networking/devlink/ice.rst

1 .. SPDX-License-Identifier: GPL-2.0
15 .. list-table:: devlink info versions implemented
18     * - Name
19       - Type
20       - Example
21       - Description
22     * - ``board.id``
23       - fixed
24       - K65390-000
25       - The Product Board Assembly (PBA) identifier of the board.
26     * - ``fw.mgmt``
27       - running
28       - 2.1.7
29       - 3-digit version number of the management firmware that controls the
31     * - ``fw.mgmt.api``
32       - running
33       - 1.5
34       - 2-digit version number of the API exported over the AdminQ by the
37     * - ``fw.mgmt.build``
38       - running
39       - 0x305d955f
40       - Unique identifier of the source for the management firmware.
41     * - ``fw.undi``
42       - running
43       - 1.2581.0
44       - Version of the Option ROM containing the UEFI driver. The version is
48         non-breaking changes and reset to 1 when the major version is
51     * - ``fw.psid.api``
52       - running
53       - 0.80
54       - Version defining the format of the flash contents.
55     * - ``fw.bundle_id``
56       - running
57       - 0x80002ec0
58       - Unique identifier of the firmware image file that was loaded onto
60     * - ``fw.app.name``
61       - running
62       - ICE OS Default Package
63       - The name of the DDP package that is active in the device. The DDP
66     * - ``fw.app``
67       - running
68       - 1.3.1.0
69       - The version of the DDP package that is active in the device. Note
72     * - ``fw.app.bundle_id``
73       - running
74       - 0xc0000001
75       - Unique identifier for the DDP package loaded in the device. Also
78     * - ``fw.netlist``
79       - running
80       - 1.1.2000-6.7.0
81       - The version of the netlist module. This module defines the device's
85     * - ``fw.netlist.build``
86       - running
87       - 0xee16ced7
88       - The first 4 bytes of the hash of the netlist module contents.
90 Flash Update
93 The ``ice`` driver implements support for flash update using the
94 ``devlink-flash`` interface. It supports updating the device flash using a
95 combined flash image that contains the ``fw.mgmt``, ``fw.undi``, and
98 .. list-table:: List of supported overwrite modes
101    * - Bits
102      - Behavior
103    * - ``DEVLINK_FLASH_OVERWRITE_SETTINGS``
104      - Do not preserve settings stored in the flash components being
108    * - ``DEVLINK_FLASH_OVERWRITE_SETTINGS`` and ``DEVLINK_FLASH_OVERWRITE_IDENTIFIERS``
109      - Do not preserve either settings or identifiers. Overwrite everything
110        in the flash with the contents from the provided image, without
127 .. list-table:: regions implemented
130     * - Name
131       - Description
132     * - ``nvm-flash``
133       - The contents of the entire flash chip, sometimes referred to as
134         the device's Non Volatile Memory.
135     * - ``device-caps``
136       - The contents of the device firmware's capabilities buffer. Useful to
144     $ devlink region new pci/0000:01:00.0/nvm-flash snapshot 1
145     $ devlink region dump pci/0000:01:00.0/nvm-flash snapshot 1
147     $ devlink region dump pci/0000:01:00.0/nvm-flash snapshot 1
153     $ devlink region read pci/0000:01:00.0/nvm-flash snapshot 1 address 0 length 16
156     $ devlink region delete pci/0000:01:00.0/nvm-flash snapshot 1
158     $ devlink region new pci/0000:01:00.0/device-caps snapshot 1
159     $ devlink region dump pci/0000:01:00.0/device-caps snapshot 1
195     $ devlink region delete pci/0000:01:00.0/device-caps snapshot 1