GTA04Installation » History » Revision 13
Revision 12 (Paul Kocialkowski, 07/03/2013 09:39 PM) → Revision 13/24 (Paul Kocialkowski, 04/24/2014 08:52 PM)
h1. GTA04 Installation
h2. Prerequisites
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.
h2. Downloading the files
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.
1. Find out what the latest image is: check out the @Last image@ part of the general table on [[GTA04]]
2. Download *all* the files listed for the device (including the checksum and the signatures) on [[ReplicantImages]] for the latest image
2. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring
3. Check the signature of the files:
<pre>
gpg --armor --verify path/to/replicant-4.2-gta04.zip.img.sig path/to/replicant-4.2-crespo.zip
gpg --armor --verify path/to/recovery.img.sig path/to/recovery.img
</pre>
4. Make sure the check succeeds, *do not install anything if it doesn't*!
5. Check the checksum of the files:
<pre>
md5sum -c gta04.md5
</pre>
6. Make sure the check succeeds, *do not install anything if it doesn't*!
h2. Replicant 4.0 installation
Replicant installation requires a microSD card that is at least 1Gio. Note that this document refers to the microSD card as @sdcard@.
Make sure you have all the required files to install Replicant:
* MLO
* u-boot.bin
* splash.rgb16z
* boot.scr
* boot.img
* system.tar.bz2
To make it easier to install Replicant on GTA04, you can use the install script: replicant_gta04_install.sh.
# Connect the sdcard to your computer
# Run the install script:
<pre>
./replicant_gta04_install.sh path/to/files
</pre>
# Select the device that matches your sdcard (might be shown as USB card reader)
# Confirm erasing the drive by typing "y"
# Wait until the installation ends
# Remove the sdcard and insert it into the phone
# Start the phone, the power LED will show the boot status and the splashscreen will shortly appear
The POWER (bottom right) led indicates the status:
|_. Led color |_. Status |
| Orange | Loading Linux |
| Yellow | Completed |
| Red | Error |
*Your device should now be running Replicant!*
h2. Replicant 2.3 installation
Replicant installation requires a microSD card that is at least 1Gio. Note that this document refers to the microSD card as @sdcard@.
Make sure you have downloaded all the required files to install Replicant:
* replicant_gta04_install.sh
* bootloader.img
* boot.scr
* boot.img
* system.tar.bz2
To make it easier to install Replicant on GTA04, you can use the install script: replicant_gta04_install.sh.
<pre>
Usage: ./replicant_gta04_install.sh [TYPE] [DRIVE]
Arguments:
- The [TYPE] argument can either be:
* "install" to create an install sdcard
* "system" to create a system sdcard
- The [DRIVE] argument is the sdcard drive node and can be omitted
Notes:
The following files must be present in the directory where you run the script:
* bootloader.img boot.scr boot.img (install)
* system.tar.bz2 (system)
</pre>
h3. Creating an install sdcard
The install sdcard will flash the bootloader, the boot instructions and the kernel to the GTA04 NAND flash.
Make sure that the following files are in the directory where you run the script: @bootloader.img boot.scr boot.img@
Process that way:
<pre>
./replicant_gta04_install.sh install
</pre>
If you know what the sdcard drive is, you can also specify it explicitly:
<pre>
./replicant_gta04_install.sh install /dev/sde
</pre>
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 *while pressing the AUX button until it becomes lightened*.
It will flash the files to the GTA04 NAND flash.
The AUX (top left) led indicates the status:
|_. Led color |_. Status |
| Orange | Flashing |
| Yellow | Completed |
| Red | Error |
If flashing failed, you might need to get a serial cable to investigate what's going on.
h3. Creating a system sdcard
The system sdcard holds the partitions required to hold the Replicant system files.
Make sure that the following files are in the directory where you run the script: @system.tar.bz2@
Process that way:
<pre>
./replicant_gta04_install.sh system
</pre>
If you know what the sdcard drive is, you can also specify it explicitly:
<pre>
./replicant_gta04_install.sh system /dev/sde
</pre>
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.
Now you must leave the sdcard in the phone in order to boot Replicant.
The POWER (bottom right) led indicates the status:
|_. Led color |_. Status |
| Orange | Booting Linux |
| Yellow | Completed |
| Red | Error |