Тема: Free remote tank monitoring software + Eurosens fuel level sensors

Remote fuel level monitoring of fuel storages is a popular task in GPS tracking industry.  Usually GPS tracking provider is dealing with a fleet of vehicles and either own  or  rent commercial GPS tracking software with vehicle-specific reports .  It can be used for stationary objects monitoring however 90% of software features would never been used (geofences, special fleet reports, etc). So if there is a chance to save some money?

There are instructions how to build the most cost-effective remote tank monitoring solution with the free, open-source Thingsboard IOT-platform. Despite being free, it supports a lot necessary features:
• Display the remaining amount fuel in the tanks;
• Display of the fuel volume history in graphical and tabular form;
• Generation of events (high / low level);
• Email-notifications;
• Configuring user access rights.

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

2

Re: Free remote tank monitoring software + Eurosens fuel level sensors

The choice of equipment is determined by the fact that the Thingsboard server is able to receive data via the MQTT protocol, which is widely used to transfer data on the Internet of Things. But popular GPS trackers don't support it. Well, it's okay, in this project we don’t need GPS anyway.

To monitor fuel in a fuel storage, we recommend two options:

1. Eurosens Dominator RS fuel level sensors are installed in each tank, connected to the Eurosens Modem data transmission device via RS485 interface.
The modem polls the sensors and transmits volume information to the server via cellular communication (GPRS). Eurosens Modem also supports up to 4 security sensors - door opening, flooding, smoke, vibration and other discrete states. Their states are transmitted to the server as “1” or “0”. Security sensors have a 433 MHz radio interface, EV1527 codec, they are wireless, are very inexpensive and you can find them on Aliexpress.

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

3 (2020-08-27 19:15:18 отредактировано Mechatronica)

Re: Free remote tank monitoring software + Eurosens fuel level sensors

2. A wireless Eurosens Dominator Bt fuel level sensor can be installed in each tank. In the room where the stable reception of the radio signal from the sensors is to be ensured, we install an Android tablet or a smartphone permanently connected to an external power supply. Eurosens Tank Monitor application is running, which receives data from sensors using the Dominator BLE protocol, displays the fuel volume on an interactive diagram, and also transmits information to the server using the MQTT protocol via the Internet (using Wi-Fi or 3G cellular networks).

The second option is much easier to install if you can find a good place to install your Android tablet. The transmission distance from the Dominator Bt fuel level sensor is up to 200 meters within the line of sight.

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

4

Re: Free remote tank monitoring software + Eurosens fuel level sensors

As mentioned above, the Thingsboard Community Edition server software is free - you can download and install it on your own, providing customers with access to it, or each customer can install their own version of the server.

The installation procedure is described here

https://thingsboard.io/docs/user-guide/ … n-options/

After installation, you can login as System Administrator with credentials : sysadmin@thingsboard.org / sysadmin

1

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

5

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Create accounts of data administrators - Tenants.

More info – there  https://thingsboard.io/docs/user-guide/ui/tenants/


2

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

6

Re: Free remote tank monitoring software + Eurosens fuel level sensors

After creating an account, click the Manage tenant admins icon and create an Tenant user. Select activation method - display the link (Display activation link) and click Add


3

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

7

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Go to the activation link

4

Create password for tenant

5

Password should contain at least 6 characters. Then main tenant dashboard will appear.

6

Objects in Thingsboard are structured like a tree. Objects and ares are called Assets. For example, the District Object includes the Building object, which in turn can include the Floors and Rooms objects. Incoming data goes to a device type object (Devices). Devices are owned by some assets . We can set the hierarchy, the names of classes, relationship between objects.

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

8

Re: Free remote tank monitoring software + Eurosens fuel level sensors

For example, consider monitoring one asset, which is a fuel storage site with 2 tanks installed. Each tank contains one Dominator Bt fuel level sensor, data from which are transmitted to the server via a tablet and the Eurosens Tank Manager program.

In this case, we will have only one asset (site) and 2 devices (Tank №1 and Tank №2).
Let's start by creating the first device and checking that data is coming to it. Go to the Devices menu and click the “+” icon. Set the device name (Tank №1), device type (sensor), in the Description field you can add other information about the device.

7

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

9

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Now we have a first device of sensor type. It can receive data by MQTT protocol.

8

You must assign it a unique identification number. To do this, click on it, and select Manage credentials in the device properties menu. In the Access token field, type the MAC address of the Eurosens Dominator Bt sensor, which is installed in tank # 1.


9

Now we can open Latest telemetry tab. If Android tablet is sending some sensor data now – you will see the latest data here.


10

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

10

Re: Free remote tank monitoring software + Eurosens fuel level sensors

In the same way we create the second sensor with its unique MAC-address identifier.

11

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

11

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Now let's move on to data visualization. We create the “Fuel storage site1” asset - the first site with fuel lubricants tanks. Let's assign the asset type - Fuel site (probably in the future we will have other types of sites, for example, diesel generators).


12

Click on the asset and open its properties. Go to the Attributes section and assign field values:
latitude, type Double.
longitude, type Double
Imageurl (http link to image or asset plan) , type String.

13

Now we need to create a dashboard - an operator interface.
Go to the Dashboards section and click “+”to add new dashboard. We give it a name.


14

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

12

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Open the dashboard, which does not yet have a single element (widget). Select the Maps widget, the Latest values type - Openstreetmap. Click on it to select.

15


You will need to select the data to display on the map. We want to display all our assets on the map. So far, this is one site with fuel tanks, but there will be several of them in the future. This means that the system will have to display all objects. For this, the concept of Alias is used. Let's create the first alias.


17

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

13

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Create an alias Fuel storages. It includes all “Fuel site” assets that start with Fuel. The "Resolve as multiple entities" checkbox means that the alias includes multiple assets.


18


After choosing an alias to display on the map, you need to set the asset parameters: its latitude and longitude. To do this, type the latitude text field and press enter, the same with longitude.

19

On the Advanced tab, you can select an icon to display the asset on the map

20

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

14

Re: Free remote tank monitoring software + Eurosens fuel level sensors

We save the changes and see our object on the added widget

21

Let's create another one dashboard. We want it to open when clicking on the asset icon on the map. And it will display fuel volume information – actual and historic data.
To do this, click on the layers icon at the top left (Manage dashboards states). And create a new state of the dashboard. In the Name field, enter $ {entityName}, in the State id field, create the name of the new dashboard layer - Fuel storage site, i.e. detailed view of the fuel storage area. We do not set the Root state tick - it designates the dashboard layer that is launched by default at startup.


22

After creating a new dashboard layer, go to the properties of the map widget. In the Actions tab, select the action (Action source), which switches to a new layer - On marker click. We give the action a name - for example, opensite. Select the type of action - navigate to new dashboard state and indicate which dashboard to go to – recently created Fuel storage site. Check the Set entity from widget with the checkbox and save the changes. Now, when you click on the icon on the map, a new widget opens, which is still empty.

23

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

15

Re: Free remote tank monitoring software + Eurosens fuel level sensors

It contains only site pucture from imageurl link

99


Here we want to see graphs of the volume of fuel in the tanks. Add a new Charts widget, choose Time series and the type of chart you like the most.

24


To display the graph, set an alias - all sensor type devices that begin with “Tank”.

25

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

16 (2020-08-27 18:49:06 отредактировано Mechatronica)

Re: Free remote tank monitoring software + Eurosens fuel level sensors

After setting the alias, we specify which parameters to display on the chart. All sensors send the fuel parameter (fuel volume in the tank) and fuel temperature t. We type these parameters, confirming the input of each with the Enter key.


26

The labels, display of each of the parameters can be changed, as well as the color of the graph.

27

Now we have a fuel volume and temperature plot.

98

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

17 (2020-08-27 18:52:28 отредактировано Mechatronica)

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Likewise, add the Digital gauge widget to display each of the gauges separately.

Alias in this case will include a set of one sensor (Tank # 1 and Tank # 2)

30


28

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

18

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Now let's set up event handling. We need notification of low fuel level in any tank.
Events are defined in the Rule Chains section - rule chains. One of the chains is marked as Root and is the algorithm start point.



31

For more details on the powerful means of defining events in Thingsboard, read the tutorial. We suggest simply importing ready-made Rule Chains. Download Low fuel and low fuel email chains.

32

Open Low fuel rule chain in built-in editor.

33

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

19

Re: Free remote tank monitoring software + Eurosens fuel level sensors

It is intuitively clear that the script checks if the volume of fuel in the tank is low. If it is true, an alarm event is generated (Create alarm) and the chain for sending an email notification is started. If the fuel level is OK, then the existing alarm event (if any) is removed.

If we open the script, we will see that it consists of one line, where the value from the sensors is compared with 10. Thus, the script is triggered if the value from the sensor is <10 and here this value can be changed.

34

The Low fuel email chain called to send an email notification is very simple and consists of two blocks. The first one describes the content of the message and its headers, the second (SendGrid SMTP) specifies the SMTP server settings. The system default settings can be used, which are configured through the Thingsboard system administrator interface.

35

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

20 (2020-08-27 19:01:49 отредактировано Mechatronica)

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Now we need to connect the Low fuel chain to the Root rule chain.
Having opened the Root rule chain, we see the following default workflow of Thingsboard engine.

38

On the left in the menu, select the Rule chain block and drag it to the algorithm field. We choose a name for the chain - it must match the name of the chain that we want to start. This block is a link to it.

39

Next, we connect the output of the Message type Switch to the input of the new block.

40

Select the transmitted data - Post telemetry.It means data from the sensors is transmitted to our chain.

41

The chain is connected. Now, a check for low fuel balance will be launched as a part of Thingsboard workflow, and, if a new warning is present, will launch the chain for sending an email notification.

42

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

21 (2020-08-27 19:05:46 отредактировано Mechatronica)

Re: Free remote tank monitoring software + Eurosens fuel level sensors

The operation of the event detector can be checked by  Alarms tab of device properties section. All notifications generated by the workflow will be displayed here.

Now let's add this information to the dashboard. Go to the dashboard window and add a widget of the Alarm widget type.

45

In the widget settings, select Alarm source - Entity. And set the alias, describing the objects for notifications - Fuel storages.
New tab will appear on the dashboard.

46

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

22

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Same widget you can place on the main dashboard (with the map).

47

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

23

Re: Free remote tank monitoring software + Eurosens fuel level sensors

Now you need to create user accounts. In the Customers menu, create a customer - a company whose employees will be users of the system.


48

After creating the company, click on the Manage customer users icon and create a user who will log in to the system as a user.

49

We go through the stage of user activation through a link. Upon completion, we get to the system user screen. There is no access to assets and dashboards yet.

50

We go back as an Administrator (Tenant user) to the Assets section, select the required assets and click the Assign assets to Customer icon. And choose the company.

51

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru

24

Re: Free remote tank monitoring software + Eurosens fuel level sensors

We do the same with devices (Devices) and dashboards. After assigning them to the user, you can log in under the created user and see the results.

52


User can only view data but doesn’t have rights to modify dashboards or assets.

We've shown you only the most basic thingsboard features. We recommend that you watch the video on the developer channel and repeat the examples indicated there.

https://www.youtube.com/watch?v=0io1YnQjIwA
https://www.youtube.com/watch?v=mqWEGs1Z2BQ
https://www.youtube.com/watch?v=TyUKx5rNJSs

The system supports embedded programming using Javascript, so you can modify the platform, create your own dashboards and data processing algorithms.

Welcome to the GPS tracking news telegram channel
EN: https://t.me/telematics
RU: https://t.me/telematicsru