Libelium Waspmote Plug & Sense! Series Quick start guide

Waspmote Plug & Sense!
Technical Guide

-2- v8.6
Document version: v8.6 - 05/2019
© Libelium Comunicaciones Distribuidas S.L.
Index
INDEX
1. General and safety information..........................................................................................6
2. Important: Read before use.................................................................................................7
3. Introduction .......................................................................................................................... 8
4. Waspmote vs Waspmote Plug & Sense!..............................................................................9
5. General view........................................................................................................................10
5.1. Specications................................................................................................................................... 10
5.2. Parts included.................................................................................................................................. 13
5.3. Identication.................................................................................................................................... 14
6. Sensor probes...................................................................................................................... 16
6.1. Sensor probes types....................................................................................................................... 18
6.2. Extension cord................................................................................................................................. 27
7. Internal sensors ..................................................................................................................29
7.1. Accelerometer ................................................................................................................................. 29
8. Radio modules.....................................................................................................................30
8.1. XBee-PRO 802.15.4 ......................................................................................................................... 31
8.2. XBee ZigBee 3.................................................................................................................................. 33
8.3. XBee 868LP ...................................................................................................................................... 35
8.4. XBee-PRO 900HP............................................................................................................................. 36
8.5. LoRaWAN modules ......................................................................................................................... 37
8.6. Sigfox modules................................................................................................................................ 39
8.7. WiFi PRO module ............................................................................................................................ 41
8.8. 4G module ....................................................................................................................................... 42
9. Industrial Protocols ............................................................................................................44
10. GPS module........................................................................................................................46
11. Internal storage ................................................................................................................47
12. On/o button .................................................................................................................... 48
12.1. External LED .................................................................................................................................. 49

-3- v8.6
Index
13. Resetting Waspmote Plug & Sense! with an external magnet ....................................50
14. USB port ............................................................................................................................. 52
14.1. Outdoors USB Cable..................................................................................................................... 54
14.2. External SIM/USB socket.............................................................................................................. 55
15. External solar panel..........................................................................................................58
16. External Battery Module..................................................................................................60
16.1. Technical specications................................................................................................................ 60
16.2. Operating modes.......................................................................................................................... 63
17. Vent plug / Pressure Compensator................................................................................. 65
18. Antenna.............................................................................................................................. 66
18.1. Antennas for the Plug & Sense! 4G model................................................................................. 67
18.2. Antennas for Plug & Sense! GPS-ready models ........................................................................ 68
19. Sensor protection .............................................................................................................70
19.1. Special probes............................................................................................................................... 70
20. Battery ...............................................................................................................................70
21. Models ................................................................................................................................71
21.1. Smart Environment PRO.............................................................................................................. 72
21.2. Smart Security ............................................................................................................................... 74
21.3. Smart Water................................................................................................................................... 76
21.4. Smart Water Xtreme..................................................................................................................... 78
21.5. Smart Water Ions .......................................................................................................................... 80
21.6. Smart Parking................................................................................................................................ 83
21.7. Smart Agriculture PRO ................................................................................................................. 84
21.8. Smart Agriculture Xtreme ............................................................................................................ 86
21.9. Ambient Control............................................................................................................................ 89
21.10. Smart Cities PRO......................................................................................................................... 91
21.11. Radiation Control........................................................................................................................ 93
21.12. 4-20 mA Current Loop................................................................................................................ 94
22. Programming....................................................................................................................95
22.1. Real time Clock - RTC.................................................................................................................... 95
22.2. Interruptions ................................................................................................................................. 96
22.3. Watchdog....................................................................................................................................... 96
22.3.1. RTC Watchdog for reseting Waspmote ..........................................................................96
23. Programming Cloud Service ............................................................................................97

-4- v8.6
24. Uploading code..................................................................................................................98
25. Over the air programming – OTA ..................................................................................104
25.1. Overview ...................................................................................................................................... 104
25.2. OTA with 4G/WiFi modules via FTP.......................................................................................... 104
25.2.1. Setting the FTP server conguration ........................................................................... 105
26. Encryption libraries ........................................................................................................106
27. Interacting with Waspmote...........................................................................................107
27.1. Receiving XBee frames with Waspmote Gateway................................................................... 107
27.1.1. Waspmote Gateway....................................................................................................... 107
27.1.2. Linux receiver ................................................................................................................. 108
27.1.3. Windows receiver........................................................................................................... 112
27.1.4. Mac-OS receiver ............................................................................................................. 114
29. Installation ......................................................................................................................120
29.1. Parts.............................................................................................................................................. 120
29.2. Street Light installation .............................................................................................................. 123
29.2.1. External solar panel ....................................................................................................... 123
29.3. Wall installation........................................................................................................................... 126
29.3.1. External solar panel ....................................................................................................... 126
30. Energy Consumption ......................................................................................................128
30.1. Consumption tables ................................................................................................................... 128
30.2. Energy system ............................................................................................................................. 128
30.2.1. Concepts.......................................................................................................................... 128
30.2.2. Sleep mode ..................................................................................................................... 130
30.2.3. Deep Sleep mode........................................................................................................... 131
30.3. Lifetime of the sensors............................................................................................................... 131
31. Recommendations.......................................................................................................... 132
32. Documentation changelog ............................................................................................ 133
33. Certications...................................................................................................................135
33.1. General overview ........................................................................................................................ 135
33.2. CE (Europe) .................................................................................................................................. 135
33.2.1. Waspmote Plug & Sense! 802.15.4 EU......................................................................... 136
33.2.2. Waspmote Plug & Sense! 868....................................................................................... 136
33.2.3. Waspmote Plug & Sense! WiFi ...................................................................................... 136
33.2.4. Waspmote Plug & Sense! 4G EU/BR............................................................................. 137
33.2.5. Waspmote Plug & Sense! Sigfox EU............................................................................. 137
33.2.6. Waspmote Plug & Sense! LoRaWAN EU ...................................................................... 137
33.3. FCC (USA) ..................................................................................................................................... 138
Index

-5- v8.6
33.4. IC (Canada)................................................................................................................................... 139
33.5. ANATEL (Brazil)............................................................................................................................ 139
33.6. RCM (Australia)............................................................................................................................ 140
33.7. Use of equipment characteristics ............................................................................................ 141
34. Maintenance....................................................................................................................142
35. Disposal and recycling....................................................................................................143
36. Resources.........................................................................................................................144

-6- v8.6
General and safety information
1. General and safety information
Important:
•All documents and any examples they contain are provided as-is and are subject to change without notice.
Except to the extent prohibited by law, Libelium makes no express or implied representation or warranty of
any kind with regard to the documents, and specically disclaims the implied warranties and conditions of
merchantability and tness for a particular purpose.
•The information on Libelium’s websites has been included in good faith for general informational purposes
only. It should not be relied upon for any specic purpose and no representation or warranty is given as to its
accuracy or completeness.
•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- v8.6
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 ensure 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 -20 ºC or above 60 º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- v8.6
Introduction
3. Introduction
This guide explains the features related to our product line Plug & Sense! v15, released on October 2016.
If you are using previous versions of our products, please use the corresponding guides, available on our
Development website.
You can get more information about the generation change on the document “New generation of Libelium product
lines”.

-9- v8.6
Waspmote vs Waspmote Plug & Sense!
4. 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 Waspmote Plug & Sense! line allows developers to forget about electronics and focus on services and
applications. You can deploy wireless sensor networks in an easy and scalable way ensuring minimum maintenance
costs. The 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!

-10- v8.6
General view
5. 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.
5.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.): -30 °C*
•Ambient temperature (max.): 70 °C*
•Approximated weight: 800 g
*Temporary extreme temperatures are supported. Regular recommended usage: -20, +60 ºC.
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!

-11- v8.6
General view
Figure: Control side of the enclosure
Figure: Control side of the enclosure for 4G model
Figure: Sensor side of the enclosure

-12- v8.6
General view
Figure: Antenna side of the enclosure
Figure: Front view of the enclosure
Figure: Back view of the enclosure

-13- v8.6
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.
5.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

-14- v8.6
General view
5.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

-15- v8.6
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.
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
Figure: Sensor
Figure: reference
Figure: Sensor probe identication sticker

-16- v8.6
Sensor probes
6. 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 150 mm, including waterproof connector, but it could vary due to
some sensors need special dimensions. Weight of a standard probe rounds 20 g, but there are some special cases
which this weight can rise.
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 connectors 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 the right socket, otherwise they can be damaged.
Never connect a sensor not provided by Libelium to any of the sensor connectors. The electronics system inside
can be damaged and the warranty will be automatically void.
Figure: Enclosure sensor side without protection caps

-17- v8.6
Sensor probes
It should be taken into account that any sensor probe connector has only one matching position with a sensor
probe. The user should align the 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 only sensors ocially provided by Libelium. Any other sensor can damage Waspmote Plug & Sense!
and void the warranty.

-18- v8.6
Sensor probes
6.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. The 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. Besides, the
sensor is kept always straight and the size and shape of the probes are standardized as maximum as possible.
Figure: Standard sensor probe
Sensor probes of this type are all the gas sensors of the Smart Environment and the Smart Environment PRO
models (except for the temperature, humidity and pressure sensor and the particle matter sensor).
White protection probe
This probe is designed to reduce sunlight eects and prevent from water and rain, but allowing humidity
measurement.
Only the temperature, humidity and pressure sensor include this special protection.
Figure: Temperature, humidity and pressure probe

-19- v8.6
Sensor probes
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)
Liquid level probe
This probe is designed to measure liquid levels.
Figure: Liquid level probe

-20- v8.6
Sensor probes
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
Solar radiation probe
This probe is designed to measure solar radiation.
Figure: Solar radiation probe