Qtopia Home - Classes - Hierachy - Annotated - Functions - Qt Embedded

Building Qtopia Refboard PDA OEM for i386

• Introduction
• Pre-requisites
• Method
  • Install Qtopia Tools
  • Extract Qt/Embedded and Qtopia
  • Setup environment variables
  • Build QVFb
  • Build Qt/Embedded
  • Build Qtopia

Introduction

This documentation indicates the steps required to install Qtopia on an i386 host system when using the Qtopia Tools package. On completion of these steps a Qtopia binaries image will be available under $QPEDIR/image for the specified i386 processor.

If the Qtopia Tools package is not being used, then refer to the instructions on how to build Qtopia tools from source

Pre-requisites

The following packages are required in current directory:

• Qtopia Tools package to suit the host system (refer to: Choosing an RPM)
• Qt/E-2.3.11 source package
• Qtopia-2.1.2 source package

Method

Building Qtopia for an i386 host can be achieved using these steps:

1. Install Qtopia Tools
2. Extract Qt/Embedded and Qtopia
3. Setup environment variables
4. Build Qt/Embedded
5. Build Qtopia

Install Qtopia Tools

To install the Qtopia Tools package, login as the root user and run the commands:

# remove any existing Qtopia Tools package
sudo rpm -e qtopia-tools

# install the Qtopia Tools for host system
sudo rpm -ivh qtopia-tools*.rpm

Extract Qt/Embedded and Qtopia

To extract Qt/Embedded and Qtopia run :

# Change into the package download directory
cd ~/dev

# Extract Qt/Embedded
tar -xzf qt-embedded-*2.3.11*.tar.gz

# Extract Qtopia
tar -xzf qtopia-*source-*2.1.2.tar.gz

Setup environment variables

The following command will setup the environment variables required for a build of Qt/Embedded and Qtopia:

# Set the enviroment for later use by Qtopia
export TMAKEDIR=/opt/QtopiaTools/tmake
export QT2DIR=/opt/QtopiaTools/qt2
export DQTDIR=/opt/QtopiaTools/dqt
export QPEDIR=$(echo $(/bin/pwd)/qtopia-*-2.1.2)
export QTEDIR=$(echo $PWD/qt-2.3.11)
export QTE_XPLATFORM=linux-generic-g++

Build QVFb

To build qvfb sources from Qt 2.3.11 against the static Qt library from Qt 2.3.2 via running:

export TMAKEPATH=$TMAKEDIR/lib/linux-g++
export QTDIR=$QT2DIR
export PATH=$QTDIR/bin:$PATH:$TMAKEDIR/bin
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
cd $QTEDIR/tools/qvfb
tmake -o Makefile qvfb.pro
make

Build Qt/Embedded

To build Qt/Embedded run :

# Ensure that uic and qvfb are available as expected
export LD_LIBRARY_PATH=$QT2DIR/lib:$LD_LIBRARY_PATH
mkdir -p $QTEDIR/bin/
cp -f $QT2DIR/bin/uic $QTEDIR/bin/
cp -f $QTEDIR/tools/qvfb/qvfb $QTEDIR/bin/

# build libqte
cd $QTEDIR
export TMAKEPATH=$TMAKEDIR/lib/qws/linux-x86-g++
export QTDIR=$QTEDIR
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
cp -f $QPEDIR/src/qt/qconfig-qpe.h src/tools/
./configure -system-jpeg -no-xft -qconfig qpe -qvfb -depths 4,8,16,32 # see [extra options: see below]
make sub-src

Warning: To build Qtopia, the system-specific jpeg library and header files MUST be provided by your compiler tool chain or your system.

Note: It is possible to build QT/Embedded without X11; contact support for the details.

Extra options:

• The configure option -keypad-mode, to enable keypad widget navigation support, is required when building Qtopia for a phone device, but it should not be used for building Qtopia for a PDA device.
• GIF support is provided by using the -gif configuration option.
• For additional configuration options, run the command :

           ./configure --help

Build Qtopia

To build Qtopia, run :

cd $QPEDIR
export QTDIR=$QTEDIR
export PATH=$QPEDIR/bin:$PATH
./configure -xplatform $QTE_XPLATFORM -edition pda -no-qtopiadesktop
make
make install