Project

General

Profile

DeprecatedInstallation » History » Version 29

Paul Kocialkowski, 02/05/2012 05:43 PM

1 27 Paul Kocialkowski
h1. Installation
2 1 Denis 'GNUtoo' Carikli
3 26 Paul Kocialkowski
{{toc}}
4 25 Paul Kocialkowski
5
h2. Detailed instructions to install Replicant
6
7 28 Paul Kocialkowski
1. *Make sure your phone is supported*
8 25 Paul Kocialkowski
9 28 Paul Kocialkowski
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.
10 25 Paul Kocialkowski
11 28 Paul Kocialkowski
2. *Make sure your phone allows non-official images*
12 25 Paul Kocialkowski
13 29 Paul Kocialkowski
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).
14 1 Denis 'GNUtoo' Carikli
15 29 Paul Kocialkowski
Please, refer to the "CyanogenMod wiki":http://wiki.cyanogenmod.com/wiki/Main_Page 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.
16 1 Denis 'GNUtoo' Carikli
17 29 Paul Kocialkowski
For instance on the "HTC Dream":http://wiki.cyanogenmod.com/wiki/HTC_Dream page, you'll need to follow the instructions to *root the phone* and to install *DangerSPL*.
18 1 Denis 'GNUtoo' Carikli
19 29 Paul Kocialkowski
*Note: all the radio images and bootloader images that are provided on these pages are not free software.*
20 25 Paul Kocialkowski
21 29 Paul Kocialkowski
3. *Download the Replicant images and tools for your phone*
22 25 Paul Kocialkowski
23 29 Paul Kocialkowski
a. *Find the codename of your phone*
24 1 Denis 'GNUtoo' Carikli
25 25 Paul Kocialkowski
      Each device we support has a codename. You can find the codenames on the [[ReplicantStatus]] page. 
26
27 27 Paul Kocialkowski
For instance, HTC Dream has Codename: dream_sapphire .
28 25 Paul Kocialkowski
29
30 1 Denis 'GNUtoo' Carikli
   b. *Find the latest usable Replicant image*
31 25 Paul Kocialkowski
32
      The [[ReplicantStatus]] page also shows the latest usable Replicant image for each device.
33
34 27 Paul Kocialkowski
For instance, HTC Dream/HTC Magic has Last usable image: Replicant 2.2 preview 0009 .
35 25 Paul Kocialkowski
36
37
   c. *Find the base location of the tools/images for your device*
38
39
40
      Replicant images are hosted at: http://ftp.osuosl.org/pub/replicant/images/ 
41
42
      From this page, select the Replicant version (replicant-2.2, replicant-2.3, etc) of the latest usable Replicant image for your device.
43 1 Denis 'GNUtoo' Carikli
44 25 Paul Kocialkowski
      Then, select the Replicant image type (preview or release) of the latest usable Replicant image for your device.
45
46
      Select the Replicant image number (0006 for example) of the latest usable Replicant image for your device.
47
48 27 Paul Kocialkowski
For instance, if the phone is HTC Dream and the latest image Replicant 2.2 preview 0009 , the base location will be: http://ftp.osuosl.org/pub/replicant/images/replicant-2.2/preview/0009/ .
49 25 Paul Kocialkowski
50
51
   d. *Download the tools to flash your device*
52
53
54
      From the base location we just found out, select the *tools* directory and download the *fastboot* utility to write Replicant on your device. 
55
56
57
   e. *Download the Replicant images for your device*
58
59
60 1 Denis 'GNUtoo' Carikli
      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. 
61
62
63 25 Paul Kocialkowski
 4. *Setup the computer to flash Replicant*
64 1 Denis 'GNUtoo' Carikli
65
66 27 Paul Kocialkowski
67
Open a terminal and go to the location where you downloaded all the files (usually, ~/Downloads ). To do this, run the following command:
68
69
70 25 Paul Kocialkowski
    To do this, run the following command:
71
72 27 Paul Kocialkowski
cd ~/Downloads 
73 1 Denis 'GNUtoo' Carikli
74 27 Paul Kocialkowski
If you have downloaded the files in any other place, change ~/Downloads by the location where you downloaded the files.
75 25 Paul Kocialkowski
76
    Then, you need to get root on this terminal. Run:
77
78 27 Paul Kocialkowski
su 
79 25 Paul Kocialkowski
80
    This will ask you to type the superuser (root) password. Note that in most cases, the letters you type won't be shown.
81
82
    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: 
83
84 27 Paul Kocialkowski
chmod a+x fastboot 
85 25 Paul Kocialkowski
86
    Keep this terminal open during the next step.
87
88
89
 5. *Setup the device to flash Replicant*
90 1 Denis 'GNUtoo' Carikli
91 25 Paul Kocialkowski
92
    Completely turn off your device. You can also remove and reinsert the battery then. 
93
94
    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. 
95
96
    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 
97
98
    Connect the USB cable to your PC, hold the appropriate keys and boot the phone. You should get on fastboot menu. 
99
100
    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: 
101
102 27 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.
103 25 Paul Kocialkowski
104
105
 6. *Flash Replicant images*
106
107
108
    *WARNING: This step will erase every data stored on the phone, make sure you copied the data if you don't want to lose it.* 
109
110
    Switch back to the terminal we just opened and run the following commands: 
111
112
<pre>
113 17 Paul Kocialkowski
./fastboot flash system system.img
114 18 Paul Kocialkowski
./fastboot flash boot boot.img
115 19 Paul Kocialkowski
./fastboot flash userdata userdata.img 
116 25 Paul Kocialkowski
</pre>
117
    If you want to flash Recovery image:
118
119
<pre>
120 20 Paul Kocialkowski
./fastboot flash recovery recovery.img 
121 25 Paul Kocialkowski
</pre>
122 22 Paul Kocialkowski
    Then clean the cache and reboot:
123 25 Paul Kocialkowski
<pre>
124 23 Alexandre Oliva -
./fastboot erase cache
125 22 Paul Kocialkowski
./fastboot reboot
126 25 Paul Kocialkowski
</pre>
127 22 Paul Kocialkowski
    Your device should now reboot with Replicant running. Now you are done, Replicant is installed on your device!
128 20 Paul Kocialkowski
129
130 25 Paul Kocialkowski
h2. Summary of the instructions to install Replicant
131
 #installsummary
132 16 Paul Kocialkowski
133 8 Paul Kocialkowski
134 25 Paul Kocialkowski
h2. Requirements
135
136
* a rooted or unlocked phone
137
* fastboot(can be built or obtained "from our ftp":http://ftp.osuosl.org/pub/replicant/images/replicant-2.2/)
138
* the images(can be built or obtained "from our ftp":http://ftp.osuosl.org/pub/replicant/images/replicant-2.2/)
139
140
141
h2. Installation
142
143
144 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.
145 4 Denis 'GNUtoo' Carikli
146 25 Paul Kocialkowski
*Note, if you don't have instructions for entering fastboot mode, you may need to install [[DangerSPL]] using the [[CyanogenMod]] instructions.*
147 1 Denis 'GNUtoo' Carikli
148 25 Paul Kocialkowski
*Note that it will erase everything on the phone* 
149
<pre>
150 1 Denis 'GNUtoo' Carikli
./fastboot flash system system.img
151
./fastboot flash boot boot.img
152
./fastboot flash userdata userdata.img 
153
./fastboot erase cache
154
./fastboot reboot
155 25 Paul Kocialkowski
</pre>