Water Level
Introduction
In this project you will be directed to create a water level usecase. You need a water level device that has been integrated with Antares. You are asked to group devices based on the application name and device name into the water level usecase group. This process is called Integrate Device in the Antares Insight Hub service.
Prerequisites
Before starting the project, make sure you have followed the mandatory prerequisites. Here is the prerequisite page that needs to be prepared.
Water Level Usecase PrerequisitesWater Level Usecase Creation Steps
1. Integrate Device
1.1. Open Usecase Water Level Menu
On the left navigation bar, select ‘Usecase’. Then on the Usecase menu select ‘Water Level’.
1.2. Do Device Integration
On the Water Level Usecase Page, Click ‘Integrate’ then a pop up form will appear.
Next, fill in the Integrate Device form by filling in the ‘Application Name’, select ‘Device Name’ then fill in other data such as Decoder Type, Device Label, Serial Number, Address and Map Location.
Make sure the Decoder Type matches the type of Device you are using.
The following is an explanation of the Integrate Device form parameters:
No. | Data Type | Description |
---|---|---|
1. | Usecase | Select the usecase according to your needs. There are 3 (three) usecase options, namely Power Meter, Water Meter, and Water Level. |
2. | Application | After creating an application, you can use the application in a usecase |
3. | Device | After adding the device to the application, select the device for the usecase you will be using. |
4. | Device Label | Create labels for the devices you will use |
5. | Decoder Type | A decoder option is provided by Antares. The decoder serves to ensure that the payload used by the user matches the format used by Antares. |
6. | Serial Number | Enter the serial number for the device you will be using |
7. | Address | Provide the address that will be used for your usecase |
8. | Map Location | Select the coordinates on the map according to the address you have listed |
Make sure the data filled in the form is correct. After filling in the data on the Integrate Device form, then click ‘Integrate’.
Once you have successfully integrated the device, the display will change as shown below.
1.3. See Device Detail
On the usecase page, you can view data from particular devices that have been successfully integrated. To view data from a particular device, click the device that you have integrated to see more data information.
The following is a detailed view of the device that has been opened.
2. Testing Payload
To ensure the Antares Insight service is working properly, make sure the payload sent by the user's device matches the format specified in Antares Insight. You can then follow the steps below to use the Payload Decoder feature.
2.1. Choose Payload Decoder
On the left navigation bar, click the ‘Usecase’ menu then select ‘Water Level’. After opening the Water Level Usecase page, click ‘Payload Decoder’.
A popup will appear as shown below, select the decoder you want to use.
There are several decoders provided by Antares. You can customise the decoder selection according to your device type.
2.2. Input Data Payload
You can see an example payload based on the device recommendation on the following page.
Payload Example Water LevelEnter the payload for your device in the ‘Input Decoder’ field. After entering the payload, click the ‘Submit’ button.
Payloads that have been customised to the format used in Antares will automatically appear in the ‘Decoder Results’ column.
3. Setup Device Threshold
In this section you can set the threshold for alert notification. You can enter a maximum of 3 data parameters that you want to be used as alert notifications. You can also limit it to a maximum of 3 threshold points. For more details you can see it on the following page.
Setup Device Threshold Water LevelManage Usecase
1. Edit Device Usecase
In this section you can edit usecase data details such as ‘Application Name’, ‘Device Name’, Decoder Type, Device Label, Serial Number, Address and Map Location that you previously filled in when filling out the integrate device form. On the Water Level Usecase page, select the device you want to edit as shown below.
On the selected device page click ‘Edit Details’, then the Edit Integrate device popup form will appear.
You can rearrange the device usecase data as needed.
2. Edit Device Water Level
In this section, you can edit the device in the application antares. You can change the subscription package, set LoRa, and view other data. On the Water Level Usecase page, select the device you want to edit as shown below.
On the selected device page click ‘Config’, then you will be directed to the device page that you want to configure.
You can configure devices such as ‘Set LoRa’, ‘Webhhok’, ‘Subscription’, and view other data details.
Last updated