Libelium Comunicaciones Distribuidas S L PARKING-V1 Wireless sensor node for Smart Parking (Internet of Things) User Manual 08 User manual v1

Libelium Comunicaciones Distribuidas S.L. Wireless sensor node for Smart Parking (Internet of Things) 08 User manual v1

User Manual

waspmotePlug & Sense! Smart ParkingTechnical Guide
-2- © Libelium Comunicaciones Distribuidas S.L.INDEX1. Introduction ......................................................................................................................................... 42. General  ................................................................................................................................................ 52.1. General and safety information ..............................................................................................................................................52.2. Conditions of use .........................................................................................................................................................................53. Hardware .............................................................................................................................................. 63.1. Hardware description .................................................................................................................................................................63.2. Power consumption ....................................................................................................................................................................64. How the node works ............................................................................................................................ 75. Sleep modes ......................................................................................................................................... 85.1. Day mode ........................................................................................................................................................................................85.2. Night mode ....................................................................................................................................................................................96. Transmission modes .......................................................................................................................... 107. Frames ................................................................................................................................................ 117.1. Firmware version v2.x.x ...........................................................................................................................................................117.1.1. Info frame ......................................................................................................................................................................117.1.2. Keep-Alive frame ........................................................................................................................................................127.1.3. Daily update frame ....................................................................................................................................................127.1.4. Error frame ....................................................................................................................................................................137.1.5. Start frames ..................................................................................................................................................................147.2. Firmware version v1.x.x ...........................................................................................................................................................157.2.1. Info frame ......................................................................................................................................................................157.2.2. Keep-Alive frame ........................................................................................................................................................167.2.3. Daily update frame ....................................................................................................................................................167.2.4. Error frame ....................................................................................................................................................................177.2.5. Start frames ..................................................................................................................................................................188. Smart Devices App ............................................................................................................................ 198.1. Installation ...................................................................................................................................................................................198.2. Smart Parking ............................................................................................................................................................................. 198.2.1. Programmer .................................................................................................................................................................198.2.2. Firmware upgrade ......................................................................................................................................................218.2.3. Conguration ...............................................................................................................................................................23Index
-3- 9. Callback Server .................................................................................................................................. 249.1. Installation ...................................................................................................................................................................................249.2. Deploying ....................................................................................................................................................................................259.3. Making the server accessible from anywhere ................................................................................................................269.4. Web form ......................................................................................................................................................................................269.5. How to extend the remote node conguration web application ...........................................................................2910. Developing the network ................................................................................................................. 3210.1. Application considerations .................................................................................................................................................3210.1.1. Deployment of the motes ....................................................................................................................................3210.1.2. Interference of other vehicles .............................................................................................................................3311. Device Installation ........................................................................................................................... 3411.1. Assembly and set up .............................................................................................................................................................3411.2. How to close the Smart Parking enclosure to keep the waterproof IP68 features .........................................3611.3. Installation and boot .............................................................................................................................................................3711.4. Conguring the parking nodes in the callback server ..............................................................................................4312. Services ............................................................................................................................................ 4412.1. Sigfox .......................................................................................................................................................................................... 4412.1.1. Device conguration ..............................................................................................................................................4412.1.2. Server conguration ...............................................................................................................................................4812.2. Loriot ........................................................................................................................................................................................... 4912.2.1. Device conguration ..............................................................................................................................................4912.2.2. Server conguration ...............................................................................................................................................5012.3. Start the web-socket connection .....................................................................................................................................5112.4. Actility .........................................................................................................................................................................................5212.4.1. Device conguration ..............................................................................................................................................5212.4.2. Server conguration ...............................................................................................................................................5512.5. Saving the information received .......................................................................................................................................5612.6. How to develop a new service ...........................................................................................................................................5613. Troubleshooting .............................................................................................................................. 6213.1. Windows does not recognize USB ports  ....................................................................................................................... 6213.2. How to know the port where the device is plugged in ............................................................................................6513.3. I cannot load nor save the conguration in the node ...............................................................................................6514. Certications .................................................................................................................................... 6614.1. USA Certication: .................................................................................................................................................................... 6615. Disposal and recycling .................................................................................................................... 67Index
-4-Introduction1. IntroductionThe 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 IDSmart Parking US XKM-PARKING-V1The 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-Hardware3. Hardware3.1. Hardware descriptionFigure : Plug & Sense! Smart ParkingPower supply Built-in Lithium batteries, expected lifetime of 4-6 years*Antenna IncludedDetection MagneticMounting 2YHUWKHȵRRUDimensions 230 mm diameter, 28 mm heightProtection  IP68  strictly  under  right  closing  (see  section  “Device installation”)Operating temperature -20 to +65 °C* Under normal circumstances and dependent on settingsFigure : Plug & Sense! Smart Parking main characteristics3.2. Power consumptionConsumptionMeasuring sensor TBDTransmission Sigfox TBDTransmission LoRaWAN TBDSleep state 25 µABattery self discharge < 1% month at +20 ºCBattery type Lithium non-rechargeable battery, 3.6 V, 10.4 A·hFigure : Plug & Sense! Smart Parking power consumption
-7-How the node works4. How the node worksFigure : Basic working loop diagramAs 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 modes5. Sleep modesPlug & 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ȴJXUDWLRQSleep time 1 minuteKeep-Alive 2 hoursNight Mode start hour 00 hoursNight Mode duration 6 hoursNight Mode Sleep Time 10 minutesNight Mode Keep-Alive 3 hoursFigure : ([DPSOHFRQȴJXUDWLRQFigure : Day and night modes example5.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 modes5.2. Night modeThis 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 modes6. Transmission modesPlug & 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-Frames7. Frames7.1. Firmware version v2.x.x3OXJ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 Description7 Parking slot status '0' indicates that the parking slot is empty'1' indicates that the slot is in occupied6 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.3Frame type0 – Info frame1 – Keep-Alive frame2 – Daily update frame3 – Error frame4 – Start frame 15 – Start frame 2Values from 6 to 15 are reservedValues from 6 to 15 are reserved210Figure : Byte 0 descriptionByte 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 frameIt 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 Description0 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 LSB5 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 LSB7 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 LSB9-10 Reserved Reserved bytes. Do not consider. Figure : Info frame structure
-12-Frames7.1.2. Keep-Alive frameThis frame is used to indicate that the parking slot has not changed, but the node is still working.Byte Name Description0 Basic data Detailed description in section “Frame”1 Frame counter Detailed description in section “Frame”2 Timestamp (hh) Current hours3 Timestamp (mm) Current minutes4 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 LSB7 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 LSB9 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 LSBFigure : Keep-Alive frame structure7.1.3. Daily update frameThis frame is sent daily at 1 AM. It contains a little summary.Byte Name Description0 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 LSB4 Sigfox transmissions MSB Unsigned 16 bit counter. It stores the times that Sigfox radio is used in the last 24 hours. 5 Sigfox transmissions LSB6 LoRaWAN transmissions MSB Unsigned 16 bit counter. It stores the times that LoRaWAN radio is used in the last 24 hours. 7 LoRaWAN transmissions LSB8 Resets Number of resets generated in the last 24 hours9&RQȴJBLG 9DOXHRIWKHFRQȴJXUDWLRQYHUVLRQORDGHGLQWRWKHQRGH10 Reserved Reserved bytes. Do not consider. Figure : Daily update frame structureThis 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-Frames7.1.4. Error frameIn some cases the node could send a frame if some internal components or processes fail.Byte Name Description0 Basic data Detailed description in section “Frame”1 Frame counter Detailed description in section “Frame”2 Error data Detailed description below3 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 LSB6 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 LSB8 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 LSB10 Battery level Battery voltage in millivolts. To convert to millivolts use the next formula: Figure : Error frame structureBit Name Description7-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-Frames7.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 1Byte Name Description0 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 LSB5 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 LSB7 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 LSB9 Battery voltage MSB Battery voltage in millivolts. The value stored in these two bytes is an unsigned 16-bit value. 10 Battery voltage LSBFigure : Start frame number 1 structure7.1.5.2. Start frame number 2Byte Name Description0 Basic data Detailed description in section “Frame”1 Frame counter Detailed description in section “Frame”2)Ζ50:$5(B9(56Ζ21 Firmware version310B67$57 Beginning hour of the night mode410B3(5Ζ2' Duration in hours of the night mode510B6/((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 combinations86/((3B7Ζ0( Sleep time between consecutive sensor measurements9.((3B$/Ζ9( Elapsed time since last transmission to trigger a Keep-Alive frame10 THRESHOLD Threshold for detecting a vehicle over the parking slotFigure : Start frame number 2 structure
-15-Frames7.2. Firmware version v1.x.x3OXJ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 Description7 Parking slot status '0' indicates that the parking slot is empty'1' indicates that the slot is in occupied6 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. 3Frame type0 – Info frame1 – Keep-Alive frame2 – Daily update frame3 – Error frame4 – Start frame 15 – Start frame 2Values from 6 to 15 are reserved210Figure : Byte 0 description7.2.1. Info frameIt 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 Description0 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 LSB4 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 LSB6 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 LSB8 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 LSB10-11 Reserved Reserved bytes. Do not consider. Figure : Info frame structure
-16-Frames7.2.2. Keep-Alive frameThis frame is used to indicate that the parking slot has not changed, but the node is still working.Byte Name Description0 Basic data Detailed description in section “Frame”1 Frame counter Detailed description in section “Frame”2 Timestamp (hh) Current hours3 Timestamp (mm) Current minutes4 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 LSB6 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 LSB8 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 LSB10 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 LSBFigure : Keep-Alive frame structure7.2.3. Daily update frameThis frame is sent daily at 1 AM. It contains a little summary.Byte Name Description0 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 LSB4 Sigfox transmissions MSB Unsigned 16 bit counter. It stores the times that Sigfox radio is used in the last 24 hours. 5 Sigfox transmissions LSB6 LoRaWAN transmissions MSB Unsigned 16 bit counter. It stores the times that LoRaWAN radio is used in the last 24 hours. 7 LoRaWAN transmissions LSB8 Resets Number of resets generated in the last 24 hours9&RQȴJBLG 9DOXHRIWKHFRQȴJXUDWLRQYHUVLRQORDGHGLQWRWKHQRGH10-11 Reserved Reserved bytes. Do not consider. Figure : Daily update frame structureThis 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-Frames7.2.4. Error frameIn some cases the node could send a frame if some internal components or processes fail.Byte Name Description0 Basic data Detailed description in section “Frame”1 Frame counter Detailed description in section “Frame”2 Error data Detailed description below3 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 LSB5X 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 LSB7Y 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 LSB9Z 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 LSB11 Battery level Battery voltage in millivolts. To convert to millivolts use the next formula:Figure : Error frame structureBit Name Description7-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-Frames7.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 1Byte Name Description0 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 LSB4 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 LSB6 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 LSB8 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 LSB10 Battery voltage MSB Battery voltage in millivolts. The value stored in these two bytes is an unsigned 16-bit value. 11 Battery voltage LSBFigure : Start frame number 1 structure7.2.5.2. Start frame number 2Bit Name Description0 Basic data Detailed description in section “Frame”1 Frame counter Detailed description in section “Frame”2&2'(BΖ' Firmware version310B67$57 Beginning hour of the night mode410B3(5Ζ2' Duration in hours of the night mode510B6/((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 combinations86/((3B7Ζ0( Sleep time between consecutive sensor measurements9.((3B$/Ζ9( Elapsed time since last transmission to trigger a Keep-Alive frame10 THRESHOLD Threshold for detecting a vehicle over the parking slot11 Reserved Reserved byte. Do not consider. Figure : Start frame number 2 structure
-19-Smart Devices App8. 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. InstallationFirst 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.htmlOnce 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.zip7KHQ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 ParkingThis section provides several options to Smart Parking users in order to take full advantage of all possibilities the GHYLFHVR΍HUV8.2.1. ProgrammerFigure : 6PDUW3DUNLQJFRQȴJXUDWLRQIRUP
-20-Smart Devices App8VHUV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.
-21-Smart Devices AppSigfox ID: Sigfox ID that will be loaded from the device. •LoRaWAN EUI: LoRaWAN EUI that will be loaded from the device.USB SETTINGS •USB Port: In this list will be displayed all available USB ports to work out with the device. If you plug your device and the port is not listed, you have click on “Refresh” button in order to update the list.Figure : /RDGFRQȴJXUDWLRQIURPQRGH6HQGFRQȴJXUDWLRQWRQRGHEXWWRQVThe “Load from node” button will read all parameters from the node and will display the information in the form. 2QWKHRWKHUKDQGWKHȊ6HQGWRQRGHȋEXWWRQZLOORYHUZULWHWKHFRQȴJXUDWLRQLQWKHQRGH$OODYDLODEOHȴHOGVKDYHWREHȴOOHGZLWKWKHSURSHUIRUPDWΖIDQ\SDUDPHWHUGRHVQRWKDYHDQDFFHSWDEOHIRUPDWDUHGFURVVOLNHWKLV  will be displayed near it and you cannot write the information in the node. If the information introduced is valid, a green tick yeyeyeyeye will be shown.8.2.2. Firmware upgradeΖQWKLVWDEXVHUVFDQVHOHFWWKHȴUPZDUHYHUVLRQWRLQVWDOOLQWKHLUGHYLFHVFigure : 6PDUW3DUNLQJȴUPZDUHXSJUDGHIRUP
-22-Smart Devices App7KHOLVWZLWKDOODYDLODEOHȴUPZDUHLVORDGHGZKHQWKHSURJUDPVWDUWVEXWXVHUVFDQXSGDWHLWRQGHPDQGFOLFNLQJRQ Ȋ6HDUFK QHZ ȴUPZDUH XSGDWHVȋ EXWWRQ %HIRUH LQVWDOOLQJ WKH ȴUPZDUH LW LV QHFHVVDU\ WR GRZQORDG LW 7KLVprocess is very simple, just mark the check of the version you want to install from the list   and click on “Download checked” button. Figure : 'RZQORDGWKHȴUPZDUHVHOHFWHGWhen this item is downloaded, a disk will be displayed near it  LQGLFDWLQJLWLVGRZQORDGHG2QFHWKHȴUPZDUHLVdownloaded, it is ready to install using the “Install Firmware” section at the bottom. In the drop-down will appear all downloaded versions. Select one and then hit on “Install” button. Figure : ΖQVWDOOWKHȴUPZDUHVHOHFWHG<RXFDQDOVRGHOHWHWKHGRZQORDGHGȴUPZDUHPDUNLQJWKHFKHFNIURPWKHOLVW  and then clicking on “Delete checked” button. Figure : 'HOHWHGRZQORDGHGȴUPZDUHRemember that the USB port must be selected in the programmer tab.
-23-Smart Devices App8.2.3. &RQȴJXUDWLRQΖQWKHODVWWDEȊ&RQȴJXUDWLRQȋDOOH[WHUQDOSDUDPHWHUVWKDWWKHVRIWZDUHXVHVWRZRUNZLOOEHGLVSOD\HG8VHUVFDQmodify these values in order to get the wished application behavior. In this case, there is only one parameter available, the API key to connect to Libelium Cloud. This value is provided by Libelium and it is very important to control the access and get some results needed in the programmer tab. If XVHUVGRQRWȴOOWKLVȴHOGWKHVRIWZDUHGRHVQRWZRUNFigure : 6PDUW3DUNLQJFRQȴJXUDWLRQIRUP
-24-Callback Server9. Callback ServerSigfox  and  LoRaWAN  callback  service  requirements  include  a  server  with  a  web  application  up  and  running, this web application will receive Sigfox and LoRaWAN requests. Sigfox and LoRaWAN callback service will relay messages via POST/GET requests to your web application running in your server./LEHOLXP SURYLGHV WKH VRXUFH ȴOHV RI D VLPSOH ZHE DSSOLFDWLRQ WR GHSOR\ LQ \RXU VHUYHU 7KLV UHPRWH QRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQSURYLGHGE\/LEHOLXPZLOOUHFHLYH6LJIR[DQG/R5D:$1UHTXHVWVVHQGLQJDUHVSRQVHEDFNZLWKWKH6PDUW3DUNLQJQRGHFRQȴJXUDWLRQ7KHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQLQFOXGHVDVLPSOHZHEIRUPWRPDQDJHWKHFRQȴJXUDWLRQYDOXHVof the Smart Parking nodes, and a background process to deal with the Sigfox and LoRaWAN callback services UHTXHVWV7KHEDFNJURXQGSURFHVVZLOOGHOLYHUWKHSURSHUUHSOLHVZLWKWKHFRQȴJXUDWLRQYDOXHVIRUHDFKUDGLRΖ'previously stored using the web form.7KHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQVKRXOGEHGHSOR\HGLQ\RXUVHUYHUDQGWKHFDOOEDFNVHUYLFHVPXVWEHFRQȴJXUHGZLWKWKHFRPSOHWH85/FRQWDLQLQJ\RXUVHUYHUGRPDLQQDPHRUΖ3DQGWKHFRQWH[WSRLQWLQJWRWKHweb app deployment path.Example URL: https://my_server.com/path/zip/extractedNOTE: Customers have to ask for this source code to Libelium Sales Department after buying the nodes.9.1. Installation$VVLJQLQJDSXEOLFΖ3DQGDUHJLVWHUHGGRPDLQQDPHWRWKHVHUYHULVUHFRPPHQGHGWRHDVHWKHWDVNRIFRQȴJXULQJSigfox and LoRaWAN callback services to send HTTP/HTTPS requests to this server. It is also a good practice to LPSOHPHQWH[LVWLQJVHFXULW\SROLFLHVXVHUFUHGHQWLDOV66/ȴUHZDOODQGWRROVWRDYRLG'R6DWWDFNVIRUVHUYHUVZLWKopen ports to Intermet.  $SDFKHZHEVHUYHUZLWK3+3VXSSRUWPXVWEHFRQȴJXUHGLQ\RXUVHUYHUWKRVHDUHWKHPLQLPXQUHTXLUHPHQWVWRGHSOR\WKHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQ/LEUDULHVIRU'DWDEDVHV0\64/3RVWJUH64/DUHRSWLRQDOWKHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQVDYHVWKH6PDUW3DUNLQJFRQȴJXUDWLRQYDOXHVLQWH[WȴOHVEXWFRXOGbe extended to implement connections to any other DB storage.Info and tutorials about installation of minimun requirements in your server: •Ubuntu: https://help.ubuntu.com/community/ApacheMySQLPHP •Windows: http://www.ampsoft.net/webdesign-l/how-to-install-apache-php-mysql.html •Mac: http://jason.pureconcepts.net/2012/10/install-apache-php-mysql-mac-os-x/Loriot LoRaWAN callback service has extra requirements, Node.js and NPM libraries are needed: •Ubuntu: http://www.hostingadvice.com/how-to/install-nodejs-ubuntu-14-04/ •Windows: http://blog.teamtreehouse.com/install-node-js-npm-windows •Mac: http://shapeshed.com/setting-up-nodejs-and-npm-on-mac-osx/
-25-Callback Server9.2. Deploying6WHS([WUDFWLQ\RXUVHUYHUWKH=Ζ3ȴOHSURYLGHGE\/LEHOLXPFRQWDLQLQJWKHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQVRXUFHȴOHV6WHS&KHFNWKHULJKWRZQHUJURXSDQGSHUPLVVLRQVRIDOOWKHȴOHVH[WUDFWHGXVXDOO\XVLQJZZZGDWDJURXSLVdefault in Ubuntu environment. 6WHS&KHFNWKHSHUPLVVLRQVRIDOOIROGHUVDQGȴOHVXVXDOO\XVLQJIRUGLUHFWRULHVDQGIRUȴOHVLVGHIDXOWin Ubuntu environment. 6WHS&RQȴJXUHWKHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQFRQWH[WLQ\RXUVHUYHUZLWKWKHSDWKZKHUHWKHVRXUFHȴOHVZHUHH[WUDFWHG([DPSOHFRQȴJXUDWLRQIRUDVHUYHUUXQQLQJ8EXQWXRSHUDWLQJV\VWHPDQG$SDFKHZHEVHUYHU&UHDWHDQHZFRQȴJXUDWLRQȴOHP\BVHUYHUFRQILQHWFDSDFKHVLWHVDYDLODEOHGLUHFWRU\P\BVHUYHUFRQIH[DPSOHȴOHUHSODFHSDWKVWRPDWFK\RXUVHUYHUGHSOR\PHQWORFDWLRQV<VirtualHost *:80>        ServerAdmin webmaster@localhost        ServerName my_server.com        ServerAlias my_server.com        DirectoryIndex index.html index.php        DocumentRoot /path/zip/extracted        ErrorLog ${APACHE_LOG_DIR}/error.log        CustomLog ${APACHE_LOG_DIR}/access.log combined        <Directory /path/zip/extracted>                Options Indexes FollowSymLinks                AllowOverride All                Require all granted        </Directory></VirtualHost>6WHSΖVPDQGDWRU\WRZULWHWKHFXVWRPHUȇV$3Ζ.(<LQWKHVHUYHUFRQȴJXUDWLRQȴOHDYDOLG$3Ζ.(<ZLOOEHSURYLGHGby your Libelium sales representative. ΖIWKHȊDSLNH\ȋSDUDPHWHULVQRWSURSHUO\FRQȴJXUHGWKHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQZLOOQRWZRUN7KHVHUYHUFRQȴJXUDWLRQȴOHLVORFDWHGLQdata/app.iniLQVLGHWKHIROGHUZKHUHWKHFXVWRPHUH[WUDFWHGWKH]LSȴOHLQ6WHS7KHSDWWHUQRIWKLVȴOHLV[app]VHUYHU ߙKWWSVDSLOLEHOLXPFRPVPDUWSDUNLQJFRQࢱJSKSߚDSLNH\ ߙߚserver:85/WRUHPRWHQRGHFRQȴJXUDWLRQVHUYLFHKRVWHGLQ/LEHOLXPȇVVHUYHUVapikey: unique API KEY provided by Libelium to identify the customer, must be double quoted. 6WHS(QDEOHWKLVQHZFRQȴJXUDWLRQVLWHFUHDWHGDQGUHVWDUWWKH$SDFKHVHUYHUXVXDOO\WKHFRPPDQGȊDHQVLWHP\BVHUYHUȋZLOOGRWKHWDVNLQ8EXQWXHQYLURQPHQW$ JRRG GDWH DQG WLPH VHUYHU FRQȴJXUDWLRQ LV UHFRPPHQGHG LQ RUGHU WR JXDUDQWHH WKH GDWD LQWHJULW\ RIthe  information  sent  to  the  Smart  Parking  nodes,using  an  NTP  server  to  keep  the  clock  system  up  to  date  is recommended.
-26-Callback Server9.3. Making the server accessible from anywhereCompulsory for Sigfox and Actility platforms.Optimal  deployment  includes  a  server  name  pointing  to  a  public  and  static  IP,  using  dynamic  DNS  could be  done  with  services  like  no-ip  which  has  a  free  package  http://www.noip.com/.  No-ip  has  also  a  client application  responsible  for  updating  any  IP  address  changes  in  the  background,  more  information  in:  http://www.noip.com/download)LQDOO\WKH85/WRFRQȴJXUHWKH6LJIR[DQG/R5D:$1SODWIRUPVWRVHQGWKHFDOOEDFNUHTXHVWWRZLOOEHFRQIRUPHGwith the server name and the paths:https://my_server.com/path/zip/extracted/9.4. Web form7KHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQSUHYLRXVO\GHSOR\HGLQ\RXUVHUYHUSXEOLVKHVDZHEIRUPDYDLODEOHin the URL (http://my_server.com/HVWDEOLVKHGLQWKHZHEVHUYHUFRQȴJXUDWLRQȴOH7KHZHEIRUPLVXVHGWRPDQDJHWKHFRQȴJXUDWLRQYDOXHVIRUHYHU\VLQJOH6PDUW3DUNLQJQRGH8VLQJWKHZHEIRUPWKHUHPRWHFRQȴJXUDWLRQZHEDSSOLFDWLRQZLOOVDYHDELQDU\ȴOHVWRULQJWKHFRQȴJXUDWLRQYDOXHVIRUWKH6PDUW3DUNLQJQRGHLGHQWLȴHGZLWKWKHserial ID:Figure : /LEHOLXP&DOOEDFN&RQȴJXUDWRUVFUHHQVKRW'HVFULSWLRQRIDOOWKHZHEIRUPȴHOGVDEVICE •ID: Device ID of the node. In each platform section we explain how to get this parameter. Note: Several ID may EHZULWWHQVHSDUDWHGE\VHPLFRORQVȊȋ([DPSOH)WRVWRUHLGHQWLFDOFRQȴJXUDWLRQIRUmany Smart Parking nodes at once. •Name$QDPHDVVRFLDWHGWRWKHGHYLFHΖ'WRPDNHHDVLHUIRU\RXWKHLGHQWLȴFDWLRQRIWKHQRGH
-27-Callback ServerTIME SETTINGS •Sleep time: Sleep time between consecutive sensor measurements. •Keep-Alive: Elapsed time since last transmission to send a Keep-Alive frame.NIGHT MODE •Enabled: %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. •Reset request: Enable/Disable the reset when a vehicle abandon the parking slot. •&RQȴJXUDWLRQYHUVLRQ&RGHYHUVLRQLGHQWLȴHURADIO MODE •Radio mode: Radio transmission mode among Sigfox, LoRaWAN or their combinations. •LoRaWAN join mode: LoRaWAN join mode, ABP or OTAA.(DFK6PDUW3DUNLQJQRGHKDVEHHQDVVLJQHGZLWKWZRGL΍HUHQWUDGLRΖ'RQHXQLTXHΖ'IRUWKH6LJIR[UDGLRDQGDGL΍HUHQWΖ'IRUWKH/R5D:$1UDGLR8VLQJWKHZHEIRUPDELQDU\YDOXHZLWKWKHFRQȴJXUDWLRQSDUDPHWHUVZLOOEHstored internally for every radio ID. Users can create or update the information of every device.&UHDWH QHZ FRQȴJXUDWLRQ 7\SH LQ WKH Ζ' ȴHOG RI WKH '(9Ζ&( VHFWLRQ WKH QHZ Ζ' YDOXH DVVLJQHG WR WKH 6PDUW3DUNLQJQRGHWRFRQȴJXUH&RQȴJXUHDOOSDUDPHWHUVSURSHUO\8SGDWHH[LVWLQJFRQȴJXUDWLRQ3LFNIURPWKHΖ'OLVWWKHQRGHΖ'WRXSGDWHDOOSDUDPHWHUVSUHYLRXVO\VDYHGZLOOEHORDGHGLQWKHIRUPRUW\SHLWLQWKHΖ'ȴHOGRIWKH'(9Ζ&(VHFWLRQ1DPHȴHOGVZLWKRQHVZKLFKGRQRWH[LVWZKHQWKHLQIRUPDWLRQLVVDYHGLWZLOOEHFUHDWHGΖIWKHGHYLFHΖ'H[LVWVLWZLOOEHXSGDWHGOLNHLI\RXVHOHFWWKHGHYLFHIURPWKHOLVW&RQȴJXUHDOOSDUDPHWHUVSURSHUO\&OLFNRQȊ6DYHFRQȴJXUDWLRQȋDEDFNJURXQGSURFHGXUHZLOOVWDUWWRVDYHDOOLQIRUPDWLRQQHHGHGWRJHQHUDWHDYDOLGanswer to the node.Figure : Device creation detail
-28-Callback ServerNote: Sigfox and LoRaWAN radios unique ID must be known previously to use the web form. There are several ways those unique ID are provided. Additionally the Libelium Smart Devices App can be used to read those ID YDOXHVGLUHFWO\IURPWKH6PDUW3DUNLQJQRGHWKHΖ'QHHGHGWRFUHDWHFRQȴJXUDWLRQYDOXHVXVLQJWKHZHEIRUPDUHpointed in the following picture: Figure : Device IDs read from the Smart Devices App&UHDWLQJFRQȴJXUDWLRQYDOXHVIRUWKHUDGLRΖ'RIWKH6PDUW3DUNLQJQRGHVXVLQJWKHZHEIRUPHQDEOHVWKHUHPRWHFRQȴJXUDWLRQ ZHE DSS WR PRGLI\ VRPH SDUDPHWHUV RI WKH 6PDUW 3DUNLQJ QRGHV DV WKH 6PDUW -DYD $SS GRHVUsing the Smart Java App requires physical access to the Smart Parking node, the node must be attached to the FRPSXWHUXVLQJD86%FDEOH8VLQJWKHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSZLOOPRGLI\WKH6PDUW3DUNLQJQRGHbehavior remotely.All  Smart  Parking  nodes  will  synchronize  date  and  time  with  the  server  (NTP  recommended  as  commented previously in this chapter) in any case, no matter that a valid binary value has not been previously stored for the radio ID.5HPRWHQRGHFRQȴJXUDWLRQZHEDSS PDQDJH WKUHHGL΍HUHQWUHTXHVWWR JHQHUDWH WKHSURSHUDQVZHUWRWKHPZKHQDPHVVDJHLVUHFHLYHGDYDOLGELQDU\YDOXHLVUHTXLUHGWREHFRQȴJXUHGIRUWKHUDGLRVRIWKH6PDUW3DUNLQJQRGH&RQȴJXULQJDOOWKH6PDUW3DUNLQJQRGHVXVLQJWKHZHEIRUPLVUHFRPPHQGHGWRJHWWKHPRVWRIWKHUHPRWHFRQȴJXUDWLRQZHEDSSOLFDWLRQ'HVFULSWLRQRIWKHGL΍HUHQWUHTXHVW •Response  to  the  Start  Frame  number  1,  transmitted  by  the  node  in  the  activation  process.  This  response frame allows the initial time synchronization of the internal clock. In normal conditions, the activation process happens only once.  •Response to the Daily Update Frame with a timestamp, in order to perform a time synchronization  of  the internal clock. This will happen once per day and helps to keep the node’s time drift to minimum.  •5HVSRQVHWRWKH'DLO\8SGDWH)UDPHZLWKDQHZFRQȴJXUDWLRQIRUWKHQRGH7KLVZLOOKDSSHQYHU\IHZWLPHVDFKDQJHLQWKH6PDUW3DUNLQJQRGHFRQȴJXUDWLRQZLOORQO\KDSSHQZKHQWKHDGPLQLVWUDWRURIWKHQHWZRUNGHFLGHVWRFKDQJHWKHLQLWLDOFRQȴJXUDWLRQSDUDPHWHUVORDGHGYLDWKH86%3URJUDPPHU
-29-Callback Server9.5. +RZWRH[WHQGWKHUHPRWHQRGHFRQȴJXUDWLRQZHEapplication/LEHOLXPSURYLGHVWRXVHUVDVLPSOHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQWRPRGLI\UHPRWHO\WKHEHKDYLRURIWKH6PDUW3DUNLQJQRGHV7KHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQLQFOXGHVDZHEIRUPWRPDQDJHWKHFRQȴJXUDWLRQYDOXHVDVVRFLDWHGWRWKHUDGLRΖ'RIWKH6PDUW3DUNLQJQRGHDQGDEDFNJURXQGSURFHVVWRGHDOZLWKWKH6LJIR[DQG/R5D:$1&DOOEDFNVHUYLFHVUHTXHVWVGHOLYHULQJWKHSURSHUUHSOLHVZLWKWKHFRQȴJXUDWLRQYDOXHVpreviously stored using the web form.The background process could be improved, or totally recoded using other programming languages, sharing with WKHZHEIRUPWKHUDGLRFRQȴJXUDWLRQV6RPHQHZIHDWXUHVWKDWFRXOGEHLPSOHPHQWHGE\XVHUVDUHWRVDYHWKHnode information in a database, grouping the nodes in zones, adding user credentials, etc.For improvements on the web form, it is important to pay special attention to the endpoints described in this VHFWLRQWRJHWWKHH[SHFWHGUHVSRQVHFRQWDLQLQJWKHFRQȴJXUDWLRQPHVVDJHWKDWZLOOEHVHQWWRWKHQRGHV6WRUDJHRIWKHFRQȴJXUDWLRQYDOXHVPXVWEHVKDUHGZLWKWKHEDFNJURXQGSURFHVVFigure : Backend working diagram:KHQDQRGHFRQȴJXUDWLRQLVVDYHGXVLQJWKHZHEIRUPDOOWKHYDOXHVRIWKHȴHOGVDUHVWRUHGLQWKHFRQȴJXUDWLRQLQLȴOH7KHZHEIRUPZLOOUHFRYHUWKHPLIWKHGHYLFHLVVHOHFWHGDJDLQIURPWKHΖ'OLVW7KHZHEIRUPDOVRPDNHVDFDOOWRWKH/LEHOLXP$3ΖZLWKDOOWKHYDOXHVRIWKHSDUDPHWHUVWKHUHVSRQVHLVVDYHGLQWKHUHVSRQVHVLQLȴOHEndpoints description:endpointhttps://api.libelium.com/smartparking/cong.phpmethodPOSTheaderkey Authorizationvalue “Bearer “ + <APIKEY>The <APIKEY> provided in order to protect the system and control the accessbodykey NODE_TYPEvalue ߙ3DUNLQJߚ TextDescription Kind of node to be used. Manual value>ߙ3DUNLQJߚ@$SSȴHOG -App values -
-30-Callback Serverkey BAT_READINGvalue [0-7] TextDescription Number of daily battery level checking$SSȴHOG ([WUDFRQȴJXUDWLRQ%DWWHU\FKHFNLQJSHUGD\App values [0 = 1 | 1 = 2 | 2 = 3 | 3 = 4 | 4 = 5 | 5 = 6 | 6 = 7 | 7 = 8]key RADIO_MODEvalue [0-4] TextDescription Selected transmission mode$SSȴHOG 5DGLRFRQȴJXUDWLRQ5DGLRPRGHApp values > 6LJIR[_ /R5D:$1_ 6LJIR[/R5D:$1_ 6LJIR[ࠥ/R5D:$1_ /R5D:$1ࠥ6LJIR[@key THRESHOLDvalue [0-255] TextDescription Threshold for detecting a vehicle over the parking slot$SSȴHOG ([WUDFRQȴJXUDWLRQ6HQVRUWKUHVKROGApp values [0 = 1| 1 = 2 | 2 = 3 | 3 = 4 | 4 = 5 | … | 255 - 256]key SLEEP_TIMEvalue [0-31] TextDescription Sleep time between consecutive sensor measurements$SSȴHOG Time Settings - Sleep timeApp values[0 = 1m | 1 = 2m | 2 = 3m | 3 = 4m | 4 = 5m | 5 = 10m | 6 = 15m | 7 = 20m | 8 = 30m | 9 = 1h | 10 = 2h | 11 = 3h | 12 = 4h | 13 = 5h | 14 = 6h | 15 = 7h | 16 = 8h | 17 = 9h | 18 = 10h | 19 = 11h | 20 = 12h | 21 = 13h | 22 = 14h | 23 = 15h | 24 = 16h | 25 = 17h | 26 = 18h | 27 = 19h | 28 = 20h | 29 = 21h | 30 = 22h | 31 = 24h]m = minutesh = hourskey KEEP_ALIVEvalue [0-15] TextDescription Elapsed time since last transmission to send a Keep-Alive frame$SSȴHOG Time Settings - Keep-AliveApp values[0 = 0h | 1 = 0.5h | 2 = 1h | 3 = 2h | 4 = 3h | 5 = 4h | 6 = 5h | 7 = 6h | 8 = 8h | 9 = 10h | 10 = 12h | 11 = 14h | 12 = 16h | 13 = 18h | 14 = 20h | 15 = 24h]h = hourskey NM_STARTvalue [0-23] TextDescription Beginning hour of the night mode$SSȴHOG Night mode – Start hourApp values[0 = 0h | 1 = 1h | 2 = 2h | 3 = 3h | 4 = 4h | 5 = 5h | 6 = 6h | 7 = 7h | 8 = 8h | 9 = 9h | 10 = 10h | 11 = 11h | 12 = 12h | 13 = 13h | 14 = 14h | 15 = 15h | 16 = 16h | 17 = 17h | 18 = 18h | 19 = 19h | 20 = 20h | 21 = 21h | 22 = 22h | 23 = 23h]h = hours
-31-Callback Serverkey NM_PERIODvalue [0-15] TextDescription Night mode duration time$SSȴHOG Night mode - DurationApp values[0 = 0h | 1 = 1h | 2 = 2h | 3 = 3h | 4 = 4h | 5 = 5h | 6 = 6h | 7 = 7h | 8 = 8h | 9 = 9h | 10 = 10h | 11 = 11h | 12 = 12h | 13 = 13h | 14 = 14h | 15 = 15h]h = hourskey NM_SLEEP_TIMEvalue [0-15] TextDescription Sleep time between consecutive sensor measurements (during night mode)$SSȴHOG Night mode – Sleep timeApp values[0 = 2m | 1 = 5m | 2 = 10m | 3 = 15m | 4 = 20m | 5 = 30m | 6 = 1h | 7 = 2h | 8 = 3h | 9 = 4h | 10 = 5h | 11 = 6h | 12 = 8h | 13 = 10h | 14 = 12h | 15 = 14h]m = minutesh = hourskey NM_KEEP_ALIVEvalue [0-15] TextDescription Elapsed time since last transmission to send a Keep-Alive frame (during night mode)$SSȴHOG Night mode – Sleep timeApp values[0 = 0h | 1 = 1h | 2 = 2h | 3 = 3h | 4 = 4h | 5 = 5h | 6 = 6h | 7 = 7h | 8 = 8h | 9 = 9h | 10 = 10h | 11 = 11h | 12 = 12h | 13 = 13h | 14 = 14h | 15 = 15h]h = hourskey CONFIG_IDvalue [1-255] TextDescription 9HUVLRQQXPEHURIWKHFRQȴJXUDWLRQ$SSȴHOG ([WUDFRQȴJXUDWLRQȂ&RQȴJXUDWLRQYHUVLRQApp values [1-255]responseUsers will receive a JSON string with these possibilities:{ߙHUURUߚ7H[W}Error received from the API system validation. text contains the error detail.{ߙVWDWXVߚ>2._12.@ߙGDWDߚ7H[W}Information received after all values have been evaluated. NOK status includes in data the error detail. OK status includes in data the string to be saved in GDWDFRQࢱJXUDWLRQ.LQLȴOHDVVRFLDWHGWRWKHdevice ID provided.
-32-Developing the network10. Developing the network10.1. Application considerations10.1.1. Deployment of the motesThe optimum deployment point will be the one where the probability of detection is maximum, which means minimizing the probabilities of false detection (caused by other vehicles or objects near the lot under control) and IDOVHUHMHFWLRQRZHGWRDQRWKLJKHQRXJKYDULDWLRQLQWKHPDJQHWLFȴHOGDERYHWKHPRWHZLWKDYHKLFOHSDUNHGLQthe spot).This optimum deployment spot will depend on the kind of parking lot that we are going to monitor. In the case of SDUDOOHOSDUNLQJORWVWKHPRWHVKRXOGEHGHSOR\HGEHORZRQHRIWKHFDUVLGHVDVVKRZQLQȴJXUHEHORZZKLOHIRUperpendicular parking spots the most adequate place will be the one nearest to the center of the motor or the backside of the vehicle.Figure : Diagram of the deployment points of the motes for parallel parking lots
-33-Developing the networkFigure : Diagram of the deployment points of the motes for perpendicular parking lotsFigure :  Placement options of the motes for parallel parking lots Figure : Placement options of the motes for perpendicular parking lotsOther consideration to be taken into account in mote deployment is the communication between this one and the gateway or router that will receive the data and process or redirect it. This is a very variable issue that will have to be analyzed independently for each scenario.10.1.2. Interference of other vehiclesAs pointed in the section “Deployment of the motes”, the presence of other vehicles in contiguous spots or near SODFHVPD\LQȵXHQFHLQWKHGHWHFWLRQPRGLI\LQJWKHGHWHFWLRQWKUHVKROG7KLVLQȵXHQFHHDUQVVSHFLDOLPSRUWDQFHin perpendicular lots, where the distance between the mote and the contiguous vehicles is shortest, and in the non-delimited parallel lots. The best way to avoid this disturbance is to take into account the state of the near VSRWVLQWKHGHWHFWLRQGHFLVLRQZKHQWKHYDULDWLRQLQWKHPDJQHWLFȴHOGLVYHU\FORVHWRWKHGHWHFWLRQWKUHVKROG
-34-Device Installation11. Device InstallationImportant:  Before  deploying  the  nodes  on  the  street,  make  sure  that  enough  tests  have  been  performed  in order to achieve a 100% functional network and that all the necessary information related to the mote, such as LGHQWLȴFDWLRQQXPEHUVRIWKHUDGLRVKDVEHHQFRPSLOHGDQGVWRUHGVLQFHRQFHWKHPRWHLVLQVWDOOHGWKHDFFHVVwill be very limited. 11.1. Assembly and set upStep  1:  Connect  the  USB  Programmer  to  the  node.  Please  note  that  an  inadequate  connection  of  the  USB Programmer can damage the node.Figure : Plug & Sense! Smart Parking with the USB Programmer tool connected Step 2:2QFHWKHSDUDPHWHUVKDYHEHHQFRQȴJXUHGDQGWKH86%SRUWVHOHFWHGLQWKH3OXJ6HQVH6PDUW3DUNLQJ3URJUDPPHUWXUQRQWKHQRGHDQGVHQGWKHFRQȴJXUDWLRQZLWKWKHEXWWRQȊ6HQGWRQRGHȋΖIWKHQRGHKDVEHHQprogrammed successfully, the next message will be shown.Figure : &RQȴJXUDWLRQVXFFHVVIXOO\SURJUDPPHG
-35-Device InstallationStep 3:1RZWKHQRGHLVFRQȴJXUHG7XUQR΍WKHQRGHFigure : Battery connectionStep 4:%HIRUHFORVLQJWKHHQFORVXUHWKHQRGHPXVWEHSRZHUHGRQΖWLVPDQGDWRU\WKDWWKHQRGHLVSRZHUHGR΍before this step. The node blinks the onboard red LED (1 second) and it will go to deepsleep state. In this state the node must not be reset with the magnetic switch before the node is deployed. If it is reseted, the node starts to work and will send frames, generating an unwanted consumption. Besides, the node would perform the calibration process before it is in the real location.Figure : LEDs blinkingStep 5: Now, the node can be closed. It is ready to deploy.
-36-Device Installation11.2. How to close the Smart Parking enclosure to keep the waterproof IP68 featuresIn order to close the node correctly and ensure correct sealing, the following steps must be strictly followed.Step 1: Make sure that the screws have the o-rings to prevent water ingress.Figure : Screws with o-ringStep 2: Ensure that the top surface of the gasket is clean and contains no foreign objects. Step 3: Place the inner casing inside the outer casing and make sure that the two position marks match.Figure : Enclosure position marks
-37-Device InstallationStep 4: Insert the screws and tighten them halfwayFigure : Screws in their positionStep 5:)LQDOO\WLJKWHQWKHIRXUVFUHZVȴUPO\'RQRWXVHWKHPD[LPXPSUHVVXUHGRQRWJRDOOWKHZD\ZLWKWKHscrews), because the o-rings could be ejected from the screws, and then the waterproof feature would NOT be valid. Besides, do not screw too hard and keep on screwing, because the screws could carve the female sockets, expanding their inner diameter; this would cancel the waterproof quality too.11.3. Installation and bootStep 1:ΖQGLFDWHWKHKROHVLQWKHDVSKDOW6HOHFWDQDUHDDVȵDWDQGUHJXODUDVSRVVLEOHDYRLGLUUHJXODULWLHVLQWKHWHUUDLQ<RXVKRXOGSODFHWKHHQFORVXUHLQWKHȴQDOORFDWLRQDQGXVHWKHKROHVDVDUHIHUHQFHWRGULOOOLWWOHPDUNVin the ground. You can also draw 4 dots with ink. Figure : Indicating the holes for the node
-38-Device InstallationStep 2: Drill the holes. Warning: The drill diameter must be 10 mm maximum to prevent the anchor from rotating freely in the hole. Try to drill as vertical as possible, to enable the best enclosure installation. The length of the hole must be about 42 mm. It is important to know that the screw will only penetrate to half of the length of the anchor, so there must be a distance of 12 mm or more between the ground surface and the top of the anchor. You can experience with slightly deeper holes because the screw does not need to be fully screwed inside the anchor: depths of 45-50 mm could work too. Remove all the dust and little rocks inside the 4 holes, created during the drilling operation. This is important to allow the anchors go all the way down. You can clean each hole mechanically and then use a bottle of spray duster (high-pressure air bottle). Make sure that the real depth of the hole is enough. Figure : Drilling the holesFigure : Section of the hole
-39-Device InstallationStep 3:6HWWLQJDQFKRUV7KHDQFKRUVXVHGWRȴ[WKH3OXJ6HQVH6PDUW3DUNLQJDUHPHWDOOLFH[SDQVLRQDQFKRUVThe anchoring mechanism of these anchors is based on the expansion of the metal body against the base material. This expansion occurs when the expansion cylinder is propelled down, hitting on a punch with a hammer. First, insert the anchors in the holes and take them all the way down. For that, you can use a hammer and punch of 9 mm in diameter. You can also use a sharper punch to hit on the top circle of the anchor, working on all the circle as you can see in the following diagram (take care of not hitting inside the anchor to avoid the cylinder goes down).Figure : Hammering the anchor downFigure : Good and bad anchor introduction
-40-Device InstallationOnce the anchor is totally inserted, make sure that it is at least 12 mm below the ground. Then take a sharp punch (few mm), put it inside the anchor and hit some very hard blows with a hammer.Figure : Hammering with a punch inside the anchor<RXVKRXOGQRWLFHWKDWWKHF\OLQGHUZHQWDERXWPPGRZQΖQWKDWPRPHQWWKHDQFKRULQVWDOODWLRQLVȴQLVKHGLWLVȴ[HGEHFDXVHLWVORZHUZDOOVH[SDQGHGFigure : Anchor installedWarning: The anchors provided are indicated for concrete with at least 50 mm of depth, depending on the material of the terrain where the node is going to be installed, it could be that the anchors are not installed correctly. If the material RQZKLFKWKHQRGHLVJRLQJWREHDQFKRUHGLVGL΍HUHQWLWPLJKWEHLQWHUHVWLQJWRYDOXHDQDOWHUQDWLYHW\SHRIIDVWHQLQJWarning: Make sure that the installation of the anchors is correct. If not, it is possible that the anchorage of the node is not correct and may even move from its position.
-41-Device InstallationFigure : Setting anchors instructionsStep  4:  Place  the  black  circle  rubber  on  the  ground.  To  enable  the  correct  screwing  of  the  screws  inside  the anchors, make sure that there is no dust in the inner thread of the anchor (you can use the spray duster again). ΖQVWDOOWKHQRGHLQLWVȴQDOSRVLWLRQDQGVFUHZWKHVSHFLDODQWLYDQGDOLFVFUHZVSURYLGHG$QWLYDQGDOLFVFUHZVDUHUHFRPPHQGHGWRDYRLGSUREOHPVDQ\RQHFRXOGXQVFUHZDQRGHLIȴ[HGZLWKVWDQGDUGVFUHZVFigure : Screwing the nodeFigure : Final section of the anchor and screw
-42-Device InstallationFigure : 7KHQRGHȴQDOO\VFUHZHGStep 5:8VHWKHPDJQHWWRUHVHWWKHQRGH2QFHWKHQRGHKDVEHHQUHVHWLWZLOOVWDUWWRFRQȴJXUHWKHUDGLRVDQGget a calibration of the parking slot. In this stage the parking slot must be empty, so the node learns when the slot is not occupied.Figure : Using the magnet to reset the nodeStep 6: When the node gets the reference calibration, it will send two frames to the cloud: Start frame 1 and Start frame 2.
-43-Device InstallationFigure : Start frames received in the Sigfox backend11.4. &RQȴJXULQJWKHSDUNLQJQRGHVLQWKHFDOOEDFNVHUYHU&XVWRPHUVKDYHLQVWDOOHGWKHFDOOEDFNVHUYHUDVH[SODLQHGEHIRUH1RZDOOQRGHVKDYHWREHFRQȴJXUHGXVLQJWKHon-line form available. &RQVLGHULQJWKDWDUHDOGHSOR\PHQWZLOOKDYHJURXSVRIQRGHVZRUNLQJZLWKGL΍HUHQWFRQȴJXUDWLRQVIRUH[DPSOHVWUHHW  VWUHHW  LW LV UHFRPPHQGHG WKDW WKH ȴQDO 5HPRWH 0DQDJHU LV DEOH WR JHQHUDWH WKH FRQȴJXUDWLRQdepending on the group that each node belong to. This can be achieved if the cloud keeps record of the groups, and which nodes are inside each group. 3OHDVHVHHWKH6LJIR[DQG/R5D:$1VHFWLRQVWRJHWPRUHLQIRUPDWLRQDERXWVSHFLȴFFDOOEDFNFRQȴJXUDWLRQ
-44-Services12. Services/LEHOLXPKDVLPSOHPHQWHGVHUYLFHVLQWKHUHPRWHQRGHFRQȴJXUDWLRQZHEDSSOLFDWLRQ6LJIR[/RULRWDQG$FWLOLW\ΖQWKLVVHFWLRQLVH[SODLQHGKRZWRVHWWKHPXSZLWKDVLPSOHFRQȴJXUDWLRQΖIXVHUVZDQWWRXVHDVHUYLFHRIRWKHUcompany not already implemented, we include in this section the instructions to develop that new service.12.1. SigfoxThis section explains how to route the information received from the Sigfox platform to the callback server and generate the needed response. 12.1.1. 'HYLFHFRQȴJXUDWLRQ&RQȴJXUHDQHZ*URXSLQWKH6LJIR[EDFNHQG •1. Display the parent group hitting on group top menu section. •2. It is not allowed to create two same groups in the same level. An alert is shown while the form is saved noticing the error. Skip  to the Device Type creation step if the group already exists. •3. Create the new group clicking in “New” button.Select the parent group following the next pop-up windows. )LQDOO\ȴOOLQWKHIRUPZLWKWKHLQIRUPDWLRQUHTXLUHGFKHFNLQJLIWKHSDUHQWJURXSZULWWHQLVWKHRQHFKRVHQin the previous step.Figure : Group creation schema
-45-ServicesThe next step is creating the Device Type in the back-end, clicking on “Device Type” in the top menu and then on “New” button.Figure : Device type creation schemaA  new  pop-up  window  will  be  shown  to  select  the  group  for  the  new  Device  Type,  usually  the group  created previously.Select the group and a new form will appear,  provide all information required to create the Device Type. Sigfox nodes  assigned  to  this  Device  type  will  share  the  same  functionality.  It  is  mandatory  to  select  CALLBACK  as Downlink mode.Figure : Device type form7KH QH[W VWHS LV FRQȴJXULQJ WKH FDOOEDFN &OLFN RQ Ȋ&DOOEDFNVȋ RSWLRQ LQ WKH OHIW PHQX DQG WKHQ FUHDWH D QHZcallback: “New” button in the window loaded.Figure : Callback creation
-46-Services$QHZIRUPZLOOEHGLVSOD\HGSOHDVHȴOOLQWKHIRUPIROORZLQJWKHLQGLFDWLRQVVKRZQLQWKHQH[WLPDJHFigure : Callback form:ULWHWKH85/WRDFFHVVWKH6LJIR[VHUYLFHLQWKHȴHOGȊ8UOSDWWHUQȋ7KLV85/KDVEHHQSUHYLRXVO\FRQȴJXUHGLQyour  server.  Some  extra  variables  have  been  added  (to  send  to  the  service  as  much  information  as  possible) following the information displayed in the form.http://my_server.com/services/sigfox/?id={device}&time={time}&duplicate={duplicate}&snr={snr}&station={station}&data={data}&avgSnr={avgSnr}&lat={lat}&lng={lng}&rssi={rssi}&seq-Number={seqNumber}&ack=trueAfter the callback form is saved, the list of all available callbacks will be shown. Enable this entry with a downlink, the service running in your server will receive the information:1. Activate “Downlink” column. There is a bullet in this column, and it must be activated. To activate, just click on it and leave the bullet coloured. • Downlink active  • Downlink inactive2. “Enable” the callback. In the “Enable” column of  the  callback  created,  there is a check icon and you have to ensure that it is checked with a green colour. • Callback enabled • Callback disabledFigure : Callback list
-47-ServicesFinally it is time for creating the device node itself, click on “Device” option in the top  menu,  wait  for  the  next window to be loaded, click on “New” button.Figure : Device creationAs it happened with the Device Type, the parent group of the device must be selected. Fill the following information in the new device form:Figure : Device form •ΖGHQWLȴHU Device ID in hexadecimal format, given by the manufacturer.  •Name: Device name. A descriptive name useful to identify your device easily.  •PAC: Porting Authorization Code (PAC) is a unique hexadecimal number to identify the device regardless of the network. This code is given by the device manufacturer.  •Prototype: Mark this checkbox.  •3URGXFWFHUWLȴFDWH Leave blank.  •Type: Select the device type created before. •Lat (-90º to +90º) / Lng (-180º to +180º) / Map:*UDEWKHFRRUGLQDWHVRI\RXUQRGHWRXVHWKHVHWKUHHȴHOGV •Prevent token renewal?: Leave unchecked.
-48-Services12.1.2. 6HUYHUFRQȴJXUDWLRQΖQWKHFDOOEDFNVHUYHUSUHYLRXVO\LQVWDOOHGVRPHSDUDPHWHUVPXVWEHFRQȴJXUHGWRHQDEHWKHFRPPXQLFDWLRQwith the node.7KHVHUYLFHVLQLȴOHORFDWHGLQGDWDIROGHUKDVWREHXSGDWHGZLWKWKHIROORZLQJLQIRUPDWLRQLQWKHVLJIR[VHFWLRQ[sigfox]ORJBOHYHO ߙ$//ߚORJBࢱOH ߙORJVVLJIR[ORJߚ •log_level: This level is the minimum level to save logs in the system. Select among these levels:  -OFF: This option deactivate the log. -ERROR : It only reports ERROR messages. -INFO: It reports ERROR + INFO messages. -DEBUG: it reports ERROR + INFO + DEBUG messages. -ALL: It reports everything happened in the process. •ORJBȴOH The relative path where the log messages will be saved.
-49-Services12.2. LoriotThis section explains how to route the information received from the Loriot platform to the callback server and generate a response if it is needed.12.2.1. 'HYLFHFRQȴJXUDWLRQLog in and create a new application in the Loriot dashboard. Figure : Creating an applicationIn this application all devices have to be added clicking on “Devices” left menu option and the device list will be displayed. Click on “Generate new device” button to add a new device. The new device will appear in the end of the list. Click on it to get more information.Figure : Device creation schemaData  output  section  is  the  responsible  to  stablish  the  communication  between  the  platform  and  the  callback VHUYHU&OLFNRQRXUDSSOLFDWLRQQDPHLQWKHOHIWPHQXWKHȴUVWULJKWEORFNȊ1HWZRUN$SSOLFDWLRQȋFRQWDLQVWKHȊ'DWDRXWSXWȋRSWLRQWKHFRQȴJXUDWLRQLVLQWKHPDLQZLQGRZRIWKHDSSOLFDWLRQFUHDWHGFigure : Output application selection
-50-ServicesClick on “Edit output” to display all the information available about the selected output option.Click on “Change” button in the detailed window to change the data output, select one of the multiple choices from the list.   Figure : Selecting the output application“Websocket” is the method recommended  to deliver the end-device data. •ΖWȇVFORXGIULHQGO\H[LVWLQJ+773WUDɝFRSWLPL]DWLRQFDQEHXVHG •It’s bi-directional, real-time interface •It’s easy to implement •It’s lower overhead compared to REST •It’s already supported in all major web browsers •It’s already supported in many programming languages12.2.2. 6HUYHUFRQȴJXUDWLRQΖQWKHFDOOEDFNVHUYHUSUHYLRXVO\LQVWDOOHGVRPHSDUDPHWHUVPXVWEHFRQȴJXUHGWRHQDEOHWKHFRPPXQLFDWLRQwith the node.The services.iniȴOH ORFDWHGLQ data  folder, has  to be  updated with the  following information  in the loriot section.[loriot]ORJBOHYHO ߙ$//ߚORJBࢱOH ߙORJVORULRWORJߚZHEVRFNHWBXUO ߙZVVHXORULRWLRDSS"LG [[[[[[[WRNHQ [[[[[[[ߚVHUYLFHBXUO ߙKWWSP\VHUYHUFRPVHUYLFHVORULRWߚ •log_level: This level is the minimum level to save logs in the system. Select among these levels:  -OFF: This option deactivate the log. -ERROR : It only reports ERROR messages. -INFO: It reports ERROR + INFO messages. -DEBUG: it reports ERROR + INFO + DEBUG messages. -ALL: It reports everything happened in the process. •ORJBȴOH The relative path where the log messages will be saved. •websocket_url: The URL of the websocket listed in the Loriot dashboard. In the last window shown “Application output”, in the second section “Current output setup” there are the target URL and the Authentication Token to access to the API interface.
-51-ServicesFigure : Output setupClicking  in  “Authentication  token”  link,  a  new  window  will  be  shown  with  the  tokens  generated  in  the  Loriot application.  To  create  a  new  one,  just  click  on  “Generate  another  authentication  token”  button,  and  a  new  record  will  be created in the table. Finally, copy the full URL hitting on “Show full URL” and paste the URL in this parameter of the VHUYLFHFRQȴJXUDWLRQȴOHFigure : Generating an application token •service_url:7KH85/WRDFFHVVWRWKH/RULRWVHUYLFHLQ\RXUFDOOEDFNVHUYHUSUHYLRXVO\FRQȴJXUHG (http://my_server.com/services/loriot/)12.3. Start the web-socket connectionThis platform requires an additional step. Start the process which establish the connection to the Loriot server in order to receive and send information in all nodes.Open a SSH connection to the web server in a terminal and navigate to the directory your_web_server_path/services/loriot.  Execute following command to create the web-socket communication: nohup nodejs websocket.js >>../../logs/loriot.log 2>&1 & Kill this process to stop the web-socket communication.
-52-Services12.4. ActilityThis section explains how to route the information received from the Actility platform to the callback server and generate a response if it is needed. 12.4.1. 'HYLFHFRQȴJXUDWLRQ&RQȴJXUHDQHZ$6URXWLQJSURȴOHLQWKH'HYLFH0DQDJHUFOLFNLQJRQȊ$6URXWLQJSURȴOHVȋRQWKHOHIWVLGHEDUPHQXFigure : $65RXWLQJSURȴOHVPHQX$OLVWZLWKDOOH[LVWLQJ$6URXWLQJSURȴOHVZLOOEHGLVSOD\HG%HORZLQWKHVHFRQGVHFWLRQ1HZ$6URXWLQJSURȴOHJLYHVWKHFDSDELOLW\WRDGGQHZ$6URXWLQJSURȴOHV&OLFNLQJRQ$GGEXWWRQWRFUHDWHDQHZ$65RXWLQJSURȴOHFigure : $65RXWLQJSURȴOHV
-53-ServicesA name must be typed in the new window displayed. Clicking on Create button to continue the process.Figure : $65RXWLQJSURȴOHQDPHIn the new window, mark the check “Is default” and click the “Add button” in the Add a route section.Figure : $65RXWLQJSURȴOHURXWHA new section  “Route” will appear  with a  default  route created.  The  name will be  always “bigONG1”.  Only  our GHVWLQDWLRQ85/PXVWEHLQWKLVWDEOH7KHȴUVWVWHSZLOOEHWRGHOHWHWKHGHIDXOWURXWHFOLFNLQJRQWKHURZDQGWKHQon the “Delete button”Figure : Add a route
-54-ServicesAfter the default route has been deleted, create the destination URL.  •1. Hitting on “Add” button a new pop up window will be displayed. •ΖQȊ7\SHȋȴHOGȊ7KLUGSDUW\$6+773ȋPXVWEHVHOHFWHG •ΖQȊ'HVWLQDWLRQȋȴHOGWKH85/WRDFFHVVWRWKH$FWLOLW\VHUYLFHLQ\RXUFDOOEDFNVHUYHUSUHYLRXVO\FRQȴJXUHGKDVWREHW\SHGKWWSP\BVHUYHUFRPVHUYLFHVDFWLOLW\ •)LQDOO\KLWWLQJRQȊ$GGȋEXWWRQWKHFRQȴJXUDWLRQZLOOEHVDYHGFigure : Route destination7KHFRQȴJXUDWLRQZLOODSSHDULQWKHOLVW7KHODVWVWHSLVFUHDWLQJ\RXUGHYLFHDQGDVVRFLDWHLWWRWKH$6URXWLQJcreated. Right-click on “Devices” option in the left menu, and then hit on “Create device”.)LOOLQDOOFRPSXOVRU\ȴHOGVLQWKHIRUPGLVSOD\HGLQWKHQHZZLQGRZDFFRUGLQJWRWKHYDOXHVLQWKH/LEHOLXP6PDUW'HYLFHV$SS5HPHPEHUWRVHOHFW\RXU$6URXWLQJLQȊ$6URXWLQJSURȴOHȋFigure : Create a new device
-55-Services7RFKDQJHWKHQHWZRUNURXWLQJWRWKH$65RXWLQJSURȴOHVHOHFWDGHYLFHIURPWKHOLVWDQGKLWRQȊ(GLWȋEXWWRQ7KHQclick on Network section in the left menu.Figure : Steps to follow when the device is createdΖQ WKH Ȋ1HWZRUNFORXG URXWLQJȋ VHFWLRQ WKH QHZ $6 5RXWLQJ SURȴOH FUHDWHG PXVW EH VHOHFWHG FOLFNLQJ RQ WKHȊ&KDQJHȋEXWWRQVHOHFWWKHSURȴOHFUHDWHGIURPWKHGURSGRZQER[GLVSOD\HGLQWKHQHZSRSXSZLQGRZ)LQDOO\click on the “Save” button. Figure : Select the AS Routing created12.4.2. 6HUYHUFRQȴJXUDWLRQΖQWKHFDOOEDFNVHUYHUSUHYLRXVO\LQVWDOOHGVRPHSDUDPHWHUVPXVWEHFRQȴJXUHGWRHQDEOHWKHFRPPXQLFDWLRQwith the node.7KHVHUYLFHVLQLȴOHORFDWHGLQGDWDIROGHUKDVWREHXSGDWHGZLWKWKHIROORZLQJLQIRUPDWLRQLQWKHDFWLOLW\VHFWLRQ[actility]ORJBOHYHO ߙ$//ߚORJBࢱOH ߙORJVDFWLOLW\ORJߚVHUYHUBXUO ߙKWWSOUFWKLQJSDUNFRPVHQVRUߚ •log_level: This level is the minimum level to save logs in the system. Users can select one among these levels:  -OFF: This option deactivate the log. -ERROR : It only reports ERROR messages. -INFO: It reports ERROR + INFO messages. -DEBUG: it reports ERROR + INFO + DEBUG messages. -ALL: It reports everything happened in the process. •ORJBȴOH The relative path where the log messages will be saved. •server_url: The downlink URL that Actility gives to send information from the server to the node. This URL will be the address of the primary Actility LRC cluster.
-56-Services12.5. Saving the information receivedThis section explains how to get the information sent by the Smart Parking nodes to the callback server.7KHVHUYLFHVLPSOHPHQWHGE\/LEHOLXPORJWKHLQIRUPDWLRQLQDȴOHE\GHIDXOW7RVDYHWKHLQIRUPDWLRQLQDGDWDEDVHRUDFORXGVHUYLFHIROORZLQJȴOHVLQFKDUJHRIGRLQJWKHRSHUDWLRQVGHVFULEHGLQWKHFDOOEDFNVHUYHUQHHGWREHPRGLȴHG •Sigfox: your_callback_server_path/services/sigfox/index.php •Loriot: your_callback_server_path/services/loriot/websocket_response.php •Actility: your_callback_server_path/services/actility/index.phpyour_callback_server_path has to be replaced with the path where the  callback server was previously installed. 6HDUFKIRUDFRPPHQWOLQHOLNHWKLVLQWKHSUHYLRXVVRXUFHFRGHȴOHV//To-Do: get the information received: $frame->get_data();([DPSOHWRVDYHWKHLQIRUPDWLRQLQD0\64/GDWDEDVHXVLQJWKH3+33'2OLEUDU\$data = $frame->get_data();OLQN QHZ3'2ߕP\VTOKRVW VHUYHUSRUW SRUWGEQDPH GEQDPHFKDUVHW XWIߖߕXVHUߖߕSDV-sword’);VWDWHPHQW OLQN!SUHSDUHߙ,16(57,172WDEOHࢱHOGࢱHOG9$/8(6GDWDGDWDߚ$statement->execute(array(ߙGDWDߚ !GDWD>ߕSDUNLQJߖ@ߙGDWDߚ !GDWD>ߕEDWWHU\ߖ@));It is recommended to paste this code block below the commented line.Take a close look at the next section in order to get more information about all the data obtained using the get_data method.12.6. How to develop a new serviceΖWLVSRVVLEOHWRGHYHORSDQHZVHUYLFHGL΍HUHQWWRWKHVHUYLFHVSURYLGHGE\/LEHOLXP7KHDLPRIDVHUYLFHLVWRget the payload sent from the Smart Parking nodes and generate the correct answer when it is needed. Both, the SD\ORDGDQGWKHDQVZHUKDYHWREHGHFRGHGDFFRUGLQJWR/LEHOLXPVSHFLȴFDWLRQV(DFKVHUYLFHFDQKDYHLWVRZQIXQFWLRQDOLW\VRPHZLOOUHTXLUHDZHEVRFNHWVRPHD85/WRFDOOȐ7KHVSHFLȴFDWLRQVof the new service should include all the information needed to implement the new service. We recommend to use PHP, so the new project could be developed faster reusing code created. The most useful PHP class is called frame, which has been created to simplify the payload-answer process and it is located in:your_callback_server_path/includes/class.Frame.php“your_callback_server_path” has to be replaced with the path where the user has the callback server installed. This is a complete description of all attributes and methods of the class frame:AttributesName Descriptionprivate String data Information received from the node.private String type Frame type decoded from the information sent from the node.private String return String to return to the node.private String device_id Device ID of the node.private Array bytes Information received from the node converted into bytes.private Array bits Array in which each previous byte is converted into bits.private Array info Array with the information decoded.
-57-ServicesMethodsName Descriptionvoid __construct (String device_ID)Class constructor.Device ID has to be sent as a parameter. It will be saved in the attribute device_id.void reset (void) Reset all attributes.void get_info (String data)Decode the  information  received from  the  node and  store  it in  the attribute info.The information received from the node has to be sent as a parameter.The information decoded will be saved in the attribute info.Boolean waiting_response(void) It returns a boolean to know if it necessary to send a response for the frame received.String get_response(void) It returns a string to send to the node.Array get_data(void) It returns an array with all information decoded.Using the get_data method of this class, users will get an array with the decoded information received from the QRGH'DWDZLOOGHSHQGRQWKHIUDPHW\SHUHFHLYHG7KHVHȴYHSDUDPHWHUVDUHFRPPRQLQDOOIUDPHW\SHVName Descriptiondevice_id ID of the devicebattery Battery level. [0 = good charge level | 1 = little charge level]parking Status of the parking slot [0 = empty | 1 = occupied]frame_counter Counter of the frames received.frame_typeCounter of the frames received. [0 = Info frame | 1 = Keep-Alive frame | 2 = Daily update frame | 3 = Error frame | 4 = Start frame 1 | 5 = Start frame 2]And then, these are the parameters for each frame type:Frame type 0 = Info frameName Descriptiontemperature_msb Raw temperature from the parking internal sensor.To convert to Celsius degrees use the next formula: 2QO\DYDLODEOHLQȴUPZDUHY[[temperature_lsbtemperatureTemperature (Celsius degrees) from the node’s internal sensor. The value of temperature is a signed integer. 2QO\DYDLODEOHIURPȴUPZDUHY[[x_msb Reference value from the sensor associated to the X axis.x_lsby_msb Reference value from the sensor associated to the Y axis. y_lsbz_msb Reference value from the sensor associated to the Z axis. z_lsb
-58-ServicesFrame type 1 = Keep-Alive frameName Descriptionsensor_msb Times that the sensor is used in the las 24 hours.sensor_lsbsigfox_msb Times that the Sigfox radio is used in the last 24 hours.sigfox_lsblorawan_msb Times that the LoRaWAN radio is used in the last 24 hours.lorawan_lsbresets_today Number of resets generated in the last 24 hours.CONFIG_ID 9DOXHRIWKHFRQȴJXUDWLRQYHUVLRQORDGHGLQWRWKHQRGHThis class will generate automatically the response for this frame type which is formed by 8 bytes with the following structure:Byte bit 7 bit 6 bit 5 bit 4 bit 3 bit 2 bit 1 bit 00Bytes reserved for the information saved in the FRQȴJXUDWLRQLQLȴOHRIWKHVSHFLȴFGHYLFH123456 Timestamp (hh) º hour with two numbers7Enable daily frameReset Timestamp (mm) º minutes with two numbersFrame type 3 = Error frameName Descriptionerror_z Error detected in the X axis of the sensor. >ߙߚ HUURU_ߙߚ QRHUURU@error_y Error detected in the X axis of the sensor. >ߙߚ HUURU_ߙߚ QRHUURU@error_x Error detected in the X axis of the sensor. >ߙߚ HUURU_ߙߚ QRHUURU@error_rtc Error detected in the RTC (internal clock). >ߙߚ HUURU_ߙߚ QRHUURU@error_lorawan Error detected in the LoRaWAN radio. >ߙߚ HUURU_ߙߚ QRHUURU@error_sigfox Error detected in the Sigfox radio. >ߙߚ HUURU_ߙߚ QRHUURU@temperature_msb Raw temperature from the parking internal sensor.To convert to Celsius degrees use the next formula:2QO\DYDLODEOHLQȴUPZDUHY[[temperature_lsbtemperatureTemperature  (Celsius  degrees)  from  the  node’s  internal  sensor.  The  value  of temperature is a signed integer. 2QO\DYDLODEOHIURPȴUPZDUHY[[
-59-Servicesx_msb Reference value from the sensor associated to the X axis.x_lsby_msb Reference value from the sensor associated to the Y axis. y_lsbz_msb Reference value from the sensor associated to the Z axis. z_lsbbattery_levelBattery voltage in millivolts. To convert to millivolts, use the next formula:Frame type 4 = Start frame number 1Name Descriptiontemperature_msb Raw temperature from the parking internal sensor.To convert to Celsius degrees use the next formula:2QO\DYDLODEOHLQȴUPZDUHY[[temperature_lsbtemperatureTemperature (Celsius degrees) from the node’s internal sensor. The value of temperature is a signed integer. 2QO\DYDLODEOHIURPȴUPZDUHY[[x_calibration_msb Reference value from the sensor associated to the X axis. x_calibration_lsby_calibration_msb Reference value from the sensor associated to the Y axis. y_calibration_lsbz_calibration_msb Reference value from the sensor associated to the Z axis.z_calibration_lsbbattery_level_msb Battery voltage in millivolts.battery_level_lsbThis class will generate automatically the response for this frame type. It consists of 8 bytes with date and time information which will be sent to the node according to this structure:Byte bit 7 bit 6 bit 5 bit 4 bit 3 bit 2 bit 1 bit 00 Timestamp (YY) º two last numbers of the year1 Timestamp (MM) º month with two numbers2 Timestamp (DD) º day with two numbers3 Timestamp (dow) º day of the week. 0 for Sunday, through 6 for Saturday.4 Timestamp (hh) º hour with two numbers5 Timestamp (mm) º minutes with two numbers67
-60-ServicesFrame type 5 = Start frame number 2Name Firmware version.CODE_ID Firmware version.NM_START Beginning hour of the night mode.NM_PERIOD Duration in hours of the night mode.NM_SLEEP_TIME Sleep time between consecutive sensor measurements (during night mode).NM_KEEP_ALIVE Elapsed  time  since  last  transmission  to  trigger  a  Keep-Alive  frame (during night mode).RADIO_MODE Selected  transmission  mode  between  Sigfox,  LoRaWAN  y  their combinations.SLEEP_TIME Sleep time between consecutive sensor measurements.KEEP_ALIVE Elapsed time since last transmission to trigger a Keep-Alive frame.THRESHOLD Threshold for detecting a vehicle over the parking slot.When using PHP as a programming language of the new service is not possible, using the raw information sent from the device will be mandatory.S. Frames section of this document explains how to do some operations to get the real value of every parameter received and how to generate the answer to sent it back to the Smart Parking node.Example Payload: 0400003f34b909173f600fc2 Node ID: 0102030405060708. Date: 13th February 2017 18:45:22. UHVSRQVHVLQLȴOHFRQWHQWUHVSRQVHIURPWKH/LEHOLXPUHPRWHQRGHVHUYLFH[devices] ߙGߚFRQȴJXUDWLRQLQLȴOHFRQWHQWYDOXHVVDYHGLQWKHZHEIRUP[0102030405060708]'(9,&(B1$0( ߙ6HWߚSLEEP_TIME = 1KEEP_ALIVE = 910B67$786 NM_PERIOD = 9NM_START = 22NM_SLEEP_TIME = 2NM_KEEP_ALIVE = 4THRESHOLD = 93BAT_READING = 0ENABLE_DAILY_FRAME = 1CONFIG_ID = 97RADIO_MODE = 0LORAWAN_MODE = 05(6(7B5(48(67 Following the Frame section, we have 12 bytes (v1.x.x). Each byte is formed with two numbers, starting from the left. The result is:byte 0 1 2 3 4 5 6 7 8 9 10 11value 04 00 00 3f 34 b9 09 17 3f 60 0f c2
-61-ServicesByte 0 has always the same format in all frames and it is compulsory to start with it in order to know which frame type is.byte 00 2 160 0 1 0 20 0 1 0 2byte 7 6 5 4 3 2 1 0value 0 0 0 0 0 0 1 0The information obtained in this step is: •Parking slot (bit 7)  0 ® free •Battery state (bit 6)  0 ® normal •Frame type (bits 0-3)  0010 2 = 2 ® Frame type 2, daily update frame*HQHUDWHWKHDQVZHUDFFRUGLQJWRWKHVSHFLȴFDWLRQVH[SODLQHGLQWKLVVHFWLRQIRUWKLVNLQGRIIUDPH7KHȴUVWE\WHVDUHIRUWKHYDOXHVDYHGRIWKLVQRGHIURPWKHUHVSRQVHVLQLȴOHRUIURPWKHUHTXHVWPDGHWRWKH/LEHOLXPremote node  service  explained  in  the  section  “How  to  create  your  own  dashboard”).  In  this  case,  the  value  is 615d01991642. Then two bytes (6 and 7) have to be added following the instructions:In byte 6, bits from 0 to 4 are booked for the hour of the current time, in this case, 18. The rest bits have no value. A conversion of the hour value to binary is needed to put all values according to the byte pattern: 1810 = 100102byte 6byte 7 6 5 4 3 2 1 0value 0 0 0 1 0 0 1 0Convert the entire binary byte to hexadecimal format: 000100102 = 1216. And this is the result for byte 6. In byte 7, bits from 0 to 5 are reserved for the minutes of the current time, in this case, 45. Then, bit 6 is the reset YDOXHDQGELWLVWKHHQDEOHGDLO\IUDPHYDOXH7KHVHODVWWZRYDOXHVDUHWDNHQIURPWKHFRQȴJXUDWLRQLQLȴOHwhere all the dashboard parameters are saved. In this case, the values are 0 and 1 respectively.Change the minute value to binary to generate this byte: 4510 = 10110121RZLWLVWLPHIRUȴOOLQJELWDQGZLWKtheir values: 101011012.byte 7byte 7 6 5 4 3 2 1 0value 1 0 1 0 1 1 0 1A conversion from this binary value to hexadecimal format is needed to get byte 7: 101011012 = AD16)LQDOO\WKHODVWVWHSLVWRMRLQWKHUHVXOWVRIWKHE\WHVDQGWRWKHYDOXHRIWKHFRQȴJXUDWLRQLQLȴOHWRVHQGLWWRthe node. The result of the whole process is: 615D0199164212AD.
-62-Troubleshooting13. Troubleshooting13.1. Windows does not recognize USB ports Sometimes it is possible that your computer does not recognize the USB port where the board is plugged. It is EHFDXVH\RXGRQRWKDYHLQVWDOOHGWKHSURSHUGULYHUIRUWKHGHYLFHEXWGRQRWZRUU\ZHZLOOWHOO\RXKRZWRȴ[this issue. Firstly, it is necessary to open the Device Manager in order to see what device is not being detected. To open this window depends on the Windows version you have, but usually typing “Device Manager” in the Start > Search option it is enough.Figure : Windows Device ManagerThe devices that are not detected are always marked with an alert icon as the next image shows. Right-click and VHOHFWWKHȴUVWFKRLFHȊ8SGDWH'ULYHU6RIWZDUHȋFigure : Update driver
-63-TroubleshootingThen, the driver must be searched in the computer, in particular the same path where the Smart Devices App has been installed.   Figure : Search the driver in the computer2QFHYDOLGDWHGWKHSDWKWKHQH[WSRSXSZLOOEHGLVSOD\HGQRWLFLQJWKHGULYHULVQRWYHULȴHG8VHUVKDYHWRFRQȴUPclicking on “Install this driver software anyway”. Figure : Security warningAfter a while, the driver is installed.Figure : Driver installed
-64-Troubleshooting%XWWKHSURFHVVLVQRWȴQLVKHG7KHȴUVWGULYHULQVWDOOHGLVȊ86%6HULDO&RQYHUWHUȋEXWLWLVQHFHVVDU\WRFKHFNWKHDevice Manager list to verify the status. If the warning remains near the USB serial port, users have to repeat the “Update driver software” process again.Figure : USB devices to verify:KHQWKHSURFHVVLVȴQLVKHGXVHUVFDQFKHFNERWKGULYHUVKDYHEHHQLQVWDOOHGFigure : USB devices with all drivers installedNow, the Smart Device App is ready to detect the ports and make the operation you want to do.
-65-Troubleshooting13.2. How to know the port where the device is plugged inUsers have to select in the Smart Devices App the port assigned to the Smart Parking node in the computers to make any operation with the Smart Parking node. The assigned port depends on the USB devices that the users have plugged in their computers. The port displayed in the images of this guide may not correspond with the users port. Follow these steps to discover the Smart Parking node port: Step 1: Unplug the Smart Parking device from the computer and refresh the list. Take a look of all ports detected.Figure : Port list without the node connectedStep 2: Plug the Smart Parking device and refresh the list again.Figure : Port list with the node connectedStep 3: Compare the results with the previous ones and the new port detected is the Smart Parking node plugged in the last step.Figure : Comparing the results13.3. ΖFDQQRWORDGQRUVDYHWKHFRQȴJXUDWLRQLQWKHQRGHSometimes users can experience that they cannot do any operation with the node in the Smart Devices App.Figure : Error messages displayed in load / save operationA message like one of the previous can be displayed. When the USB port is properly selected, the problem could EHWKDWWKH6PDUW3DUNLQJQRGHKDVJRQHWRGHHSVOHHSVWDWH7RVROYHLWSRZHUR΍WKHQRGHDQGWKHQSRZHULWRQagain. Then, click on “load” or “save” button as soon as possible, just before the node enter in deepsleep state (it takes 4 or 5 seconds).
-66-&HUWLȴFDWLRQV14. &HUWLȴFDWLRQVThis document applies to the following Smart Parking model, approved for FCC:Model FCC IDSmart Parking US XKM-PARKING-V114.1. 86$&HUWLȴFDWLRQ0RGLȴFDWLRQVWDWHPHQW/LEHOLXPKDVQRWDSSURYHGDQ\FKDQJHVRUPRGLȴFDWLRQVWRWKLVGHYLFHE\WKHXVHU$Q\FKDQJHVRUPRGLȴFDWLRQVcould void the user’s authority to operate the equipment.Interference statementThis  device  complies  with  Part  15  of  the  FCC  Rules  license-exempt  RSS  standard(s).  Operation  is  subject  to the  following  two  conditions:  (1)  this  device  may  not  cause  interference,  and  (2)  this  device  must  accept  any interference, including interference that may cause undesired operation of the device.Wireless noticeThis device complies with  FCC  radiation exposure limits  set  forth for an uncontrolled  environment  and meets the FCC radio frequency (RF) Exposure Guidelines rules. This transmitter must not be co-located or operating in conjunction with any other antenna or transmitter.This device needs to be installed and used on distance greater than 20 cm from human body.For FCC Part 15 – Class B device: digital device or peripheralThis equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of  the  FCC  Rules.  These  limits  are  designed  to  provide  reasonable  protection  against  harmful  interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment R΍DQGRQWKHXVHULVHQFRXUDJHGWRWU\WRFRUUHFWWKHLQWHUIHUHQFHE\RQHRUPRUHRIWKHIROORZLQJPHDVXUHV •Reorient or relocate the receiving antenna. •Increase the separation between the equipment and receiver. •&RQQHFWWKHHTXLSPHQWLQWRDQRXWOHWRQDFLUFXLWGL΍HUHQWIURPWKDWWRZKLFKWKHUHFHLYHULVFRQQHFWHG •Consult the dealer or an experienced radio/TV technician for help.
-67-Disposal and recycling15. Disposal and recyclingIn this section, the term “Waspmote” encompasses both the Waspmote device itself as well as it enclosure.When Waspmote reaches the end of its useful life, it must be taken to an electronic equipment recycling point.The equipment must be disposed of in a selective waste collection system, and not that for urban solid residue. Please manage its disposal properly.Your distributor will inform you about the most appropriate and environmentally friendly disposal process for the used product and its packaging.

Navigation menu