Main.Documentation
Bundles
en
0
Main.Documentation
xwiki:XWiki.donsez
xwiki:XWiki.donsez
xwiki:XWiki.donsez
1276181207000
1308752231000
1308752231000
1.52
Aspire :: OSGi Bundles for Aspire servers
1 Aspire :: OSGi Bundles for Aspire servers
----
#toc("" "" "true")
----
This section describes the OSGi bundles used in the Aspire middleware.
1.1 Source repository
* [Source repository>http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2F]
1.1 OBR
The artifact will be available soon through an [OBR index>http://www.osgi.org/download/rfc-0112_BundleRepository.pdf] mapped on a Maven repository.
1.1 General Purpose
* [Bluetooth Server>Main.Documentation.Bundles.BluetoothServer]
* [RXTX>Main.Documentation.Bundles.RXTX]
* [LibUSBJava>Main.Documentation.Bundles.LibUSBJava]
* [Phidget library>Main.Documentation.Bundles.PhidgetLib]
1.1 Readers
1.1.1 Libraries
The bundles for readers package only implementation classes imported by the ALEServer barfile (bundle+war) deployed on the OSGi platform.
* [ProximaRF Desktop USB reader>Main.Documentation.Bundles.ProximaRFDesktopReader]
* [TagSys Medio Serial reader>Main.Documentation.Bundles.TagSysMedioReader]
* [ACR 122 USB reader>Main.Documentation.Bundles.ACR122Reader]
* [OneWire reader>Main.Documentation.Bundles.OneWireReader]
* [Phidget RFID Reader>Main.Documentation.Bundles.PhidgetReader]
1.1.1 Bundles with HALAdaptor services
The bundles package services that are automatically added and removed to the ALEServer' LRSpec list
1.1.1 UPnP RFID Readers
* [UPnP RFID Reader (based on ACR122U>Main.Documentation.Bundles.UPnPRFIDReader]
1.1 Sensors
1.1.1 Data exchanges
Data sent by the sensors to the ALEServer are:
* [org.osgi.util.measurement.Measurement>http://www.osgi.org/javadoc/r4v42/org/osgi/util/measurement/Measurement.html]
* [org.osgi.util.measurement.State>http://www.osgi.org/javadoc/r4v42/org/osgi/util/measurement/State.html]
* [org.osgi.util.position.Position>http://www.osgi.org/javadoc/r4v42/org/osgi/util/position/Position.html]
* [java.awt.Image>http://java.sun.com/javase/6/docs/api/java/awt/Image.html]
* [javax.imageio.IIOImage>http://java.sun.com/javase/6/docs/api/javax/imageio/IIOImage.html]
* java.lang.Double
* java.lang.Float
* java.lang.Long
* java.lang.Integer
Data values must be represented in units defined by the [International System of Units>http://en.wikipedia.org/wiki/International_System_of_Units] (such as the [org.osgi.util.measurement.Unit>http://www.osgi.org/javadoc/r4v42/org/osgi/util/measurement/Unit.html]).
Sensors data types are named ~~[flavors>http://www.osgi.org/javadoc/r4v42/org/osgi/service/wireadmin/WireConstants.html#WIREADMIN_PRODUCER_FLAVORS]~~ in the WireAdmin terminology.
Other data types could be
* Location API for J2ME (JSR 179) ( http://www.jcp.org/en/jsr/detail?id=179)
* Java Distributed Data Acquisition and Control API (JDDAC) ( https://jddac.dev.java.net)
1.1.1 Sensors properties
Sensors and data properties qualify the Producer services and Event properties used in the Aspire components.
* application.name
* value.unit
* ...
[UPnP constants>http://www.osgi.org/javadoc/r4v42/org/osgi/service/upnp/UPnPDevice.html] can be used also.
1.1.1 OSGi WireAdmin based sensors
The sensors are developed according the OSGi [WireAdmin>http://www.osgi.org/javadoc/r4v42/org/osgi/service/wireadmin/package-summary.html] specification.
The bundles for sensors package Producer services. Those service are automatically wired to the Consumer service of the ALEServer barfile.
* [OneWire>Main.Documentation.Bundles.OneWireProducer]
* [TEMPer>Main.Documentation.Bundles.TEMerProducer]
* [Oregon WMR 200 weather station>Main.Documentation.Bundles.WMR200WeatherStation]
* [LaCrosse WS 2300 weather station>Main.Documentation.Bundles.WS2300WeatherStation]
* Sunspot
* Wiimote
* [NMEA GPS>Main.Documentation.Bundles.NMEAGPS]
* USB WebCam using JMF
* USB WebCam unig QT
* [USB Multimeter Velleman DVM 1200>Main.Documentation.Bundles.MultimeterDVM1200]
1.1.1 OSGi EventAdmin based sensors
The sensors are developed according the OSGi [EventAdmin>http://www.osgi.org/javadoc/r4v42/org/osgi/service/event/package-summary.html] specification. They send/post events containing measures to the ALEServer' topic <code>org/ow2/aspirerfid/aleserver/sensedata</code>.
The Event properties are :
1.1.1 OSGi MonitorAdmin based sensors
The sensors are developed according the OSGi [MonitorAdmin>http://www.osgi.org/javadoc/r4v42/org/osgi/service/monitor/package-summary.html] specification.
1.1.1 OSGi UPnP Base Driver based sensors
The sensors are developed according the OSGi [UPnP Base Driver>http://www.osgi.org/javadoc/r4v42/org/osgi/service/upnp/package-summary.html] specification.
1.1 Actuators
* [iBuddy>Main.Documentation.Bundles.iBuddy]
* [Rocket launcher>Main.Documentation.Bundles.RocketLauncher]
* [Velleman K8090 USB 8 relays>Main.Documentation.Bundles.K8090]
* [Servo Motors>Main.Documentation.Bundles.ServoMotor]
1.1.1 OSGi UPnP Base Driver based actuators
The sensors are developed according the OSGi [UPnP Base Driver>http://www.osgi.org/javadoc/r4v42/org/osgi/service/upnp/package-summary.html] specification.
1.1 Sensors+Actuators
* Lego Mindstorms
* [USB Phidgets>Main.Documentation.Bundles.Phidgets]
* [Velleman K8055 acquisition board>Main.Documentation.Bundles.K8055]
* [Arduino>Main.Documentation.Bundles.Arduino]
1.1 Others
1.1 Utilities
* SensorConsumer
* WireAdmin-to-EventAdmin bridge
1.1 How to develop
1.1.1 Serial devices (and serial-to-USB devices)
* RXTX
1.1.1 USB devices
* LibUSB Java
1.1.1 Bluetooth devices
* Bluetooth bridge
1.1.1 Zigbee devices
1.1.1 6lowPAN devices
1.1.1 Sample of OSGi WireAdmin producer
1.1.1 Sample of OSGi WireAdmin consumer
1.1.1 Sample of OSGi EventAdmin publisher
1.1.1 Sample of OSGi EventAdmin subscriber (ie EventHandler)
<h2 class="heading-1"><span id="HAspire3A3AOSGiBundlesforAspireservers">Aspire :: OSGi Bundles for Aspire servers</span></h2>
<hr class="line"/>
<ul>
<li><a href="#HSourcerepository">1 Source repository</a>
<li><a href="#HOBR">2 OBR</a>
<li><a href="#HGeneralPurpose">3 General Purpose</a>
<li><a href="#HReaders">4 Readers</a>
<ul>
<li><a href="#HLibraries">4.1 Libraries</a>
<li><a href="#HBundleswithHALAdaptorservices">4.2 Bundles with HALAdaptor services</a>
<li><a href="#HUPnPRFIDReaders">4.3 UPnP RFID Readers</a>
</ul>
<li><a href="#HSensors">5 Sensors</a>
<ul>
<li><a href="#HDataexchanges">5.1 Data exchanges</a>
<li><a href="#HSensorsproperties">5.2 Sensors properties</a>
<li><a href="#HOSGiWireAdminbasedsensors">5.3 OSGi WireAdmin based sensors</a>
<li><a href="#HOSGiEventAdminbasedsensors">5.4 OSGi EventAdmin based sensors</a>
<li><a href="#HOSGiMonitorAdminbasedsensors">5.5 OSGi MonitorAdmin based sensors</a>
<li><a href="#HOSGiUPnPBaseDriverbasedsensors">5.6 OSGi UPnP Base Driver based sensors</a>
</ul>
<li><a href="#HActuators">6 Actuators</a>
<ul>
<li><a href="#HOSGiUPnPBaseDriverbasedactuators">6.1 OSGi UPnP Base Driver based actuators</a>
</ul>
<li><a href="#HSensors2BActuators">7 Sensors+Actuators</a>
<li><a href="#HOthers">8 Others</a>
<li><a href="#HUtilities">9 Utilities</a>
<li><a href="#HHowtodevelop">10 How to develop</a>
<ul>
<li><a href="#HSerialdevices28andserialtoUSBdevices29">10.1 Serial devices (and serial-to-USB devices)</a>
<li><a href="#HUSBdevices">10.2 USB devices</a>
<li><a href="#HBluetoothdevices">10.3 Bluetooth devices</a>
<li><a href="#HZigbeedevices">10.4 Zigbee devices</a>
<li><a href="#H6lowPANdevices">10.5 6lowPAN devices</a>
<li><a href="#HSampleofOSGiWireAdminproducer">10.6 Sample of OSGi WireAdmin producer</a>
<li><a href="#HSampleofOSGiWireAdminconsumer">10.7 Sample of OSGi WireAdmin consumer</a>
<li><a href="#HSampleofOSGiEventAdminpublisher">10.8 Sample of OSGi EventAdmin publisher</a>
<li><a href="#HSampleofOSGiEventAdminsubscriber28ieEventHandler29">10.9 Sample of OSGi EventAdmin subscriber (ie EventHandler)</a>
</ul></ul> <hr class="line"/><p class="paragraph"/>This section describes the OSGi bundles used in the Aspire middleware.
<h3 class="heading-1-1"><span id="HSourcerepository">1 Source repository</span></h3>
<ul class="star">
<li><span class="wikiexternallink"><a href="http://websvn.ow2.org/listing.php?repname=aspire&path=%2Ftrunk%2Fbundles%2F">Source repository</a></span></li>
</ul><h3 class="heading-1-1"><span id="HOBR">2 OBR</span></h3>
The artifact will be available soon through an <span class="wikiexternallink"><a href="http://www.osgi.org/download/rfc-0112_BundleRepository.pdf">OBR index</a></span> mapped on a Maven repository.
<h3 class="heading-1-1"><span id="HGeneralPurpose">3 General Purpose</span></h3>
<ul class="star">
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/BluetoothServer">Bluetooth Server</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/RXTX">RXTX</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/LibUSBJava">LibUSBJava</a></span></li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/Main.Documentation.Bundles/PhidgetLib?parent=Main.Documentation.Bundles"><span class="wikicreatelinktext">Phidget library</span><span class="wikicreatelinkqm">?</span></a></li>
</ul><h3 class="heading-1-1"><span id="HReaders">4 Readers</span></h3>
<h4 class="heading-1-1-1"><span id="HLibraries">4.1 Libraries</span></h4>
The bundles for readers package only implementation classes imported by the ALEServer barfile (bundle+war) deployed on the OSGi platform.
<ul class="star">
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/ProximaRFDesktopReader">ProximaRF Desktop USB reader</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/TagSysMedioReader">TagSys Medio Serial reader</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/ACR122Reader">ACR 122 USB reader</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/OneWireReader">OneWire reader</a></span></li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/Main.Documentation.Bundles/PhidgetReader?parent=Main.Documentation.Bundles"><span class="wikicreatelinktext">Phidget RFID Reader</span><span class="wikicreatelinkqm">?</span></a></li>
</ul><h4 class="heading-1-1-1"><span id="HBundleswithHALAdaptorservices">4.2 Bundles with HALAdaptor services</span></h4>
The bundles package services that are automatically added and removed to the ALEServer' LRSpec list
<h4 class="heading-1-1-1"><span id="HUPnPRFIDReaders">4.3 UPnP RFID Readers</span></h4>
<ul class="star">
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/UPnPRFIDReader">UPnP RFID Reader (based on ACR122U</a></span></li>
</ul><h3 class="heading-1-1"><span id="HSensors">5 Sensors</span></h3>
<h4 class="heading-1-1-1"><span id="HDataexchanges">5.1 Data exchanges</span></h4>
Data sent by the sensors to the ALEServer are:
<ul class="star">
<li><span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/util/measurement/Measurement.html">org.osgi.util.measurement.Measurement</a></span></li>
<li><span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/util/measurement/State.html">org.osgi.util.measurement.State</a></span></li>
<li><span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/util/position/Position.html">org.osgi.util.position.Position</a></span></li>
<li><span class="wikiexternallink"><a href="http://java.sun.com/javase/6/docs/api/java/awt/Image.html">java.awt.Image</a></span></li>
<li><span class="wikiexternallink"><a href="http://java.sun.com/javase/6/docs/api/javax/imageio/IIOImage.html">javax.imageio.IIOImage</a></span></li>
<li>java.lang.Double</li>
<li>java.lang.Float</li>
<li>java.lang.Long</li>
<li>java.lang.Integer</li>
</ul>Data values must be represented in units defined by the <span class="wikiexternallink"><a href="http://en.wikipedia.org/wiki/International_System_of_Units">International System of Units</a></span> (such as the <span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/util/measurement/Unit.html">org.osgi.util.measurement.Unit</a></span>).<p class="paragraph"/>Sensors data types are named <i class="italic"><span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/service/wireadmin/WireConstants.html#WIREADMIN_PRODUCER_FLAVORS">flavors</a></span></i> in the WireAdmin terminology.<p class="paragraph"/>Other data types could be
<ul class="star">
<li>Location API for J2ME (JSR 179) ( <span class="nobr"><a href="http://www.jcp.org/en/jsr/detail?id=179">http://www.jcp.org/en/jsr/detail?id=179</a></span>)</li>
<li>Java Distributed Data Acquisition and Control API (JDDAC) ( <span class="nobr"><a href="https://jddac.dev.java.net">https://jddac.dev.java.net</a></span>)</li>
</ul><h4 class="heading-1-1-1"><span id="HSensorsproperties">5.2 Sensors properties</span></h4>
Sensors and data properties qualify the Producer services and Event properties used in the Aspire components.
<ul class="star">
<li>application.name</li>
<li>value.unit</li>
<li>...</li>
</ul><span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/service/upnp/UPnPDevice.html">UPnP constants</a></span> can be used also.
<h4 class="heading-1-1-1"><span id="HOSGiWireAdminbasedsensors">5.3 OSGi WireAdmin based sensors</span></h4>
The sensors are developed according the OSGi <span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/service/wireadmin/package-summary.html">WireAdmin</a></span> specification.
The bundles for sensors package Producer services. Those service are automatically wired to the Consumer service of the ALEServer barfile.
<ul class="star">
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/OneWireProducer">OneWire</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/TEMerProducer">TEMPer</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/WMR200WeatherStation">Oregon WMR 200 weather station</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/WS2300WeatherStation">LaCrosse WS 2300 weather station</a></span></li>
<li>Sunspot</li>
<li>Wiimote</li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/NMEAGPS">NMEA GPS</a></span></li>
<li>USB WebCam using JMF</li>
<li>USB WebCam unig QT</li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/MultimeterDVM1200">USB Multimeter Velleman DVM 1200</a></span></li>
</ul><h4 class="heading-1-1-1"><span id="HOSGiEventAdminbasedsensors">5.4 OSGi EventAdmin based sensors</span></h4>
The sensors are developed according the OSGi <span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/service/event/package-summary.html">EventAdmin</a></span> specification. They send/post events containing measures to the ALEServer' topic <code>org/ow2/aspirerfid/aleserver/sensedata</code>.
The Event properties are :
<h4 class="heading-1-1-1"><span id="HOSGiMonitorAdminbasedsensors">5.5 OSGi MonitorAdmin based sensors</span></h4>
The sensors are developed according the OSGi <span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/service/monitor/package-summary.html">MonitorAdmin</a></span> specification.
<h4 class="heading-1-1-1"><span id="HOSGiUPnPBaseDriverbasedsensors">5.6 OSGi UPnP Base Driver based sensors</span></h4>
The sensors are developed according the OSGi <span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/service/upnp/package-summary.html">UPnP Base Driver</a></span> specification.
<h3 class="heading-1-1"><span id="HActuators">6 Actuators</span></h3>
<ul class="star">
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/iBuddy">iBuddy</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/RocketLauncher">Rocket launcher</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/K8090">Velleman K8090 USB 8 relays</a></span></li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/Main.Documentation.Bundles/ServoMotor?parent=Main.Documentation.Bundles"><span class="wikicreatelinktext">Servo Motors</span><span class="wikicreatelinkqm">?</span></a></li>
</ul><h4 class="heading-1-1-1"><span id="HOSGiUPnPBaseDriverbasedactuators">6.1 OSGi UPnP Base Driver based actuators</span></h4>
The sensors are developed according the OSGi <span class="wikiexternallink"><a href="http://www.osgi.org/javadoc/r4v42/org/osgi/service/upnp/package-summary.html">UPnP Base Driver</a></span> specification.
<h3 class="heading-1-1"><span id="HSensors2BActuators">7 Sensors+Actuators</span></h3>
<ul class="star">
<li>Lego Mindstorms</li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/Phidgets">USB Phidgets</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/K8055">Velleman K8055 acquisition board</a></span></li>
<li><span class="wikilink"><a href="/xwiki/bin/view/Main.Documentation.Bundles/Arduino">Arduino</a></span></li>
</ul><h3 class="heading-1-1"><span id="HOthers">8 Others</span></h3>
<h3 class="heading-1-1"><span id="HUtilities">9 Utilities</span></h3>
<ul class="star">
<li>SensorConsumer</li>
<li>WireAdmin-to-EventAdmin bridge</li>
</ul><h3 class="heading-1-1"><span id="HHowtodevelop">10 How to develop</span></h3>
<h4 class="heading-1-1-1"><span id="HSerialdevices28andserialtoUSBdevices29">10.1 Serial devices (and serial-to-USB devices)</span></h4>
<ul class="star">
<li>RXTX</li>
</ul><h4 class="heading-1-1-1"><span id="HUSBdevices">10.2 USB devices</span></h4>
<ul class="star">
<li>LibUSB Java</li>
</ul><h4 class="heading-1-1-1"><span id="HBluetoothdevices">10.3 Bluetooth devices</span></h4>
<ul class="star">
<li>Bluetooth bridge</li>
</ul><h4 class="heading-1-1-1"><span id="HZigbeedevices">10.4 Zigbee devices</span></h4>
<h4 class="heading-1-1-1"><span id="H6lowPANdevices">10.5 6lowPAN devices</span></h4>
<h4 class="heading-1-1-1"><span id="HSampleofOSGiWireAdminproducer">10.6 Sample of OSGi WireAdmin producer</span></h4>
<h4 class="heading-1-1-1"><span id="HSampleofOSGiWireAdminconsumer">10.7 Sample of OSGi WireAdmin consumer</span></h4>
<h4 class="heading-1-1-1"><span id="HSampleofOSGiEventAdminpublisher">10.8 Sample of OSGi EventAdmin publisher</span></h4>
<h4 class="heading-1-1-1"><span id="HSampleofOSGiEventAdminsubscriber28ieEventHandler29">10.9 Sample of OSGi EventAdmin subscriber (ie EventHandler)</span></h4>