wiki:Devices/GTA/InstallGuide

Version 12 (modified by slyon, 6 years ago) (diff)

fix typo

What to install?

There is more than one way to install SHR on the openmoko phones, simply because they have:

  • A microsd slot
  • 256M of flash(freerunner/gta02) or 64M of flash(neo1973/gta01)

And also because there are more than one version of SHR:

  • SHR Core : it's the place where all the development takes place
  • SHR Unstable: old but more stable images, contains more software in the feeds, development abandoned
  • SHR testing : even older, supposed to be even more stable, development abandoned?

Combined with different image versions:

  • shr-image Lite: it contains the minimum to be able to use your phone
  • shr-image Full: it contains more than the minimum(for instance an IM client or a web browser)
  • aurora image: this is a very different image from the aurora project, it's an image meant for emulating a non-smart phone(also called feature-phone)

The actual Installation

Installing on the Flash using a GUI

We're going to assume that you know how to use NeoTool.

First, determine which model of phone you have, the GTA01 (neo1973) or the GTA02 (FreeRunner).

You need to download two files from your prefered version above:

  • The kernel (uImage*.bin)
  • The root filesystem (shr*.rootfs.jffs2)

Choose if you want the lite or the complete SHR according to this page. Please note that the GTA01's internal flash only has room for the unstable version's LITE image.

Installing on the microsd from the command line

  • Download an image
  • Connect your microsd to your computer
  • format your microsd to ext2 or ext3(that loose all the data that is on it)
  • mount your microsd
  • go inside the place where your microsd is mounted
  • extract the image to the microsd:
    sudo tar xvzpf  /path/to/full-om-gta02.tar.gz --numeric-owner
    

Installing on the flash from the command line

Two kinds of filesystem are provided, the old jffs2 and the new ubifs. ubifs is more space efficent, so prefer ubifs.

Openmoko GTA01

  • Since the openmoko GTA01 have limited space on the flash, the full image cannot be installed on the flash of theses devices, instead prefer the light image
  • The openmoko GTA01 also only have one and only one bootloader

Openmoko GTA02

  • Since the freerunner has two bootloaders(one in NOR, and one in NAND (NAND and NOR are two different kinds of flash devices), you can safely flash a bootloader on NAND), it is possible to flash QI, a less complex bootloader. Two bootloaders are available:
    • QI (preferred)
    • U-boot

Post install

Connecting your FreeRunner to your computer

For the next configuration steps, you will need to type some commands. It is much easier to type on a real keyboard than on a touch screen. So you need to connect your FR to you computer, and make a bridge to internet. Use this page

Update your system

First of all, in setting menu, put "suspend" on "off". Just type

opkg update
opkg upgrade

Setting local time

As any linux system, the UTC time is used by the system. First of all, adjust this time:

date -u -s 010220052009
 Fri Jan  2 20:05:00 UTC 2009

Then, you need to "localise?" your system. Search for the appropriate country with:

 opkg list | grep tzdata

then install the one corresponding to your area.

opkg install tzdata-europe

Then select your city (search the city availabled in /usr/share/zoneinfo/your-country)

You can fully localise your system by installing the glibc-binary-localedata corresponding to your language. Search the ones available with:

opkg list | grep glibc-binary-localedata

install with

 opkg install glibc-binary-localedata-fr-fr

(example for France)

 ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime

Changing root password

SHR is shipped without root password. This is very dangerous if you connect using wifi, or USB. You must activate the root password:

 passwd

then type your selected password two times, otherwise you will not be able to get your FreeRunner connected to your pc.