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) mlxsw 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 ``mlxsw``
^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)    * - ``fw_load_policy``
^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 ``mlxsw`` 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)    * - ``acl_region_rehash_interval``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)      - u32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)      - runtime
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)      - Sets an interval for periodic ACL region rehashes. The value is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)        specified in milliseconds, with a minimum of ``3000``. The value of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)        ``0`` disables periodic work entirely. The first rehash will be run
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)        immediately after the value is set.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) The ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Info versions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) =============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) The ``mlxsw`` driver reports the following versions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) .. list-table:: devlink info versions implemented
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)    :widths: 5 5 90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)    * - Name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)      - Type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)      - Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)    * - ``hw.revision``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)      - fixed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)      - The hardware revision for this board
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)    * - ``fw.psid``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)      - fixed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)      - Firmware PSID
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)    * - ``fw.version``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)      - running
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59)      - Three digit firmware version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) Driver-specific Traps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) =====================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) .. list-table:: List of Driver-specific Traps Registered by ``mlxsw``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)    :widths: 5 5 90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)    * - Name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)      - Type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)      - Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)    * - ``irif_disabled``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)      - ``drop``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)      - Traps packets that the device decided to drop because they need to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)        routed from a disabled router interface (RIF). This can happen during
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)        RIF dismantle, when the RIF is first disabled before being removed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)        completely
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)    * - ``erif_disabled``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)      - ``drop``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78)      - Traps packets that the device decided to drop because they need to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)        routed through a disabled router interface (RIF). This can happen during
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80)        RIF dismantle, when the RIF is first disabled before being removed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81)        completely