Linux TDS Recon
Release 1.0 Notes

Introduction
    Thank you for purchasing the rugged TDS Recon running the Linux
    operating system.  In these release notes, you will find the
    latest information regarding the Linux and Qtopia software on your
    Recon. 

    NOTE: The documentation in the Recon box contains the original
    PocketPC reference material. Some of this material provides
    general hardware and operating information and has thus been
    retained.

Software Development
 -  A C++ software developer kit for a Linux host may be downloaded
    from the following location:
    http://familiar.sdgsystems.com/recon/sdgsdk-1.0.tar.gz
    This tar file should be extracted in /opt/sdg, as follows
    % mkdir -p /opt/sdg; cd /opt/sdg; tar zxf <downloads>/sdgsdk-1.0.tar.gz
 -  Information about Python development is also available in this
    download in sdgsdk-1.0/samples.
 -  Once downloaded, you should refer to the README.txt file in the
    resulting sdgsdk-1.0/ directory for information on building
    applications (including required environment variables).

Networking
 -  The default USB Ethernet IP address for the Recon is
    192.168.129.210.
 -  The default Ethernet configuration for USB Networking uses a small
    4-bit netmask. The host computer may be configured as follows:
        iface usb0 inet static
        address 192.168.129.209
        netmask 255.255.255.252
        network 192.168.129.208
 -  This Linux distribution uses the /etc/network/interfaces network
    configuration method. Qtopia will write the configuration
    parameters to this file when you attempt to connect to a network.
    You should be aware that changes to this file may be overwritten
    by Qtopia for interfaces that are managed by Qtopia (i.e. eth0 and
    wlan0).

Remote Access:
 -  The Recon information management utilities may be synchronized
    with your desktop computer using Qtopia Desktop. Qtopia Desktop
    may be downloaded at http://familiar.sdgsystems.com/recon/.
 -  The Recon uses the "dropbear" secure shell server. You may ssh to
    the Recon once you have configured the root password.
 -  By default, the Recon has no root password, which prevents ssh
    from connecting to the Recon. The password may be set using the
    Terminal application and entering the 'passwd' command.
 -  The Recon uses 'iptables' to block many remote ports except for
    those on the usb0 (USB cable) interface. It does not block ssh.

Known Problems
 -  A security vulnerability was uncovered in the released version of
    the "dropbear" secure shell software. To upgrade this package,
    you should run "ipkg update" followed by "ipkg upgrade". Following
    the upgrade you should have dropbear version 0.47 or higher.
 -  The process of adding additional software packages is very slow,
    particularly when using the network configuration. Qtopia may
    even appear to be "hung." Patience is required. This slowness is
    due to the large number of software packages in the Familiar Linux
    distribution. Experienced Linux users may want to use the
    command-line tool, ipkg, for the installation and removal of
    software.
 -  When connecting the Recon to Windows using the USB cable,
    Windows may lock up on occasion (RNDIS problems).
 -  If the network is started using a terminal window (e.g. 'ifup
    eth0'), then Qtopia will be unable to fully control the network.
    You should use either Qtopia fully, or the command-line fully.
 -  The Familiar repository contains many applications. We have not
    fully tested these applications and cannot guarantee their
    functionality. In particular, the Opie applications may not
    function. Opie-Console, however, does work using the Updates
    section of the software repository,
    http://familiar.sdgsystems.com/releases.
 -  The Familiar repository contains kernel modules that do not apply
    to the Recon. Your Recon has many kernel modules already
    installed. Additional modules must be built from the kernel
    sources, available at http://familiar.sdgsystems.com/recon/.
 -  Some MP3 files may not play properly from the Qtopia music player,
    depending on their compression ratio.
 -  The Qtopia e-mail client cannot handle large numbers of messages
    using IMAP.