Difference between revisions of "Da³vid configuration example"

From Teltonika Networks Wiki
(Created page with "da³vid embedded data GmbH is a cloud based, real-time IoT management gateway. More information can be found here - http://www.embedded-data.de/produkt_david __TOC__ ==Introd...")
 
(Replaced content with "{{Template:Da3vid_configuration_example}}")
Tag: Replaced
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
da³vid embedded data GmbH is a cloud based, real-time IoT management gateway. More information can be found here - http://www.embedded-data.de/produkt_david
+
{{Template:Da3vid_configuration_example}}
 
 
__TOC__
 
==Introduction==
 
 
 
This article contains instructions on how to do a basic setup and configuration with a Teltonika device in order to connect to your da³vid embedded data gateway.
 
 
 
==Prerequisites==
 
 
 
You will need:
 
 
 
*A Teltonika device (RUT or TRB) with MODBUS support and internet connection
 
*A da³vid embedded data GmbH gateway
 
 
 
==Configuring the device==
 
 
 
{{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer
 
| series = RUTX
 
}}
 
 
 
Before you connect the device to the gateway, 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 the da³vid embedded data GmbH gateway==
 
 
 
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 embedded data GmbH gateway. 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_11.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.</li>
 
  <li>Check if the MODBUS configuration is correct in device's WebUI.</li>
 
  <li>Recheck the portal configuration steps.</li>
 
</ul>
 

Revision as of 10:34, 8 November 2021

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

Da3vid.png

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.

Networking rutos manual webui basic advanced mode 75.gif

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.

Networking rutos configuration examples david embedded data modbus.png

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.

Networking rutos configuration examples david embedded data 8.png

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

Networking rutos configuration examples david embedded data 9.png


Then you can add the station.

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

Networking rutos configuration examples david embedded data 7.png

  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.

Networking rutos configuration examples david embedded data 10.png

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.

Networking rutos configuration examples david embedded data 1.png

  • Press New Connection.

Networking rutos configuration examples david embedded data 2.png


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

Networking rutos configuration examples david embedded data 3.png

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.

Networking rutos configuration examples david embedded data 4.png

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

Networking rutos configuration examples david embedded data 5.png

Next, you need to add our MODBUS Slave.

Networking rutos configuration examples david embedded data 6.png

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.

Networking rutos configuration examples david embedded data 11.png

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.

Networking rutos configuration examples david embedded data 16.png

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.

Networking rutos configuration examples david embedded data 12.png

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.

Networking rutos configuration examples david embedded data 13.png

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.

Networking rutos configuration examples david embedded data 14.png

Results

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

Networking rutos configuration examples david embedded data 15.png

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: