Consortium Activities Projects Forge Events

Aspire :: OSGi Bundles :: RXTX

1 Aspire :: OSGi Bundles :: RXTX

----
#toc("" "" "true")
----

1.1 Goal

This bundle packages the java classes and shared libraries (.so, .dll) of the [RXTX project>http://users.frii.com/jarvi/rxtx/index.html]. The RXTX project enables to send and to receive data to/from serial or parallel devices (RFID readers, smartcards readers, modems, gsm, nmea0183 gps, onewire adapter, bluetooth serial port, PIC/AVR boards like Arduino ...).

The artifact is org.ow2.aspirerfid:rxtx

* [rxtx>http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx%2F]
* [rxtx.cmd>http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx.cmd%2F]
* [rxtx-2.2-pre>http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx-2.2-pre%2F] (optional)

1.1 RXTX Command
This command for the Felix shell enables to to send and to receive data to/from serial or parallel devices for:
* debugging programs using gnu.io
* dumping serial port (raw or formatted) output (GPS, RFID reader, ...)

The options are:
{code}
rxtx list                  : list the available ports
rxtx open <portname> <baudrate> <flowctrlin> <flowctrlout> <databits> <stopbits> <parity>
                               flowctrl=None,Xon/XoffOut,Xon/XoffIn,RTS/CTSIn,RTS/CTSOut
                               databits=5,6,7,8
                               stopbits=1,1.5,2
                               parity=None,Odd,Even
                           : open a serial port
rxtx close                 : close the current opened port
rxtx send <bytes in hexa>  : send message bytes
rxtx binary                : switch IO in hex
rxtx ascii                 : switch IO in ascii
rxtx buffersize <size>     : set IO buffer size
rxtx sendurl <url>         : send bytes contained at the url
rxtx logfile <filepath>    : log received bytes in the file
rxtx iowrapper <classname> : set a wrapper for IO parsing and printing. The class could be exported by a external bundle
rxtx help                  : display this help
{code}

The option iowrapper loads a java class implementing the interface [IOWrapper>http://websvn.ow2.org/filedetails.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx.cmd%2Fsrc%2Fmain%2Fjava%2Forg%2Fow2%2Faspirerfid%2Frxtx%2Fcmd%2FIOWrapper.java] in order
* to encode the messages sent to the port
* to format the message received from the port

[Examples>http://websvn.ow2.org/filedetails.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx.cmd%2Fsrc%2Fsite%2Frxtx.txt]

1.1 Sample usage

1.1 RXTX 2.2-pre

A pre-release if 2.2 version is available at : [RXTX Download page>http://rxtx.qbang.org/wiki/index.php/Download].
It seems to correct some incapacitating bugs on Linux 2.6 kernels.

1.1.1 Build the bundle

# Download the latest RXTX 2.2 binary version : [RXTX Download page>http://rxtx.qbang.org/wiki/index.php/Download].
# Extract all Windows, Linux and Mac OS files and place them according to the existing folder structure in the bundle ./src/main/resources folder.
# An extra file may be needed for the i386 version : rxtxParallel.dll. It can be found in the latest RXTX 2.1 binary release.
# Build and install with Maven.