summaryrefslogtreecommitdiff
path: root/README
Unidiff
Diffstat (limited to 'README') (more/less context) (ignore whitespace changes)
-rw-r--r--README15
1 files changed, 12 insertions, 3 deletions
diff --git a/README b/README
index 0c6ef68..91164d5 100644
--- a/README
+++ b/README
@@ -1,112 +1,121 @@
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. Qt/Embedded 2.3.12 is not recommended atm.
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
67For a successful Opie build, you need to install the following libraries and headers: 67For a successful Opie build, you need to install the following libraries and headers:
68 68
69* libsdl >= 1.2.0 69* libsdl >= 1.2.0
70 http://www.libsdl.org/download-1.2.php 70 http://www.libsdl.org/download-1.2.php
71 71
72* libxine >= 1.0 72* libxine >= 1.0 && <= 1.1
73 http://prdownloads.sourceforge.net/xine/ 73 http://prdownloads.sourceforge.net/xine/
74 74
75* libpcap >= 0.7.2 75* libpcap >= 0.7.2
76 http://www.tcpdump.org/release/ 76 http://www.tcpdump.org/release/
77 77
78* libetpan >= 0.34 78* libetpan >= 0.34
79 http://prdownloads.sourceforge.net/libetpan/ 79 http://prdownloads.sourceforge.net/libetpan/
80 80
81* libsqlite >= 3.0.0 81* libsqlite >= 3.0.0
82 http://www.sqlite.org/download.html 82 http://www.sqlite.org/download.html
83 83
84* libipk >= 138 84* libipk >= 138
85 ftp://handhelds.org/linux/packages/ipkg 85 ftp://handhelds.org/linux/packages/ipkg
86 86
87* libobexftp >= 0.19 87* libobexftp >= 0.19
88 http://triq.net/obexftp.html 88 http://triq.net/obexftp.html
89 89
90* libsword >= 1.5.8
91 http://www.crossfire.org/sword
92
93* libbluez >= 2.25
94 http://www.bluez.org
95
96* libfreetype6 >= 2.21
97 http://www.freetype.org
98
903. Required Programs 993. Required Programs
91==================== 100====================
92 101
93For a successful usage of Opie, you should install the following programs: 102For a successful usage of Opie, you should install the following programs:
94 103
95* obexftpd 104* obexftpd
96* obextool 105* obextool
97 106
984. Supported Devices 1074. Supported Devices
99==================== 108====================
100 109
101Sharp Zaurus SL-5x00, SL-B500, SL-C7x0, SL-C8x0, SL-C1000, SL-C3000, SL-C3100, SL-6000 110Sharp Zaurus SL-5x00, SL-B500, SL-Cxx0, SL-Cxx00, SL-6000
102 111
103HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx 112HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx
104 113
105SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD 114SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD
106 115
107MasterIA Beagle, Tradesquare.NL Tuxpad 1 116MasterIA Beagle, Tradesquare.NL Tuxpad 1
108 117
109GMate Yopy 3x00 118GMate Yopy 3x00
110 119
111Motorola EZX A780, E680 120Motorola EZX A780, E680
112 121