<?xml version="1.0" encoding="UTF-8"?>

<xwikidoc>
<web>Main.Documentation.Bundles</web>
<name>ProximaRFDesktopReader</name>
<language></language>
<defaultLanguage>en</defaultLanguage>
<translation>0</translation>
<parent>Main.Documentation.ALEonOSGi</parent>
<creator>xwiki:XWiki.donsez</creator>
<author>xwiki:XWiki.gabo_pedraza</author>
<contentAuthor>xwiki:XWiki.gabo_pedraza</contentAuthor>
<creationDate>1277102916000</creationDate>
<date>1277469077000</date>
<contentUpdateDate>1277469077000</contentUpdateDate>
<version>1.9</version>
<title>Aspire :: OSGi Bundles :: ProximaRF Desktop Reader</title>
<template></template>
<attachment>
<filename>jna-3.2.5.jar</filename>
<filesize>947456</filesize>
<author>xwiki:XWiki.gabo_pedraza</author>
<date>1277469066000</date>
<version>1.1</version>
<comment></comment>
</attachment>
<content>1 Aspire :: OSGi Bundles :: ProximaRF Desktop Reader
----
#toc("" "" "true")
----

This section describes the bundle for ProximaRF Desktop reader (ie HALAdaptor)


1.1 Context
The [ProximaRF Desktop Reader&gt;http://www.proximarf.com/ProductsAndServices/DesktopPage.aspx] is a ISO 15693 RFID reader.

The ProximaRF Desktop Reader bundle packages a HALAdaptor for ProximaRF reader attached to the host (Serial emulated USB port).

1.1 Building process



# You must build the abstract-reader project. This project contains base classes used by all HAL adaptors.

&lt;blockquote&gt;
The sources of this project are in ~~trunk/bundles/readers/abstract-reader~~. Use maven to build this project, the instruction is mvn clean install
&lt;/blockquote&gt;

# Finally you must build the proximarf reader project. The sources are in ~~trunk/bundles/readers/proximarf-reader~~

&lt;blockquote&gt;
Use maven to build this project, the instruction is mvn clean install
&lt;/blockquote&gt;


Remark: the reader uses the JNA API to invoke the DLL. You have to install the JNA library ({attach:jna-3.2.5.jar} ) into your maven local repository. Use the next maven command:
mvn install:install-file -DgroupId=com.sun.jna -DartifactId=jna-Dversion=3.2.5 -Dpackaging=jar -Dfile=jna-3.2.5.jar 


1.1 Deployment


The artifacts to deploy are


* org.ow2.aspirerfid:abstract-reader (Artifact that has the base reader classes)
* com.sun.jna:jna (The JNA bundle)
* org.ow2.aspirerfid:tagsys-reader (The proximarf reader driver)

1.1 LRSpec

1.1.1 Configurable properties

* SerialPort

{code}
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ns3:LRSpec xmlns:ns2="urn:epcglobal:ale:wsdl:1" xmlns:ns3="urn:epcglobal:ale:xsd:1"&gt;
	&lt;isComposite&gt;false&lt;/isComposite&gt;
	&lt;readers /&gt;
	&lt;properties&gt;
		&lt;property&gt;
			&lt;name&gt;ReaderType&lt;/name&gt;
			&lt;value&gt;org.ow2.aspirerfid.ale.server.readers.rp.proximarf.ProximaRFAdaptor&lt;/value&gt;
		&lt;/property&gt;
		&lt;property&gt;
			&lt;name&gt;Description&lt;/name&gt;
			&lt;value&gt;This ProximaRF Logical Reader &lt;/value&gt;
		&lt;/property&gt;
		&lt;property&gt;
			&lt;name&gt;PhysicalReaderName&lt;/name&gt;
			&lt;value&gt;ProximaRF&lt;/value&gt;
		&lt;/property&gt;
		&lt;property&gt;
			&lt;name&gt;ReadTimeInterval&lt;/name&gt;
			&lt;value&gt;1500&lt;/value&gt;
		&lt;/property&gt;

		&lt;property&gt;
			&lt;name&gt;SerialPort&lt;/name&gt;
			&lt;value&gt;COM9&lt;/value&gt;
		&lt;/property&gt;
	&lt;/properties&gt;
&lt;/ns3:LRSpec&gt;
{code}


1.1 Link

1.1.1 Starter kit
</content>
<renderedcontent>&lt;h2 class="heading-1"&gt;&lt;span id="HAspire3A3AOSGiBundles3A3AProximaRFDesktopReader"&gt;Aspire :: OSGi Bundles :: ProximaRF Desktop Reader&lt;/span&gt;&lt;/h2&gt; 
&lt;hr class="line"/&gt;
            &lt;ul&gt;
          &lt;li&gt;&lt;a href="#HContext"&gt;1 Context&lt;/a&gt; 
      &lt;li&gt;&lt;a href="#HBuildingprocess"&gt;2 Building process&lt;/a&gt; 
      &lt;li&gt;&lt;a href="#HDeployment"&gt;3 Deployment&lt;/a&gt; 
      &lt;li&gt;&lt;a href="#HLRSpec"&gt;4 LRSpec&lt;/a&gt; 
        &lt;ul&gt;
          &lt;li&gt;&lt;a href="#HConfigurableproperties"&gt;4.1 Configurable properties&lt;/a&gt; 
        &lt;/ul&gt;
          &lt;li&gt;&lt;a href="#HLink"&gt;5 Link&lt;/a&gt; 
        &lt;ul&gt;
          &lt;li&gt;&lt;a href="#HStarterkit"&gt;5.1 Starter kit&lt;/a&gt; 
      &lt;/ul&gt;&lt;/ul&gt; &lt;hr class="line"/&gt;&lt;p class="paragraph"/&gt;This section describes the bundle for ProximaRF Desktop reader (ie HALAdaptor)
&lt;h3 class="heading-1-1"&gt;&lt;span id="HContext"&gt;Context&lt;/span&gt;&lt;/h3&gt; 
The &lt;span class="wikiexternallink"&gt;&lt;a href="http://www.proximarf.com/ProductsAndServices/DesktopPage.aspx"&gt;&amp;#80;roximaRF Desktop Reader&lt;/a&gt;&lt;/span&gt; is a ISO 15693 RFID reader.&lt;p class="paragraph"/&gt;The ProximaRF Desktop Reader bundle packages a HALAdaptor for ProximaRF reader attached to the host (Serial emulated USB port).
&lt;h3 class="heading-1-1"&gt;&lt;span id="HBuildingprocess"&gt;Building process&lt;/span&gt;&lt;/h3&gt; 
&lt;ol&gt;&lt;li&gt;You must build the abstract-reader project. This project contains base classes used by all HAL adaptors.&lt;/li&gt;
&lt;/ol&gt;&lt;blockquote&gt;
The sources of this project are in &lt;i class="italic"&gt;trunk/bundles/readers/abstract-reader&lt;/i&gt;. Use maven to build this project, the instruction is mvn clean install
&lt;/blockquote&gt;
&lt;ol&gt;&lt;li&gt;Finally you must build the proximarf reader project. The sources are in &lt;i class="italic"&gt;trunk/bundles/readers/proximarf-reader&lt;/i&gt;&lt;/li&gt;
&lt;/ol&gt;&lt;blockquote&gt;
Use maven to build this project, the instruction is mvn clean install
&lt;/blockquote&gt;&lt;p class="paragraph"/&gt;
Remark: the reader uses the JNA API to invoke the DLL. You have to install the JNA library (&lt;a href="/xwiki/bin/download/Main.Documentation.Bundles/ProximaRFDesktopReader/jna-3.2.5.jar" /&gt;&amp;#106;na-3.2.5.jar&lt;/a&gt; ) into your maven local repository. Use the next maven command:
mvn install:install-file -DgroupId=com.sun.jna -DartifactId=jna-Dversion=3.2.5 -Dpackaging=jar -Dfile=jna-3.2.5.jar 
&lt;h3 class="heading-1-1"&gt;&lt;span id="HDeployment"&gt;Deployment&lt;/span&gt;&lt;/h3&gt;&lt;p class="paragraph"/&gt;
The artifacts to deploy are
&lt;ul class="star"&gt;
&lt;li&gt;org.ow2.aspirerfid:abstract-reader (Artifact that has the base reader classes)&lt;/li&gt;
&lt;li&gt;com.sun.jna:jna (The JNA bundle)&lt;/li&gt;
&lt;li&gt;org.ow2.aspirerfid:tagsys-reader (The proximarf reader driver)&lt;/li&gt;
&lt;/ul&gt;&lt;h3 class="heading-1-1"&gt;&lt;span id="HLRSpec"&gt;LRSpec&lt;/span&gt;&lt;/h3&gt; 
&lt;h4 class="heading-1-1-1"&gt;&lt;span id="HConfigurableproperties"&gt;Configurable properties&lt;/span&gt;&lt;/h4&gt; 
&lt;ul class="star"&gt;
&lt;li&gt;SerialPort&lt;/li&gt;
&lt;/ul&gt;&lt;div class="code"&gt;&lt;pre&gt;&amp;#60;?xml version=&lt;span class="java&amp;#45;quote"&gt;"1.0"&lt;/span&gt; encoding=&lt;span class="java&amp;#45;quote"&gt;"UTF&amp;#45;8"&lt;/span&gt; standalone=&lt;span class="java&amp;#45;quote"&gt;"yes"&lt;/span&gt;?&amp;#62;
&amp;#60;ns3:LRSpec xmlns:ns2=&lt;span class="java&amp;#45;quote"&gt;"urn:epcglobal:ale:wsdl:1"&lt;/span&gt; xmlns:ns3=&lt;span class="java&amp;#45;quote"&gt;"urn:epcglobal:ale:xsd:1"&lt;/span&gt;&amp;#62;
	&amp;#60;isComposite&amp;#62;&lt;span class="java&amp;#45;keyword"&gt;false&lt;/span&gt;&amp;#60;/isComposite&amp;#62;
	&amp;#60;readers /&amp;#62;
	&amp;#60;properties&amp;#62;
		&amp;#60;property&amp;#62;
			&amp;#60;name&amp;#62;ReaderType&amp;#60;/name&amp;#62;
			&amp;#60;value&amp;#62;org.ow2.aspirerfid.ale.server.readers.rp.proximarf.ProximaRFAdaptor&amp;#60;/value&amp;#62;
		&amp;#60;/property&amp;#62;
		&amp;#60;property&amp;#62;
			&amp;#60;name&amp;#62;Description&amp;#60;/name&amp;#62;
			&amp;#60;value&amp;#62;This ProximaRF Logical Reader &amp;#60;/value&amp;#62;
		&amp;#60;/property&amp;#62;
		&amp;#60;property&amp;#62;
			&amp;#60;name&amp;#62;PhysicalReaderName&amp;#60;/name&amp;#62;
			&amp;#60;value&amp;#62;ProximaRF&amp;#60;/value&amp;#62;
		&amp;#60;/property&amp;#62;
		&amp;#60;property&amp;#62;
			&amp;#60;name&amp;#62;ReadTimeInterval&amp;#60;/name&amp;#62;
			&amp;#60;value&amp;#62;1500&amp;#60;/value&amp;#62;
		&amp;#60;/property&amp;#62;&lt;p class="paragraph"/&gt;		&amp;#60;property&amp;#62;
			&amp;#60;name&amp;#62;SerialPort&amp;#60;/name&amp;#62;
			&amp;#60;value&amp;#62;COM9&amp;#60;/value&amp;#62;
		&amp;#60;/property&amp;#62;
	&amp;#60;/properties&amp;#62;
&amp;#60;/ns3:LRSpec&amp;#62;&lt;/pre&gt;&lt;/div&gt;
&lt;h3 class="heading-1-1"&gt;&lt;span id="HLink"&gt;Link&lt;/span&gt;&lt;/h3&gt; 
&lt;h4 class="heading-1-1-1"&gt;&lt;span id="HStarterkit"&gt;Starter kit&lt;/span&gt;&lt;/h4&gt; 
</renderedcontent>
</xwikidoc>