How To Use PPCKitchen- A Step By Step Tutorial With Screenshots

JustPCTech · #1 10-29-2008, 12:56 PM

How to use PPCKitchen

Minimum list of what will be needed to proceed:

1. A computer with Windows XP or Vista operating system. This computer should have at least 1 open USB port for use
when flashing a rom to the device. There should be NO USB hubs in the mix here, they can cause connection issues.
2. Must have installed- ActiveSync 4.5 for computers with the XP operating system /Windows Mobile Device Center for
computers with Vista operating system
3. Must have installed- Microsoft .NET Framework 2.0 Service Pack 1 or higher
4. One mini USB cable

Things that might come in handy:

1. Micro sdcard 512MB in size to 2Gig in size- can be used to flash roms/radio’s in case of connection issues with ActiveSync/Mobile Device Center. Must be formatted in Fat32 format.

Depending on your device, it may need to be unlocked before you can flash a custom ROM

IMPORTANT!!

For Titan and Vogue (Mogul, XV6800, Touch) MUST HAVE RADIO version 3.xx or higher for gps-enabled ROM's!
A custom ROM WILL NOT BOOT without a gps-enabled radio on the device.

NOTES:
If you have the 6700 device (PPC-6700, XV6700) you will not need to unlock it to flash a custom ROM. You will have to BE SURE to match the Bootloader version on your device to the Rev. dropdown in BuildOS- this is very important to get a build to flash.

If you have and device made later than that such as the 6800 (PPC-6800-Mogul, XV6800) or 6900 (Vogue, Touch) it WILL NEED TO BE UNLOCKED before flashing a custom ROM. For GPS enabled ROM’s you will need to have a radio version 3.xx or higher on the device before flashing a custom ROM. If you do NOT have the right version radio to match the ROM the device will NOT boot.
See the Unlocking Tutorial at the following link:

Installation of PPCKitchen

You can download the kitchen installer from the following links:
Links/Downloads area of forum- just click on the title of the post there.
http://www.ppckitchen.org/forums/loc...ks.php?catid=4
Manual Downloads page- get the BuildOS.msi file here-
http://www.ppckitchen.org/Downloads/BuildOS.msi

The first thing you should do after installation is run Updater to make sure that BuildOS is up to date with the latest fixes. Be SURE BuildOS is not running when you run Updater. You will find updater link in your programs group on the Start Menu of your pc in the PPCKitchen folder.

When you get to the menu part of Updater you will see all the different selections for OEM’s and kitchens that are available for use. You will need at least the PPCkitchen OEMs and Non-Freeware OEM’s at the top. If your device is a VGA type device- you will need the PPCkitchen VGA OEMs instead of the other.

The latest kitchens will be the modular selections, and you will need to select both the Build files (20273 in this case) and the Generic OEM kitchen files, Carrier, Device drivers (Titan in this case), and Device kitchen core (Titan kitchen core in this case)

In the picture below I am selecting files for the PPC6800 device (Titan)

When you click Next the Updater will begin downloading files and you will get a screen to show the progress.

Sometimes during the update process the update server is extremely busy. If this is the case your downloads may fail and the update process will "roll back" to what it was before. If this happens to you, the best thing to try is not selecting as many of the files to update. You can run updater again if needed to download any files that you did not get the first time.

JustPCTech · #2 10-29-2008, 09:42 PM

Running PPCk-BuildOS to build a ROM

To start PPCk-BuildOS to build a custom ROM, click Start, Programs, PPCKitchen, then PPCk-BuildOS. You will get a login box first that you need to add information to. It makes it easier for the Kitchen Crew to help you if you use the same Nic (username) that you use on either PPCGeeks forum or PPCKitchen forum. The password does NOT need to be the same one, and is NOT related to the one you use for the other sites. If you have donated to PPCKitchen before, please be sure to add your donation email address so we can add you to the Donator's List for recognition.

As PPCk-BuildOS opens, it will ask you to select a Project file (ex: C:\Program Files\PPCkitchen.org\BuildOS\Projects\Titan_WM6.1_ 20931 Selections.txt). The file you choose or create will be in the Projects folder under PPCKitchen.org folder in Program Files.

Common Errors:
If when opening the selections file you get the error "need selections version .04"....then you selected the wrong kind of file.
If you get the error " need kitchen_config version .02"....then you have an outdated kitchen that needs upgrading.

Choosing existing Project

If there are no files available in the Use Existing Project side of the Select Project window, you must use the Create a New Project option. Click on the Create a New Project tab at the top, then select your device in the top dropdown menu(Ex: Titan_WM) then the Build Base you want to use in the middle dropdown menu (Ex: WM6.1_96DPI_QVGA_20931_0409.txt). Then give it a name at the bottom next to Filename and click OK.

Creating a new Project

BuildOS will then process all the files needed to build a ROM which could take 15-30 seconds or so to complete.

On the toolbars along the top of PPCk-BuildOS, you will see various dropdown menus pertaining to your device; these can include Boot Splash, Sub Splash, Animated Splash and Main Splash screens, RUU type, OS type and Carrier selection.
If multiple XIP’s are available, you can use the dropdown to pick which one you will build with.
All devices may choose the Compression method for the build also. XPR is the default; LZX has better compression but is slower during the build process.

To build a working ROM for your device the only thing that MUST be selected is the Carrier, except in the case of Apache (PPC-6700, XV 6700) devices. You MUST select the Rev version (Bootloader version) also for Apache builds.

Now you can start selecting the games, programs and utilities that you want to build into your ROM. You can either click on a group name in the left hand part of PPCk-BuildOS or just start at the top in the main section and begin making selections. PPCk-BuildOS will let you know if the ROM is too big, but not until the end of the build process. This is usually only a big problem on the 6700 devices (Apache): PPC6700, XV6700. It’s a good idea to start small just to get an idea of how the process works, as you can always build another ROM easily enough now! As you choose your selections, you can right click on the Module Name and get more information about that particular selection by choosing OEM Info or Visit Homepage.

Once you have completed your selections, to start the actual build process you click the green arrow on the top left of the BuildOS toolbar. IMPORTANT- It is a good idea not to run any programs while the ROM is building as this can cause a build to fail. This will open a window called Build Status that will show the progress as the build is being processed. The build status window has a Save to File and Save to Clipboard options available. If you get an error in your build, you can click the Save to File button and it will save a build log to the following location: C:\Program Files\PPCkitchen.org\BuildOS. It will be named like this- buildlog 081028-134045.txt- which shows the date and time the build was done. This can be posted on our forum or http://ppckitchen.pastebin.com website if we need to look at it to help you troubleshoot the problem.

Depending on the selections you have made, you might get the File Overwrite prompt during the build. PPCk-BuildOS is just overwriting older files with newer files usually. Most times the default answer of Yes to file overwrites will be fine.

When the build is complete, the ROM Upgrade Utility (RUU) will open. If your phone is not already synced to ActiveSync or Mobile Device Center- plug the USB cable into it now and make the connection. You will need to follow the directions on that and check the box to allow it to continue. It will first check to make sure the device is connected properly, then it will actually start the upgrade process, also called “flashing the device”. Once the flash begins you will get a window that will show the progress of the upgrade. When it is complete, you will get a window telling you so and you will click Finish in that window.
IMPORTANT- Do NOT open or run any programs while the RUU is flashing your device. Do NOT attempt to disconnect or unplug your device. Both these could cause the flash to fail and give you MAJOR PROBLEMS.

Your phone should reset itself after the flash and reboot. You should ALWAYS perform a Hard Reset after flashing a device- you can do this once it displays the data on the first boot screen or wait for it to boot the first time then perform the Hard Reset then.

Congratulations! You have now made your own custom ROM using the PPCKitchen. Enjoy the added stability and performance.

JustPCTech · #3 11-19-2008, 04:51 PM

All links in the above post have been fixed now. Sorry about the inconvenience.

murmur · #4 11-23-2008, 03:45 PM

JustPCTech, it seems like the link in Step 3 of your "What will be needed to proceed" section goes to .NET Compact Framework 2.0, instead of Microsoft .NET Framework 2.0 Service Pack 1. We want the latter, right?

JustPCTech · #5 11-23-2008, 05:32 PM

No, it redirects to a page on microsoft.com that has this at the top:
NET Compact Framework 2.0 Service Pack 1 Redistributable
which is the correct one. You might have been using the link from awhile back before I fixed them maybe? But it links to the correct version of the .NET needed now.

GaMedic · #6 11-26-2008, 03:05 PM

Hey Just PC I have been away for a while. Wanted to say nice tutorial.

elgreek84 · #7 11-28-2008, 08:49 PM

Great tutorial. Do you have any resources on how to do this manually? I had problems with the updater (errors out and rolls back changes) and I download the packages/.rar files but have no idea where to put them. (total noob here) Thanks!.

JustPCTech · #8 11-30-2008, 07:26 PM

Sorry for the delayed response here. With updater might try selecting only 1 or 2 files at a time...its funny how some people have issues with it but it always works fine for me and lots of others. Any of the *.rar files will go in C:\Program Files\PPCkitchen.org\BuildOS\Kitchens directory; projects files would go in C:\Program Files\PPCkitchen.org\BuildOS\Projects directory.

JustPCTech · #9 11-30-2008, 07:28 PM

Tutorial has been updated to reflect changes to the Open Project part of the process now. With the newer BuildOS you have the option to Create a New Project, which will be needed due to the fact that old selections files will not work with newer BuildOS.

whitefatboy2k · #10 12-05-2008, 02:08 PM

after owning this phone 6900 sprint but partial flash to cricket ( i NEED CRICKET AS PROVIDER) seems i maybe will be able to get all working?....
hope mms works without closing internet down and then going into the default connections and deleting em to get mms (pix messages).....
thanks

Thread Tools
Show Printable Version Email this Page
Display Modes
Linear Mode Switch to Hybrid Mode Switch to Threaded Mode

The Following 72 Users Say Thank You to JustPCTech For This Useful Post:
2WebFeat (05-01-2010), 68Camaro (12-18-2008), 82tarheel (12-24-2008), antilaw (04-15-2009), armowawa (01-22-2009), arzdog (10-09-2009), asf4588 (02-11-2009), Biggnaa20 (02-21-2009), chborge (01-09-2009), coolcarguy1 (05-08-2010), courtney1985 (03-23-2010), daddyspc (01-17-2009), dan-htc-touch (12-24-2008), DawgY (03-31-2009), DenverDev (05-27-2009), disturb1 (05-10-2009), donsalari (02-05-2010), dvpmike (02-05-2009), dyrtnapr (01-05-2009), ethinton (11-30-2008), findsilence (02-10-2010), Fiote (07-15-2009), firef1y (05-12-2009), flashedphones (12-20-2009), fort13 (11-20-2009), gerarq (08-02-2009), hawks2005 (02-04-2010), HoyaSkin (07-02-2009), hthomas (03-11-2010), jchittwood (02-18-2010), kjmars (03-02-2009), krushmoto (12-15-2008), lazydazed (03-02-2010), leeco (03-29-2010), lightupmyworld (07-17-2009), Lmiller1708 (11-10-2009), LOSHTC (06-07-2010), Lthorus (02-03-2009), lunacie (08-28-2009), M4te0 (04-26-2009), macs53 (04-26-2009), MAFoElffen (05-06-2009), marsavo (02-25-2009), Matthew1034 (05-19-2010), maxemma (05-25-2010), medman (04-23-2009), mike99 (05-13-2009), mohapmasker (08-16-2009), montanye (06-11-2009), nicerob (11-11-2008), Old Faithful (02-22-2009), patwehner (02-08-2009), qumis (02-20-2010), reddick (09-25-2009), rwcj63 (01-05-2010), setyodinuto (09-23-2009), Skandolis (06-09-2009), skank_boy (01-22-2010), sos4ever (01-30-2009), SprDav (07-01-2009), stupidcid (05-23-2010), sumlee777 (03-10-2009), taufcon (02-21-2009), the nobody (12-10-2009), tonyafm (02-10-2010), treckin (11-12-2008), twisted (04-18-2009), urgodfather (02-10-2010), xredfish (07-14-2010), ZALI (02-05-2010), Zan (07-09-2010), zodiackid (09-26-2009)

The Following 44 Users Say Thank You to JustPCTech For This Useful Post:
68Camaro (12-18-2008), aalonanarayan (08-06-2009), Abid885 (01-21-2010), amw1972 (04-24-2009), armowawa (01-22-2009), beno85us (06-27-2009), bluebean (02-17-2010), Bobtr (07-19-2009), cagrant (11-25-2009), cgaiii (07-02-2009), chborge (01-09-2009), CuriousG (03-20-2009), daddyspc (01-17-2009), dan-htc-touch (12-24-2008), DawgY (03-31-2009), devsolution (03-27-2010), ethinton (11-30-2008), fort13 (11-20-2009), Jeanelle8705 (09-05-2009), kjmars (03-02-2009), lightupmyworld (07-17-2009), Lmiller1708 (11-10-2009), Lthorus (02-03-2009), M4te0 (04-26-2009), Matthew1034 (05-19-2010), mcbean2k (03-13-2009), medman (04-23-2009), navyinak (08-31-2009), nicerob (11-11-2008), Ocurrente (06-28-2009), ownagewith98 (01-05-2009), peacock93 (11-07-2008), professorbooty (06-15-2010), Radon_22 (11-10-2008), RichardB (12-01-2009), silvaman (03-15-2009), skank_boy (01-22-2010), sos4ever (01-30-2009), sumlee777 (03-10-2009), the nobody (12-10-2009), UndeadSquirrel (01-27-2010), yukonmarc (02-19-2009), yulic (11-20-2009), Zaphod-Beeblebrox (03-21-2010)

The Following 5 Users Say Thank You to JustPCTech For This Useful Post:
dan-htc-touch (12-24-2008), lunacie (08-28-2009), Ocurrente (06-28-2009), silvaman (03-15-2009), sos4ever (01-30-2009)

The Following User Says Thank You to murmur For This Useful Post:
silvaman (03-15-2009)

The Following 3 Users Say Thank You to JustPCTech For This Useful Post:
dan-htc-touch (12-24-2008), GaMedic (11-26-2008), sos4ever (01-30-2009)

The Following 2 Users Say Thank You to JustPCTech For This Useful Post:
crazaytalent (04-18-2009), dan-htc-touch (12-24-2008)

The Following 3 Users Say Thank You to JustPCTech For This Useful Post:
dan-htc-touch (12-24-2008), jetcat (07-11-2009), macs53 (04-26-2009)

The Following User Says Thank You to whitefatboy2k For This Useful Post:
maxemma (05-25-2010)