Building Orbiter for the Nokia 770
From LinuxMCE
These are the instructions to build a version of Orbiter for the Nokia 770 internet platform. Nokia 770 has an ARM family processor, therefore you will need to cross-compile if your build machine is an Intel.
Contents
Requirements
You will need:
- an Ubuntu box to host the build
- the Maemo 1.1 SDK for ARM ( http://repository.maemo.org/stable/1.1/arm/Maemo_Dev_Platform_RS_v1.1_arm.tgz )
- Scratchbox cross-compilation toolkit 0.9.8.5 (http://www.scratchbox.org/download/files/sbox-releases/0.9.8/deb/ )
scratchbox-core_0.9.8.5_i386.deb scratchbox-devkit-debian_0.9.8.5_i386.deb scratchbox-doctools_0.9.8.5_i386.deb scratchbox-libs_0.9.8.5_i386.deb scratchbox-toolchain-arm-glibc_0.9.8.5_i386.deb scratchbox-toolchain-i686-glibc_0.9.8.5_i386.deb
Preparing the Nokia tablet
- Make sure it is connected to the network - check the Connection manager for a WiFi connection
- Open an X terminal on the tablet; make a directory in your home dir to hold the Orbiter binaries, say /home/user/orbiter
- You'll need a way to transfer files from the build machine to the tablet. Either have an HTTP server somewhere on your network, or install OpenSSH on the tablet. If you install OpenSSH, remember to also start it, by doing /etc/init.d/ssh start. To get a root prompt, use sudo gainroot.
Preparing the build machine
- Install Scratchbox debs on the build machine
- Add yourself as a Scratchbox user: /scratchbox/sbin/sbox_adduser username
- Check out a fresh working copy of LinuxMCE from http://svn.plutohome.com/pluto/trunk/src/ into /scratchbox/users/username/pluto/trunk/src (username is assumed to be your user name on the build machine)
- Copy or symlink the Maemo SDK into /scratchbox/packages
- Log in to Scratchbox by typing scratchbox
- Configure Scratchbox cross-compile target:
> sbox-config -ct Nokia770
Available compilers:
0) arm-linux-gcc-3.3_3.3.4-glibc-2.3.2.ds1
1) host-gcc
2) i686-linux-gcc-3.3_3.3.4-glibc-2.3.2.ds1
Enter compiler number: 0
Available CPU-transparency methods:
sbrsh
qemu-arm
qemu-ppc
Enter method name (qemu-arm): qemu-arm
Available devkits:
debian
Enter list of devkit names (none): debian
- Select the new cross-compile target: sbox-config -st Nokia770
- Unpack the Maemo rootstrap: sbox-config -er /scratchbox/packages/Maemo_Dev_Platform_RS_v1.1_arm.tgz
- sbox-config -cc
- sbox-config -cf
- Update the package list inside Scratchbox by typing apt-get update
- Install the following build-time dependencies (with apt-get install)
- libmysqlclient12-dev
- libid3-dev
- xlibmesa-gl-dev
- Before starting to compile Orbiter and its dependencies, type: export SNR_CPPFLAGS="-DMAEMO_NOKIA770" (add there -DDEBUG if you want to see all debug messages) and export SNR_LDFLAGS="". Also, apply that patch to Orbiter Makefile to remove GL and HID dependences:
--- src-2.0.0.44/src/Orbiter/Makefile 2007-03-05 13:44:44.000000000 -0800
+++ tmp/Makefile 2007-06-07 08:02:09.000000000 -0700
@@ -23,9 +23,9 @@
CXXFLAGS += -g -O0
-CPPFLAGS += -I/usr/include/SDL -DORBITER -DCACHE_IMAGES -DENABLE_MOUSE_BEHAVIOR -I$(ROOT)/Splitter -I$(ROOT)/OrbiterGen -I$(ROOT)/SDL_Helpers -DHID_REMOTE
+CPPFLAGS += -I/usr/include/SDL -DORBITER -DCACHE_IMAGES -DENABLE_MOUSE_BEHAVIOR -I$(ROOT)/Splitter -I$(ROOT)/OrbiterGen -I$(ROOT)/SDL_Helpers
LDFLAGS += -L/usr/X11R6/lib
-XTRALDLIBS += -lDCECommon -lSDL -lSDL_ttf -lSDL_image -lSGE -lSDL_gfx -lXtst -lXext -lGL -lXrender -lGLU -lSDL_Helpers -lhid
+XTRALDLIBS += -lDCECommon -lSDL -lSDL_ttf -lSDL_image -lSGE -lSDL_gfx -lXtst -lXext -lXrender -lSDL_Helpers -lhid
# wmctrl wrapper
CPPFLAGS += -I/usr/X11R6/include -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include
@@ -38,7 +38,6 @@
../utilities/linux/wrapper/wrapper_x11.cpp \
../utilities/linux/wrapper/image_file.cpp \
Linux/win_list_manager.cpp \
- Linux/HIDInterface.cpp \
Linux/OrbiterRenderer_Linux.cpp \
Linux/WindowContext.cpp \
DesignObj_Data.cpp \
Building Orbiter
- While inside Scratchbox, go into /pluto/trunk/src/SerializeClass and type make
- Go into /pluto/trunk/src/PlutoUtils and type make
- Go into /pluto/trunk/src/DCE and type make
- Go into /pluto/trunk/src/SDL_Helpers and type make
- Go into /pluto/trunk/src/Orbiter and type make bin
- After a while, the following files will result in /pluto/trunk/src
- lib/libDCECommon.so
- lib/libSerializeClass.so
- lib/libPlutoUtils.so
- lib/libSDL_Helpers.so
- bin/Orbiter
- Copy these files over to the tablet, in /home/user/orbiter
- Don't forget strip Orbiter binaries to save space:
- strip lib/*
- strip bin/*
Running Orbiter
Before starting Orbiter following applications and libraries should be installed:
- mysql-common
- libmysqlclient
- libhttpfetcher
- libhid (should be removed soon)
- libsdl-sge
- libsdl-gfx
- libsdl
- libgle
- libxmu
- libsdl-ttf
- libsdl-image
- libsm
- libice
- libxt
- xterm
- ssh
To do that just add additional repository repository.maemo.org and activate Red Pill Mode. Additionally, you should became a root on your device.
In an X terminal On the tablet itself (NOT via ssh) do this:
cd /home/user/orbiter export LD_LIBRARY_PATH=. ./Orbiter -r xxx.xxx.xxx.xxx -d yy -l orbiter.log
where xxx.xxx.xxx.xxx is the IP address of the DCE Router, and yy is the device number assigned to your new Orbiter.
If it complains about missing .so files, copy them over from your Scratchbox on the build machine into /home/user/orbiter on the tablet.
Notice: you need true type fonts on your Nokia770. The orbiter searches them here - /usr/share/truetype/msttcorefonts. Just copy this directory from your core to Nokia770 (the Debian package for Nokia is coming soon).
