summaryrefslogtreecommitdiff
path: root/README
Unidiff
Diffstat (limited to 'README') (more/less context) (ignore whitespace changes)
-rw-r--r--README15
1 files changed, 11 insertions, 4 deletions
diff --git a/README b/README
index 8184a76..e142382 100644
--- a/README
+++ b/README
@@ -1,99 +1,106 @@
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
16You will need Qt/Embedded 2.3.10. Note that we don't support any 16You will need Qt/Embedded 2.3.10. Note that we don't support any
17other Qt/Embedded version anymore. 17other Qt/Embedded version anymore.
18 18
19You can get it from: 19You can get it from:
20ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.10-free.tar.bz2 20ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.10-free.tar.bz2
21 21
22Set QTDIR to point to your qt/embedded source tree, such as: 22Set QTDIR to point to your qt/embedded source tree, such as:
23export QTDIR=/opt/qt-2.3.10 23export QTDIR=/opt/qt-2.3.10
24 24
25You need to do set the OPIEDIR environment variable: 25You need to do set the OPIEDIR environment variable:
26export OPIEDIR=`pwd` 26export OPIEDIR=`pwd`
27or 27or
28export OPIEDIR=~/projects/sources/opie 28export OPIEDIR=~/projects/sources/opie
29or wherever you placed the Opie sources. 29or wherever you placed the Opie sources.
30 30
31You need to adjust your runtime library search path, 31You need to adjust your runtime library search path,
32so that the Qt/Embedded and Opie libraries can be found: 32so that the Qt/Embedded and Opie libraries can be found:
33export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH 33export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
34 34
35You have to apply the patches corresponding to your Qt/Embedded version 35You have to apply the patches corresponding to your Qt/Embedded version
36and copy the qconfig-qpe.h file to $QTDIR/src/tools: 36and copy the qconfig-qpe.h file to $QTDIR/src/tools:
37cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1 37cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1
38cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools 38cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools
39 39
40You are now ready to configure and build Qt/Embedded 40You are now ready to configure and build Qt/Embedded
41 41
42cd $QTDIR 42cd $QTDIR
43echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb 43echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb
44make 44make
45 45
46Note that the above command ( -qvfb ) compiles in the Virtual 46Note that the above command ( -qvfb ) compiles in the Virtual
47Framebuffer and is mostly meant for development on your host system. 47Framebuffer and is mostly meant for development on your host system.
48For cross compiling, you will need to use the -xplatform switch. 48For cross compiling, you will need to use the -xplatform switch.
49See ./configure --help for details about the possible options. 49See ./configure --help for details about the possible options.
50 50
51Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler 51Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler
52is available. 52is available.
53 53
54Then do the following in the opie source tree: 54Then do the following in the opie source tree:
55 55
56make clean 56make clean
57make menuconfig 57make menuconfig
58 58
59Now you can move through the menu and select or deselect anything.. 59Now you can move through the menu and select or deselect anything..
60Exit and save the configuration and enter "make" to build everything selected. 60Exit and save the configuration and enter "make" to build everything selected.
61 61
62Have fun! 62Have fun!
63 63
642. Required Libraries 642. Required Libraries
65===================== 65=====================
66 66
67The following Libraries are used by Opie parts. 67For a successful Opie build, you need to install the following libraries and headers:
68For a successful build you must install these libraries and headers.
69 68
70* libsdl >= 1.2.0 69* libsdl >= 1.2.0
71 http://www.libsdl.org/download-1.2.php 70 http://www.libsdl.org/download-1.2.php
72 71
73* libxine >= 1.0 72* libxine >= 1.0
74 http://prdownloads.sourceforge.net/xine/ 73 http://prdownloads.sourceforge.net/xine/
75 74
76* libpcap >= 0.7.2 75* libpcap >= 0.7.2
77 http://www.tcpdump.org/release/ 76 http://www.tcpdump.org/release/
78 77
79* libetpan >= 0.34 78* libetpan >= 0.34
80 http://prdownloads.sourceforge.net/libetpan/ 79 http://prdownloads.sourceforge.net/libetpan/
81 80
82* libsqlite >= 3.0.0 81* libsqlite >= 3.0.0
83 http://www.sqlite.org/download.html 82 http://www.sqlite.org/download.html
84 83
85* libipk >= 138 84* libipk >= 138
86 ftp://handhelds.org/linux/packages/ipkg 85 ftp://handhelds.org/linux/packages/ipkg
87 86
883. Supported Devices 873. Required Programs
89==================== 88====================
90 89
91Sharp Zaurus SL-5x00, SL-B500, SL-C7x0, SL-C8x0, SL-C1000, SL-C3000, SL-6000 90For a successful usage of Opie, you should install the following programs:
91
92* obexftpd
93* obextool
94
954. Supported Devices
96====================
97
98Sharp Zaurus SL-5x00, SL-B500, SL-C7x0, SL-C8x0, SL-C1000, SL-C3000, SL-C3100, SL-6000
92 99
93HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx 100HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx
94 101
95SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD 102SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD
96 103
97MasterIA Beagle, Tradesquare.NL Tuxpad 1 104MasterIA Beagle, Tradesquare.NL Tuxpad 1
98 105
99GMate Yopy 3x00 106GMate Yopy 3x00