這篇寫給剛開始做 TXW81x 方案的軟件工程師:先把開發環境搭起來,編譯、調試、燒錄完整跑一遍;再花十分鐘認識 SDK 的整體結構,之後讀代碼會輕松很多。
技術細節以泰芯官方《TXW81x SDK 快速入門手冊》為準。SDK 請到泰芯官網下載,下載前建議先看《TXW81x SDK 選型表》選對版本。
| 工具 | 用途 | 獲取方式 |
|---|---|---|
| 創芯蜂 CKLink 調試器(推薦) | 調試、燒錄 | 創芯蜂淘寶店購買 |
| 創芯蜂 HiveComm(推薦) | 固件燒錄、串口看日志 | 免費下載,用法見 CKLink 驅動安裝與固件燒錄教程 |
| CDK 集成開發環境 | 編輯、編譯、調試 | 平頭哥官網,建議 v2.8.8 及以上 |
| TXW81x SDK | 方案代碼 | 泰芯官網 |
project 目錄,雙擊工程文件 *.cdkproj,用 CDK 打開。先做一次調試配置:
然後把 CKLink 接到板子的調試口,點調試按鈕(或按 Ctrl+F5)就能開始調試。
打斷點之前,記得關掉代碼裡的看門狗。 否則程序停在斷點上一會兒,芯片就被看門狗複位了。
正常的調試流程會先複位芯片,現場就沒了。想保留現場,先這樣配置,再插調試器:
gdb.init:程序沒開看門狗,可以把內容清空;開了看門狗,按泰芯手冊保留指定的兩條語句。| 方式 | 適合場景 | 要點 |
|---|---|---|
| 創芯蜂 HiveComm(推薦) | 日常燒寫 | 免安裝,燒錄算法已內置,能自動識別芯片,燒完直接切到串口看日志;下載 HiveComm,步驟見 CKLink 驅動安裝與固件燒錄教程 |
| CDK 下載 | 邊改邊調試 | 菜單 Flash → Download,會保留非代碼區的配置;需要清掉配置時選 Chip Erase |
| 串口升級 | 已帶串口升級功能的固件 | SDK 集成了串口升級(命令 TX+OTA),具體用法可諮詢泰芯 FAE |
| 量產燒錄 | 產線 | 見泰芯《TXW81x 量產和燒錄指南》 |
燒不進去,看這篇:TXW 系列芯片固件燒錄教程:燒錄器接線、操作與失敗排查。
| 目錄 | 內容 | 要不要改 |
|---|---|---|
csky/ |
CSKY RTOS 代碼 | 一般不用動 |
project/ |
CDK 工程和應用代碼,main.c 在這裡 |
主要在這裡開發 |
sdk/chip/ |
芯片定義和啟動代碼 | 不要動 |
sdk/driver/ |
外設驅動 | 按需 |
include/ |
SDK 頭文件 | 不用改 |
lib/ |
常用庫(lwIP 協議棧、以太網 PHY 驅動等),自己移植的庫也放這裡 | 按需 |
上電後大致按這個順序執行:
Reset_Handler → SystemInit → pre_main → main_task → dev_init → device_init → main
其中只有 device_init(位於 project/device.c,負責初始化和注冊設備,設備注冊後才能使用)和 main(應用入口)是留給你修改的,其餘啟動代碼不要改。
小技巧:device_init 裡沒用到的外設初始化可以刪掉,能省下一些代碼空間。
系統參數在 project/sys_cfg.h 和 project/sys_cfg.c 中配置,常用的有:Wi-Fi 工作模式(STA、AP、AP+STA)、信道、加密方式、IP / 掩碼 / 網關、DHCP 服務端和客戶端開關等。
syscfg_read / syscfg_write;全局變量 sys_cfgs 可以在其他模塊直接訪問。sys_config.h 裡調整,比如發得多、收得少,就加大發送緩沖。system_clock_init()。typesdef.h),不要直接引用編譯器的頭文件。dev_get(設備 ID) 拿到設備,再調用 HAL API;設備 ID 定義在 include/devid.h。常用 API:
| 用途 | API |
|---|---|
| 打印 |
os_printf(帶時間戳)、dump_hex(十六進制打印) |
| 內存 |
os_malloc、os_zalloc、os_realloc、os_free
|
| 延時 |
os_sleep(秒)、os_sleep_ms(毫秒) |
| 創建任務 |
OS_TASK_INIT 宏,一步完成初始化、設置棧大小和優先級、啟動任務 |
| 想看什麼 | 怎麼做 |
|---|---|
| Wi-Fi 收發統計(RSSI、重傳、丟包、頻偏等) | 協議棧會周期打印,用 AT+PRINT_PERIOD=毫秒數 調整間隔,設為 0 關閉 |
| heap 還剩多少 | 調用 sysheap_status()
|
| 各任務的 CPU 占用 | 調用 cpu_loading_print()
|
| 跑 XIP 時的取指效率 | 用 Cache 命中和丟失計數算命中率;可以從提高 SPI Flash 線模式和頻率、優化代碼局部性入手 |
泰芯官方還有視頻、USB、音頻、藍牙配網、IOT、低功耗、量產燒錄等專項開發指南,都可以在泰芯文檔中心找到。