Project

General

Profile

DeprecatedInstallation » History » Version 18

Paul Kocialkowski, 09/27/2011 09:59 AM

1 8 Paul Kocialkowski
== Summary ==
2
3
 * [#installdetailed Detailed instructions to install Replicant]
4
 * [#installsummary Summary of the instructions to install Replicant]
5
6
== Detailed instructions to install Replicant == #installdetailed
7
8
 1. '''Make sure your phone is supported'''[[BR]][[BR]]
9
    Replicant only supports a few phones. Make sure the phone you want to install Replicant on is on the ReplicantStatus list. If it's not, you won't be able to install Replicant on your device without at least a bit of software hacking.[[BR]][[BR]]
10 11 Paul Kocialkowski
 2. '''Make sure your phone allows non-official images'''[[BR]][[BR]]
11
    Some phones come with software that allows the user to ''flash'' the memory (replace the content of the memory partitions, like the system or the kernel one), but it's not always the case. Google-branded phones (Nexus One and Nexus S) come with this allowed but for some other devices, you'll certainly have to do some more operations to make this possible (it's required to flash Replicant).[[BR]]
12
    Please, refer to the [http://wiki.cyanogenmod.com/wiki/Main_Page CyanogenMod wiki] to find and follow the instructions to '''root the phone'''. Note that instructions for Replicant 2.2 correspond to CyanogenMod 6 and Replicant 2.3 correspond to CyanogenMod 7.[[BR]]
13
    For instance on the [http://wiki.cyanogenmod.com/wiki/HTC_Dream HTC Dream] page, you'll need to follow the instructions to '''root the phone''' and to install '''DangerSPL'''.[[BR]][[BR]]
14
    '''Note: all the radio images and bootloader images that are provided on these pages are not free software.'''[[BR]][[BR]]
15 12 Paul Kocialkowski
 3. '''Download the Replicant images and tools for your phone'''[[BR]][[BR]]
16 8 Paul Kocialkowski
   a. '''Find the codename of your phone'''[[BR]]
17
      Each device we support has a codename. You can find the codenames on the ReplicantStatus page. [[BR]]
18 9 Paul Kocialkowski
      For instance, HTC Dream has {{{ Codename: dream_sapphire }}}.[[BR]][[BR]]
19 1 Denis 'GNUtoo' Carikli
   b. '''Find the latest usable Replicant image'''[[BR]]
20 9 Paul Kocialkowski
      The ReplicantStatus page also shows the latest usable Replicant image for each device.[[BR]]
21
      For instance, HTC Dream/HTC Magic has {{{ Last usable image: Replicant 2.2 preview 0008 }}}.[[BR]][[BR]]
22 12 Paul Kocialkowski
   c. '''Find the base location of the tools/images for your device'''[[BR]][[BR]]
23 9 Paul Kocialkowski
      Replicant images are hosted at: http://ftp.osuosl.org/pub/replicant/images/ [[BR]]
24
      From this page, select the Replicant version (replicant-2.2, replicant-2.3, etc) of the latest usable Replicant image for your device.[[BR]]
25
      Then, select the Replicant image type (preview or release) of the latest usable Replicant image for your device.[[BR]]
26
      Select the Replicant image number (0006 for example) of the latest usable Replicant image for your device.[[BR]]
27 12 Paul Kocialkowski
      For instance, if the phone is HTC Dream and the latest image {{{ Replicant 2.2 preview 0008 }}}, the base location will be: {{{ http://ftp.osuosl.org/pub/replicant/images/replicant_2.2/preview/0008/ }}}.[[BR]][[BR]]
28
   d. '''Download the tools to flash your device'''[[BR]][[BR]]
29
      From the base location we just found out, select the '''tools''' directory and download the '''fastboot''' utility to write Replicant on your device. [[BR]][[BR]]
30
   e. '''Download the Replicant images for your device'''[[BR]][[BR]]
31 13 Paul Kocialkowski
      From the base location we just found out, select the '''pieces''' directory and then the directory corresponding to your phone codename and download the '''boot.img''' (kernel), '''system.img''' (OS) and '''userdata.img''' (data) files. It can take some time. [[BR]][[BR]]
32 14 Paul Kocialkowski
 4. '''Setup the computer to flash Replicant'''[[BR]][[BR]]
33
    Open a terminal and go to the location where you downloaded all the files (usually,{{{  ~/Downloads }}}).
34
    To do this, run the following command:[[BR]]
35
    {{{ cd ~/Downloads }}}[[BR]]
36
    If you have downloaded the files in any other place, change {{{ ~/Downloads }}} by the location where you downloaded the files.[[BR]]
37
    Then, you need to get root on this terminal. Run:[[BR]]
38
    {{{ su }}}[[BR]]
39
    This will ask you to type the superuser (root) password. Note that in most cases, the letters you type won't be shown.[[BR]]
40
    Now that you're root, you are able to use the '''fastboot''' utility. We first need to make it executable. To do this, run the following: [[BR]]
41 15 Paul Kocialkowski
    {{{ chmod a+x fastboot }}}[[BR]]
42
    Keep this terminal open during the next step.[[BR]][[BR]]
43 17 Paul Kocialkowski
 5. '''Setup the device to flash Replicant'''[[BR]][[BR]]
44 16 Paul Kocialkowski
    Completely turn off your device. You can also remove and reinsert the battery then. [[BR]]
45
    Now, you'll need to turn your device in fastboot mode. The usual way to do this is to hold a few buttons when booting. [[BR]]
46
    A list of the buttons to hold for each (Google) device  is available at: http://source.android.com/source/building-devices.html#booting-into-fastboot-mode [[BR]]
47
    Connect the USB cable to your PC, hold the appropriate keys and boot the phone. You should get on fastboot menu. [[BR]]
48 1 Denis 'GNUtoo' Carikli
    If it's the first time you flash an image and your phone is Google Nexus One or Google Nexus S, you'll need to unlock the bootloader. Switch back to the terminal we opened earlier and run: [[BR]]
49 17 Paul Kocialkowski
    {{{ ./fastboot oem unlock }}} '''Warning: on Nexus One, the operation voids the warranty and is irreversible. On Nexus S and Nexus S 4G, the bootloader can be locked back.'''[[BR]][[BR]]
50 18 Paul Kocialkowski
 6. '''Flash Replicant images'''[[BR]][[BR]]
51 16 Paul Kocialkowski
52 8 Paul Kocialkowski
== Summary of the instructions to install Replicant == #installsummary
53
54 2 Denis 'GNUtoo' Carikli
== Requirements ==
55
 * a rooted or unlocked phone
56 5 John Sullivan
 * fastboot(can be built or obtained [http://ftp.osuosl.org/pub/replicant/images/replicant_2.2/ from our ftp])
57
 * the images(can be built or obtained [http://ftp.osuosl.org/pub/replicant/images/replicant_2.2/ from our ftp])
58 2 Denis 'GNUtoo' Carikli
59 6 John Sullivan
== Installation ==
60 1 Denis 'GNUtoo' Carikli
61 10 Mark Holmquist -
Put the phone in fastboot mode (by holding the Camera button and the Power button, then following on-screen instructions), make sure it's connected to your computer, and run the following commands on your computer. You may need to use sudo.
62
63
'''Note, if you don't have instructions for entering fastboot mode, you may need to install DangerSPL using the CyanogenMod instructions.'''
64 4 Denis 'GNUtoo' Carikli
65 3 Denis 'GNUtoo' Carikli
'''Note that it will erase everything on the phone''' 
66 1 Denis 'GNUtoo' Carikli
{{{
67
./fastboot flash system system.img
68
./fastboot flash boot boot.img
69
./fastboot flash userdata userdata.img 
70
./fastboot erase cache
71
./fastboot reboot
72
}}}