Libelium waspmote plug & sense Quick start guide

Waspmote Plug & Sense!
Technical Guide

-2- v5.8
Document version: v5.8 - 01/2016
© Libelium Comunicaciones Distribuidas S.L.
Index
INDEX
1. General and safety information ......................................................................................................... 6
2. Important: Read before use................................................................................................................ 7
3. Waspmote vs Waspmote Plug & Sense! ............................................................................................. 8
4. General view ........................................................................................................................................ 9
4.1. Specications ................................................................................................................................................................................9
4.2. Parts included.............................................................................................................................................................................12
4.3. Identication...............................................................................................................................................................................13
5. Sensor probes .................................................................................................................................... 15
5.1. Sensor probes types.................................................................................................................................................................17
5.2. Extension cord ...........................................................................................................................................................................26
6. Internal sensors ................................................................................................................................. 28
6.1. Temperature................................................................................................................................................................................28
6.2. Accelerometer............................................................................................................................................................................28
7. Radios ................................................................................................................................................. 29
7.1. 802.15.4 PRO...............................................................................................................................................................................29
7.2. ZigBee PRO.................................................................................................................................................................................. 32
7.3. DigiMesh ......................................................................................................................................................................................33
7.4. 868MHz.........................................................................................................................................................................................34
7.5. 900MHz.........................................................................................................................................................................................35
7.6. LoRaWAN .....................................................................................................................................................................................36
7.7. Sigfox.............................................................................................................................................................................................37
7.8. LoRa ...............................................................................................................................................................................................38
7.9. WiFi.................................................................................................................................................................................................40
7.9.1. WiFi Topologies ...........................................................................................................................................................40
7.9.1.1. Access Point .................................................................................................................................................40
7.10. GPRS ............................................................................................................................................................................................43
7.11. GPRS+GPS .................................................................................................................................................................................44
7.12. 3G/GPRS.....................................................................................................................................................................................45
7.13. Bluetooth Low Energy ..........................................................................................................................................................46
8. Internal storage ................................................................................................................................. 47
9. GPS...................................................................................................................................................... 48

-3- v5.8
Index
10. ON / OFF Button............................................................................................................................... 51
10.1. External led ............................................................................................................................................................................... 52
11. Resetting Waspmote plug & sense! with an external magnet ..................................................... 53
12. USB ................................................................................................................................................... 55
12.1. External SIM socket................................................................................................................................................................57
13. Internal solar panel ......................................................................................................................... 59
14. External solar panel ........................................................................................................................ 60
15. Vent plug / Pressure Compensator................................................................................................. 62
16. Antenna............................................................................................................................................ 63
17. Sensor protection............................................................................................................................ 65
17.1. Special probes .........................................................................................................................................................................65
17.2. Solar shield................................................................................................................................................................................65
18. Batteries ........................................................................................................................................... 71
19. Models.............................................................................................................................................. 72
19.1. Smart Environment................................................................................................................................................................73
19.2. Smart Environment PRO ......................................................................................................................................................75
19.3. Smart Security .........................................................................................................................................................................77
19.4. Smart Water..............................................................................................................................................................................79
19.5. Smart Water Ions.....................................................................................................................................................................81
19.5.1. Single............................................................................................................................................................................82
19.5.2. Double .........................................................................................................................................................................83
19.6. Smart Cities...............................................................................................................................................................................84
19.7. Smart Parking ..........................................................................................................................................................................86
19.8. Smart Agriculture ...................................................................................................................................................................87
19.8.1. Normal.........................................................................................................................................................................88
19.8.2. PRO ...............................................................................................................................................................................88
19.9. Ambient Control ..................................................................................................................................................................... 89
19.10. Radiation Control.................................................................................................................................................................91
20. First steps ......................................................................................................................................... 92
21. Programming .................................................................................................................................. 93
21.1. Code generator ....................................................................................................................................................................... 93
21.2. Real time Clock - RTC.............................................................................................................................................................97
21.3. Interruptions ............................................................................................................................................................................98

-4- v5.8
Index
22. Uploading code ............................................................................................................................... 99
23. Over the air programming – OTA ................................................................................................. 105
23.1. Overview..................................................................................................................................................................................105
23.2. Benets.....................................................................................................................................................................................105
23.3. Concepts..................................................................................................................................................................................105
23.4. OTA with 802.15.4/ZigBee modules ..............................................................................................................................108
23.4.1. OTA Step by Step...................................................................................................................................................108
23.4.2. OTA Shell..................................................................................................................................................................111
23.5. OTA with 3G/GPRS/WiFi modules via FTP....................................................................................................................111
23.5.1. Procedure ................................................................................................................................................................111
23.5.2. Setting the FTP server conguration............................................................................................................. 112
24. Encryption Libraries...................................................................................................................... 113
24.1. Transmission of sensor data..............................................................................................................................................113
25. Interacting with Waspmote Plug & Sense! .................................................................................. 115
25.1. Receiving XBee frames with Waspmote Gateway ....................................................................................................115
25.1.1. Waspmote Gateway.............................................................................................................................................115
25.1.2. Linux receiver......................................................................................................................................................... 116
25.1.3. Windows receiver..................................................................................................................................................117
25.1.4. Mac-OS receiver ....................................................................................................................................................119
25.2. Meshlium.................................................................................................................................................................................120
25.2.1. What can I do with Meshlium?.........................................................................................................................120
25.2.2. How do they work together?............................................................................................................................121
25.2.2.1. Meshlium Storage Options ...............................................................................................................121
25.2.2.2. Meshlium Connection Options ....................................................................................................... 121
25.2.3. Capturing and storing sensor data in Meshlium from a Waspmote sensor network ..................122
25.2.4. Capturer logs..........................................................................................................................................................137
25.2.5. Sensors .....................................................................................................................................................................138
25.2.6. Sending frames from Meshlium to Waspmote .......................................................................................... 139
25.2.7. Interacting with 3rd party Cloud platforms................................................................................................140
26. Installation..................................................................................................................................... 141
26.1. Parts...........................................................................................................................................................................................141
26.2. Street Light installation......................................................................................................................................................144
26.2.1. External solar panel..............................................................................................................................................144
26.2.2. Internal solar panel ..............................................................................................................................................147
26.3. Wall ............................................................................................................................................................................................149
26.3.1. External solar panel..............................................................................................................................................149
26.3.2. Internal solar panel ..............................................................................................................................................150

-5- v5.8
27. Energy Consumption..................................................................................................................... 151
27.1. Consumption tables............................................................................................................................................................151
27.2. Energy system........................................................................................................................................................................151
27.2.1. Concepts..................................................................................................................................................................151
27.2.2. Sleep mode.............................................................................................................................................................152
27.2.3. Deep sleep mode..................................................................................................................................................152
27.3. Lifetime of the sensors........................................................................................................................................................153
28. Recommendations ........................................................................................................................ 154
29. Documentation Changelog .......................................................................................................... 155
30. Certications.................................................................................................................................. 157
30.1. CE................................................................................................................................................................................................157
30.2. FCC.............................................................................................................................................................................................158
30.3. IC ................................................................................................................................................................................................159
30.4. Use of equipment characteristics...................................................................................................................................159
30.5. Limitations of use .................................................................................................................................................................159
31. Maintenance .................................................................................................................................. 161
32. Disposal and recycling .................................................................................................................. 162
33. Resources ....................................................................................................................................... 163
Index

-6- v5.8
General and safety information
1. General and safety information
• Read carefully Limited Warranty and Terms and Conditions of Use before using“Waspmote Plug & Sense!”.
• Do not open casing and do not damage black warranty stickers. If you do so, you will lose warranty.
• Do not remove any of the connectors.
• Do not allow contact between metallic objects and electronic parts to avoid injury and burns.
• Never immerse equipment in any liquid.
• Keep equipment within temperature range indicated in recommendation section.
• Do not connect or power equipment using cables that have been damaged.
• Place equipment in an area to which only maintenance personnel can have access (in a restricted access zone)
• In any case keep children away from the equipment.
• If there is a power failure, immediately disconnect from the mains.
• If using a battery whether or not in combination with a solar panel as a power source follow the voltage and current
specications indicated in the section “External solar panel connector”.
• If a software failure occurs, contact Libelium technical support before doing any action by yourself.
• Do not place equipment on trees or plants as they could be damaged by its weight.
• Be particularly careful if you are connected through a software interface for handling the machine; if settings of that
interface are incorrectly altered, it could become inaccessible.
• If you need to clean the node, wipe it with a dry towel.
• If Waspmote Plug & Sense! needs to be returned please send it completely dry and free from contaminants.
• Waspmote Plug & Sense! is not designed to be placed in hard environmental conditions, under dangerous chemical
elements, explosive atmospheres with ammable gases, high voltage installations or special installations. Please contact
Libelium technical support to ensure your application is compatible with Waspmote Plug & Sense!

-7- v5.8
Important: Read before use
2. Important: Read before use
The following list shows just some of the actions that produce the most common failures and warranty-voiding. Complete
documentation about usage can be found at http://www.libelium.com/development. Failure to comply with the
recommendations of use will entail the warranty cancellation.
Software:
• Upload code only using Waspmote IDE. If a dierent IDE is used, Waspmote can be damaged and can become unresponsive.
This use is not covered under warranty.
• Do not unplug any connector while uploading code. Waspmote can become unresponsive. This use is not covered under
warranty.
• Do not connect or disconnect any connector while Waspmote is ON. Waspmote can become unstable or unresponsive, and
internal parts can be damaged. This fact is not covered under warranty.
Hardware:
• Do not handle black stickers seals on both sides of the enclosure ( Warranty stickers). Their integrity is the proof that
Waspmote Plug & Sense! has not been opened. If they have been handled, damaged or broken, the warranty is void.
• Do not open Waspmote Plug & Sense! in any case. This will automatically make the warranty void.
• Do not handle the four metallic screws of Waspmote Plug & Sense!. They ensures waterproof seal.
• Do not submerge Waspmote Plug & Sense! in liquids.
• Do not place nodes on places or equipment where it could be exposed to shocks and/or big vibrations.
• Do not expose Waspmote Plug & Sense! to temperatures below -10ºC or above 50ºC.
• Do not power Waspmote with other power sources than the original provided by Libelium. Voltage and current maximum
ratings can be exceeded, stopping Waspmote working and voiding warranty.
• Do not try to extract, screw, break or move Waspmote Plug & Sense! connectors far from necessary usage, waterproof
sealing can be damaged and warranty will be voided.
• For more information: http://www.libelium.com
• Do not connect any sensor on the solar panel connector and also do not connect the solar panel to any of sensor connectors.
Waspmote can be damaged and warranty void.
• Do not connect any sensor not provided by Libelium.
• Do not place Waspmote Plug & Sense! where water can reach internal parts of sensors.
• Do not get the magnet close to a metal object. The magnet is really powerful and will get stuck.
• Do not place the magnet close to electronic devices, like PCs, batteries, etc, they could be damaged, or information could
be deleted.

-8- v5.8
Waspmote vs Waspmote Plug & Sense!
3. Waspmote vs Waspmote Plug & Sense!
Waspmote is the original line in which developers have a total control over the hardware device.You can physically access to the
board and connect new sensors or even embed it in your own products as an electronic sensor device.
The new Waspmote Plug & Sense! line allows developers to forget about electronics and focus on services and applications. Now
you can deploy wireless sensor networks in an easy and scalable way ensuring minimum maintenance costs. The new platform
consists of a robust waterproof enclosure with specic external sockets to connect the sensors, the solar panel, the antenna and
even the USB cable in order to reprogram the node. It has been specially designed to be scalable, easy to deploy and maintain.
Figure : Waspmote Figure : Waspmote Plug & Sense!

-9- v5.8
General view
4. General view
This section shows main parts of Waspmote Plug & Sense! and a brief description of each one. In later sections all parts will be
described deeply.
4.1. Specications
•Material: polycarbonate
•Sealing: polyurethane
•Cover screws: stainless steel
•Ingress protection: IP65
•Impact resistance: IK08
•Rated insulation voltage AC: 690 V
•Rated insulation voltage DC: 1000 V
•Heavy metals-free: Yes
•Weatherproof: true - nach UL 746 C
•Ambient temperature (min.): -10 °C
•Ambient temperature (max.): 50 °C
•Approximated weight: 800 g
In the pictures included below it is shown a general view of Waspmote Plug & Sense! main parts. Some elements are dedicated
to node control, others are designated to sensor connection and other parts are just identication elements. All of them will be
described along this guide.
164 mm
124 mm
175 mm
410 mm
160 mm
122 mm
85 mm
Figure : Main view of Waspmote Plug & Sense!

-10- v5.8
General view
Figure : Control side of the enclosure
Figure : Control side of the enclosure for GPRS or 3G models
Figure : Sensor side of the enclosure

-11- v5.8
General view
Figure : Antenna side of the enclosure
Figure : Front view of the enclosure
Figure : Back view of the enclosure

-12- v5.8
General view
Figure : Warranty stickers of the enclosure
Important note: Do not handle black stickers seals of the enclosure (Warranty stickers). Their integrity is the proof that Waspmote
Plug & Sense! has not been opened. If they have been handled, damaged or broken, the warranty is automatically void.
4.2. Parts included
Next picture shows Waspmote Plug & Sense! and all of its elements. Some of them are optional accessories that may not be
included.
1
2
3
4
5
7
6
8
9
10
Figure : Waspmote Plug & Sense! accessories: 1 enclosure, 2 sensor probes, 3 external solar panel, 4 USB cable, 5 antenna, 6 cable ties, 7 mounting feet
(screwed to the enclosure), 8 extension cord, 9 solar panel cable, 10 wall plugs & screws

-13- v5.8
General view
4.3. Identication
Each Waspmote model is identied by stickers. Next gure shows front sticker.
Model identication colour
Enclosure model
Figure : Front sticker of the enclosure
There are many congurations of Waspmote Plug & Sense! line, all of them identied by one unique sticker. Next image shows
all possibilities.
Figure : Dierent front stickers

-14- v5.8
General view
Moreover, Waspmote Plug & Sense! includes a back sticker where it is shown identication numbers, radio MAC addresses, etc.
It is highly recommended to annotate this information and save it for future maintenance. Next gure shows it in detail.
Enclosure serial number
Radio 1 MAC adress
Battery type
Extra information
Certications
Figure : Back sticker
Sensor probes are identied too by a sticker showing the measured parameter and the sensor manufacturer reference.
CO - TGS2442
Measure parameter Sensor reference
Figure : Sensor probe identication sticker

-15- v5.8
Sensor probes
5. Sensor probes
All sensing capabilities of Waspmote Plug & Sense! are provided by sensor probes. Each sensor probe contains one sensor, some
necessary protections against outdoor environmental conditions and a waterproof male connector.
The standard length of a sensor probe is about 150mm, including waterproof connector, but it could vary due to some sensors
need special dimensions. Weight of a standard probe rounds 20g (gases probes, temperature and humidity (Sensirion), etc), but
there are some special cases which can rise this weight.
Moreover, some probes allows its usage in combination with a solar shield (an extra protection against sun direct exposition)
which can improve sensor behavior, measurement accuracy and lifetime of sensors. Please see corresponding section to see
how to use solar shields provided by Libelium.
Sensor probes are designed to be used in vertical position (with sensor looking to the ground). In this position, the protection
cap of each sensor probe is eective against bad weather conditions.
Each model has six dedicated sockets to connect sensor probes. They are located in the sensor side, as shown below. Each socket
has a protecting cap. When one of the six sensor connector is not used, be sure the cap is screwed to protect the connector.
Figure : Enclosure sensor side with protection caps
Each sensor socket is identied by a letter from A to F (see picture below). The user should understand that each sensor probe
should go in a dedicated socket, due to each sensor has dierent power requirements (current and voltage levels), dedicated
circuitry, etc. So please see corresponding section about where to connect each probe.
Always be sure you connected probes in right socket, otherwise they can be damaged.
Never connect a sensor not provided by Libelium to any of the sensor connectors. Electronic inside can be damaged and
warranty will be automatically void.

-16- v5.8
Sensor probes
Figure : Enclosure sensor side without protection caps
It should be taken into account that sensor probe connector has only one matching position. The user should align sensor probe
connector looking at the little notch of the connector (see image below). Notice that the sensor connector is male type and the
enclosure sensor connector is female type.
Figure : Detail of sensor waterproof connector
Besides that, there is a locking nut which should be screwed till the connector is completely xed to the enclosure.
Figure : Connecting a sensor probe to the enclosure
Please use sensors ocially provided by Libelium. Any other sensor can damage Waspmote Plug & Sense! and void the warranty.

-17- v5.8
Sensor probes
5.1. Sensor probes types
Libelium provides many dierent sensor probes depending on what is going to be measured. This section describes main
features of each type. If further information is required, please refer for the corresponding sensor board guide available on
Libelium website.
Standard Type
This sensor probe is the most common. Sensor is placed inside a plastic cylinder acting as a protection against rain and water,
but allowing sensor interact with environment to measure necessary parameters.
Figure : Standard sensor probe
Sensor probes of this type are:
• Temperature
• Carbon monoxide - CO
• Methane - CH4
• LPG
• Air pollutants 1: C6H5CH3, H2S, CH3CH2OH, NH3, H2
• Air pollutants 2: C4H10, CH3CH2OH, H2, CO, CH4
• Alcohol derivates: CH3CH2OH, H2, C4H10, CO, CH4
• Humidity
• Atmospheric pressure
• Carbon dioxide - CO2
• Nitrogen dioxide - NO2
• Ozone - O3
• Hydrocarbons - VOC
• Oxygen - O2
• Carbon monoxide – CO
• Noise sensor (dBA) - Microphone

-18- v5.8
Sensor probes
Humidity and temperature (Sensirion) probe
This probe is designed to avoid sunlight eects and prevent from water and rain, but allowing humidity measurement.
Only the temperature + humidity (Sensirion) sensor includes this special protection.
Figure : Humidity and temperature (Sensirion) probe
Luminosity - LDR probe
This probe is designed to allow sunlight go thought a transparent protection.
Figure : Luminosity probe
Liquid Presence probe (point)
This probe is designed to allow placing the sensor near its application.
Figure : Liquid Presence probe (point)

-19- v5.8
Sensor probes
Liquid level probe
This probe is designed to measure liquid levels.
Figure : Liquid level probe
Liquid ow probe
This probe is designed to measure liquid ow through a pipe.
Figure : Liquid ow probe
Hall eect probe
This probe is designed to control the opening of doors, windows, etc.
Figure : Hall eect probe

-20- v5.8
Sensor probes
Solar radiation probe
This probe is designed to measure solar radiation.
Figure : Solar radiation probe
Soil temperature probe
This probe is designed to be buried into the ground to measure its temperature.
Figure : Soil temperature probe
Soil moisture probe
This probe is designed to be buried into the ground to measure its moisture.
Figure : Soil moisture probe