Main.Documentation.Bundles
RXTX
en
0
Main.Documentation.Bundles
xwiki:XWiki.donsez
xwiki:XWiki.calmant
xwiki:XWiki.calmant
1276951873000
1295974701000
1295974701000
1.16
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.
<h2 class="heading-1"><span id="HAspire3A3AOSGiBundles3A3ARXTX">Aspire :: OSGi Bundles :: RXTX</span></h2><p class="paragraph"/><hr class="line"/>
<ul>
<li><a href="#HGoal">1 Goal</a>
<li><a href="#HRXTXCommand">2 RXTX Command</a>
<li><a href="#HSampleusage">3 Sample usage</a>
<li><a href="#HRXTX22pre">4 RXTX 2.2-pre</a>
<ul>
<li><a href="#HBuildthebundle">4.1 Build the bundle</a>
</ul></ul> <hr class="line"/>
<h3 class="heading-1-1"><span id="HGoal">Goal</span></h3><p class="paragraph"/>This bundle packages the java classes and shared libraries (.so, .dll) of the <span class="wikiexternallink"><a href="http://users.frii.com/jarvi/rxtx/index.html">RXTX project</a></span>. 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 ...).<p class="paragraph"/>The artifact is org.ow2.aspirerfid:rxtx
<ul class="star">
<li><span class="wikiexternallink"><a href="http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx%2F">rxtx</a></span></li>
<li><span class="wikiexternallink"><a href="http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx.cmd%2F">rxtx.cmd</a></span></li>
<li><span class="wikiexternallink"><a href="http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx-2.2-pre%2F">rxtx-2.2-pre</a></span> (optional)</li>
</ul><h3 class="heading-1-1"><span id="HRXTXCommand">RXTX Command</span></h3>
This command for the Felix shell enables to to send and to receive data to/from serial or parallel devices for:
<ul class="star">
<li>debugging programs using gnu.io</li>
<li>dumping serial port (raw or formatted) output (GPS, RFID reader, ...)</li>
</ul>The options are:
<div class="code"><pre>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 : <span class="java-keyword">switch</span> IO in hex
rxtx ascii : <span class="java-keyword">switch</span> 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 <span class="java-keyword">for</span> IO parsing and printing. The class could be exported by a external bundle
rxtx help : display <span class="java-keyword">this</span> help</pre></div><p class="paragraph"/>
The option iowrapper loads a java class implementing the interface <span class="wikiexternallink"><a href="http://websvn.ow2.org/filedetails.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx.cmd%2Fsrc%2Fmain%2Fjava%2Forg%2Fow2%2Faspirerfid%2Frxtx%2Fcmd%2FIOWrapper.java">IOWrapper</a></span> in order
<ul class="star">
<li>to encode the messages sent to the port</li>
<li>to format the message received from the port</li>
</ul><span class="wikiexternallink"><a href="http://websvn.ow2.org/filedetails.php?repname=aspire&path=%2Ftrunk%2Fbundles%2Fcommon%2Frxtx.cmd%2Fsrc%2Fsite%2Frxtx.txt">Examples</a></span>
<h3 class="heading-1-1"><span id="HSampleusage">Sample usage</span></h3>
<h3 class="heading-1-1"><span id="HRXTX22pre">RXTX 2.2-pre</span></h3><p class="paragraph"/>A pre-release if 2.2 version is available at : <span class="wikiexternallink"><a href="http://rxtx.qbang.org/wiki/index.php/Download">RXTX Download page</a></span>.
It seems to correct some incapacitating bugs on Linux 2.6 kernels.
<h4 class="heading-1-1-1"><span id="HBuildthebundle">Build the bundle</span></h4>
<ol><li>Download the latest RXTX 2.2 binary version : <span class="wikiexternallink"><a href="http://rxtx.qbang.org/wiki/index.php/Download">RXTX Download page</a></span>.</li>
<li>Extract all Windows, Linux and Mac OS files and place them according to the existing folder structure in the bundle ./src/main/resources folder.</li>
<li>An extra file may be needed for the i386 version : rxtxParallel.dll. It can be found in the latest RXTX 2.1 binary release.</li>
<li>Build and install with Maven.</li>
</ol>