xref: /linux/Documentation/networking/devlink/zl3073x.rst (revision 8a5f956a9fb7d74fff681145082acfad5afa6bb8)
1.. SPDX-License-Identifier: GPL-2.0
2
3=======================
4zl3073x devlink support
5=======================
6
7This document describes the devlink features implemented by the ``zl3073x``
8device driver.
9
10Parameters
11==========
12
13.. list-table:: Generic parameters implemented
14   :widths: 5 5 90
15
16   * - Name
17     - Mode
18     - Notes
19   * - ``clock_id``
20     - driverinit
21     - Set the clock ID that is used by the driver for registering DPLL devices
22       and pins.
23
24Info versions
25=============
26
27The ``zl3073x`` driver reports the following versions
28
29.. list-table:: devlink info versions implemented
30    :widths: 5 5 5 90
31
32    * - Name
33      - Type
34      - Example
35      - Description
36    * - ``asic.id``
37      - fixed
38      - 1E94
39      - Chip identification number
40    * - ``asic.rev``
41      - fixed
42      - 300
43      - Chip revision number
44    * - ``fw``
45      - running
46      - 7006
47      - Firmware version number
48    * - ``custom_cfg``
49      - running
50      - 1.3.0.1
51      - Device configuration version customized by OEM
52
53Flash Update
54============
55
56The ``zl3073x`` driver implements support for flash update using the
57``devlink-flash`` interface. It supports updating the device flash using a
58combined flash image ("bundle") that contains multiple components (firmware
59parts and configurations).
60
61During the flash procedure, the standard firmware interface is not available,
62so the driver unregisters all DPLLs and associated pins, and re-registers them
63once the flash procedure is complete.
64
65The driver does not support any overwrite mask flags.
66