GTA04Installation » History » Revision 14
Revision 13 (Paul Kocialkowski, 04/24/2014 08:52 PM) → Revision 14/24 (Paul Kocialkowski, 05/06/2014 08:05 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) 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-gta04.zip path/to/replicant-4.2-crespo.zip gpg --armor --verify path/to/bootable.zip.sig path/to/bootable.zip path/to/recovery.img.sig path/to/recovery.img gpg --armor --verify path/to/replicant_gta04_install.sh.sig path/to/replicant_gta04_install.sh </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. Preparing the microSD card Replicant 4.0 installation In order to install Replicant on the installation requires a microSD card, it has card that is at least 1Gio. Note that this document refers to be set up with the base bootable files first: 1. Connect the microSD card to the computer (e.g. using an USB card reader) 2. as @sdcard@. Make sure that you have all the @bootable.zip@ file is placed within the same directory as the @replicant_gta04_install.sh@ script (or change the @FILES_BASE@ variable in the script required files to the correct path) install Replicant: 3. Make sure that the @/mount@ directory exists and * MLO * u-boot.bin * splash.rgb16z * boot.scr * boot.img * system.tar.bz2 To make it easier to install Replicant on GTA04, you can be used for creating @boot@, @system@, @cache@ and @data@ sub-folders (or change use the @MOUNT_BASE@ variable in install script: replicant_gta04_install.sh. # Connect the script sdcard to the correct path) your computer 4. Setup # Run the card using the installation script (you can provide the block device node as a second argument): install script: <pre> ./replicant_gta04_install.sh setup path/to/files </pre> *Note: you might want to run this command # Select the device that matches your sdcard (might be shown as root, since operations will fail with an unprivileged user!* USB card reader) 5. If you didn't provide # Confirm erasing the block device node, select which device to use for drive by typing "y" # Wait until the installation ends 6. The script should report that # Remove the process was completed sdcard and that insert it into the card can be removed phone 7. Disconnect # Start the microSD card from phone, the computer power LED will show the boot status and the splashscreen will shortly appear h2. Installing The POWER (bottom right) led indicates the system status: Once the |_. 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 prepared, it is possible at least 1Gio. Note that this document refers to insert it in the phone though no system is installed yet. It is possible 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 either from on GTA04, you can use the host computer or from the device. install script: replicant_gta04_install.sh. h3. From the host computer <pre> Usage: ./replicant_gta04_install.sh [TYPE] [DRIVE] 1. Connect the microSD card back Arguments: - The [TYPE] argument can either be: * "install" to the computer (e.g. using create an USB card reader) install sdcard * "system" to create a system sdcard 2. Make sure that the @replicant-4.2-gta04.zip@ file - The [DRIVE] argument is placed within the same sdcard drive node and can be omitted Notes: The following files must be present in the directory as where you run the @replicant_gta04_install.sh@ script (or change script: * bootloader.img boot.scr boot.img (install) * system.tar.bz2 (system) </pre> h3. Creating an install sdcard The install sdcard will flash the @FILES_BASE@ variable in bootloader, the script boot instructions and the kernel to the correct path) GTA04 NAND flash. 3. Make sure that the @/mount@ directory exists and can be used for creating @boot@, @system@, @cache@ and @data@ sub-folders (or change the @MOUNT_BASE@ variable following files are in the script to directory where you run the correct path) script: @bootloader.img boot.scr boot.img@ Process that way: 4. Install the system to the card using the installation script (you can provide the block device node as a second argument): <pre> ./replicant_gta04_install.sh install </pre> *Note: you might want to run this command as root, since operations will fail with an unprivileged user!* 5. If you didn't provide know what the block device node, select which device to use for installation sdcard drive is, you can also specify it explicitly: 6. <pre> ./replicant_gta04_install.sh install /dev/sde </pre> The script should report that will then format the process was completed sdcard and that copy the card can files. Once it has completed with success (@Your drive is now ready to be removed 7. Disconnect used!@), put the microSD card from sdcard in the computer phone and boot *while pressing the AUX button until it becomes lightened*. 8. Insert It will flash the microSD card in files to the device and power GTA04 NAND flash. The AUX (top left) led indicates the device on: the device should boot normally (the power light should stay orange for status: |_. Led color |_. Status | | Orange | Flashing | | Yellow | Completed | | Red | Error | If flashing failed, you might need to get a short time and then switch green) serial cable to investigate what's going on. *Your device should now be running Replicant!* h3. From the device Creating a system sdcard 1. Insert The system sdcard holds the microSD card in partitions required to hold the device and power the device on: the device should boot normally (the power light should stay orange for a short time and then switch green) Replicant system files. 2. Make sure that the device boots to recovery 3. Connect following files are in the USB cable to both directory where you run the computer and the device script: @system.tar.bz2@ Process that way: 4. Select *install zip* (using the AUX key to navigate and the power key to select) <pre> 5. Select *install zip from sideload* ./replicant_gta04_install.sh system 5. Back to </pre> If you know what the host computer, load the system zip with sideload: sdcard drive is, you can also specify it explicitly: <pre> adb sideload path/to/replicant-4.2-gta04.zip ./replicant_gta04_install.sh system /dev/sde </pre> 6. Make sure The script will then format the file sdcard and copy the files. Once it has completed with success (@Your drive is being transfered 7. Select *Go Back* (if necessary) now ready to get back to be used!@), put the general menu sdcard in the phone and boot. 8. Select *wipe data/factory reset* 9. Confirm Now you must leave the data wipe by selecting *Yes -- delete all user data* 10. Select *Reboot system now* sdcard in the phone in order to reboot boot Replicant. The POWER (bottom right) led indicates the device status: *Your device should now be running Replicant!* |_. Led color |_. Status | | Orange | Booting Linux | | Yellow | Completed | | Red | Error |