Qtopia / Qt Extended on FreeRunner

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Option 3: building from source)
Line 73: Line 73:
 
{{note|This should really be tested, I'm reporting it as discussed in the ML. I will update it as soon as I can}}
 
{{note|This should really be tested, I'm reporting it as discussed in the ML. I will update it as soon as I can}}
 
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 [http://lists.openmoko.org/pipermail/community/2008-August/024785.html this thread] of the community mailing list. Summing up:
 
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 [http://lists.openmoko.org/pipermail/community/2008-August/024785.html this thread] of the community mailing list. Summing up:
- get the latest toolchain released by trolltech: http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=38
+
 
- unzip it on your PC in / (as root)
+
- get the latest toolchain released by trolltech: http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=38
- get the latest snapshot from trolltech: ftp://ftp.trolltech.com/qtopia/snapshots/
+
- unzip it on your PC in / (as root)
- once dowloaded untar it
+
- get the latest snapshot from trolltech: ftp://ftp.trolltech.com/qtopia/snapshots/
 +
- once dowloaded untar it
 
   tar xvzf qtopia-opensource-src-4.3.2-snapshot-20080804.tar.gz
 
   tar xvzf qtopia-opensource-src-4.3.2-snapshot-20080804.tar.gz
- get into the untarred directory and make a "build" dir  
+
- get into the untarred directory and make a "build" dir  
 
   cd  qtopia-opensource-src-4.3.2-snapshot-20080804/
 
   cd  qtopia-opensource-src-4.3.2-snapshot-20080804/
 
   mkdir build
 
   mkdir build
 
   cd build
 
   cd build
- configure and make:
+
- configure and make:
 
   ../qtopia-opensource-src-4.3.2-snapshot-20080804/configure -device ficgta01
 
   ../qtopia-opensource-src-4.3.2-snapshot-20080804/configure -device ficgta01
 
   make  
 
   make  
  
 
Note that the option "-device ficgta01" should work for both neo and freerunner.
 
Note that the option "-device ficgta01" should work for both neo and freerunner.
 
  
 
=== Booting into Qtopia ===
 
=== Booting into Qtopia ===

Revision as of 14:31, 4 August 2008

This page provides instructions on how to install Qtopia (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 18 July 2008, Qtopia released the latest flash image for the FIC Neo Freerunner (gta02) containing the Qtopia 4.3.2 snapshot of 17 July 2008 (GPL version).

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.

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.


Installing Qtopia

Unpacking the Qtopia Root Filesystem Image

Download the Qtopia FLASH image from Latest Images#Qtopia image from qtopia.net 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 extract the root file system from the jffs2 using the commands found at here.


Now, tar up the root filesystem:

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

Where <mountpoint> is the location where the jff2 filesystem was mounted.

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/ on the first partition of the MicroSD card.

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

Option 3: building from source

NOTE: This should really be tested, I'm reporting it as discussed in the ML. I will update it as soon as I can


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:

- get the latest toolchain released by trolltech: http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=38 - unzip it on your PC in / (as root) - get the latest snapshot from trolltech: ftp://ftp.trolltech.com/qtopia/snapshots/ - once dowloaded untar it

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

- get into the untarred directory and make a "build" dir

  cd  qtopia-opensource-src-4.3.2-snapshot-20080804/
  mkdir build
  cd build

- configure and make:

  ../qtopia-opensource-src-4.3.2-snapshot-20080804/configure -device ficgta01
  make 

Note that the option "-device ficgta01" should work for both neo and freerunner.

Booting into Qtopia

Now shutdown the FreeRunner

 shutdown -h now

Log into U-Boot in the NOR 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.

Personal tools

This page provides instructions on how to install Qtopia (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 18 July 2008, Qtopia released the latest flash image for the FIC Neo Freerunner (gta02) containing the Qtopia 4.3.2 snapshot of 17 July 2008 (GPL version).

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.

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.


Installing Qtopia

Unpacking the Qtopia Root Filesystem Image

Download the Qtopia FLASH image from Latest Images#Qtopia image from qtopia.net 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 extract the root file system from the jffs2 using the commands found at here.


Now, tar up the root filesystem:

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

Where <mountpoint> is the location where the jff2 filesystem was mounted.

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/ on the first partition of the MicroSD card.

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

Option 3: building from source

NOTE: This should really be tested, I'm reporting it as discussed in the ML. I will update it as soon as I can


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:

- get the latest toolchain released by trolltech: http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=38 - unzip it on your PC in / (as root) - get the latest snapshot from trolltech: ftp://ftp.trolltech.com/qtopia/snapshots/ - once dowloaded untar it

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

- get into the untarred directory and make a "build" dir

  cd  qtopia-opensource-src-4.3.2-snapshot-20080804/
  mkdir build
  cd build

- configure and make:

  ../qtopia-opensource-src-4.3.2-snapshot-20080804/configure -device ficgta01
  make 

Note that the option "-device ficgta01" should work for both neo and freerunner.

Booting into Qtopia

Now shutdown the FreeRunner

 shutdown -h now

Log into U-Boot in the NOR 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.