networking/devlink/devlink-linecard.rst

1 .. SPDX-License-Identifier: GPL-2.0
10 The ``devlink-linecard`` mechanism is targeted for manipulation of
14   * Get a list of supported line card types.
15   * Provision of a slot with specific line card type.
16   * Get and monitor of line card state and its change.
19 to mux the lanes with certain speed to multiple ports with lanes
20 of different speed. Line card ensures N:M mapping between
21 the switch ASIC modules and physical front panel ports.
30 of detection of the splitter cable geometry, the device
32 concept of provisioning is introduced. It allows the user to:
36     - Device driver would instruct the ASIC to prepare all
40   * Manipulate of line card entities even without line card
41     being physically connected or powered-up
42   * Setup splitter cable on line card ports
44     - As on the ordinary ports, user may provision a splitter
45       cable of a certain type, without the need to
47   * Configure devlink ports and netdevices
51   * Line card is not inserted or powered-down
53     - The carrier is always down
56     - The carrier is decided as for ordinary port netdevice
61 The ``devlink-linecard`` mechanism supports the following line card states:
65   * ``provisioning``: Line card slot is currently in a process of being provisioned
69   * ``active``: Line card is powered-up and active.
71 The following diagram provides a general overview of ``devlink-linecard``
74                                           +-------------------------+
76        +---------------------------------->      unprovisioned      |
78        |                                  +--------|-------^--------+
81        |                                  +--------v-------|--------+
85        |                                  +------------|------------+
87        |                 +-----------------------------+
89        |    +------------v------------+   +------------v------------+   +-------------------------+
90        |    |                         |   |                         ---->                         |
91        +-----   provisioning_failed   |   |       provisioned       |   |         active          |
92        |    |                         |   |                         <----                         |
93        |    +------------^------------+   +------------|------------+   +-------------------------+
96        |                 |                +------------v------------+
100        |                 |                +------------|------------+
102        |                 +-----------------------------+
104        +-----------------------------------------------+
113     $ devlink lc set DEV lc LC_INDEX [ { type LC_TYPE | notype } ]
118     # Set slot 8 to be provisioned with type "16x100G":
119     $ devlink lc set pci/0000:01:00.0 lc 8 type 16x100G
121     # Set slot 8 to be unprovisioned:
122     $ devlink lc set pci/0000:01:00.0 lc 8 notype