Difference between revisions of "Template:Networking rutos manual mbus"

From Teltonika Networks Wiki
m (Text replacement - "\{\{Template: Networking_rutos_manual_fw_disclosure (.*) (.*) (.*) (.*) \}\}" to "{{Template: Networking_device_manual_fw_disclosure | series = {{{series}}} | name = {{{name}}} | fw_version ={{Template: Networking_device_manual_latest_fw | series = {{{series}}} | name = {{{name}}} }} }}")
(2 intermediate revisions by 2 users not shown)
Line 14: Line 14:
 
This manual page provides an overview of the M-Bus functionality in {{{name}}} devices.
 
This manual page provides an overview of the M-Bus functionality in {{{name}}} devices.
  
==Client==
+
==M-Bus Settings==
  
 +
The <b>M-Bus Settings</b> section is used to configure the general service functionality. The figure below is an example of the M-Bus Settings and the table below provides information on the fields contained in that section:
  
===General settings===
+
[[File:Networking_rutos_manual_mbus_mbus_settings_v1.png|border|class=tlt-border]]
----
 
 
 
The M-Bus device configuration section is used to configure the general service functionality. The figure below is an example of the M-Bus Settings and the table below provides information on the fields contained in that section:
 
 
 
[[File:Networking_rutos_manual_mbus_client_general_settings.png|border|class=tlt-border]]
 
 
 
[[File:Networking_rutos_manual_mbus_client_device_configuration.png|border|class=tlt-border]]
 
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 33: Line 27:
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Status</td>
+
         <td>Enable</td>
         <td>Inactive | Active</td>
+
         <td>off | on; default: <b>off</b></td>
         <td>Status of service, whether it is currently running. If it is active, it will also show how long it has been running.</td>
+
         <td>Enables the service.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
Line 41: Line 35:
 
         <td>300 | 600 | 1200 | 2400 | 4800 | 9600 ; default: <b>2400</b></td>
 
         <td>300 | 600 | 1200 | 2400 | 4800 | 9600 ; default: <b>2400</b></td>
 
         <td>Specifies the M-Bus server network baud rate.</td>
 
         <td>Specifies the M-Bus server network baud rate.</td>
    </tr>
 
</table>
 
 
The Devices section is used to configure the general device instance. The figure below is an example of the M-Bus device and the table below provides information on the fields contained in that section:
 
 
===Devices===
 
----
 
 
[[File:Networking_rutos_manual_mbus_client_devices_add.png|border|class=tlt-border]]
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th>Field</th>
 
        <th>Value</th>
 
        <th>Description</th>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Name</td>
+
         <td>Database location</td>
         <td>String; default: <b>Device 1</b></td>
+
         <td>RAM memory | Flash memory; default: <b>RAM memory</b></td>
        <td>Display name of device configuration.</td>
+
         <td>Specifies where the database will be stored..</td>
    </tr>
 
    <tr>
 
        <td>Address type</td>
 
        <td>Primary | Secondary ; default: <b>Primary</b></td>
 
         <td>Primary address which will be used when sending requests.</td>
 
    </tr>
 
    <tr>
 
        <td>Primary address</td>
 
        <td>integer [0..250]; default: <b>empty</b></td>
 
        <td>Primary address which will be used when sending requests.</td>
 
    </tr>
 
    <tr>
 
        <td>Secondary address</td>
 
        <td>string of 16 symbols; default: <b>empty</b></td>
 
        <td>A unique device identifier which commonly includes the serial number.</td>
 
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
 +
==Records==
 +
 +
By default there are no <b>Records</b> instances created. To start configuring, add a new record using the <b>Add New Instance</b> section below.
  
 +
[[File:Networking_rutos_manual_mbus_records_add_new_instance_v1.png|border|class=tlt-border]]
  
===Data collecting groups===
+
===M-Bus Record===
 
----
 
----
 +
The <b>M-Bus Record</b> section is used to configure the general record instance. The figure below is an example of the M-Bus Record and the table below provides information on the fields contained in that section:
  
[[File:Networking_rutos_manual_mbus_client_data_collecting_groups.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_mbus_record_mbus_record_demo_v2.png|border|class=tlt-border]]
 
 
Before saving, you can check if your configuration works accordingly by pressing the Test Configuration button. You should see the data in a pop-up field.
 
 
 
[[File:Networking_rutos_manual_mbus_client_data_collecting_groups_configuration.png|border|class=tlt-border]]
 
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 97: Line 62:
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Enabled</td>
+
         <td>Enable</td>
         <td>on | off; default: <b>off</b></td>
+
         <td>off | on; default: <b>off</b></td>
         <td>Button to enable/disable data collecting group.</td>
+
         <td>Enables the service.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Period</td>
+
         <td>Name</td>
         <td>integer [0..86400]|; default: <b>60</b></td>
+
         <td>string; default: <b>none</b></td>
         <td>Time duration between data retrievals (in seconds).</td>
+
         <td>Name used for distinguishing purposes.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Data type</td>
+
         <td>Period</td>
         <td>JSON | XML | ASCII | Hexadecimal | Binary; default: <b>JSON</b></td>
+
         <td>integer [1..86400]; default: <b>60</b></td>
         <td>Data type to process the received data.</td>
+
         <td>Specifies the period how often record data will be collected.</td>
    </tr>
 
    <tr>
 
        <td>Test</td>
 
        <td>Interactive button</td>
 
        <td>A unique device identifier which commonly includes the serial number.</td>
 
 
     </tr>
 
     </tr>
</table>
 
 
 
 
[[File:Networking_rutos_manual_mbus_client_data_collecting_groups_value_edit.png|border|class=tlt-border]]
 
 
[[File:Networking_rutos_manual_mbus_client_data_collecting_groups_value_edit_configuration.png|border|class=tlt-border]]
 
 
<table class="nd-mantable">
 
 
     <tr>
 
     <tr>
         <th>Field</th>
+
         <td>String before data</td>
        <th>Value</th>
+
         <td>string; default: <b>none</b></td>
        <th>Description</th>
+
         <td>String that will be appended before request data.</td>
    </tr>
 
    <tr>
 
        <td>Enabled</td>
 
        <td>on | off; default: <b>off</b></td>
 
        <td>Button to enable/disable data group value.</td>
 
    </tr>
 
    <tr>
 
         <td>FCB toggle</td>
 
        <td>on | off; default: <b>off</b></td>
 
         <td>FCB (Frame Count-Bit): One-bit counter for reliable server-client communication. Some devices may have different uses for it.</td>
 
    </tr>
 
    <tr>
 
        <td>Manufacturer information</td>
 
        <td>on | off; default: <b>off</b></td>
 
        <td>Should manufacturer information be included in the payload.</td>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Selected parameters</td>
+
         <td>String between data</td>
         <td>All | Custom; default: <b>All</b></td>
+
         <td>string; default: <b>none</b></td>
         <td>Should all parameters be saved from device, or a custom subset of them.</td>
+
         <td>String that will be appended between request data.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Frame number</td>
+
         <td>String after data</td>
         <td>integer [0..15]|; default: <b>60</b></td>
+
         <td>string; default: <b>none</b></td>
         <td>Frame number.</td>
+
         <td>String that will be appended after request data.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Record number</td>
+
         <td>Failure mode</td>
         <td>integer [0..63]|; default: <b>60</b></td>
+
         <td>Never | <span style="color: red;">Any requests failed</span> | <span style="color: red;">All requests failed</span>; default: <b>Never</b></td>
         <td>Record number.</td>
+
         <td>Specifies when whole record is considered as failure.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Parameter</td>
+
         <td><span style="color: red;">Store a failure message</span></td>
         <td>id | frame | Function | StorageNumber | Tariff | Device | Unit | Value | Timestamp; default: <b>id</b></td>
+
         <td>off | on; default: <b>off</b></td>
         <td>Parameter.</td>
+
         <td>Select whether to store a failure message in the database or do nothing on failure.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
==Gateway==
+
===Request Configuration===
 
 
 
 
===M-Bus device configuration===
 
 
----
 
----
 +
In this section, you can configure requests from servers. By default there are no instances created. To add a new instance and start configuring press the <b>Add</b> button.
  
The M-Bus device configuration section is used to configure the general service functionality. The figure below is an example of the M-Bus Settings and the table below provides information on the fields contained in that section:
+
[[File:Networking_rutos_manual_mbus_record_request_configuration_v2.png|border|class=tlt-border]]
 
 
[[File:Networking rutos manual mbus gateway mbus device configuration.png|border|class=tlt-border]]
 
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th>Field</th>
 
        <th>Value</th>
 
        <th>Description</th>
 
    </tr>
 
    <tr>
 
        <td>Enabled</td>
 
        <td>on | off; default: <b>off</b></td>
 
        <td>Button to enable/disable service.</td>
 
    </tr>
 
    <tr>
 
        <td>Baud rate</td>
 
        <td>300 | 600 | 1200 | 2400 | 4800 | 9600 ; default: <b>2400</b></td>
 
        <td>Specifies the M-Bus server network baud rate.</td>
 
    </tr>
 
</table>
 
 
 
  
 
+
====Request Configuration Edit====
===Configuration settings===
 
 
----
 
----
 
+
[[File:Networking rutos manual mbus record request configuration edit v3.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mbus_gateway_configuration_settings_general.png|border|class=tlt-border]]
 
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 209: Line 120:
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Mode</td>
+
         <td>Enable</td>
         <td>Server | Client | Client+server | Bidirect(legacy mode, not recommended); default: <b>Server</b></td>
+
         <td>off | on; default: <b>off</b></td>
         <td>
+
         <td>Enables request processing.</td>
            <ul>
 
                <li>Server - launches service in server mode and listens on the selected port.</li>
 
                <li>Client - launches service in client mode, which connects to one or several servers with the selected addresses and ports.</li>
 
                <li>Client + server - launches service in server and client(s) mode simultaneously.</li>
 
                <li>Bidirect(legacy) - launches service in bidirect mode, which means that the service keeps changing between server and client modes. If server mode fails it switches to client mode and vice versa.</li>
 
            </ul>
 
      </td>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Protocol</td>
+
         <td>Server address</td>
         <td>TCP | UDP; default: <b>TCP</b></td>
+
         <td>int | hexstring; default: <b>none</b></td>
         <td>Select which protocol to use for data transmission.</td>
+
         <td>Address of the server to be inquired.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Listening port</td>
+
         <td>Data type</td>
         <td>integer [1..65535]; default: <b>empty</b></td>
+
         <td>XML | HEX | BIN | JSON; default: <b>XML</b></td>
         <td>Specify port number for server to listen.</td>
+
         <td>Data type to process the received data.</td>
 
     </tr>
 
     </tr>
</table>
 
 
 
 
[[File:Networking_rutos_manual_mbus_gateway_configuration_settings_security.png|border|class=tlt-border]]
 
 
<table class="nd-mantable">
 
 
     <tr>
 
     <tr>
         <th>Field</th>
+
         <td>Error value</td>
         <th>Value</th>
+
         <td>string; default: <b>none</b></td>
         <th>Description</th>
+
         <td>Changes request data to this value if request fails.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Use TLS/SSL</td>
+
         <td>FCB toggle</td>
         <td>on | off; default: <b>off</b></td>
+
         <td>off | on; default: <b>on</b></td>
        <td>Button to use TLS/SSL for connection.</td>
+
         <td>FCB (Frame Count-Bit): One-bit counter for reliable server-client communication; some devices have special uses for it.</td>
    </tr>
 
    <tr>
 
        <td>TLS version</td>
 
        <td>tlsv1.0 | tlsv1.1 | tlsv1.2 | tlsv1.3 | Support all ; default: <b>Support all</b></td>
 
        <td>Minimum TLS version allowed to be used.</td>
 
    </tr>
 
    <tr>
 
        <td>TLS type</td>
 
        <td>Certificate based | <span style="color: red">Pre-Shared-Key based</span>; default: <b>Certificate based</b></td>
 
        <td>Select the type of TLS encryption.</td>
 
    </tr>
 
    <tr>
 
        <td><span style="color: red">Pre-Shared-Key</span></td>
 
        <td>hexadecimal string of symbols; default: <b>empty</b></td>
 
        <td>The pre-shared-key in hex format with no leading “0x”.</td>
 
    </tr>
 
    <tr>
 
        <td><span style="color: red">Identity</span></td>
 
        <td>string of symbols; default: <b>empty</b></td>
 
        <td>Specify the identity.</td>
 
    </tr>
 
    <tr>
 
        <td>Require certificate</td>
 
        <td>on | off; default: <b>on</b></td>
 
         <td>Demand certificate and key from peer and verify them against certificate authority.</td>
 
    </tr>
 
    <tr>
 
        <td>Certificate files from device</td>
 
        <td>on | off; default: <b>off</b></td>
 
        <td>Choose this option if you want to select certificate files from device.</td>
 
    </tr>
 
</table>
 
 
 
 
 
 
 
[[File:Networking_rutos_manual_mbus_gateway_configuration_settings_advanced.png|border|class=tlt-border]]
 
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th>Field</th>
 
        <th>Value</th>
 
        <th>Description</th>
 
    </tr>
 
    <tr>
 
        <td>Raw mode</td>
 
        <td>on | off; default: <b>on</b></td>
 
        <td>Enable to transmit all data transparently.</td>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Remove all zeros</td>
+
         <td>Test configuration</td>
         <td>on | off; default: <b>off</b></td>
+
         <td>button; default: <b>-</b></td>
         <td>Remove all zero bytes from received data.</td>
+
         <td>Tests the current configuration.</td>
    </tr>
 
    <tr>
 
        <td>Inactivity timeout</td>
 
        <td>integer [0..36000] ; default: <b>300</b></td>
 
        <td>Specifies period of time in seconds, where server connection must be inactive, to disconnect client. To disable timeout input 0.</td>
 
    </tr>
 
    <tr>
 
        <td>Serial timeout</td>
 
        <td>integer [0..1000] ; default: <b>empty</b></td>
 
        <td>Specifies the maximum milliseconds to wait for serial data.</td>
 
    </tr>
 
    <tr>
 
        <td>Max clients</td>
 
        <td>integer [1..32] ; default: <b>4</b></td>
 
        <td>Specify (1-32) how many clients are allowed to connect simultaneously.</td>
 
    </tr>
 
    <tr>
 
        <td>TCP echo</td>
 
        <td>on | off; default: <b>off</b></td>
 
        <td>Software TCP echo.</td>
 
    </tr>
 
    <tr>
 
        <td>Close connections</td>
 
        <td>on | off; default: <b>off</b></td>
 
        <td>Close TCP connections everytime data is sent or received (might result in serial data loss).</td>
 
    </tr>
 
    <tr>
 
        <td>Keep alive</td>
 
        <td>on | off; default: <b>off</b></td>
 
        <td>Enable keep alive.</td>
 
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
 
+
====Test Configuration====
 
 
===IP filter===
 
 
----
 
----
 +
Before saving, you can check if your configuration works accordingly by pressing the <b>Test Configuration</b> button. You should see the data in a field below:
  
[[File:Networking_rutos_manual_mbus_gateway_ip_filter.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_mbus_record_request_configuration_edit_test_configuration_v1.png|border|class=tlt-border]]
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th>Field</th>
 
        <th>Value</th>
 
        <th>Description</th>
 
    </tr>
 
    <tr>
 
        <td>Allow IP</td>
 
        <td>IPv4 and IPv6 addresses with or without mask prefix are accepted. E.g 192.168.1.0/24.</td>
 
        <td>Allow IP connecting to server, write 0.0.0.0/0 for allowing all</td>
 
    </tr>
 
</table>
 
  
 
[[Category:{{{name}}} Services section]]
 
[[Category:{{{name}}} Services section]]

Revision as of 12:09, 24 October 2023

The information in this page is updated in accordance with firmware version .

Summary

The M-Bus (Meter Bus) is a cost-effective fieldbus communication protocol for transmitting energy consumption data. A central client – in this case {{{name}}} – communicates via a two-wire bus (up to max. 250 servers per segment) with bus devices (e.g., heat meter, water meter, electric meter, gas meter).

This manual page provides an overview of the M-Bus functionality in {{{name}}} devices.

M-Bus Settings

The M-Bus Settings section is used to configure the general service functionality. The figure below is an example of the M-Bus Settings and the table below provides information on the fields contained in that section:

Networking rutos manual mbus mbus settings v1.png

Field Value Description
Enable off | on; default: off Enables the service.
Baud rate 300 | 600 | 1200 | 2400 | 4800 | 9600 ; default: 2400 Specifies the M-Bus server network baud rate.
Database location RAM memory | Flash memory; default: RAM memory Specifies where the database will be stored..

Records

By default there are no Records instances created. To start configuring, add a new record using the Add New Instance section below.

Networking rutos manual mbus records add new instance v1.png

M-Bus Record


The M-Bus Record section is used to configure the general record instance. The figure below is an example of the M-Bus Record and the table below provides information on the fields contained in that section:

Networking rutos manual mbus record mbus record demo v2.png

Field Value Description
Enable off | on; default: off Enables the service.
Name string; default: none Name used for distinguishing purposes.
Period integer [1..86400]; default: 60 Specifies the period how often record data will be collected.
String before data string; default: none String that will be appended before request data.
String between data string; default: none String that will be appended between request data.
String after data string; default: none String that will be appended after request data.
Failure mode Never | Any requests failed | All requests failed; default: Never Specifies when whole record is considered as failure.
Store a failure message off | on; default: off Select whether to store a failure message in the database or do nothing on failure.

Request Configuration


In this section, you can configure requests from servers. By default there are no instances created. To add a new instance and start configuring press the Add button.

Networking rutos manual mbus record request configuration v2.png

Request Configuration Edit


Networking rutos manual mbus record request configuration edit v3.png

Field Value Description
Enable off | on; default: off Enables request processing.
Server address int | hexstring; default: none Address of the server to be inquired.
Data type XML | HEX | BIN | JSON; default: XML Data type to process the received data.
Error value string; default: none Changes request data to this value if request fails.
FCB toggle off | on; default: on FCB (Frame Count-Bit): One-bit counter for reliable server-client communication; some devices have special uses for it.
Test configuration button; default: - Tests the current configuration.

Test Configuration


Before saving, you can check if your configuration works accordingly by pressing the Test Configuration button. You should see the data in a field below:

Networking rutos manual mbus record request configuration edit test configuration v1.png

[[Category:{{{name}}} Services section]]