| 1 | |
| 2 |
|
| 3 | ====================
|
| 4 | i40e devlink support
|
| 5 | ====================
|
| 6 |
|
| 7 | This document describes the devlink features implemented by the ``i40e``
|
| 8 | device driver.
|
| 9 |
|
| 10 | Parameters
|
| 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 |
|
| 44 | Info versions
|
| 45 | =============
|
| 46 |
|
| 47 | The ``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.
|