LTP: GIOP tunneling over L2CAP

Disclaimer

This software is provided on an "as is" basis. The VIVIAN consortium does not commit to provide any updates, bug-fixes or other kind of support for this software. The VIVIAN consortium declines any responsibility for possible inconveniences that the use of this software may cause.

This software builds on MIWCO and hence it is licensed under the same terms: GNU LGPL for libraries and GNU GPL for programs.

The LTP software is an extension of the MIWCO wireless CORBA provided by the University of Helsinki. It extends MIWCO with support for GIOP tunneling support over the Bluetooth L2CAP layer. To use LTP you need:

• The LTP software (miwco-ltp.tgz, 1.8MB) which includes MIWCO version 020109 with some modification mentioned below, plus a number of ltp specific files.
• The Bluez Bluetooth stack (http://bluez.sourceforge.net)
• Linux kernel 2.4.13
• Linux PCMCIA package pcmcia-cs version 3.1.31
• DTL1 driver version 0.4 for the Nokia Connectivity Card DTL-1
• DTL-1 Nokia Connectivity Card

The following MIWCO files have been modified:

• include/mico/MobileTerminal.idl - LTP tunneling identifier
• include/mico/impl.h - including of LTP classes
• include/mico/ior.h - support for the IOR profile
• coss/wireless/proxy.cc - recognizes LTP
• coss/wireless/AccessBridge_impl.cc - recognizes LTP
• orb/address.cc - creates static address parser
• orb/orb.cc - support for the IOR profile

The following files have been added:

• orb/ltp_address.cc - LTP address format
• orb/ltp_addressparser.cc - parser for the address format
• orb/ltp_transport.cc - transport over L2CAP
• orb/ltp_transportserver.cc - transport server
• orb/ltp_ior.cc - IOR profile

NOTES:

The LTP software can be compiled exactly like MIWCO-020109 so please refer to MIWCO's documentation for instructions (http://www.cs.helsinki.fi/u/jkangash/miwco/)

In order to use any tunneling, including LTP, you have to have certain preferences made in the configuration files ~/.micorc and ~/.hlarc

To start the program you need to start Naming Service, Home Location Agent, Access Bridge and Terminal Bridge. The scripts demons (naming service) and demohla (home location agent) can be found in scripts.tgz. Place the demons script in the coss/naming directory and the demohla script in the coss/wireless directory; they start the correspondent programs with correct command line options.

The directory coss/wireless contains two scripts, bt_ab and bt_tb for starting LTP aware Access Bridge and Terminal Bridge. These files take the address of the BT access bridge in the WATMGTPAddr argument. The address is format bt-l2cap:XX:XX:XX:XX:XX:XX#PSM (check BlueZ documentation for more info about address and psm).

Since LPT implements the IOR profile, MIWCO-LTP can now be used like traditional ORB without any wireless parts. The directory demo/ltp/hello contains a simple helloworld example and startup scripts for both server and client. In order to use the IOR profile the Bluetooth address must be given in the -ORBIIOPAddr command line parameter (e.g. -ORBIIOPAddr bt-l2cap:XX:XX:XX:XX:XX:XX#PSM ).

If you are using miwco-ltp with JacORB, then you must use the JacORB version 1.2.3. Newer versions that support GIOP 1.2 (1.3.3 and 1.4 beta2 tested) don't work because they don't have NEEDS_ADDRESSING_MODE reply implemented. But since JacORB 1.2.3 has only GIOP 1.0, this problematic reply isn't used (mobile object key is used instead).