这篇把 TXW81x 开发中反复被问到的问题集中整理成问答, 适合遇到具体问题时按标题查找. 每个问题先说原因, 再给处理步骤; 涉及较多背景的内容, 会链接到站内的专题教程.
技术细节以泰芯官方 "泰芯芯片 FLASH 各种常见问题 FAQ" , "TXW81x USB 开发指南" 等文档为准.
多数是 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.
程序本身跑在 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.
部分 Flash 带一块额外的安全区, 读写方式和普通区域不同. 先查 Flash 规格书: 首页特性里会说明是否支持; 搜索安全区擦除指令 44H, 指令说明里会给出安全区的地址. 例如官方举的一款 Flash 有 3 个安全区, 地址分别为 0x001000, 0x002000, 0x003000, 每个 1KB.
地址必须写对才能正常读写, 示例代码见 SDK 的 app/flash/flash_read_demo. c 中的 flash_security_demo () .
不需要. 这三项是 TXW82x 的功能, 官方明确说明 TXW81x 不用考虑.
TXW81x 支持 Flash 内两份代码共存: 启动时优先加载较新的一份, 如果它损坏或跑死, 会自动回滚到旧的那份运行, 避免出现无法开机, 无法再次升级的情况. 前提是 Flash 空间足够放两份代码.
不能. 泰芯 SDK 需要用平头哥的 CDK IDE 编译. Linux 只适合编译第三方库: 把库代码编成 . a 静态库, 再加到 CDK 工程里统一链接. CDK 的安装与工程编译见 "TXW81x SDK 快速入门" .
TXW80x/81x/82x 系列选 csky-elfabiv2-tools-i386-minilibc, 从玄铁官网下载, 解压到 Linux 后设置好环境变量.
编译参数和芯片相关, 不同芯片不一样, 不要照抄别的芯片的参数. 最稳妥的办法:
-mcpu=. . . , -D. . . 宏定义, 优化选项等) ; . a; . a 库, 重新编译链接. 官方文档中的参数示例是 TXW82x 的 (如-mcpu=e804df,-DTXW82X) , TXW81x 必须用自己工程输出的参数.
烧录接线, HiveComm 操作, PA9/PA10 被占用导致烧不进等问题, 已经在 "固件烧录教程: 烧录器接线, 操作与失败排查" 和 "CKLink 驱动安装与固件烧录教程" 中详细讲过, 这里只补充几个容易混淆的点. CKLink 调试器可在创芯蜂淘宝店购买.
| 对比项 | 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 强制烧录.
只接通讯口到电脑, 这个口既通讯也供电; 另一个供电口悬空不接.
按顺序检查: Flash 型号是否在支持范围内, Flash 是否焊接良好, Flash 容量是否放得下固件.
USB 控制器支持 Device 和 Host 两种模式, USB 2. 0 High Speed. 但要注意具体料号: TXW813, TXW816 只支持 Device, TXW817 只有部分封装支持 Host, 选型时核对数据手册 (各型号差异见 "TXW81x 型号怎么选" ) . 端点方面, 除了用于枚举的 EP0, 还有 EP1/EP2/EP3 的收发共 6 个端点.
在 project_config. h 中配置:
| 模式 | 需要使能的宏 |
|---|---|
| USB Device | USB_EN |
| USB Host |
USB_EN 和 USB_HOST_EN
|
代码中的使用步骤与其他外设一致:
device. c 中把 USB 设备加入系统设备链表; dev_get 获取设备句柄; usb_device_open 打开设备, 传入 struct usb_device_cfg; usb_device_ioctl 做配置; usb_device_request_irq 注册中断. 硬件抽象层接口见 usb_device. h, Host 和 Device 共用这一层.
两种方式: 在 struct usb_device_cfg 的 vid, pid 字段中填写; 或用 usb_device_ioctl 的 USB_DEV_IO_CMD_SET_ID 命令设置.
用 ioctl 修改时, 必须在 usb_device_open 之后立即执行.
USB 协议里, 数据长度和 MaxPacketSize 对齐时, 需要再补一个空包作为结束. 用 usb_device_ioctl 打开 USB_DEV_IO_CMD_AUTO_TX_NULL_PKT_ENABLE, 驱动会自动补发空包; 对应的关闭命令是 USB_DEV_IO_CMD_AUTO_TX_NULL_PKT_DISABLE.
一般不需要. 简单的 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 协议, 非必要不建议改.
| 中断 | 含义 |
|---|---|
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 |
EXAMPLES 宏; project_config. h 中再定义要运行的那个示例的宏; 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 播放 |
在 project_config. h 中用 PIN_ 开头的宏指定, 例如 UART0:
#define PIN_UART0_TX PA_5
#define PIN_UART0_RX PA_6
各外设可用的引脚宏名称定义在 sdk\include\chip\txw81x\pin_names. h, 改引脚前先在这里查名称.
可以, 都通过 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 档. SPI 示例中, 读写数据超过 16 字节时自动使用 DMA, 不需要额外配置.
LCD 屏幕相关问题 (新屏适配, 花屏, 不显示等) 请看 "TXW81x LCD 屏幕点亮教程" .