Wiki source code of Fuel Level Monitoring

Version 3.1 by Hera Guo on 2024/11/27 16:23
Show last authors
1 **Table of Contents:**
2
3 {{toc/}}
4
5 = 1. About this demo =
6
7 This template is a display template for fuel level monitoring, in this template you can see the location of the tank, fuel capacity, temperature etc. and supports alarm settings. It has two levels of dashboards as shown below.
8
9 * **First Level - Overview for all tanks**:The **main state** is designed to monitor the remaining fuel and control the placement of tanks, device management, and the alarm system. This page contains the following elements:
10
11 The section with an //**interactive map**// displays the location of the tanks with the help of markers. The marker also informs about the current status of the sensor, namely: green - the sensor is in a normal state, and the rules for triggering alarms are not applied; yellow - low battery; red - at least one of the conditions for starting a warning, for example, a low level of fuel remaining or low/high temperature, is used; gray - the sensor  is in mode offline. To get more information, click on the tank marker - a popup with detailed information will appear.
12
13 The user can use the map filter - map switches that will help sort the display according to requirements.
14
15 The //**Tanks section**// is a list designed to display all existing tanks. You can delete or edit existing ones. The main list of “Tanks” contains the following data: “Total label”, “Remaining, %”, “Temperature”, “Battery”, “Connection” and action buttons. The user can create/add new sensors by clicking on the "+" button. To create a sensor, the user must go through the following steps: "General info", "Tank info," and "Set location". Note  That we provided the ability to add and define nine types of tanks, which we can calculate based on their geometric parameters. See detailed information in the **"Tank Creation"** paragraph.
16
17 The //**Alarms section**// is designed to display all alarms related to the remaining fuel level, temperature, and battery level. You can set the conditions under which alarms will be triggered by clicking the “Alarm Rules” button. By default, the following types of alarms are defined: “Low battery level”, “Low temperature”, “High temperature” and “Low remaining level”.
18
19 * **second Level - Sensor Level**: **Tank state** is designed to display information about a specific tank. This page contains the following elements: 
20
21 Fuel remaining display widget;
22
23 Section for displaying detailed tank information: “Tank Name”, “Serial number”, “Liquid type”, “Tank temperature”, “Battery level”, “Connection” and “Last Update”. Also, using the functionality of this section, you can edit the main fields - for this, click the "Edit" button, as well as change the location of the tank, and the marker on the map - by clicking on the "Edit Map" button;
24
25 The Consumption and remaining fuel section is a table with a list of consumption, remaining, and fuel replenishment. The ability to monitor the duration of refueling or filling the tank with fuel and the timestamp of the action has also been added;
26
27 The Remaining chart is designed to display the statistics of the tank's remaining and fuel consumption in the form of a graph, which is shown in terms of volume/% and time intervals;
28
29 The Alarm section is a list of alarms for a specific tank.
30
31 [[image:屏幕截图 2024-11-27 150313.png||height="394" width="756"]][[image:Arrow.png]][[image:屏幕截图 2024-11-27 150340.png||height="388" width="750"]]
32
33 = 2.Import Solution Template =
34
35 == 2.1 Get the json files ==
36
37 where to get:[[https:~~/~~/github.com/ThingsEye-io/te-platform/tree/main/Solution%20Template/Water%20metering>>https://github.com/ThingsEye-io/te-platform/tree/main/Solution%20Template/Water%20metering]]
38
39 what files to get:Download the three json files with the suffixes dashboard, deviceprofile, and rulechain.
40
41 == 2.2 Import rulechain/deviceprofile/dashboard ==
42
43 * **You will need to download and import the appropriate files**
44 * **In this solution, there are 3 rulechains, all of which need to be downloaded and imported**
45
46 [[image:屏幕截图 2024-11-27 101602.png]]
47
48 [[image:屏幕截图 2024-11-27 101909.png]]
49
50 === 2.2.1 Import rulechain ===
51
52 Firstly, we need to import the rule chain. The rule chain tells platform how we should handel the uplink and downlink for this device.
53
54 Open rule chains, click on the "+" in the upper right corner,
55
56 select "import rule chain", and then drag the downloaded JSON file with the suffix "_rule_chain" into the text box
57
58 [[image:屏幕截图 2024-11-26 174215.png||height="785" width="1542"]]
59
60 === 2.2.2 Import deviceprofile ===
61
62 At this step, we need to import the device profile first, as shown in the figure.
63
64 First, we need to open the device profiles, click on the "+" in the upper right corner, select "import device profile",
65
66 and then select the file with the suffix "_device_defiles" that we have already downloaded. Drag it into the text box.
67
68 [[image:屏幕截图 2024-11-26 175041.png||height="745" width="1545"]]
69
70 === 2.2.3 Import dashboard ===
71
72 Firstly, we need to open the dashboard module,
73
74 click on the "+" in the upper right corner, select "import dashboard",
75
76 then we shoud drag the downloaded _dashboard file into the text box.
77
78 [[image:屏幕截图 2024-11-26 175723.png||height="759" width="1548"]]
79
80 = 3.Connecting devices to thingseye =
81
82 Click the link below to connect the server to the platform：
83
84 [[https:~~/~~/wiki.thingseye.io/xwiki/bin/view/Main/How%20to%20connect%20my%20devices%20to%20ThingsEye%3>>https://wiki.thingseye.io/xwiki/bin/view/Main/How%20to%20connect%20my%20devices%20to%20ThingsEye%3F/]]
85
86 = 4.Change the deviceproflie of device =
87
88 When our import is complete, we need to replace the deviceprofile of the device we want to show with our newly imported deviceprofile.
89
90 [[image:屏幕截图 2024-11-26 180544.png||height="772" width="1551"]]
91
92
93 = 5.Check to see if the device is displaying properly on the dashboard =
94
95 [[image:屏幕截图 2024-11-27 150313.png||height="797" width="1532"]]
96
97 * Note: The dashboard will display properly only if our device has the key values **battery, fuelLevel, fuelHeight, temperature .**