Da³vid configuration example: Difference between revisions

From Teltonika Networks Wiki
m (BenasB moved page Da³vid embedded data configuration example to Da³vid configuration example without leaving a redirect)
No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The name da³vid stands for datapoint acquisition analysis and visualisation and is developed by "embedded data GmbH" in Germany.
{{Template:Da3vid_configuration_example}}
da³vid is a cloud and/or edge based, real-time IoT management software.
[[Category:IoT platforms]]
More information can be found here - https://www.embedded-data.de/produkt_david
 
__TOC__
==Introduction==
 
This article contains instructions on how to do a basic setup and configuration with a Teltonika device in order to connect to da³vid.
 
==Prerequisites==
 
You will need:
 
*A Teltonika device (RUT or TRB) with MODBUS support and internet connection
*A Embedded data GmbH da³vid software and license
 
==Configuring the device==
 
{{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer
| series = RUTX
}}
 
Before you connect the device to da³vid, you must first enable MODBUS by following these steps:
 
<ol>
  <li>Log into the device's WebUI.</li>
  <li>Navigate to Services → MODBUS.</li>
  <li>Enable the service and <b>Allow Remote Access</b> option.</li>
  <li>Press <b>Save & Apply</b>
</ol>
 
You may also change the <b>Port</b> and <b>Device ID</b>, but for this example we will be using the default values.
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_modbus.png|border|class=tlt-border]]
 
==Configuring da³vid==
 
Once logged into the portal, first add a new station.
 
===Adding a new station===
----
Before you start configuring the device, you must create a Station Group:
<ul>
  <li>Navigate to <b>Administration</b> on the side-menu.</li>
  <li>Find <b>Stationgroups</b> in the list.</li>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_8.png|border|class=tlt-border]]
 
<ol>
  <li>Press <b>Add new root group</b>.</li>
  <li>Enter the name of your group.</li>
  <li>Save the group.</li>
</ol>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_9.png|border|class=tlt-border]]
----
Then you can add the station.
 
<ul>
  <li>Navigate to <b>Administration</b> on the side-menu.</li>
  <li>Find <b>Stations</b> in the list.</li>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_7.png|border|class=tlt-border]]
 
<ol>
  <li>Enter the Station name of your device. Used for management purposes only.</li>
  <li>Select Default Dashboard for now, you can change it later.</li>
  <li>Select the previously created Station group.</li>
  <li>Press <b>Create new Station</b>.</li>
</ol>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_10.png|border|class=tlt-border]]
 
===Adding a MODBUS device===
Once a station has been created, we need to add a new MODBUS device for that station.
----
<ul>
  <li>Navigate to <b>Administration</b> on the side-menu.</li>
  <li>Find <b>Modbus Settings</b> in the list below.</li>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_1.png|border|class=tlt-border]]
 
<ul>
  <li>Press <b>New Connection.</b></li>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_2.png|border|class=tlt-border]]
 
 
<ul>
  <li>In this example we will be configuring using TCP/IP.</li>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_3.png|border|class=tlt-border]]
 
A device configuration window should appear. Here you should enter your device's details
 
<ol>
  <li>Enter the name of your device. Used for management purposes only.</li>
  <li>Enter the WAN IP of your device.</li>
  <li>Enter the Port of Modbus slave.</li>
  <li>Press <b>Save Connection</b>.</li>
</ol>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_4.png|border|class=tlt-border]]
 
After saving the new configuration, don't forget to Enable it.
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_5.png|border|class=tlt-border]]
 
Next, you need to add our MODBUS Slave.
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_6.png|border|class=tlt-border]]
 
A slave configuration window should appear. Enter your slave's details:
 
<ol>
  <li>Enter the name of your slave. Used for management purposes only.</li>
  <li>Enter the Slave address of your device which is identical to <b>Device ID</b> in MODBUS settings on WebUI.</li>
  <li>Adjust the timeout to your needs.</li>
  <li>Choose your device's station.</li>
  <li>Press <b>Save Connection</b>.</li>
  <li>Lastly enable the slave with the toggle above configuration.</li>
</ol>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_11.png|border|class=tlt-border]]
 
The device should be connected to da³vid. To do a simple check, you can try to pull some data from the device following the steps below.
 
===Configuring information output===
----
For this example, we are going to retrieve <b>System uptime</b> from our device. First, we need to create a new datapoint:
 
 
<ol>
  <li>In the Administration page, find <b>Datapoints</b> section and press on <b>Create</b>.</li>
</ol>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_16.png|border|class=tlt-border]]
 
A new window should appear for creating a datapoint:
 
<ul>
  <li>Select <b>Create metadata for single datapoint</b>.</li>
  <li>Configure the data point:</li>
  <ol>
    <li>Enter Datapoint ID, used for management purposes</li>
    <li>Enter the name, used for management purposes</li>
    <li>Select <b>Double</b> data type.</li>
  </ol>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_12.png|border|class=tlt-border]]
 
You can leave the rest of the configuration default.
----
Once the datapoint is created, we can add it to our Modbus Slave:
 
<ul>
  <li>Navigate to Administration → Modbus settings → Edit your device → Slaves → Word-Addresses.</li>
  <li>Press <b>New Address</b>.</li>
  <li>A new side menu should appear for configuring the address:</li>
  <ol>
    <li>Enter the Modbus address of System uptime, on Teltonika devices it is <b>1</b>.</li>
    <li>Select the data type. Uptime address is represented by 32 bit unsigned int, so select <b>FC03 - BIT32_CDAB_REGISTER_RO_UNSIGNED</b>.</li>
    <li>Select your previously created datapoint - Uptime.</li>
    <li>Leave the rest default and Save.</li>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_13.png|border|class=tlt-border]]
 
Lastly, add the datapoint to your station:
 
<ul>
  <li>Navigate to Administration → Stations → Edit your device → Stationdatapoints.</li>
  <li>Press <b>Add Datapoint</b>.</li>
  <li>New section should appear, find your Uptime datapoint in the list.</li>
  <li>Press <b>Add datapoint</b>.</li>
</ul>
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_14.png|border|class=tlt-border]]
 
==Results==
 
If everything was configured correctly, you should now see the device Uptime in the datapoint list.
 
[[File:Networking_rutos_configuration_examples_david_embedded_data_15.png|border|class=tlt-border]]
 
==Troubleshooting==
 
If you are unable to retrieve data from your device, make sure you have configured everything properly:
<ul>
  <li>Make sure your device has WAN access.</li>
  <li>Check if the MODBUS configuration is correct in device's WebUI.</li>
  <li>Recheck the portal configuration steps.</li>
</ul>
 
==Additional sources==
You can find MODBUS addresses used on Teltonika devices here:
<ul>
  <li>https://wiki.teltonika-networks.com/view/Monitoring_via_Modbus</li>
</ul>

Latest revision as of 14:12, 2 August 2023

Main Page > General Information > Configuration Examples > Third party services > IoT platforms > Da³vid configuration example


The name da³vid stands for datapoint acquisition analysis and visualisation and is developed by "embedded data GmbH" in Germany. da³vid is a cloud and/or edge based, real-time IoT management software. More information can be found here - https://www.embedded-data.de/produkt_david

Introduction

This article contains instructions on how to do a basic setup and configuration with a Teltonika device in order to connect to da³vid.

Prerequisites

You will need:

  • A Teltonika device (RUT or TRB) with MODBUS support and internet connection
  • A Embedded data GmbH da³vid software and license

Configuring the device

If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on "Advanced WebUI" mode. You can do that by clicking the "Advanced" button, located at the top of the WebUI.

Before you connect the device to da³vid, you must first enable MODBUS by following these steps:

  1. Log into the device's WebUI.
  2. Navigate to Services → MODBUS.
  3. Enable the service and Allow Remote Access option.
  4. Press Save & Apply

You may also change the Port and Device ID, but for this example we will be using the default values.

Configuring da³vid

Once logged into the portal, first add a new station.

Adding a new station


Before you start configuring the device, you must create a Station Group:

  • Navigate to Administration on the side-menu.
  • Find Stationgroups in the list.

  1. Press Add new root group.
  2. Enter the name of your group.
  3. Save the group.


Then you can add the station.

  • Navigate to Administration on the side-menu.
  • Find Stations in the list.

  1. Enter the Station name of your device. Used for management purposes only.
  2. Select Default Dashboard for now, you can change it later.
  3. Select the previously created Station group.
  4. Press Create new Station.

Adding a MODBUS device

Once a station has been created, we need to add a new MODBUS device for that station.


  • Navigate to Administration on the side-menu.
  • Find Modbus Settings in the list below.

  • Press New Connection.


  • In this example we will be configuring using TCP/IP.

A device configuration window should appear. Here you should enter your device's details

  1. Enter the name of your device. Used for management purposes only.
  2. Enter the WAN IP of your device.
  3. Enter the Port of Modbus slave.
  4. Press Save Connection.

After saving the new configuration, don't forget to Enable it.

Next, you need to add our MODBUS Slave.

A slave configuration window should appear. Enter your slave's details:

  1. Enter the name of your slave. Used for management purposes only.
  2. Enter the Slave address of your device which is identical to Device ID in MODBUS settings on WebUI.
  3. Adjust the timeout to your needs.
  4. Choose your device's station.
  5. Press Save Connection.
  6. Lastly enable the slave with the toggle above configuration.

The device should be connected to da³vid. To do a simple check, you can try to pull some data from the device following the steps below.

Configuring information output


For this example, we are going to retrieve System uptime from our device. First, we need to create a new datapoint:


  1. In the Administration page, find Datapoints section and press on Create.

A new window should appear for creating a datapoint:

  • Select Create metadata for single datapoint.
  • Configure the data point:
    1. Enter Datapoint ID, used for management purposes
    2. Enter the name, used for management purposes
    3. Select Double data type.

You can leave the rest of the configuration default.


Once the datapoint is created, we can add it to our Modbus Slave:

  • Navigate to Administration → Modbus settings → Edit your device → Slaves → Word-Addresses.
  • Press New Address.
  • A new side menu should appear for configuring the address:
    1. Enter the Modbus address of System uptime, on Teltonika devices it is 1.
    2. Select the data type. Uptime address is represented by 32 bit unsigned int, so select FC03 - BIT32_CDAB_REGISTER_RO_UNSIGNED.
    3. Select your previously created datapoint - Uptime.
    4. Leave the rest default and Save.

Lastly, add the datapoint to your station:

  • Navigate to Administration → Stations → Edit your device → Stationdatapoints.
  • Press Add Datapoint.
  • New section should appear, find your Uptime datapoint in the list.
  • Press Add datapoint.

Results

If everything was configured correctly, you should now see the device Uptime in the datapoint list.

Troubleshooting

If you are unable to retrieve data from your device, make sure you have configured everything properly:

  • Make sure your device has WAN access.
  • Check if the MODBUS configuration is correct in device's WebUI.
  • Recheck the portal configuration steps.

Additional sources

You can find MODBUS addresses used on Teltonika devices here: