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
问答

发布
问题