Jump to content
  • EN

Da³vid configuration example: Difference between revisions

← Older edit
VisualWikitext
No edit summary
No edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:da³vid configuration example}}
{{Template:Da3vid_configuration_example}}
 
[[Category:IoT platforms]]
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>
Retrieved from "https://wiki.teltonika-networks.com/view/Da³vid_configuration_example"