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 的 SSID1 为不能被扫描到
AT+SCANSTA 扫描周围 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
问答

发布
问题