基础命令

介绍

重要

默认的 AT 固件支持此页面下的所有基础 AT 命令。实际响应格式应以当前固件版本为准。

本文档介绍 KCM601XE AT 固件支持的基础命令。

基础命令主要用于 AT 通信链路测试、命令列表查询、固件版本查询、串口波特率配置、软件复位、模块 SN 查询、调试日志配置和恢复出厂设置。

备注

  • 本文档仅描述 KCM601XE 已定义的基础命令，不包含 ESP-AT 特有的 Wi-Fi、Bluetooth、TCP/IP、Deep-sleep 等命令。

  • 对需要结合实测确认的响应前缀、参数范围或输出格式，本文使用 TODO 标注。

命令列表

命令

功能

支持的命令类型

备注

AT

检查 AT 通信链路

执行命令

用于确认模组和主控串口通信是否正常

AT+QHELP

列出所有命令列表

执行命令

输出当前固件注册的 AT 命令列表

AT+QVER

查询固件主版本

查询命令

用于查询面向客户发布的固件版本

AT+QSUBVER

查询固件子版本

查询命令

用于查询详细内部构建版本

AT+QBAUD

查询或设置串口波特率

查询命令 / 设置命令

设置成功后需要主控同步切换串口波特率

AT+QRST

软件复位

执行命令

用于触发模组软件复位或重启

AT+QSN

查询模块 SN

查询命令

SN 通常由出厂写入

AT+QDEBUG

查询或设置调试日志输出

查询命令 / 设置命令 / 测试命令

用于配置调试日志输出通道和等级

AT+QFACTORY

恢复出厂设置

执行命令 / 测试命令

恢复后不自动复位

AT：检查 AT 通信链路

该命令用于检查模组是否正常运行，以及 UART 通信链路是否畅通。

执行命令

命令：

AT

响应：

OK

说明：

  • 该命令无业务副作用。

  • 如果主控无法收到 OK，请先确认供电、串口接线、波特率、数据位、停止位和校验位配置。

AT+QHELP：列出所有命令列表

该命令用于列出当前固件支持的所有 AT 命令名称。

执行命令

命令：

AT+QHELP

响应：

+QHELP:
  AT+QHELP
  AT+QVER
  AT+QBAUD
  ...

OK

说明：

  • 该命令用于确认当前固件已注册的 AT 命令集合。

  • 不同固件版本、编译配置或产品分支支持的命令可能不同。

  • TODO：确认当前发布固件 AT+QHELP 的完整输出格式、排序方式和是否包含被禁用命令。

AT+QVER：查询固件主版本

该命令用于查询 KCM601XE AT 固件主版本。

查询命令

命令：

AT+QVER?

响应：

+QVER: <version>

OK

参数：

参数

说明

<version>

固件主版本字符串，例如 KCM601XEAAR01A02M01。

示例：

AT+QVER?
+QVER: KCM601XEAAR01A02M01

OK

说明：

  • 主版本通常用于客户发布、版本兼容性说明和问题反馈。

  • TODO：确认当前发布固件 AT+QVER? 的实际响应前缀和字段数量，是否仅返回 <version>，或包含 <model>、<author>、<build_date> 等字段。

AT+QSUBVER：查询固件子版本

该命令用于查询 KCM601XE AT 固件子版本。

查询命令

命令：

AT+QSUBVER?

响应：

+QSUBVER: <subversion>

OK

参数：

参数

说明

<subversion>

固件子版本字符串，例如 KCM601XEAAR01A02M01V01。

示例：

AT+QSUBVER?
+QSUBVER: KCM601XEAAR01A02M01V01

OK

说明：

  • 子版本用于区分更具体的构建版本、测试版本或发布批次。

  • 问题反馈时建议同时提供 AT+QVER? 和 AT+QSUBVER? 的返回结果。

  • TODO：确认当前发布固件 AT+QSUBVER? 的实际响应前缀。

AT+QBAUD：查询或设置串口波特率

该命令用于查询或设置模组 UART 通信波特率。

查询命令

命令：

AT+QBAUD?

响应：

+QBAUD: <baudrate>

OK

参数：

参数

说明

<baudrate>

当前 UART 波特率。

设置命令

命令：

AT+QBAUD=<baudrate>

响应：

OK

参数：

参数

说明

<baudrate>

目标 UART 波特率。

示例：

AT+QBAUD=57600
OK

说明：

  • 默认波特率为 115200。

  • 设置成功后，波特率配置会保存，后续上电自动加载。

  • 设置成功后，模组通常在 OK 响应发送完成后切换到新波特率，主控应同步切换串口配置。

  • TODO：确认当前发布固件 AT+QBAUD 支持的波特率范围。内部资料中列出的范围包括 38400、57600、115200。

  • TODO：确认设置波特率后是否需要执行 AT+QRST 才能在所有场景下生效。

AT+QRST：软件复位

该命令用于触发模组软件复位或重启。

执行命令

命令：

AT+QRST

响应：

OK

说明：

  • 该命令用于触发模组软件复位或重启。

  • 执行后串口连接可能短暂中断，主控应等待模组重新启动完成后再发送后续 AT 命令。

  • 如果实际固件会输出启动提示、URC 或其他响应，请以实测结果补充。

  • TODO：确认当前发布固件执行 AT+QRST 后的完整启动日志和重新可接受 AT 命令的等待时间。

AT+QSN：查询模块 SN

该命令用于查询模块序列号（SN）。

查询命令

命令：

AT+QSN?

响应：

+QSN: <sn>

OK

参数：

参数

说明

<sn>

模块 SN 字符串。

说明：

  • SN 通常由出厂写入。

  • 内部资料说明 <sn> 最大长度不超过 31 个字符。

  • TODO：确认当前发布固件 AT+QSN 的实际响应格式。

  • TODO：确认 SN 是否允许为空、是否包含双引号以及是否包含特殊字符。

AT+QDEBUG：查询或设置调试日志输出

该命令用于查询或设置模组调试日志输出通道和日志等级。

查询命令

命令：

AT+QDEBUG?

响应：

+QDEBUG: <mode>,<level>

OK

参数：

参数

说明

<mode>

调试日志输出通道。

<level>

调试日志过滤等级。

设置命令

命令：

AT+QDEBUG=<mode>[,<level>]

响应：

OK

参数：

参数

说明

<mode>

调试日志输出通道。

[level]

可选参数，调试日志过滤等级。

测试命令

命令：

AT+QDEBUG=?

响应：

+QDEBUG: (0-2),(0-5)
mode: 0=OFF, 1=RTT, 2=UART
level: 0=ASSERT, 1=ERROR, 2=WARN, 3=INFO, 4=DEBUG, 5=VERBOSE
OK

说明：

  • 内部资料说明默认日志输出通道为 UART，等级为 INFO。

  • 内部资料说明 <mode> 会持久化保存，<level> 不持久化；实际行为应以当前固件版本为准。

  • 设置调试日志可能影响串口输出内容和问题分析方式。

  • TODO：确认当前发布固件 AT+QDEBUG 参数取值，例如 0/1/2 是否分别表示 OFF/RTT/UART。

  • TODO：确认当前发布固件 <level> 的默认值、是否持久化以及重启后的恢复策略。

AT+QFACTORY：恢复出厂设置

该命令用于将模组系统参数和 LoRaWAN 运行时参数恢复为出厂默认值。

执行命令

命令：

AT+QFACTORY

响应：

OK

+QEVT:FACTORY,DONE

错误响应示例：

ERROR

+QEVT:ERR,INTERNAL

测试命令

命令：

AT+QFACTORY=?

响应：

+QFACTORY:
Restore factory defaults.
Execute: AT+QFACTORY
OK

说明：

  • 执行 AT+QFACTORY 后，模组会自动离网并重新加载配置，回到空闲状态。

  • 该命令不会自动复位。

  • 如需使所有设置在硬件上生效，例如波特率恢复为默认值后立即应用，请执行 AT+QRST。

  • 内部资料说明 DevEUI、SN、XTAL trim、用户凭证以及入网计数器等参数不会被该命令清除。

  • TODO：确认当前发布固件 AT+QFACTORY 恢复参数的完整列表和默认值。