JetDroid Installation Guide (Summarised by Bonsitm, all other work by The JD Dev Team)
~ | QUESTIONS?:
Discussion, questions and corrections to this guide can take place in the Guide Discussion Topic
~ | UPDATES:
(04/04/11) - Update Jetplatform Eclair 26/3/2011 testing
(29/01/11) - Remove version number - it's meaningless!
(25/12/10) - Virtualbox information
(16/12/10) - Added warning on mixing platform files
(05/12/10) - Link to JetPlatform 0.3pre1
(25/11/10) - Links to JetKernel 0.3pre2 and pre3
(30/10/10) - Link to Guide discussion topic
(27/10/10) - Added link to new JetKernel 0.3pre1
(25/10/10) - Added more sub steps for setting up Ubuntu and refined links to Android files
A | BEFORE YOU START:
Make sure you have the following:
1. Unlocked (Sim and Network) Samsung Jet S8000. Refer to flash guide
For additional requirements and instructions
2. A 4GB and up SDHC micro SD card. Must be HC at the time of writing.
3. Samsung New PC Studio for Jet’s drivers
4. Bootloader JetQi, can be built yourself with instructions here:
or found here
5. A good understanding of the flashing procedure, file operations in windows and Ubuntu (the latter is easy to learn) and partitioning.
6. Make sure your Jet’s firmware matches one here:
If not, then consider flashing to a compatible version.
7. Download Ubuntu and Virtualbox:
and put them in a single easy to reach folder in windows
NOTE: Virtualbox only supports the 32bit version of Ubuntu, so make sure you pick the 32 bit version, and not the 64 bit version!
B | PREPARE THE PHONE:
1. BACKUP ALL CONTENT ON PHONE AND SDCARD TO WINDOWS. Calendar, Memo etc can be backed up using New PC Studio
Locate the JetQi bootloader build you built/downloaded and open it in Multiloader (which you learned about here: http://darkforestgroup.com/archives/51)
The bootloader must be called 'boot_loader.mbn' to use.
Make sure it matches this picture:
More detailed steps: (BUT NO SUBSTITUTE FOR READING THE FLASH GUIDE)
1.1 Use this radio button
1.2 Click only 'boot change'
1.3 Click ‘Boot’ button and navigate to folder containing the .mbn you built.
1.4 Connect Jet in Download Mode (Turn off, then Vol down, camera and power) and then connect via usb. Click Port Search.
1.5 Should say ‘Ready’ here
1.6 Click Download, and cross fingers (arbitrary)
1.7 Should say ‘all files ok’ or similar here
2. You now have JetQi in place.
C | PREPARE UBUNTU LINUX
Because of the tools used in development, and the use of 'ext3' partition format, it is necessary to use Linux, here Ubuntu. The easiest way of doing this is by installing it inside a virtual machine, so it is independent of Windows.
1. Install VirtualBox
2. Set up a new Virtual Machine, like so: (open image in new tab if too small)
Notes for each individual step:
a. Click next
b. Name your virtual machine (calling it Ubuntu selects Ubuntu), then choose the type shown.
c. Choose the amount of RAM to be allocated to the machine. I chose 512MB.
d - g. Create a new virtual hard disk. Make sure it is at least 10GB and 'dynamic', if you want to build from sources.
3. Click ‘Start’ green arrow.
4. Follow the instructions to complete Ubuntu Setup. Make sure you specify the ubuntu iso you downloaded at the start as the boot device.
5. When this has finished, shut down ubuntu and return to virtualbox.
6. Connect Jet to computer in USB Mass Storage mode and go to ‘settings’ then ‘USB’ in virtualbox.
7. Click the ‘+’ icon and choose SAMSUNG GT-S8000 or similar to add Jet as a USB device.
8. Boot up Ubuntu with the Jet still attached and verify the card appears.
9. Shutdown Ubuntu
D | PREPARE THE CARD
For JetDroid to run, it needs to be placed in a partition on the SDHC card with 'ext3' formatting. The good news is that this is easy to do and you can still leave the majority of the space available as FAT32 for Samsung firmware to use. GParted is available from 'Applications -> Ubuntu Software Centre'
1. Start GParted. You may need to enter your Ubuntu password
2. On the top right of GParted, click /dev/sda and change to the one that is roughly the size of your SDHC card, and NOT the 1GB - 2GB of your Jet!
3. Here you will see the list of partitions on your card. If you just bought yours or have never partitioned it before it should look something like this!
4. Right click the main FAT32 partition (if new) and any extra ones you have (if previiously partitioned) (except unallocated ones) and click 'delete'.
5. You should now have the rough size of your card represented as grey and 'unallocated'
6. Right click this unallocated entry and click 'new'.
7. This will be the FIRST partition so change the 'New size' box to the total size minus about 1.5GB.
7b. Change the 'file system' entry to 'FAT32'
7c. Choose a label for your FAT32 partition. As this will be usable for media etc in the TouchWiz OS, name it MEMORY CARD or MEDIA etc
8. Click 'Add'
9. Now for the JetDroid ext3 partition. Right click the unallocated section and click 'new'
10. This time just change 'file system' to 'ext3' and choose a label. I chose 'NEW VOLUME'. Its not important.
11. Click 'Add'
12. Make sure FAT32 is #1 and the ext3 is #2
13. Click the tick at the top. YOU WILL LOSE ALL DATA ON THE SDCARD AT THIS POINT.
14. Wait for completion.
15. Close Gparted. Your memory card is now ready for JetDroid.
E | INSTALL ANDROID FILES
1. Start Virtualbox, then Ubuntu
2. Connect Jet in Mass Storage Mode when Ubuntu has booted up.
3. Get latest platform files (binary release) , zImage, and qwerty.kl. Links are in step 6.
4. Put those three items in one easy to find folder IN UBUNTU.
Here is an example:
5. Open a terminal, and type ‘sudo nautilus’. An explorer type window will open. This is so that you can copy all the files.
Example: (Yes, my name is Chris... too many places to cover up)
NOTE: To avoid installation errors and wierd artifacts, always clean the ext3 partition of all old files before copying over new releases!
The JetPlatform files (0.3pre1)
Extract all these into the ext3 root directory.
IMPORTANT: Do not confuse these files with the source files! The source files are used to BUILD the platform, and you do not need them!
Paste this into the root directory, replacing the one already in there.
JetKernel 0.3pre1 (pre-release)
This is a pre-release of the 0.3 JetKernel. It would be preferable to use 0.2, unless you feel like testing it!
JetKernel 0.3pre3 (pre-release)
Newest version. Includes support for USB and Wifi with correct files.
Put this in 'system' -> 'usr' -> 'keylayout', replacing the one already in there.
** UPDATE 4/4/11 **
Everthing in italic text is out-of-date. Download lastest tesing release here http://www.jetdroid.org/forum/viewtopic.php?f=77&t=582 or you can try old release above to see differences
Extract all these into the ext3 root directory.
7 - 9. Example of the root directory after copying platform
10. Close that window and the terminal behind it when this is done.
11. Open a new terminal.
12. Type "sudo chmod -R 777" but don't hit enter yet.
13. Go to your root ext3 partition folder (mine is NEW VOLUME) and click copy in the ‘address area’
14. Go back to the terminal you didn’t press enter on and go to ‘edit’ -> ‘paste filenames’
15. Then press enter. Enter Ubuntu password if prompted. May be a brief pause.
16. When the prompt returns, you can close the terminal and safetly remove the Jet from the ubuntu desktop.
F | TESTING JETDROID
1. Switch off the handset.
2. Hold call and end buttons simultaneously.
3. Wait for JetDroid Desktop!
Good luck! And add whether you were successful to the Discussion thread
If anything is wrong or missing here, please let me know!
An article of Frequently Asked Questions is available here
Also, any common problems may have been already discussed in this forum, so please read around.