AT 命令通用规则

本文档介绍 KCM601XE AT 命令的通用格式、参数表示方法、响应类型、状态限制和主动上报消息规则。

本文档包含以下小节：

  • 命令类型：说明运行命令、读取命令、设置命令和测试命令的格式。

  • 响应类型：说明同步响应和异步 URC 的区别。

  • 参数规则：说明参数分隔、可选参数和字符串参数的写法。

  • 状态限制：说明不同 LoRaWAN 状态下命令执行限制。

  • 注意事项：说明 OK、ERROR 和业务完成事件之间的关系。

备注

  • OK 表示模组已接受命令或命令参数校验通过，不一定表示 LoRaWAN 空口业务已经完成。

  • 入网、发送、链路检查、RF Test 等命令可能通过 URC 异步上报最终结果。

  • 原文未说明所有命令的最大长度限制；实际使用时应避免发送过长命令。

命令类型

除检查模块运行和通信链路命令外，常见命令格式如下。

类型

格式

说明

示例

运行命令

AT+<CMD>

执行对应功能

AT+QRST

读取命令

AT+<CMD>?

查询当前配置或状态

AT+QDR?

设置命令

AT+<CMD>=<value>

设置参数

AT+QDR=3

测试命令

AT+<CMD>=?

查询参数范围或命令帮助

AT+QDR=?

参数规则

AT 命令参数使用英文逗号 , 分隔。

表示方式

说明

<param>

必填参数

[param]

可选参数

"string"

字符串参数

hex

十六进制字符串，通常不带 0x 前缀

示例：

AT+QSEND=<port>,<len>,<payload>[,<confirm>]

响应类型

KCM601XE AT 固件通常包含两类输出。

类型

说明

示例

同步响应

命令接收、参数校验或查询结果

OK、ERROR、+QVER: ...

异步 URC

业务状态或事件主动上报

+QEVT:JOIN,DONE、+QEVT:SEND,CONFIRMED

状态限制

LoRaWAN 业务存在状态限制。下表为常见状态说明。

状态

说明

常见限制

IDLE

空闲状态，初始化完成但尚未入网

可执行入网和多数配置命令

JOINING

正在入网

不建议重复执行 AT+QJOIN 或发送上行；可通过 AT+QLEAVE 中止

JOINED

已入网

可执行上行、链路检查等数据面命令

SENDING

正在发送

需等待发送完成 URC 后再发起下一次发送

RFTEST

RF Test 进行中

LoRaWAN 正常业务通常不可同时执行

SLEEP_PENDING

睡眠等待中

模组会等待未完成业务结束后进入睡眠

OK 与业务完成

对于异步业务命令，OK 仅表示命令已被接受。例如：

AT+QJOIN=1
OK
+QEVT:JOIN,TRYING,1
+QEVT:JOIN,DONE

上述流程中，入网成功应以 +QEVT:JOIN,DONE 为准，而不是以 OK 为准。

对于 confirmed 上行，应根据发送结果 URC 判断是否收到 ACK：

+QEVT:SEND,CONFIRMED

表示 confirmed 上行收到网络服务器 ACK。

+QEVT:SEND,DONE

表示发送流程结束，但未表示 confirmed ACK 已收到。