ChirpStack is an open-source LoRaWAN Network Server which can be used to to setup LoRaWAN networks. ChirpStack provides a web-interface for the management of gateways, devices and tenants as well to setup data integrations with the major cloud providers, databases and services commonly used for handling device data. ChirpStack provides a gRPC based API that can be used to integrate or extend ChirpStack.
In most cases a ChirpStack LoRaWAN server is running on a private server for each protected area. However, more and more we see that organisations like African Parks and Peace Parks Foundation are using central LoRaWAN servers for better integration and maintenance. Smart Parks is also running a few “shared” ChirpStack server and also still provides local severs in case the network latency demands for it.
¶ ChirpStack v3 and v4
It is important to note that in 2022 Orne Brocaar has releases the 4th version of ChirpStack. This version has some major changes compared to v3 which may also impact the integration towards other applications. Many existing ChirpStack deployment are still running on v3, so it is important to use the correct documentation when working on this.
This Wiki will not try to copy the very complete original ChirpStack Wiki maintained by Orne Brocaar. We will only use this Wiki to highlight specific features, set-ups and use-cases that are relevant for the Smart Parks Stack.
The following example instructions will help you to understand how we use ChirpStack with the Smart Parks Stack. These are all examples based on ChirpStack version 3, as most of the deployments are still using this. Once version 4 is more actively used, we will update the examples accordingly. when confused, please check the original ChirpStack documentation 🔝.
- Ensure you have all the device credentials:
- Device name:
SP050099
- Device EUI:
0016C001F002E0AB
- Device-profile:
opencollar_edge_2
- In case your device profile is not there yet, please add a device profile first. This needs to be an OTAA device profile.
- Application Key:
53 D0 1A AE A3 61 ED D4 AD E6 64 4C 59 57 f3 91
- Navigate to the Application where you want to add the device.
- Hit the “+ CREATE” button in the top right corner.
- Add the OTAA device credentials:
- Device name
- Device Description
- Device-profile
- Add the correct device tags.
- Adding device tags
- payloadType = …
- ER = yes / …
- loracloud =
- Hit the “CREATE DEVICE” button in the bottom right corner.
- Now fill in the OTAA - Application Key (AppKey) and hit the “SET DEVICE-KEYS” button in the bottom right corner.
- You device in now added to the LoRaWAN server.
- Check if any JOIN messages are coming by using the LORAWAN FRAMES tab.
- If you do not see any data coming in, please trigger the device to reboot or otherwise start the JOIN procedure.
- When the device has JOINED the network, please check the DEVICE DATA tab for device messages.
- Ensure you have all the device credentials:
- Device name:
07001
- Device EUI:
353232335B387C1A
- Device-profile:
opencollar_lion_tracker_v1_ABP
- In case your device profile is not there yet, please add a device profile first. This need to be an ABP device profile.
- Device Address:
AD010395
- Network Session Key:
53 D0 1A AE A3 61 ED D4 AD E6 64 4C 59 57 f3 91
- Application Session Key:
53 D0 1A AE A3 61 ED D4 AD E6 64 4C 59 57 f3 91
- Navigate to the Application where you want to add the device.
- Hit the “+ CREATE” button in the top right corner.
- Add the ABP device credentials:
- Device name
- Device Description
- Device-profile
- Add the correct device tags.
- Adding device tags
- payloadType = …
- ER = yes / …
- loracloud =
- Hit the “CREATE DEVICE” button in the bottom right corner.
- Now fill in the ABP credential hit the “(RE)ACTIVATE DEVICE” button in the bottom right corner.
- Device address
- Network Session Key
- Application Session Key
- You device in now added to the LoRaWAN server.
- Check if any JOIN messages are coming by using the LORAWAN FRAMES tab.
- If you do not see any data coming in, please trigger the device to reboot or otherwise start the JOIN procedure.
- When the device has JOINED the network, please check the DEVICE DATA tab for device messages.
- Step 1
- Step 2
- Step 3
- Step 4
¶ Chirpstack Database Backup and Restore