1. project confidential Page 1 20-Jan-09 Integrated Project – EC FP7 215417 AspireRFID Developers First CodeCamp Athens Information Technology Nikos Kefalakis Advanced Sensors and lightweight Programmable middleware for Innovative Rfid Enterprise applications: ASPIRE

2. project confidential Page 2 20-Jan-09 Integrated Project – EC FP7 215417 Overview  Development Requirements  Downloading the Source Code at your Eclipse  Code crawling of the AspireRFID trunk  Executing a Demo  How to create a new Reader Interface at ALE Layer

3. project confidential Page 3 20-Jan-09 Development Requirements (1)  Eclipse 3.4 and above (http://www.eclipse.org/downloads/) withhttp://www.eclipse.org/downloads/ RCP/Plug-in Development Environment plug-ins, Web and Java EE Development plug-ins, Subversive plug-in (http://community.polarion.com/index.php?page=overview&project=su bversive)http://community.polarion.com/index.php?page=overview&project=su bversive  Update Site: http://download.eclipse.org/technology/subversive/0.7/update-site/http://download.eclipse.org/technology/subversive/0.7/update-site/ Subversive SVN Connectors  Update Site: http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/ http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/ Maven Integration for Eclipse plug-ins (http://m2eclipse.sonatype.org/)http://m2eclipse.sonatype.org/  Update Site: http://m2eclipse.sonatype.org/update/http://m2eclipse.sonatype.org/update/ Integrated Project – EC FP7 215417

4. project confidential Page 4 20-Jan-09 Development Requirements (2)  JDK 1.6 and above  Tomcat 5.5 (or higher)  MySQL 5.0 (or higher)  Apache Maven 2.0.8 or higher (http://maven.apache.org/)http://maven.apache.org/ Integrated Project – EC FP7 215417

5. project confidential Page 5 20-Jan-09 Downloading the Source Code at your Eclipse (1)  Install the Subversive and the Subversive SVN Connectors plug-ins  Open the SVN Repository Perspective  Go to the SVN Repositories Tab and hit the new repository location button.  For acquiring the hole trunk source code place at the URL of the New Repository Location window that appears the following URL: svn://svn.forge.objectweb.org/svnroot/aspire/ (Anonymous) or svn+ssh://USER@svn.forge.objectweb.org/svnroot/aspire (Developer SVN Access )  Open the repository go to the trunk file right click it an hit Check Out Integrated Project – EC FP7 215417

6. project confidential Page 6 20-Jan-09 Downloading the Source Code at your Eclipse (2)  For working with a specific AspireRFID project hit File>Import>General>Existing Projects into Workspace and select for the root directory the project you want to work with from the Hole trunk you have just checked out.  Select it from the list, Uncheck the Copy projects into workspace  Hit finish and you are ready to work Integrated Project – EC FP7 215417

7. project confidential Page 7 20-Jan-09 Code Crawling of the Trunk (1)  The trunk is a “BIG” Eclipse project which is comprised from Five main folders.  The “AspireRfidIDE” folder which hosts: The AspireRFID IDE core (“aspireRfidIDE”) project which is the Eclipse RCP environment for every AspireRFID IDE plug-in and is prerequisite for them to run. The “AspireRfidIdePlug-ins” folder witch contains all the AspireRFID IDE plug-in Eclipse projects which are:  The “aspireRfidIde-AleSerConfig”  The “aspireRfidIde-beg”  The “aspireRfidIde-ECSpecEditor”  The “aspireRfidIde-jmx”  The “aspireRfidIde-LRSpecEditor”  The “aspireRfidIde-MasterDataEditor”  And the “aspireRfidIde-TcpMC” Integrated Project – EC FP7 215417

8. project confidential Page 8 20-Jan-09 Code Crawling of the Trunk (2)  The “bundles” ( probably will become deprecated ) folder which contains The “common” folder with some of the required libraries bundled  The “JaxBLib” lib as an Eclipse project  The “tdt” lib as an Eclipse project And the “readers” folder which contains the Reader Core Bundles The “impl” folder which contains the Readers HAL bundle implementations with:  The “IntermecIF5” Eclipse project Bundle  And the “Simulator” with the Fosstrak simm Eclipse project Bundle The “ReaderProtocol” Eclipse project which defines the JMX Reader Core Interface And the “ReaderProtocolImpl” which is the Reader Core Eclipse Project Integrated Project – EC FP7 215417

9. project confidential Page 9 20-Jan-09 Code Crawling of the Trunk (3)  The “demos” folder which contains the demo applications created so far for the AspireRFID which are: The “aspireWarehouseAleDemo” Eclipse Project which sits on top of the F&C server And the “aspireWarehouseEpcisDemo” Eclipse project which sits on top of the Connector server.  The “servers” folder which contains the Server’s modules of the AspireRFID and more spesificaly The “aspireRfidALE” Eclipse project The “aspireRfidEpcisRepository” Eclipse Project And the “connectors” Eclipse project Integrated Project – EC FP7 215417

10. project confidential Page 10 20-Jan-09 Code Crawling of the Trunk (4)  And finally the “standaloneTools” folder which contains any tool that is useful for testing and developing with the AspireRFID which till now are the folowing: The “aspireRfidEpcisQueryAndCaptureClient” Eclipse project which includes the Query and Capture clients of the EPCIS repository and a simple UI to test it The “aspireRfidTDT” Eclipse project which contains the enhanced Fosstrak TDT And the “aspireTcpMessageCapturer” Eclipse project which contains a realy simple stand alone application that shows a defined TCP port captured messages. Integrated Project – EC FP7 215417

11. project confidential Page 11 20-Jan-09 Executing a Simle Demo  Simple F&C test with the Simulator Reader device  Lets go at : http://wiki.aspire.ow2.org/xwiki/bin/view/Main.Documentation/Demo s#HSimpleF26CtestwiththeSimulatorReaderdevice http://wiki.aspire.ow2.org/xwiki/bin/view/Main.Documentation/Demo s#HSimpleF26CtestwiththeSimulatorReaderdevice Integrated Project – EC FP7 215417

12. project confidential Page 12 20-Jan-09 How to create a new Reader Interface at ALE Layer (1)  For creating a new Reader Interface we must create a new package for our new reader adaptor.  Then we create a new Java Class with the name of our adaptor and let this Class extend the abstract Class BaseReader (“org.ow2.aspirerfid.ale.server.readers.BaseReader.java” )  And we will need to overwrite the following methods: start: start the reader (this means only to let the reader deliver tags). stop: stop the reader (this means only to stop the reader from delivering tags). connectReader: here we should place the connection setup between the reader and the reader adaptor. disconnectReader: destroy the connection between the reader and the adaptor. identify: where we set how to collect read tags (we should implement this method, even when we do have a reader that is capable for auto-polling) update: here you have to place the code for an update through the logical reader API. initialize: this method is used to setup your adaptor. Integrated Project – EC FP7 215417

13. project confidential Page 13 20-Jan-09 How to create a new Reader Interface at ALE Layer (2)  Instead of a constructor with arguments we chose the approach of an default constructor and an initializer method. To ensure that our adaptor is setup correctly we implement the constructor and the initizalizer method as following: constructor: we do not implement a constructor that needs arguments. Easiest is just to place the constructor call for the superclass ("super()") and leave the rest empty. initialize: The initializer-method takes two arguments. The first (name: String) will be the name of your reader within the logical reader API. The second (spec:LRSpec) is a valid LRSpec that contains the details how to build our reader.  More Information can be found at the following link: http://www.fosstrak.org/fc/docs/developer-adaptor.html#A http://www.fosstrak.org/fc/docs/developer-adaptor.html#A Integrated Project – EC FP7 215417