manualshive.com logo in svg

Libelium Waspmote Plug & Sense! Smart Parking, Technical Manual

Share
Download
Libelium Waspmote Plug & Sense! Smart Parking Technical Manual Download Page 17

-17-

v7.0

Smart Devices App

8. Smart Devices App

Libelium Smart Devices App is an important tool developed by Libelium that allows users install new firmware versions and 

program the configuration of the new Libelium devices in a few clicks. At the moment it is only available for SmartParking and 

MySignals products, but the list will be incremented shortly.

8.1. Installation

First of all and before installing anything, users have to take into account the platform where the application is going to be 

installed. To install the Libelium Smart Devices App, it is compulsory to have installed the JDK 1.8. If it is not installed in the 

computer, you can follow the steps and download it from this website: 

 https://docs.oracle.com/javase/8/docs/technotes/guides/install/install_overview.html

Once installed JDK, users can download the application using the appropriate link depending on the operative system:

 •

Ubuntu:

 

http://downloads.libelium.com/smart_device_app/SmartDeviceApp_linux64.zip

 •

Windows:

 

http://downloads.libelium.com/smart_device_app/SmartDeviceApp_windows32.zip

 •

Mac:

 

http://downloads.libelium.com/smart_device_app/SmartDeviceApp_macosx64.zip

Then customers only have to extract the content of the SmartDeviceApp zip file downloaded in a place with the right permissions, 

and finally execute the file called “SmartDeviceApp” that will initialize the application. Please, note that the extension of this file 

will depend on the operative system the user is using at the moment (sh for Linux and OSX, and bat for Windows).

8.2. Smart Parking

This section provides several options to Smart Parking users in order to take full advantage of all possibilities the devices offers.

8.2.1. Programmer

Figure :  Smart Parking configuration form

Summary of Contents for Waspmote Plug & Sense! Smart Parking

Page 1: ...wasp mote Plug Sense Smart Parking Technical Guide ...

Page 2: ...Night mode 9 6 Transmission modes 10 7 Frames 11 7 1 Info frame 12 7 2 Keep Alive frame 12 7 3 Daily update frame 13 7 4 Error frame 14 7 5 Start frames 15 7 5 1 Start frame number 1 15 7 5 2 Start frame number 2 16 8 Smart Devices App 17 8 1 Installation 17 8 2 Smart Parking 17 8 2 1 Programmer 17 8 2 2 Firmware upgrade 19 8 2 3 Configuration 21 9 Callback Server 22 9 1 Installation 22 9 2 Deploy...

Page 3: ...3 Configuring the parking nodes in the callback server 33 12 Sigfox 34 12 1 Device configuration 34 12 2 Server configuration 38 13 Loriot 39 13 1 Device configuration 39 13 2 Server configuration 40 13 3 Start the web socket connection 41 14 Actility 42 14 1 Device configuration 42 14 2 Server configuration 45 15 Troubleshooting 46 15 1 Windows does not recognize USB ports 46 16 Certifications 49...

Page 4: ... 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...

Page 5: ...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 an...

Page 6: ...cted lifetime of 4 6 years Antenna Included Detection Magnetic Mounting Over the floor Dimensions 230 mm diameter 28 mm height Protection IP67 completely sealed housing Operating temperature 20 to 65 C Under normal circumstances and dependent on settings Figure Plug Sense Smart Parking main characteristics 3 2 Power consumption Consumption Measuring sensor TBD Transmission Sigfox TBD Transmission ...

Page 7: ...vents 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 th...

Page 8: ...minutes and the Keep Alive increases too 3 hours Example configuration Parameter Configuration Sleep time 1 minute Keep Alive 2 hours Night Mode start hour 00 hours Night Mode duration 6 hours Night Mode Sleep Time 10 minutes Night Mode Keep Alive 3 hours Figure Example configuration Figure Day and night modes example 5 1 Day mode It is the basic working mode and it has 2 configurable parameters S...

Page 9: ... by default Night Mode Sleep Time Sleep time between consecutive sensor measurements during night mode 10 minutes option is configured by default Night Mode Keep Alive Elapsed time since last transmission to trigger a Keep Alive frame during night mode 4 hours option is configured by default This frame only contains basic data from the node parking slot status and battery status It is useful to kn...

Page 10: ...mode only use the LoRaWAN radio to send the data collected by the node Sigfox LoRaWAN In this mode the data collected is sent using the 2 radios It is recommended to test the node with the two transmission technologies Sigfox LoRaWAN This mode uses Sigfox radio as primary radio If there is an issue with the Sigfox radio it will use LoRaWAN to send the frames LoRaWAN Sigfox This mode uses LoRaWAN r...

Page 11: ...hat the parking slot is empty 1 indicates that the slot is in occupied 6 Battery state 0 indicates that the battery has a good level of charge 1 indicates that the battery has little charge and it will be necessary to change it When the battery has little charge it is possible that the node does not work properly and the radios fail sending the frames 5 4 Reserved Reserved bits Do not consider 3 F...

Page 12: ...tored in these two bytes is a 16 bit value in 2 s complement form 9 Z axis measurement LSB 10 11 Reserved Reserved bytes Do not consider Figure Info frame structure 7 2 Keep Alive frame This frame is used to indicate that the parking slot has not changed but the node is still working Byte Name Description 0 Basic data Detailed description in section Frame 1 Frame counter Detailed description in se...

Page 13: ...smissions MSB Unsigned 16 bit counter It stores the times that LoRaWAN radio is used in the last 24 hours 7 LoRaWAN transmissions LSB 8 Resets Number of resets generated in the last 24 hours 9 Config_id Value of the configuration version loaded into the node 10 11 Reserved Reserved bytes Do not consider Figure Daily update frame structure This frame is sent daily at 1 AM It contains a little summa...

Page 14: ...ula 4 Temperature LSB 5 X axis measurement MSB Raw value from the sensor associated to the X axis The value stored in these two bytes is a 16 bit value in 2 s complement form 6 X axis measurement LSB 7 Y axis measurement MSB Raw value from the sensor associated to the Y axis The value stored in these two bytes is a 16 bit value in 2 s complement form 8 Y axis measurement LSB 9 Z axis measurement M...

Page 15: ...nd some parameters about the chosen configuration 7 5 1 Start frame number 1 Byte Name Description 0 Basic data Detailed description in section Frame 1 Frame counter Detailed description in section Frame 2 Temperature MSB Raw temperature from the parking internal sensor The value stored in these two bytes is a 16 bit value in 2 s complement form To convert to Celsius degrees use the next formula 3...

Page 16: ...onsecutive sensor measurements during night mode 6 NM_KEEP_ALIVE Elapsed time since last transmission to trigger a Keep Alive frame during night mode 7 RADIO_MODE Selected transmission mode between Sigfox LoRaWAN y their combinations 8 SLEEP_TIME Sleep time between consecutive sensor measurements 9 KEEP_ALIVE Elapsed time since last transmission to trigger a Keep Alive frame 10 THRESHOLD Threshold...

Page 17: ...ides install install_overview html Once installed JDK users can download the application using the appropriate link depending on the operative system Ubuntu http downloads libelium com smart_device_app SmartDeviceApp_linux64 zip Windows http downloads libelium com smart_device_app SmartDeviceApp_windows32 zip Mac http downloads libelium com smart_device_app SmartDeviceApp_macosx64 zip Thencustomer...

Page 18: ...on Button to activate deactivate this option If it is not active the following fields will not be effective 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 d...

Page 19: ... node button will read all parameters from the node and will displayed the information in the form On the other hand Send to node button will overwrite the configuration in the node All available fields have to be filled with the proper format If any parameter doesn t have an acceptable format a red cross like this IMAGEN app_cross png will be displayed near it and you can t write the information ...

Page 20: ...ad the firmware selected When this item is downloaded a disk will be displayed near it IMAGEN app_disk png indicating it is downloaded Once the firmware is 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 Install the firmware selected You can also delete the downl...

Page 21: ...s 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 users don t fill this field the software don t work Figure Smart Parking configuration form ...

Page 22: ...tools to avoid DoS attacks Libelium back end web server application is developed using PHP language so any web server supporting this technology may be used Apache web server with PHP libraries is a suitable configuration to be used DB Storage packages like MySQL Postgresql or any other database engine is optional for custom requirements Visit the following URL s to find some tutorials about perfo...

Page 23: ... has also a client application responsible for updating any IP address changes in the background more information in http www noip com download Finally the URL to configure the SigFox and LoraWAN platforms to send the callback request to will be conformed with the server name and the paths https my_server com path zip extracted 9 4 Remote node configuration web The remote node configuration tool i...

Page 24: ... the USB Programmer Figure Libelium Callback Configurator screen shot Users can create update and delete the same configuration for several devices To do that just type the ID separated by semicolons like this 00145F 001460 001461 and the rest configuration parameters will be saved with each device ID Here there are the description for all fields DEVICE ID Device ID of the node In each platform se...

Page 25: ...s per day Daily frame Enable Disable daily frame sending Reset request Enable Disable the reset when a vehicle abandon the parking slot Configuration version Code version identifier RADIO MODE Radio mode Radio transmission mode among Sigfox LoRaWAN or their combinations LoRaWAN join mode LoRaWAN join mode ABP or OTAA Before configuring the platform that we will explain in the following sections we...

Page 26: ...s it will be updated like if you select the device from the list Getting the IDs from the node is quite easy from the Libelium Smart Devices App The IDs to be created in your web server are marked in the following picture Figure Device IDs readed from the Smart Devices App Then it is necessary to configure the rest parameters Click on Save configuration and a background procedure will start to sav...

Page 27: ...ection owed to a not high enough variation in the magnetic field above the mote with a vehicle parked in the spot This optimum deployment spot will depend on the kind of parking lot that we are going to monitor In the case of parallel parking lots the mote should be deployed below one of the car sides as shown in figure below while for perpendicular parking spots the most adequate place will be th...

Page 28: ...ssue that will have to be analyzed independently for each scenario 10 1 2 Interference of other vehicles As pointed in section Deployment of the motes the presence of other vehicles in contiguous spots or near places may influence in the detection modifying the detection threshold This influence earns special importance in perpendicular lots where the distance between the mote and the contiguous v...

Page 29: ...e access will be very limited 11 1 Assembly and set up Step 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 Once the parameters have been configured and the USB port selected in the Plug Sense Smart Parking Programmer turn on the node and send t...

Page 30: ... the onboard LEDs first the red LED and after the green LED 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 start 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 blinking Step 5...

Page 31: ... 31 v7 0 Device Installation 11 2 Installation and boot Step 1 Indicate the 4 holes in the asphalt Figure Indicating the holes for the node Step 2 Drill the holes Figure Drilling the holes ...

Page 32: ... 3 Install the node in its final position and screw with the 4 special screws Anti vandalic screws are recommended to avoid problems anyone could unscrew the node from the ground Figure Screwing the node Figure The node finally screwed ...

Page 33: ... Sigfox backend 11 3 Configuring the parking nodes in the callback server Customers have installed the callback server as explained before Now all nodes have to be configured using the on line form available Considering that a real deployment will have groups of nodes working with different configurations for example street 1 street 2 it is recommended that the final Remote Manager is able to gene...

Page 34: ... Then before creating a new one we have to be sure that it does not exist We can t create two same groups in the same level in this case an alert is shown while the form is saved noticing the error If the group exists we have to skip the rest of these steps and jump to the Device Type paragraph 3 We are ready now to create the new group clicking in New button In the next pop up windows you have to...

Page 35: ...viously After selecting the desired Group a new form will appear to fill all information required to create the Device Type Device Types are shared for all nodes with the same functionality Fulfil the form with the information you want don t forget to select CALLBACK as Downlink mode Figure Device type form Once created configuring the callback is a must Click on Callbacks option in the left menu ...

Page 36: ... snr station station data data avgSnr avgSnr lat lat lng lng rssi rssi seq Number seqNumber ack true The list of all callbacks available will be shown after the callback form is saved In this list it is mandatory to enable this entry with a downlink for the service in your server receive information Perform following 2 actions to enable SigFox downlink 1 Activate Downlink column There is a bullet ...

Page 37: ...Device ID in hexadecimal format given by the manufacturer Name Device name Use a descriptive name in order 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 Product certificate Leave in blank Type We have to look for in this drop down the device type created...

Page 38: ...nformation in the sigfox section sigfox log_level ALL log_file logs sigfox log 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 log_file The relative pat...

Page 39: ... be added clicking on Devices left menu option and the device list will be displayed Click on Generate new device button for adding a new device The new one will be created in the end of the list Click on it to get more information Figure Device creation schema Data output section is the responsible to stablish the communication between the platform and the customer server The configuration is in ...

Page 40: ...er to be able to communicate to the node and run the whole system The services ini file located in data folder has to be updated with the following information in the loriot section loriot log_level ALL log_file logs loriot log websocket_url wss eu1 loriot io app id xxxxxxx token xxx xxxx service_url http my server com services loriot log_level This level is the minimum level to save logs in the s...

Page 41: ...ce_url The URL to access to the Loriot service in your server previously configured http my_server com services loriot 13 3 Start the web socket connection This platform requires an additional step starting the process that 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 navigate to the Loriot...

Page 42: ...it is necessary to configure a new AS routing profile in the Device Manager clicking on AS routing profiles on the left sidebar menu Figure AS Routing profiles menu A list will be displayed with all existing AS routing profiles Below in the second section New AS routing profile gives the capability to add new AS routing profiles Clicking on Add button to create a new AS Routing profile Figure AS R...

Page 43: ...essary to mark the check Is default and click the Add button in the Add a route section Figure AS Routing profile route A new section Route will appear with a default route created The name will be always bigONG1 Only our destination URL must be in this table The first step will be delete the default route clicking on the row and then on the Delete button Figure Add a route ...

Page 44: ... 4 Finally hitting on Add button the configuration will be saved Figure Route destination Once saved the configuration will appear in the list The last step is creating your device and associate it to the AS routing created You have to right click on Devices option in the left menu and then hit on Create device It is necessary to fill in all compulsory fields in the form displayed in the new windo...

Page 45: ...gure some parameters in order to be able to communicate to the node and run the whole system The services ini file located in data folder has to be updated with the following information in the actility section actility log_level ALL log_file logs actility log server_url http lrc99 thingpark com 8807 sensor log_level This level is the minimum level to save logs in the system Users can select one a...

Page 46: ...tem Proceed as described to fix this issue Open the Device Manager in order to see what device is not being detected There are several ways to open this window depending on the Windows version installed usually typing Device Manager in the Start Search option works Figure Windows Device Manager The devices that are not detected are always marked with an alert icon as the next image shows Right cli...

Page 47: ...evices App has been installed Figure Search the driver in the computer Once validated the path the next pop up will be displayed noticing the driver is not verified Users have to confirm clicking on Install this driver software anyway Figure Security warning After a while the driver is installed Figure Driver installed ...

Page 48: ...tatus If the warning remains near the USB serial port the Update driver software process must be repeated again Figure USB devices to verify When the process is finished check that both drivers have been installed Figure USB devices with all drivers installed Now the Smart Device App is ready to detect the ports and make the operation you want to do ...

Page 49: ...tifications See below the specific list of regulations passed More info at www libelium com products plug sense Besides Meshlium our multiprotocol router for the IoT is also certified with the certifications below Get more info at www libelium com products meshlium List of certifications for Plug Sense and Meshlium CE Europe FCC US IC Canada ANATEL Brazil RCM Australia PTCRB cellular certification...

Page 50: ...es 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 ...

Reviews:

No comments

Brands by name

Popular brands

Load more brands