Consortium Activities Projects Forge Events

Aspire :: OSGi Bundles :: OneWireProducer

1 Aspire :: OSGi Bundles :: OneWireProducer
----
#toc("" "" "true")
----

This section describes the bundle for OneWire sensors

1.1 Context
The OneWire protocol is a proprietary serial protocol for communicating with low-cost [iButton devices>http://www.maxim-ic.com/products/ibutton/products/ibuttons.cfm]. A iButton had a globally unique 64 bits long IDentifiers and optionnally memory banks, sensors (thermometer, hygrometer), realtime clock, wo data loggers.. According to Maxim IC, over 175 million iButtons are currently in circulation and they are used in [many applications>http://www.maxim-ic.com/products/ibutton/applications] such access control, door lock, guard tour, cold supply chain, ....

The OneWireProducer bundle registers one Producer service for each iButton connected to the bus managed by the OneWire adapter attached to the host (RS232,Parallel,USB).

1.1 Build
1.1.1 Sources
* trunk/bundles/common
* trunk/bundles/sensors

1.1.1 Instruction
# we must install the 1-Wire SDK for Java.  this library is available for download from http://files.dalsemi.com/auto_id/public/owapi_1_10.zip
# we must install the library in your Maven repository  with mvn install:install-file -DgroupId=com.dalsemi.onewire -DartifactId=onewireapi -Dversion=1.10.0 -Dpackaging=jar -Dfile=owapi_1_10\lib\OneWireAPI.jar
# cd trunk/bundles/common/onewireapi; mvn clean install
# cd trunk/bundles/sensors/onewireproducer; mvn clean install

1.1.1 Extra
Windows DLL are provided in the ["1-Wire Drivers">http://www.maxim-ic.com/products/ibutton/software/tmex/index.cfm]
and can be added in the org.ow2.aspirerfid:org.ow2.aspirerfid.onewireapi. Change the Bundle-NativeCode directive in the pom.xml.

# adapterName=DS9097U on COM ports (could run without DLL ibtmjava.dll) -> product name DS9097U-9 
# adapterName={DS9097U} on COM ports (required DLL Ib97u32.dll)
# adapterName={DS9097E} on COM ports (required DLL Ib97e32.dll)
# adapterName={DS9490}  on USB ports (required DLL ib90usb.dll)
# adapterName={DS1410E} on LPT ports (required DLL Ib10e32.dll)

1.1 Configuration
You must configure the properties adapterName and port for your OneWire adapter (see http://www.maxim-ic.com/products/ibutton/products/readers.cfm).
The default values are {DS9490} USB1.

1.1 Artifacts
The artifacts to deploy are
*  org.ow2.aspirerfid:org.ow2.aspirerfid.onewireapi
*  org.ow2.aspirerfid:org.ow2.aspirerfid.onewireproducer

Optionnally, the artifact provides a Felix shell command to inspect the OneWire devices and adapters.
* org.ow2.aspirerfid:org.ow2.aspirerfid.onewireapi.cmd

{code}

-> ow help
ow prop                  : list the properties
ow list                  : list the available devices on the default adapter
ow list <name> <port>    : list the available devices on the default adapter
ow listAll               : list the available devices on all adapters
ow adapters              : list the available adapters
ow help                  : display this help

-> ow list
Adapter: {DS9490} Port: USB1
BD000801A332FA10: DS1920 (DS18S20) Digital thermometer measures temperatures ...
830000002C575881: DS1990A (DS2401,DS2411) 64-bit unique serial number
27000000CD3B8D2D: DS1972 (DS2431) 1K-Bit protected 1-Wire EEPROM.

-> ow list {DS9490} USB1

{code}

1.1 Link
iButton web site http://www.maxim-ic.com/products/ibutton/ibuttons

1.1.1 Starter kit
if you want to develop with onewire devices, you need as least one adapter (DS9490 is fine), one connector (DS1402D-DR8 is fine) and some iButtons.
* http://www.maxim-ic.com/products/ibutton/products/ibuttons.cfm
* http://www.maxim-ic.com/datasheet/index.mvp/id/3834
* http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2706