wiki:WikiStart

Version 58 (modified by zach, 13 years ago) (diff)

--

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 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. Testbed Overview

  1. 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 Resource Descriptions that are registered with a Resource Directory and the 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 Java REP for getting started on a standard PC, an Android Java REP? for phones and more specialized 6LoWPAN and ZigBee? sensor network hardware implementations. Finally two realizations of advanced SENSEI functionality are described: for the creation of dynamic resources, and the manipulation of actuation resources.

2.1. Overview
2.2. Resource Description
2.3. Observation & Measurement
2.4. Deploying the Java REP

2.4.1. Quick Start
2.4.2. Developer Guide

2.5. Java REP for Android
2.6. REP access control
2.7. Deploying Sensor Network Islands

2.7.1. Native Gateway
2.7.2. FAIR - Resilient Data Aggregation
2.7.2. ZigBee Gateway
2.7.3. TinyOS Node
2.7.4. Secure Code Update
2.7.5. Contiki Node
2.7.6. Tiny Task Networks (TITAN)
2.7.7. Ambient REP
2.7.8. Check Management Protocol Suite

2.8. Dynamic Resource Creation
2.9. Actuation Space Resource

  1. System Provider Guide

The framework and community management components play a central role in the SENSEI system, they match Resource Users with Resource Providers, add layers of context, provide security and automate advanced tasks. The easiest way to make use of a SENSEI System Provider is to use the already deployed Pan-European Testbed, which hosts all of these components, as described in this section. It is also possible to deploy a private tested and act as a System Provider. A virtual machine image is provided for this purpose, containing all the components pre-configured and automatically run. Descriptions on configuring and using each individual component in the virtual machine are also inluded in the guide.

3.1. Quick Start
3.2. Using the SENSEI Testbed
3.3. The SENSEI Virtual Machine
3.4. Individual Components

3.4.1. Resource Directory
3.4.2. SQR
3.4.3. ED
3.4.4. AAA
3.4.5. Privacy & Billing
3.4.6. Execution Manager

  1. Resource User Guide

Once a Service Provider is hosting the SENSEI framework and community management components, and Resource Providers have registered resources with the Resource Directory, the system is ready to be used by consumers of resources. The most intuitive way to make use of the SENSEI system and access resources is through the Management GUI on the pan-european testbed server or on your own private server. When using the SENSEI system for an application, it plays the role of a Resource User. This guide includes an overview of using the basic SENSEI interfaces from a Resource User including implementation examples.

4.1. SENSEI Management GUI
4.2. Connecting a Resource User

4.2.1. Access control
4.2.2. Resource Lookup Interface
4.2.3. Resource Access Interface
4.2.4. Semantic Query Interface
4.2.5. Entity Directory Interface

TSG Review Comments

SENSEI Cookbook guinea pig comments (will be added incrementally after testing)