Skip to content
ericehlers edited this page Jan 9, 2012 · 5 revisions

There only exist debian-based images of QtMoko. The former FSO based images (with opkg; broken link or Progress 12) no longer seem to be maintained.

Table of Contents

Tools

To flash an image you need dfu-util.

You may also find http://wiki.openmoko.org/wiki/NeoTool (a GUI for DFU, for flashing the freerunner) useful

If you are using dfu-util from a distribution package, simply invoke:

sudo dfu-util [arguments]

If you have downloaded the dfu-util executable, invoke:

sudo /path/to/dfu-util [arguments]

Method 1: Installing on NAND

To flash an image you just have to download it along with the given kernel and flash them with these commands:

sudo dfu-util -a kernel -R -D name-of-file.bin
sudo dfu-util -a rootfs -R -D name-of-file.ubi

You will need the Qi bootloader instead of U-boot, if you are using the .ubi image. Download the version of Qi from the QtMoko download page.

Flash Qi with this command (similiar to flashing with u-boot):

sudo dfu-util -a u-boot -R -D name-of-file.udfu

If for some reasons you prefer U-boot you can flash it with this command:

sudo dfu-util -a u-boot -R -D name-of-file.bin

To use ubi and u-boot you need to configure it accordingly.

Method 2: Installing on microSD

To install QtMoko on your microSD you need Qi bootloader.

If you're using a .ubi QtMoko image, then you will need to use the version of Qi available from the QtMoko download page.

You can check how Qi works in the wiki page of Qi, but normally Qi is flashed easily on your Neo device with this simple command:

sudo dfu-util -a u-boot -R -D name-of-file.udfu

After you have Qi active on your Neo, you simply need to:

  • Make a partition in Ext3 on the microSD
  • Untar all the content of the QtMoko root file version in *.tar.gz format, that can be get from the QtMoko download page.
  • Then you simply re-boot and it will start automatically first from your microSD with QtMoko

Important post-install security step

BEWARE! The image you just installed uses an empty root password, so as soon as you connect to the internet, anyone in the world could log into your phone via ssh. Therefore the first thing to do after installing the image, is to change/set the root password, e.g. by using the terminal app on the device, or by logging in via ssh-over-usb.

You should also recreate the ssh key. In order to do this, you should type in the following commands through console using either the terminal on your phone, or through ssh (make sure the second command finishes execution before logging out):

rm /etc/ssh/ssh_host*key*
dpkg-reconfigure openssh-server

NB: Maybe recreation of the ssh key is no longer required in v36+? The ChangeLog for v36 includes the item "SSH server keys are generated on first boot".

Version specific

 V37:
   # installation for the GTA02 is not provided, to get v37 on the GTA02, install v35,
     then do apt-get update and apt-get upgrade.
 V36:
   # this release is experimental/unstable.  booting from NAND is known not to work.
 V26:
   # get the matching bootloader: [http://www.bsdmn.com/openmoko/gpsfix/u-boot_242_gps.udfu u-boot_242_gps.udfu] if you are using u-boot 
     or [http://www.openmobile.nl/modules/download_gallery/dlc.php?file=53 qi-s3c2442-master_c38b062a609f1442.udfu] if you are using Qi  and save it in /tmp<br>
   # download the kernel [http://sourceforge.net/projects/qtmoko/files/uImage-v26.bin/download here] and save it in /tmp<br>
   # download the rootfs [http://sourceforge.net/projects/qtmoko/files/qtmoko-debian-v26.jffs2/download here]and save it in /tmp<br>
   # Flash the bootloader (u-boot)
   dfu-util -a u-boot -R -D /tmp/u-boot_242_gps.udfu<br>
   or (Qi) 
   dfu-util -a u-boot -R -D /tmp/qi-s3c2442-master_c38b062a609f1442.udfu<br>
   # Flash the kernel
   dfu-util -a kernel -R -D /tmp/uImage-v26.bin<br>
   # Flash the rootfs
   dfu-util -a rootfs -R -D /tmp/qtmoko-debian-v26.jffs2<br>
   # powerdown the freerunner and power it on again.
   # in a console, uname -a should give you:
   # Linux neo 2.6.29-rc3-v26 #1 Sat Aug 28 13:11:14 CEST 2010 armv4tl GNU/Linux

Category:Distributions

Upgrading with apt

Once you have installed the debian-based version of qtmoko (or from a bare debian system), you can install/upgrade qtmoko with apt, by adding the repository detailed here.