Project

General

Profile

Installation » History » Version 12

Denis 'GNUtoo' Carikli, 05/11/2019 07:22 PM
EFS: Add support for the galaxy Nexus

1 1 Denis 'GNUtoo' Carikli
h1. ReplicantInstallation
2
3
h2. Backup your data
4
5
Before attempting to install Replicant, you need to backup everything you can from the device as most of the data will be erased during the installation.
6
7
You can skip this step if you have no data you want to keep.
8
9 7 Denis 'GNUtoo' Carikli
h2. Installation overview
10 1 Denis 'GNUtoo' Carikli
11
The installation of Replicant is several steps:
12
* First you install a Replicant recovery. It's a very minimalist operating system that is dedicated to the installation of Replicant.
13
* Then you download Replicant and use the recovery to install it.
14
15
h2. Recovery installation
16
17
To install the Replicant recovery, follow the instructions on the [[RecoveryInstallationWithHeimdall|Recovery installation with Heimdall]] wiki page.
18
19 10 Denis 'GNUtoo' Carikli
h2. Wipe the existing system, cache and data partitions
20 9 Denis 'GNUtoo' Carikli
21 10 Denis 'GNUtoo' Carikli
Once this is done, you then need to wipe the existing system, cache and data partitions. This is to ensure that the partitions are formatted correctly.
22 9 Denis 'GNUtoo' Carikli
23 10 Denis 'GNUtoo' Carikli
To wipe the system partition, once you are in the recovery:
24 1 Denis 'GNUtoo' Carikli
1. Select Advanced
25
2. Select Wipe system partition
26 10 Denis 'GNUtoo' Carikli
3. It will ask you to confirm the wipe, so you will need to select Yes to confirm it.
27
4. Press the back key to get back to the general menu
28
29
To then wipe the cache and data partitions:
30
1. Select Factory reset
31
2. Select Wipe data (keep media)
32 9 Denis 'GNUtoo' Carikli
3. It will ask you to confirm the wipe, so you will need to select Yes to confirm it.
33
4. Press the back key to get back to the general menu
34
35 1 Denis 'GNUtoo' Carikli
h2. Using the recovery to install Replicant
36
37 4 Denis 'GNUtoo' Carikli
Installing Replicant can be done either by:
38
* [[InstallOrUpgradeReplicantWithoutAComputer|downloading the installation files the device, without the need of a computer]]
39
* [[InstallOrUpgradeReplicantFromMicroSD|using a computer and a microSD]]
40
* [[InstallOrUpgradeReplicantFromInternalStorage|using a computer and the internal storage to store the installation files]]
41 1 Denis 'GNUtoo' Carikli
42
Once this is done, you will need to do a factory reset.
43
44
h2. Factory reset
45
46
To do a Factory reset, you need to be in the recovery.
47
48
1. Select Factory reset
49
2. Select Wipe data (keep media)
50
3. It will ask you to confirm the wipe, so you will need to select Yes to confirm it.
51
4. Press the back key to get back to the general menu
52 6 Denis 'GNUtoo' Carikli
53
h2. Reboot the device
54
55
Once the factory reset is done, you can then reboot the device.
56
57
In the recovery:
58
1. Select Reboot system now to reboot the device
59 1 Denis 'GNUtoo' Carikli
2. Your device now has Replicant installed!
60 7 Denis 'GNUtoo' Carikli
61
h2. Backup the EFS
62
63
Now that Replicant is installed, it's a good idea to do a backup of the EFS partition which has the modem data.
64
65 11 Denis 'GNUtoo' Carikli
This way it would be way easier to restore it if it becomes corrupted ("it can sometimes happen with Replicant":https://redmine.replicant.us/issues/1869).
66
67 7 Denis 'GNUtoo' Carikli
Only the following devices that are supported by Replicant have an EFS:
68
* Galaxy S 2 (I9100)
69
* Galaxy S 3 (I9300)
70
* Galaxy S 3 4G (I9305)
71
* Galaxy Nexus (I9250)
72
* Galaxy Note (N7000)
73
* Galaxy Note 2 (N7100)
74
* Galaxy Tab 2 7.0 (P3100)
75
* Galaxy Tab 2 10.1 (P5100)
76
* Galaxy Note 8.0 (N5100)
77 11 Denis 'GNUtoo' Carikli
78
So you can skip this section if you have a device that is not mentioned in the list above.
79 7 Denis 'GNUtoo' Carikli
80
First make sure that you have adb setup correctly and that it gives you a root shell on the device by following the wiki page that explains how to [[ADB|install adb and get a root shell]] on your device.
81
82
Once this is done you can then backup the EFS.
83
84
For the Galaxy SIII (I9300), run the following commands to do that:
85
<pre>
86
mkdir backup_efs
87 8 Denis 'GNUtoo' Carikli
cd backup_efs
88 7 Denis 'GNUtoo' Carikli
adb pull /efs/ efs
89
adb shell "cat /dev/block/platform/*/by-name/EFS" > EFS.img 
90
</pre>
91
92 12 Denis 'GNUtoo' Carikli
For the Galaxy Nexus (I9250), run the following commands to do that:
93
<pre>
94
mkdir backup_efs
95
cd backup_efs
96
adb pull /factory/ factory
97
adb shell "cat /dev/block/platform/*/*/by-name/efs" > efs.img 
98
</pre>
99
100
101 7 Denis 'GNUtoo' Carikli
This will create a copy of the contents of /efs in the backup_efs directory. It will also backup the full partition.
102
Keep these files around as a backup in case anything goes wrong.