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
問答

發布
問題