Qtopia / Qt Extended on FreeRunner

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Current status: s/match/work/)
m (Preparing the SD card: use pre-formatting for command block (to have commands now in separate lines, using space-indentation as didn't work; don't know why))
Line 46: Line 46:
 
See the [[Booting from SD#Prepare the SD card| Preparing the SD Card]] section of the [[Booting from SD]] page for partitioning and formatting instructions.  After you complete the "Formatting the SD Card" steps, return here and execute the following:
 
See the [[Booting from SD#Prepare the SD card| Preparing the SD Card]] section of the [[Booting from SD]] page for partitioning and formatting instructions.  After you complete the "Formatting the SD Card" steps, return here and execute the following:
  
 +
<pre>
 
mount /dev/mmcblk0p1 /media/card
 
mount /dev/mmcblk0p1 /media/card
 
mkdir /media/card/boot
 
mkdir /media/card/boot
Line 51: Line 52:
 
mkdir /media/mmcblk0p2
 
mkdir /media/mmcblk0p2
 
mount /dev/mmcblk0p2 /media/mmcblk0p2
 
mount /dev/mmcblk0p2 /media/mmcblk0p2
 +
</pre>
  
 
This will set you up properly for the installation of the root filesystem and the kernel in the steps below.
 
This will set you up properly for the installation of the root filesystem and the kernel in the steps below.

Revision as of 16:35, 11 November 2008


This page provides instructions on how to install Qtopia/Qt Extended (proper, not the ASU or QtopiaOnX11 efforts) on the GTA02 (FreeRunner) phone. It is similar to the Qtopia on Neo1973 page.

Contents

Current status

On 31 October 2008, Trolltech released the Qtopia ROM flash image containing the rootfs for the Openmoko Neo FreeRunner (gta02) containing the Qtopia 4.4.2 release (GPL version). This runs on the mwebster ROM flash image containing the kernel. At release time, 4.4.2 & current mwester's kernel mismatched, please clarify the previous sentence. Hypnotize has released Qt Extended 4.4.2 images for the Neo FreeRunner that work better.

This image can successfully make and receive calls and text messages. It can read all contacts from the SIM card (which the updated 2007.2 does not appear to be able to do). It contains apps that appear to be more stable than the ones found in the 2007.2 image. It has multiple input methods that appear to be more mature. It does not, however, have a web browser or a GPS application. There are however at least three third-party GPS applications available:

On 2nd of September 2008 Trolltech also released a 4.3.3-snapshot which fixes a number issues (sms messages not retrieved after resume; Qtopia getting confused between two calls; Make default call volume down and mic up; Added echo fix.)

You can find all the Qtopia images here (including Qtextended/Qtopia 4.4 for FreeRunner and Neo1973!)

What is in the latest release (Qtopia 4.4)?

Qtopia 4.4 has been released with the name of QtExtended 4.4.

Option 1: Flashing Qtopia to FreeRunner

Download the image mentioned above and follow the instructions here: Flashing the Neo FreeRunner

Option 2: Dual-Booting between Qtopia and 2007.2 (Qtopia boots from MicroSD card)

Installation Requirements:

  1. SSH shell access to 2007.2 based image of the FreeRunner through USB interface or WLAN.
  2. A Desktop Linux distro (to unpack the .jffs2 image, I ran Ubuntu under VMWare)


Preparing the SD card

See the Preparing the SD Card section of the Booting from SD page for partitioning and formatting instructions. After you complete the "Formatting the SD Card" steps, return here and execute the following:

mount /dev/mmcblk0p1 /media/card
mkdir /media/card/boot

mkdir /media/mmcblk0p2
mount /dev/mmcblk0p2 /media/mmcblk0p2

This will set you up properly for the installation of the root filesystem and the kernel in the steps below.

Installing Qtopia

Unpacking the Qtopia Root Filesystem Image

Download the Qtopia FLASH image from Latest Images#Qtopia images to your Linux box and extract its contents:

tar xzf qtopia-4.3.2-gta02-flash-*.tgz

You should now have two files:

  1. uImage-2.6.24+git18+9c058ff0d2641df3c36fc3300acb72078d2c41d4-r0-om-gta02.bin
  2. qtopia-4.3.2-gta02-rootfs-07172049.jffs2

Now, mount the root file system from the jffs2 using the commands found here. However, in the mount command, substitute the image filename for "/dev/mtdblock0".

Creating a compressed tarball

Next, tar up the root filesystem:

  1. tar czf qtopia-4.3.2-gta02-rootfs-07172049.tar.gz -C <mountpoint> .

Where <mountpoint> is the location where the jff2 filesystem was mounted. Note the space and the period after the mountpoint.

Installing Root Filesystem

Transfer this compressed tarball to the second partition of the MicroSD that is mounted on the FreeRunner:

scp qtopia-4.3.2-gta02-rootfs-07172049.tar.gz root@192.168.0.202:/media/mmcblk0p2/

Log in to your FreeRunner and unpack the root filesystem:

cd /media/mmcblk0p2 tar xzf qtopia-4.3.2-gta02-rootfs-07172049.tar.gz rm qtopia-4.3.2-gta02-rootfs-07172049.tar.gz rm -f /media/mmcblk0p2/boot/*

Note: the last step removes the kernel image from the second partition. For some reason, U-Boot cannot find the uImage.bin file in the first partition if a kernel image exists in the second partition boot/ directory.

Installing Kernel

From your Linux box, rename uImage-2.6.24+git18+9c058ff0d2641df3c36fc3300acb72078d2c41d4-r0-om-gta02.bin to uImage.bin and copy it to the boot directory on the first partition of the MicroSD card. Depending on the version of U-Boot you have installed, this may not work. To prevent any possible issues, copy it to the /media/card directory as well. There is plenty of room on the first partition to have uImage.bin in both locations.

mv uImage-2.6.24+git18+9c058ff0d2641df3c36fc3300acb72078d2c41d4-r0-om-gta02.bin uImage.bin scp uImage.bin root@192.168.0.202:/media/card/boot/ scp uImage.bin root@192.168.0.202:/media/card/

Pointing Qtopia to the SD Card

Lorn Potter on the mailing lists pointed this out:

Qtopia was designed to be run from the root partition on a flash chip, not from a removable sd card.

You would have to edit the etc/default/Trolltech/Storage.conf file to make it forget about the sd /dev node, to be able to run it this way"

Another user's solution to this is the following:

Edit this file: " /opt/Qtopia/etc/default/Trolltech/Storage.conf And change the [MountPoint0] section so it resembles this: -[ [MountPoint0] Name[] = SD Card Path=/dev/mmcblk0p1 Removable = 0 Applications = 0 Documents = 0 ContentDatabase = 0

Option 3: updating from source

NOTE: This will upgrade only opt/Qtopia directory, you should use opkg update/upgrade for the rest


Original Qtopia images (the distribution released by Trolltech, not ASU) are rarely released as a rootfs image, but the source code is often updated. If you want to reflash your OM with the latest version of Qtopia you might build it from sources. This has been explained in this thread of the community mailing list. Summing up:

cd / wget http://qtopia.net/downloads/neo/arm920t-eabi-ficgta01-toolchain.tgz tar xvzf arm920t-eabi-ficgta01-toolchain.tgz

tar xvzf qtopia-opensource-src-4.3.2-snapshot-20080806.tar.gz

  • make a "build" dir

mkdir build cd build

  • configure and make:

../qtopia-opensource-src-4.3.2-snapshot-20080806/configure -device ficgta01 make This will take some time (couple hours). Note that the option "-device ficgta01" should work for both neo and freerunner. Then:

make install

will make a root directory into the build directory. There you can find an image that directory should be copied to /opt/Qtopia of your phone with scp. once done restart qpe or whole phone.

For compiling qt-extended 4.4.2, you may need to use the following commands:

  • cd build
  • $QTOPIA_DEPOT_PATH/configure -device neo -verbose -build-qt -force-build-qt
  • bin/qbuild image

This forces building qt as well which resolved problems with the qbuild test using all the system ram.

Booting into Qtopia

Now shutdown the FreeRunner

shutdown -h now

Log into U-Boot in the NAND Flash to boot from the MicroSD card: (instructions from Booting the Neo FreeRunner)

  • Press and hold Power button
  • Then while still pressing the Power button, press and hold AUX button for 5 to 8 seconds.
  • A boot menu will appear.
  • Press the AUX button to select "Boot from MicroSD" and then press the Power button to execute.

Qtopia should now boot.

Note: you may get a kernel panic which says that "optional features not supported". If this is the case, boot back into 2007.2 and run

umount /dev/mmcblk0p2 fsck.ext3.e2fsprogs /dev/mmcblk0p2

This will clean up the file system and clear recovery flags in ext3 that ext2 does not support, then try booting from the MicroSD again.

Internationalization

Qtopia comes with support for German and American English, and users from other countries will find that Qtopia's predictive keyboard makes writing in another language near impossible. One way to disable the predictive keyboard is to simply replace /opt/Qtopia/etc/dict/en_US/common.dawg and words.dawg with empty files (after backing them up). Qtopia normally looks in these files for words to suggest, and if it doesn't find any words that fit, it simply shows what you actually wrote.

Adding characters to the keyboard requires modifications to the source code, as described here.


Suspend /Resume

It seems that suspend/resume only works when the FreeRunner has been connected to a powersource (only a few seconds if sufficient). If you boot from battery, it will never suspend until you have plugged it in at least for a couple of seconds.

Bugs

See Trolltech's tracker (Qtopia Tracker).

Bug reports should be sent to qt-bugs@trolltech.com or by web form at http://trolltech.com/bugreport-form.

Bugs in 4.4.1

  • Boot and Shutdown Splash will not work because splash-write was not compiled into Busybox
  • Timezone & time on latest Qt 4.4.1
  • The first item in a list is missing the top half

Bugs in 4.4.2

Bluetooth isn't avaible

Personal tools


This page provides instructions on how to install Qtopia/Qt Extended (proper, not the ASU or QtopiaOnX11 efforts) on the GTA02 (FreeRunner) phone. It is similar to the Qtopia on Neo1973 page.

Contents

Current status

On 31 October 2008, Trolltech released the Qtopia ROM flash image containing the rootfs for the Openmoko Neo FreeRunner (gta02) containing the Qtopia 4.4.2 release (GPL version). This runs on the mwebster ROM flash image containing the kernel. At release time, 4.4.2 & current mwester's kernel mismatched, please clarify the previous sentence. Hypnotize has released Qt Extended 4.4.2 images for the Neo FreeRunner that work better.

This image can successfully make and receive calls and text messages. It can read all contacts from the SIM card (which the updated 2007.2 does not appear to be able to do). It contains apps that appear to be more stable than the ones found in the 2007.2 image. It has multiple input methods that appear to be more mature. It does not, however, have a web browser or a GPS application. There are however at least three third-party GPS applications available:

On 2nd of September 2008 Trolltech also released a 4.3.3-snapshot which fixes a number issues (sms messages not retrieved after resume; Qtopia getting confused between two calls; Make default call volume down and mic up; Added echo fix.)

You can find all the Qtopia images here (including Qtextended/Qtopia 4.4 for FreeRunner and Neo1973!)

What is in the latest release (Qtopia 4.4)?

Qtopia 4.4 has been released with the name of QtExtended 4.4.

Option 1: Flashing Qtopia to FreeRunner

Download the image mentioned above and follow the instructions here: Flashing the Neo FreeRunner

Option 2: Dual-Booting between Qtopia and 2007.2 (Qtopia boots from MicroSD card)

Installation Requirements:

  1. SSH shell access to 2007.2 based image of the FreeRunner through USB interface or WLAN.
  2. A Desktop Linux distro (to unpack the .jffs2 image, I ran Ubuntu under VMWare)


Preparing the SD card

See the Preparing the SD Card section of the Booting from SD page for partitioning and formatting instructions. After you complete the "Formatting the SD Card" steps, return here and execute the following:

mount /dev/mmcblk0p1 /media/card
mkdir /media/card/boot

mkdir /media/mmcblk0p2
mount /dev/mmcblk0p2 /media/mmcblk0p2

This will set you up properly for the installation of the root filesystem and the kernel in the steps below.

Installing Qtopia

Unpacking the Qtopia Root Filesystem Image

Download the Qtopia FLASH image from Latest Images#Qtopia images to your Linux box and extract its contents:

tar xzf qtopia-4.3.2-gta02-flash-*.tgz

You should now have two files:

  1. uImage-2.6.24+git18+9c058ff0d2641df3c36fc3300acb72078d2c41d4-r0-om-gta02.bin
  2. qtopia-4.3.2-gta02-rootfs-07172049.jffs2

Now, mount the root file system from the jffs2 using the commands found here. However, in the mount command, substitute the image filename for "/dev/mtdblock0".

Creating a compressed tarball

Next, tar up the root filesystem:

  1. tar czf qtopia-4.3.2-gta02-rootfs-07172049.tar.gz -C <mountpoint> .

Where <mountpoint> is the location where the jff2 filesystem was mounted. Note the space and the period after the mountpoint.

Installing Root Filesystem

Transfer this compressed tarball to the second partition of the MicroSD that is mounted on the FreeRunner:

scp qtopia-4.3.2-gta02-rootfs-07172049.tar.gz root@192.168.0.202:/media/mmcblk0p2/

Log in to your FreeRunner and unpack the root filesystem:

cd /media/mmcblk0p2 tar xzf qtopia-4.3.2-gta02-rootfs-07172049.tar.gz rm qtopia-4.3.2-gta02-rootfs-07172049.tar.gz rm -f /media/mmcblk0p2/boot/*

Note: the last step removes the kernel image from the second partition. For some reason, U-Boot cannot find the uImage.bin file in the first partition if a kernel image exists in the second partition boot/ directory.

Installing Kernel

From your Linux box, rename uImage-2.6.24+git18+9c058ff0d2641df3c36fc3300acb72078d2c41d4-r0-om-gta02.bin to uImage.bin and copy it to the boot directory on the first partition of the MicroSD card. Depending on the version of U-Boot you have installed, this may not work. To prevent any possible issues, copy it to the /media/card directory as well. There is plenty of room on the first partition to have uImage.bin in both locations.

mv uImage-2.6.24+git18+9c058ff0d2641df3c36fc3300acb72078d2c41d4-r0-om-gta02.bin uImage.bin scp uImage.bin root@192.168.0.202:/media/card/boot/ scp uImage.bin root@192.168.0.202:/media/card/

Pointing Qtopia to the SD Card

Lorn Potter on the mailing lists pointed this out:

Qtopia was designed to be run from the root partition on a flash chip, not from a removable sd card.

You would have to edit the etc/default/Trolltech/Storage.conf file to make it forget about the sd /dev node, to be able to run it this way"

Another user's solution to this is the following:

Edit this file: " /opt/Qtopia/etc/default/Trolltech/Storage.conf And change the [MountPoint0] section so it resembles this: -[ [MountPoint0] Name[] = SD Card Path=/dev/mmcblk0p1 Removable = 0 Applications = 0 Documents = 0 ContentDatabase = 0

Option 3: updating from source

NOTE: This will upgrade only opt/Qtopia directory, you should use opkg update/upgrade for the rest


Original Qtopia images (the distribution released by Trolltech, not ASU) are rarely released as a rootfs image, but the source code is often updated. If you want to reflash your OM with the latest version of Qtopia you might build it from sources. This has been explained in this thread of the community mailing list. Summing up:

cd / wget http://qtopia.net/downloads/neo/arm920t-eabi-ficgta01-toolchain.tgz tar xvzf arm920t-eabi-ficgta01-toolchain.tgz

tar xvzf qtopia-opensource-src-4.3.2-snapshot-20080806.tar.gz

  • make a "build" dir

mkdir build cd build

  • configure and make:

../qtopia-opensource-src-4.3.2-snapshot-20080806/configure -device ficgta01 make This will take some time (couple hours). Note that the option "-device ficgta01" should work for both neo and freerunner. Then:

make install

will make a root directory into the build directory. There you can find an image that directory should be copied to /opt/Qtopia of your phone with scp. once done restart qpe or whole phone.

For compiling qt-extended 4.4.2, you may need to use the following commands:

  • cd build
  • $QTOPIA_DEPOT_PATH/configure -device neo -verbose -build-qt -force-build-qt
  • bin/qbuild image

This forces building qt as well which resolved problems with the qbuild test using all the system ram.

Booting into Qtopia

Now shutdown the FreeRunner

shutdown -h now

Log into U-Boot in the NAND Flash to boot from the MicroSD card: (instructions from Booting the Neo FreeRunner)

  • Press and hold Power button
  • Then while still pressing the Power button, press and hold AUX button for 5 to 8 seconds.
  • A boot menu will appear.
  • Press the AUX button to select "Boot from MicroSD" and then press the Power button to execute.

Qtopia should now boot.

Note: you may get a kernel panic which says that "optional features not supported". If this is the case, boot back into 2007.2 and run

umount /dev/mmcblk0p2 fsck.ext3.e2fsprogs /dev/mmcblk0p2

This will clean up the file system and clear recovery flags in ext3 that ext2 does not support, then try booting from the MicroSD again.

Internationalization

Qtopia comes with support for German and American English, and users from other countries will find that Qtopia's predictive keyboard makes writing in another language near impossible. One way to disable the predictive keyboard is to simply replace /opt/Qtopia/etc/dict/en_US/common.dawg and words.dawg with empty files (after backing them up). Qtopia normally looks in these files for words to suggest, and if it doesn't find any words that fit, it simply shows what you actually wrote.

Adding characters to the keyboard requires modifications to the source code, as described here.


Suspend /Resume

It seems that suspend/resume only works when the FreeRunner has been connected to a powersource (only a few seconds if sufficient). If you boot from battery, it will never suspend until you have plugged it in at least for a couple of seconds.

Bugs

See Trolltech's tracker (Qtopia Tracker).

Bug reports should be sent to qt-bugs@trolltech.com or by web form at http://trolltech.com/bugreport-form.

Bugs in 4.4.1

  • Boot and Shutdown Splash will not work because splash-write was not compiled into Busybox
  • Timezone & time on latest Qt 4.4.1
  • The first item in a list is missing the top half

Bugs in 4.4.2

Bluetooth isn't avaible