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