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