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}} |
− | | + | [[Category:IoT platforms]] |
− | __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_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>
| |