Insert microSD in your freerunner and boot from SD-Card (press Power & AUX-Button together to get boot menue)

Select boot from microSD and after 3 automatic reboots and flashing the QtMoko is installed including Navit.

Installation

If you flash the FreeRunner with a kernel image from QtMoko, then you must install the kernel and the root file system with dfu-util.

NOTE: You need a fully charged Freerunner for installation.

Installation on SD card with Qi

Installing QtMoko on your microSD Card depends on the Bootloader you are using, U-Boot or Qi.

If you have Qi installed then you can install QtMoko on the SD card. This seems to be useful if you want to work with different distribution and you can change the distribution just by changing the microSD card in your FreeRunner.

NOTE: Installation in NAND-Memory with Qi is possible without errors, but with an installed bootloader Qi the boot process will terminate (with Qi installed by Android, which is modified). Install a non-Android Qi version or u-Boot instead!

If you use Qi, you only need an ext2 partition into your µSD Card where you uncompress the root filesystem image file qtmoko-debian-v26.tar.gz. In this case Qi Bootloader is going to look for the kernel image into the /boot directory for file named uImage-GTA02.bin .

Installation on SDHC card with u-Boot (Neo1973)

This procedure was tested only on Neo1973. The biggest disadvantage is the fact, that you will still be able to have only one distribution on the device at once. You can change the sd card, of course, or install another system to NAND flash, but you can have only one kernel flashed on device. The only advantage is more space for system.

All versions of the GTA02 (Neo FreeRunner) that have been sold to the public are version 5 hardware, so look for a file with "gta02" and "v5" in the name, for example:
u-boot-gta02v5-1.3.1.bin (linked U-Boot-Version from 31.Jan 2010):

sudo dfu-util -a u-boot -R -D u-boot-gta02v5-1.3.1.bin

Installation of Kernel and Root-FS NAND-Memory

Switch off your FreeRunner and press the AUX and Power-On button at the same time. Your FreeRunner is showing the following U-Boot Menu:

*** BOOT MENU (NOR) ***

Boot
Boot from microSD (FAT/ext2)
Set Console to USB
Set Console to Serial
Reboot
Power Off

The FreeRunner will stay in this mode for only 30 sec. Within this time you have to start dfu-util. If you want to flash the kernel image (you will need to be root on your PC) then you have to start the following command in the 30sec your see the BOOT MENU (use kernel and rootfs from http://sourceforge.net/projects/qtmoko/files/):

NOTE: Unzip extracts and overwrites the network settings files mentioned above. Due to this fact the usb0 MAC address changes for the USB connection to your freerunner. E.g. under Ubuntu 10.04 the new network interface for usb0 has to configure again

Now you have to restart your Freerunner, but you can also try from the command line of your neo:

If you want to use a map for another country, you can just store a downloaded Navit-Map in that folder and rename it osm_benelux.bin. If the map name should make sense, you have to edit the file navit.xml. See the Navit manual for details. You can find the navit.xml at:

# /usr/share/navit/navit.xml

Create the folder .navit in the home directory on your FR and copy navit.xml to this directory:

Starting Navit

Click on the white Paper Icon on the bottom left to open the context menu of the QX application.

Select Launch to start Navit.

Exit with AUX-Button without stopping navit.

VoIP

Integrated VoIP-Client

QtMoko has an integrated VoIP-Client, which would be perfect to use a SIP-Account to do free of charge mobile communication world wide. But at the moment the integrated VoIP-Client does not work, due to some strange problems in Version v24 (see QtMoko homepage for current status of development).

The script adds a syncal to QX-favourites and creates a desktop-definition file

/usr/share/applications/syncal.desktop

because without the desktop-definition file an application will not be visible in QX-favourites.

Settings for Remote ICS-files

After installation you have to edit the file

/usr/local/bin/synccal

with your confidential username, password and file URL for the remote ics files. You can import more than one remote ICS-files, so 2 variables for file URLs are defined. Change that to your appropriate number of remote ICS-files. See remotesync4ics2openmoko.sh for further details. If you do not want to store the password in the script for security reasons you can use xdialog for entering the vPWD via user interface (e.g. input box).

Setting up a Groupware Server for testing

If you want to setup your own groupware server for testing on your own Linux Box, you can try CitaDel. Accessing the remote ics-file are explained on the homepage of http://www.citadel.org.

Use Evolution iCal-file via SSHFS

Evolution stores the calendar data in the iCal-file calendar.ics. So you might to use the files directly.

If you running Evolution on you Linux-Box you can use SSHFS to mount the directory of Evolution in homedirectory e.g. in

/home/username/.evolution/calendar/local/system

You can use the iCal-file directly by mounting the directory mentioned above on the Freerunner. Now you can used the calendar.ics from the Linux-Box, if you mount the directory in (replace username by your account on your Linux-Box):

To test this script on your freerunner, you have to start it from the terminal in QX. Source of the xdialog script is used from http://xdialog.free.fr.

Apt-Get Problem jffs2

[Apt-Get] (jffs2) Couldn't make mmap ...: (solved with the following workaround)
If that happens regularly, create two scripts apt-start and apt-stop. These scripts are used before and after apt-get use.

Usage of Scripts

If you to install software use the scripts before and after apt-get call:

apt-start
apt-get install mysoftware
apt-stop

Replace mysoftware with the package you want to install e.g. linphone.

Data Safety / Boot Errors

Boot Errors due to Filesystem Corruption

In case your ext3 partition gets corrupted take out the sdcard from your freerunner, put it in a card reader and insert the card reader in one of the usb slots of your desktop linux system.
Find out the mount point of the ext3 partition but do not mount the partition. You can use the following command to find the partition:

cat /proc/partitions

Now you can run from command line where /dev/sdXX is the qtmoko partition on your sd card (/dev/sdc2 in the example below):

fsck /dev/sdc2

and you will be asked to confirm the error correction. If you just want to have any errors corrected run

fsck -y /dev/sdc2

Backing up whole partitions

To backup whole partitions to your local desktop computer navigate to the directory where you'd like to have the files written to (in this case /home/limo/) open a terminal in that directory and run the two commands below (it assumes the following paritioning of the sdcard: 1st partition = vfat 2nd partition = qtmoko on some ext filesystem):

Backing up your contacts

In contacts menu there is "Send All..." You can then send contacts using
bluetooth or email. If you use email and you don't have smtp setup up, you can download the mail
message from /home/root/Applications/qtopiamail and open in e.g. in kmail
and save the VCF attachment.

Reinstallation of the contacts is much easier: After reinstall you can just click on it and QtMoko imports them.
Regards

Links

SVG Keyboards (from QtMoko v45 onwards)

Since QtMoko v45 you can customize your keyboard via simple svg files which can be easily edited in inkscape.
Here is the original post:

Layouts are completely customizable. You can easily change key size, position,
background. It's very easy to add international characters and new layouts.
Just have a look at /opt/qtmoko/etc/im/svgkbd/ The layouts are normal svg
images. You can use inkscape to open and edit them. It should be very clear
what to do. Only thing to explain is how you should name the key XML elements.
In Inkscape go to Edit->XML editor and click on key. The element name must be
in form:

key_QtKeycode_unicode

For possible QtKeycode values check this link qt-keycodes and for unicode values use
your favourite unicode character map.

Manual installation

This installation will remove the original keyboards!!!
If you want to keep them backup everything in root@192.168.0.202:/opt/qtmoko/etc/im/svgkbd/

To install the keyboard download File:DE de.tar.gz, go to your download directory and use

DE_de Layout

This layout has a portrait and a landscape mode for the abc.svg keyboard (more a SMS keyboard now). The portrait mode is default which means that abc.svg is just a copy of abc_portrait.svg. If you prefer the landscape mode just copy the abc_landscape.svg to abc.svg.

abc_portrait.svg = default abc.svg

abc_landscape.svg

qwerty.svg

qwerty_shift.svg

Installation via Package-Manger

Radek has packaged the keyboard as a .deb package so you can simple navigate to "more apps" and look for keyboards. Do not forget
to restart QtMoko afterwards.

Insert microSD in your freerunner and boot from SD-Card (press Power & AUX-Button together to get boot menue)

Select boot from microSD and after 3 automatic reboots and flashing the QtMoko is installed including Navit.

Installation

If you flash the FreeRunner with a kernel image from QtMoko, then you must install the kernel and the root file system with dfu-util.

NOTE: You need a fully charged Freerunner for installation.

Installation on SD card with Qi

Installing QtMoko on your microSD Card depends on the Bootloader you are using, U-Boot or Qi.

If you have Qi installed then you can install QtMoko on the SD card. This seems to be useful if you want to work with different distribution and you can change the distribution just by changing the microSD card in your FreeRunner.

NOTE: Installation in NAND-Memory with Qi is possible without errors, but with an installed bootloader Qi the boot process will terminate (with Qi installed by Android, which is modified). Install a non-Android Qi version or u-Boot instead!

If you use Qi, you only need an ext2 partition into your µSD Card where you uncompress the root filesystem image file qtmoko-debian-v26.tar.gz. In this case Qi Bootloader is going to look for the kernel image into the /boot directory for file named uImage-GTA02.bin .

Installation on SDHC card with u-Boot (Neo1973)

This procedure was tested only on Neo1973. The biggest disadvantage is the fact, that you will still be able to have only one distribution on the device at once. You can change the sd card, of course, or install another system to NAND flash, but you can have only one kernel flashed on device. The only advantage is more space for system.

All versions of the GTA02 (Neo FreeRunner) that have been sold to the public are version 5 hardware, so look for a file with "gta02" and "v5" in the name, for example:
u-boot-gta02v5-1.3.1.bin (linked U-Boot-Version from 31.Jan 2010):

sudo dfu-util -a u-boot -R -D u-boot-gta02v5-1.3.1.bin

Installation of Kernel and Root-FS NAND-Memory

Switch off your FreeRunner and press the AUX and Power-On button at the same time. Your FreeRunner is showing the following U-Boot Menu:

*** BOOT MENU (NOR) ***

Boot
Boot from microSD (FAT/ext2)
Set Console to USB
Set Console to Serial
Reboot
Power Off

The FreeRunner will stay in this mode for only 30 sec. Within this time you have to start dfu-util. If you want to flash the kernel image (you will need to be root on your PC) then you have to start the following command in the 30sec your see the BOOT MENU (use kernel and rootfs from http://sourceforge.net/projects/qtmoko/files/):

NOTE: Unzip extracts and overwrites the network settings files mentioned above. Due to this fact the usb0 MAC address changes for the USB connection to your freerunner. E.g. under Ubuntu 10.04 the new network interface for usb0 has to configure again

Now you have to restart your Freerunner, but you can also try from the command line of your neo:

If you want to use a map for another country, you can just store a downloaded Navit-Map in that folder and rename it osm_benelux.bin. If the map name should make sense, you have to edit the file navit.xml. See the Navit manual for details. You can find the navit.xml at:

# /usr/share/navit/navit.xml

Create the folder .navit in the home directory on your FR and copy navit.xml to this directory:

Starting Navit

Click on the white Paper Icon on the bottom left to open the context menu of the QX application.

Select Launch to start Navit.

Exit with AUX-Button without stopping navit.

VoIP

Integrated VoIP-Client

QtMoko has an integrated VoIP-Client, which would be perfect to use a SIP-Account to do free of charge mobile communication world wide. But at the moment the integrated VoIP-Client does not work, due to some strange problems in Version v24 (see QtMoko homepage for current status of development).

The script adds a syncal to QX-favourites and creates a desktop-definition file

/usr/share/applications/syncal.desktop

because without the desktop-definition file an application will not be visible in QX-favourites.

Settings for Remote ICS-files

After installation you have to edit the file

/usr/local/bin/synccal

with your confidential username, password and file URL for the remote ics files. You can import more than one remote ICS-files, so 2 variables for file URLs are defined. Change that to your appropriate number of remote ICS-files. See remotesync4ics2openmoko.sh for further details. If you do not want to store the password in the script for security reasons you can use xdialog for entering the vPWD via user interface (e.g. input box).

Setting up a Groupware Server for testing

If you want to setup your own groupware server for testing on your own Linux Box, you can try CitaDel. Accessing the remote ics-file are explained on the homepage of http://www.citadel.org.

Use Evolution iCal-file via SSHFS

Evolution stores the calendar data in the iCal-file calendar.ics. So you might to use the files directly.

If you running Evolution on you Linux-Box you can use SSHFS to mount the directory of Evolution in homedirectory e.g. in

/home/username/.evolution/calendar/local/system

You can use the iCal-file directly by mounting the directory mentioned above on the Freerunner. Now you can used the calendar.ics from the Linux-Box, if you mount the directory in (replace username by your account on your Linux-Box):

To test this script on your freerunner, you have to start it from the terminal in QX. Source of the xdialog script is used from http://xdialog.free.fr.

Apt-Get Problem jffs2

[Apt-Get] (jffs2) Couldn't make mmap ...: (solved with the following workaround)
If that happens regularly, create two scripts apt-start and apt-stop. These scripts are used before and after apt-get use.

Usage of Scripts

If you to install software use the scripts before and after apt-get call:

apt-start
apt-get install mysoftware
apt-stop

Replace mysoftware with the package you want to install e.g. linphone.

Data Safety / Boot Errors

Boot Errors due to Filesystem Corruption

In case your ext3 partition gets corrupted take out the sdcard from your freerunner, put it in a card reader and insert the card reader in one of the usb slots of your desktop linux system.
Find out the mount point of the ext3 partition but do not mount the partition. You can use the following command to find the partition:

cat /proc/partitions

Now you can run from command line where /dev/sdXX is the qtmoko partition on your sd card (/dev/sdc2 in the example below):

fsck /dev/sdc2

and you will be asked to confirm the error correction. If you just want to have any errors corrected run

fsck -y /dev/sdc2

Backing up whole partitions

To backup whole partitions to your local desktop computer navigate to the directory where you'd like to have the files written to (in this case /home/limo/) open a terminal in that directory and run the two commands below (it assumes the following paritioning of the sdcard: 1st partition = vfat 2nd partition = qtmoko on some ext filesystem):

Backing up your contacts

In contacts menu there is "Send All..." You can then send contacts using
bluetooth or email. If you use email and you don't have smtp setup up, you can download the mail
message from /home/root/Applications/qtopiamail and open in e.g. in kmail
and save the VCF attachment.

Reinstallation of the contacts is much easier: After reinstall you can just click on it and QtMoko imports them.
Regards

Links

SVG Keyboards (from QtMoko v45 onwards)

Since QtMoko v45 you can customize your keyboard via simple svg files which can be easily edited in inkscape.
Here is the original post:

Layouts are completely customizable. You can easily change key size, position,
background. It's very easy to add international characters and new layouts.
Just have a look at /opt/qtmoko/etc/im/svgkbd/ The layouts are normal svg
images. You can use inkscape to open and edit them. It should be very clear
what to do. Only thing to explain is how you should name the key XML elements.
In Inkscape go to Edit->XML editor and click on key. The element name must be
in form:

key_QtKeycode_unicode

For possible QtKeycode values check this link qt-keycodes and for unicode values use
your favourite unicode character map.

Manual installation

This installation will remove the original keyboards!!!
If you want to keep them backup everything in root@192.168.0.202:/opt/qtmoko/etc/im/svgkbd/

To install the keyboard download File:DE de.tar.gz, go to your download directory and use

DE_de Layout

This layout has a portrait and a landscape mode for the abc.svg keyboard (more a SMS keyboard now). The portrait mode is default which means that abc.svg is just a copy of abc_portrait.svg. If you prefer the landscape mode just copy the abc_landscape.svg to abc.svg.

abc_portrait.svg = default abc.svg

abc_landscape.svg

qwerty.svg

qwerty_shift.svg

Installation via Package-Manger

Radek has packaged the keyboard as a .deb package so you can simple navigate to "more apps" and look for keyboards. Do not forget
to restart QtMoko afterwards.