这篇写给刚开始做 TXW81x 方案的软件工程师:先把开发环境搭起来,编译、调试、烧录完整跑一遍;再花十分钟认识 SDK 的整体结构,之后读代码会轻松很多。
技术细节以泰芯官方《TXW81x SDK 快速入门手册》为准。SDK 请到泰芯官网下载,下载前建议先看《TXW81x SDK 选型表》选对版本。
| 工具 | 用途 | 获取方式 |
|---|---|---|
| 创芯蜂 CKLink 调试器(推荐) | 调试、烧录 | 创芯蜂淘宝店购买 |
| 创芯蜂 HiveComm(推荐) | 固件烧录、串口看日志 | 免费下载,用法见 CKLink 驱动安装与固件烧录教程 |
| CDK 集成开发环境 | 编辑、编译、调试 | 平头哥官网,建议 v2.8.8 及以上 |
| TXW81x SDK | 方案代码 | 泰芯官网 |
project 目录,双击工程文件 *.cdkproj,用 CDK 打开。先做一次调试配置:
然后把 CKLink 接到板子的调试口,点调试按钮(或按 Ctrl+F5)就能开始调试。
打断点之前,记得关掉代码里的看门狗。 否则程序停在断点上一会儿,芯片就被看门狗复位了。
正常的调试流程会先复位芯片,现场就没了。想保留现场,先这样配置,再插调试器:
gdb.init:程序没开看门狗,可以把内容清空;开了看门狗,按泰芯手册保留指定的两条语句。| 方式 | 适合场景 | 要点 |
|---|---|---|
| 创芯蜂 HiveComm(推荐) | 日常烧写 | 免安装,烧录算法已内置,能自动识别芯片,烧完直接切到串口看日志;下载 HiveComm,步骤见 CKLink 驱动安装与固件烧录教程 |
| CDK 下载 | 边改边调试 | 菜单 Flash → Download,会保留非代码区的配置;需要清掉配置时选 Chip Erase |
| 串口升级 | 已带串口升级功能的固件 | SDK 集成了串口升级(命令 TX+OTA),具体用法可咨询泰芯 FAE |
| 量产烧录 | 产线 | 见泰芯《TXW81x 量产和烧录指南》 |
烧不进去,看这篇:TXW 系列芯片固件烧录教程:烧录器接线、操作与失败排查。
| 目录 | 内容 | 要不要改 |
|---|---|---|
csky/ | CSKY RTOS 代码 | 一般不用动 |
project/ | CDK 工程和应用代码,main.c 在这里 | 主要在这里开发 |
sdk/chip/ | 芯片定义和启动代码 | 不要动 |
sdk/driver/ | 外设驱动 | 按需 |
include/ | SDK 头文件 | 不用改 |
lib/ | 常用库(lwIP 协议栈、以太网 PHY 驱动等),自己移植的库也放这里 | 按需 |
上电后大致按这个顺序执行:
Reset_Handler → SystemInit → pre_main → main_task → dev_init → device_init → main
其中只有 device_init(位于 project/device.c,负责初始化和注册设备,设备注册后才能使用)和 main(应用入口)是留给你修改的,其余启动代码不要改。
小技巧:device_init 里没用到的外设初始化可以删掉,能省下一些代码空间。系统参数在 project/sys_cfg.h 和 project/sys_cfg.c 中配置,常用的有:Wi-Fi 工作模式(STA、AP、AP+STA)、信道、加密方式、IP / 掩码 / 网关、DHCP 服务端和客户端开关等。
syscfg_read / syscfg_write;全局变量 sys_cfgs 可以在其他模块直接访问。sys_config.h 里调整,比如发得多、收得少,就加大发送缓冲。system_clock_init()。typesdef.h),不要直接引用编译器的头文件。dev_get(设备 ID) 拿到设备,再调用 HAL API;设备 ID 定义在 include/devid.h。常用 API:
| 用途 | API |
|---|---|
| 打印 | os_printf(带时间戳)、dump_hex(十六进制打印) |
| 内存 | os_malloc、os_zalloc、os_realloc、os_free |
| 延时 | os_sleep(秒)、os_sleep_ms(毫秒) |
| 创建任务 | OS_TASK_INIT 宏,一步完成初始化、设置栈大小和优先级、启动任务 |
| 想看什么 | 怎么做 |
|---|---|
| Wi-Fi 收发统计(RSSI、重传、丢包、频偏等) | 协议栈会周期打印,用 AT+PRINT_PERIOD=毫秒数 调整间隔,设为 0 关闭 |
| heap 还剩多少 | 调用 sysheap_status() |
| 各任务的 CPU 占用 | 调用 cpu_loading_print() |
| 跑 XIP 时的取指效率 | 用 Cache 命中和丢失计数算命中率;可以从提高 SPI Flash 线模式和频率、优化代码局部性入手 |
泰芯官方还有视频、USB、音频、蓝牙配网、IOT、低功耗、量产烧录等专项开发指南,都可以在泰芯文档中心找到。