Project

General

Profile

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 |