Welcome to a step-by-step guide to using the Advanced LORIOT Network Ranger application.
The LORIOT Advanced Network Ranger application is a new standalone tool which stores and displays the relayed GPS and radio information of a LoRaWAN device and the relevant gateway(s) within range.
The Advanced Network Ranger application is available to dedicated customer as a hosted service or on-premise deployment. Please get in touch with firstname.lastname@example.org if you would like to test the solution or inquire an instance.
In this guide, we will demonstrate:
LoRaWAN devices are required to be back-end integrated by LORIOT to be compatible with the Advanced Network Ranger application.
We currently support the following LoRaWAN devices:
Adeunis Field Test Device ChipCAD Micromite ZANE GPS Devices
Additional LoRaWAN GPS devices will be integrated and supported by LORIOT. For a specific device you require to be integrated, please contact us at email@example.com
For device data to be displayed in the Network Ranger application, first we must add the compatible LoRaWAN device to our virtual application in the user dashboard.
This is based on the assumption you have already created a Network and added at least one gateway.
For the virtual application to route device data to the Advanced Network Ranger application, the virtual application requires to have WebSocket enabled in Application Outputs.
The default application output for a virtual application is already a WebSocket. If if it has previously been changed, the WebSocket must be re-enabled in Application Outputs.
LORIOT Networkserver v5.0+ enables multiple simultaneous application outputs for a single virtual application; therefore you can still output to your chosen output(s) in parallel to a WebSocket.
Gateway and Radio information must be included with a device payload for it to be displayed in the Network Ranger application. This feature is available to all accounts on the network server.
To guide the WebSocket Application output towards your advanced network ranger application you need to retrieve the Authentication Token from the Access Tokens dashboard in your LORIOT application.
It is also possible to generate a new Authentication Tokens or revoke previous tokens.
The Advanced Network Ranger application makes use of the OpenStreetMap API and Leaflet as the map provider to display the location of gateways and devices:
For the moment the map style can't be changed but its on our the roadmap to include a map style selection into the application.
The device uplink messages and the receiving gateways are displayed as icons on the map.
The elements can be selected with a mouse click to trigger advanced actions in the dashboard.
➜ There are the following noticeable features initially on the displayed on the map.
The color represents the spreading factor the device used to communicate with any gateway which received its packet:
Per default, the Advanced Network Ranger will automatically display every new uplink message received. It is possible to pause the live data stream by clicking the pause sign button in the menu bar.
After clicking the button it will change into a play icon to restart the stream.
The Advanced Network is able to store your historical GPS data up the limits defined during the installation or provided by the LORIOT infrastructure. The time picker allows you to load historical data into the application
The application will show the 100 latest transmissions after the initial load of the dashboard. To load more transmission simply click the "Load older transmissions" button in the left corner of the dashboard.
The Advanced Network Ranger allows users to download the data loaded in the application as CSV-file. To trigger the download use the following button in the menu bar.
The prepared csv-file will always contain the data selected in time picker, even if less data is displayed in the dashboard.
By selecting an uplink message and clicking the "Show only this device" Button in the detail pop-up window the application will show only uplink messages from this specific device:
After clicking the button, the application will only show uplink messages from the selected device and the selected device EUI will be visible in the menubar:
To remove the filter simply click the little "x" next to the device EUI.
With a device filter activated you can see it is possible to show tracks between a devices uplink messages. To activate the tracks just click the "Tracks" button in the menu bar.
Two uplinks from the same device are connected with a line if they have been received after each other within a 10 minute time frame.
When a device communicates with a gateway, it will transmit a radio packet including its GPS coordinates.
The gateway will upload this data to the Network Server, and the Network Ranger application will display the device location on the map including the device details;
We can view these details by selecting a device icon on the map:
We can see in the image above the gateway has received a transmission from the device.
The relevant data is displayed in the top left corner and a short description is also shown next to the gateway and device.
In the example below, the device packet has been received by two separate gateways and the gateway gwEUI identifies the gateways.
The Gateway receives a packet from a compatible Network Ranger device and it will display in the application.
Selecting the gateway icon will display the Spreading Factor and distance transmitted of a device packet.