前言：在 RK3588 平臺開發(fā)過程中，你是否遇到過這樣的窘境：明明 PCIe 總線上掛好了網(wǎng)卡模塊，lspci 能識別到芯片，可驅動就是加載失敗，排查半天找不到關鍵問題？別慌！本文將帶你一步步解決這個棘手問題。

一、案例背景

使用眺望電子 RK3588核心板的PCIE20_0/1/2接口掛載裕太微yt6801芯片擴展網(wǎng)卡為例，看看問題到底有多棘手。

通過lspci命令查看設備狀態(tài)時，能清晰看到 yt6801 芯片的存在，三個網(wǎng)卡設備均顯示為 “Ethernet controller: Device 1f0a:6801 (rev 01)”，從表面看似乎一切正常。

可當執(zhí)行insmod yt6801.ko加載驅動時，報錯信息卻接連彈出驅動加載直接失敗，網(wǎng)卡根本無法使用。

明明硬件連接沒問題，設備也能被識別，為什么驅動就是 “不聽話”？這背后肯定藏著我們沒注意到的關鍵細節(jié)。

二、根源分析

問題不能看表面，深入日志查原因

查看系統(tǒng)日志時發(fā)現(xiàn)，出問題的 PCIe 設備與正常設備的 class 類型截然不同。正常工作的兩個 PCIe 設備（000200.0 和 000100.0），class 類型均為 0x060400；而加載驅動失敗的 PCIe 設備（000400.0），class 類型卻顯示為 0x000000。

在SDK/kernel/include/linux/pci_ids.h文件中定義了不同class類別。其中0x000000為PCI_CLASS_NOT_DEFINED，即為未定義；而0x060400為PCI_CLASS_BRIDGE_PCI，即為PCIe橋。只有正確識別設備類型，內(nèi)核才能進行后續(xù)的資源分配和驅動加載。

由于該 PCIe 設備的 class 類型非法（未定義），系統(tǒng)無法正確識別其功能屬性，導致 Memory BAR 資源分配異常（lspci 中 BAR 資源會顯示 unassigned 狀態(tài)），最終造成網(wǎng)卡驅動加載失敗。

找到根源后，解決問題就有了明確方向。

三、解決方案

想要解決這個問題，最根本的方式是聯(lián)系模塊供應商，讓其對模塊的 class 類型進行正確配置。但如果遇到無法修改硬件配置，或需要臨時應急的情況，可以參考下文嘗試對模塊的class類型進行軟件修復，具體只需如下3步：

3.1定位修改文件

打開RK3588的SDK，找到內(nèi)核中的kernel/drivers/pci/quirks.c文件。該文件主要用于處理 PCI 設備的特殊配置和兼容性問題，是我們進行軟件修復的關鍵位置。

3.2添加修復代碼

在quirks.c文件中，新增以下兩段代碼：

1.定義 class 類型修復函數(shù)

staticvoidquirk_class_id_fixup(struct pci_dev *dev){ dev->class=0x060400;// 將class類型設置為標準PCIe橋類型}

2.注冊修復邏輯

DECLARE_PCI_FIXUP_CLASS_EARLY(0x1d87,0x3588, PCI_CLASS_NOT_DEFINED,8, quirk_class_id_fixup);

這里需要注意：0x1d87是 RK3588 的 Vendor ID（廠商 ID），0x3588是對應的 Device ID（設備 ID），PCI_CLASS_NOT_DEFINED指定針對未定義 class 類型的設備進行修復，0x060400則是我們要修復到的正確 class 類型。

3.3加修復代碼

代碼添加完成后，重新編譯內(nèi)核鏡像，將編譯好的鏡像燒錄到 RK3588 核心板中，通過命令驗證修復效果：

1、執(zhí)行l(wèi)spci命令，已正確顯示為 “PCI bridge: Fuzhou Rockchip Electronics Co., Ltd Device 3588 (rev 01)”，class 類型修復成功。

2、執(zhí)行insmod yt6801.ko加載驅動，此時不再出現(xiàn)報錯信息，驅動加載成功。

3、執(zhí)行ifconfig命令，能看到新增的網(wǎng)卡接口（如 enP4p65s0），且接口狀態(tài)正常，支持 UP、BROADCAST、MULTICAST 等模式，說明網(wǎng)卡已能正常工作。

至此，RK3588 PCIe 非法class類型導致的網(wǎng)卡驅動無法加載問題，已完全解決。

四、小結

本文提供的解決方案基于特定硬件平臺驗證，實際應用中需根據(jù)具體設備調(diào)整VID/PID及class類型參數(shù)。如果你在 RK3588 平臺或者我司核心板開發(fā)中還遇到過其他 PCIe 相關難題，請關注眺望電子公眾號或在評論區(qū)留言分享，我們一起交流探討！