在嵌入式開發(fā)領(lǐng)域，瑞芯微RK3588憑借超強的算力、豐富的接口和廣泛的場景適配性，成為高端邊緣計算、消費電子項目的熱門選擇。而U-Boot作為嵌入式系統(tǒng)的“第一道門”，負責(zé)硬件初始化、引導(dǎo)內(nèi)核啟動，其板級適配代碼直接決定了芯片硬件能力的落地。

今天我們聚焦RK3588評估板（EVB）的核心板級文件——u-boot/board/rockchip/evb_rk3588/evb_rk3588.c，拆解這份代碼的底層邏輯，搞懂RK3588的USB功能是如何在U-Boot中被初始化和管理的。

一、文件定位：RK3588 USB功能的“板級適配基石”

evb_rk3588.c是Rockchip為RK3588評估板定制的U-Boot板級適配文件，核心職責(zé)是為RK3588的USB DWC3控制器提供板級初始化和管理邏輯，是評估板USB功能能正常工作的核心保障。

具體來說，這份文件的核心價值體現(xiàn)在3點：

1.適配瑞芯微RK3588的USB OTG控制器（基于DWC3架構(gòu)），實現(xiàn)硬件復(fù)位、參數(shù)配置等底層操作；

2.支撐USB Gadget（設(shè)備模式）功能，是瑞芯微Rockusb協(xié)議（刷機/調(diào)試專用）的底層依賴；

3.處理USB 3.0/2.0模式的兼容邏輯，包括PHY初始化失敗時的降級策略（USB3.0→USB2.0），保證基礎(chǔ)功能不丟失。

簡單講：沒有這份文件，RK3588評估板的USB刷機、USB調(diào)試等核心功能，在U-Boot階段就無法正常工作。

二、逐行拆解：核心宏定義與函數(shù)功能

這份文件的代碼圍繞“USB控制器適配”展開，我們從宏定義、全局配置、核心函數(shù)三個維度，逐一解析其功能。

1.硬件相關(guān)宏定義：操作時鐘與復(fù)位的“地址鑰匙”

#defineCRU_BASE0xfd7c0000#defineCRU_SOFTRST_CON420x0aa8

RK3588的硬件操作依賴時鐘復(fù)位單元（CRU），這兩個宏是操作USB OTG控制器復(fù)位的關(guān)鍵：

?CRU_BASE：CRU模塊的基地址，所有時鐘、復(fù)位寄存器都基于此地址訪問；

?CRU_SOFTRST_CON42：USB OTG控制器的軟復(fù)位寄存器偏移量，寫入特定值可觸發(fā)/釋放復(fù)位。

這是嵌入式開發(fā)的典型設(shè)計：通過物理地址直接操作硬件寄存器，實現(xiàn)對底層硬件的控制。

2.全局配置結(jié)構(gòu)體：DWC3控制器的“參數(shù)清單”

staticstructdwc3_device dwc3_device_data = {.maximum_speed = USB_SPEED_SUPER,.base=0xfc000000,.dr_mode = USB_DR_MODE_PERIPHERAL,.index =0,.dis_u2_susphy_quirk =1,.dis_u1u2_quirk =1,.usb2_phyif_utmi_width =16,};

這是給DWC3 USB控制器的“初始化參數(shù)”，每一項都針對RK3588的硬件特性定制：

?maximum_speed：默認開啟USB 3.0超高速（SUPER）；

?dr_mode：強制工作在設(shè)備模式（而非主機模式），因為U-Boot階段USB主要用于刷機/調(diào)試；

?dis_u2_susphy_quirk/dis_u1u2_quirk：關(guān)閉USB2.0 PHY休眠、U1/U2節(jié)能模式，避免初始化失敗或穩(wěn)定性問題；

?usb2_phyif_utmi_width：配置USB2.0 PHY接口寬度為16位，匹配RK3588的硬件設(shè)計。

3.核心函數(shù)解析：USB功能的“核心操作邏輯”

（1）usb_gadget_handle_interrupts：USB中斷的“響應(yīng)入口”

intusb_gadget_handle_interrupts(intindex){dwc3_uboot_handle_interrupt(0);return0;}

功能：處理USB Gadget模式下的中斷請求。

U-Boot運行時，USB設(shè)備模式會產(chǎn)生各類中斷（比如數(shù)據(jù)傳輸完成、設(shè)備枚舉），該函數(shù)是中斷處理的“入口”——內(nèi)部調(diào)用U-Boot通用DWC3驅(qū)動的中斷處理函數(shù)，確保中斷被及時響應(yīng)，保證USB數(shù)據(jù)傳輸不中斷。

（2）rkusb_usb3_capable：USB3.0能力的“判斷開關(guān)”

boolrkusb_usb3_capable(void){returntrue;}

功能：告知上層邏輯（如Rockusb協(xié)議），當(dāng)前板子支持USB 3.0。

Rockusb是瑞芯微定制的USB協(xié)議（用于刷機、燒錄固件），該函數(shù)直接返回true，表示RK3588評估板硬件支持USB 3.0，上層可啟用高速傳輸模式，提升刷機/調(diào)試效率。

（3）usb_reset_otg_controller：USB控制器的“復(fù)位操作”

staticvoidusb_reset_otg_controller(void){writel(0x00100010,CRU_BASE+CRU_SOFTRST_CON42);mdelay(1);writel(0x00100000,CRU_BASE+CRU_SOFTRST_CON42);mdelay(1);}

功能：對USB OTG控制器執(zhí)行軟復(fù)位，清除硬件異常狀態(tài)。

硬件初始化前，復(fù)位是必備步驟：

1.向復(fù)位寄存器寫入0x00100010，觸發(fā)OTG控制器復(fù)位；

2.延時1ms，確保復(fù)位動作完成；

3.寫入0x00100000釋放復(fù)位；

4.再延時1ms，保證控制器穩(wěn)定運行。

這一步能解決控制器殘留的異常狀態(tài)，為后續(xù)初始化鋪路，是嵌入式硬件初始化的“常規(guī)操作”。

（4）board_usb_init：USB初始化的“核心入口”

intboard_usb_init(intindex,enumusb_init_typeinit){u32 ret =0;usb_reset_otg_controller();// 先復(fù)位控制器#ifdefined(CONFIG_SUPPORT_USBPLUG)// 啟用USB插拔檢測時，默認降級為USB2.0dwc3_device_data.maximum_speed = USB_SPEED_HIGH;if(rkusb_switch_usb3_enabled()) {// 若開啟USB3.0，嘗試初始化USB3.0 PHYdwc3_device_data.maximum_speed = USB_SPEED_SUPER;ret = rockchip_u3phy_uboot_init();if(ret) {// PHY初始化失敗，強制USB2.0rkusb_force_to_usb2(true);dwc3_device_data.maximum_speed = USB_SPEED_HIGH;}}#else// 未啟用插拔檢測，直接初始化USB3.0 PHYret = rockchip_u3phy_uboot_init();if(ret) {// 失敗則降級為USB2.0rkusb_force_to_usb2(true);dwc3_device_data.maximum_speed = USB_SPEED_HIGH;}#endif// 調(diào)用通用驅(qū)動完成DWC3控制器初始化returndwc3_uboot_init(&dwc3_device_data);}

功能：U-Boot板級USB初始化的核心函數(shù)，是USB控制器能工作的“總開關(guān)”。

執(zhí)行流程拆解：

1.先復(fù)位控制器，清理初始狀態(tài)；

2.若開啟CONFIG_SUPPORT_USBPLUG（USB插拔檢測）：

?先默認設(shè)置為USB2.0高速模式，再檢查是否啟用USB3.0；

?嘗試初始化USB3.0 PHY，失敗則強制降級為USB2.0；

3.若未開啟插拔檢測：直接初始化USB3.0 PHY，失敗則降級；

4.最后調(diào)用U-Boot通用DWC3驅(qū)動的初始化函數(shù)，完成控制器配置。

這個函數(shù)的設(shè)計體現(xiàn)了嵌入式開發(fā)的“容錯思想”：優(yōu)先嘗試高性能模式（USB3.0），失敗則降級到基礎(chǔ)模式（USB2.0），保證核心功能不丟失。

（5）board_usb_cleanup（條件編譯）：USB資源的“清理入口”

#ifdefined(CONFIG_SUPPORT_USBPLUG)intboard_usb_cleanup(intindex,enumusb_init_typeinit){dwc3_uboot_exit(index);return0;}#endif

功能：僅在啟用USB插拔檢測時生效，負責(zé)清理USB控制器資源。

當(dāng)USB設(shè)備插拔時，需要釋放舊的控制器資源，該函數(shù)調(diào)用通用驅(qū)動的退出函數(shù)，保證多次插拔時USB功能的穩(wěn)定性。

三、USB功能異常排查流程圖：快速定位問題

U-Boot階段USB功能異常（刷機失敗、調(diào)試無響應(yīng)）的排查流程圖，直接對照即可快速縮小故障范圍，適配evb_rk3588.c的核心邏輯：

四、總結(jié)：嵌入式板級適配的“核心思路”

evb_rk3588.c雖代碼量不大，但濃縮了嵌入式板級適配的核心思想：

1.分層設(shè)計：硬件無關(guān)的邏輯交給U-Boot通用驅(qū)動（如DWC3驅(qū)動），硬件相關(guān)的細節(jié)（復(fù)位、PHY配置）交給板級文件；

2.容錯設(shè)計：關(guān)鍵功能（如USB3.0）做降級兼容，保證基礎(chǔ)功能可用；

3.硬件直操：通過物理地址操作寄存器，實現(xiàn)對底層硬件的精準控制。

對于RK3588開發(fā)者來說，理解這份代碼不僅能解決USB初始化失敗、刷機異常等問題，更能掌握板級適配的核心邏輯——把通用驅(qū)動和具體硬件結(jié)合，讓芯片的能力真正落地。

最后，留一個互動問題：你在做RK3588開發(fā)時，遇到過USB初始化失敗的問題嗎？評論區(qū)聊聊你的排坑經(jīng)驗～