Project

General

Profile

RecoveryInstallationWithHeimdall » History » Version 22

Denis 'GNUtoo' Carikli, 03/27/2018 03:50 AM

1 1 Denis 'GNUtoo' Carikli
h1. Recovery installation or update trough Heimdall
2
3 16 Denis 'GNUtoo' Carikli
h2. Warning
4 1 Denis 'GNUtoo' Carikli
5 22 Denis 'GNUtoo' Carikli
Theses instructions are a work in progress and do not cover all supported devices yet.
6 16 Denis 'GNUtoo' Carikli
7 1 Denis 'GNUtoo' Carikli
h2. Prerequisites 
8
9
This guide applies only to the following devices:
10 22 Denis 'GNUtoo' Carikli
* i9100 (Galaxy S II)
11 13 Denis 'GNUtoo' Carikli
* Galaxy S 3 (I9300)
12 1 Denis 'GNUtoo' Carikli
* Galaxy S 3 4G (I9305)
13 22 Denis 'GNUtoo' Carikli
* N7000 (Galaxy Note)
14 1 Denis 'GNUtoo' Carikli
* Galaxy Note 2 (N7100)
15 22 Denis 'GNUtoo' Carikli
* P3100 (Galaxy Tab 2 7.0)
16
* P3110 (Galaxy Tab 2 7.0 Wi-Fi)
17
* P5100 (Galaxy Tab 2 10.1)
18
* P5110 (Galaxy Tab 2 10.1 Wi-Fi)
19 14 Denis 'GNUtoo' Carikli
* Galaxy Note 8.0 (N5100)
20
* Galaxy Note 8.0 Wi-Fi (N5110)
21 13 Denis 'GNUtoo' Carikli
22 15 Denis 'GNUtoo' Carikli
Using the instructions of this page with a device not listed above can break it, up to the point where it is too long, complicated and expensive to repair, even for technical people.
23
24 2 Denis 'GNUtoo' Carikli
In order to install the Replicant recovery on your device, it is assumed that you have a computer running a GNU/Linux operating system and everything necessary to connect your device to the computer through USB. Moreover, it is assumed that anyone performing the installation knows how to use the command line in a terminal and has basic knowledge about it.
25 1 Denis 'GNUtoo' Carikli
26
h2. Downloading the files
27
28
The first step in the installation process is to download and set up the files that will be used to install Replicant to the device. The files must be downloaded on your computer first.
29
30 3 Denis 'GNUtoo' Carikli
1. First find the recovery latest image for your device in [[ReplicantImages#Images|ReplicantImages]]. For instance for a Galaxy S2, the table will have <pre>Galaxy S 2 (I9100)</pre> in the device column.
31 5 Denis 'GNUtoo' Carikli
2. Then identify the recovery file and its corresponding signature file:
32 1 Denis 'GNUtoo' Carikli
The recovery file will look like that:
33
<pre>
34
recovery-<yourdevice>.img
35
</pre>
36
And the its corresponding signature file will look like that:
37
<pre>
38
recovery-<yourdevice>.img.asc
39
</pre>
40
41
For instance for the Samsung Galaxy S2, the file will be named like that:
42
* recovery-i9100.img
43
* recovery-i9100.img.asc
44 4 Denis 'GNUtoo' Carikli
45 6 Denis 'GNUtoo' Carikli
3. Download the latest recovery file and its corresponding signature file for your device on [[ReplicantImages#Images|ReplicantImages]].
46 5 Denis 'GNUtoo' Carikli
4. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring
47 4 Denis 'GNUtoo' Carikli
48
h2. Check the signature of the recovery
49 1 Denis 'GNUtoo' Carikli
50 7 Denis 'GNUtoo' Carikli
1. From the command line, go inside the directory that has the dowloaded files:
51 9 Denis 'GNUtoo' Carikli
The emplacement where the files are downloaded might be different for you.
52
If it is the case, adjust the command below accordingly:
53 1 Denis 'GNUtoo' Carikli
<pre>
54
cd "${HOME}/Downloads/"
55
</pre>
56 10 Denis 'GNUtoo' Carikli
57 7 Denis 'GNUtoo' Carikli
2. Then check the signature of the recovery (and don't forget to sure to substitute "<yourdevice>" with the actual device name):
58 1 Denis 'GNUtoo' Carikli
<pre>
59
gpg --armor --verify recovery-<yourdevice>.img.asc recovery-<yourdevice>.img
60
</pre>
61 8 Denis 'GNUtoo' Carikli
Make sure the check succeeds, *do not continue the recovery installation if it doesn't*!
62 1 Denis 'GNUtoo' Carikli
63
h2. Installing heimdall
64
65
The heimdall tool is required to flash the recovery image to the device.
66
Instructions to install heimdall: [[ToolsInstallation#Heimdall|ToolsInstallation]]
67
68
h2. Preparing the device
69
70
The next step in the installation process is to prepare the device for heimdall mode.
71
72
1. Make sure the device is completely turned off and the USB cable is disconnected from the device
73
2. Start the device by holding the following key combination: *Volume down, Select, Power*
74
3. Hold the key combination until the device shows a *Warning* message
75
4. Confirm that you want to download a custom OS (using volume up)
76
5. Make sure the device is in *Downloading* mode
77
4. Connect the USB cable to both the computer and the device
78
79
h2. Installing the images
80
81
Now that both the computer and the device are set up, it is time to actually install the images to the device.
82
83 11 Denis 'GNUtoo' Carikli
1. From the command line, return inside the directory that has the dowloaded files:
84
The emplacement where the files are downloaded might be different for you.
85
If it is the case, adjust the command below accordingly:
86
<pre>
87
cd "${HOME}/Downloads/"
88
</pre>
89
90 18 Denis 'GNUtoo' Carikli
2. Installing the recovery
91 21 Denis 'GNUtoo' Carikli
If you are installing Replicant for the first time, you need to install a recovery.
92
93
If you have one of theses devices:
94
* Galaxy S 3 (I9300)
95
* Galaxy S 3 4G (I9305)
96
* Galaxy Note 2 (N7100)
97
* Galaxy Note 8.0 (N5100)
98
* Galaxy Note 8.0 Wi-Fi (N5110)
99
100 1 Denis 'GNUtoo' Carikli
you should then run the following command to install the recovery:
101
<pre>
102
heimdall flash --BOOT path/to/recovery-<yourdevice>.img --RECOVERY path/to/recovery-<yourdevice>.img
103
</pre>
104 22 Denis 'GNUtoo' Carikli
105
Instead, if you have one of the following devices:
106
* i9100 (Galaxy S II)
107
* N7000 (Galaxy Note)
108
* P3100 (Galaxy Tab 2 7.0)
109
* P3110 (Galaxy Tab 2 7.0 Wi-Fi)
110
* P5100 (Galaxy Tab 2 10.1)
111
* P5110 (Galaxy Tab 2 10.1 Wi-Fi)
112
you should then run the following command to install the recovery:
113
<pre>
114
heimdall flash --KERNEL recovery-<yourdevice>.img --RECOVERY recovery-<yourdevice>.img
115
</pre>
116
117
The command(s) above should also automatically reboot the device to the recovery.
118 12 Denis 'GNUtoo' Carikli
119 18 Denis 'GNUtoo' Carikli
2. Or updating the recovery
120
Instead if you just want to update your recovery, you should run the following command:
121 12 Denis 'GNUtoo' Carikli
<pre>
122 17 Denis 'GNUtoo' Carikli
heimdall flash --RECOVERY path/to/recovery-<yourdevice>.img
123 12 Denis 'GNUtoo' Carikli
</pre>
124
This command should also automatically reboot the device to the Replicant.