From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/emb-install.html | 157 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 157 insertions(+) create mode 100644 doc/html/emb-install.html (limited to 'doc/html/emb-install.html') diff --git a/doc/html/emb-install.html b/doc/html/emb-install.html new file mode 100644 index 000000000..a2bd029c0 --- /dev/null +++ b/doc/html/emb-install.html @@ -0,0 +1,157 @@ + + + + + +Installing TQt/Embedded + + + + + + + +

Installing TQt/Embedded

+ + + +

This installation procedure is written for Linux. It may need +to be modified for other platforms. +

Unpack the archive if you have not done so already +
```
+    cd <anywhere>
+    gunzip qt-embedded-commercial-VERSION.tar.gz    # uncompress the archive
+    tar xf qt-embedded-commercial-VERSION.tar       # unpack it
+
```
+ +Replace VERSION with the TQt/Embedded version number throughout. +
This document assumes that the archive is installed as ~/qt-embedded-commercial-VERSION. +
Compile the TQt/Embedded library and examples. +
```
+    cd ~/qt-embedded-commercial-VERSION
+    export QTDIR=~/qt-embedded-commercial-VERSION
+    ./configure
+    make
+
```
+ +
The configuration system is designed to allow platform-specific options +to be added, but in general all Linux systems which have framebuffer +support can use the "linux-generic-g++" platform. +The configuration system also supports cross-compilers: +to build on Linux/x86 for the Linux/MIPSEL target, you would use: +
```
+    ./configure -embedded mips
+
```
+ +
Only a small number of configurations are predefined. +You can create your own custom configuration by adding new files +to the mkspecs/qws/ directory. Use existing similar configurations +as a starting point. +
Note: Due to a bug in the configure script, cross-compiling on +a little-endian machine (e.g. x86) for a big-endian processor +(e.g. PowerPC) will use the host's endianness instead of the +target's. Workaround: after running configure, and before running +make, edit $QTDIR/include/qconfig.h and change the definition of +Q_BYTE_ORDER. +
Enable framebuffer support. +
You may need to recompile your kernel to enable the framebuffer. +This document does not describe how to do this; the +Framebuffer HOWTO page +contains a short description. (You should see +a penguin logo at boot time when the frame buffer is enabled.) +
For Matrox G100/G200/G400 use the matrox frame buffer driver. +
For NVidia TNT cards use the nvidia frame buffer driver. +
For Mach64 and most other cards, use the vesafb driver. +
Note that some cards are only supported in VGA16 mode, this will +not work with the current version of TQt/Embedded, since VGA/16 is +not yet supported. You may need to upgrade your kernel, or even +switch to an experimental kernel. +
The frame buffer must also be enabled with a boot parameter. See +/usr/src/linux/Documentation/fb for details. +
The fbset program, which should be included in Linux distributions, +may be used to switch video modes without rebooting the system. The +video mode active when the server is started will be used. (8-bit +modes are still experimental.) Note: fbset does not work +with the vesafb driver. +
Change permissions. +
To run TQt/Embedded, you need write access to the framebuffer device +/dev/fb0. +
You also need read access to the mouse device. (Note that +/dev/mouse is normally a symbolic link; the actual mouse device +must be readable.) +
How to run the demonstration program. +
Log into a virtual console and do this: +
```
+    cd ~/qt-embedded-commercial-VERSION/examples/launcher
+    ./start-demo
+
```
+ +
Miscellaneous troubleshooting and known bugs. +
To kill gpm, run the following command as root: +
```
+    gpm -k
+
```
+ +
In some cases, if the server does not work, it will work when run as root. +
Show processes using the framebuffer: +
```
+    fuser -v /dev/fb0
+
```
+ +
Kill such processes: +
```
+    fuser -vk /dev/fb0
+
```
+ +or harsher: +
```
+    fuser -k -KILL /dev/fb0
+
```
+ +
Show existing semaphores: +
```
+    ipcs            
+
```
+ +
Remove semaphores: +
```
+    ipcrm
+
```
+ +
The communication between client and server is done through the +named pipe /tmp/qtembedded-username/TQtEmbedded-0; sometimes it may need to be deleted +(e.g. if you run TQt/Embedded with root privileges then later as an unprivileged user). +
Customization. +
The TQt/Embedded library can be reduced in size by +removing unnecessary features. +
This document shows how to use TQt/Embedded with the Linux framebuffer. For +development and debugging purposes it is often easier to use the TQt/Embedded virtual framebuffer instead. +

+ +

Trademarks +

TQt 3.3.8

+ -- cgit v1.2.1