TXW82x SDK 快速入門:選對 SDK 版本,編譯雙核工程到第一次上電

發布於 2026-11-08 22:00:09

這篇寫給剛接手 TXW82x 方案的軟件工程師。按順序走完:選對 SDK 版本 → 選一個參考方案 → 編譯雙核工程 → 燒錄上電 → 認識 SDK 結構。走完一遍,後面看代碼會輕松很多。

內容以泰芯官方《TXW82x_FPV_SDK 開發文檔》《TXW82x SDK 架構與配置說明》為準,適用 SDK v2.7.1.7。SDK 請到泰芯官網下載。

一、先選對 SDK 版本

TXW82x 目前有兩個 FPV SDK 分支,能做的應用不一樣。下載前先對照官方《SDK 選型表》:

SDK 適合的產品 說明
2.7.0.7 常電 IPC、記錄儀、拇指相機、對講機、嬰兒監護器、雙目 720P IPC 支持單目 720P / 1080P / 720P 插值 1080P 的錄卡、圖傳、回放、拍照,支持縮時錄影
2.7.1.7 低功耗 IPC、AI 鬧鐘、網絡點歌機、AI 相機 新增低功耗 IPC、大模型接入(扣子、豆包語音等)、播放器;暫不支持記錄儀、拇指相機、對講機、嬰兒監護器、雙目 720P IPC

兩個版本都支持藍牙配網、WPA3、ISP 調試工具,以及「錄風者」App。

以 2.7.1.7 為例,兩種攝像頭的默認碼流如下(實際帧率以攝像頭配置表為準):

攝像頭 主碼流 輔碼流 拍照
720P(默認 GC1084) H.264 1280×720@25fps H.264 640×360@25fps MJPEG 1280×720
1080P(默認 GC2053) H.264 1920×1080@15fps H.264 1280×720@15fps MJPEG 1920×1080

錄卡默認是 MP4 格式:主碼流 + AAC 音頻(8kHz / 16bit)。

二、準備工具

工具 用途
Windows 電腦 + C-SKY CDK 編輯、編譯、調試(需要帶 cdk-make.exe、編譯器和 CKLink 調試組件)
創芯蜂 CKLink 調試器(淘寶購買)+ 驅動 下載、調試
串口工具 看啟動日志
創芯蜂 HiveComm 單獨燒錄固件(推薦)

需要在 Linux 下命令行編譯,可參考泰芯《SDK Linux 環境編譯簡要說明》,但工具鏈版本、路徑大小寫和後處理腳本要逐項核對,不能照搬 Windows 命令。

SDK 裡的工程大量使用相對路徑。CDK 裝在哪裡都可以,但不要移動 SDK 內部的目錄結構。

三、選一個參考方案

SDK 用一個宏 CUSTOMER_ID 選擇產品方案,位置在 project/txw82xApp/project_config.h:

#define CUSTOMER_ID 5
ID 方案 適合做什麼
1 AI 語音對話 無屏語音助手(需配置雲端賬號)
2 AI 視覺對話 帶屏 AI 助手
3 AI 鬧鐘 SPI 屏桌面設備
4 ISP 調試 攝像頭畫質調試,不建議直接量產
5 IPC 720P 默認方案,720P 網絡攝像機的起點
6 LCD 720P 帶 MIPI 屏的攝像機
7 IPC Sleep 720P 低功耗 IPC
8 IPC 1080P 1080P 網絡攝像機
9 電池相機 1080P 電池攝像機

建議從最接近你產品的方案改起,不要從零搭。

配置改在哪一層

配置分三層,優先級從高到低:

  1. project/txw82xApp/project_config.h:選方案(CUSTOMER_ID)。
  2. sdk/demo/<方案>/xxx_config.h:方案的 Sensor、屏幕、網絡、內存等配置,平時改這裡。
  3. project/txw82xApp/sys_config.h:系統默認值,只在方案沒定義時生效,不要直接改。

另外兩點:

  • 宏打開了不代表功能已經接通,還要確認方案的初始化代碼確實調用了對應模塊。
  • 引腳由 project/txw82xApp/config.cfg 和 pin_param.h 生成(開啟了 PIN_FROM_PARAM 時)。新增 pin_param.h 宏要追加在文件末尾,改完要重新打包固件。

四、編譯:先 Core 再 App

TXW82x 是雙核,SDK 裡有兩個工程:

工程 運行在 負責
project/txw82xCore/txw82xCore.cdkproj CPU1 Wi-Fi LMAC、BLE 底層、802.11 協議棧
project/txw82xApp/txw82xApp.cdkproj CPU0 應用、網絡、多媒體、存儲、UI

編譯順序必須是 Core → App。 App 打包時要用到剛編出來的 Core 鏡像大小和 CRC。用 IDE 打開 project/txw82x.cdkws 也一樣,先編 Core 再編 App。

命令行編譯(在 SDK 根目錄,把 CDK 路徑換成你自己的):

& 'Z:\C-SKY\CDK\cdk-make.exe' -p '.\project\txw82xCore\txw82xCore.cdkproj' -d build -c FLASH
& 'Z:\C-SKY\CDK\cdk-make.exe' -p '.\project\txw82xApp\txw82xApp.cdkproj' -d build -c FLASH

最終要燒的整機固件是:

project/txw82xApp/APP.bin

幾個容易出錯的地方:

  • 發布包裡預置了一個 project/txw82xApp/txw82xcore.bin,它不是你剛編的。改了 CPU1、Wi-Fi 或 Core 配置後,一定要重編 Core,否則 APP.bin 裡可能還是舊 Core。
  • 編譯日志出現 !!!txw82xcore code is distroyed!,說明 Core 校驗失敗。這時不要只重編 App,要先清理並重編 Core,再編 App。
  • 切換方案、改鏈接腳本或大量改宏後,先 clean 兩個工程再完整重編(把命令裡的 build 換成 clean)。
  • 新增的 .c 文件要手動加進 txw82xApp.cdkproj,否則不會參與編譯。

五、燒錄和第一次上電

燒錄推薦用創芯蜂 HiveComm,免安裝、燒錄算法已內置,步驟見 CKLink 驅動安裝與固件燒錄教程。燒不進去可以看 固件燒錄失敗排查。

第一次上電建議這樣檢查:

  1. 先只接電源、串口和 CKLink,攝像頭、屏幕、TF 卡都先不接。
  2. 燒錄和板子匹配的 APP.bin。
  3. 打開串口,保存完整啟動日志,確認 CPU0 正常啟動。
  4. 確認日志裡出現 CPU1 ready!,說明 Wi-Fi 核起來了。
  5. 確認 PSRAM、設備表、參數區和網絡初始化沒有報錯。
  6. 再逐個接入攝像頭、TF 卡、屏幕、USB 和音頻,每接一個看一次日志。
不要帶電插拔攝像頭、屏幕和核心板,也不要帶電改電壓跳線。

默認網絡

方案沒改網絡配置時,設備默認是 AP 模式:

項目 默認值
SSID 82X_ + MAC 後三字節
密碼 12345678
設備 IP 192.168.1.1
分配給手機 / 電腦的 IP 192.168.1.100 ~ 192.168.1.254

手機或電腦連上這個熱點,就能用 VLC 拉 RTSP 流看畫面,具體見 TXW82x 錄像、拍照與 RTSP 圖傳。

默認密碼只能用於開發,量產必須改掉,並設計好首次配網流程。

六、認識 SDK

目錄結構

目錄 內容 要不要改
project/txw82xApp/ CPU0 工程、板級代碼、參數和最終固件 主要在這裡
project/txw82xCore/ CPU1 工程和後處理腳本 一般不動
sdk/demo/ 各個參考方案 在這裡組織你的產品功能
sdk/app/ 錄像、拍照、RTSP、LCD、UI 等可複用組件 調用為主
sdk/driver/、sdk/lib/、sdk/hal/、sdk/chip/ 驅動、組件庫、HAL、芯片啟動 不建議改
libs/ CPU0 / CPU1 的預編譯庫 不能改

這個 SDK 不是全源碼

Wi-Fi、ISP、H.264、USB、SD、音頻等模塊是以靜態庫(libs/ 下的 .a 文件)交付的。所以:

  • 改了代碼不生效,先確認這個函數是在源碼裡,還是在靜態庫裡。
  • 頭文件裡有聲明,不代表驅動源碼已開放。
  • 不要拿其他 SDK 版本的庫來替換,需要改閉源模塊請聯系泰芯或創芯蜂。

啟動流程

main() 依次初始化雙核、內存、配置和事件,再初始化 MSI 媒體框架、編解碼、Wi-Fi / BLE / 網絡、文件系統,最後調用 sys_app_init(),按 CUSTOMER_ID 進入對應方案的 xxx_demo_init()。你的產品邏輯從方案的 init 函數開始寫,不需要在業務代碼裡重複初始化 MSI 和文件系統。

雙核怎麼分工

業務代碼默認都跑在 CPU0。CPU1 留給 Wi-Fi 協議棧。確實要讓 CPU1 分擔計算時,只能放純軟件運算(輸入輸出都是數據,不碰任何硬件、不創建任務和信號量),通過 SDK 的 RPC 接口調用。另外 CPU1 沒有硬件浮點,不要在它上面做浮點運算。

七、下一步

遇到問題歡迎在社區提問。

參考資料

0 條評論

AI
問答

發布
問題