ixgbe devlink 支援

本文件描述了由ixgbe裝置驅動程式實現的 devlink 功能。

資訊版本

任何涉及由devlink-info提供安全性的版本都純粹是資訊性的。Devlink 不使用安全通道與裝置通訊。

該ixgbe驅動程式報告以下版本

已實現的 devlink 資訊版本

名稱	型別	示例	描述
board.id	固定	H49289-000	主機板的產品板元件 (PBA) 識別符號。
fw.undi	正在執行	1.1937.0	包含 UEFI 驅動程式的 Option ROM 版本。版本以major.minor.patch格式報告。主版本在發生重大突破性更改或次版本溢位時遞增。次版本針對非突破性更改遞增，並在主版本遞增時重置為 1。補丁版本通常為 0，但在作為針對舊版基礎 Option ROM 的補丁交付修復時遞增。
fw.undi.srev	正在執行	4	指示 Option ROM 安全修訂號的數字。
fw.bundle_id	正在執行	0x80000d0d	載入到裝置上的韌體影像檔案的唯一識別符號。也稱為 NVM 的 EETRACK 識別符號。
fw.mgmt.api	正在執行	1.5.1	管理韌體透過 AdminQ 匯出的 API 的三位數版本號 (major.minor.patch)。驅動程式使用它來識別支援哪些命令。核心的歷史版本僅顯示兩位版本號 (major.minor)。
fw.mgmt.build	正在執行	0x305d955f	管理韌體源的唯一識別符號。
fw.mgmt.srev	正在執行	3	指示韌體安全修訂號的數字。
fw.psid.api	正在執行	0.80	定義快閃記憶體內容格式的版本。
fw.netlist	正在執行	1.1.2000-6.7.0	netlist 模組的版本。此模組定義了裝置的乙太網功能和預設設定，並由管理韌體用於管理鏈路和裝置連線。
fw.netlist.build	正在執行	0xee16ced7	netlist 模組內容的雜湊值的前 4 個位元組。

快閃記憶體更新

該ixgbe驅動程式實現了使用devlink-flash介面進行快閃記憶體更新的支援。它支援使用包含fw.mgmt`、fw.undi`和fw.netlist元件的組合快閃記憶體映像來更新裝置快閃記憶體。

支援的覆蓋模式列表

位	行為
DEVLINK_FLASH_OVERWRITE_SETTINGS	不要保留正在更新的快閃記憶體元件中儲存的設定。這包括覆蓋決定裝置將使用多少物理功能進行初始化的埠配置。
DEVLINK_FLASH_OVERWRITE_SETTINGS and DEVLINK_FLASH_OVERWRITE_IDENTIFIERS	不要保留設定或識別符號。用所提供影像的內容覆蓋快閃記憶體中的所有內容，不進行任何保留。這包括覆蓋裝置識別字段，例如 MAC 地址、重要產品資料 (VPD) 區域和裝置序列號。預計此組合將與為特定裝置定製的影像一起使用。

重新載入

該ixgbe驅動程式支援在快閃記憶體更新後，使用DEVLINK_CMD_RELOAD命令和DEVLINK_RELOAD_ACTION_FW_ACTIVATE操作來啟用新韌體。

$ devlink dev reload pci/0000:01:00.0 reload action fw_activate

透過發出裝置特定的嵌入式管理處理器復位來啟用新韌體，該復位請求裝置復位並重新載入 EMP 韌體映像。

該驅動程式目前不支援透過DEVLINK_RELOAD_ACTION_DRIVER_REINIT重新載入驅動程式。

區域

該ixgbe驅動程式實現了以下區域以訪問內部裝置資料。

已實現的區域

名稱	描述
nvm-flash	整個快閃記憶體晶片的內容，有時也稱為裝置的非易失性儲存器。
shadow-ram	影子 RAM 的內容，它從快閃記憶體的開頭載入。儘管內容主要來自快閃記憶體，但此區域還包含裝置啟動期間生成但未儲存在快閃記憶體中的資料。
device-caps	裝置韌體能力緩衝區的內容。有助於確定裝置的當前狀態和配置。

同時，nvm-flash和shadow-ram區域無需快照即可訪問。device-caps區域需要快照，因為內容由韌體傳送，不能拆分成單獨的讀取。

使用者可以透過DEVLINK_CMD_REGION_NEW命令請求立即捕獲所有三個區域的快照。

$ devlink region show
pci/0000:01:00.0/nvm-flash: size 10485760 snapshot [] max 1
pci/0000:01:00.0/device-caps: size 4096 snapshot [] max 10

$ devlink region new pci/0000:01:00.0/nvm-flash snapshot 1

$ devlink region dump pci/0000:01:00.0/nvm-flash snapshot 1
0000000000000000 0014 95dc 0014 9514 0035 1670 0034 db30
0000000000000010 0000 0000 ffff ff04 0029 8c00 0028 8cc8
0000000000000020 0016 0bb8 0016 1720 0000 0000 c00f 3ffc
0000000000000030 bada cce5 bada cce5 bada cce5 bada cce5

$ devlink region read pci/0000:01:00.0/nvm-flash snapshot 1 address 0 length 16
0000000000000000 0014 95dc 0014 9514 0035 1670 0034 db30

$ devlink region delete pci/0000:01:00.0/device-caps snapshot 1