TXW81x SDK 快速入門:從搭建開發環境到第一次燒錄調試

發布於 2026-11-07 16:40:58

這篇寫給剛開始做 TXW81x 方案的軟件工程師:先把開發環境搭起來,編譯、調試、燒錄完整跑一遍;再花十分鐘認識 SDK 的整體結構,之後讀代碼會輕松很多。

技術細節以泰芯官方《TXW81x SDK 快速入門手冊》為準。SDK 請到泰芯官網下載,下載前建議先看《TXW81x SDK 選型表》選對版本。

一、準備工具

工具 用途 獲取方式
創芯蜂 CKLink 調試器(推薦) 調試、燒錄 創芯蜂淘寶店購買
創芯蜂 HiveComm(推薦) 固件燒錄、串口看日志 免費下載,用法見 CKLink 驅動安裝與固件燒錄教程
CDK 集成開發環境 編輯、編譯、調試 平頭哥官網,建議 v2.8.8 及以上
TXW81x SDK 方案代碼 泰芯官網

二、編譯

  1. 解壓 SDK,進入 project 目錄,雙擊工程文件 *.cdkproj,用 CDK 打開。
  2. 點擊菜單中的編譯,或直接按 F7。

三、調試

先做一次調試配置:

  1. 打開 Project Settings,進入 Debug 頁,勾選 Use ICE。
  2. 進入 ICE 的 Settings,調試器連接正常時,這裡能讀到目標芯片的信息。
  3. ICE Clock 設為 120KHz,勾選 Reset After Connect,複位方式選 soft reset。

然後把 CKLink 接到板子的調試口,點調試按鈕(或按 Ctrl+F5)就能開始調試。

打斷點之前,記得關掉代碼裡的看門狗。 否則程序停在斷點上一會兒,芯片就被看門狗複位了。

程序已經在跑,想中途接上調試器

正常的調試流程會先複位芯片,現場就沒了。想保留現場,先這樣配置,再插調試器:

  1. 在 Project Settings(Alt+F7)裡取消勾選 Load Application to Target。
  2. 在 ICE Settings 裡勾選 Download to Flash,取消 Reset After Connect;ICE Clock 不要超過系統時鐘的 1/2。
  3. 修改工程的 gdb.init:程序沒開看門狗,可以把內容清空;開了看門狗,按泰芯手冊保留指定的兩條語句。

四、燒錄

方式 適合場景 要點
創芯蜂 HiveComm(推薦) 日常燒寫 免安裝,燒錄算法已內置,能自動識別芯片,燒完直接切到串口看日志;下載 HiveComm,步驟見 CKLink 驅動安裝與固件燒錄教程
CDK 下載 邊改邊調試 菜單 Flash → Download,會保留非代碼區的配置;需要清掉配置時選 Chip Erase
串口升級 已帶串口升級功能的固件 SDK 集成了串口升級(命令 TX+OTA),具體用法可諮詢泰芯 FAE
量產燒錄 產線 見泰芯《TXW81x 量產和燒錄指南》

燒不進去,看這篇:TXW 系列芯片固件燒錄教程:燒錄器接線、操作與失敗排查。

五、認識 SDK

目錄結構

目錄 內容 要不要改
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 服務端和客戶端開關等。

  • 參數默認保存在 Flash 最後 2 個 sector,兩個參數區交替寫入,更不容易因掉電丟失。
  • 讀寫參數用 syscfg_read / syscfg_write;全局變量 sys_cfgs 可以在其他模塊直接訪問。
  • 參數結構體開頭的 magic、crc、size 是核心字段,不要修改,也不要占用。

Flash 與內存布局

  • Flash:雙固件區(地址 0 和 512KB / 1MB 處)加雙參數區。
  • SRAM 共 288KB:依次是深睡眠參數區、代碼段與數據段、heap、Wi-Fi 接收緩沖、Wi-Fi 發送緩沖。收發緩沖的大小可以按實際數據量在 sys_config.h 裡調整,比如發得多、收得少,就加大發送緩沖。
  • 默認系統時鐘 180MHz,需要修改時重寫 system_clock_init()。

六、寫代碼的幾條規矩

  • 頭文件只引用 SDK 提供的(基礎類型用 typesdef.h),不要直接引用編譯器的頭文件。
  • 訪問外設走 HAL:先用 dev_get(設備 ID) 拿到設備,再調用 HAL API;設備 ID 定義在 include/devid.h。
  • 和操作系統相關的走 OSAL:任務、互斥鎖、信號量、消息隊列、軟件定時器都有封裝。
  • 軟件定時器基於 1ms 的 OS tick,所有定時器共用一個執行序列,回調函數要盡量短。

常用 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、低功耗、量產燒錄等專項開發指南,都可以在泰芯文檔中心找到。

開發中遇到問題,歡迎在社區提問,也可以先問 AI 助手。

0 條評論

AI
問答

發布
問題