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