¶ Wi-Fi
In the communications window, in the tab "Wifi, Serial and Modbus" you can configure the parameters related to the wifi interface.
Here you can select the operating mode from the following options:
- Off
By deselecting the Access point and Station check-boxes, the Wi-Fi module is turned off and is not used. - Access Point
The RTU-X creates a Wi-Fi network with the configured SSID and password and then accepts connections from other devices. In this configuration, the RTU-X address is always 192.168.4.1 and DHCP is enabled, that is, the RTU-X assigns an IP to the devices that connect to the access point. If the password is left empty, the access point will be open and without security. There is the option to hide this network so that it is not visible to other devices, but remains accessible if you know the SSID and password. - Station
- Fixed IP OFF (uses DHCP)
The RTU-X connects to the Wi-Fi network with the configured SSID and password, and takes the IP of the access point to which it connects. - Fixed IP ON (Static IP address)
The RTU-X connects to the Wi-Fi network with the configured SSID and password, and uses the network settings that it has configured (IP, subnet, Gateway and DNS).
- Fixed IP OFF (uses DHCP)
The RTU-X allows the possibility of being in Access Point and Station mode at the same time.
¶ RS-485 serial bus
In the communications window, in the tab "Wifi, Serial and Modbus" you can configure the parameters related to the RS-485 serial interfaces.
The RS-485 serial interfaces are optional expansion modules. For each interface, speed and parity can be configured.
¶ Modbus
In the communications window, in the tab "Wifi, Serial and Modbus" you can configure the parameters related to Modbus.
The parameters are:
- Modbus Slave ID
The Modbus slave number of the RTU-X (by default 1). - Modbus TCP port
In the case of Wi-Fi connections, the TCP port to use (by default 502). - Max. Modbus TCP connections
The maximum number of simultaneous Modbus TCP incoming connections that the RTU-X accepts (by default 4). - Modbus gateway
Defines the default communication interface to which all Modbus messages whose recipient does not match the Slave ID of the RTU-X are forwarded. If the option "No gateway" is selected, the RTU-X will respond with an error message to all Modbus packets that are not for it. Otherwise, it will forward them over the RS-485 bus depending on which one is selected and then forward the reply back to the sender. Through this functionality, the RTU-X can act as an intermediary so that a client can communicate transparently with a device connected to the RS-485 bus in the expansion modules.
¶ Modem
In the communications window, in the tab "Modem, Bluetooth, NTP" you can configure the parameters related to the modem. The modem is an optional module.
The parameters that can be configured are:
- Network to use
User may choose between different modem modules which support several technologies and communication bands:- Quectel BG95: LTE Cat-NB1 or LTE Cat-M1 with down grade to 2G.
- Cat M1 / NB-IoT - B1/B2/B3/B4/B5/B8/B12/B13/B18/B19/B20/B25/B26/B27/B28/B31/B66/B71/B72/B73/B85
- EGPRS 850/900/1800/1900 MHz
- Quectel EG91: LTE with down grade to 3G / 2G.
- LTE - B1/B2/B3/B4/B5/B7/B8/B28/B66
- WCDMA - B1/B2/B5/B8
- EGPRS 850/900/1800/1900 MHz
- Quectel BG95: LTE Cat-NB1 or LTE Cat-M1 with down grade to 2G.
- Modem on at power-up
This is the normal operating mode in cases where the RTU-X is always on and connected to a stable power source. If this option is disabled, it is possible to control the modem on and off from the script by means of the modem_on variable. This case is often used in applications where power consumption is critical, and you want to turn on the modem for short periods of time just to send the information stored in the log. - Accept incoming connections
When this option is checked, the RTU-X accepts incoming connections on the port 502 used by the user interface. By default, this options is disabled. - PIN
The PIN to be asigned in case the SIM requires it. - Enable GPS
Set this option to enable GPS. The GPS information is available in variables in the script. - Enable SMS
This option must be enabled if you want to send and receive SMS. - Enable data
This option must be enabled for the modem to establish the data connection with the configured APN. - LTE Bands
Definition of bands to be used when LTE is used to connect to the cellular network.
¶ Bluetooth
By default the RTU-X has BLE 4.2 connectivity that can be used to connect to the device from the configuration software and also to act as a master of other BLE devices, such as temperature and humidity sensors.
In the communications window, in the tab "Modem, Bluetooth, NTP" you can configure the parameters related to Bluetooth.
You must select the name of the device (it will be the name advertised by the RTU-X) and the security pin, which will be requested when connecting.
¶ NTP
In the communications window, in the tab "Modem, Bluetooth, NTP" you can configure the configuration of an NTP server for time synchronization.
You must select:
- Interface
It can be wi-fi, modem or the same interface being used for the MQTT connection - Server
URL or IP address of the NTP server - Time zone
Relative to UTC
¶ MQTT
The MQTT protocol is a communications protocol over TCP/IP that has been adopted as one of the most widely used standards for IoT devices.
The RTU-X uses MQTT to send the log records to a server in the cloud, but it is also used to perform other more complex functions when the RTU-X is connected to Thingsboard; such as updating all settings, synchronizing shared variables, or sending RPC commands.
¶ MQTT configuration
The parameters to configure for the MQTT connection are the following:
- Interfce - The RTU-X implements the MQTT protocol over Wi-Fi and the modem data connection. The physical interface to use must be selected.
- Format - The following options are available:
- JSON - It uses the JSON format to send the log records.
- Ultralight - It uses the Ultralight 2.0 format for sending the log records.
- Predix - It uses the JSON format compatible with the General Electric's MQTT Data Collector according to the specified here.
- Thingsboard - In this option, the RTU-X is configured to establish the connection with a Thingsboard server. Nettra Telemetry+ is a professional instance of Thingsboard managed by Nettra.
- URI – The URI must have the format "equema://host:port" where schema can be mqtt or mqtts depending on whether or not you want to establish an SSL connection. An example URI is mqtts://myhost.com:8883
- User, password and client ID – According to the MQTT protocol.
- Telemetry Topic – Defines the MQTT topic to which the stored records are sent using the log and report functions of the script for telemetry type variables.
- Attribute Topic – Defines the MQTT topic to which the stored records are sent using the log and report functions of the script for variables of type attribute.
- Watchdog – It allows to implement a security mechanism in case of communication failure. If the RTU-X is unable to establish the MQTT connection for this time, it will restart automatically. If the configured time is zero, this functionality is disabled.
- Certificate – Server certificate in PEM format in case of using SSL for MQTT connection. Leave blank if not used.
For the Thingsboard format option, you only need to configure the URI, user (token) that uniquely identifies the device on the platform and certificate (in case of using mqtts). All other parameters are set automatically.
When using the Telemetry + instance of Nettra, you must select the Thingsboard format and fill in only the user (token) that will be provided by Nettra. The URI and certificate are the values that are loaded by default when selecting Thingsboard.
To send variables through MQTT you can use the log and report functions from the script. Both functions can be used with variables of type telemetry or attribute.
The format in which the information is sent in each case is as follows:
| Format | Telemetry type variable | Attribute type variable |
| JSON and Thingsboard |
where XXX is the timestamp in UTC in unix format in milliseconds of the records |
|
| Ultralight 2.0 |
where TTT is the timestamp in UTC in ISO8601 format |
|
All log records created with the same date / time are sent in the same MQTT package.
If the connection is lost, all records are stored in the log and sent when the connection is re-established.
¶ Integration with Thingsboard
When Thingsboard is selected as the format for the MQTT connection, the RTU-X implements additional functionalities in addition to sending the log by MQTT.
These functionalities are described below.
¶ “Shared” attributes
When a variable in the script is defined with the prefix shared, the value of the variable is synchronized with the value of the shared attribute in Thingsboard with the same name if it exists.
This is achieved without the user having to do anything special because when establishing the MQTT connection, the RTU-X automatically subscribes to the topics
v1/devices/me/attributes and v1/devices/me/attributes/response/+
When the value of the shared attribute is created or updated in Thingsboard, the system sends the following publish to the RTU-X:
- Topic:
v1/devices/me/attributes - Message:
{“variable”:value}
On the other hand, when the RTU-X establishes the MQTT connection (or the script is updated with new variables), the RTU-X performs the following publish:
- Topic:
v1/devices/me/attributes/request/44332 - Message:
{“sharedKeys”, “variable1,variable2”}
And the Thingsboard server sends the following publish to the RTU-X as a response:
- Topic:
v1/devices/me/attributes/response/44332 - Mensaje:
{“variable1”:value, “variable2”:value}
¶ Periodic submission of internal attributes
The RTU-X automatically publishes a list of useful internal variables to the server.
The following variables are published every time the connection is established with the MQTT server:
| Variable | Detalle |
| model | RTU-X model (DIN or IP68) and hardware version |
| mac_wifi | MAC address of the Wi-Fi module. |
| ext1 | Information of the module connected in the extension socket 1. |
| ext2 | Information of the module connected in the extension socket 2. |
| modem_imei | Modem IMEI (if a modem is present in the communication socket). |
| modem_imsi | IMSI of the SIM (if a modem is present in the communication socket). |
The following variables are published periodically every 10 minutes:
| Variable | Detalle |
| battery | Battery percentage. |
| battery_status | Working status of the RTU-X related to battery. It can be Charged, Charging or No power. |
| internal_temperature | Internal temperature of the RTU-X |
| modem_signal | Modem signal level in dBm. |
| wifi_signal | Wi-Fi signal level in dBm. |
¶
RPC Commands
RPC stands for “Remote Procedure Call” and is used to send commands and queries from the Thingsboard server to the RTU-X.
To do this, the RTU-X subscribes to the topic “v1/devices/me/rpc/request/+” to receive the commands.
The following RPC commands are valid:
| Function | Description | Command | Response |
| set_variable | Modify a telemetry, attribute or shared variable |
where NAME is the name of the variable and VALUE the value |
OK |
| get_variable | Query a telemetry, attribute or shared variable |
where NAME is the name of the variable |
VALUE |
| resend_log | Resends the last N log registers |
where N is the number of log registers to resend |
OK |
| timezone | Sets the timezone of the RTU-X |
where t is the new time zone |
OK |
| reset | Resets de RTU-X |
|
None |