= [wiki:GuineaPigComments SENSEI Cookbook guinea pig comments (will be added incrementally after testing)] =


= SENSEI Cookbook =

The SENSEI Cookbook provides a set of guides for using the SENSEI Pan-European Testbed, deploying your own testbed or using the individual components available from SENSEI. The SENSEI architecture involves different roles, with three technical roles being particularly important for a testbed: Resource Provider, System Provider and Resource User. This Cookbook is organized by these three roles, with a guide for participating in a SENSEI system in each role. Before digging into the technical details, it is best to start with the [wiki:TestbedOverview overview] of the Pan-European Testbed.  

This Cookbook is aimed at several different audiences. It can be used by consortium members to disseminate information about and exploit the components developed in the project internally. It is critical documentation for third parties to participate in the Pan-European Testbed or deploy their own testbed. Finally, this Cookbook serves as documentation for potential users of this SENSEI system implementation when available to the public. The Cookbook is not meant to be a general tutorial of the SENSEI architecture or its components, nor is it meant to be a specification of the system design or implementations. 

After reading the testbed overview, it is best to start with the Resource Provider Guide. This gives a good way to get started by registering resources into the SENSEI system from a standard PC with the Java REP. The System Provider Guide is for more advanced users, and explains how to use the deployed Pan-European Testbed or how to deploy your own testbed server components. Finally, the Resource User Guide describes how to use the Management GUI of the testbed to access resources and management the system. This guide also includes information on how to create you own application acting as a Resource User.   


  1. '''Pan-European Testbed'''

     1.1. [wiki:TestbedOverview Testbed Overview] [[BR]]

  2. '''Resource Provider Guide'''

Making resources available to the SENSEI system, i.e. being a Resource Provider, is both the most imporatnt role to play in SENSEI and the easiest way to get started. This section introduces the data formats used by a Resource Provider, namely the [wiki:RpResDescription Resource Descriptions] that are registered with a Resource Directory and the [wiki:RpObservationMeasurement Observation & Measurement] format used in the payloads of the Resource Access Interface. Several different realizations of Resource End Point frameworks are included in the guide, including the [wiki:RpRepDeployment Java REP] for getting started on a standard PC, and more specialized 6LoWPAN and ZigBee sensor network hardware implementations. Finally two realizations of advanced SENSEI functionality are described: for the creation of [wiki:RpDynamicCreation dynamic resources], and the manipulation of [wiki:RpactuationSpaceResource actuation resources]. 

     2.1. [wiki:RpOverview Overview] [[BR]]
     2.2. [wiki:RpResDescription Resource Description] [[BR]]
     2.3. [wiki:RpObservationMeasurement Observation & Measurement] [[BR]]
     2.4. [wiki:RpRepDeployment Deploying the Java REP] [[BR]]
         2.4.1. [wiki:RepQuickStart Quick Start] [[BR]]
         2.4.2. [wiki:RepDeveloperGuide Developer Guide] [[BR]]
     2.5. [wiki:RepAaa REP access control] [[BR]]
     2.6. Deploying Native Islands [[BR]]
         2.6.1. [wiki:NativeGateway Native Gateway] [[BR]]
         2.6.2. [wiki:ZigbeeGateway ZigBee Gateway] [[BR]]
         2.6.3. [wiki:node-tinyos TinyOS Node] [[BR]]
         2.6.4. [wiki:node-contiki Contiki Node] [[BR]]
     2.7. [wiki:RpDynamicCreation Dynamic Resource Creation] [[BR]]
     2.8. [wiki:RpactuationSpaceResource Actuation Space Resource] [[BR]]

  3. '''System Provider Guide'''


     3.1. [wiki:SpQuickStart Quick Start] (Alex) [[BR]]
     3.2. [wiki:SpUsingTestbed Using the SENSEI Testbed] (Alex) [[BR]]
     3.3. [wiki:SpVirtualMachine The SENSEI Virtual Machine] (Alex) [[BR]]
     3.4. Individual Components [[BR]]
         3.4.1. [wiki:ResourceDirectory Resource Directory] (Stevan) [[BR]]
         3.4.2. [wiki:SQR SQR] (Fred) [[BR]]
         3.4.3. [wiki:ED ED] (Fred) [[BR]]
         3.4.4. [wiki:Aaa AAA] (Tim) [[BR]]
         3.4.5. [wiki:PrivacyAndBilling Privacy & Billing] (Osman) [[BR]]
         3.4.6. [wiki:ExecutionManager Execution Manager] (Martin) [[BR]]

  4. '''Resource User Guide'''


     4.1. [wiki:RuManagementGui SENSEI Management GUI] (Alex) [[BR]]
     4.2. [wiki:RuConnecting Connecting a Resource User] (Alex) [[BR]]
         4.2.1. [wiki:RuAaa Access control] (Tim) [[BR]]
         4.2.2. [wiki:RuRli Resource Lookup Interface] (Alex) [[BR]]
         4.2.3. [wiki:RuRai Resource Access Interface] (Alex) [[BR]]
         4.2.4. [wiki:RuSqr Semantic Query Interface] (Fred) [[BR]]
         4.2.5. [wiki:RuEdi Entity Directory Interface] (Fred) [[BR]]
 



For a complete list of local wiki pages, see TitleIndex.