Replicant

h1. GTA04 Installation

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.

<pre>

Usage: ./replicant_gta04_install.sh [FILES_BASE] [DRIVE]

Arguments:

- The [FILES_BASE] argument is the path to the files

  The following files must be in that directory:

  MLO, u-boot.bin, splash.rgb16z, boot.scr, boot.img, system.tar.bz2

- The [DRIVE] argument is the sdcard drive node and can be omitted

</pre>

# 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 |