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-CLINKTXLink-Lite
定位开发调试,支持 debug量产烧录,不支持 debug
TXW81x 接线VREF-3.3V、TMS-PA9、TCK-PA10、GNDVREF-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 DeviceUSB_EN
USB HostUSB_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_IRQDevice 收到总线 reset / suspend / resume
USB_DEV_SOF_IRQDevice 收到 SOF
USB_DEV_CTL_IRQ端点 0 收发
USB_EP_RX_IRQ / USB_EP_TX_IRQ端点收到数据 / 发送完成
USB_CONNECT / USB_DISCONNECTHost 检测到设备接入 / 断开
USB_BABBLE / USB_XACT_ERRHost 遇到 babble / xact error

五、外设示例

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

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

SDK 提供的示例:

外设示例内容
UARTCPU 收发、DMA 收发、超时中断、ioctl 改波特率
PWM50% 占空比输出、比较值中断、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
问答

发布
问题