Libelium Smart Cities PRO Quick start guide

Smart Cities PRO
Technical Guide

-2-
v7.3
Index
Document version: v7.3 - 11/2017
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. General...................................................................................................................................5
1.1. General and safety information...................................................................................................... 5
1.2. Conditions of use .............................................................................................................................. 6
2. New version: Smart Cities PRO v3.0....................................................................................7
3. Waspmote Plug & Sense!......................................................................................................8
3.1. Features ............................................................................................................................................. 8
3.2. General view ...................................................................................................................................... 9
3.3. Specications..................................................................................................................................... 9
3.4. Parts included.................................................................................................................................. 12
3.5. Identication.................................................................................................................................... 13
3.6. Sensor probes ................................................................................................................................. 15
3.7. Solar powered ................................................................................................................................. 16
3.8. External Battery Module ................................................................................................................ 18
3.9. Programming the Nodes................................................................................................................ 19
3.10. Program in minutes...................................................................................................................... 20
3.11. Radio interfaces ............................................................................................................................ 21
3.12. Industrial Protocols ...................................................................................................................... 22
3.13. GPS ................................................................................................................................................. 24
3.14. Models............................................................................................................................................ 25
3.14.1. Smart Cities PRO ...............................................................................................................26
4. Hardware .............................................................................................................................28
4.1. General description ........................................................................................................................ 28
4.2. Specications................................................................................................................................... 28
4.3. Electrical characteristics................................................................................................................. 28
5. Sensors .................................................................................................................................29
5.1. Temperature, Humidity and Pressure Sensor............................................................................. 29
5.1.1. Specications .......................................................................................................................29
5.1.2. Measurement process........................................................................................................30
5.1.3. Socket ...................................................................................................................................31
5.2. Ultrasound sensor probe (MaxSonar® from MaxBotix™)......................................................... 32
5.2.1. Specications .......................................................................................................................32
5.2.2. Measurement Process........................................................................................................34
5.2.3. Socket ...................................................................................................................................34
5.3. Luminosity (Luxes accuracy) Sensor............................................................................................. 35
5.3.1. Specications .......................................................................................................................35
5.3.2. Measurement process........................................................................................................35
5.3.3. Socket ...................................................................................................................................35
5.4. Particle Matter (PM1 / PM2.5 / PM10) - Dust Sensor.................................................................. 36

-3-
v7.3
Index
5.4.1. Specications .......................................................................................................................36
5.4.2. Particle matter: the parameter..........................................................................................37
5.4.3. Measurement process........................................................................................................37
5.5. Noise / Sound Level Sensor ........................................................................................................... 38
5.5.1. Specications of the Sound Level Sensor probe .............................................................38
5.5.2. Specications of the enclosure..........................................................................................38
5.5.3. Sound pressure level measurement.................................................................................38
5.5.4. Equivalent continuous sound level ...................................................................................39
5.5.5. The A-weighting...................................................................................................................39
5.5.6. International standard IEC 61672-1:2013 ........................................................................40
5.5.7. Measurement process........................................................................................................40
5.5.8. Calibration Tests..................................................................................................................40
5.5.9. Mounting the Noise / Sound Level Sensor and supplying power .................................43
5.6. Carbon Monoxide (CO) Gas Sensor for high concentrations [Calibrated]............................... 48
5.6.1. Specications .......................................................................................................................48
5.6.2. Cross-sensitivity data..........................................................................................................49
5.7. Carbon Monoxide (CO) Gas Sensor for low concentrations [Calibrated] ................................ 50
5.7.1. Specications .......................................................................................................................50
5.7.2. Cross-sensitivity data..........................................................................................................51
5.8. Carbon Dioxide (CO2) Gas Sensor [Calibrated]............................................................................ 52
5.8.1. Specications .......................................................................................................................52
5.9. Molecular Oxygen (O2) Gas Sensor [Calibrated].......................................................................... 53
5.9.1. Specications .......................................................................................................................53
5.10. Ozone (O3) Gas Sensor [Calibrated]............................................................................................ 54
5.10.1. Specications.....................................................................................................................54
5.10.2. Cross-sensitivity data........................................................................................................55
5.11. Nitric Oxide (NO) Gas Sensor for low concentrations
[Calibrated] ............................................................................................................................................. 56
5.11.1. Specications.....................................................................................................................56
5.11.2. Cross-sensitivity data........................................................................................................57
5.12. Nitric Dioxide (NO2) high accuracy Gas Sensor
[Calibrated] ............................................................................................................................................. 58
5.12.1. Specications.....................................................................................................................58
5.12.2. Cross-sensitivity data........................................................................................................59
5.13. Sulfur Dioxide (SO2) high accuracy Gas Sensor [Calibrated] ................................................... 60
5.13.1. Specications.....................................................................................................................60
5.13.2. Cross-sensitivity data........................................................................................................61
5.14. Ammonia (NH3) Gas Sensor for low concentrations [Calibrated] ........................................... 62
5.14.1. Specications.....................................................................................................................62
5.14.2. Cross-sensitivity data........................................................................................................63
5.15. Ammonia (NH3) Gas Sensor for high concentrations [Calibrated].......................................... 64
5.15.1. Specications.....................................................................................................................64
5.15.2. Cross-sensitivity data........................................................................................................65
5.16. Methane (CH4) and Combustible Gas Sensor

-4-
v7.3
[Calibrated] ............................................................................................................................................. 66
5.16.1. Specications.....................................................................................................................66
5.16.2. Sensitivity data ..................................................................................................................67
5.17. Molecular Hydrogen (H2) Gas Sensor [Calibrated].................................................................... 68
5.17.1. Specications.....................................................................................................................68
5.17.2. Cross-sensitivity data........................................................................................................69
5.18. Hydrogen Sulde (H2S) Gas Sensor [Calibrated]....................................................................... 70
5.18.1. Specications.....................................................................................................................70
5.18.2. Cross-sensitivity data........................................................................................................71
5.19. Hydrogen Chloride (HCl) Gas Sensor [Calibrated] .................................................................... 72
5.19.1. Specications.....................................................................................................................72
5.19.2. Cross-sensitivity data........................................................................................................73
5.20. Hydrogen Cyanide (HCN) Gas Sensor [Calibrated]................................................................... 74
5.20.1. Specications.....................................................................................................................74
5.20.2. Cross-sensitivity data........................................................................................................75
5.21. Phosphine (PH3) Gas Sensor [Calibrated] .................................................................................. 76
5.21.1. Specications.....................................................................................................................76
5.21.2. Cross-sensitivity data........................................................................................................77
5.22. Ethylene Oxide (ETO) Gas Sensor [Calibrated].......................................................................... 78
5.22.1. Specications.....................................................................................................................78
5.22.2. Cross-sensitivity data........................................................................................................79
5.23. Chlorine (Cl2) Gas Sensor [Calibrated]........................................................................................ 80
5.23.1. Specications.....................................................................................................................80
5.23.2. Cross-sensitivity data........................................................................................................81
5.24. Important notes for Calibrated Sensors .................................................................................... 82
6. Board conguration and programming ...........................................................................83
6.1. Hardware conguration................................................................................................................ 83
6.2. API..................................................................................................................................................... 83
6.2.1. Before starting to program ................................................................................................83
6.2.2. Gases sensors......................................................................................................................83
6.2.3. Temperature, humidity and pressure sensor (BME280) ................................................84
6.2.4. Luxes sensor ........................................................................................................................84
6.2.5. Ultrasound sensor...............................................................................................................85
7. Consumption .......................................................................................................................86
7.1. Consumption table ......................................................................................................................... 86
8. API changelog ...................................................................................................................... 87
9. Documentation changelog ................................................................................................ 88
10. Certications.....................................................................................................................89
11. Maintenance......................................................................................................................90
12. Disposal and recycling......................................................................................................91
Index

-5-
v7.3
General
1. General
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.
1.1. General and safety information
•In this section, the term “Waspmote” encompasses both the Waspmote device itself and its modules and
sensor boards.
•Read through the document “General Conditions of Libelium Sale and Use”.
•Do not allow contact of metallic objects with the electronic part to avoid injuries and burns.
•NEVER submerge the device in any liquid.
•Keep the device in a dry place and away from any liquid which may spill.
•Waspmote consists of highly sensitive electronics which is accessible to the exterior, handle with great care
and avoid bangs or hard brushing against surfaces.
•Check the product specications section for the maximum allowed power voltage and amperage range and
consequently always use a current transformer and a battery which works within that range. Libelium is only
responsible for the correct operation of the device with the batteries, power supplies and chargers which it
supplies.
•Keep the device within the specied range of temperatures in the specications section.
•Do not connect or power the device with damaged cables or batteries.
•Place the device in a place only accessible to maintenance personnel (a restricted area).
•Keep children away from the device in all circumstances.
•If there is an electrical failure, disconnect the main switch immediately and disconnect that battery or any
other power supply that is being used.
•If using a car lighter as a power supply, be sure to respect the voltage and current data specied in the “Power
Supplies” section.
•If using a battery in combination or not with a solar panel as a power supply, be sure to use the voltage and
current data specied in the “Power supplies” section.
•If a software or hardware failure occurs, consult the Libelium Web Development section.
•Check that the frequency and power of the communication radio modules together with the integrated
antennas are allowed in the area where you want to use the device.
•Waspmote is a device to be integrated in a casing so that it is protected from environmental conditions such
as light, dust, humidity or sudden changes in temperature. The board supplied “as is” is not recommended for
a nal installation as the electronic components are open to the air and may be damaged.

-6-
v7.3
General
1.2. Conditions of use
•Read the “General and Safety Information” section carefully and keep the manual for future consultation.
•Use Waspmote in accordance with the electrical specications and the environment described in the “Electrical
Data” section of this manual.
•Waspmote and its components and modules are supplied as electronic boards to be integrated within a nal
product. This product must contain an enclosure to protect it from dust, humidity and other environmental
interactions. In the event of outside use, this enclosure must be rated at least IP-65.
•Do not place Waspmote in contact with metallic surfaces; they could cause short-circuits which will permanently
damage it.
Further information you may need can be found at http://www.libelium.com/development/waspmote
The “General Conditions of Libelium Sale and Use” document can be found at:
http://www.libelium.com/development/waspmote/technical_service

-7-
v7.3
New version: Smart Cities PRO v3.0
2. New version: Smart Cities PRO v3.0
This guide explains the new Smart Cities Sensor Board v3.0. This board was designed for our new product lines
Waspmote v15 and Plug & Sense! v15, released on October 2016.
The previous version of this board (Smart Cities v2.0) was designed for Waspmote v12 and Plug & Sense! v12, and
it is NOT recommended to mix product generations. 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”.
Dierences of Smart Cities PRO v3.0 with the previous version:
•Added the new Noise Level Sensor, able to read LeqA (integrated equivalent continuous sound level,
A-weighted) in dBA. The sensor achieves high accuracy in a wide range of frequencies.
•I2C sockets allow the connection of digital sensors, even gas sensors from Gases PRO, Temperature, Humidity
and Pressure sensor or Luxes and Ultrasound sensors.
•The Particle Matter – Dust Sensor (PM1 / PM2.5 / PM10) is now available on this board.
•New connectors to improve the Plug & Sense! wiring, making it more robust.
•Added an I2C isolator chip to avoid aecting to the Waspmote I2C bus.

-8-
v7.3
Waspmote Plug & Sense!
3. Waspmote Plug & Sense!
The Waspmote Plug & Sense! line allows you to easily deploy Internet of Things 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.
Note: For a complete reference guide download the “Waspmote Plug & Sense! Technical Guide” in the Development
section of the Libelium website.
3.1. Features
•Robust waterproof IP65 enclosure
•Add or change a sensor probe in seconds
•Solar powered with internal and external panel options
•Radios available: 802.15.4, 868 MHz, 900 MHz, WiFi, 4G, Sigfox and LoRaWAN
•Over the air programming (OTAP) of multiple nodes at once (via WiFi or 4G radios)
•Special holders and brackets ready for installation in street lights and building fronts
•Graphical and intuitive interface Programming Cloud Service
•Built-in, 3-axes accelerometer
•External, contactless reset with magnet
•Optional industrial protocols: RS-232, RS-485, Modbus, CAN Bus
•Optional GPS receiver
•Optional External Battery Module
•External SIM connector for the 4G models
•Fully certied: CE (Europe), FCC (USA), IC (Canada), ANATEL (Brazil), RCM (Australia), PTCRB (USA, cellular
connectivity), AT&T (USA, cellular connectivity)
Figure: Waspmote Plug & Sense!

-9-
v7.3
Waspmote Plug & Sense!
3.2. 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.
3.3. 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!

-10-
v7.3
Waspmote Plug & Sense!
Figure: Control side of the enclosure
Figure: Control side of the enclosure for 4G model
Figure: Sensor side of the enclosure

-11-
v7.3
Waspmote Plug & Sense!
Figure: Antenna side of the enclosure
Figure: Front view of the enclosure
Figure: Back view of the enclosure

-12-
v7.3
Waspmote Plug & Sense!
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.
3.4. 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-
v7.3
Waspmote Plug & Sense!
3.5. 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-
v7.3
Waspmote Plug & Sense!
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
Sensor
reference
Figure: Sensor probe identication sticker

-15-
v7.3
Waspmote Plug & Sense!
3.6. Sensor probes
Sensor probes can be easily attached by just screwing them into the bottom sockets. This allows you to add new
sensing capabilities to existing networks just in minutes. In the same way, sensor probes may be easily replaced
in order to ensure the lowest maintenance cost of the sensor network.
Figure: Connecting a sensor probe to Waspmote Plug & Sense!
Go to the Plug & Sense! Sensor Guide to know more about our sensor probes.

-16-
v7.3
Waspmote Plug & Sense!
3.7. Solar powered
The battery can be recharged using the waterproof USB cable but also the internal or external solar panel options.
The external solar panel is mounted on a 45º holder which ensures the maximum performance of each outdoor
installation.
Figure: Waspmote Plug & Sense! powered by an external solar panel
For the internal option, the solar panel is embedded on the front of the enclosure, perfect for use where space is
a major challenge.
Figure: Internal solar panel

-17-
v7.3
Waspmote Plug & Sense!
Figure: Waspmote Plug & Sense! powered by an internal solar panel

-18-
v7.3
Waspmote Plug & Sense!
3.8. External Battery Module
The External Battery Module (EBM) is an accessory to extend the battery life of Plug & Sense!. The extension
period may be from months to years depending on the sleep cycle and radio activity. The daily charging period is
selectable among 5, 15 and 30 minutes with a selector switch and it can be combined with a solar panel to extend
even more the node’s battery lifetime.
Note: Nodes using solar panel can keep using it through the External Battery Module (EBM). The EBM is
connected to the solar panel connector of Plug & Sense! and the solar panel unit is connected to the solar
panel connector of the EBM.
Figure: Plug & Sense! with External Battery Module
Figure: Plug & Sense! with External Battery Module and solar panel

-19-
v7.3
Waspmote Plug & Sense!
3.9. Programming the Nodes
Waspmote Plug & Sense! can be reprogrammed in two ways:
The basic programming is done from the USB port. Just connect the USB to the specic external socket and then
to the computer to upload the new rmware.
Figure: Programming a node
Over the Air Programming (OTAP) is also possible once the node has been installed (via WiFi or 4G radios). With
this technique you can reprogram, wireless, one or more Waspmote sensor nodes at the same time by using a
laptop and Meshlium.
Figure: Typical OTAP process

-20-
v7.3
Waspmote Plug & Sense!
3.10. Program in minutes
The Programming Cloud Service is an intuitive graphic interface which creates code automatically. The user just
needs to to ll a web form to obtain binaries for Plug & Sense!. Advanced programming options are available,
depending on the license selected.
Check how easy it is to handle the Programming Cloud Service at:
https://cloud.libelium.com/
Figure: Programming Cloud Service