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
问答

发布
问题