泰芯 AH SDK V2. x 的固件支持 AT 指令, 组网, 配对, 加密, 中继, 休眠和调试都可以用 AT 指令完成. 本文按「连上串口 → 两台模组建立连接 → 进阶功能 → 调试」的顺序介绍常用指令.
验证方法: 发送 AT+SYSCFG, 能打印出一长串设备参数, 说明串口通了; 没有任何回显, 就检查接线, 波特率和新行设置.
网桥也可以不接串口, 用泰芯的网口工具:
工具在泰芯官网 nettools 下载. 电脑网卡没有 IP 时, 先手动设一个静态 IP.
最小配置: 一台设成 AP, 一台设成 STA, 其他参数两边一样.
AT+CHAN_LIST=9080, 9160, 9240 // 信道列表, 两边必须完全一致 (含顺序)
AT+BSS_BW=8 // 带宽 8MHz, 两边一致
AT+SSID=hgic_ah_test // SSID, 最长 32 个字符
AT+ENCRYPT=1 // 开启加密
AT+KEY=12345678 // 密码, 至少 8 个字符
AT+WIFIMODE=ap // 另一台设为 sta
信道怎么填, 各国能用哪些频点, 见 HaLow 频点与带宽设置.
AT+PAIR=1 进入配对; 看到 PAIRING SUCCESS 后, 必须执行 AT+PAIR=0 退出配对, 退出后才会开始握手连接. AT+PAIR=2 表示按第 2 组配对, 可以在同一场地分组配对互不干扰. 无论哪种方式, 都要保证两边的 CHAN_LIST 和 BSS_BW 一致.
Linux 主控的提示: 在模组从「未连接」切换到「已连接」的过程中修改 SSID 或密码, 可能导致 AP 显示已连接, STA 显示未连接, 之后一直连不上. 规避办法是先ifconfig hg0 down, 改完参数再ifconfig hg0 up.
| 指令 | 作用 | 说明 |
|---|---|---|
AT+WIFIMODE=ap/sta/apsta |
设置角色 | apsta 是中继; wnbap/wnbsta 是兼容 V1. 6 的私有协议模式, 默认固件不支持, 需要找 FAE |
AT+SSID=xxx |
设置 SSID | 默认是 HALOW_ 加 MAC 后 3 字节 |
AT+ENCRYPT=0/1 |
关闭/开启加密 | 加密方式为 WPA2-PSK (AES) |
AT+KEY=xxx |
设置密码 | 默认 12345678, 至少 8 个字符 |
AT+CHANNEL=n |
指定信道 | n 从 1 开始, 不超过 CHAN_LIST 的个数, 一般在 AP 设置 |
AT+TXPOWER=1~20 |
最大发射功率 | 单位 dBm, 超出范围按 20 处理, 掉电不保存 |
AT+ACK_TO=n |
延长 ACK 超时 | 单位 us, 超过 1km 通信才需要设置, 按 10× (公里数-1) 计算, 2km 设 10; 掉电不保存 |
AT+UNPAIR=mac |
解除某个 STA 的配对 | |
AT+APHIDE=0/1 |
隐藏 AP 的 SSID | 1 为不能被扫描到 |
AT+SCAN |
STA 扫描周围 AP | 结果在 umac 打印里看, 先执行 AT+SYSDBG=umac, 1
|
中继节点同时是上级 AP 的 STA 和下级 STA 的 AP, 用 AT+WIFIMODE=apsta 设置. 以不加密为例:
// AP
AT+SSID=ssid1
AT+ENCRYPT=0
// 中继
AT+WIFIMODE=apsta
AT+ENCRYPT=0
AT+SSID=ssid1 // 用来连上级 AP
AT+R_SSID=ssid1_r1 // 给下级 STA 连接用
// STA
AT+SSID=ssid1_r1 // 等于中继的 R_SSID
AT+ENCRYPT=0
开启加密时, 中继用 AT+KEY 设置连 AP 的密码, 用 AT+R_KEY 设置给下级 STA 的密码. 中继后流量约减半, 延时约翻倍.
在 STA 上执行 AT+ROAM=1. 泰芯文档说明只有私有协议支持漫游. AP 的 SSID 推荐全字匹配: 所有 AP 和 STA 设成同一个 SSID. 也可以模糊匹配: SSID 总长大于 8 个字符, 由共同前缀加 3 位编号组成, 比如 HUGE_IC_AH001, HUGE_IC_AH002, STA 设成其中一个即可.
AT+DSLEEP=1: 已连接时进入休眠保活; 未连接时休眠 60 秒后唤醒. AT+WAKEUP=mac: 在 AP 端远程唤醒指定 STA. STA 低功耗对硬件有要求 (外接 1. 3V DC-DC, Nor Flash 等) , 见 TX-AH 模组硬件设计要点.
| 指令 | 作用 |
|---|---|
AT+SYSCFG |
查看全部参数 |
AT+VERSION |
查看固件版本, 如 v2. 4. 1. 3-34690: 最后一位 3 表示网桥固件, 5 表示 FMAC 固件 |
AT+SYSDBG=LMAC, 1 |
打开空口统计打印 (UMAC 为上层协议栈) , 0 关闭 |
AT+LOADDEF=1 |
恢复出厂设置 |
AT+RST |
重启 |
AT+FWUPG |
串口升级固件, 见下文 |
AT+JTAG=0/1 |
关闭/打开调试口, 配合调试器使用 |
AT+TX_PWR_SUPER=0/1 |
关闭/开启 superpwr, 正常模式默认开启 |
串口升级固件: 发送 AT+FWUPG, 串口开始连续打印 CCCCCCCCCC, 说明进入了 Xmodem 接收模式; 在 SecureCRT, Xshell 等支持 Xmodem 的工具里选择「发送 Xmodem」, 选中固件, 传到 100% 后自动重启. 这个方法要求模组里原本已有固件, 空片要先烧录, 见 HaLow 常见问题汇总.
网络测试 (需要固件打开 SYS_NETWORK_SUPPORT 宏, ping 还需要 LWIP_RAW) :
AT+IPERF2=s, 5002 // 接收端
AT+IPERF2=c, 192. 168. 123. 2, 5002, 60 // 发送端: 对端 IP, 端口, 时长 (秒)
AT+PING=192. 168. 123. 2, 5, 1024 // 目标, 次数, 包长
射频测试模式的指令 (at+test_start, at+lo_freq 等) 见 AH 射频性能自测.