這篇把 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 屏幕點亮教程》。