mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-12-25 12:04:46 +08:00
709e7158f0
The documentation for the ice driver around "fw.app" has a spelling mistake in variation. Additionally, the language of "shall have a unique name" sounds like a requirement. Reword this to read more like a description or property. Reported-by: Benjamin Fisher <benjamin.l.fisher@intel.com> Signed-off-by: Jacob Keller <jacob.e.keller@intel.com> Acked-by: Jakub Kicinski <kubakici@wp.pl> Acked-by: Jeff Kirsher <jeffrey.t.kirsher@intel.com> Signed-off-by: David S. Miller <davem@davemloft.net>
97 lines
3.2 KiB
ReStructuredText
97 lines
3.2 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
===================
|
|
ice devlink support
|
|
===================
|
|
|
|
This document describes the devlink features implemented by the ``ice``
|
|
device driver.
|
|
|
|
Info versions
|
|
=============
|
|
|
|
The ``ice`` driver reports the following versions
|
|
|
|
.. list-table:: devlink info versions implemented
|
|
:widths: 5 5 5 90
|
|
|
|
* - Name
|
|
- Type
|
|
- Example
|
|
- Description
|
|
* - ``board.id``
|
|
- fixed
|
|
- K65390-000
|
|
- The Product Board Assembly (PBA) identifier of the board.
|
|
* - ``fw.mgmt``
|
|
- running
|
|
- 2.1.7
|
|
- 3-digit version number of the management firmware that controls the
|
|
PHY, link, etc.
|
|
* - ``fw.mgmt.api``
|
|
- running
|
|
- 1.5
|
|
- 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
|
|
- 0x305d955f
|
|
- Unique identifier of the source for the management firmware.
|
|
* - ``fw.undi``
|
|
- running
|
|
- 1.2581.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
|
|
- 0.80
|
|
- Version defining the format of the flash contents.
|
|
* - ``fw.bundle_id``
|
|
- running
|
|
- 0x80002ec0
|
|
- Unique identifier of the firmware image file that was loaded onto
|
|
the device. Also referred to as the EETRACK identifier of the NVM.
|
|
* - ``fw.app.name``
|
|
- running
|
|
- ICE OS Default Package
|
|
- The name of the DDP package that is active in the device. The DDP
|
|
package is loaded by the driver during initialization. Each
|
|
variation of the DDP package has a unique name.
|
|
* - ``fw.app``
|
|
- running
|
|
- 1.3.1.0
|
|
- The version of the DDP package that is active in the device. Note
|
|
that both the name (as reported by ``fw.app.name``) and version are
|
|
required to uniquely identify the package.
|
|
|
|
Regions
|
|
=======
|
|
|
|
The ``ice`` driver enables access to the contents of the Non Volatile Memory
|
|
flash chip via the ``nvm-flash`` region.
|
|
|
|
Users can request an immediate capture of a snapshot via the
|
|
``DEVLINK_CMD_REGION_NEW``
|
|
|
|
.. code:: shell
|
|
|
|
$ devlink region new pci/0000:01:00.0/nvm-flash snapshot 1
|
|
$ devlink region dump 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/nvm-flash snapshot 1
|