這篇寫給剛接手 TXW82x 方案的軟件工程師。按順序走完:選對 SDK 版本 → 選一個參考方案 → 編譯雙核工程 → 燒錄上電 → 認識 SDK 結構。走完一遍,後面看代碼會輕松很多。
內容以泰芯官方《TXW82x_FPV_SDK 開發文檔》《TXW82x SDK 架構與配置說明》為準,適用 SDK v2.7.1.7。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 | 電池攝像機 |
建議從最接近你產品的方案改起,不要從零搭。
配置分三層,優先級從高到低:
project/txw82xApp/project_config.h:選方案(CUSTOMER_ID)。sdk/demo/<方案>/xxx_config.h:方案的 Sensor、屏幕、網絡、內存等配置,平時改這裡。project/txw82xApp/sys_config.h:系統默認值,只在方案沒定義時生效,不要直接改。另外兩點:
project/txw82xApp/config.cfg 和 pin_param.h 生成(開啟了 PIN_FROM_PARAM 時)。新增 pin_param.h 宏要追加在文件末尾,改完要重新打包固件。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。build 換成 clean)。.c 文件要手動加進 txw82xApp.cdkproj,否則不會參與編譯。燒錄推薦用創芯蜂 HiveComm,免安裝、燒錄算法已內置,步驟見 CKLink 驅動安裝與固件燒錄教程。燒不進去可以看 固件燒錄失敗排查。
第一次上電建議這樣檢查:
APP.bin。CPU1 ready!,說明 Wi-Fi 核起來了。不要帶電插拔攝像頭、屏幕和核心板,也不要帶電改電壓跳線。
方案沒改網絡配置時,設備默認是 AP 模式:
| 項目 | 默認值 |
|---|---|
| SSID |
82X_ + MAC 後三字節 |
| 密碼 | 12345678 |
| 設備 IP | 192.168.1.1 |
| 分配給手機 / 電腦的 IP | 192.168.1.100 ~ 192.168.1.254 |
手機或電腦連上這個熱點,就能用 VLC 拉 RTSP 流看畫面,具體見 TXW82x 錄像、拍照與 RTSP 圖傳。
默認密碼只能用於開發,量產必須改掉,並設計好首次配網流程。
| 目錄 | 內容 | 要不要改 |
|---|---|---|
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 的預編譯庫 | 不能改 |
Wi-Fi、ISP、H.264、USB、SD、音頻等模塊是以靜態庫(libs/ 下的 .a 文件)交付的。所以:
main() 依次初始化雙核、內存、配置和事件,再初始化 MSI 媒體框架、編解碼、Wi-Fi / BLE / 網絡、文件系統,最後調用 sys_app_init(),按 CUSTOMER_ID 進入對應方案的 xxx_demo_init()。你的產品邏輯從方案的 init 函數開始寫,不需要在業務代碼裡重複初始化 MSI 和文件系統。
業務代碼默認都跑在 CPU0。CPU1 留給 Wi-Fi 協議棧。確實要讓 CPU1 分擔計算時,只能放純軟件運算(輸入輸出都是數據,不碰任何硬件、不創建任務和信號量),通過 SDK 的 RPC 接口調用。另外 CPU1 沒有硬件浮點,不要在它上面做浮點運算。
遇到問題歡迎在社區提問。