1.. SPDX-License-Identifier: GPL-2.0 2 3==================== 4i40e devlink support 5==================== 6 7This document describes the devlink features implemented by the ``i40e`` 8device driver. 9 10Parameters 11========== 12 13.. list-table:: Generic parameters implemented 14 :widths: 5 5 90 15 16 * - Name 17 - Mode 18 - Notes 19 * - ``max_mac_per_vf`` 20 - runtime 21 - Controls the maximum number of MAC addresses a VF can use 22 on i40e devices. 23 24 By default (``0``), the driver enforces its internally calculated per-VF 25 MAC filter limit, which is based on the number of allocated VFS. 26 27 If set to a non-zero value, this parameter acts as a strict cap: 28 the driver will use the user-provided value instead of its internal 29 calculation. 30 31 **Important notes:** 32 33 - This value **must be set before enabling SR-IOV**. 34 Attempting to change it while SR-IOV is enabled will return an error. 35 - MAC filters are a **shared hardware resource** across all VFs. 36 Setting a high value may cause other VFs to be starved of filters. 37 - This value is a **Administrative policy**. The hardware may return 38 errors when its absolute limit is reached, regardless of the value 39 set here. 40 41 The default value is ``0`` (internal calculation is used). 42 43 44Info versions 45============= 46 47The ``i40e`` driver reports the following versions 48 49.. list-table:: devlink info versions implemented 50 :widths: 5 5 5 90 51 52 * - Name 53 - Type 54 - Example 55 - Description 56 * - ``board.id`` 57 - fixed 58 - K15190-000 59 - The Product Board Assembly (PBA) identifier of the board. 60 * - ``fw.mgmt`` 61 - running 62 - 9.130 63 - 2-digit version number of the management firmware that controls the 64 PHY, link, etc. 65 * - ``fw.mgmt.api`` 66 - running 67 - 1.15 68 - 2-digit version number of the API exported over the AdminQ by the 69 management firmware. Used by the driver to identify what commands 70 are supported. 71 * - ``fw.mgmt.build`` 72 - running 73 - 73618 74 - Build number of the source for the management firmware. 75 * - ``fw.undi`` 76 - running 77 - 1.3429.0 78 - Version of the Option ROM containing the UEFI driver. The version is 79 reported in ``major.minor.patch`` format. The major version is 80 incremented whenever a major breaking change occurs, or when the 81 minor version would overflow. The minor version is incremented for 82 non-breaking changes and reset to 1 when the major version is 83 incremented. The patch version is normally 0 but is incremented when 84 a fix is delivered as a patch against an older base Option ROM. 85 * - ``fw.psid.api`` 86 - running 87 - 9.30 88 - Version defining the format of the flash contents. 89 * - ``fw.bundle_id`` 90 - running 91 - 0x8000e5f3 92 - Unique identifier of the firmware image file that was loaded onto 93 the device. Also referred to as the EETRACK identifier of the NVM. 94