Documentation/devicetree/bindings/net/dsa/nxp,netc-switch.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/net/dsa/nxp,netc-switch.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/net/dsa/nxp,netc-switch.yaml
Extension
.yaml
Size
3569 bytes
Lines
132
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/dsa/nxp,netc-switch.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: NETC Switch family

description: >
  The NETC presents itself as a multi-function PCIe Root Complex Integrated
  Endpoint (RCiEP) and provides full 802.1Q Ethernet switch functionality,
  advanced QoS with 8 traffic classes and 4 drop resilience levels, and a
  full range of TSN standards capabilities.

  The CPU port of the switch connects to an internal ENETC. The switch and
  the internal ENETC are fully integrated into the NETC IP, a back-to-back
  MAC is not required. Instead, a light-weight "pseudo MAC" provides the
  delineation between the switch and ENETC. This translates to lower power
  (less logic and memory) and lower delay (as there is no serialization
  delay across this link).

maintainers:
  - Wei Fang <wei.fang@nxp.com>

properties:
  compatible:
    enum:
      - pci1131,eef2

  reg:
    maxItems: 1

  dsa,member:
    description: >
      The property indicates DSA cluster and switch index. For NETC switch,
      the valid range of the switch index is 1 ~ 7, the index is reflected
      in the switch tag as an indication of the switch ID where the frame
      originated. The value 0 is reserved for ENETC VEPA switch, whose ID
      is hardwired to zero.
    items:
      - true
      - minimum: 1
        maximum: 7

  ethernet-ports:
    type: object
    patternProperties:
      "^ethernet-port@[0-9a-f]$":
        type: object
        $ref: dsa-port.yaml#

        properties:
          clocks:
            items:
              - description: MAC transmit/receive reference clock.

          clock-names:
            items:
              - const: ref

          mdio:
            $ref: /schemas/net/mdio.yaml#
            unevaluatedProperties: false
            description:
              Optional child node for switch port, otherwise use NETC EMDIO.

        unevaluatedProperties: false

required:
  - compatible

Annotation

Implementation Notes