Waspmote Plug & Sense! Smart Parking Quick start guide

wasp
mote
Plug & Sense! Smart Parking
Technical Guide

-2-
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. Introduction......................................................................................................................................... 4
2. General ................................................................................................................................................ 5
2.1. General and safety information..............................................................................................................................................5
2.2. Conditions of use .........................................................................................................................................................................5
3. Hardware.............................................................................................................................................. 6
3.1. Hardware description.................................................................................................................................................................6
3.2. Power consumption....................................................................................................................................................................6
4. How the node works............................................................................................................................ 7
5. Sleep modes......................................................................................................................................... 8
5.1. Day mode........................................................................................................................................................................................8
5.2. Night mode ....................................................................................................................................................................................9
6. Transmission modes.......................................................................................................................... 10
7. Frames ................................................................................................................................................ 11
7.1. Firmware version v2.x.x...........................................................................................................................................................11
7.1.1. Info frame......................................................................................................................................................................11
7.1.2. Keep-Alive frame........................................................................................................................................................12
7.1.3. Daily update frame....................................................................................................................................................12
7.1.4. Error frame....................................................................................................................................................................13
7.1.5. Start frames ..................................................................................................................................................................14
7.2. Firmware version v1.x.x...........................................................................................................................................................15
7.2.1. Info frame......................................................................................................................................................................15
7.2.2. Keep-Alive frame........................................................................................................................................................16
7.2.3. Daily update frame....................................................................................................................................................16
7.2.4. Error frame....................................................................................................................................................................17
7.2.5. Start frames ..................................................................................................................................................................18
8. Smart Devices App ............................................................................................................................ 19
8.1. Installation...................................................................................................................................................................................19
8.2. Smart Parking............................................................................................................................................................................. 19
8.2.1. Programmer .................................................................................................................................................................19
8.2.2. Firmware upgrade......................................................................................................................................................21
8.2.3. Conguration...............................................................................................................................................................23
Index

-3-
9. Callback Server .................................................................................................................................. 24
9.1. Installation...................................................................................................................................................................................24
9.2. Deploying ....................................................................................................................................................................................25
9.3. Making the server accessible from anywhere ................................................................................................................26
9.4. Web form...................................................................................................................................................................................... 26
9.5. How to extend the remote node conguration web application...........................................................................29
10. Developing the network ................................................................................................................. 32
10.1. Application considerations.................................................................................................................................................32
10.1.1. Deployment of the motes ....................................................................................................................................32
10.1.2. Interference of other vehicles .............................................................................................................................33
11. Device Installation........................................................................................................................... 34
11.1. Assembly and set up ............................................................................................................................................................. 34
11.2. How to close the Smart Parking enclosure to keep the waterproof IP68 features.........................................36
11.3. Installation and boot.............................................................................................................................................................37
11.4. Conguring the parking nodes in the callback server.............................................................................................. 43
12. Services ............................................................................................................................................ 44
12.1. Sigfox ..........................................................................................................................................................................................44
12.1.1. Device conguration..............................................................................................................................................44
12.1.2. Server conguration...............................................................................................................................................48
12.2. Loriot...........................................................................................................................................................................................49
12.2.1. Device conguration..............................................................................................................................................49
12.2.2. Server conguration...............................................................................................................................................50
12.3. Start the web-socket connection .....................................................................................................................................51
12.4. Actility......................................................................................................................................................................................... 52
12.4.1. Device conguration..............................................................................................................................................52
12.4.2. Server conguration...............................................................................................................................................55
12.5. Saving the information received.......................................................................................................................................56
12.6. How to develop a new service...........................................................................................................................................56
13. Troubleshooting .............................................................................................................................. 62
13.1. Windows does not recognize USB ports .......................................................................................................................62
13.2. How to know the port where the device is plugged in............................................................................................65
13.3. I cannot load nor save the conguration in the node............................................................................................... 65
14. Certications.................................................................................................................................... 66
14.1. USA Certication:....................................................................................................................................................................66
15. Disposal and recycling .................................................................................................................... 67
Index

-4-
Introduction
1. Introduction
The aim of this manual is to introduce the user to Smart Parking in a practical way.
This document applies to the following Smart Parking model, approved for FCC:
Model FCC ID
Smart Parking US XKM-PARKING-V1
The new version of Waspmote Plug & Sense! Smart Parking, the solution for Smart Cities that allows citizens to
detect available parking spots.
The new device is easier and cheaper to deploy as it is mounted on the road surface. Unlike most market
versions, it does not need to dig a hole in the ground for installation, reducing installation time from 30 to 5
minutes and allowing to be replaced by another unit in case of maintenance in just 10 minutes.
The smaller size -reduced over 50%-, its higher accuracy and reliability, and the faster time of detection, besides
the independence from temperature are also important features of new Smart Parking device.
New sensor system is fully compatible with LPWAN radio technologies -LoRaWAN and Sigfox- to enable long
range and low power consumption. It can be connected with both radios for the European 868 MHz band and
for the 900-930 MHz band (US / Canada). One unique feature of the system is that it allows to use both radio
technologies at the same time or changing from one to the other using the manager system from the Cloud.
With the new sensor system, one base station can give service to thousands of devices around a range of several
kilometers in urban environment. This fact provides lower costs of installation since the number of base stations
can be dramatically reduced. Besides, the new sensor model has been optimized for really low-power operation,
so the battery lifetime is extended up to 10 years easily.
The new Smart Parking node has been granted with the CE / FCC marks and provides a robust software which
works out-of-the-box. Developers do not have to cope with programming the nodes, they just have to specify
WKHYDOXHVRINH\SDUDPHWHUVLQWKHȴUPZDUHVXFKDVZRUNLQJF\FOHRUQLJKWPRGHWREHUHDG\WRZRUNRemote
management and bidirectional communication allows to change several parameters of the nodes from the
Cloud. This means we can reprogram thousands of nodes by just setting the right values from our web browser
in the management platform.

-5-
General
2. General
2.1. General and safety information
•In this section, the term “Waspmote” encompasses both the Waspmote device itself and it enclosure.
•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 with the enclosure open.
•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.
•&KHFNWKHSURGXFWVSHFLȴFDWLRQVVHFWLRQIRUWKHPD[LPXPDOORZHGSRZHUYROWDJHDQGDPSHUDJHUDQJHDQG
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.
•.HHSWKHGHYLFHZLWKLQWKHVSHFLȴHGUDQJHRIWHPSHUDWXUHVLQWKHVSHFLȴFDWLRQVVHFWLRQ
•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 a 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.
2.2. Conditions of use
•Read the “General and Safety Information” section carefully and keep the manual for future consultation.
•8VH :DVSPRWH LQ DFFRUGDQFH ZLWK WKH HOHFWULFDO VSHFLȴFDWLRQV DQG WKH HQYLURQPHQW GHVFULEHG LQ WKH
“Hardware” section of this manual.
•Do not place Waspmote in contact with metallic surfaces; they could cause short-circuits which will permanently
damage it.
•Ζ03257$17ΖWLVWKHUHVSRQVLELOLW\RIWKHLQVWDOOHUWRȴQGRXWDERXWUHVWULFWLRQVRIXVHIRUIUHTXHQF\EDQGVLQ
each country and act in accordance with the given regulations. Libelium Comunicaciones Distribuidas S.L does
not list the entire set of standards that must be met for each country.
•For further information go to:
-CEPT ERC 70-03E - Technical Requirements, European restrictions and general requirements: http://www.
erodocdb.dk/
-R&TTE Directive - Equipment requirements, placement on market: http://www.erodocdb.dk/
•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

-6-
Hardware
3. Hardware
3.1. Hardware description
Figure : Plug & Sense! Smart Parking
Power supply Built-in Lithium batteries, expected lifetime of 4-6 years*
Antenna Included
Detection Magnetic
Mounting 2YHUWKHȵRRU
Dimensions 230 mm diameter, 28 mm height
Protection IP68 strictly under right closing (see section “Device
installation”)
Operating temperature -20 to +65 °C
* Under normal circumstances and dependent on settings
Figure : Plug & Sense! Smart Parking main characteristics
3.2. Power consumption
Consumption
Measuring sensor TBD
Transmission Sigfox TBD
Transmission LoRaWAN TBD
Sleep state 25 µA
Battery self discharge < 1% month at +20 ºC
Battery type Lithium non-rechargeable battery, 3.6 V,
10.4 A·h
Figure : Plug & Sense! Smart Parking power consumption

-7-
How the node works
4. How the node works
Figure : Basic working loop diagram
As the diagram indicate, the basic loop of the node consists in read the sensor and send a frame when the parking
slot change it status. Then, it sleeps a desired time and starts the loop again.
Some events can forced the node to send a frame to the cloud. If a desired time elapsed since the last radio
transmission, the node will send a Keep-Alive frame. This frame only contains basic data from the node (parking
slot status and battery status). It is useful to know that there is no changes in the slot, but the node still working.
The node also will send a frame each 24 hours with the working data of the day (number of measurements,
number of transmissions,…).
Figure : Extended loop diagram

-8-
Sleep modes
5. Sleep modes
Plug & Sense! Smart Parking has 2 sleep modes: day mode and night mode. The second one has been developed
WRXVHZKHQWKHSDUNLQJVORWLVH[SHFWHGWRKDYHIHZHUFKDQJHVLHDWQLJKW(DFKPRGHKDVLWVRZQFRQȴJXUDWLRQ
SDUDPHWHUV7KHȴJXUHEHORZVKRZVDQH[DPSOHIRUWKHQRGHWUDQVPLVVLRQVLQDGD\7KHWLPH]RQHEHWZHHQ
AM and 12 AM (in light gray) indicates that the node is working in day mode. In this mode, the sampling of the
parking slot is made more regular (1 minute) and the Keep-Alive is only 2 hours. In the dark gray zone, from 12 AM
to 6 AM, the node is working in night mode. As is shown in the example, the sampling time is greater (10 minutes)
and the Keep-Alive increases too (3 hours).
([DPSOHFRQȴJXUDWLRQ
Parameter &RQȴJXUDWLRQ
Sleep time 1 minute
Keep-Alive 2 hours
Night Mode start hour 00 hours
Night Mode duration 6 hours
Night Mode Sleep Time 10 minutes
Night Mode Keep-Alive 3 hours
Figure : ([DPSOHFRQȴJXUDWLRQ
Figure : Day and night modes example
5.1. Day mode
ΖWLVWKHEDVLFZRUNLQJPRGHDQGLWKDVFRQȴJXUDEOHSDUDPHWHUV
•Sleep time:6OHHSWLPHEHWZHHQFRQVHFXWLYHVHQVRUPHDVXUHPHQWVPLQXWHVRSWLRQLVFRQȴJXUHGE\GHIDXOW
•Keep-Alive:(ODSVHGWLPHVLQFHODVWWUDQVPLVVLRQWRWULJJHUD.HHS$OLYHIUDPHKRXUVRSWLRQLVFRQȴJXUHG
by default. This frame only contains basic data from the node (parking slot status and battery status). It is
useful to know that there are no changes in the slot, but the node still working. This mode can be disabled
using both the USB Programmer or the Remote Manager.

-9-
Sleep modes
5.2. Night mode
This mode has been developed to use when the parking slot is expected to have fewer changes (i.e. at night). It
KDVFRQȴJXUDEOHSDUDPHWHUV
•Night Mode start hour:%HJLQQLQJKRXURIWKHQLJKWPRGHKRXUVRSWLRQLVFRQȴJXUHGE\GHIDXOW
•Night Mode duration:1LJKWPRGHGXUDWLRQWLPHKRXURSWLRQLVFRQȴJXUHGE\GHIDXOW
•Night Mode Sleep Time: Sleep time between consecutive sensor measurements (during night mode). 10
PLQXWHVRSWLRQLVFRQȴJXUHGE\GHIDXOW
•Night Mode Keep-Alive: Elapsed time since last transmission to trigger a Keep-Alive frame (during night
PRGHKRXUVRSWLRQLVFRQȴJXUHGE\GHIDXOW7KLVIUDPHRQO\FRQWDLQVEDVLFGDWDIURPWKHQRGHSDUNLQJVORW
status and battery status). It is useful to know that there is no change in the slot, but the node is still working.
This mode can be disabled using both the USB Programmer or the Remote Manager.

-10-
Transmission modes
6. Transmission modes
Plug & Sense! Smart Parking has 2 transmission modes allowing the user to choose between Sigfox, LoRaWAN:
•Sigfox. This mode only uses the Sigfox radio to send the data collected by the node. This mode is selected by
default.
•LoRaWAN. This mode only uses the LoRaWAN radio to send the data collected by the node.