mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-09-21 20:22:13 +08:00
i40e: Align devlink info versions with ice driver and add docs
Align devlink info versions with ice driver so change 'fw.mgmt'
version to be 2-digit version [major.minor], add 'fw.mgmt.build'
that reports mgmt firmware build number and use '"fw.psid.api'
for NVM format version instead of incorrect '"fw.psid'.
Additionally add missing i40e devlink documentation.
Fixes: 5a423552e0
("i40e: Add handler for devlink .info_get")
Signed-off-by: Ivan Vecera <ivecera@redhat.com>
Reviewed-by: Jacob Keller <jacob.e.keller@intel.com>
Link: https://lore.kernel.org/r/20231018123558.552453-1-ivecera@redhat.com
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
This commit is contained in:
parent
4b316e0700
commit
f2cab25b0e
59
Documentation/networking/devlink/i40e.rst
Normal file
59
Documentation/networking/devlink/i40e.rst
Normal file
@ -0,0 +1,59 @@
|
|||||||
|
.. SPDX-License-Identifier: GPL-2.0
|
||||||
|
|
||||||
|
====================
|
||||||
|
i40e devlink support
|
||||||
|
====================
|
||||||
|
|
||||||
|
This document describes the devlink features implemented by the ``i40e``
|
||||||
|
device driver.
|
||||||
|
|
||||||
|
Info versions
|
||||||
|
=============
|
||||||
|
|
||||||
|
The ``i40e`` driver reports the following versions
|
||||||
|
|
||||||
|
.. list-table:: devlink info versions implemented
|
||||||
|
:widths: 5 5 5 90
|
||||||
|
|
||||||
|
* - Name
|
||||||
|
- Type
|
||||||
|
- Example
|
||||||
|
- Description
|
||||||
|
* - ``board.id``
|
||||||
|
- fixed
|
||||||
|
- K15190-000
|
||||||
|
- The Product Board Assembly (PBA) identifier of the board.
|
||||||
|
* - ``fw.mgmt``
|
||||||
|
- running
|
||||||
|
- 9.130
|
||||||
|
- 2-digit version number of the management firmware that controls the
|
||||||
|
PHY, link, etc.
|
||||||
|
* - ``fw.mgmt.api``
|
||||||
|
- running
|
||||||
|
- 1.15
|
||||||
|
- 2-digit version number of the API exported over the AdminQ by the
|
||||||
|
management firmware. Used by the driver to identify what commands
|
||||||
|
are supported.
|
||||||
|
* - ``fw.mgmt.build``
|
||||||
|
- running
|
||||||
|
- 73618
|
||||||
|
- Build number of the source for the management firmware.
|
||||||
|
* - ``fw.undi``
|
||||||
|
- running
|
||||||
|
- 1.3429.0
|
||||||
|
- Version of the Option ROM containing the UEFI driver. The version is
|
||||||
|
reported in ``major.minor.patch`` format. The major version is
|
||||||
|
incremented whenever a major breaking change occurs, or when the
|
||||||
|
minor version would overflow. The minor version is incremented for
|
||||||
|
non-breaking changes and reset to 1 when the major version is
|
||||||
|
incremented. The patch version is normally 0 but is incremented when
|
||||||
|
a fix is delivered as a patch against an older base Option ROM.
|
||||||
|
* - ``fw.psid.api``
|
||||||
|
- running
|
||||||
|
- 9.30
|
||||||
|
- Version defining the format of the flash contents.
|
||||||
|
* - ``fw.bundle_id``
|
||||||
|
- running
|
||||||
|
- 0x8000e5f3
|
||||||
|
- Unique identifier of the firmware image file that was loaded onto
|
||||||
|
the device. Also referred to as the EETRACK identifier of the NVM.
|
@ -80,6 +80,7 @@ parameters, info versions, and other features it supports.
|
|||||||
bnxt
|
bnxt
|
||||||
etas_es58x
|
etas_es58x
|
||||||
hns3
|
hns3
|
||||||
|
i40e
|
||||||
ionic
|
ionic
|
||||||
ice
|
ice
|
||||||
mlx4
|
mlx4
|
||||||
|
@ -18,8 +18,14 @@ static void i40e_info_fw_mgmt(struct i40e_hw *hw, char *buf, size_t len)
|
|||||||
{
|
{
|
||||||
struct i40e_adminq_info *aq = &hw->aq;
|
struct i40e_adminq_info *aq = &hw->aq;
|
||||||
|
|
||||||
snprintf(buf, len, "%u.%u.%05d",
|
snprintf(buf, len, "%u.%u", aq->fw_maj_ver, aq->fw_min_ver);
|
||||||
aq->fw_maj_ver, aq->fw_min_ver, aq->fw_build);
|
}
|
||||||
|
|
||||||
|
static void i40e_info_fw_mgmt_build(struct i40e_hw *hw, char *buf, size_t len)
|
||||||
|
{
|
||||||
|
struct i40e_adminq_info *aq = &hw->aq;
|
||||||
|
|
||||||
|
snprintf(buf, len, "%05d", aq->fw_build);
|
||||||
}
|
}
|
||||||
|
|
||||||
static void i40e_info_fw_api(struct i40e_hw *hw, char *buf, size_t len)
|
static void i40e_info_fw_api(struct i40e_hw *hw, char *buf, size_t len)
|
||||||
@ -77,6 +83,12 @@ static int i40e_devlink_info_get(struct devlink *dl,
|
|||||||
if (err)
|
if (err)
|
||||||
return err;
|
return err;
|
||||||
|
|
||||||
|
i40e_info_fw_mgmt_build(hw, buf, sizeof(buf));
|
||||||
|
err = i40e_devlink_info_put(req, I40E_DL_VERSION_RUNNING,
|
||||||
|
"fw.mgmt.build", buf);
|
||||||
|
if (err)
|
||||||
|
return err;
|
||||||
|
|
||||||
i40e_info_fw_api(hw, buf, sizeof(buf));
|
i40e_info_fw_api(hw, buf, sizeof(buf));
|
||||||
err = i40e_devlink_info_put(req, I40E_DL_VERSION_RUNNING,
|
err = i40e_devlink_info_put(req, I40E_DL_VERSION_RUNNING,
|
||||||
DEVLINK_INFO_VERSION_GENERIC_FW_MGMT_API,
|
DEVLINK_INFO_VERSION_GENERIC_FW_MGMT_API,
|
||||||
@ -86,7 +98,7 @@ static int i40e_devlink_info_get(struct devlink *dl,
|
|||||||
|
|
||||||
i40e_info_nvm_ver(hw, buf, sizeof(buf));
|
i40e_info_nvm_ver(hw, buf, sizeof(buf));
|
||||||
err = i40e_devlink_info_put(req, I40E_DL_VERSION_RUNNING,
|
err = i40e_devlink_info_put(req, I40E_DL_VERSION_RUNNING,
|
||||||
DEVLINK_INFO_VERSION_GENERIC_FW_PSID, buf);
|
"fw.psid.api", buf);
|
||||||
if (err)
|
if (err)
|
||||||
return err;
|
return err;
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user