DTU Tool User Guide

Overview

This document introduces how to use DTU Tool with Quectel DTU Solution for development and debugging.

DTU Tool has two main functions:

• Query and configure DTU device parameters.
• Transmit data: send and receive data between the DTU device and the cloud.

Query and Configure Parameters

Query IMEI Number

The left serial port data display box displays the detailed serial port data in string format, and the right command box displays the queried IMEI number.

Query Phone Number

Query Signal Strength

Restart Device

Get Current Parameter Settings

In the command box, click get current setting to request the current parameter settings of the DTU device, and the tool will redirect to the parameter setting and display page

Parameter setting and display page

Save Parameter Settings

After getting the current parameter settings, enter the parameter "settings" page, and modify the settings according to actual needs (You can also set the parameter directly without getting the current values).

After the modification is completed, return to the "repl" page and click save setting to save the settings.

Click restore factory setting to restore the factory settings.

System Configuration Parameter

The basic configuration parameters are shown in the above figure.

Cloud Configuration Parameter

The cloud configuration parameters vary with the selected cloud type. When the cloud type is MQTT, the cloud configuration parameters are as follows:

The subscription topic and publishing topic are both in the format of "JSON format with the topic ID as the key and the topic string as the value".

For example: the parameter {"0":"/F79933DC83A4/connect_packet/adv_publish"} indicates that the topic with ID "0" is "/F79933DC83A4/connect_packet/adv_publish".

DTU Data Transmission and Debugging

Data format requirements for the data transmission box: The data transmission format is consistent with the communication format between MCU and DTU. Depending on the different communication protocols with the cloud, the communication protocol between the module and external devices (such as MCU) will also be different. When the module communicates with the cloud over the TCP protocol, because both TCP and serial ports are in the form of data streams, the data is transparently transmitted without any processing. When the module communicates with the cloud over the MQTT protocol, in order to distinguish different data frames, the module's serial port adopts a simple data frame for external protocol: <topic_id>,<msg_len>,<msg_data>.

Example messages

Upstream message: "1,6,abcedf"

Downstream message: "1,6,ijklmn"

Both the uplink and downlink messages between the module and the external device (MCU) are in string format, with data items separated by ",".

Secondary Development

The DTU Tool is developed based on the graphical framework wxPython. At this stage, it has been compiled into dtu_tool.exe and only supports the Windows system. You can configure the Python environment and install wxPython on Linux or macOS, and then run dtu_tool.py directly or compile the corresponding version of the binary program by yourself (compilation script: dtu_tool/build.sh).

DTU Tool source code repository link: https://github.com/QuecPython/DTU-tool.git

wxPython official website: https://www.wxpython.org

Install Dependencies

After configuring the Python development environment, use the pip tool to install the following dependencies:

Pypubsub==4.0.3
wxPython==4.1.1
pubsub==0.1.2
pyserial==3.5

Execute Script

python dtu_tool.py

Interface Display

Note: Before debugging, please start the DTU device, select the serial port for communication with the DTU device in the "PC settings" area of the DTU Tool, and open the serial port.