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

發布
問題