|
diff --git a/README b/README index 8184a76..e142382 100644 --- a/ README+++ b/ README |
|
@@ -1,99 +1,106 @@ |
1 | 1. How to use the Opie build system |
1 | 1. How to use the Opie build system |
2 | ==================================== |
2 | ==================================== |
3 | There's a tutorial document at: |
3 | There's a tutorial document at: |
4 | http://www.uv-ac.de/opiedev/opiedev.html |
4 | http://www.uv-ac.de/opiedev/opiedev.html |
5 | |
5 | |
6 | The API reference currently is at: |
6 | The API reference currently is at: |
7 | http://handhelds.org/~zecke/apidocs/index.html |
7 | http://handhelds.org/~zecke/apidocs/index.html |
8 | |
8 | |
9 | You will need qvfb, uic and |
9 | You will need qvfb, uic and |
10 | (if you want to develop applications) designer |
10 | (if you want to develop applications) designer |
11 | compiled and linked against Qt/X11. |
11 | compiled and linked against Qt/X11. |
12 | That means you must download and configure/make it: |
12 | That means you must download and configure/make it: |
13 | wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz |
13 | wget 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 | |
16 | You will need Qt/Embedded 2.3.10. Note that we don't support any |
16 | You will need Qt/Embedded 2.3.10. Note that we don't support any |
17 | other Qt/Embedded version anymore. |
17 | other Qt/Embedded version anymore. |
18 | |
18 | |
19 | You can get it from: |
19 | You can get it from: |
20 | ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.10-free.tar.bz2 |
20 | ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.10-free.tar.bz2 |
21 | |
21 | |
22 | Set QTDIR to point to your qt/embedded source tree, such as: |
22 | Set QTDIR to point to your qt/embedded source tree, such as: |
23 | export QTDIR=/opt/qt-2.3.10 |
23 | export QTDIR=/opt/qt-2.3.10 |
24 | |
24 | |
25 | You need to do set the OPIEDIR environment variable: |
25 | You need to do set the OPIEDIR environment variable: |
26 | export OPIEDIR=`pwd` |
26 | export OPIEDIR=`pwd` |
27 | or |
27 | or |
28 | export OPIEDIR=~/projects/sources/opie |
28 | export OPIEDIR=~/projects/sources/opie |
29 | or wherever you placed the Opie sources. |
29 | or wherever you placed the Opie sources. |
30 | |
30 | |
31 | You need to adjust your runtime library search path, |
31 | You need to adjust your runtime library search path, |
32 | so that the Qt/Embedded and Opie libraries can be found: |
32 | so that the Qt/Embedded and Opie libraries can be found: |
33 | export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH |
33 | export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH |
34 | |
34 | |
35 | You have to apply the patches corresponding to your Qt/Embedded version |
35 | You have to apply the patches corresponding to your Qt/Embedded version |
36 | and copy the qconfig-qpe.h file to $QTDIR/src/tools: |
36 | and copy the qconfig-qpe.h file to $QTDIR/src/tools: |
37 | cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1 |
37 | cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1 |
38 | cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools |
38 | cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools |
39 | |
39 | |
40 | You are now ready to configure and build Qt/Embedded |
40 | You are now ready to configure and build Qt/Embedded |
41 | |
41 | |
42 | cd $QTDIR |
42 | cd $QTDIR |
43 | echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb |
43 | echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb |
44 | make |
44 | make |
45 | |
45 | |
46 | Note that the above command ( -qvfb ) compiles in the Virtual |
46 | Note that the above command ( -qvfb ) compiles in the Virtual |
47 | Framebuffer and is mostly meant for development on your host system. |
47 | Framebuffer and is mostly meant for development on your host system. |
48 | For cross compiling, you will need to use the -xplatform switch. |
48 | For cross compiling, you will need to use the -xplatform switch. |
49 | See ./configure --help for details about the possible options. |
49 | See ./configure --help for details about the possible options. |
50 | |
50 | |
51 | Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler |
51 | Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler |
52 | is available. |
52 | is available. |
53 | |
53 | |
54 | Then do the following in the opie source tree: |
54 | Then do the following in the opie source tree: |
55 | |
55 | |
56 | make clean |
56 | make clean |
57 | make menuconfig |
57 | make menuconfig |
58 | |
58 | |
59 | Now you can move through the menu and select or deselect anything.. |
59 | Now you can move through the menu and select or deselect anything.. |
60 | Exit and save the configuration and enter "make" to build everything selected. |
60 | Exit and save the configuration and enter "make" to build everything selected. |
61 | |
61 | |
62 | Have fun! |
62 | Have fun! |
63 | |
63 | |
64 | 2. Required Libraries |
64 | 2. Required Libraries |
65 | ===================== |
65 | ===================== |
66 | |
66 | |
67 | The following Libraries are used by Opie parts. |
67 | For a successful Opie build, you need to install the following libraries and headers: |
68 | For 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 | |
88 | 3. Supported Devices |
87 | 3. Required Programs |
89 | ==================== |
88 | ==================== |
90 | |
89 | |
91 | Sharp Zaurus SL-5x00, SL-B500, SL-C7x0, SL-C8x0, SL-C1000, SL-C3000, SL-6000 |
90 | For a successful usage of Opie, you should install the following programs: |
| |
91 | |
| |
92 | * obexftpd |
| |
93 | * obextool |
| |
94 | |
| |
95 | 4. Supported Devices |
| |
96 | ==================== |
| |
97 | |
| |
98 | Sharp Zaurus SL-5x00, SL-B500, SL-C7x0, SL-C8x0, SL-C1000, SL-C3000, SL-C3100, SL-6000 |
92 | |
99 | |
93 | HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx |
100 | HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx |
94 | |
101 | |
95 | SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD |
102 | SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD |
96 | |
103 | |
97 | MasterIA Beagle, Tradesquare.NL Tuxpad 1 |
104 | MasterIA Beagle, Tradesquare.NL Tuxpad 1 |
98 | |
105 | |
99 | GMate Yopy 3x00 |
106 | GMate Yopy 3x00 |
|