View source for Template:Da3vid configuration example

{{DISPLAYTITLE: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

[[File:Da3vid.png|right|300px]]

__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>