TXW81x SDK 快速入门: 从搭建开发环境到第一次烧录调试

发布于 2026-11-07 16: 40: 58

这篇写给刚开始做 TXW81x 方案的软件工程师: 先把开发环境搭起来, 编译, 调试, 烧录完整跑一遍; 再花十分钟认识 SDK 的整体结构, 之后读代码会轻松很多.

技术细节以泰芯官方 TXW81x SDK 快速入门手册 为准. SDK 请到泰芯官网下载, 下载前建议先看 TXW81x SDK 选型表 选对版本.

一, 准备工具

工具 用途 获取方式
创芯蜂 CKLink 调试器 (推荐) 调试, 烧录 创芯蜂淘宝店购买
创芯蜂 HiveComm (推荐) 固件烧录, 串口看日志 免费下载, 用法见 CKLink 驱动安装与固件烧录教程
CDK 集成开发环境 编辑, 编译, 调试 平头哥官网, 建议 v2. 8. 8 及以上
TXW81x SDK 方案代码 泰芯官网

二, 编译

  1. 解压 SDK, 进入 project 目录, 双击工程文件 *. cdkproj, 用 CDK 打开.
  2. 点击菜单中的编译, 或直接按 F7.

三, 调试

先做一次调试配置:

  1. 打开 Project Settings, 进入 Debug 页, 勾选 Use ICE.
  2. 进入 ICE 的 Settings, 调试器连接正常时, 这里能读到目标芯片的信息.
  3. ICE Clock 设为 120KHz, 勾选 Reset After Connect, 复位方式选 soft reset.

然后把 CKLink 接到板子的调试口, 点调试按钮 (或按 Ctrl+F5) 就能开始调试.

打断点之前, 记得关掉代码里的看门狗. 否则程序停在断点上一会儿, 芯片就被看门狗复位了.

程序已经在跑, 想中途接上调试器

正常的调试流程会先复位芯片, 现场就没了. 想保留现场, 先这样配置, 再插调试器:

  1. 在 Project Settings (Alt+F7) 里取消勾选 Load Application to Target.
  2. 在 ICE Settings 里勾选 Download to Flash, 取消 Reset After Connect; ICE Clock 不要超过系统时钟的 1/2.
  3. 修改工程的 gdb. init: 程序没开看门狗, 可以把内容清空; 开了看门狗, 按泰芯手册保留指定的两条语句.

四, 烧录

方式 适合场景 要点
创芯蜂 HiveComm (推荐) 日常烧写 免安装, 烧录算法已内置, 能自动识别芯片, 烧完直接切到串口看日志; 下载 HiveComm, 步骤见 CKLink 驱动安装与固件烧录教程
CDK 下载 边改边调试 菜单 Flash → Download, 会保留非代码区的配置; 需要清掉配置时选 Chip Erase
串口升级 已带串口升级功能的固件 SDK 集成了串口升级 (命令 TX+OTA) , 具体用法可咨询泰芯 FAE
量产烧录 产线 见泰芯 TXW81x 量产和烧录指南

烧不进去, 看这篇: TXW 系列芯片固件烧录教程: 烧录器接线, 操作与失败排查.

五, 认识 SDK

目录结构

目录 内容 要不要改
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 服务端和客户端开关等.

  • 参数默认保存在 Flash 最后 2 个 sector, 两个参数区交替写入, 更不容易因掉电丢失.
  • 读写参数用 syscfg_read / syscfg_write; 全局变量 sys_cfgs 可以在其他模块直接访问.
  • 参数结构体开头的 magic, crc, size 是核心字段, 不要修改, 也不要占用.

Flash 与内存布局

  • Flash: 双固件区 (地址 0 和 512KB / 1MB 处) 加双参数区.
  • SRAM 共 288KB: 依次是深睡眠参数区, 代码段与数据段, heap, Wi-Fi 接收缓冲, Wi-Fi 发送缓冲. 收发缓冲的大小可以按实际数据量在 sys_config. h 里调整, 比如发得多, 收得少, 就加大发送缓冲.
  • 默认系统时钟 180MHz, 需要修改时重写 system_clock_init () .

六, 写代码的几条规矩

  • 头文件只引用 SDK 提供的 (基础类型用 typesdef. h) , 不要直接引用编译器的头文件.
  • 访问外设走 HAL: 先用 dev_get (设备 ID) 拿到设备, 再调用 HAL API; 设备 ID 定义在 include/devid. h.
  • 和操作系统相关的走 OSAL: 任务, 互斥锁, 信号量, 消息队列, 软件定时器都有封装.
  • 软件定时器基于 1ms 的 OS tick, 所有定时器共用一个执行序列, 回调函数要尽量短.

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

开发中遇到问题, 欢迎在社区提问, 也可以先问 AI 助手.

0 条评论

AI
问答

发布
问题