c4a67a21a6
This reverts commit5e927a9f4b, reversing changes made tocfc1d91a7d. The discussion is still ongoing so let's remove the uAPI until the discussion settles. Link: https://lore.kernel.org/all/20220425090021.32e9a98f@kernel.org/ Reviewed-by: Ido Schimmel <idosch@nvidia.com> Link: https://lore.kernel.org/r/20220504154037.539442-1-kuba@kernel.org Signed-off-by: Jakub Kicinski <kuba@kernel.org>
123 lines
5.1 KiB
ReStructuredText
123 lines
5.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
=================
|
|
Devlink Line card
|
|
=================
|
|
|
|
Background
|
|
==========
|
|
|
|
The ``devlink-linecard`` mechanism is targeted for manipulation of
|
|
line cards that serve as a detachable PHY modules for modular switch
|
|
system. Following operations are provided:
|
|
|
|
* Get a list of supported line card types.
|
|
* Provision of a slot with specific line card type.
|
|
* Get and monitor of line card state and its change.
|
|
|
|
Line card according to the type may contain one or more gearboxes
|
|
to mux the lanes with certain speed to multiple ports with lanes
|
|
of different speed. Line card ensures N:M mapping between
|
|
the switch ASIC modules and physical front panel ports.
|
|
|
|
Overview
|
|
========
|
|
|
|
Each line card devlink object is created by device driver,
|
|
according to the physical line card slots available on the device.
|
|
|
|
Similar to splitter cable, where the device might have no way
|
|
of detection of the splitter cable geometry, the device
|
|
might not have a way to detect line card type. For that devices,
|
|
concept of provisioning is introduced. It allows the user to:
|
|
|
|
* Provision a line card slot with certain line card type
|
|
|
|
- Device driver would instruct the ASIC to prepare all
|
|
resources accordingly. The device driver would
|
|
create all instances, namely devlink port and netdevices
|
|
that reside on the line card, according to the line card type
|
|
* Manipulate of line card entities even without line card
|
|
being physically connected or powered-up
|
|
* Setup splitter cable on line card ports
|
|
|
|
- As on the ordinary ports, user may provision a splitter
|
|
cable of a certain type, without the need to
|
|
be physically connected to the port
|
|
* Configure devlink ports and netdevices
|
|
|
|
Netdevice carrier is decided as follows:
|
|
|
|
* Line card is not inserted or powered-down
|
|
|
|
- The carrier is always down
|
|
* Line card is inserted and powered up
|
|
|
|
- The carrier is decided as for ordinary port netdevice
|
|
|
|
Line card state
|
|
===============
|
|
|
|
The ``devlink-linecard`` mechanism supports the following line card states:
|
|
|
|
* ``unprovisioned``: Line card is not provisioned on the slot.
|
|
* ``unprovisioning``: Line card slot is currently being unprovisioned.
|
|
* ``provisioning``: Line card slot is currently in a process of being provisioned
|
|
with a line card type.
|
|
* ``provisioning_failed``: Provisioning was not successful.
|
|
* ``provisioned``: Line card slot is provisioned with a type.
|
|
* ``active``: Line card is powered-up and active.
|
|
|
|
The following diagram provides a general overview of ``devlink-linecard``
|
|
state transitions::
|
|
|
|
+-------------------------+
|
|
| |
|
|
+----------------------------------> unprovisioned |
|
|
| | |
|
|
| +--------|-------^--------+
|
|
| | |
|
|
| | |
|
|
| +--------v-------|--------+
|
|
| | |
|
|
| | provisioning |
|
|
| | |
|
|
| +------------|------------+
|
|
| |
|
|
| +-----------------------------+
|
|
| | |
|
|
| +------------v------------+ +------------v------------+ +-------------------------+
|
|
| | | | ----> |
|
|
+----- provisioning_failed | | provisioned | | active |
|
|
| | | | <---- |
|
|
| +------------^------------+ +------------|------------+ +-------------------------+
|
|
| | |
|
|
| | |
|
|
| | +------------v------------+
|
|
| | | |
|
|
| | | unprovisioning |
|
|
| | | |
|
|
| | +------------|------------+
|
|
| | |
|
|
| +-----------------------------+
|
|
| |
|
|
+-----------------------------------------------+
|
|
|
|
|
|
Example usage
|
|
=============
|
|
|
|
.. code:: shell
|
|
|
|
$ devlink lc show [ DEV [ lc LC_INDEX ] ]
|
|
$ devlink lc set DEV lc LC_INDEX [ { type LC_TYPE | notype } ]
|
|
|
|
# Show current line card configuration and status for all slots:
|
|
$ devlink lc
|
|
|
|
# Set slot 8 to be provisioned with type "16x100G":
|
|
$ devlink lc set pci/0000:01:00.0 lc 8 type 16x100G
|
|
|
|
# Set slot 8 to be unprovisioned:
|
|
$ devlink lc set pci/0000:01:00.0 lc 8 notype
|