泰芯 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 射频性能自测。