summaryrefslogtreecommitdiff
path: root/README
Unidiff
Diffstat (limited to 'README') (more/less context) (ignore whitespace changes)
-rw-r--r--README42
1 files changed, 26 insertions, 16 deletions
diff --git a/README b/README
index 568b76e..1c74dd4 100644
--- a/README
+++ b/README
@@ -1,88 +1,98 @@
11. How to use the Opie build system 11. How to use the Opie build system
2==================================== 2====================================
3There's a tutorial document at: 3There's a tutorial document at:
4http://www.uv-ac.de/opiedev/opiedev.html 4http://www.uv-ac.de/opiedev/opiedev.html
5 5
6The API reference currently is at: 6The API reference currently is at:
7http://handhelds.org/~zecke/apidocs/index.html 7http://handhelds.org/~zecke/apidocs/index.html
8 8
9You will need qvfb, uic and 9You will need qvfb, uic and
10(if you want to develop applications) designer 10(if you want to develop applications) designer
11compiled and linked against qt-x11. 11compiled and linked against Qt/X11.
12That means you must download and configure/make it. 12That means you must download and configure/make it:
13wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz 13wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz
14(Alternatively, you can get static binaries from http://www.vanille.de/tools) 14(Alternatively, you can get static binaries from http://www.vanille.de/tools)
15 15
16The recommended version of Qt embedded is qt-embedded-2.3.7 16The recommended version of Qt/Embedded is 2.3.7
17 17
18You can get it from: 18You can get it from:
19ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2 19ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2
20 20
21Set QTDIR to point to your qt/embedded source tree, such as: 21Set QTDIR to point to your qt/embedded source tree, such as:
22export QTDIR=/opt/qt-2.3.7 22export QTDIR=/opt/qt-2.3.7
23 23
24You need to do set the OPIEDIR environment variable: 24You need to do set the OPIEDIR environment variable:
25export OPIEDIR=`pwd` 25export OPIEDIR=`pwd`
26or 26or
27export OPIEDIR=~/projects/sources/opie 27export OPIEDIR=~/projects/sources/opie
28or whereever you placed the Opie sources. 28or whereever you placed the Opie sources.
29 29
30You need to adjust your runtime library search path, 30You need to adjust your runtime library search path,
31so that the Qt/Embedded and Opie libraries can be found: 31so that the Qt/Embedded and Opie libraries can be found:
32export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH 32export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
33 33
34You have to apply the qte<version>-all.patch to the Qt/Embedded 34You have to apply the patches corresponding to your Qt/Embedded version
35sources and copy the qconfig-qpe.h file to $QTDIR/src/tools: 35and copy the qconfig-qpe.h file to $QTDIR/src/tools:
36cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1 36cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1
37cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools 37cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools
38 38
39You are now ready to configure and build Qt/Embedded 39You are now ready to configure and build Qt/Embedded
40 40
41cd $QTDIR 41cd $QTDIR
42echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb 42echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb
43make 43make
44 44
45Note that the above command ( -qvfb ) compiles in the Virtual 45Note that the above command ( -qvfb ) compiles in the Virtual
46Framebuffer and is mostly meant for development on your host system. 46Framebuffer and is mostly meant for development on your host system.
47For cross compiling, you will need to use the -xplatform switch. 47For cross compiling, you will need to use the -xplatform switch.
48See ./configure --help for details about the possible options. 48See ./configure --help for details about the possible options.
49 49
50Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler 50Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler
51is available. 51is available.
52 52
53Then do the following in the opie source tree: 53Then do the following in the opie source tree:
54 54
55make clean 55make clean
56make menuconfig 56make menuconfig
57 57
58Now you can move through the menu and select or deselect anything.. 58Now you can move through the menu and select or deselect anything..
59Exit and save the configuration and enter "make" to create opie... 59Exit and save the configuration and enter "make" to build everything selected.
60 60
61Have fun! 61Have fun!
62 62
632. Used Libraries 632. Required Libraries
64================ 64================
65 65
66The following Libraries are used in Opie. 66The following Libraries are used by Opie parts.
67For a successful build you must install these librarys and headers. 67For a successful build you must install these librarys and headers.
68The versions are known-good versions. If you successfully try newer ones,
69commit a new README or send a mail to opie-devel@handhelds.org
70 68
71* libsdl 1.2 69* libsdl >= 1.2.0
72 http://www.libsdl.org/download-1.2.php 70 http://www.libsdl.org/download-1.2.php
73 71
74* libxine 1.0 rc6 72* libxine >= 1.0 RC6
75 http://prdownloads.sourceforge.net/xine/ 73 http://prdownloads.sourceforge.net/xine/
76 74
77* libpcap 0.7.2 75* libpcap >= 0.7.2
78 http://www.tcpdump.org/release/ 76 http://www.tcpdump.org/release/
79 77
80* libetpan 0.33pre 78* libetpan >= 0.34
81 http://prdownloads.sourceforge.net/libetpan/ + patch in noncore/net/mail/libetpanstuff 79 http://prdownloads.sourceforge.net/libetpan/
82 80
83* libsqlite 2.8.6 81* libsqlite >= 3.0.0
84 http://www.sqlite.org/download.html 82 http://www.sqlite.org/download.html
85 83
86* libipk v109 (or greater) 84* libipk v109 (or greater)
87 ftp://handhelds.org/linux/packages/ipkg 85 ftp://handhelds.org/linux/packages/ipkg
88 86
873. Supported Devices
88====================
89
90Sharp Zaurus SL-5x00, SL-B500, SL-C7x0, SL-C8x0, SL-6000
91
92HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx
93
94SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD
95
96MasterIA Beagle, Tradesquare.NL Tuxpad 1
97
98GMate Yopy 3x00