这篇写给刚开始做 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, 低功耗, 量产烧录等专项开发指南, 都可以在泰芯文档中心找到.