Files
maglink-console/AT_UPLOADDATA_MQTT_Configuration_EN.md
brentperteet 5703c05c1d Initial commit
2026-06-24 11:12:44 -05:00

2.5 KiB

MQTT Data Upload Configuration via AT Commands

Overview

Configure device data upload functionality using AT+UPLOADDATA_PARM and AT+UPLOADDATA_TYPE commands. Configuration is saved to Flash and persists across power cycles.


Configuration Steps

Step 1: Set Server Address and Upload Frequency

Command: AT+UPLOADDATA_PARM=SET

Format:

AT+UPLOADDATA_PARM=SET,<freq>,<ip>,<port>\r\n

Parameters:

Parameter Description Values
freq Upload frequency 0=OFF, 1=1s, 2=2s, 5=5s, 10=10s, 255=Follow GGA rate
ip Server address IP or domain name, max 99 bytes
port Server port 1~65535

Example:

AT+UPLOADDATA_PARM=SET,1,mqtt.example.com,1883

Response:

OK

Step 2: Set Protocol Type to MQTT and Configure Authentication

Command: AT+UPLOADDATA_TYPE=SET

Format:

AT+UPLOADDATA_TYPE=SET,2,USERNAME,<user>,PASSWORD,<password>,CLIENTID,<clientid>,TOPIC,<topic>\r\n

Parameters:

Parameter Description Max Length
type Protocol type, use 2 for MQTT
USERNAME MQTT username 63 bytes
PASSWORD MQTT password 63 bytes
CLIENTID MQTT client ID 63 bytes
TOPIC Publish topic 63 bytes

Example:

AT+UPLOADDATA_TYPE=SET,2,USERNAME,myuser,PASSWORD,mypass,CLIENTID,device001,TOPIC,/gnss/data

Response:

OK

Query Current Configuration

Query Server Parameters

AT+UPLOADDATA_PARM=GET\r\n

Response Format:

AT+UPLOADDATA_PARM=GET,<freq>,<ip>,<port>
OK

Query Protocol Type and MQTT Parameters

AT+UPLOADDATA_TYPE=GET\r\n

Response Format (MQTT):

AT+UPLOADDATA_TYPE=GET,2,USERNAME,<user>,PASSWORD,<pass>,CLIENTID,<id>,TOPIC,<topic>,SUBTOPIC,<subtopic>
OK

Protocol Type Reference

type Protocol Description
0 TCP Raw TCP connection, no additional parameters
1 HTTP HTTP POST upload, requires USERNAME/PASSWORD
2 MQTT MQTT publish, requires USERNAME/PASSWORD/CLIENTID/TOPIC
3 JT808 JT808 protocol

Complete Configuration Example

# 1. Set server address with 1-second upload interval
AT+UPLOADDATA_PARM=SET,1,mqtt.example.com,1883

# 2. Set MQTT protocol and authentication
AT+UPLOADDATA_TYPE=SET,2,USERNAME,myuser,PASSWORD,mypass,CLIENTID,device001,TOPIC,/gnss/data

# 3. Verify configuration
AT+UPLOADDATA_PARM=GET
AT+UPLOADDATA_TYPE=GET