Documentation/devicetree/bindings/net/ethernet-switch.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/net/ethernet-switch.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/net/ethernet-switch.yaml
Extension
.yaml
Size
2087 bytes
Lines
86
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/ethernet-switch.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Generic Ethernet Switch

maintainers:
  - Andrew Lunn <andrew@lunn.ch>
  - Florian Fainelli <f.fainelli@gmail.com>
  - Vladimir Oltean <olteanv@gmail.com>

description:
  Ethernet switches are multi-port Ethernet controllers. Each port has
  its own number and is represented as its own Ethernet controller.
  The minimum required functionality is to pass packets to software.
  They may or may not be able to forward packets automonously between
  ports.

select: false

allOf:
  # This condition is here to satisfy the case where certain device
  # nodes have to preserve non-standard names because of
  # backward-compatibility with boot loaders inspecting certain
  # node names.
  - if:
      properties:
        compatible:
          contains:
            enum:
              - marvell,turris-mox-mv88e6085
              - marvell,turris-mox-mv88e6190
    then:
      properties:
        $nodename:
          pattern: 'switch[0-3]@[0-3]+$'
    else:
      properties:
        $nodename:
          pattern: '^(ethernet-)?switch(@.*)?$'

patternProperties:
  '^(ethernet-)?ports$':
    type: object
    unevaluatedProperties: false

    properties:
      '#address-cells':
        const: 1
      '#size-cells':
        const: 0

    patternProperties:
      '^(ethernet-)?port@[0-9a-f]+$':
        type: object
        description: Ethernet switch ports

    required:
      - '#address-cells'
      - '#size-cells'

oneOf:
  - required:
      - ports
  - required:
      - ethernet-ports

additionalProperties: true

Annotation

Implementation Notes