Main.Documentation.Bundles
OneWireProducer
en
0
Main.Documentation.Bundles
xwiki:XWiki.donsez
xwiki:XWiki.donsez
xwiki:XWiki.donsez
1276765943000
1276772710000
1276772710000
1.20
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
<h2 class="heading-1"><span id="HAspire3A3AOSGiBundles3A3AOneWireProducer">Aspire :: OSGi Bundles :: OneWireProducer</span></h2>
<hr class="line"/>
<ul>
<li><a href="#HContext">1 Context</a>
<li><a href="#HBuild">2 Build</a>
<ul>
<li><a href="#HSources">2.1 Sources</a>
<li><a href="#HInstruction">2.2 Instruction</a>
<li><a href="#HExtra">2.3 Extra</a>
</ul>
<li><a href="#HConfiguration">3 Configuration</a>
<li><a href="#HArtifacts">4 Artifacts</a>
<li><a href="#HLink">5 Link</a>
<ul>
<li><a href="#HStarterkit">5.1 Starter kit</a>
</ul></ul> <hr class="line"/><p class="paragraph"/>This section describes the bundle for OneWire sensors
<h3 class="heading-1-1"><span id="HContext">1 Context</span></h3>
The OneWire protocol is a proprietary serial protocol for communicating with low-cost <span class="wikiexternallink"><a href="http://www.maxim-ic.com/products/ibutton/products/ibuttons.cfm">iButton devices</a></span>. 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 <span class="wikiexternallink"><a href="http://www.maxim-ic.com/products/ibutton/applications">many applications</a></span> such access control, door lock, guard tour, cold supply chain, ....<p class="paragraph"/>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).
<h3 class="heading-1-1"><span id="HBuild">2 Build</span></h3>
<h4 class="heading-1-1-1"><span id="HSources">2.1 Sources</span></h4>
<ul class="star">
<li>trunk/bundles/common</li>
<li>trunk/bundles/sensors</li>
</ul><h4 class="heading-1-1-1"><span id="HInstruction">2.2 Instruction</span></h4>
<ol><li>we must install the 1-Wire SDK for Java. this library is available for download from <span class="nobr"><a href="http://files.dalsemi.com/auto_id/public/owapi_1_10.zip">http://files.dalsemi.com/auto_id/public/owapi_1_10.zip</a></span></li>
<li>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_10libOneWireAPI.jar</li>
<li>cd trunk/bundles/common/onewireapi; mvn clean install</li>
<li>cd trunk/bundles/sensors/onewireproducer; mvn clean install</li>
</ol><h4 class="heading-1-1-1"><span id="HExtra">2.3 Extra</span></h4>
Windows DLL are provided in the <span class="wikiexternallink"><a href="http://www.maxim-ic.com/products/ibutton/software/tmex/index.cfm">"1-Wire Drivers"</a></span>
and can be added in the org.ow2.aspirerfid:org.ow2.aspirerfid.onewireapi. Change the Bundle-NativeCode directive in the pom.xml.
<ol><li>adapterName=DS9097U on COM ports (could run without DLL ibtmjava.dll) -> product name DS9097U-9</li>
<li>adapterName={DS9097U} on COM ports (required DLL Ib97u32.dll)</li>
<li>adapterName={DS9097E} on COM ports (required DLL Ib97e32.dll)</li>
<li>adapterName={DS9490} on USB ports (required DLL ib90usb.dll)</li>
<li>adapterName={DS1410E} on LPT ports (required DLL Ib10e32.dll)</li>
</ol><h3 class="heading-1-1"><span id="HConfiguration">3 Configuration</span></h3>
You must configure the properties adapterName and port for your OneWire adapter (see <span class="nobr"><a href="http://www.maxim-ic.com/products/ibutton/products/readers.cfm">http://www.maxim-ic.com/products/ibutton/products/readers.cfm</a></span>).
The default values are {DS9490} USB1.
<h3 class="heading-1-1"><span id="HArtifacts">4 Artifacts</span></h3>
The artifacts to deploy are
<ul class="star">
<li> org.ow2.aspirerfid:org.ow2.aspirerfid.onewireapi</li>
<li> org.ow2.aspirerfid:org.ow2.aspirerfid.onewireproducer</li>
</ul>Optionnally, the artifact provides a Felix shell command to inspect the OneWire devices and adapters.
<ul class="star">
<li>org.ow2.aspirerfid:org.ow2.aspirerfid.onewireapi.cmd</li>
</ul><div class="code"><pre>-> ow help
ow prop : list the properties
ow list : list the available devices on the <span class="java-keyword">default</span> adapter
ow list <name> <port> : list the available devices on the <span class="java-keyword">default</span> adapter
ow listAll : list the available devices on all adapters
ow adapters : list the available adapters
ow help : display <span class="java-keyword">this</span> help<p class="paragraph"/>
-> 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 <span class="java-keyword">protected</span> 1-Wire EEPROM.<p class="paragraph"/>-> ow list {DS9490} USB1</pre></div>
<h3 class="heading-1-1"><span id="HLink">5 Link</span></h3>
iButton web site <span class="nobr"><a href="http://www.maxim-ic.com/products/ibutton/ibuttons">http://www.maxim-ic.com/products/ibutton/ibuttons</a></span>
<h4 class="heading-1-1-1"><span id="HStarterkit">5.1 Starter kit</span></h4>
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.
<ul class="star">
<li><span class="nobr"><a href="http://www.maxim-ic.com/products/ibutton/products/ibuttons.cfm">http://www.maxim-ic.com/products/ibutton/products/ibuttons.cfm</a></span></li>
<li><span class="nobr"><a href="http://www.maxim-ic.com/datasheet/index.mvp/id/3834">http://www.maxim-ic.com/datasheet/index.mvp/id/3834</a></span></li>
<li><span class="nobr"><a href="http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2706">http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2706</a></span></li>
</ul>