TX-AH 模组 AT 指令上手: 串口配置, 组网配对, 中继漫游与休眠

发布于 2026-11-08 22: 00: 50

泰芯 AH SDK V2. x 的固件支持 AT 指令, 组网, 配对, 加密, 中继, 休眠和调试都可以用 AT 指令完成. 本文按「连上串口 → 两台模组建立连接 → 进阶功能 → 调试」的顺序介绍常用指令.

一, 连上设备

1. 串口

  • 用模组的调试串口发 AT 指令. 调试口和通信接口有关: USB 固件在 IOA10/IOA11, SDIO, SPI, UART, 网桥固件在 IOA12/IOA13. 开发板上用 UART 跳线切换, 打印波特率 115200.
  • 串口工具里一定要打开「新行模式」 (发送时自动加回车换行) , 否则输入的 AT 指令不生效.
  • 电脑识别不到串口, 一般是没装 CH340 驱动.

验证方法: 发送 AT+SYSCFG, 能打印出一长串设备参数, 说明串口通了; 没有任何回显, 就检查接线, 波特率和新行设置.

2. 网口 (网桥产品)

网桥也可以不接串口, 用泰芯的网口工具:

  • netat. exe: 网线连接网桥和电脑, 运行后输入电脑网卡的 IP, 就能选中设备, 像串口一样输入 AT 指令.
  • netlog. exe: 用网线查看网桥日志, 用法相同, 只能看直连的那台设备.

工具在泰芯官网 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 频点与带宽设置.

两种连接方式

  1. 相同参数自动连接: AP 和 STA 都设好同样的 SSID 和密码, 开机后自动连上.
  2. 配对连接: 只在 AP 上设好 SSID 和密码, 两边都执行 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 射频性能自测.

参考资料

0 条评论

AI
问答

发布
问题