mirror of
https://github.com/torvalds/linux.git
synced 2024-12-21 10:31:54 +00:00
f45a645fa6
The flash memory for the ice hardware contains a block of information
used for link management called the Netlist module.
As this essentially represents another section of firmware, add its
version information to the output of the driver's .info_get handler.
This includes both a version and the first few bytes of a hash of the
module contents.
fw.netlist -> the version information extracted from the netlist module
fw.netlist.build-> first 4 bytes of the hash of the contents, similar
to fw.mgmt.build
Signed-off-by: Jacob Keller <jacob.e.keller@intel.com>
Tested-by: Andrew Bowers <andrewx.bowers@intel.com>
Signed-off-by: Jeff Kirsher <jeffrey.t.kirsher@intel.com>
108 lines
3.7 KiB
ReStructuredText
108 lines
3.7 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.
|
|
* - ``fw.netlist``
|
|
- running
|
|
- 1.1.2000-6.7.0
|
|
- The version of the netlist module. This module defines the device's
|
|
Ethernet capabilities and default settings, and is used by the
|
|
management firmware as part of managing link and device
|
|
connectivity.
|
|
* - ``fw.netlist.build``
|
|
- running
|
|
- 0xee16ced7
|
|
- The first 4 bytes of the hash of the netlist module contents.
|
|
|
|
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
|