Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  3) ====================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  4) mlx5 devlink support
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  5) ====================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) This document describes the devlink features implemented by the ``mlx5``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) device driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Parameters
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) ==========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) .. list-table:: Generic parameters implemented
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)    * - Name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)      - Mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)    * - ``enable_roce``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)      - driverinit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) The ``mlx5`` driver also implements the following driver-specific
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) parameters.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) .. list-table:: Driver-specific parameters implemented
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)    :widths: 5 5 5 85
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)    * - Name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)      - Type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)      - Mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)      - Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)    * - ``flow_steering_mode``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)      - string
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)      - runtime
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)      - Controls the flow steering mode of the driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)        * ``dmfs`` Device managed flow steering. In DMFS mode, the HW
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)          steering entities are created and managed through firmware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)        * ``smfs`` Software managed flow steering. In SMFS mode, the HW
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)          steering entities are created and manage through the driver without
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)          firmware intervention.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)    * - ``fdb_large_groups``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)      - u32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)      - driverinit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)      - Control the number of large groups (size > 1) in the FDB table.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)        * The default value is 15, and the range is between 1 and 1024.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) The ``mlx5`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) Info versions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) =============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) The ``mlx5`` driver reports the following versions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) .. list-table:: devlink info versions implemented
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)    :widths: 5 5 90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)    * - Name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)      - Type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59)      - Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60)    * - ``fw.psid``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)      - fixed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)      - Used to represent the board id of the device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)    * - ``fw.version``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)      - stored, running
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)      - Three digit major.minor.subminor firmware version number.