Project

General

Profile

Actions

GTA04Installation » History » Revision 13

« Previous | Revision 13/24 (diff) | Next »
Paul Kocialkowski, 04/24/2014 08:52 PM


GTA04 Installation

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.

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 Replicant release key to your GPG keyring
3. Check the signature of the files:

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

4. Make sure the check succeeds, do not install anything if it doesn't!
5. Check the checksum of the files:
md5sum -c gta04.md5

6. Make sure the check succeeds, do not install anything if it doesn't!

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.

  1. Connect the sdcard to your computer
  2. Run the install script:
    ./replicant_gta04_install.sh path/to/files
    
  3. Select the device that matches your sdcard (might be shown as USB card reader)
  4. Confirm erasing the drive by typing "y"
  5. Wait until the installation ends
  6. Remove the sdcard and insert it into the phone
  7. 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!

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.

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)

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:

./replicant_gta04_install.sh install

If you know what the sdcard drive is, you can also specify it explicitly:

./replicant_gta04_install.sh install /dev/sde

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.

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:

./replicant_gta04_install.sh system

If you know what the sdcard drive is, you can also specify it explicitly:

./replicant_gta04_install.sh system /dev/sde

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

Updated by Paul Kocialkowski about 10 years ago · 13 revisions

Also available in: PDF HTML TXT