Differences

This shows you the differences between two versions of the page.

--- crime:sunspot [2011/04/24 11:09] – wamerijc
+++ crime:sunspot [2011/06/02 12:51] (current) – wamerijc
@@ Line 1: / Line 1: @@
-====== Event Crime ======
+====== CrimeSPOT ======
 CRIME has been ported for wireless sensor networks.
 In this project we have used sunspots, small nodes equipped with sensors and wireless communication.
 Every node sends events over the network which can be received by one or more nodes within communication range. Writing applications which are driven by external events is significantly different from writing traditional sequential programs or algorithms. When applications are driven by external events, the control flow of these applications is also driven by these events which can trigger at any order and at any moment in time.
-In this project we have used CRIME in order to deal with the complexity of composing and deriving meaningful information from a continuos stream of events received from the surrounding. While CRIME has been previously used for the development of context aware applications we have seen that CRIME did not scale for the development such event driven applications. We therefore had to significantly adapt the reasoning engine in order to deal with the transient nature of events.
+In this project we have used CRIME in order to deal with the complexity of composing and deriving meaningful information from a continuous stream of events received from the surrounding. While CRIME has been previously used for the development of context aware applications we have seen that CRIME did not scale for the development such event driven applications. We therefore had to significantly adapt the reasoning engine in order to deal with the transient nature of events.
 <note>
 This project is still under development, as such the documentation can be out of sync with actual implementation.
 </note>
 ===== Repository =====
-The repository for Event CRIME is located at:
+The repository for CrimeSPOT is located at:
 https://soft.vub.ac.be/svn-gen/projects/stadium/code/CrimeLoociSunspot
@@ Line 18: / Line 19: @@
 Configure the built path by selecting the src folder to be included in the built path. Next add all the jars located in the lib folder the project.
@@ Line 31: / Line 33: @@
 === LooCI ===
 As CRIME makes use of the Looci firmware you will have to configure your sunspot runtime in order to include Looci in the sunspot vm. Instructions on how to do this can be found [[http://code.google.com/p/looci/wiki/GettingStartedSunSPOT|here]].
+<note>
+Tutorial notes:
+) Edit ~/.sunspot.properties as explained && flashlibrary all SunSPOTs
+) before "Setting up the deployment environment", use Sun SPOTManager to:
+. Start Basestation
+. Start Shared Basestation
+) Before "ant host-run", edit gateway/build.properties:
+main.class=be.kuleuven.cs.distrinet.wsn.looci.demo.Demo
+</note>
 === CrimeSPOT ===
@@ Line 44: / Line 57: @@
 . Add the CrimeSPOT jar to the SunSPOT libs by editing the spot.library.addin.jars property in ~/sunspot.properties as follows:
-  spot.library.addin.jars=${sunspot.lib}/multihop_common.jar${path.separator}${sunspot.lib}/transducer_device.jar${path.separator}${sunspot.lib}/LooCI_1.0.0.jar**${path.separator}${sunspot.lib}/CRIME.jar**
+  spot.library.addin.jars=${sunspot.lib}/multihop_common.jar${path.separator}${sunspot.lib}/transducer_device.jar${path.separator}${sunspot.lib}/LooCI_1.0.0.jar${path.separator}${sunspot.lib}/CRIME.jar
 . Rebuild & reflash the SunSPOT library in /path/to/sunspot-sdk-red:
@@ Line 58: / Line 71: @@
 A CrimeSPOT component can now be deployed over the air using LooCI's gateway. More information about the gateway can be found [[http://code.google.com/p/looci/wiki/FirstDeployment|here]].
-Executing the following commands in the gateway suffices:
+Executing the following commands in the gateway suffices for deploying CrimeSPOTComponent.jar on a SunSPOT with MAC XXXX.XXXX.XXXX.XXXX:
   # deploy /path/to/the/CrimeSPOTComponent.jar XXXX.XXXX.XXXX.XXXX
+  > ID
+  # activate ID XXXX.XXXX.XXXX.XXXX
+As can be observed, unlike for LooCI components, it's not required to manually add wirings for CrimeSPOT components. The CrimeSPOT runtime automatically adds toAll&fromAll wirings for:
+- the internal CrimeSPOT event types,
+- all event types for which an //event-fact mapping// is installed.
+For debugging purposes, the runtime on a SunSPOT can be monitored by connecting the SunSPOT via USB and executing:
+  $ ant echo
 <note>
@@ Line 67: / Line 91: @@
+====== Creating a CrimeSPOT Component ======
+===== Netbeans =====
+Individual CrimeSPOT components can be created in Netbeans.
+Steps:
+. Create a New Project: Sun SPOT Application
+. Extend the abstract CrimeComponent class and give an implementation for:
+  o execute(): invoked when the component is activated; expressions can be installed via processExpression(String) or registerRule(String,Action)
+  o all methods invoked from within the interaction rules (cfr. is-operator) && invoke(String,Object[]); the dispatcher method to access these methods
+. Compile the component:
+  $ ant jar-app
+===== Macro-CrimeSPOT =====
+==== The network-level dialect ====
+A CrimeSPOT WSN application can be created from the network-level perspective in the Macro-CrimeSPOT dialect.
+Examples can be found on https://soft.vub.ac.be/svn-gen/projects/stadium/code/CrimeLoociSunspot/Macro_CRIMESpot/Examples/.
+==== The precompiler ====
+The precompiler for compiling Macro-CrimeSPOT code to node-level component jars can be obtained via SVN:
+. Checkout the Eclipse project from https://soft.vub.ac.be/svn-gen/projects/stadium/code/CrimeLoociSunspot/Macro_CRIMESpot/ & compile.
+. Use edu.vub.crimespot.precompiler.Main to compile a source file
+. The resulting components can be found in Macro_CRIMESpot/components. Their Java code can be further refined, or the jars can be deployed immediately on SunSPOTs.