Libelium Waspmote Smart Parking v2 Quick start guide

INDEX
Document version: v7.5 - November 27, 2019
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. Introduction ......................................................................................................... 6
2. Network architecture ........................................................................................... 7
2.1. Smart Parking node ............................................................................................. 8
2.2. LoRaWAN base station ......................................................................................... 8
2.3. LoRaWAN Network Server ..................................................................................... 8
2.4. Libelium Smart Parking Cloud Service and Customer Server ........................................ 9
3. Smart Parking node .............................................................................................. 11
3.1. Hardware description........................................................................................... 11
3.1.1. Node versions ......................................................................................... 13
3.1.2. LoRaWAN regions..................................................................................... 13
3.1.3. LoRaWAN protocol and parameters ............................................................. 13
3.1.4. Identification label.................................................................................... 14
3.2. Power and time consumption ................................................................................ 14
3.2.1. Smart Parking EU ..................................................................................... 15
3.2.2. Smart Parking US ..................................................................................... 15
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 frames ................................................... 24
3.7.3. Understanding night-mode ........................................................................ 24
3.7.4. Understanding RTC synchronization ............................................................ 25
3.7.5. Understanding uplink frames format (real example) ....................................... 26
3.7.6. Factory default values ............................................................................... 27
3.7.7. Configure new parameter values................................................................. 28
4. Libelium Cloud management ................................................................................ 29
4.1. Introduction to the Libelium Services Cloud Manager - SCM ........................................ 29
4.2. SCM account ...................................................................................................... 30
- 2 - v7.5

INDEX
4.2.1. Creating an account.................................................................................. 30
4.2.2. Signing in ............................................................................................... 31
4.3. Smart Parking nodes registration ........................................................................... 32
4.4. Editing Smart Parking nodes.................................................................................. 33
4.5. Export CSV file with nodes credentials ..................................................................... 34
5. Smart Devices App................................................................................................ 36
5.1. How to install the Smart Devices App ...................................................................... 36
5.1.1. Start Smart Devices App on Windows........................................................... 37
5.1.2. Start Smart Devices App on GNU/Linux ........................................................ 38
5.1.3. Start Smart Devices App on MacOSX ............................................................ 38
5.2. Upgrading the Smart Devices App .......................................................................... 38
5.3. Smart Parking v2 ................................................................................................ 38
5.3.1. How to plug the Smart Parking node............................................................ 39
5.3.2. Configuration .......................................................................................... 39
5.3.3. Programmer (change node parameters) ....................................................... 40
5.3.4. Firmware upgrade .................................................................................... 41
5.3.5. Factory Reset .......................................................................................... 43
6. LoRaWAN Network 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 devices manually............................................................ 55
6.2.4. Nodes batch provisioning in Actility ............................................................. 56
6.3. The Things Network (TTN) ..................................................................................... 58
6.3.1. Log in .................................................................................................... 58
6.3.2. Manage gateways .................................................................................... 60
6.3.3. Manage applications................................................................................. 62
6.4. The Things Industries (TTI) .................................................................................... 70
6.4.1. Log in .................................................................................................... 70
6.4.2. Manage gateways .................................................................................... 71
6.4.3. Manage applications................................................................................. 73
6.5. MultiTech basestation .......................................................................................... 82
6.5.1. Libelium’s Custom App .............................................................................. 82
6.5.2. Compatible firmware versions .................................................................... 87
6.5.3. Installing/upgrading Custom App ................................................................ 87
- 3 - v7.5

INDEX
7. Customer Server................................................................................................... 92
7.1. Installation ......................................................................................................... 93
7.1.1. Docker ................................................................................................... 93
7.1.2. Server .................................................................................................... 93
7.2. Deploying .......................................................................................................... 93
7.2.1. Docker ................................................................................................... 93
7.2.2. Server .................................................................................................... 94
7.3. Configuring the application ................................................................................... 95
7.3.1. How to configure Loriot............................................................................. 97
7.3.2. How to configure Actility............................................................................ 98
7.3.3. How to configure The Things Network (TTN) .................................................. 98
7.3.4. How to configure The Things Industries (TTI).................................................100
7.3.5. How to configure a MultiTech basestation.....................................................102
7.4. Making the server accessible from anywhere ............................................................103
7.4.1. Configuring a domain pointing to the customer server ....................................103
7.5. Remote Configuration Form ..................................................................................103
7.6. Customer Server Core ..........................................................................................105
7.6.1. End-point ...............................................................................................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 ................................................................................115
8.1.3. Log........................................................................................................123
8.1.4. Tools .....................................................................................................124
9. Deployment and installation .................................................................................127
9.1. Step-by-step guideline..........................................................................................127
9.2. How to place the nodes ........................................................................................128
9.3. Node installation .................................................................................................129
9.3.1. Triple installation option ............................................................................129
9.3.2. On-surface node installation ......................................................................130
9.3.3. Underground node installation ...................................................................135
9.3.4. Semi-underground node installation............................................................138
9.4. Node start-up .....................................................................................................139
9.5. Working example ................................................................................................140
- 4 - v7.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

Introduction
1. Introduction
The Smart Parking v2 solution developed by Libelium allows citizens to detect available parking slots.
Figure : Smart Parking node developed by Libelium
The node applies intelligent algorithms to detect changes in the state of the parking slot. Then data is transmitted
with the LoRaWAN radio to the final server.
Figure : Simplified Smart Parking 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 certainly know when objects are placed over the device. The next table shows a comparative analysis of the
current sensor technologies in the Smart Parking market:
- 6 - v7.5

Introduction
Radar Infra-red Magnetometer
Reliability against nearby vehicle movement
Reliability against nearby parked vehicles
Reliability against electromagnetic interferences
Reliability in any lighting scenario
Stability during long-duration 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 side.
Figure : Remote Configuration Form
- 6 - v7.5

Network architecture
2. Network architecture
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

Network architecture
2.1. Smart Parking node
The Smart Parking node is the device installed in each parking slot. When the device detects a change of the parking
slot status (free/occupied), it sends a frame to the LoRaWAN base station.
Figure : Smart Parking node
2.2. LoRaWAN base station
The LoRaWAN base station (also known as gateway) must be installed in the surrounding area next to the parking
nodes. It receives data and forwards it to the LoRaWAN Network Server.
Libelium distributes base stations for LoRaWAN networks. All of them have LoRaWAN connection; some feature
Ethernet, 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
the network. Each node must be registered with an identifier and some encryption keys so the Network Server can
receive and decrypt the packets successfully.
The LoRaWAN Network Server purpose is to translate data from the LoRaWAN wireless network to an IP network.
Therefore, when Smart Parking nodes packets are received, a callback is performed in order to send data to the
- 8 - v7.5

Network architecture
Libelium Smart Parking Cloud Service or to the Customer Server.
2.4. Libelium Smart Parking Cloud Service and Customer
Server
The LoRaWAN Network Server connects to the final server, which can be the Libelium Smart Parking Cloud Service
or the Customer Server.
The LoRaWAN network servers currently supported are:
‚Loriot
‚Actility
‚The Things Network
‚The Things Industries
‚The Embedded Network Server inside MultiTech base stations
If the customer wants to use a new LoRaWAN Network Server, then the Data Parser block must be modified in
order to receive data properly. Keep in mind that each Network Server implements its own HTTPS callback using a
different format.
The Remote Configuration 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 mandatory that the user sets up her own server to host the
Customer Server. Read the “Customer Server” chapter for further information.
‚The Smart Parking Cloud Service is a software service provided by Libelium which permits to receive,
decode and redirect the data to the final 3rd party IoT cloud (Amazon, Azure, etc). This retransmission is
done thanks to the cloud connectors running on another Libelium Cloud’s service: the Bridge. Read the
“Libelium Smart Parking Cloud Service”chapter for further information.
- 9 - v7.5