DX-WF24 AT 命令参考

Wi-Fi / BLE 二合一模块常用串口命令速查。

115200 / 8N1命令以 CRLF 结束默认无流控

基础命令返回顶部

命令用途 / 说明
AT测试通信,返回 OK
AT+GMR查询固件版本。
AT+UART_DEF?查询串口参数。
AT+UART_DEF=115200,8,1,0保存串口参数并自动重启。
AT+RST重启模块。
AT+RESTORE恢复出厂设置并重启,谨慎使用。
命令格式:AT+Command=<参数> 。本次实测固件:WF24_V1.1.0

Wi-Fi返回顶部

命令用途 / 说明
AT+CWMODE?
AT+CWMODE=<mode>
查询/设置模式:0 Station,1 SoftAP,2 Station+SoftAP。
AT+CWJAP?
AT+CWJAP=<ssid>,<pwd>
查询/连接 Wi-Fi。
AT+CWSTATE?查询连接状态。2 表示已连接并获取 IPv4。
AT+CWQAP断开 Station 与 AP 的连接。
AT+CWSAP?
AT+CWSAP=<ssid>,<pwd>[,<channel>,<hidden>]
查询/设置 SoftAP。
AT+CIPAP?
AT+CIPSTA?
查询 SoftAP / Station 的 IP 参数。
AT+CWDHCP?
AT+CWDHCP=<0|1>
查询/关闭/开启 DHCP。
AT+CWLAP?扫描可用 AP。
AT+PING=<host>Ping 域名或 IPv4 地址。

BLE返回顶部

命令用途 / 说明
AT+BLUFINAME?
AT+BLUFINAME=<name>
查询/设置 BLE 名称;设置后需重启。
AT+BLUFIADDR查询 BLE MAC 地址。
AT+BLUFI?
AT+BLUFI=<0|1>
查询/设置 BLE 广播。
AT+BLUFISEND?
AT+BLUFISEND=<0|1>
查询/设置 BLE 透传。
+++退出透传,不带 CRLF。

TCP / UDP返回顶部

命令用途 / 说明
AT+CIPMODE?
AT+CIPMODE=<0|1>
多连接 / 单连接模式;默认 1。
AT+CIPSTART=TCP,<ip>,<port>建立 TCP 客户端连接。
AT+CIPSTART=UDP,<ip>,<port>,<local>,<mode>创建 UDP 会话。
AT+CIPSERVER=1,<port>,TCP,<maxlink>建立 TCP 服务端。
AT+CIPSERVER=0关闭 TCP 服务端。
AT+CIPSTATE?查询连接信息和会话 ID。
AT+CIPSEND单连接进入透传,等待 >
AT+CIPSEND=<id>,<length>多连接发送定长数据,等待 >
AT+CIPCLOSE[=<id>]关闭连接;ID=20 表示关闭全部。
透传退出符 +++ 不带 CRLF;前后需保持静默,不能使用普通自动追加 CRLF 的发送方式。

MQTT返回顶部

命令用途 / 说明
AT+MQTTCONNCFG?
AT+MQTTCONNCFG=...
查询/设置 MQTT 连接属性与遗嘱。
AT+MQTTLONGCLIENTID?
AT+MQTTLONGCLIENTID=<id>
查询/设置客户端 ID。
AT+MQTTLONGUSERNAME=<user>设置用户名。
AT+MQTTLONGPASSWORD=<password>设置密码。
AT+MQTTCONN=<host>,<port>,<reconnect>连接 MQTT 服务器。
AT+MQTTPUBRAW=<topic>,<len>,<qos>,<retain>发布定长消息,返回 > 后发送正文。
AT+MQTTSUB=<topic>,<qos>订阅主题。
AT+MQTTUNSUB=<topic>取消订阅。
AT+MQTTCLEAN断开 MQTT 连接。

HTTP返回顶部

命令用途 / 说明
AT+HTTPPARA?
AT+HTTPPARA=<url>,<port>
查询/设置 URL 和端口。
AT+HTTPRQH?
AT+HTTPRQH=<key>,<value>
查询/设置请求头。
AT+HTTPACTION=<request>发起请求:0 GET,1 POST,2 PUT,3 DELETE,4 HEAD。
AT+HTTPDATA=<length>设置请求体,等待 > 后发送指定字节数。

简易配对返回顶部

命令用途 / 说明
AT+SIMPLEMODE?
AT+SIMPLEMODE=<mode>,<state>
查询/设置简易模式和角色;设置后自动重启。
AT+SIMPLECLIENT?
AT+SIMPLECLIENT=<type>,<host>,<port>
查询/设置客户端配置。
AT+SIMPLESERVER?
AT+SIMPLESERVER=1,<port>,TCP,<maxlink>
查询/设置服务端配置。

URC 与错误码返回顶部

内容含义
+STA_CONNECTEDTCP 客户端接入。
+STA_DISCONNECTEDTCP 客户端断开。
+MQTTSUBRECV收到 MQTT 订阅消息。
BLE_CONNECT_SUCCESSBLE 主机已连接。
ERROR=101..104参数长度、状态、参数数据或指令错误。
ERROR=201..203网络服务器、服务端或 MQTT 连接错误。
完整参数、响应格式、示例和注意事项请查看 Markdown 原文