Replicant

h1. GTA04 Installation

h2. Installing for µSD card storage

What you need is 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 on sdcard:

* bootloader.img

* boot.scr

* boot.img

* system.tar.bz2

h3. Getting the install script

To make it easier to install Replicant on GTA04, you can use the install script: replicant_gta04_install.sh.

It should be shipped with Replicant images or copied in @out/target/product/gta04/@ during the build process.

If you cannot find the script, download the latest version from gitorious: "replicant_gta04_install.sh":https://gitorious.org/replicant/device_goldelico_gta04/blobs/raw/replicant-2.3/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*.

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 |