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.

-11-
Frames
7. Frames
7.1. Firmware version v2.x.x
3OXJ6HQVH6PDUW3DUNLQJQRGHFDQVHQGGHȴQHGIUDPHV$OOIUDPHVDUHE\WHVOHQJWKDQGWKH\DUHWKH
same for Sigfox and LoRaWAN. Bytes 0 and 1 are common for all frames. Byte 0 has the basic information of the
node and frame.
Bit Name Description
7 Parking slot status '0' indicates that the parking slot is empty
'1' indicates that the slot is in occupied
6 Battery state
'0' indicates that the battery has a good level of charge
‘1’ indicates that the battery has little charge and it will be necessary
to change it. When the battery has little charge it is possible that the
node does not work properly and the radios fail sending the frames.
5-4 Reserved Reserved bits. Do not consider.
3
Frame type
0 – Info frame
1 – Keep-Alive frame
2 – Daily update frame
3 – Error frame
4 – Start frame 1
5 – Start frame 2
Values from 6 to 15 are reserved
Values from 6 to 15 are reserved
2
1
0
Figure : Byte 0 description
Byte 1 is a frame counter, it goes from 0 to 255. This byte can be used to detect lost frames (sent by the node but
not received).
7.1.1. Info frame
It is the most common frame sent by the node. The node will send this kind of frame each time it detects that the
parking slot changed from empty to occupied or vice-versa. The other bytes are used to give additional data to
the user.
Byte Name Description
0 Basic data Detailed description in the section “Frame”
1 Frame counter Detailed description in the section “Frame”
2 Temperature Temperature (Celsius degrees) from the node's internal sensor. The
value of temperature is a signed integer.
3 X axis measurement MSB Raw value from the sensor associated to the X axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
4 X axis measurement LSB
5 Y axis measurement MSB Raw value from the sensor associated to the Y axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
6 Y axis measurement LSB
7 Z axis measurement MSB Raw value from the sensor associated to the Z axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
8 Z axis measurement LSB
9-10 Reserved Reserved bytes. Do not consider.
Figure : Info frame structure

-12-
Frames
7.1.2. Keep-Alive frame
This frame is used to indicate that the parking slot has not changed, but the node is still working.
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Timestamp (hh) Current hours
3 Timestamp (mm) Current minutes
4 Temperature Temperature (Celsius degrees) from the node's internal sensor. The
value of temperature is a signed integer.
5 X axis measurement MSB Raw value from the sensor associated to the X axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form,.
6 X axis measurement LSB
7 Y axis measurement MSB Raw value from the sensor associated to the Y axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
8 Y axis measurement LSB
9 Z axis measurement MSB Raw value from the sensor associated to the Z axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
10 Z axis measurement LSB
Figure : Keep-Alive frame structure
7.1.3. Daily update frame
This frame is sent daily at 1 AM. It contains a little summary.
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Sensor measurements MSB Unsigned 16 bit counter. It stores the times that the sensor is used
in the last 24 hours.
3 Sensor measurements LSB
4 Sigfox transmissions MSB Unsigned 16 bit counter. It stores the times that Sigfox radio is
used in the last 24 hours.
5 Sigfox transmissions LSB
6 LoRaWAN transmissions MSB Unsigned 16 bit counter. It stores the times that LoRaWAN radio is
used in the last 24 hours.
7 LoRaWAN transmissions LSB
8 Resets Number of resets generated in the last 24 hours
9&RQȴJBLG 9DOXHRIWKHFRQȴJXUDWLRQYHUVLRQORDGHGLQWRWKHQRGH
10 Reserved Reserved bytes. Do not consider.
Figure : Daily update frame structure
This frame can be deactivated using the Plug & Sense! Smart Parking USB Programmer or via radio, with the
Remote Manager, setting to 0 the enable/disable daily frame bit.
The daily update frame is very special because the node waits for a response after it is sent. This response is useful
IRUUHFRQȴJXULQJWKHQRGHȊRYHUWKHDLUȋZLWKRXWSK\VLFDODFFHVV$OVRDVHFRQGXVHRIWKLVUHVSRQVHIUDPHLVWR
V\QFKURQL]HWKHQRGHȇVLQWHUQDOFORFNWKDQNVWRDWLPHVWDPS7KLVUHVSRQVHFDQEHFRQȴJXUHGXVLQJWKHUHPRWH
PHP.

-13-
Frames
7.1.4. Error frame
In some cases the node could send a frame if some internal components or processes fail.
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Error data Detailed description below
3 Temperature Temperature (Celsius degrees) from the node's internal sensor. The
value of temperature is a signed integer.
4 X axis measurement MSB Raw value from the sensor associated to the X axis. The value
stored in these two bytes is a 16-bit value in 2’s complement form.
5 X axis measurement LSB
6 Y axis measurement MSB Raw value from the sensor associated to the Y axis. The value
stored in these two bytes is a 16-bit value in 2’s complement form.
7 Y axis measurement LSB
8 Z axis measurement MSB Raw value from the sensor associated to the Z axis. The value
stored in these two bytes is a 16-bit value in 2’s complement form.
9 Z axis measurement LSB
10 Battery level Battery voltage in millivolts. To convert to millivolts use the next
formula:
Figure : Error frame structure
Bit Name Description
7-6 Reserved Reserved bits. Do not consider.
5 Error Sigfox Set to '1' when an error related with the Sigfox radio is detected. Clear when no
issues detected.
4 Error LoRaWAN Set to '1' when an error related with the LoRaWAN radio is detected. Clear when
no issues detected.
3 Error RTC Set to '1' when an error related with the RTC (internal clock) is detected. Clear
when no issues detected.
2 Error X axis Set to '1' when an error appears in the X axis of the sensor. Clear when no issues
detected.
1 Error Y axis Set to '1' when an error appears in the Y axis of the sensor. Clear when no issues
detected.
0 Error Z axis Set to '1' when an error appears in the Z axis of the sensor. Clear when no issues
detected.
Figure : “Error data” byte structure

-14-
Frames
7.1.5. Start frames
:KHQWKHQRGHVWDUWVWRZRUNLQWKHSDUNLQJVORWLWZLOOVHQGIUDPHV7KHȴUVWRQHLVGHGLFDWHGWRWKHVHQVRUDQG
WKHEDWWHU\7KHVHFRQGRQHLVXVHGWRVHQGVRPHSDUDPHWHUVDERXWWKHFKRVHQFRQȴJXUDWLRQ
7.1.5.1. Start frame number 1
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Temperature Temperature (Celsius degrees) from the node's internal sensor. The value
of temperature is a signed integer.
3 X axis reference MSB Reference value from the sensor associated to the X axis. The value stored
in these two bytes is a 16-bit value in 2’s complement form.
4 X axis reference LSB
5 Y axis reference MSB Reference value from the sensor associated to the Y axis. The value stored
in these two bytes is a 16-bit value in 2’s complement form.
6 Y axis reference LSB
7 Z axis reference MSB Reference value from the sensor associated to the Z axis. The value stored
in these two bytes is a 16-bit value in 2’s complement form.
8 Z axis reference LSB
9 Battery voltage MSB Battery voltage in millivolts. The value stored in these two bytes is an
unsigned 16-bit value.
10 Battery voltage LSB
Figure : Start frame number 1 structure
7.1.5.2. Start frame number 2
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2)Ζ50:$5(B9(56Ζ21 Firmware version
310B67$57 Beginning hour of the night mode
410B3(5Ζ2' Duration in hours of the night mode
510B6/((3B7Ζ0( Sleep time between consecutive sensor measurements (during night mode)
610B.((3B$/Ζ9( Elapsed time since last transmission to trigger a Keep-Alive frame (during
night mode)
75$'Ζ2B02'( Selected transmission mode between Sigfox, LoRaWAN y their
combinations
86/((3B7Ζ0( Sleep time between consecutive sensor measurements
9.((3B$/Ζ9( Elapsed time since last transmission to trigger a Keep-Alive frame
10 THRESHOLD Threshold for detecting a vehicle over the parking slot
Figure : Start frame number 2 structure

-15-
Frames
7.2. Firmware version v1.x.x
3OXJ6HQVH6PDUW3DUNLQJQRGHFDQVHQGGHȴQHGIUDPHV$OOIUDPHVDUHE\WHVOHQJWKDQGWKH\DUHWKH
same for Sigfox and LoRaWAN. Bytes 0 and 1 are common for all frames. Byte 0 has the basic information of the
node, and frame and byte 1 is a frame counter. It can be used to detect lost frames.
Bit Name Description
7 Parking slot status '0' indicates that the parking slot is empty
'1' indicates that the slot is in occupied
6 Battery state
'0' indicates that the battery has a good level of charge
'1' indicates that the battery has little charge and it will be necessary to
change it. When the battery has little charge it is possible that the node
does not work properly and the radios fail sending the frames.
5-4 Reserved Reserved bits. Do not consider.
3
Frame type
0 – Info frame
1 – Keep-Alive frame
2 – Daily update frame
3 – Error frame
4 – Start frame 1
5 – Start frame 2
Values from 6 to 15 are reserved
2
1
0
Figure : Byte 0 description
7.2.1. Info frame
It is the most common frame sent by the node. The node will send this kind of frame each time it detects that the
parking slot changed from empty to occupied or vice-versa. The other bytes are used to give additional data to
the user.
Byte Name Description
0 Basic data Detailed description in the section “Frame”
1 Frame counter Detailed description in the section “Frame”
2 Temperature MSB Raw temperature from the node's internal sensor. The value stored in
these two bytes is a 16-bit value in 2’s complement form. To convert to
Celsius degrees use the next formula:
3 Temperature LSB
4 X axis measurement MSB Raw value from the sensor associated to the X axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
5 X axis measurement LSB
6 Y axis measurement MSB Raw value from the sensor associated to the Y axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
7 Y axis measurement LSB
8 Z axis measurement MSB Raw value from the sensor associated to the Z axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
9 Z axis measurement LSB
10-11 Reserved Reserved bytes. Do not consider.
Figure : Info frame structure

-16-
Frames
7.2.2. Keep-Alive frame
This frame is used to indicate that the parking slot has not changed, but the node is still working.
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Timestamp (hh) Current hours
3 Timestamp (mm) Current minutes
4 Temperature MSB Raw temperature from the node’s internal sensor. The value stored in
these two bytes is a 16-bit value in 2’s complement form. To convert to
Celsius degrees use the next formula:
5 Temperature LSB
6 X axis measurement MSB Raw value from the sensor associated to the X axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
7 X axis measurement LSB
8 Y axis measurement MSB Raw value from the sensor associated to the Y axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
9 Y axis measurement LSB
10 Z axis measurement MSB Raw value from the sensor associated to the Z axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
11 Z axis measurement LSB
Figure : Keep-Alive frame structure
7.2.3. Daily update frame
This frame is sent daily at 1 AM. It contains a little summary.
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Sensor measurements MSB Unsigned 16 bit counter. It stores the times that the sensor is used
in the last 24 hours.
3 Sensor measurements LSB
4 Sigfox transmissions MSB Unsigned 16 bit counter. It stores the times that Sigfox radio is used
in the last 24 hours.
5 Sigfox transmissions LSB
6 LoRaWAN transmissions MSB Unsigned 16 bit counter. It stores the times that LoRaWAN radio is
used in the last 24 hours.
7 LoRaWAN transmissions LSB
8 Resets Number of resets generated in the last 24 hours
9&RQȴJBLG 9DOXHRIWKHFRQȴJXUDWLRQYHUVLRQORDGHGLQWRWKHQRGH
10-11 Reserved Reserved bytes. Do not consider.
Figure : Daily update frame structure
This frame can be deactivated using the Plug & Sense! Smart Parking USB Programmer or via radio, with the
Remote Manager, setting to 0 the enable/disable daily frame bit.
The daily update frame is very special because the node waits for a response after it is sent. This response is useful
IRUUHFRQȴJXULQJWKHQRGHȊRYHUWKHDLUȋZLWKRXWSK\VLFDODFFHVV$OVRDVHFRQGXVHRIWKLVUHVSRQVHIUDPHLVWR
V\QFKURQL]HWKHQRGHȇVLQWHUQDOFORFNWKDQNVWRDWLPHVWDPS7KLVUHVSRQVHFDQEHFRQȴJXUHGXVLQJWKHUHPRWH
PHP.

-17-
Frames
7.2.4. Error frame
In some cases the node could send a frame if some internal components or processes fail.
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Error data Detailed description below
3 Temperature MSB Raw temperature from the parking internal sensor. The value stored in
these two bytes is a 16-bit value in 2’s complement form. To convert to
Celsius degrees use the next formula:
4 Temperature LSB
5X axis measurement
MSB Raw value from the sensor associated to the X axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
6X axis measurement
LSB
7Y axis measurement
MSB Raw value from the sensor associated to the Y axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
8Y axis measurement
LSB
9Z axis measurement
MSB Raw value from the sensor associated to the Z axis. The value stored in
these two bytes is a 16-bit value in 2’s complement form.
10 Z axis measurement
LSB
11 Battery level Battery voltage in millivolts. To convert to millivolts use the next formula:
Figure : Error frame structure
Bit Name Description
7-6 Reserved Reserved bits. Do not consider.
5 Error Sigfox Set to '1' when an error related with the Sigfox radio is detected. Clear
when no issues detected.
4 Error LoRaWAN Set to '1' when an error related with the LoRaWAN radio is detected. Clear
when no issues detected.
3 Error RTC Set to '1' when an error related with the RTC (internal clock) is detected.
Clear when no issues detected.
2 Error X axis Set to '1' when an error appears in the X axis of the sensor. Clear when no
issues detected.
1 Error Y axis Set to '1' when an error appears in the Y axis of the sensor. Clear when no
issues detected.
0 Error Z axis Set to '1' when an error appears in the Z axis of the sensor. Clear when no
issues detected.
Figure : “Error data” byte structure

-18-
Frames
7.2.5. Start frames
:KHQWKHQRGHVWDUWVWRZRUNLQWKHSDUNLQJVORWLWZLOOVHQGIUDPHV7KHȴUVWRQHLVGHGLFDWHGWRWKHVHQVRUDQG
WKHEDWWHU\7KHVHFRQGRQHLVXVHGWRVHQGVRPHSDUDPHWHUVDERXWWKHFKRVHQFRQȴJXUDWLRQ
7.2.5.1. Start frame number 1
Byte Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2 Temperature MSB Raw temperature from the parking internal sensor. The value stored in
these two bytes is a 16-bit value in 2’s complement form. To convert to
Celsius degrees use the next formula:
3 Temperature LSB
4 X axis reference MSB Reference value from the sensor associated to the X axis. The value stored
in these two bytes is a 16-bit value in 2’s complement form.
5 X axis reference LSB
6 Y axis reference MSB Reference value from the sensor associated to the Y axis. The value stored
in these two bytes is a 16-bit value in 2’s complement form.
7 Y axis reference LSB
8 Z axis reference MSB Reference value from the sensor associated to the Z axis. The value stored
in these two bytes is a 16-bit value in 2’s complement form.
9 Z axis reference LSB
10 Battery voltage MSB Battery voltage in millivolts. The value stored in these two bytes is an
unsigned 16-bit value.
11 Battery voltage LSB
Figure : Start frame number 1 structure
7.2.5.2. Start frame number 2
Bit Name Description
0 Basic data Detailed description in section “Frame”
1 Frame counter Detailed description in section “Frame”
2&2'(BΖ' Firmware version
310B67$57 Beginning hour of the night mode
410B3(5Ζ2' Duration in hours of the night mode
510B6/((3B7Ζ0( Sleep time between consecutive sensor measurements (during night mode)
610B.((3B$/Ζ9( Elapsed time since last transmission to trigger a Keep-Alive frame (during
night mode)
75$'Ζ2B02'( Selected transmission mode between Sigfox, LoRaWAN y their
combinations
86/((3B7Ζ0( Sleep time between consecutive sensor measurements
9.((3B$/Ζ9( Elapsed time since last transmission to trigger a Keep-Alive frame
10 THRESHOLD Threshold for detecting a vehicle over the parking slot
11 Reserved Reserved byte. Do not consider.
Figure : Start frame number 2 structure

-19-
Smart Devices App
8. Smart Devices App
/LEHOLXP6PDUW'HYLFHV$SSLVDQLPSRUWDQWWRROGHYHORSHGE\/LEHOLXPWKDWDOORZVXVHUVLQVWDOOQHZȴUPZDUH
YHUVLRQVDQGSURJUDP WKH FRQȴJXUDWLRQRIWKH QHZ /LEHOLXPGHYLFHVLQ D IHZFOLFNV $W WKHPRPHQWLW LV RQO\
available for Smart Parking and MySignals products, but the list will be incremented shortly.
8.1. Installation
First of all and before installing anything, users have to take into account the platform where the application is
going to be installed. To install the Libelium Smart Devices App, it is compulsory to have installed the JDK 1.8. If it
is not installed in the computer, you can follow the steps and download it from this website:
https://docs.oracle.com/javase/8/docs/technotes/guides/install/install_overview.html
Once installed JDK, users can download the application using the appropriate link depending on the operative
system:
•Ubuntu: http://downloads.libelium.com/smart_device_app/SmartDeviceApp_linux64.zip
•Windows: http://downloads.libelium.com/smart_device_app/SmartDeviceApp_windows32.zip
•Mac: http://downloads.libelium.com/smart_device_app/SmartDeviceApp_macosx64.zip
7KHQFXVWRPHUVRQO\KDYHWRH[WUDFWWKHFRQWHQWRIWKH6PDUW'HYLFH$SS]LSȴOHGRZQORDGHGLQDSODFHZLWKWKH
ULJKWSHUPLVVLRQVDQGȴQDOO\H[HFXWHWKHȴOHFDOOHGȊ6PDUW'HYLFH$SSȋWKDWZLOOLQLWLDOL]HWKHDSSOLFDWLRQ3OHDVH
QRWHWKDWWKHH[WHQVLRQRIWKLVȴOHZLOOGHSHQGRQWKHRSHUDWLQJV\VWHPWKHXVHULVXVLQJDWWKHPRPHQWVKIRU
Linux and OSX, and .bat for Windows).
8.2. Smart Parking
This section provides several options to Smart Parking users in order to take full advantage of all possibilities the
GHYLFHVR΍HUV
8.2.1. Programmer
Figure : 6PDUW3DUNLQJFRQȴJXUDWLRQIRUP

-20-
Smart Devices App
8VHUVFDQUHDGDQGZULWHDOOFRQȴJXUDWLRQSDUDPHWHUVRIWKHLUGHYLFHVLQWKLVVHFWLRQ7KHSURFHVVLVTXLWHVLPSOH
Just connect the device to the computer where the Smart Devices App is installed using the USB cable provided
and switch the node on.
Then, refresh the “USB settings” block which is in the bottom-right corner, clicking in “refresh” button. Once done
it, the port where the device has been connected must be selected.
Figure : USB settings
%XWEHIRUHFRQȴJXULQJWKHGHYLFHLWLVYHU\LPSRUWDQWWKDWXVHUVWDNHLQFRQVLGHUDWLRQWKHIROORZLQJOLVWZKHUHDOO
parameters are explained:
TIME SETTINGS
•Sleep time: Sleep time between consecutive sensor measurements.
•Keep-Alive: Elapsed time since last transmission to send a Keep-Alive frame.
NIGHT MODE
•2Q2΍EXWWRQ %XWWRQ WRDFWLYDWHGHDFWLYDWH WKLVRSWLRQΖI LWLV QRW DFWLYHWKH IROORZLQJȴHOGV ZLOOQRWEH
H΍HFWLYH
•Duration: Night mode duration time.
•Start hour: Night Mode start hour.
•Sleep time: Sleep time between consecutive sensor measurements (during night mode).
•Keep-Alive: Elapsed time since last transmission to send a Keep-Alive frame (during night mode).
EXTRA CONFIGURATION
•Sensor Threshold: Threshold for detecting a vehicle over the parking slot.
•Battery readings per day: Battery readings per day.
•Daily frame: Enable/Disable daily frame sending.
RADIO MODE
•Radio mode: Radio transmission mode among Sigfox, LoRaWAN or their combinations.
LoRaWAN parameters
•LoRaWAN join mode: LoRaWAN join mode, ABP or OTAA.
•Device EUI: LoRaWAN device EUI.
•Device Address: LoRaWAN device address.
•Port: LoRaWAN port.
•Network Session Key: LoRaWAN network session key.
•Application Session Key: LoRaWAN application session key.
•Application Key: LoRaWAN application key.
•Application EUI: LoRaWAN application EUI.