泰芯AH-SDK_V2.x AT指令使用说明

日期

版本

描 述

修订人

2026-1-6

V1.3

修改TXPOWER和ACK_TO的描述

WY

2025-12-11

V1.2

修改chan_list的描述

WY

2025-9-18

V1.1

修改漫游相关的描述

WY

2025-7-3

V1.0

第一个发布版本

WY

执行指令

查询: AT+WIFIMODE=?

设置:AT+WIFIMODE=ap

响应

OK

成功：OK

失败：ERROR

参数说明

支持ap/sta/apsta/wnbap/wnbsta 5种模式

示例

• at+wifimode=ap，标准协议的ap模式
• at+wifimode=sta，标准协议的sta模式
• at+wifimode=apsta，标准协议的中继模式，中继模式的设备既作为sta连接上一级AP，又作为ap为其它sta提供连接服务。请查看中继相关设置命令。
• at+wifimode=wnbap，私有协议的ap模式，可以跟V1.6的STA互连
• at+wifimode=wnbsta，私有协议的sta模式，可以跟V1.6的AP互连

后面的两种模式，默认的固件和SDK不支持，需要时请联系FAE提供

执行指令

查询: AT+SSID=?

设置:AT+SSID=ssid_char

响应

+SSID:HALOW_959B60

OK

成功：OK

失败：ERROR

参数说明

默认SSID是HALOW_xxxxxx(MAC后3byte）

ssid_char 长度小于等于32个字符，超过会截断。

示例

at+ssid=hgic_ah_test

执行指令

查询: AT+ENCRYPT=?

设置:AT+ENCRYPT=0/1

响应

+ENCRYPT:0 or 1

OK

成功：OK

失败：ERROR

参数说明

1:开启加密

0:关闭加密

示例

at+encrypt=1

at+encrypt=0

执行指令

查询: AT+KEY=?

设置:AT+KEY=key_char

响应

+KEY:key_char

OK

成功：OK

失败：ERROR

参数说明

默认key是12345678

key_char的长度必须大于等于8个ASSIC 字符。

key长度小于8时，返回：

ERROR

need 8 bytes at less

示例

+KEY:12345678

OK

at+key=87654321

执行指令

设置: AT+PAIR=0/1/2/...

响应

OK

参数说明

此命令可实现快速配对组网。

启动配对前，AP配置了SSID和key，通过配对STA会获取到AP的SSID和key。

配对成功后会产生PAIRING SUCCESS消息，但不会自动退出配对，需要执行AT+PAIR=0停止配对。

配对停止后会自动建立连接。

如果AP和STA都设置了SSID等参数，就不用启动PAIR了，会依靠SSID等参数自动连接。

示例

AT+PAIR=1 //启动配对，按照默认的分组配对

AT+PAIR=0 //停止配对

AT+PAIR=2 //启动配对,并且按照分组2进行配对

执行指令

查询: AT+CHAN_LIST=?

设置:AT+CHAN_LIST=freq1，freq2

响应

+CHAN_LIST:9080,9160,9240

OK

成功：OK

失败：ERROR

参数说明

该命令用于设置频点列表；

指定的频点值为中心频点*10，例如9080表示908MHz；

最多支持16个频点，以逗号分隔；

注意ap和sta的chan_list要完全一样（包括信道频点的顺序），否则会连接出错；

示例

AT+CHAN_LIST=9080,9240

执行指令

查询: AT+BSS_BW=?

设置:AT+BSS_BW=bss_bw

响应

+BSS_BW:8MHz

OK

成功：OK

失败：ERROR

参数说明

bss_bw只选择以下4个值：

1 : 1MHz

2 : 2MHz

4 : 4MHz

8 : 8MHz

示例

at+bss_bw=4

执行指令

查询: AT+TXPOWER=?

设置:AT+TXPOWER=txpower

响应

+TXPOWER:20dbm

OK

成功：OK

失败：ERROR

参数说明

该命令用于手动设置最大发射功率。

范围是1~20，1db步进。

超出范围的设置，都会设置为20。

此命令掉电不保存。

示例

at+txpower=20

将最大发射功率设置为20dbm

执行指令

查询: AT+ACK_TO=?

设置:AT+ACK_TO=xx

响应

+ACK_TO:extra ack timeout= 0us

OK

成功：OK

失败：ERROR

参数说明

默认值，不额外增加ACK超时时间；

设置增加AH模块WiFi协议参数ack timeout值，单位为微秒，默认为0。只有在进行超过1km通信时才需要设置该参数。计算公式为10*（距离公里数-1），例如2km设置ack_to=10。

修改值掉电不保存。

示例

AT+ACK_TO=100

增加100us的ACK包超时时间

执行指令

查询: AT+UNPAIR=?

设置:AT+UNPAIR=mac_addr

响应

无响应

成功：unpair sta:mac_addr

失败：sta:mac_addr is not exist

参数说明

mac_addr是对方的mac地址

示例

at+unpair=f6:de:09:75:a3:61

执行指令

查询: AT+APHIDE=?

设置:AT+APHIDE=0/1

响应

+APHIDE:1

OK

成功：OK

失败：ERROR

参数说明

在AP模式执行该命令，用于让AP的SSID能不能被扫描到。

0 : 能扫描到

1 :不能扫描到

示例

at+aphide=1

执行指令

AT+SCAN

响应

OK

说明

在STA模式执行该命令，用于扫描周围AP信息。

可以在umac的dbg打印中看到扫描到的AP信息：at+sysdbg=umac,1

执行指令

查询: AT+CHANNEL=?

设置:AT+CHANNE=channel-index

响应

+CHANNEL:3

OK

成功：OK

失败：ERROR

参数说明

查到第3个channel

Channel的值最小为1，且小于等于chanlist里的值的个数

通常在ap端设置

示例

频点数为3

AT+CHANNEL=1

执行指令

AT+SYSCFG

响应

说明

查看设备的参数信息

执行指令

AT+FWUPG

响应

执行成功后串口打印: CCCCCCCCCC

表示模块已进入升级模式，可以使用xmodem协议下载固件。

说明

支持xmodem协议的串口工具有：secureCRT，xshell

执行指令

AT+LOADDEF=1

响应

说明

恢复出厂设置

执行指令

查询: 不支持

设置:AT+SYSDBG=XXX,VALE

响应

成功：OK

参数说明

XXX可以选择LMAC（空口统计信息），UMAC（上层协议栈信息）；

VALE=0表示关闭相应打印，=1表示打开相应打印。

LMAC统计信息和UMAC统计信息是默认不打开的，如果有需要可以开启。

示例

AT+SYSDBG=LMAC,1

打开LMAC的打印

执行指令

AT+RST

响应

说明

复位

执行指令

查询: 不支持

设置:AT+JTAG=0/1

响应

OK

成功：OK

参数说明

需要搭配调试器使用，其中

0 : 关闭

1 : 打开

示例

AT+JTAG=1

执行指令

查询: AT+TX_PWR_SUPER=?

设置:AT+TX_PWR_SUPER=1/0

响应

tx pwr super enable 或

tx pwr super disable

1：tx pwr super enable

0：tx pwr super disable

参数说明

该命令用于手动设置是否开启Superpwr；

正常模式下，默认开启；

测试模式下，默认关闭；

示例

AT+TX_PWR_SUPER=1

执行指令

查询: AT+VERSION

响应

+VERSION:v2.4.1.3-34690, app:0

参数说明

在版本34690后支持

v2.4.1.3-34690, app:0，其中

v2是主版本，4是分支版本，1是patch版本，3是网桥类型固件（如果此位为5表示fmac固件）；

执行指令

查询: AT+DSLEEP=?

设置:AT+DSLEEP=1

响应

+DSLEEP:0

OK

成功：PSM: en=1 tus=0

wakeup by IO or timer, dsleep...

参数说明

休眠后不能读取

在连接状态，设置=1，使得设备进入休眠保活状态；

在非连接状态，设置=1表示设备进入休眠60秒后唤醒。

示例

AT+DSLEEP=1

执行指令

查询: AT+WAKEUP=?

设置:AT+WAKEUP=mac_addr

响应

无效

成功：OK

失败：ERROR

参数说明

AP端输入此命令，唤醒休眠的STA

示例

AT+WAKEUP=11:22:33:44:55:66

执行指令

查询：AT+R_SSID=?

设置:AT+R_SSID=repeater_ssid

响应

+R_SSID:repeater_ssid

OK

成功：OK

失败：ERROR

参数说明

设置中继连接下一级STA的SSID。

示例

执行指令

查询: AT+R_KEY=?

设置:AT+R_KEY=key_char

响应

+R_KEY:key_char

成功：OK

失败：ERROR

参数说明

设置中继连接下一级STA的KEY。

key_char的长度必须大于等于8个hex 字符。

key长度小于8时，返回：

ERROR

need 8 bytes at less

示例

AT+R_KEY=87654321

执行指令

查询: AT+ROAM=？

设置:AT+ROAM=0/1

响应

OK

成功：OK

失败：ERROR

参数说明

只有私有协议才支持漫游。

漫游的使能只在STA端需要设置。

漫游网络中AP的SSID可以按全字匹配，也可以按模糊匹配来设置。

全字匹配：所有AP的SSID设置成同1个SSID，SSID长度不限制，不超过32个字符即可。STA也都设置成这个SSID。建议优先选择全字匹配。

模糊匹配：不同AP的SSID后面3个字符不同。SSID总长度要大于8个字符，由共通字符串（位于SSID的串首）和3个字符的ID（位于串尾）来组成。例如共通字符串为HUGE_IC_AH,那么可以设置AP1的SSID为HUGE_IC_AH001，AP2的SSID为HUGE_IC_AH002，以此类推。STA的SSID要设置成跟其中的一个AP的SSID一致。

修改值掉电保存；

示例

AT+ROAM=1

执行指令

AT+IPERF2=c/s,ip_addr,port,time

响应

参数说明

c/s: “c”为客户端做发送，“s”则为服务器做接收

ip_addr: 对方的IP地址

port: 端口号

Time：持续时间，单位S

这个命令需要打开SYS_NETWORK_SUPPORT宏定义才支持

示例

两个设备进行tcp测试时，

发送端：AT+IPERF2=c,192.168.123.2,5002,60

接收端：AT+IPERF2=s,5002

执行指令

AT+PING=ip_domain,send_times,size

响应

参数说明

"ip_domain" 可为IP地址或域名；

注意，ping的同时不能输入其他at命令。

这个命令需要打开SYS_NETWORK_SUPPORT和LWIP_RAW宏定义才支持

示例

AT+PING=192.168.123.2,5,1024

执行指令

查询: AT+TEST_START=?

设置:AT+TEST_START=1 or 0

响应

OK

1：+TEST_START:test mode started

OK

0：+TEST_START:test mode stoped

OK

参数说明

进入测试模式，可以进行RF的Tx或Rx测试；

此命令会掉电不保存；

示例

AT+TEST_START=1

执行指令

查询: AT+LO_FREQ=?

设置:AT+LO_FREQ=freq

响应

LO freq= 924000 KHz

成功：OK

失败：ERROR

参数说明

表示当前频点是924M

Freq单位为KHz，例如Freq=908000表示908MHz；

此命令掉电不保存；

未作检查

示例

at+lo_freq=924000

执行指令

查询: AT+TX_START=?

设置:AT+TX_START=1 or 0

响应

OK

1：+TX_START:tx test started

OK

0：+TX_START:tx test stoped

OK

参数说明

在进入测试模式后，选择进入Tx模式，还是Rx模式（默认）；

此命令掉电不保存；

示例

AT+TX_START=1

执行指令

查询: AT+TX_MCS=?

设置:AT+TX_MCS=xx

响应

+TX_MCS:255

OK

成功：OK

失败：ERROR

参数说明

255表示自动调整mcs

设置tx mcs，范围在0~7或1M模式下10时表示固定成某个mcs，其他值表示mcs自动调整；

此命令掉电不保存；

示例

AT+TX_MCS=2

固定传输的MCS为2