Da³vid configuration example

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

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

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 "Basic" button under "Mode", which is located at the top-right corner of the WebUI.

Networking rutx manual webui basic advanced mode.gif

Before you connect the device to the gateway, 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 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:

  • 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 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 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: