User Tools

Site Tools


IoT Converter



User guide

Connecting to a converter

Converter is connected to a PC via USB/UART converter (3.5 mm jack connector). After selecting port of USB/UART converter and clicking „Connect“ the connection with LoRa converter should be established (it may take a few seconds if converter is taking a measurement).

Current configuration of converter will be loaded upon connecting and GUI defaults to MBUS page:

Buttons description

Save and load configuration into/from a converter

Current configuration of converter can be saved into a EEPROM memory and loaded from it.

Save and load configuration into/from a file

Current configuration of converter can be saved into a text file (.cfg) in JSON format and loaded from it.

Save and load configuration a YAML file

Current configuration of converter can be saved into a YAML file (.yaml) with prepared individual configuration frames. User can select only needed frames and send them into a converter.

Tabs description

MBUS setting

General setting

Settings of communication protocol with MBUS device and converter:

List of MBUS requests

List of MBUs request to be made from converter to a MBUS device:

Request can be typed in by hand („Add new line“) or by dialog wizard („Add request“):

Dialog automatically calculates checksum and fills in start and stop bytes.

List of responses

User can set different offsets and length which are taken from responses to selected requests.

E.g.: for first request (1011223316) take data of length 4 bytes with offset 0.

NB-IoT settings

User can set host IP address, port, communication protocol and period of sending a data.

LUA interface

LUA interface adds ability to program converter with user’s script with use of converter’s API (documentation).

User can either select from available scripts (from combo box), load script from a file (.lua), edit loaded script and save it. Or user can type in own custom script.

Script is send to a converter by “Send” button or by saving configuration into a converter.

Another way of using LUA interface is interactive console where can user type LUA commands in real time. It is useful mainly for testing purposes.

Interactive console is activated with button “Debug ON” (can be exited from with “Debug OFF” or “Disconnect” buttons).

Example usage of Lua interface

Lua interactive console is great for communication with NB IoT module. It supports AT commands via api call:


= IMSI SIM card number =

Command: AT+CIMI

= Signal quality =

Command: AT+CSQ

Response: 13 means 85 dBm RSSI (normal values 9-14, bigger number = stronger signal)

= Status of network registration =

Command: AT+CEREG?

Response: 5 means that module is registered into a roaming network

= Current operator =

Command: AT+COPS?

Response: 23003 is unique operator identifier(in this case Vodafone CZ).

public/products/mbus-nbiot-sw.txt · Last modified: 2020/01/07 17:45 by Tomáš Šimíček