GTA04Installation » History » Version 13
Paul Kocialkowski, 04/24/2014 08:52 PM
1 | 1 | Paul Kocialkowski | h1. GTA04 Installation |
---|---|---|---|
2 | |||
3 | 13 | Paul Kocialkowski | h2. Prerequisites |
4 | |||
5 | In order to install Replicant on your device, it is assumed that you have a computer running a GNU/Linux operating system, a spare microSD card (at least 1GB and everything necessary to connect the card to the computer. Moreover, it is assumed that anyone performing the installation knows how to use command lines in a terminal and has basic knowledge about it. |
||
6 | |||
7 | h2. Downloading the files |
||
8 | |||
9 | 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. |
||
10 | |||
11 | 1. Find out what the latest image is: check out the @Last image@ part of the general table on [[GTA04]] |
||
12 | 2. Download *all* the files listed for the device (including the checksum and the signatures) on [[ReplicantImages]] for the latest image |
||
13 | 2. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring |
||
14 | 3. Check the signature of the files: |
||
15 | <pre> |
||
16 | gpg --armor --verify path/to/replicant-4.2-gta04.zip.img.sig path/to/replicant-4.2-crespo.zip |
||
17 | gpg --armor --verify path/to/recovery.img.sig path/to/recovery.img |
||
18 | </pre> |
||
19 | 4. Make sure the check succeeds, *do not install anything if it doesn't*! |
||
20 | 5. Check the checksum of the files: |
||
21 | <pre> |
||
22 | md5sum -c gta04.md5 |
||
23 | </pre> |
||
24 | 6. Make sure the check succeeds, *do not install anything if it doesn't*! |
||
25 | |||
26 | 9 | Paul Kocialkowski | h2. Replicant 4.0 installation |
27 | 1 | Paul Kocialkowski | |
28 | 9 | Paul Kocialkowski | Replicant installation requires a microSD card that is at least 1Gio. Note that this document refers to the microSD card as @sdcard@. |
29 | 1 | Paul Kocialkowski | |
30 | 10 | Paul Kocialkowski | Make sure you have all the required files to install Replicant: |
31 | 9 | Paul Kocialkowski | * MLO |
32 | * u-boot.bin |
||
33 | * splash.rgb16z |
||
34 | 5 | Paul Kocialkowski | * boot.scr |
35 | 1 | Paul Kocialkowski | * boot.img |
36 | * system.tar.bz2 |
||
37 | |||
38 | 9 | Paul Kocialkowski | To make it easier to install Replicant on GTA04, you can use the install script: replicant_gta04_install.sh. |
39 | 12 | Paul Kocialkowski | |
40 | 9 | Paul Kocialkowski | # Connect the sdcard to your computer |
41 | # Run the install script: |
||
42 | <pre> |
||
43 | ./replicant_gta04_install.sh path/to/files |
||
44 | </pre> |
||
45 | # Select the device that matches your sdcard (might be shown as USB card reader) |
||
46 | # Confirm erasing the drive by typing "y" |
||
47 | # Wait until the installation ends |
||
48 | # Remove the sdcard and insert it into the phone |
||
49 | # Start the phone, the power LED will show the boot status and the splashscreen will shortly appear |
||
50 | |||
51 | The POWER (bottom right) led indicates the status: |
||
52 | |||
53 | |_. Led color |_. Status | |
||
54 | | Orange | Loading Linux | |
||
55 | | Yellow | Completed | |
||
56 | | Red | Error | |
||
57 | |||
58 | *Your device should now be running Replicant!* |
||
59 | |||
60 | h2. Replicant 2.3 installation |
||
61 | |||
62 | Replicant installation requires a microSD card that is at least 1Gio. Note that this document refers to the microSD card as @sdcard@. |
||
63 | |||
64 | Make sure you have downloaded all the required files to install Replicant: |
||
65 | * replicant_gta04_install.sh |
||
66 | * bootloader.img |
||
67 | * boot.scr |
||
68 | * boot.img |
||
69 | * system.tar.bz2 |
||
70 | |||
71 | 1 | Paul Kocialkowski | To make it easier to install Replicant on GTA04, you can use the install script: replicant_gta04_install.sh. |
72 | |||
73 | 5 | Paul Kocialkowski | <pre> |
74 | Usage: ./replicant_gta04_install.sh [TYPE] [DRIVE] |
||
75 | 1 | Paul Kocialkowski | |
76 | 5 | Paul Kocialkowski | Arguments: |
77 | - The [TYPE] argument can either be: |
||
78 | * "install" to create an install sdcard |
||
79 | * "system" to create a system sdcard |
||
80 | - The [DRIVE] argument is the sdcard drive node and can be omitted |
||
81 | 1 | Paul Kocialkowski | |
82 | 5 | Paul Kocialkowski | Notes: |
83 | The following files must be present in the directory where you run the script: |
||
84 | * bootloader.img boot.scr boot.img (install) |
||
85 | * system.tar.bz2 (system) |
||
86 | </pre> |
||
87 | 1 | Paul Kocialkowski | |
88 | 5 | Paul Kocialkowski | h3. Creating an install sdcard |
89 | |||
90 | The install sdcard will flash the bootloader, the boot instructions and the kernel to the GTA04 NAND flash. |
||
91 | Make sure that the following files are in the directory where you run the script: @bootloader.img boot.scr boot.img@ |
||
92 | |||
93 | Process that way: |
||
94 | 1 | Paul Kocialkowski | <pre> |
95 | 5 | Paul Kocialkowski | ./replicant_gta04_install.sh install |
96 | </pre> |
||
97 | 1 | Paul Kocialkowski | |
98 | 5 | Paul Kocialkowski | If you know what the sdcard drive is, you can also specify it explicitly: |
99 | <pre> |
||
100 | ./replicant_gta04_install.sh install /dev/sde |
||
101 | 1 | Paul Kocialkowski | </pre> |
102 | |||
103 | 8 | Paul Kocialkowski | The script will then format the sdcard and copy the files. |
104 | Once it has completed with success (@Your drive is now ready to be used!@), put the sdcard in the phone and boot *while pressing the AUX button until it becomes lightened*. |
||
105 | 5 | Paul Kocialkowski | It will flash the files to the GTA04 NAND flash. |
106 | |||
107 | The AUX (top left) led indicates the status: |
||
108 | |||
109 | |_. Led color |_. Status | |
||
110 | | Orange | Flashing | |
||
111 | | Yellow | Completed | |
||
112 | | Red | Error | |
||
113 | |||
114 | If flashing failed, you might need to get a serial cable to investigate what's going on. |
||
115 | 6 | Paul Kocialkowski | |
116 | h3. Creating a system sdcard |
||
117 | |||
118 | The system sdcard holds the partitions required to hold the Replicant system files. |
||
119 | Make sure that the following files are in the directory where you run the script: @system.tar.bz2@ |
||
120 | |||
121 | Process that way: |
||
122 | <pre> |
||
123 | ./replicant_gta04_install.sh system |
||
124 | </pre> |
||
125 | |||
126 | If you know what the sdcard drive is, you can also specify it explicitly: |
||
127 | <pre> |
||
128 | ./replicant_gta04_install.sh system /dev/sde |
||
129 | </pre> |
||
130 | |||
131 | The script will then format the sdcard and copy the files. Once it has completed with success (@Your drive is now ready to be used!@), put the sdcard in the phone and boot. |
||
132 | Now you must leave the sdcard in the phone in order to boot Replicant. |
||
133 | |||
134 | The POWER (bottom right) led indicates the status: |
||
135 | |||
136 | |_. Led color |_. Status | |
||
137 | | Orange | Booting Linux | |
||
138 | | Yellow | Completed | |
||
139 | | Red | Error | |