background image

Smart Devices App

5.1.2. Start Smart Devices App on GNU/Linux

Open a new terminal window and navigate to the folder containing the Smart Devices App application, then type:

sudo ./SmartDevicesApp.sh

5.1.3. Start Smart Devices App on MacOSX

Open a new terminal window and navigate to the folder containing the Smart Devices App application, then type:

sudo ./SmartDevicesApp.sh

5.2. Upgrading the Smart Devices App

Occasionally, some improvements and new services will be released; if this is the case, the Smart Devices App will
show a noti

cation encouraging the user to go to the

Installation

section and download the new version.

I

mportant

:

I

t is mandatory to have an active internet connection in order to use the Smart Devices App .

To upgrade the Smart Devices App , you must follow the installation steps. This will overwrite the

les from previous

versions. As a 1st step, we recommend to backup the following

les:

cfg/con

g.ini: This

le stores the Smart Devices App con

guration parameters. To restore those settings, every

single parameter value

(username, password, etc) should be copied into the new version of the

con

g.ini

” fi

le.

The

le should not be overwritten, new parameters must be added and merging

les is mandatory.

temp: This folder contains the

rmware

les previously used. To restore these

les, copy the content of the

saved

temp

directory into the new version

temp

directory.

Figure : Smart Devices App files

5.3. Smart Parking v2

There is a new tab on the application for the new Parking version section called

Smart Parking v2

.

I

nside the tab

there are a lot of new characteristics and options to con

gure the Smart Parking v2 device.

The main sections are: Programmer, Firmware Update and Con

guration.

- 38 -

v7.5

Summary of Contents for Waspmote Smart Parking v2

Page 1: ......

Page 2: ...5 3 3 User switches 15 3 4 Reset button 16 3 5 Node setup 16 3 5 1 Ready to install state 16 3 5 2 How to close the Smart Parking node 17 3 5 3 Magnet start up process 18 3 6 How the node works 19 3 6 1 Frame types 19 3 6 2 Frame header 20 3 6 3 Frame payload 20 3 6 4 Node program flowchart 22 3 7 Node parameters 23 3 7 1 Parameters description and ranges 23 3 7 2 Understanding Info and Keep alive ...

Page 3: ...k Server setup 44 6 1 Loriot 44 6 1 1 Log in 44 6 1 2 Create a new Loriot application 45 6 1 3 Manage Loriot output data 46 6 1 4 How to delete unused Loriot applications 47 6 1 5 How to create a single device manually 48 6 1 6 Nodes batch provisioning in Loriot 49 6 2 Actility 51 6 2 1 How to create a new Application Server 51 6 2 2 How to create a new AS routing profile 53 6 2 3 How to create new...

Page 4: ... 105 7 6 2 Data Parser 105 7 6 3 Database 105 7 7 Modifying the Customer Server 108 7 7 1 Extracting data from the Customer Server 108 7 7 2 Modifying the Database 109 7 7 3 Adding a new unsupported LoRaWAN Network Server 109 7 8 Upgrading the Customer Server 110 8 Libelium Smart Parking Cloud Service 112 8 1 Smart Parking Cloud Service 112 8 1 1 Remote configuration 113 8 1 2 Service configuration ...

Page 5: ...INDEX 10 Certifications 141 10 1 CE European Union 141 10 2 FCC United States 141 11 Safety Guides 142 11 1 Smart Parking Chemical Fixing Cartridge 142 12 Documentation changelog 154 5 v7 5 ...

Page 6: ...arking network architecture The nodes provisioning has been enormously improved The nodes are delivered with default time settings and also unique LoRaWAN identifiers and keys So it is easy to use the default settings to register all nodes in the LoRaWAN network server at a time The Smart Parking node improves the detection and stability performance thanks to a radar sensor which permits to certain...

Page 7: ...uration vehicle stays Do not need an aperture in enclosure Immunity against dirt or dust on enclosure The node provides OTA S Over The Air Setup This allows the user to remotely configure the node parameters sleep time keep alive night mode etc via the Remote Configuration Form That makes it possible to directly install the nodes with factory default settings and then update them from the server sid...

Page 8: ...re The network architecture of Smart Parking is based on the next elements Smart Parking node LoRaWAN base station LoRaWAN Network Server Libelium Smart Parking Cloud Service or Customer Server Figure Smart Parking network architecture 7 v7 5 ...

Page 9: ... WiFi or 4G connectivity too Some base stations are ready to work outdoors IP67 grade Some of them come pre configured for certain LoRaWAN network servers see next section Also some of them integrate an embedded LoRaWAN Network Server Figure LoRaWAN base station 2 3 LoRaWAN Network Server The nodes registration must be done in the Network Server in order to receive LoRaWAN data from all nodes in th...

Page 10: ... Form allows the user to update the settings of each node sleep time keep alive time night mode etc The update is done remotely via LoRaWAN downlink radio packets The difference between the 2 types of server differ in the the possible client needs The Customer Server is a software system provided by Libelium which permits to receive decode and insert data into a standard MySQL database It is mandato...

Page 11: ...Network architecture Figure Libelium Smart Parking Cloud Service scenario Figure Customer Server scenario 10 v7 5 ...

Page 12: ...based on 2 different pieces the base and the external enclosure The base of the Smart Parking node includes the PCB the battery the antenna and the internal enclosure piece Figure Base of a Smart Parking node The base is screwed to the external enclosure piece Figure External enclosure 11 v7 5 ...

Page 13: ...time Min 20 s max 10 min Radio protocol LoRaWAN module Dual detection Radar main and magnetic backup Provisioning Ready to install default LoRaWAN OTAA IDs and key are loaded to each node Node configuration Via Remote Configuration Form web form LoRaWAN configuration Via Smart Devices App Java desktop application Operating temperature 20 to 65 C Under normal circumstances and depending on settings Fi...

Page 14: ...able If you are interested in further information about LoRaWAN country regulations please refer to the LoRa Alliance regional parameters document 3 1 3 LoRaWAN protocol and parameters LoRaWAN is a Low Power Wide Area Network LPWAN protocol It is a spread spectrum modulation technique at extremely low data rates which permits sending data achieving long ranges The most important LoRaWAN parameters...

Page 15: ... information collected from the network the RSSI SNR of the last received packets If you are interested in further information about LoRaWAN specifications please refer to the LoRa Alliance specifications document 3 1 4 Identification label There is a sticker on the bottom side of the Smart Parking node base In this sticker several device specifications can be seen For example the Model which refers t...

Page 16: ...t SF10 settings worst case The send process may be lower power if the node is close to the base station 3 3 User switches The Smart Parking node has 2 switches to manage the working mode On Off switch Determines whether the node is powered on or powered off App Boot switch When the node is powered on this switch determines the performance state of the device App position must be used for a normal op...

Page 17: ... set up to Boot configuration mode pressing the reset button will re start the MCU bootloader for reconfiguration or firmware update Figure Reset button 3 5 Node setup 3 5 1 Ready to install state Important Libelium provides the nodes ready to install so the user only needs to install the nodes and follow the Magnet start up process The Smart Parking node has a power on process in order to put the de...

Page 18: ...ice can be closed In 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 ring Step 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 2 po...

Page 19: ...tory default all nodes are configured with their unique LoRaWAN EUI and random private keys On the other hand if different LoRaWAN parameters are desired Smart Devices App must be used to change the settings and repeat the previously explained steps 3 5 3 Magnet start up process Once the node has been set to ready to install state and it has been closed and placed on the parking slot the magnet star...

Page 20: ... for an RTC sync once every day The next table shows the Downlink frames Frame type num Description Configuration downlink 3 Used to update the node parameters After the customer sets up a new node configuration in the Remote Configuration Form a new Configuration downlink frame is enqueued into the LoRaWAN network server s downlink queue RTC sync frame 6 Used to sync the node s RTC to the server s ti...

Page 21: ...e meaning of each field is Parking slot status 0 Free 1 Occupied Battery status 0 OK 1 Warning The battery level measured is below the warning threshold 3340 mV Configuration uplink frame acknowledgement status 0 ACK 1 NACK Sensor recalibration 0 No calibration was done since the last uplink 1 At least one calibration was done since the last uplink Frame type Number related to frame type 0 Info fram...

Page 22: ...d start hour duration sleep time The Info frame contents are Header Sensor error Temperature Timestamp hour and minutes Radar measurement Distance amplitude and number of reflections The Keep alive frame contents are Header Sensor error Temperature Timestamp hour and minutes Radar measurement Distance amplitude Battery level The RTC update request frame contents are the same as Keep alive frame Imp...

Page 23: ...Smart Parking node 3 6 4 Node program flowchart Figure Smart Parking node program flowchart 22 v7 5 ...

Page 24: ...AN join mode 0 ABP or 1 OTAA Join mode used by the LoRaWAN radio module LoRaWAN DevEUI 8 byte identifier Defines the device EUI used by the LoRaWAN radio LoRaWAN DevAddr 4 byte identifier Defines the device address used by the LoRaWAN radio in ABP mode LoRaWAN NwkSKey 16 byte key Defines the LoRaWAN Network Session Key used by the LoRaWAN radio in ABP mode LoRaWAN AppSKey 16 byte key Defines the LoRaWAN...

Page 25: ...ive 1 hour Figure Example Info and Keep alive frames 3 7 3 Understanding night mode As shown in the parameters table there are some parameters that allow the user to configure the node to use 2 working modes depending on time settings day mode and night mode The night mode is a secondary and optional working mode that allows the user to configure a different time basis parameters in order to reduce t...

Page 26: ...eriods of time every day Note From October 2019 the keep alive night mode setting was deprecated to simplify the parameter management Since then there is a single keep alive setting for both normal mode and night mode 3 7 4 Understanding RTC synchronization There are specific frame types that allow the node to synchronize the RTC to the server timestamp The Start Frame 1 expects an answer from the ...

Page 27: ...s It is possible to distinguish the starting frames at the beginning of the execution Then the node informs with a new Keep alive every 2 hours Any change of Parking slot status implies a new Info frame And after 24 hours working you can see the RTC request performed by the node Timestamp Uplink data F Type Parking lot Battery Recal Seq 04 15 19 15 59 040009c419143c01000000 4 Start 1 NULL 0 0 0 04...

Page 28: ...010110100000000c7 1 Keep alive 0 0 0 19 04 16 19 22 32 012c0011111f00000000c8 1 Keep alive 0 0 0 20 04 17 19 00 02 012d0010120100000000c7 1 Keep alive 0 0 0 21 3 7 6 Factory default values Libelium provides all Smart Parking nodes with factory default parameters Parameter Default value Sleep time 1 min Keep alive time 2 hour Night mode 0 disabled Night mode start 0 hour Night mode duration 6 hour ...

Page 29: ... the time and sensor parameters the same values are set to all nodes manufactured by Libelium The default values can be seen in the previous section However the customer can configure the time and sensor settings using both Smart Devices App and Remote Configuration Form Regarding the LoRaWAN parameters all keys are randomly generated for each node and kept secret The DevEUI set to the node is the L...

Page 30: ...hitecture users can select between 2 ways of working with the Smart Parking nodes one using the Customer Server and the other using the Smart Parking Cloud Service Regardless of the solution chosen users will always need to operate with the Services Cloud Manager SCM which is the basis of the Libelium Cloud Figure Smart Parking network architecture 29 v7 5 ...

Page 31: ...um com Figure SCM Home page 4 2 1 Creating an account To register and set up a password go to https cloud libelium com register and click on Create account Figure Create account button Complete the information in the form all the fields are mandatory Name Your name E mail address A valid e mail address it will be used for verification purposes Password and Confirm password Set your password Accepting...

Page 32: ...n the SCM go here and click on the Sign In button Figure Sign in button Complete the information in the form The e mail and password used when creating the account will be required E mail address E mail address used for registration Password Password used for registration 31 v7 5 ...

Page 33: ...ady created an account and need a password reminder you can click on Forgot password 4 3 Smart Parking nodes registration After placing an order including Smart Parking nodes you should receive an e mail with the activation codes for all your devices In this e mail you will directly find clickable links to register the devices in the SCM You can register your nodes one by one if needed but it s fas...

Page 34: ...following the wizard Figure Step1 Enter device activation code Figure Step2 Confirm activation 4 4 Editing Smart Parking nodes You can change the name project description and if the device is a Smart Parking node the LoRaWAN EUI of the device by clicking the pencil icon located next to the each device Finally you must save the changes 33 v7 5 ...

Page 35: ...ry default This means that if the user changed the LoRaWAN credentials via Smart Devices App then the exported credentials will not be same In order to export the file you must go to https cloud libelium com log in and then access My Devices On the website you will identify the Smart Parking actions button which permits to download the nodes credentials by clicking on the Download nodes keys button...

Page 36: ...Libelium Cloud management DevEUI_1 Serial AppEUI_1 AppKey_1 DevEUI_2 Serial AppEUI_2 AppKey_2 DevEUI_3 Serial AppEUI_3 AppKey_3 DevEUI_N Serial AppEUI_N AppKey_N 35 v7 5 ...

Page 37: ... described https docs oracle com javase 8 docs technotes guides install install_overview html https www oracle com technetwork java javase downloads jre8 downloads 2133155 html Once installed JDK or JRE users can download the application in the link below selecting the appropriate Operating System and architecture http www libelium com development smart parking software and applications Then custo...

Page 38: ...rtParking v2 device you can compile the stlink driver discover git clone https github com texane stlink git stlink cd stlink make install binaries sudo cp build Release st usr local bin install udev rules sudo cp etc udev rules d 49 stlinkv etc udev rules d and restart udev sudo udevadm control reload If you have problems with stlink driver installation please refer this site https github com texa...

Page 39: ...s App you must follow the installation steps This will overwrite the files from previous versions As a 1st step we recommend to backup the following files cfg config ini This file stores the Smart Devices App configuration parameters To restore those settings every single parameter value username password etc should be copied into the new version of the config ini file The file should not be overwritten n...

Page 40: ... device So when you finish reconfiguring the device please set the node to Off state 5 3 2 Configuration In the last tab called Configuration 2 parameters are available Username and Password These are the same credentials needed for the Libelium Cloud SCM https cloud libelium com login Filling these fields is mandatory before start using the Smart Devices App with the Smart Parking node Please remember ...

Page 41: ...utton to get the current configuration from the connected Smart Parking v2 device Figure Smart Parking v2 USB settings The Load from node button will read all parameters from the node and will display the information on the app On the other hand the Send to node button will overwrite the configuration on the node All available fields have to be filled with the proper format If any parameter does not h...

Page 42: ...gure Firmware update and factory reset section for Smart Parking v2 The list with all available firmwares is loaded when the program starts but users can manually update it by clicking on the Search new firmware updates button Before installing the firmware it is necessary to download it This process is very simple just mark the check of the version you want to install from the list and click on Down...

Page 43: ...d on the node When the file is downloaded a disk icon is displayed close to it indicating it is downloaded On the Install Firmware section you can select the firmware to install and then hit on Install to execute the installation The app will display a pop up message for the status of the firmware installation Note Remember that the USB port must be selected in the programmer tab Figure Firmware inst...

Page 44: ...en select a firmware from the drop down menu and press the Factory Reset button Figure Factory reset process for Smart Parking v2 Step 1 Pressing the Factory Reset button will display a file explorer window to select the configuration file provided by Libelium Once you selected this file a message will show up asking if you want to start the process If the Yes option is selected the Factory Reset proce...

Page 45: ... Parking nodes need a Network Server any LoRaWAN device by Libelium or other company needs a Network Server it s just one piece of the LoRaWAN architecture 6 1 Loriot This section explains how to route the information on Loriot to the Customer server or to the Smart Parking Cloud Service using the HTTPS protocol Important The free Community account does not permit remote downlinks Therefore a Comm...

Page 46: ...be displayed asking your credentials After logging in users have to create a new application in the Loriot dashboard To do this it is necessary to click on Applications in the left side bar and then in New Application option located in the same bar Figure Creating an application Fill the form in order to create the desired application in Loriot 45 v7 5 ...

Page 47: ...ing step Device capacity Maximum number of devices to be registered in this application The maximum value will depend on the account type you have Visibility This checkbox permits to set the application as public or private Figure New application form 6 1 3 Manage Loriot output data Once the application is created the dashboard will be shown Go to Application Outputs Ñ click on Manage outputs Ñ cl...

Page 48: ... header value in order to increase the security in the communications so the final server only accepts the information from an authorized account Finally click on the Confirm change button to save the information Figure Application output configuration 6 1 4 How to delete unused Loriot applications A list with all application outputs will be displayed in the Application Outputs window It is recommend...

Page 49: ...elete option A pop up window will ask you to confirm the operation Figure Delete unused application outputs 6 1 5 How to create a single device manually Click on Devices left menu to show the device list Click on Enroll new device button to add a new device Figure Enroll new device 48 v7 5 ...

Page 50: ...o LoRaWAN protocol and parameters to understand the all parameters involved in this form Figure New device form 6 1 6 Nodes batch provisioning in Loriot Inside the Loriot application click on Bulk import and then click on Upload file to register several devices at a time It asks for a CSV file which must be exported from the SCM Please refer to Libelium Cloud management section for further informati...

Page 51: ...igure Loriot bulk import The CSV file for N devices must respect the next format DevEUI_1 AppEUI_1 AppKey_1 Serial_1 DevEUI_2 AppEUI_2 AppKey_2 Serial_2 DevEUI_3 AppEUI_3 AppKey_3 Serial_3 DevEUI_N AppEUI_N AppKey_N Serial_N 50 v7 5 ...

Page 52: ...profile in order to establish the communication with the Customer server or the Smart Parking Cloud Service These 2 elements are required before starting the service the 1st time and will be the base to create new devices 6 2 1 How to create a new Application Server Starting from the main ThingPark Device Manager window you shall create a new Application Server by clicking on Application Servers Fi...

Page 53: ...continue Figure Application server name A new window appears where the name is copied from the previous pop up In the Content Type field you must select JSON Then click on the Add button in Add a route section to create the link to the callback server installed Figure Application server form A Route section will be generated with a new form to be completed Just click the Add button to proceed 52 v7...

Page 54: ... in order to create the Application server 6 2 2 How to create a new AS routing profile The Application Server AS routing profile defines how a previously created Application server will behave In order to create a new AS routing profile in the Device Manager click on AS routing profiles button on the left sidebar menu Figure Destination form Then you must click on the Add button in the first section Be...

Page 55: ...S routing profile ID which will be needed for batch import Besides mark the check Is default and click the Add button Figure AS Routing profile route A new pop up will appear with 2 parameters to be completed Type is the kind of the application for our destination Local application server must be selected In the Destination drop down field all available Application servers will be displayed So the co...

Page 56: ...entify the device Marker Icon to identify the device on the map list Administrative info Relevant information of the device Administrative location Location of the device Motion indicator List with several options Device identification Manufacturer Select Generic Model Select the corresponding region LoRaWAN EU863 870 LORA GenericA 1 0 2a_ETSI_Rx2 SF12 LoRaWAN US902 928 LORA GenericA 1 0 2a_FCC_Rx2...

Page 57: ...Allocated by the network server Application layer handling Application server routing profile Select the Application server created before Figure Enter all device s parameters Finally click on the Create button in order to save the information of the device 6 2 4 Nodes batch provisioning in Actility It is possible to register several nodes at a time using the Import button 56 v7 5 ...

Page 58: ...ofile_ID ConnectivityPlan name Where CREATE_OTAA Should always be the same in order to import the devices using OTAA join mode DevEUI This is the Device EUI exported from Libelium SCM CSV file Should not be changed DevProfile This field is related to the LoRaWAN region of the node Possibilities depending on the version LoRaWAN EU863 870 LORA GenericA 1 0 2a_ETSI_Rx2 SF12 LoRaWAN US902 928 LORA Generi...

Page 59: ...A EUI5 LORA GenericA 1 0 2a_ETSI_Rx2 SF12 AppEUI5 AppKey5 dev cs testing TWA_123 Node5 6 3 The Things Network TTN This section explains how to route information on TTN to the Customer Server or to the Smart Parking Cloud Service using the HTTP protocol TTN is a free and ready to use Network Server on the cloud for LoRaWAN communications TTN gives the user a wide variety of integrations ready to us...

Page 60: ... a successful login the main panel will be shown From this screen the user can access different sections to manage her devices and view data Figure Main screen on TTN Click on Console to open the 2 main sections on TTN one for applications and one for gateways 59 v7 5 ...

Page 61: ...played Figure Create new gateway on TTN On the gateway form enter the following data to create a new one 1 Gateway ID A unique and human readable identifier for the gateway 2 Description The gateway description 3 Frecuency Plan This parameter belongs to each country regulation for more information please visit this link 4 Router Select the gateway to connect choose the closest one to your location ...

Page 62: ...er filling all the fields press Register gateway to confirm this new device Gateway settings By clicking on the new created gateway a new screen summarizing the information will appear The user can edit the gateway information change the settings delete the registered gateway and see the traffic on the gateway 61 v7 5 ...

Page 63: ...s used to perform a full deletion of the gateway Do not click this option if you want to preserve your gateway as registered 6 3 3 Manage applications The Applications section permits to view edit and create applications as well as view data and integrate it with other clouds Figure Main sections on TTN Applications After clicking on Applications a list of them will appear if the user has already ...

Page 64: ...to confirm the data Figure Add new application on TTN Options and device registration overview There are plenty of options to configure an application This guide will guide you through the most important options to accomplish the integration with the Customer Server or with the Smart Parking Cloud Service The main screen shows a summary about the application the registered devices and the access key...

Page 65: ...device for an application on TTN To create a new device fill all the fields Device ID The unique identifier for the device in the application Device EUI The unique identifier for the device on the network App Key Used to create a secure communication between the device and the network Important The Device ID must be the same as LoRaWAN EUI in lowercase to match the communication with the Customer Serv...

Page 66: ... to create a new device on TTN There is also a chance to register more that one device in bulk using the Bulk import devices button placed on the top right Figure Bulk devices import on TTN The screen for a bulk import is very simple 65 v7 5 ...

Page 67: ...rt Parking Cloud Service After entering all the parameters press Register devices to finish the bulk registration process Important With this kind of bulk import after creating the devices the user must reconfigure the settings of each node using the App EUI the App Key and the Device EUI supplied on the registering process This new reprogramming process is a result of TTN frontend limitations on re...

Page 68: ...ons screen on TTN After clicking Add integration a list of third party clouds will be displayed choose HTTP integration to configure TTN to send towards the Customer Server or the Smart Parking Cloud Service Figure Integrations list on TTN 67 v7 5 ...

Page 69: ...ure HTTP integration option on TTN The form for HTTP connection is as follows Figure HTTP integration form on TTN There are some fields to fill on the form Process ID The unique identifier of the new integration process Free text 68 v7 5 ...

Page 70: ... Customer Server can be as shown in the image Figure Configuration on an HTTP integration with the Customer Server on TTN The rest of the integration fields must be blank Data visualization This is one of the most important options on TTN Here the user can see the data sent both uplink and downlink Also the errors and successes on the communication process are shown The user must use this section to...

Page 71: ...plains how to route information on TTI to the Customer Server or to the Smart Parking Cloud Service using the HTTP protocol TTI is a free and ready to use cloud for LoRaWAN communications TTI gives the user a wide variety of integrations ready to use 6 4 1 Log in Open a new window on your web browser and type the login URL provided by The Things Industries Request a quotation to get the login URL ...

Page 72: ...way click on Register gateway A new form is displayed Figure Create new gateway on TTI On the gateway form enter the following data to create a new one 1 Gateway ID A unique and human readable identifier for the gateway 2 Description The gateway description 3 Frecuency Plan This parameter belongs to each country regulation for more information please visit this link 4 Router Select the gateway to c...

Page 73: ...er filling all the fields press Register gateway to confirm this new device Gateway settings By clicking on the new created gateway a new screen summarizing the information will appear The user can edit the gateway information change the settings delete the registered gateway and see the traffic on the gateway 72 v7 5 ...

Page 74: ...s used to perform a full deletion of the gateway Do not click this option if you want to preserve your gateway as registered 6 4 3 Manage applications The Applications section permits to view edit and create applications as well as view data and integrate it with other clouds Figure Main sections on TTI Applications After clicking on Applications a list of them will appear if the user has already ...

Page 75: ...to confirm the data Figure Add new application on TTI Options and device registration overview There are plenty of options to configure an application This guide will guide you through the most important options to accomplish the integration with the Customer Server or with the Smart Parking Cloud Service The main screen shows a summary about the application the registered devices and the access key...

Page 76: ...device for an application on TTI To create a new device fill all the fields Device ID The unique identifier for the device in the application Device EUI The unique identifier for the device on the network App Key Used to create a secure communication between the device and the network Important The Device ID must be the same as LoRaWAN EUI in lowercase to match the communication with the Customer Serv...

Page 77: ... to create a new device on TTI There is also a chance to register more that one device in bulk using the Bulk import devices button placed on the top right Figure Bulk devices import on TTI The screen for a bulk import is very simple 76 v7 5 ...

Page 78: ... newlines commas or semicolons Important The Device ID Prefix must be left in blank to match the communication with the Customer Server or with the Smart Parking Cloud Service After entering all the parameters press Register devices to finish the bulk registration process Application integrations Another important section for each application is Integrations section There the user can send data to t...

Page 79: ...ons screen on TTI After clicking Add integration a list of third party clouds will be displayed choose HTTP integration to configure TTI to send towards the Customer Server or the Smart Parking Cloud Service Figure Integrations list on TTI 78 v7 5 ...

Page 80: ...ure HTTP integration option on TTI The form for HTTP connection is as follows Figure HTTP integration form on TTI There are some fields to fill on the form Process ID The unique identifier of the new integration process Free text 79 v7 5 ...

Page 81: ...Customer Server can be as shown in the image Figure Configuration on an HTTP integration with the Customer Server on TTI The rest of the integration fields must be blank Data visualization This is one of the most important options on TTN Here the user can see the data sent both uplink and downlink Also the errors and successes on the communication process are shown The user must use this section to ...

Page 82: ...Handler EUIs and Access Keys among others The user can change the parameters but it is possible to create here some misconfiguration on the application settings Also on the bottom there is a Delete application APP_NAME button that deletes the application completely Figure Settings for an application on TTI 81 v7 5 ...

Page 83: ...m App inside your basestation Important Our Custom App was developed for MultiTech s firmware 1 7 4 version At the moment the Custom App is not supported on firmware 5 0 0 this 5 0 0 version contains some known bug issues so it is not currently supported More information on the Compatible firmware versions section Log in To start the application first go to the address where you installed your MultiTe...

Page 84: ...nfigs tab If you select the Libelium Smart Parking Cloud Service option you must fill the Token field to send the node s frames to our Smart Parking Cloud Service Please refer to Tools section for further information about to how to create a token Once you have created the token paste in the field Figure MultiTech configuration Smart Parking Cloud Service option If you select the Customer Server option...

Page 85: ...omma separated format one device per line The format to use is DevEUI_1 Serial AppEUI_1 AppKey_1 DevEUI_2 Serial AppEUI_2 AppKey_2 DevEUI_3 Serial AppEUI_3 AppKey_3 DevEUI_N Serial AppEUI_N AppKey_N On the Services Cloud Manager SCM you can download a CSV file with all your devices all the devices associated with on your SCM account To download the file please refer to Libelium Cloud management sect...

Page 86: ... brings by default you have to connect through SSH to the MultiTech basestation Once connected navigate to where the configuration file is located at var config app libelium multitech app and edit the env file If you want to change the username and password to access de application APP_USERNAME admin APP_PASSWORD admin Once you have changed the default username or password and saved the file you need t...

Page 87: ...e manually To register the devices you have to go to LoraWANTM Key Management Add Device Figure Registering a device manually 1 Then click on Add new A new pop up window will open with a form so you can fill the parameters of the nodes The fields Dev EUI App EUI and App Key are mandatory to properly register the device Figure Registering a device manually 2 Once the form is completed the list of dev...

Page 88: ...tation To do so go to the menu on the left and press the Save Restart button Figure Restart button MultiTech basestation 6 5 2 Compatible firmware versions Below we show a list of the compatibility of the Custom App with versions of MultiTech basestations firmware 5 0 0 It contains some known bug issues so it is not currently supported 1 7 x Totally compatible 6 5 3 Installing upgrading Custom App L...

Page 89: ...rade the firmware see logs etc Figure DeviceHQ main panel Registering a MultiTech device on DeviceHQ Once inside the DeviceHQ panel go to Devices Tasks Register devices Figure Registering a MultiTech device on DeviceHQ panel A new pop up window appears In the Serial field you must type the MultiTech serial and on the UUID field you must type the MultiTech UUID Then click on the Register device button...

Page 90: ... the Public apps option to see all the public apps Then search the libelium multitech app Once you have found it click on Add to My Apps and again on the Add to my apps button Figure Add Libelium MultiTech application our Custom App Please accept the licensing agreement and click on Accept Figure Accepting the licensing agreement Enable Remote Management Once inside the MultiTech basestation panel...

Page 91: ... and select the version that you want to install or upgrade Figure Intall upgrade the Custom App Once you have scheduled an action you must check the DeviceHQ server and poll the next actions Read next section for more info Checking DeviceHQ from MultiTech The MultiTech basestation will check the DeviceHQ server and poll it for commands such as configuration update install and uninstall apps and ot...

Page 92: ...LoRaWAN Network Server setup Figure Check In to DeviceHQ 91 v7 5 ...

Page 93: ... the configuration values of the Smart Parking nodes the Customer Server Core it deals with the LoRaWAN Network Server requests sending back a response when needed If the user wants to use the Remote Configuration Form all Smart Parking nodes must be registered on the SCM There is no need of additional licenses The Customer Server must be deployed on your own server Besides the LoRaWAN Network Serve...

Page 94: ...m requirements for the server are Apache web server 2 4 PHP 7 1 3 Database MySQL or PostgreSQL ionCube Loader An Apache webserver with PHP support and a database must be configured on your server Those are the minimum requirements to deploy the Customer Server web application Even if you are not using Docker you can use 2 files as a reference to install all the dependencies of the project These files...

Page 95: ...he installation is completed navigating to http MACHINE_IP 7000 you should see the Remote Configuration Form login screen Multiples instances If you want to use the Customer Server with more than one application you need to deploy one instance of the container for each application You must follow the same steps axplained above but if the new installation is on the same machine you will have to chan...

Page 96: ...OG_DIR error log CustomLog APACHE_LOG_DIR access log combined Directory path zip extracted Options Indexes FollowSymLinks AllowOverride All Require all granted Directory VirtualHost Multiples instances If you want to use the Customer Server with more than one application you will have to deploy one VirtualHost for each application you will have to follow the same steps from above but you will have...

Page 97: ...SWORD password CACHE_DRIVER file It is mandatory to set a service Loriot Actility LwTTN LwTTI Multitech SERVICE If you want to use Loriot you must fill these fields LORIOT_URI LORIOT_APP_ID LORIOT_TOKEN LORIOT_API_KEY If you want to use Actility you must fill these fields ACTILITY_URI ACTILITY_TOKEN If you want to use TTN you must fill these fields TTN_URI TTN_REGION TTN_APP_ID TTN_PROCESS_ID TTN_...

Page 98: ...1 serverId is the Loriot server from which your Loriot application is served you can find it on the URL of your Loriot account LORIOT_APP_ID appId appId is the ID of your Loriot application You can find it on the Network application section of your Loriot account Figure Loriot application ID LORIOT_TOKEN loriotToken loriotToken is the ID of your Loriot application You can find it on the Application t...

Page 99: ...that Actility provides to send information from the server to the node This URL is the address of the primary Actility LRC cluster 7 3 3 How to configure The Things Network TTN Write LwTTN in the SERVICE field SERVICE LwTTN For the remaining fields TTN_URI is the URL from the TTN service to read the uplink response Set https integrations thethingsnetwork org as value TTN_URI https integrations thethi...

Page 100: ...PP_ID test_libelium TTN_PROCESS_ID is displayed on the integration overview configuration Go to the selected integration and the Process ID is available over the Integration overview section For instance if the Process ID has the value libelium1234 the configuration will be as follows Figure Process ID on TTN TTN_PROCESS_ID libelium1234 TTN_PORT is the value for the downlink port This value is avail...

Page 101: ...ions thethingsnetwork org TTN_REGION ttn eu TTN_APP_ID test_libelium TTN_PROCESS_ID libelium1234 TTN_PORT 1 TTN_KEY ttn account v2 HlR_fV9YsXE8TGTzFVEP Byr 7 3 4 How to configure The Things Industries TTI Write LwTTI in the SERVICE field SERVICE LwTTI For the remaining fields TTI_URI is the URL from the TTI service to read the uplink response Set the URL value provided from TTI It should be https int...

Page 102: ...TTI_PORT is the value for the downlink port This value is available on the device details on the Downlink section navigate to the Devices section click on the wanted device and scroll down until the Downlink section For instance in the image the FPort value is 1 the configuration must be as follows Figure Downlink port for device on TTI TTI_PORT 1 TTI_KEY appears at the bottom of the Application ov...

Page 103: ... field SERVICE Multitech MTT_USERNAME is the username that you use as a user to access the configuration panel of the MultiTech basestation MTT_USERNAME admin MTT_PASSWORD is the password that you use with your username to access the configuration panel of the MultiTech basestation MTT_PASSWORD admin1234 MTT_URI is the URL where you have configured your MultiTech basestation By default the URL to acce...

Page 104: ...vices ttn TTI The Things Industries https my_server com api parking v2 services tti MultiTech MultiTech basestation https my_server com api parking v2 services multitech 7 5 Remote Configuration Form The Remote Configuration Form is a web application which permits to update some node parameters sensor and timing parameters This is done thanks to the OTA S Over The Air Setup functionality The update ...

Page 105: ...Parking node Figure Smart Parking node configuration Once you have configured the node or nodes press the Save configuration button A message is shown indicating that a downlink frame with the node s configuration has been enqueued on the downlink queue of the LoRaWAN Network Server Therefore the node will receive a downlink frame with the new configuration in response to the next Info frame or Keep Al...

Page 106: ...ame is sent to the LoRaWAN Network Server with the new values For further information about the different frame types please refer to the Frame types section 7 6 1 End point Once you have installed and configured the Customer Server the system will be prepared to listen to LoRaWAN requests The end point will vary depending on the configured LoRaWAN service By default the source code is prepared for a...

Page 107: ... frame datarate LW_uplink All uplink frames The uplink frame contents in HEX digits LW_downlink All uplink frames The enqueued downlink frame in response to the uplink received The contents in HEX digits Normally this field is empty frame_type_uplink All uplink frames The frame type of the received uplink frame parking_slot_status Info Keep alive RTC update The status of the parking lot 0 free 1 oc...

Page 108: ...ensor radar_range_start Start frame 1 The starting range configured to the radar sensor mm units radar_range_length Start frame 1 The length of range configured to the radar sensor mm units firmware_version Start frame 1 The number related to firmware version sleep_time_minutes Start frame 2 Time settings related to sleep time minutes field sleep_time_seconds Start frame 2 Time settings related to slee...

Page 109: ...our requirements this section describes the best way to do it 7 7 1 Extracting data from the Customer Server Every time a frame is received by the Customer Server an event is created You can take advantage of this event to send the pased data to any external service To do this you have to edit the file src app Listeners FrameListener php This file receives the data parsed in the variable event frame...

Page 110: ...methods to be implemented enqueue_message It allows to send data to the new LoRaWAN Network Server get_lw_info_from_request It returns all the LoRaWAN information from the request of the new LoRaWAN Network Server get_eui_from_request It returns the node EUI from the request of the new LoRaWAN Network Server get_payload_from_request It returns the payload from the request of the new LoRaWAN Networ...

Page 111: ...smart parking customer server New version path to new smart parking customer server new Then you can use the diff command to create a file to patch your old and functioning version of the Customer Server The command to execute is diff Nur path to old smart parking customer server path to new smart parking customer server new path to upgrade diff Note You can ignore the warnings about the permissions...

Page 112: ...p0 path to upgrade diff Note You can also add the flag b to the patch command to create a backup of each modified file Once the patch process is completed you will have to review your env file and add the new options that you can find in the patched env example file 111 v7 5 ...

Page 113: ... of the Smart Parking nodes and the Smart Parking Cloud Core that deals with the LoRaWAN network server requests sending back a response if needed The data sent from the Smart Parking nodes will be sent to any compatible final IoT cloud service Amazon Azure etc using the Libelium Bridge you will need a license to use the Bridge 8 1 Smart Parking Cloud Service Once logged on the Services Cloud Manag...

Page 114: ...g Cloud Service landing page 8 1 1 Remote configuration This tab shows a drop down menu to select one or several devices Each one is identified by their unique LoRaWAN EUI The nodes displayed in the drop down menu correspond to the nodes you have claimed for on your Services Cloud Manager account You can also deselect previously selected nodes using the cross in the node s identification Once a node ...

Page 115: ...he node will receive a downlink frame with the new configuration in response to the next Info or Keep Alive uplink frame Figure Frame enqueued for processing The Remote Configuration Form application allows the user to update some node parameters just as the Smart Devices App does However using the Smart Devices App requires physical access to the node it must be plugged to your computer via a USB c...

Page 116: ...https api libelium com cloud parking v2 services tti MultiTech https api libelium com cloud parking v2 services multitech Note Only one of these services can be active at the same time If you want to use Loriot as your LoRaWAN Network Server you have to select it on the drop down menu and complete the required fields To find the information on the Loriot panel you can follow the instructions describ...

Page 117: ...complete the required fields To find the information on the TTN panel you can follow the instructions described on the How to configure The Things Network TTN section Figure TTN configuration Please be aware that there are a set of regions to choose click on the regions dropdown to see all choices The current regions to send the data are Europe Uses value ttn eu 116 v7 5 ...

Page 118: ...s To find the information on the TTI panel you can follow the instructions described on the How to configure The Things Industries TTI section Figure TTI configuration If you want to use the embedded LoRaWAN Network Server inside a MultiTech basestation as your LoRaWAN Network Server you have to select it on the drop down menu and complete the required fields To find the information on the MultiTech ba...

Page 119: ...dicating that the service has been updated or saved correctly Figure Service configuration saved Authentication token for HTTP integration with TTN The Smart Parking Cloud Service uses tokens for authentication The user must 1st create a token an API key and then use it on TTN Perform these steps to create a new API key and set it on TTN Step 1 Click Create new API key on the Tools tab Figure Step ...

Page 120: ... API key and click the Create button Figure Step 2 TTN integration Step 3 The new API key is shown copy it Figure Step 3 TTN integration Step 4 Paste the API key on the Authorization field of HTTP TTN integration This field must have Bearer CLOUD_LIBELIUM_TOKEN 119 v7 5 ...

Page 121: ...es tokens for authentication The user must 1st create a token an API key and then use it on TTI Perform these steps to create a new API key and set it on TTI Step 1 Click Create new API Key on the Tools tab Figure Step 1 TTI integration Step 2 Set a name for the new API key and click the Create button Figure Step 2 TTI integration Step 3 The new API key is shown copy it 120 v7 5 ...

Page 122: ...ion field on TTI HTTP integration Authorization token for integration with MultiTech basestation The Smart Parking Cloud Service uses tokens for authentication The user must 1st create a token an API key and then use it on the MultiTech basestation Perform these steps to create a new API key and set it on the Libelium custom app in the MultiTech basestation Step 1 Click Create new API Key on the To...

Page 123: ...art Parking Cloud Service Figure Step 1 MultiTech integration Step 2 Set a name for the new API key and click the Create button Figure Step 2 MultiTech integration Step 3 The new API key is shown copy it 122 v7 5 ...

Page 124: ...ration Then a message will be displayed indicating that the service has been updated or saved correctly 8 1 3 Log The Logs tab shows the information and error messages registering the result of the communication requests of the LoRaWAN services Different communication protocols are used to configure the service All messages related to the transport layer of the service are identified as INFO or ERROR...

Page 125: ...d load new messages available The latest messages appear at the bottom of the viewer Figure Refresh button 8 1 4 Tools The Tools tab allows users to download the Device Node Keys associated with their account as well as generate the necessary token to configure your Loriot network server correctly 124 v7 5 ...

Page 126: ... clicking on the Download Nodes Keys button Figure Download Nodes Keys button Finally a token must be generated clicking on the Create New Key button in order to finish the Loriot service configuration Figure Create New Key button A pop up window will be displayed in which users must introduce a name to identify the new token Then clicking the Create button shows a password in a new window ready to ...

Page 127: ...Libelium Smart Parking Cloud Service Figure Generated key Once the token has been generated you can use it on Loriot backend as described in the Manage Loriot output data section 126 v7 5 ...

Page 128: ...ys If factory default keys are used then a CSV file exported from Libelium Cloud Services Manager SCM can be used to ease the bulk import into the LoRaWAN Network Server Please refer to the Smart Devices App chapter for further information about the Smart Devices App Please refer to the Libelium Cloud management chapter for further information about how to extract the factory default IDs keys 2 Sma...

Page 129: ...rect installation spot is the center of the parking slot to ensure the best detection It is possible to install the nodes on different parking slot configurations Parallel Perpendicular Angled Figure Parallel parking slots Figure Perpendicular parking slots 128 v7 5 ...

Page 130: ... surface installation Semi underground installation Underground installation Type of enclosure Vaulted Vaulted Flat Presence of node over the ground Full node 40 25 mm Part of node 6 mm Node completely buried 0 cm Rain immunity Yes Yes Partial Puddle immunity Yes Yes Detection may fail if puddle appears Vandalism robbery immunity Medium High High Snowplow immunity No Possible Yes Installation proc...

Page 131: ...4 holes as a reference to drill 4 little marks on the ground You can also draw 4 dots with ink Figure Marking the holes for the node Then continue with the chemical fixing installation step by step as described above Also in the next video you can see how the installation is done chemical fixing installation Step 1 Drill the holes The drill diameter must be W 14 mm minimum Try to drill as vertical a...

Page 132: ...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 Brush the hole step 3 Figure Blow out dust and loose materials steps 2 and 4 131 v7 5 ...

Page 133: ... anchor in the hole Once the anchor is correctly inserted some adhesive might exceed from the hole This residuary adhesive must be removed from the installation so the are no extra adhesive and the anchor installation is clean and smooth Figure Insert the anchors step 6 Step 7 Finish anchors installation The anchors have an internal thread to screw the screws Inserting the anchors with the screws ...

Page 134: ...s inside the anchors make sure that there is no dust in the internal thread of the anchor Install the node in its final position and screw the 4 special anti vandalism screws provided Anti vandalism screws are recommended to avoid problems anyone could unscrew a node if fixed with standard screws Figure Place the circle rubber and the node above it Figure Screw the node 133 v7 5 ...

Page 135: ...Deployment and installation Figure Final section of the anchor and screw 134 v7 5 ...

Page 136: ...use of snowplow equipment without affecting the Smart Parking node Also this kind of installation allows the client to deploy much safer networks against vandalism or theft as the device is not accessible directly from the outside Figure Snowplow vehicle For this special installation Libelium provides flat enclosures Contact your Sales agent to order flat enclosures Figure Flat Smart Parking enclosur...

Page 137: ... pavement hole Below the device a layer of cement must be spread to elevate the device to the correct horizontal position independently of the depth of the hole The diameter of the hole must be at least 202 mm Figure Placing the node in the hole Step 3 Fill the hole Finally the node needs to be fixed to the pavement using Epoxy resin commonly used for filling road fissures This resin should fill all t...

Page 138: ...it is crucial that the upper side of the enclosure is not covered with Epoxy or other material Only the side slides can be covered the center of the node must be clean to allow the radar signal work properly Figure Final Epoxy application Step 4 Start the node using the magnet Proceed with the Magnet start up process in order to initialize the node 137 v7 5 ...

Page 139: ...partially inserted in the ground and the vaulted enclosure minimizes the water issues The same underground installation steps must be followed as seen in the previous section In the node placement step the vaulted enclosure must exceed the horizontal pavement layer by 6 7 mm approximately The next figure shows how the node is placed Figure Semi underground node installation 138 v7 5 ...

Page 140: ...gnet resets waiting at least one second between each reset In the future need of resetting the node manually just a single magnet reset will be needed Once the node has been started it will begin to run the firmware step by step as explained in the How the node works section In the next video you can see how the magnet start up is performed magnet start up Figure Using the magnet to start the node ...

Page 141: ...ing slot is free On the left column you can appreciate the parking lot status during the execution On the right side you can see the frame types that are sent to the Smart Parking Cloud Service or to the Customer Server depending on parking slot status changes elapsed time and user configuration changes Figure Smart Parking node working example 140 v7 5 ...

Page 142: ...1 489 3 Ver 2 1 1 2017 03 EN 305 550 2 V1 2 1 2014 10 Draft EN 305 550 V2 1 0 2017 10 EN 300 220 1 V3 1 1 2016 11 EN 300 220 2 V3 1 1 2016 11 EN 62479 2011 UNE EN 62368 1 2014 AC 2015 AC1 2015 AC2 2015 AC 2017 03 A11 2017 10 2 FCC United States Smart Parking v2 US complies with Title 47 Part 15 subpart B of the FCC rules and regulations for Radio Frequency Devices Unintentional Radiators 2019 This...

Page 143: ...Safety Guides 11 Safety Guides 11 1 Smart Parking Chemical Fixing Cartridge 142 v7 5 ...

Page 144: ...Safety Guides 143 v7 5 ...

Page 145: ...Safety Guides 144 v7 5 ...

Page 146: ...Safety Guides 145 v7 5 ...

Page 147: ...Safety Guides 146 v7 5 ...

Page 148: ...Safety Guides 147 v7 5 ...

Page 149: ...Safety Guides 148 v7 5 ...

Page 150: ...Safety Guides 149 v7 5 ...

Page 151: ...Safety Guides 150 v7 5 ...

Page 152: ...Safety Guides 151 v7 5 ...

Page 153: ...Safety Guides 152 v7 5 ...

Page 154: ...Safety Guides 153 v7 5 ...

Page 155: ...k The Things Industries and MultiTech basestation s Embedded Network Server From v7 2 to v7 3 Added information to enable the integration of the following 3 LoRaWAN Network Servers into the Customer Server scenario The Things Network The Things Industries and MultiTech basestation s Embedded Network Server Added diagram and dimensions of the vaulted enclosure Added info about the Customer Server m...

Reviews: