The document discusses experimentation on the WISEBED wireless sensor network testbed platform. It provides an overview of the goals and agenda for a tutorial on using the WISEBED testbed to run and script experiments. The tutorial covers the WISEBED application programming interfaces, client applications, and how to reserve nodes, monitor experiments, and interact with nodes on the testbed.
1. WISEBED - Wireless Sensor Network Testbeds
Experimentation on the
WISEBED WSN Testbed Platform
Daniel Bimschas
Institute of Telematics, University of Lübeck
bimschas@itm.uni-luebeck.de
http://www.itm.uni-luebeck.de
2. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Goals of Today’s Tutorial
n After this tutorial you should:
§ Be able to run and script experiments on the WISEBED testbed
platform,
§ Have basic knowledge about APIs and client applications, and
§ Find all necessary documentation
n During the talk:
§ Please install and boot the WISEBED Virtual Machine (from DVD!) or
§ Install the Experimentation Scripts (Linux / Mac OS X)
2
4. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
New Website
n New website launched last Friday: http://wisebed.eu/
n More user-centric
§ Clients / Libraries / Documentation
§ Development Tools
§ Community (join the mailing lists!)
§ …
n Sign up for a WISEBED testbed account online:
http://wisebed.eu/site/index.php/register/
n Send us your Feedback
§ Did you like the site? Why?
§ Did you find everything you were looking for? What was missing?
§ Got ideas for improvement? Tell us!
4
5. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Outline
1. Overview
§ Available Sensor Nodes
§ Testbed Architecture
§ Terms
2. Client Applications
§ Web-based
§ Desktop-based
3. Web Service APIs
4. Live Presentation
5. Experimentation Hands-On
6. Advanced Topics (Outlook)
§ Cross-Platform Application Development with the Wiselib
§ Run your own Testbed
§ Virtual Testbeds
5
6. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Available Sensor Nodes
n Snapshot from 20. September 2011
n Distributed across 9 testbeds
§ For an up-to-date snapshot see:
http://wisebed.itm.uni-luebeck.de/wiseui-beta/
§ Next week: extension by 144 nodes planned (iSense, TelosB, Pacemate)
6
8. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
WISEBED Virtual Unifying Laboratory 8
WISEBED
Federation
ULANC
TUD
TUBS
FUB
UZL
UNIGE
UBERN
UPC
CTI
Web Services on the
Portal Server
Portal Servers at
each WISEBED Site
Each Partner
maintains its own
testbed with
different hardware
equipment and
setup
Users connect to
a single testbed
directly using a
Web service API
Users connect to the federated testbed
using the same Web service API
Add simulated
nodes to the mix
9. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Terms
n Portal Server
§ Exposes a testbed via Web services
n Gateway
§ Sensor nodes are attached to the gateways
§ Typically
- the same machine as the Portal Server, or
- some other machine with IP-connectivity to the Portal Server
- Clock-synchronized using the Network Time Protocol (NTP)
n Federator
§ Connects two or more Portal Servers
§ Exposes them as one testbed (using the same API)
§ Used for testbed virtualization (more on that later!)
9
10. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Terms
n Sensor Node URN
§ Addressing of nodes using a Uniform Resource Identifier (URN)
§ Example: “urn:wisebed:uzl1:0x1234“
§ URN suffix corresponds with the MAC address of the node (0x1234)
n URN prefix
§ Identifier for a testbed
§ Example: “urn:wisebed:testbeduzl:”
§ Each Portal Server is responsible for one or more URN prefixes
§ All nodes inside this testbed have the same common prefix
n WiseML
§ XML dialect to describe testbed configurations, topologies and
experiment traces
10
11. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
A Typical Testbed Architecture 11
FederatorExperimenter 1
Experimenter 2
Gateways
Portal Server
Gateways
Portal Server
Serial (USB) connections
LAN
12. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The Lübeck Testbed
n 164 sensor nodes in total
§ 54 iSense
§ 54 Telos B
§ 54 Pacemates
12
13. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The Lübeck Testbed
n Distributed over all rooms of the Institute
Screenshot: SpyGlass - a modular and extensible visualization framework for WSNs
13
18. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Web Clients - WiseUI
n Expected to become the standard user interface
n Currently under heavy development
n Beta version available
§ Only limited (basic) functionality
§ No scheduling, scripting
§ http://wisebed.itm.uni-luebeck.de/wiseui-beta/
n Useful for reservation and testbeds overview
18
20. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Desktop Clients - SpyGlass 20
n A modular and extensible visualization framework for WSNs
n http://wisebed.eu/site/index.php/conduct-experiments/desktop-clients/spyglass/
21. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Desktop Clients – Experimentation Scripts 21
n A set of command line scripts to execute, control and interact
with your experiment
n http://wisebed.eu/site/index.php/conduct-experiments/desktop-clients/experimentation-scripts/
n Allows you to
§ “Program” your experiments
§ E.g. explore parameter space
§ Automatically repeat experiments
§ Programmatically analyze, convert and process output of nodes
n How does it work?
§ Scripts written in the Java programming language (BeanShell interpreter)
§ Executed from the command line
§ Like all clients they use the WISEBED Web Service APIs
22. WISEBED - Wireless Sensor Network Testbeds
WISEBED
Web Service APIs
Basics
23. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The WISEBED Testbed APIs
n SNAA: Sensor Network Authentication and Authorization API
n Facade in front of the single sign-on system Shibboleth
n Supports other authentication/authorization frameworks, too
n http://wisebed.eu/api/java/current/reference/eu/wisebed/api/snaa/SNAA.html
n http://wisebed.eu/api/wsdl/snaa/current/
23
RS
SNAA
Session
Management
WSN
WSN
WSN
WSN
Controller
iWSN
24. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The WISEBED Testbed APIs
n RS: Reservation System API
n Provides basic operations for reservations
n Different implementations in use (Google Calendar, JPA, ...)
§ http://wisebed.eu/api/java/current/reference/eu/wisebed/api/rs/RS.html
§ http://wisebed.eu/api/wsdl/rs/current/
24
RS
SNAA
Session
Management
WSN
WSN
WSN
WSN
Controller
iWSN
25. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The WISEBED Testbed APIs
n Controller API
n Runs on client side
n „Controls“ the experiment
n Receives output and backend notifications
§ http://wisebed.eu/api/java/current/reference/eu/wisebed/api/controller/Controller.html
§ http://wisebed.eu/api/wsdl/iwsn/current/
25
RS
SNAA
Session
Management
WSN
WSN
WSN
WSN
Controller
iWSN
26. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The WISEBED Testbed APIs
n Session Management API
n Provides method to static testbed (configuration) information
n Provides access to the reserved nodes (via getInstance())
§ http://wisebed.eu/api/java/current/reference/eu/wisebed/api/sm/SessionManagement.html
§ http://wisebed.eu/api/wsdl/iwsn/current/
26
RS
SNAA
Session
Management
WSN
WSN
WSN
WSN
Controller
iWSN
27. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The WISEBED Testbed APIs
n WSN: Wireless Sensor Network API (selection of methods!)
n Provides methods to
§ Interact with sensor nodes (flash, reset, send messages, …)
§ Configure the backend system (more on that later!)
§ http://wisebed.eu/api/java/current/reference/eu/wisebed/api/wsn/WSN.html
§ http://wisebed.eu/api/wsdl/iwsn/current/
27
RS
SNAA
Session
Management
WSN
WSN
WSN
WSN
Controller
iWSN
33. WISEBED - Wireless Sensor Network Testbeds
WISEBED
Web Service APIs
Advanced Stuff
34. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The Channel Pipeline
n Problem:
§ Every sensor node operating system uses a different message framing
n Examples:
§ TinyOS: Raw or HdlcTranslateC (HDLC-based framing)
§ iSense: Raw or DLE STX ... DLE ETX (HDLC-like framing)
§ Your experimental OS: ?
n Testbed backend can only forward raw bytes to clients
34
35. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The Channel Pipeline
n Configurable preprocessing of node output in the backend
35
Sensor Node
Client
DownstreamUpstream
Upstream Handler N
Upstream Handler N-1
Upstream Handler 1
…
Downstream Handler 1
…
Downstream Handler N
Downstream Handler N-1
Channel Pipeline
36. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
The Channel Pipeline 36
n Example configurations:
Sensor Node
Client
DownstreamUpstream
Raw Bytes = Empty Channel Pipeline
Sensor Node
Client
DownstreamUpstream
DleStxEtxFramingDecoder DleStxEtxFramingEncoder
Messages = Framing / Deframing Handlers
DLE STX hell o world DLE ETX
hello world
DLE STX hell o world DLE ETX
hello world
45. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Run your own Testbed
n All WISEBED implementations (back-/frontend) are Open Source!
n http://wisebed.eu/site/index.php/run-your-own-testbed
n Reference implementation: Testbed Runtime
n Run it at your desk
n Run it with your local (private) testbed
n Run it in a federation
n Separate implementations of APIs (for flexibility)
n Authentication & Authorization (SNAA)
n Htpasswd, Shibolleth, LDAP, …
n Reservation (RS)
n Google Calendar, Java Persistence API, …
n Experimentation (iWSN)
45
47. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Virtual Links
n Virtual radio is used by the application instead of the physical one
§ For every packet that passes through it decides depending on the
destination ID
§ To drop it/alter it
§ To forward it via one or all interfaces
47
Application uses
special „virtual
radio“ interface
(implemented, e.g.,
in the Wiselib )
48. WISEBED – Wireless Sensor Network Testbeds – http://wisebed.eu
Virtual Links
n Virtual links
between
§ Same testbed
§ Remote
testbeds
§ Real and
simulated
testbeds
n Virtual radio
forwards
packets to the
testbeds server
n Testbed server
routes
messages to
the destination
48