CONTENTS
- Introduction
- 1. Prerequisites
- 2. Register Account
- 3. First Login Wizard
- 4. Create More Floors (Optional)
- 5. Create Resources
- 6. Configure Gateway
- 7. Add Device
- 8. Monitor Data
Introduction
UMA is a technology service company headquartered in the UK, primarily providing information and communication technology solutions and business support services to enterprises. The company's services cover various fields such as telecommunications, management consulting, and administrative support, focusing on helping clients achieve digital transformation and operational efficiency improvements.
This document mainly introduces how to integrate Milesight LoRaWAN gateways and end devices into the UMA platform.
1. Prerequisites
- Milesight Gateway: UG56/UG65/UG67, take UG65 as example
- Milesight Sensor Models: take AM308 and AM319 as examples
- Frequency Band Used in This Demonstration: 915M (8-15 channel)
2. Register Account
Visit https://askuma.ai/, click the "Book a demo" button, and fill out the information as prompted.
Once UMA’s staff receives the request, they will contact you further, and you will receive account details and MQTT Broker configuration information assigned to your platform.
3. First Login Wizard
Once you have received an account creation email from UMA, click on the link to set up your company’s subscription and set a password.
Visit https://vision.meetuma.ai/login to log in.
Follow the wizard to get started.
Set your company’s regional settings.
Create a building and floor(s) and your preferred floor (the default floor for your user account).
For demonstration purposes, I’ve configured a Milesight building as an example.
Set your company’s working hours.
Click Finish.
Click Go to Dashboard.
4. Create More Floors (Optional)
Next, create a Floor for the Building. For demonstration purposes, I’ve configured a Milesight building as an example.
Simply follow the steps shown in the screenshot:
In this example, we’ve created 4 floors, and the devices used for this demonstration will all be added to the first floor:
5. Create Resources
Now, create Resource records, and this step is mainly to configure the relationship between Sensors and Floors.
Follow the steps in the screenshot below:
Since we have two types of devices, we need to create two records, one for AM308 and one for AM319.
Below is a schematic of the relationship between Sensors, Floors, and Buildings:
At this point, the basic configuration on the UMA platform is complete. Next, we will configure our gateway.
6. Configure Gateway
6.1. Enable Embedded NS
Enable the Embedded NS on the device:
6.2. Create Custom Decode
Create a custom payload codec:
Select the template as AM308, then modify the default Decode code as shown in the screenshot below (ensure to add the required code from the platform before the return decode statement):
decoded.devEUI = LoRaObject.devEUI; decoded.rssi = LoRaObject.rxInfo[0].rssi; decoded.snr = LoRaObject.rxInfo[0].loRaSNR; decoded.data = LoRaObject.data; decoded.time = new Date().toISOString();
After created:
For more information about the payload codec feature, please refer to How to Use Payload Codec on Milesight Gateway.
6.3. Add AM308 and AM319
Follow the steps in How to Connect LoRaWAN Nodes to Milesight Gateway to add the devices.
Once added, the status will look like this:
Note: Ensure the Payload Codec is selected correctly.
Once configured, the Payload structure for the Sensors should appear as shown below:
6.4. Configure MQTT Parameters
Follow the steps to navigate to the MQTT configuration page:
Fill out the relevant information as shown in the screenshot (use the MQTT Broker parameters from Step 2):
Note:
1. Do not check the Data Retransmission option.
2. The Uplink Topic path is milesight.
3. The Downlink Topic path is milesight/downlink/$deveui.
With this, the operations on our gateway are complete.
7. Add Device
Return to the UMA platform interface and follow the steps shown below:
Note:
The ID here refers to the Device EUI data.
After clicking "ADD," the result will appear as follows:
With this, we can see that the data from AM308 and AM319 devices are now available on the platform.
8. Monitor Data
Return to the homepage Dashboard.
You can now see the data from the configured Building, Floor, and Devices as shown below:
-END-