GTA04 microSD Installation Guide

This is a step-by-step guide, which should get you from zero to a working SHR on your GTA04 in just a few minutes.

Getting the files

• shr-core image:
  •  shr-image-om-gta04.tar.gz (latest stable image)
  •  shr-image-om-gta04.tar.gz (latest staging image, for testers only)
• gta04-init system:
  •  gta04-init

Preparing the microSD card

Your microSD card needs to have 2 partitions. One for the bootloader and one for the rootfs and the kernel:

• 1st partition: FAT32, "boot"
• 2nd partition: ext3, "rootfs"

Furthermore, it needs to be formatted with: 255 heads, 63 sectors/track.
To get this right, you can easily use this script: omap3-mkcard.sh

sudo ./omap3-mkcard.sh /dev/mmcblk0

Installing the gta04-init system

To install gta04-init, you have to untar the gta04-init archive (qtmoko-fat-v44.tar.vz) and copy all containing files to the "boot"-partition.

It is important to copy the 1st stage bootloader (MLO) to the microSD card as the very first file.

mkdir gta04-init
tar xzvpf qtmoko-fat-v44.tar.gz -C ./gta04-init
cd gta04-init/
cp MLO /media/boot/MLO
cp -r bootargs.scr boot.scr gta04-init menu.rgb16z splash.rgb16z u-boot.bin uImage user.scr x-load.flash /media/boot/

Installing SHR

To install the SHR image, you have to untar the image you downloaded to the "rootfs"-partition.

tar xzvpf shr-image.tar.gz --numeric-owner -C /media/rootfs

First boot

After you cleanly unmounted the 2 partitions and put the microSD card back into the GTA04 you can boot SHR.

You will be greeted by the gta04-init bootloader, where you have to select to boot from microSD. There is no feedback after a click, you just have to wait until SHR is booted.

Next, a first start wizard will pop up, which let's you choose between some options.
Be aware to choose a scale factor of 2.0 when asked. Other than this you could just keep the defaults.

You can now login via USB networking at: 192.168.7.2

required(else telephony and suspend won't work) post-install

opkg install fsoaudiod gta04-gps-handler gta04-gps-handler-systemd.

Installing Firmware

If you want to use the WiFi/Bluetooth chip, you have to use a non-free firmware from Marvell.
To get it you have to install linux-firmware-sd8686.

opkg install linux-firmware

Congratulations

You successfully installed SHR on your GTA04.
If you need further information or have any issues, please have a look below (Troubleshooting) or in the InstallGuide/Advanced section.

GTA04 NAND Installation Guide

• Here are the NAND partitions:

  # cat /proc/mtd 
  dev:    size   erasesize  name
  mtd0: 00080000 00020000 "X-Loader"
  mtd1: 001e0000 00020000 "U-Boot"
  mtd2: 00020000 00020000 "U-Boot Env"
  mtd3: 00400000 00020000 "Kernel"
  mtd4: 1f980000 00020000 "File System"
  

• Install SHR on microsd
• Boot on microsd
• Copy the uImage-om-gta04.bin, shr-image-om-gta04.ubi,u-boot.bin in the second partition
• Copy x-load.flash in the first partition
• Boot SHR on microsd and run the following:

  nandwrite -p /dev/mtd4 shr-image-om-gta04.ubi
  nandwrite -p /dev/mtd3 uImage-om-gta04.bin
  nandwrite -p /dev/mtd1 u-boot.bin
  

• Then reboot into u-boot: connect the serial cable and press enter(there is no other way yet(we will have to develop some uboot scripts) since x-loader partition is read only)
• flash x-load:

  mtdparts default
  mmcinfo
  fatload mmc 0:1 0x82000000 /x-load.flash
  nandecc hw
  # write some copies
  nand erase 0 80000
  nand write 0x80200000 0 20000
  nand write 0x80200000 20000 20000
  nand write 0x80200000 60000 20000
  powerdown
  

Use powerdown and not reset because reset doesn't seem to work...

Troubleshooting

Please add your questions here:

Q:
A: