This document provides instructions for exercises using an IoT Agent to connect devices to the FIWARE platform. It outlines 10 exercises of increasing difficulty: 1. Set up a Python environment and test connectivity to FIWARE services. 2. Discover available device models and create a virtual temperature sensor. 3. Send sensor observations and read them back. 4. Create additional sensor types using different models. 5. Create a new device model. 6. Create an actuator device and send/receive commands. 7. Connect a physical device by creating a model, registering it, and sending data. 8. Additional exercises include building apps on top of context data or visualizing data.

1. IoT Exercises (IDAS Gei)
(Basic – UL2.0 IoT-Agent)
Contact twitter
@carlosralli
Contact email
Carlos.ralliucendo@telefonica.com
leandro.guillen@imdea.org

2. Outline – IDAS 3.0 Gei - UL2.0 IoT-Agent
2
Testing /
Hackathons
eidas4
• IPv4: 130.206.80.47
• IPv6: 2001:720:1514:80::47
• Devices API. Port: 8002 (IPv4)
• ADMIN API. Port: 5371 (IPv4/IPv6)
Testing Service: OpenIoT
• APIKEY: 4jggokgpepnvsb2uv4s40d59ov
• Service URL:
<IDAS_HOST>/m2m/v2/services/OpenIoT
Orion4
• IPv4: 130.206.80.47
• IPv6:
2001:720:1514:80::47
• Port: 1026 (IPv4/IPv6)

3. IoT-B1. Create your FIGWAY environment
• Prerequisite
– To have a FIWARE Lab account
– To have a working Python2.7 environment
• Steps
– Go to: https://github.com/telefonicaid/fiware-figway
– Clone/Download at your computer.
– Go to the fiware-figway/python folder.
– Check out the README.md
– Get your Oauth2.0 token with get_token.py
• Hints
– To create your FIWARE Lab user:
https://account.lab.fiware.org
Easy

4. IoT-B2. Test FIGWAY environment
• Prerequisite
– IoT-B1 completed.
• Steps
– Go to python/SensorsUL20 folder.
– Execute DiscoverModels.py
• Hints
– You’ve got all available Device Models within
the OpenIoT service.
– You can use these models to create your
physical or virtual devices later on.
Easy

5. IoT-B3. Create your first virtual sensor
• Prerequisite
– IoT-B1 & IoT-B2 completed.
• Steps
– Keep on at python/SensorsUL20 folder.
– Choose a Sensor ID for your records (Device ID)
and a Sensor ID for APP developers usage (Asset
ID).
– We will create a SENSOR_TEMP model device.
– Execute RegisterDevice.py
• Hints
– When executed with no arguments it will provide
you with the right way to do it.
– Do not forget to copy&paste the actual Device ID,
Asset ID and Entity ID assigned to your device!!
Easy

6. IoT-B4. Sending your sensor 1st observations
• Prerequisite
– IoT-B3 completed.
• Steps
– Keep on at python/SensorsUL20 folder.
– You will send the measurement ‘t|25’. You can
replace 25 with any number you like ;-)
– Execute SendObservation.py
• Hints
– When executed with no arguments it will
provide you with the right way to do it.
– Do not forget to use the actual Device ID,
assigned to your device!!
Easy

7. IoT-B5. Reading your sensor 1st observations
• Prerequisite
– IoT-B4 completed.
• Steps
– Get to python/ContextBroker folder.
– Execute GetEntity.py
• Hints
– When executed with no arguments it will
provide you with the right way to do it.
– Do not forget to use the actual Entity ID,
assigned to your device!!
Easy

8. IoT-B6. Create a new type of sensor
• Prerequisite
– IoT-B5 completed.
• Steps
– Get to python/SensorsUL20 folder.
– Execute GetModels.py
– Select any Device Model you like.
– Repeat B3, B4 and B5 with a new device.
• Hints
– Remember to take note of the assigned Device
ID, Asset ID and Entity ID.
Easy

9. IoT-B7. Create a new model of Devices
• Prerequisite
– IoT-B5 completed.
• Steps
– Get to python/SensorsUL20/models folder.
– Edit SENSOR_MOV and create a new model file
for a new device type (e.g. ultrasound
measurement meter)
– Execute CreateModel.py
– Repeat B3, B4 and B5 with the new device
model.
• Hints
– Remember to take note of the assigned Device
ID, Asset ID and Entity ID.
Medium

10. IoT-B8. Create your 1st Actuator
• Prerequisite
– IoT-B5 completed.
• Steps
– Get to python/SensorsUL20 folder.
– Repeat B3, B4 and B5 with the device model
“SWITCH”.
• Hints
– Take note of the assigned Device ID, Asset ID
and Entity ID.
Medium

11. IoT-B9. Send & Get commands to your Actuator
• Prerequisite
– IoT-B5 completed.
• Steps
– Get to python/SensorsUL20 folder.
– Execute SendCommand.py (no arguments to get
on-line help for that).
• Example: SendCommand.py 3F:2A:1A:lamp3-Madrid
RawCommand Command 'Set 95-10-23’
– Check the command status (queued now in the
platform) with DebugCommand.py
– Get the command from the actuator with
GetPoolingCommands.py
• Hints
– Take note of the assigned Device ID, Asset ID and
Entity ID.
Medium

12. IoT-B10. Connect a Physical Device to
FIWARE
• Prerequisite
– IoT-B5 completed.
– You need a physical Device and a Gateway able to run
Python2.7 (it can be the same device or a RaspberryPI …)
• Steps
– Create a model if needed for your device type (IoT-B?).
• If it is a sensor use SENSOR_MOV as a template, if it is an
actuator use SWITCH model as template. See
SENSOR_ZWAVE_4IN1 to check how multiple capabilities
(observations) can be included in the same model.
– Follow B3, B4 and B5 to use your sensor manually or B8
and B9 if it is an actuator.
– Create python scripts to handle your device observations
and call SendObservation.py to send them to the platform.
• Hints
– You can improve this exercise by creating an APP ontop of
the Orion ContextBroker or a visualization portal with
CartoDB or similar (check out the ContextBroker
exercises).
Hard

13. Thanks!Thanks!