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