Differences

This shows you the differences between two versions of the page.

--- doc:appunti:prog:openmoko_compile [2009/10/14 09:12] – niccolo
+++ doc:appunti:prog:openmoko_compile [2009/12/17 12:20] (current) – niccolo
@@ Line 83: / Line 83: @@
 I pacchetti vengono installati sotto **''/usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/''**.
-==== Compiling a large project: Navit ====
+===== Compiling a large project: Navit =====
-Please, improve the page [[http://wiki.navit-project.org/index.php/Navit_on_freerunner|Navit on FreeRunner]].
+Remember to improve the page [[http://wiki.navit-project.org/index.php/Navit_on_freerunner|Navit on FreeRunner]].
+How to cross-compile a large project like Navit for the OpenMoko/FreeRunner, using a GNU/Linux box and the toolchain.
 First of all, edit the ''/usr/local/openmoko/arm/environment-setup'' script and add the followig line:
@@ Line 93: / Line 95: @@
 </file>
-After toolchain installation, install (with **''opkg-target''**) some OpenMoko **''-dev''** packages required to compile Navit:
+After toolchain installation, install (with **''opkg-target''**) some OpenMoko **''-dev''** packages required to compile Navit. Depending upon permissions of ''/usr/local/openmoko/'' directory, you may need root privileges:
 <code>
 . /usr/local/openmoko/arm/environment-setup
+opkg-target list
 opkg-target install gpsd-dev
 opkg-target install gtk+-dev
@@ Line 102: / Line 105: @@
 </code>
-Now we check-out Navit sources from the SVN repository and run **''om-conf''** to prepare the ''automake'', ''autoconf'' and ''make'' files to run into the OpenMoko toolchain:
+Now we check-out Navit sources from the SVN repository and we make an archive just in case we need the pristine sources in the future:
 <code>
-svn co https://navit.svn.sourceforge.net/svnroot/navit/trunk
+svn co https://navit.svn.sourceforge.net/svnroot/navit/trunk/navit
-om-conf navit
+tar zcvf navit-svn-2670.tar.gz navit
 </code>
+Instead of running the traditional **''./autogen.sh; ./configure''** in the navit source tree, we must run the **''om-conf''** script, which will modify the ''automake'', ''autoconf'' and ''make'' files to run into the OpenMoko toolchain.
+Because Navit on the OpenMoko FreeRunner requires some configure options, we will pass them to the script. Run ''om-conf'' from the directory containing the source tree (not inside it):
+<code>
+om-conf --host=arm-angstrom-linux-gnueabi --enable-avoid-unaligned --enable-avoid-float \
+    --enable-cache-size=20971520 --with-saxon=saxon-xslt --with-xslts=openmoko \
+    --enable-svg2png-scaling=16,32,48,96 --enable-svg2png-scaling-flag=32,48 \
+    navit
+</code>
+In the example above we used some **''./configure''** options, among them:
+**''%%--with-saxon=saxon-xslt%%''**\\ This is because we have the Debian libsaxon-java package, where the executable is called ''saxon-xslt'' instead of ''saxon''.
+**''%%--enable-svg2png-scaling=16,32,48,96%%''**\\ For each .svg icon, render a png image of the specified size. Images will be named **''icon_XX_YY.png''**.
+**''%%--enable-svg2png-scaling-flag=32,48%%''**\\ Same as above, but only for country flag icons.
 It's time to cross-compile:
 <code>
-cd trunk/navit
+cd navit
 make
 </code>
-===== Creare un pacchetto .opk =====
+===== Make an .opk package =====
-FIXME Check what is provided by the toolchain! The following may be obsolete.
+=== Using the toolchains ===
+The OpenMoko toolchain provides the **''om-make-ipkg''** utility. It requires the **directory** name where to execute the ''make install'' and the name of the **control file**:
+<code>
+. /usr/local/openmoko/arm/environment-setup
+om-make-ipkg navit navit-control
+</code>
+The control file is described [[http://wiki.openmoko.org/wiki/Toolchain#Packaging_your_application|here]].
+If you need more control files (e.g. a ''postinst'' or alike) you have to tweak with the ''om-make-ipkg'' script.  Here it is the script I use, it looks for the control files into an **''opkg''** directory, so you have to pass just the directory name containing the source tree.
+<code bash>
+#!/bin/sh -e
+error_exit () {
+        echo usage: $(basename ${0}) [app_dir_name] [ipkg_control_file]
+        exit 1
+}
+test x${OMTOOL_DIR} = x && . /usr/local/openmoko/arm/setup-env
+. ${OMTOOL_DIR}/arm/scripts/functions
+S=${1}
+(test x${S} = x || test ! -d ${S}) && error_exit
+appname=$(basename ${S})
+tmpdir=/tmp/${appname}-ipkg-tmp
+test -e "${tmpdir}" && echo Cannot use ${tmpdir} because it already exists. && exit 1
+make -C ${S} install DESTDIR="${tmpdir}"
+# Copy control files to destination directory.
+cp -pr opkg/* ${tmpdir}
+ipkg-build -o 0 -g 0 ${tmpdir}
+rm -rf ${tmpdir}
+</code>
+Control files and other files are arranged into the ''opkg'' directory as needed, here it is an example:
+<code>
+opkg/CONTROL/postinst
+opkg/CONTROL/control
+opkg/etc/rcS.d/S96overcommit_memory.sh
+</code>
+=== Using opkg-utils ===
+The **[[http://handhelds.org/moin/moin.cgi/Ipkg|ipkg]]** tool is obsolete, OpenMoko uses the **[[http://wiki.openmoko.org/wiki/Opkg|opkg]]** instead, but documentation is scarce.
+The current opkg code is in [[http://code.google.com/p/opkg/|Google code]], but you can try this one:
-Simply do an:
 <code>
 svn co http://svn.openmoko.org/trunk/src/host/opkg-utils
 </code>
-and use the instructions of ipkg's website but the software from this checkout, the opkg-build.
+and use the instructions of ipkg's website but the software from this checkout. The main script is **''opkg-build''**.
+===== Qemu and the GTA02 FreeRunner =====
+**WARNING**: this procedure works only for the GTA01 Neo1973, it fails for the GTA02 FreeRunner.
+Install the Debian packages **gcc-3.4** and **libsdl1.2-dev**, download the **qemu-neo1973** sources from the [[https://svn.openmoko.org/trunk/src/host/qemu-neo1973|svn repository]]. Run the **''./configure && make''**.
+Edit the **''openmoko/env''** file and set current URLs and filenames:
+<file>
+# Entries for GTA01
+kernel_wildcard="uImage-2.6.22.5-moko11+svnr3238-r9-neo1973.bin"
+rootfs_wildcard="openmoko-image-fic-gta01.jffs2"
+uboot_wildcard="u-boot-gta01*.bin"
+download_dir="http://downloads.openmoko.org/distro/obsolete-images/Om2007.11//images/neo1973/"
+</file>
+Run the **''openmoko/download.sh''** and **''openmoko/flash.sh''** scripts.
+For the (failed) attempt to run the GTA02 FreeRunner emulator we need different Qemu parameters and different images:
+<file>
+qemu_relative="arm-softmmu/qemu-system-arm -M gta02fake -m 130"
+# Entries for GTA02, Om2008.12
+kernel_wildcard="Om2008.12-om-gta02.uImage.bin"
+rootfs_wildcard="Om2008.12-om-gta02.rootfs.jffs2"
+uboot_wildcard="gta02v5_and_up-u-boot.bin"
+download_dir="http://downloads.openmoko.org/distro/releases/Om2008.12/"
+</file>
+The **''openmoko/Makefile''** should be changed so the openmoko-flash.base (the NAND image) will be 256 Mb in size:
+<file>
+# GTA02
+$(FLASHIMG):
+        # Making an empty/erased flash image.  Need a correct echo behavior.
+        $(echo) -en \\0377\\0377\\0377\\0377\\0377\\0377\\0377\\0377 > .8b
+        cat .8b .8b .8b .8b .8b .8b .8b .8b > .64b # OOB is 64 bytes
+        cat .64b .64b .64b .64b .64b .64b .64b .64b >  .2048b
+        cat .64b .64b .64b .64b .64b .64b .64b .64b >> .2048b
+        cat .64b .64b .64b .64b .64b .64b .64b .64b >> .2048b
+        cat .64b .64b .64b .64b .64b .64b .64b .64b >> .2048b
+        cat .2048b .64b > .sec # A sector is 2048 bytes of data + OOB
+        cat .sec .sec .sec .sec .sec .sec .sec .sec > .8sec
+        cat .8sec .8sec .8sec .8sec .8sec .8sec .8sec .8sec > .64sec
+        cat .64sec .64sec .64sec .64sec .64sec .64sec .64sec .64sec > .512sec
+        cat .512sec .512sec .512sec .512sec > .2ksec
+        cat .2ksec .2ksec .2ksec .2ksec .2ksec .2ksec .2ksec .2ksec > .16ksec
+        # Neo GTA02 NAND is 128k sectors big
+        cat .16ksec .16ksec .16ksec .16ksec .16ksec .16ksec .16ksec .16ksec > $@
+        rm -rf .8b .64b .2048b .sec .8sec .64sec .512sec .2ksec .16ksec
+</file>
+The **''openmoko/download.sh''** will run, but **''openmoko/flash.sh''** fails with endless errors:
+<code>
+s3c_nand_read: Bad register 0x20
+</code>
+May be there are more instructions for the GTA02 in the [[http://wiki.openmoko.org/wiki/Qemu| wiki page]].
+FIXME We can manually run the emulator to get the U-Boot prompt, but here we have to partition and flash the NAND manually.
+<code>
+arm-softmmu/qemu-system-arm -M gta02fake -m 130 \
+    -mtdblock openmoko-flash.base \
+    -kernel u-boot.bin \
+    -serial stdio -nographic -usb -monitor null
+</code>