2. Installation

QWireless is developed using KDevelop. To install it on your handheld system, you can either choose the ipkg-binary for qtopia or grab the sources (tgz for kdevelop 2.1.5) and compile it on your system.

For this, you need a linux system including cross compilation environment like it is described at opiedev. Here you can either find, how to setup your machine for crosscompilation and a lot of tips developing for linux handhelds.

2.1 How to obtain QWireless

QWireless is available as an ipkg (binary compatible with OPIE 1.0) or as a source tarball for KDevelop use. You can find it on my homepage qwireless.

2.2 Compilation and installation of the source tarball

In order to compile and install QWireless on your system, type the following in the base directory of the QWireless distribution:

% ./configure
% make
% make install

Since QWireless uses

autoconf

2.3 Installation on the handheld

Put the familiar feed dir into your /etc/ipkg.conf file and run ipkg update;ipkg install qwireless. This will install qwireless with an example configuation and all dependend libs/tools.

2.4 Configuration

Before you can start, QWireless needs to know, where its configuration is stored. For this, you have to setup an appropriate environment variable QWIRELESSCFG. Insert

export QWIRELESSCFG=/root/Applications/qwireless/data

assuming you are using bash or similar.

On your handheld it will work automatically using the opie dir structure.

This is the location where QWireless finds its configuration file. The following paragraph shows the config file as an example.

<?qwireless version="0.1" type="config"?>
#-------------------------------------------------------------
# Config-File for qwireless
# written from qwireless : 0.1.0
# last modified : date = 30.06.2002
#                 time = 12:50:59
#
# File is automatically generated, dont modify manually
#

[HEADER]
LASTFILE=last;
INTERFACE=eth1;
HELPPROG=helpbrowser;
HELPFILE=/opt/QtPalmtop/docs/qwireless/en/index.html;
PING PROG=ping;
PING OPTIONS=-c 2 -i 0.3 -f -q -w 1;
HOST IP=192.168.0.199;
OVERVIEW UPDATE[ms]=1000;
DETAIL UPDATE[ms]=3000;
PING UPDATE[ms]=3000;


##EOF QWIRELESS CFG FILE

• LASTFILE
  The filename, where the last used qwireless file is stored. If existing, the program always starts with the last file used (and stored).
• INTERFACE
  The interface name, which is used for wireless lan.
• PING PROG
  The ping program to be used for ping calls.
• PING OPTIONS
  The option to call ping.
  
  • -c 2
    use 2 ping frames.
  • -i 0.3
    use 0.3 sec betwenn the pings (note values below 0.2 are only allowed to superuser).
  • -f
    use flood mode (to aviod long wait times)
  • -q
    use quiet mode
  • -w 1
    use timeout of 1 sec to return if not successfull.
  HINT!!! I found out, that ping on the ipaq does not support e.g. timeour (-w). this makes it unusable for checking host connections. I will try to get the X11 standard ping (SuSE 7.3) to work on the ipaq next and distribute it with qwireless.
• HOST IP
  The IP-adress/hostname of a host reachable from the total network. This host should be pinged frequently to produce traffic on the network interface.
• OVERVIEW UPDATE
  This is the update rate (in ms) for the overiew (wireless info).
• DETAIL UPDATE
  This is the update rate (in ms) for the detail list (mainly static info).
• PING UPDATE
  This is the update rate (in ms) for the host ping.
• HELPPROG
  The help file browser.
• HELPFILE
  The help file incl. the full path.