这篇写给刚接手 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 没有硬件浮点, 不要在它上面做浮点运算.
遇到问题欢迎在社区提问.