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@25fpsH.264 640×360@25fpsMJPEG 1280×720
1080P(默认 GC2053)H.264 1920×1080@15fpsH.264 1280×720@15fpsMJPEG 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方案适合做什么
1AI 语音对话无屏语音助手(需配置云端账号)
2AI 视觉对话带屏 AI 助手
3AI 闹钟SPI 屏桌面设备
4ISP 调试摄像头画质调试,不建议直接量产
5IPC 720P默认方案,720P 网络摄像机的起点
6LCD 720P带 MIPI 屏的摄像机
7IPC Sleep 720P低功耗 IPC
8IPC 1080P1080P 网络摄像机
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.cdkprojCPU1Wi-Fi LMAC、BLE 底层、802.11 协议栈
project/txw82xApp/txw82xApp.cdkprojCPU0应用、网络、多媒体、存储、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 模式:

项目默认值
SSID82X_ + MAC 后三字节
密码12345678
设备 IP192.168.1.1
分配给手机 / 电脑的 IP192.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
问答

发布
问题