TXW81x 开发常见问题汇总: Flash, 编译环境, 烧录, USB 与外设

发布于 2026-11-08 21: 58: 43

这篇把 TXW81x 开发中反复被问到的问题集中整理成问答, 适合遇到具体问题时按标题查找. 每个问题先说原因, 再给处理步骤; 涉及较多背景的内容, 会链接到站内的专题教程.

技术细节以泰芯官方 泰芯芯片 FLASH 各种常见问题 FAQ , TXW81x USB 开发指南 等文档为准.

一, Flash

Q: 同一份固件, 换了一颗外挂 Flash 就启动不了?

多数是 Flash 四线 (Quad) 模式没有正确使能. 固件编译后会自动加一段头信息, 芯片上电时按头信息里的指令序列初始化 Flash, 而这串指令在 makecode. ini 里配置. 不同厂家的 Flash 开启四线模式的指令不完全一样, 换了型号就可能起不来.

调试阶段, 在 makecode. ini 里依次尝试下面三种典型配置, 通常其中一种就能让 Flash 四线启动:

;  配置 1
WireMode4En=1
SpecSquenceEn=1
SpecSquenceNumbers=6
SpecSquence0=50000000    ;  write enable
SpecSquence1=0100020002  ;  quad mode enable
SpecSquence2=05800101    ;  wait busy
SpecSquence3=50000000    ;  write enable
SpecSquence4=31000102    ;  quad mode enable
SpecSquence5=05800101    ;  wait busy

;  配置 2:  与配置 1 相同,  只是两条 write enable 改为 06000000

;  配置 3
WireMode4En=1
SpecSquenceEn=1
SpecSquenceNumbers=3
SpecSquence0=06000000    ;  write enable
SpecSquence1=01000140    ;  quad mode enable
SpecSquence3=05800101    ;  wait busy

每条指令的格式是 "指令码 + dummy + 数据长度 + 数据" . 配置 3 的最后一条, 官方原文写的序号是 SpecSquence3 (与 SpecSquenceNumbers=3 不连续) , 使用时请以 SDK 实际效果为准.

量产时更推荐另一种做法: 如果要一份固件兼容多种 Flash, 改 makecode. ini 就不够用了. 官方建议用通用烧录器在 Flash 贴片前先烧好固件并打开 QE 位, 同时固件里关闭特殊指令序列: WireMode4En=1, SpecSquenceEn=0, SpecSquenceNumbers=0.

Q: 擦写 Flash 时, 其他任务或中断响应变慢, 甚至出问题?

程序本身跑在 Flash 上, 擦写期间读 Flash 会读到错误数据, 所以擦写时不能执行代码, 还要关中断, 可能出现几十到几百毫秒的关中断时间.

SDK 为此默认启用了擦写动态挂起: 擦写进行一段时间后自动挂起, 让系统先处理紧急事务, 再恢复擦写. 相关时序参数如下, 取值依据是 Flash 规格书 AC Characteristics 一节, 大多数情况下不需要改:

参数 含义 SDK 默认
tsr 擦除开始到挂起的最长时间 (ms) 8
trs 挂起到恢复的必要间隔 (ms) 4
tsus 挂起指令后 CS 需保持拉高的时间 (us) 20
trus 恢复指令后 CS 需保持拉高的时间 (us) 20

如果所用 Flash 不支持 suspend/resume, 官方给出的处理是在 device. c 中把 spi7. wip. tsr 设为 60000.

Q: 怎么读写 Flash 的安全区 (OTP 区) ?

部分 Flash 带一块额外的安全区, 读写方式和普通区域不同. 先查 Flash 规格书: 首页特性里会说明是否支持; 搜索安全区擦除指令 44H, 指令说明里会给出安全区的地址. 例如官方举的一款 Flash 有 3 个安全区, 地址分别为 0x001000, 0x002000, 0x003000, 每个 1KB.

地址必须写对才能正常读写, 示例代码见 SDK 的 app/flash/flash_read_demo. c 中的 flash_security_demo () .

Q: FAQ 里提到的 DDR, XIP, 动态写保护, TXW81x 需要配置吗?

不需要. 这三项是 TXW82x 的功能, 官方明确说明 TXW81x 不用考虑.

Q: OTA 升级失败会不会变砖?

TXW81x 支持 Flash 内两份代码共存: 启动时优先加载较新的一份, 如果它损坏或跑死, 会自动回滚到旧的那份运行, 避免出现无法开机, 无法再次升级的情况. 前提是 Flash 空间足够放两份代码.

二, 编译环境

Q: 能在 Linux 下编译整个 SDK 吗?

不能. 泰芯 SDK 需要用平头哥的 CDK IDE 编译. Linux 只适合编译第三方库: 把库代码编成 . a 静态库, 再加到 CDK 工程里统一链接. CDK 的安装与工程编译见 TXW81x SDK 快速入门 .

Q: 在 Linux 下编库, 工具链选哪个?

TXW80x/81x/82x 系列选 csky-elfabiv2-tools-i386-minilibc, 从玄铁官网下载, 解压到 Linux 后设置好环境变量.

Q: 库的 Makefile 里编译参数怎么填?

编译参数和芯片相关, 不同芯片不一样, 不要照抄别的芯片的参数. 最稳妥的办法:

  1. 在 CDK 里打开 TXW81x SDK 工程, 完整编译一次;
  2. 从 CDK 输出窗口里复制编译参数 (-mcpu=. . . , -D. . . 宏定义, 优化选项等) ;
  3. 填进库代码的 Makefile, 配合上面的工具链编译出 . a;
  4. 在 CDK 工程里添加这个 . a 库, 重新编译链接.
官方文档中的参数示例是 TXW82x 的 (如 -mcpu=e804df, -DTXW82X) , TXW81x 必须用自己工程输出的参数.

三, 烧录

烧录接线, HiveComm 操作, PA9/PA10 被占用导致烧不进等问题, 已经在 固件烧录教程: 烧录器接线, 操作与失败排查 和 CKLink 驱动安装与固件烧录教程 中详细讲过, 这里只补充几个容易混淆的点. CKLink 调试器可在创芯蜂淘宝店购买.

Q: TX-CLINK 和 TXLink-Lite 有什么区别, 该用哪个?

对比项 TX-CLINK TXLink-Lite
定位 开发调试, 支持 debug 量产烧录, 不支持 debug
TXW81x 接线 VREF-3. 3V, TMS-PA9, TCK-PA10, GND VREF-3. 3V, HDA-PA8, HCK-PA9, GND
板子供电 需要稳定的 3. 3V; 新款烧录器可用 VREF 给板子供电 (仅限烧录时) 板子不用上电, 只接 4 根线; 有外部供电要先断开
上位机 创芯蜂 HiveComm (下载) 泰芯官网下载的量产烧录上位机

开发阶段用 TX-CLINK; 固件已经把 PA9/PA10 复用掉, TX-CLINK 烧不进去时, 可以改用 TXLink-Lite 强制烧录.

Q: 新款 TX-CLINK 有两个 Type-C 口, 接哪个?

只接通讯口到电脑, 这个口既通讯也供电; 另一个供电口悬空不接.

Q: 烧录时报 Flash 相关的错误?

按顺序检查: Flash 型号是否在支持范围内, Flash 是否焊接良好, Flash 容量是否放得下固件.

四, USB

Q: TXW81x 的 USB 支持哪些模式?

USB 控制器支持 Device 和 Host 两种模式, USB 2. 0 High Speed. 但要注意具体料号: TXW813, TXW816 只支持 Device, TXW817 只有部分封装支持 Host, 选型时核对数据手册 (各型号差异见 TXW81x 型号怎么选 ) . 端点方面, 除了用于枚举的 EP0, 还有 EP1/EP2/EP3 的收发共 6 个端点.

Q: 怎么在工程里打开 USB?

在 project_config. h 中配置:

模式 需要使能的宏
USB Device USB_EN
USB Host USB_EN 和 USB_HOST_EN

代码中的使用步骤与其他外设一致:

  1. 在 device. c 中把 USB 设备加入系统设备链表;
  2. dev_get 获取设备句柄;
  3. usb_device_open 打开设备, 传入 struct usb_device_cfg;
  4. usb_device_ioctl 做配置;
  5. usb_device_request_irq 注册中断.

硬件抽象层接口见 usb_device. h, Host 和 Device 共用这一层.

Q: 怎么改 USB 设备的 VID/PID?

两种方式: 在 struct usb_device_cfg 的 vid, pid 字段中填写; 或用 usb_device_ioctl 的 USB_DEV_IO_CMD_SET_ID 命令设置.

用 ioctl 修改时, 必须在 usb_device_open 之后立即执行.

Q: 发送长度刚好是最大包长的整数倍, 主机端一直等不到传输结束?

USB 协议里, 数据长度和 MaxPacketSize 对齐时, 需要再补一个空包作为结束. 用 usb_device_ioctl 打开 USB_DEV_IO_CMD_AUTO_TX_NULL_PKT_ENABLE, 驱动会自动补发空包; 对应的关闭命令是 USB_DEV_IO_CMD_AUTO_TX_NULL_PKT_DISABLE.

Q: 要做自定义设备类, 需要自己处理枚举吗?

一般不需要. 简单的 Device 方案只要把 struct usb_device_cfg 配好 (设备描述符, 配置描述符, 接口数, 端点数和端点配置) , 枚举由后台自动完成.

如果配置结构体满足不了需求 (比如要处理特殊的类请求, 厂商请求) , V2. 5. 1 及以后的版本开放了枚举流程, 可以自己实现:

函数 作用
usb_device_ep0_setup_irq 处理 setup 阶段的描述符请求, 类请求, 厂商请求
usb_device_ep0_rx_irq 处理数据阶段已接收的数据, 末尾通常调用 hgusb20_dev_ep0_clrrx_pkt0 处理 status
usb_device_ep0_tx_irq 处理数据阶段已发送完成的数据
重写这些函数需要熟悉 USB 协议, 非必要不建议改.

Q: USB 能注册哪些中断?

中断 含义
USB_DEV_RESET_IRQ / USB_DEV_SUSPEND_IRQ / USB_DEV_RESUME_IRQ Device 收到总线 reset / suspend / resume
USB_DEV_SOF_IRQ Device 收到 SOF
USB_DEV_CTL_IRQ 端点 0 收发
USB_EP_RX_IRQ / USB_EP_TX_IRQ 端点收到数据 / 发送完成
USB_CONNECT / USB_DISCONNECT Host 检测到设备接入 / 断开
USB_BABBLE / USB_XACT_ERR Host 遇到 babble / xact error

五, 外设示例

Q: SDK 自带的外设示例怎么跑起来?

  1. 在 CDK 的 Project Settings 中定义 EXAMPLES 宏;
  2. 在 project_config. h 中再定义要运行的那个示例的宏;
  3. 示例源码在 project\examples\peripherals\ 外设名 下, 例如 example_uart. c, 文件开头的宏决定运行其中哪个用例.
每次只能运行一个外设示例, 示例内部也只能开一个用例, 同时打开多个会互相冲突.

SDK 提供的示例:

外设 示例内容
UART CPU 收发, DMA 收发, 超时中断, ioctl 改波特率
PWM 50% 占空比输出, 比较值中断, ioctl 改占空比
TIMER 单次计数, 周期计数, ioctl 改分频
I2C 主机发送, 发送完成中断, ioctl 改从机地址
GPIO 按键控制 LED, GPIO 中断
ADC 采样, 采样完成中断
SPI 读写 W25Q32FV, 收发完成中断
CAPTURE 双沿捕获, 上升沿捕获
SDHOST 读写 TF 卡并校验
PDM_AUDAC 数字麦克风采集后由 AUDIO_DAC 播放

Q: 外设引脚在哪里配置?

在 project_config. h 中用 PIN_ 开头的宏指定, 例如 UART0:

#define PIN_UART0_TX  PA_5
#define PIN_UART0_RX  PA_6

各外设可用的引脚宏名称定义在 sdk\include\chip\txw81x\pin_names. h, 改引脚前先在这里查名称.

Q: 串口波特率, 定时器分频能在运行时改吗?

可以, 都通过 ioctl:

  • 串口: uart_ioctl (p_uart, UART_IOCTL_CMD_SET_BAUDRATE, 921600, 0) ;
  • 定时器: timer_device_ioctl (p_timer, TIMER_SET_CLK_PSC, n, 0) ; , 分频系数为 2 的 n 次方, 共 8 档.

Q: SPI 什么时候走 DMA?

SPI 示例中, 读写数据超过 16 字节时自动使用 DMA, 不需要额外配置.

LCD 屏幕相关问题 (新屏适配, 花屏, 不显示等) 请看 TXW81x LCD 屏幕点亮教程 .

参考资料

相关阅读

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

0 条评论

AI
问答

发布
问题