xref: /linux/Documentation/networking/devlink/sfc.rst (revision 1a9239bb4253f9076b5b4b2a1a4e8d7defd77a95) 
1.. SPDX-License-Identifier: GPL-2.0
2
3===================
4sfc devlink support
5===================
6
7This document describes the devlink features implemented by the ``sfc``
8device driver for the ef10 and ef100 devices.
9
10Info versions
11=============
12
13The ``sfc`` driver reports the following versions
14
15.. list-table:: devlink info versions implemented
16   :widths: 5 5 90
17
18   * - Name
19     - Type
20     - Description
21   * - ``fw.bundle_id``
22     - stored
23     - Version of the firmware "bundle" image that was last used to update
24       multiple components.
25   * - ``fw.mgmt.suc``
26     - running
27     - For boards where the management function is split between multiple
28       control units, this is the SUC control unit's firmware version.
29   * - ``fw.mgmt.cmc``
30     - running
31     - For boards where the management function is split between multiple
32       control units, this is the CMC control unit's firmware version.
33   * - ``fpga.rev``
34     - running
35     - FPGA design revision.
36   * - ``fpga.app``
37     - running
38     - Datapath programmable logic version.
39   * - ``fw.app``
40     - running
41     - Datapath software/microcode/firmware version.
42   * - ``coproc.boot``
43     - running
44     - SmartNIC application co-processor (APU) first stage boot loader version.
45   * - ``coproc.uboot``
46     - running
47     - SmartNIC application co-processor (APU) co-operating system loader version.
48   * - ``coproc.main``
49     - running
50     - SmartNIC application co-processor (APU) main operating system version.
51   * - ``coproc.recovery``
52     - running
53     - SmartNIC application co-processor (APU) recovery operating system version.
54   * - ``fw.exprom``
55     - running
56     - Expansion ROM version. For boards where the expansion ROM is split between
57       multiple images (e.g. PXE and UEFI), this is the specifically the PXE boot
58       ROM version.
59   * - ``fw.uefi``
60     - running
61     - UEFI driver version (No UNDI support).
62
63Flash Update
64============
65
66The ``sfc`` driver implements support for flash update using the
67``devlink-flash`` interface. It supports updating the device flash using a
68combined flash image ("bundle") that contains multiple components (on ef10,
69typically ``fw.mgmt``, ``fw.app``, ``fw.exprom`` and ``fw.uefi``).
70
71The driver does not support any overwrite mask flags.
72