Installation
============

Preface:
If you are a lucky Debian Sarge user and you have Internet online acess,
you may ignore this file, just put the lines:
  deb http://www.stud.uni-karlsruhe.de/~ubq7/debian testing main
  deb-src http://www.stud.uni-karlsruhe.de/~ubq7/debian testing main
into your: 
  /etc/apt/sources.list
file and call:
  apt-get update
  apt-get install obextool

The Debian repository for ObexTool, maintaned by Hendrik Sattler (programmer
of the great software for Siemens mobiles SCMxx) - see also
  http://www.hendrik-sattler.de/scmxx/
will do the rest for you.
After this use:
  obextool


In any other case you need:

1 TCL/Tk version 8.x
    Tool Command Language (Tcl) is an interpreted language and very portable 
    interpreter for that language. Tcl is embeddable and extensible, and has
    been widely used since its creation in 1988 by John Ousterhout. 
    Tk is a GUI toolkit for Tcl.
    You may download it from http://tcl.sourceforge.net/
    or install it form your favourite freeware server or Linux distribution.
  I've used 8.4, but older versions should work too.

2 The BWidget Toolkit 
    The BWidget library was originally developed by UNIFIX Online, and
    released under both the GNU Public License and the Tcl license.
    You may download it from http://sourceforge.net/projects/tcllib
    or install it from your favourite freeware server or Linux distribution.
  I've used BWidget 1.7.0 but older versions should work also.
  I've found a version dependecy between Tk and BWidgets, Tk 8.2 runs with
    BWidget 1.2 and BWidget 1.7 require a higher Tk version (tested 8.4).
  If using the danish language files, you should copy the contrib file
    da.rc file to the bwidget lang directory. 
  
3 TableList, a multi-column listbox package written by
    Csaba Nemethi <csaba.nemethi@t-online.de>
    You may download it from http://www.nemethi.de
    or install it from your favourite freeware server (I don't know a Linux
    distribution which contains tha TableList package).
  I've used Tablelist 3.3, but older and newer version should work also.
  To install it, you may unpack the whole package into a directory which is 
  defined in the TCL-variable $auto_path. 
  Example:
    tclsh
    % echo $auto_path
    /usr/lib/tcl8.4 /usr/lib
    exit
    cd /usr/lib
    tar -xzvf /root/tablelist3.3.tar.gz
  Act similar according the BWidget toolkit if you do not have preconfigured
  package like a RPM or DEB.
    
4 The OpenOBEX library
    The overall goal of this project is to make an open source implementation
    of the Object Exchange (OBEX) protocol. OBEX is a session protocol and
    can best be described as a binary HTTP protocol.
    You may download it from 
      http://openobex.sourceforge.net/projects/openobex/
    or install it from your favourite freeware server or Linux distribution.
  I've used OpenOBEX 1.0

5 The ObexFTP program by 
    Christian W. Zuckschwerdt <zany@triq.net>
    ObexFTP implements the Object Exchange (OBEX) protocols file transfer 
    feature.
    You may download it from http://triq.net/obexftp, from OpenOBEX too
      http://openobex.sourceforge.net/projects/openobex/
    or install it from your favourite freeware server or Linux distribution.
  I've used ObexFTP 0.10.1, 0.10.3 and 0.10.4-rc4.
  Be sure to configure your wrapper script etc/obexwrap.sh or use the
  correct commandline syntax for the --obexcmd command line option or
  set the environent variable OBEXCMD to the corresponding value.

Remark:
  Alternativley to topic 4 and 5 you may use the static linked version 
  of the obexftp.static program which you will find in the contrib/obexftp
  directory:
    $ ldd obexftp.static
            libc.so.6 => /lib/libc.so.6 (0x40031000)
            /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
    $ obexftp.static --version
    ObexFTP 0.10.4-rc3

6 The ObexTool Frontend, written by
    Gerhard Reithofer <gerhard.reithofer@tech-edv.co.at>
    You may download it from 
      http://www.tech-edv.co.at/programmierung/gplsw.html
  This is version 0.33

  Unpack the tarball, 
  e.g. /usr/local/
    tar -xzvf /root/obextool-0.33.tar.gz
  the software will create a new subdirectory obextool-0.33.
  Change the configuration to your suits, the files are located in the
  etc-directory of the ObexTool (example /usr/local/obextool-0.33),
  or try using the commandline options (obextool.tk --help).
   
  Start the ObexTool:
    /usr/local/obextool-0.33/obextool.tk
  or try using a commandline like this:
    obextool.tk --obexcmd "obexftp -t /dev/modem"

  You may also create a symlink in the binary directory:
    ln -s /usr/local/obextool/obextool.tk /usr/bin/obextool
    obextool
  Note: You must set the environment value OBEXTOOL to the 
  installation dir if using a file link to obextool.tk.

  You may also create a shell in /usr/bin/obextool for using
  a specific configuration in /etc/obextool - example:
    #!/bin/sh
    # ObexTool startup shell 
    #
    OBEXDIR=/usr/share/obextool
    OBEXTOOL_CFG=/etc/obextool
    OBEXTCMD="$OBEXDIR/contrib/obexftp/obexftp.static -t /dev/modem"
    export OBEXDIR OBEXTOOL_CFG OBEXTCMD
    #
    # Let's start the ObexTool without memory status 
    # feature (if no Siemens), using Tk version 8.4 and
    # a specific configuration directory /etc/obextool
    # and the contributed static compiled obexftp version.
    wish8.4 $OBEXDIR/obextool.tk --memstat 0 

  You also may have a look at Hendrik Sattlers obextool startup script
  for Debian in the contrib/startup directory.
 
  If ObexTool does not find its libraries, a message will be displayed. Use
  the environment variable OBEXTOOL to point to the ObexTool installation 
  directory (esp. when using symlinks to obextool.tk).
    export OBEXTOOL=/usr/local/obextool03
    obextool

Enjoy.
