dt-bindings: net: add generic ethernet-switch

The dsa.yaml bindings had references that can apply to non-dsa switches. To
prevent duplication of this information, keep the dsa-specific information
inside dsa.yaml and move the remaining generic information to the newly
created ethernet-switch.yaml.

Signed-off-by: Colin Foster <colin.foster@in-advantage.com>
Suggested-by: Vladimir Oltean <olteanv@gmail.com>
Reviewed-by: Florian Fainelli <f.fainelli@gmail.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: David S. Miller <davem@davemloft.net>

authored by

Colin Foster and committed by

David S. Miller 3 years ago 7f5bccc8 000bd2af

+69 -29

3 changed files

expand all

Documentation

devicetree

bindings

net

dsa

dsa.yaml

ethernet-switch.yaml

MAINTAINERS

+2 -29

Documentation/devicetree/bindings/net/dsa/dsa.yaml

··· 18 18 19 19 select: false 20 20 21 - properties: 22 - $nodename: 23 - pattern: "^(ethernet-)?switch(@.*)?$" 21 + $ref: /schemas/net/ethernet-switch.yaml# 24 22 23 + properties: 25 24 dsa,member: 26 25 minItems: 2 27 26 maxItems: 2 ··· 30 31 switch 1. <1 0> is cluster 1, switch 0. A switch not part of any cluster 31 32 (single device hanging off a CPU port) must not specify this property 32 33 $ref: /schemas/types.yaml#/definitions/uint32-array 33 - 34 - patternProperties: 35 - "^(ethernet-)?ports$": 36 - type: object 37 - properties: 38 - '#address-cells': 39 - const: 1 40 - '#size-cells': 41 - const: 0 42 - 43 - unevaluatedProperties: false 44 - 45 - patternProperties: 46 - "^(ethernet-)?port@[0-9]+$": 47 - type: object 48 - description: Ethernet switch ports 49 - 50 - $ref: dsa-port.yaml# 51 - 52 - additionalProperties: true 53 - 54 - oneOf: 55 - - required: 56 - - ports 57 - - required: 58 - - ethernet-ports 59 34 60 35 additionalProperties: true 61 36

+66

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

··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/net/ethernet-switch.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Generic Ethernet Switch 8 + 9 + maintainers: 10 + - Andrew Lunn <andrew@lunn.ch> 11 + - Florian Fainelli <f.fainelli@gmail.com> 12 + - Vladimir Oltean <olteanv@gmail.com> 13 + 14 + description: 15 + Ethernet switches are multi-port Ethernet controllers. Each port has 16 + its own number and is represented as its own Ethernet controller. 17 + The minimum required functionality is to pass packets to software. 18 + They may or may not be able to forward packets automonously between 19 + ports. 20 + 21 + select: false 22 + 23 + properties: 24 + $nodename: 25 + pattern: "^(ethernet-)?switch(@.*)?$" 26 + 27 + patternProperties: 28 + "^(ethernet-)?ports$": 29 + type: object 30 + unevaluatedProperties: false 31 + 32 + properties: 33 + '#address-cells': 34 + const: 1 35 + '#size-cells': 36 + const: 0 37 + 38 + patternProperties: 39 + "^(ethernet-)?port@[0-9]+$": 40 + type: object 41 + description: Ethernet switch ports 42 + 43 + $ref: ethernet-controller.yaml# 44 + 45 + additionalProperties: true 46 + 47 + oneOf: 48 + - required: 49 + - ports 50 + - required: 51 + - ethernet-ports 52 + 53 + additionalProperties: true 54 + 55 + $defs: 56 + base: 57 + description: An ethernet switch without any extra port properties 58 + $ref: '#/' 59 + 60 + patternProperties: 61 + "^(ethernet-)?port@[0-9]+$": 62 + description: Ethernet switch ports 63 + $ref: ethernet-controller.yaml# 64 + unevaluatedProperties: false 65 + 66 + ...

MAINTAINERS

··· 14543 14543 M: Vladimir Oltean <olteanv@gmail.com> 14544 14544 S: Maintained 14545 14545 F: Documentation/devicetree/bindings/net/dsa/ 14546 + F: Documentation/devicetree/bindings/net/ethernet-switch.yaml 14546 14547 F: drivers/net/dsa/ 14547 14548 F: include/linux/dsa/ 14548 14549 F: include/linux/platform_data/dsa.h

Configure Feed

Configure Feed