diff options
Diffstat (limited to 'doc/html/emb-install.html')
| -rw-r--r-- | doc/html/emb-install.html | 157 |
1 files changed, 157 insertions, 0 deletions
diff --git a/doc/html/emb-install.html b/doc/html/emb-install.html new file mode 100644 index 00000000..a2bd029c --- /dev/null +++ b/doc/html/emb-install.html @@ -0,0 +1,157 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/doc/qws.doc:36 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>Installing TQt/Embedded</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Installing TQt/Embedded</h1> + + + +<p> This installation procedure is written for Linux. It may need +to be modified for other platforms. +<p> <ol type=1> +<li> Unpack the archive if you have not done so already +<p> <pre> + cd <anywhere> + gunzip qt-embedded-commercial-VERSION.tar.gz # uncompress the archive + tar xf qt-embedded-commercial-VERSION.tar # unpack it +</pre> + +Replace <tt>VERSION</tt> with the TQt/Embedded version number throughout. +<p> This document assumes that the archive is installed as <tt>~/qt-embedded-commercial-VERSION</tt>. +<li> Compile the TQt/Embedded library and examples. +<p> <pre> + cd ~/qt-embedded-commercial-VERSION + export QTDIR=~/qt-embedded-commercial-VERSION + ./configure + make +</pre> + +<p> 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: +<pre> + ./configure -embedded mips +</pre> + +<p> Only a small number of configurations are predefined. +You can create your own custom configuration by adding new files +to the <tt>mkspecs/qws/</tt> directory. Use existing similar configurations +as a starting point. +<p> <b>Note</b>: 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 <tt>$QTDIR/include/qconfig.h</tt> and change the definition of +<tt>Q_BYTE_ORDER</tt>. +<p> <li> Enable framebuffer support. +<p> You may need to recompile your kernel to enable the framebuffer. +This document does not describe how to do this; the +<a href="emb-framebuffer-howto.html">Framebuffer HOWTO page</a> +contains a short description. (You should see +a penguin logo at boot time when the frame buffer is enabled.) +<p> For Matrox G100/G200/G400 use the matrox frame buffer driver. +<p> For NVidia TNT cards use the nvidia frame buffer driver. +<p> For Mach64 and most other cards, use the vesafb driver. +<p> 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. +<p> The frame buffer must also be enabled with a boot parameter. See +<tt>/usr/src/linux/Documentation/fb</tt> for details. +<p> The <tt>fbset</tt> 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.) <b>Note</b>: <tt>fbset</tt> does not work +with the vesafb driver. +<p> <li> Change permissions. +<p> To run TQt/Embedded, you need write access to the framebuffer device +<tt>/dev/fb0</tt>. +<p> You also need read access to the mouse device. (Note that +<tt>/dev/mouse</tt> is normally a symbolic link; the actual mouse device +must be readable.) +<p> <li> How to run the demonstration program. +<p> Log into a virtual console and do this: +<p> <pre> + cd ~/qt-embedded-commercial-VERSION/examples/launcher + ./start-demo +</pre> + +<p> <li> Miscellaneous troubleshooting and known bugs. +<p> To kill gpm, run the following command as root: +<p> <pre> + gpm -k +</pre> + +<p> In some cases, if the server does not work, it will work when run as root. +<p> Show processes using the framebuffer: +<p> <pre> + fuser -v /dev/fb0 +</pre> + +<p> Kill such processes: +<pre> + fuser -vk /dev/fb0 +</pre> + +or harsher: +<pre> + fuser -k -KILL /dev/fb0 +</pre> + +<p> Show existing semaphores: +<pre> + ipcs +</pre> + +<p> Remove semaphores: +<pre> + ipcrm +</pre> + +<p> The communication between client and server is done through the +named pipe <tt>/tmp/qtembedded-username/TQtEmbedded-0</tt>; sometimes it may need to be deleted +(e.g. if you run TQt/Embedded with root privileges then later as an unprivileged user). +<p> <li> Customization. +<p> The TQt/Embedded library can be reduced in size by +<a href="emb-features.html">removing unnecessary features</a>. +<p> <li> This document shows how to use TQt/Embedded with the Linux framebuffer. For +development and debugging purposes it is often easier to use the <a href="emb-qvfb.html">TQt/Embedded virtual framebuffer</a> instead. +<p> </ol> +<p> +<!-- eof --> +<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>TQt 3.3.8</div> +</table></div></address></body> +</html> |