泰芯 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 射頻性能自測。