mirror of
https://github.com/torvalds/linux.git
synced 2026-04-20 07:43:57 -04:00
39bd2b6a37
The 'phandle-array' type is a bit ambiguous. It can be either just an
array of phandles or an array of phandles plus args. Many schemas for
phandle-array properties aren't clear in the schema which case applies
though the description usually describes it.
The array of phandles case boils down to needing:
items:
maxItems: 1
The phandle plus args cases should typically take this form:
items:
- items:
- description: A phandle
- description: 1st arg cell
- description: 2nd arg cell
With this change, some examples need updating so that the bracketing of
property values matches the schema.
Signed-off-by: Rob Herring <robh@kernel.org>
Acked-by: Viresh Kumar <viresh.kumar@linaro.org>
Acked-by: Vinod Koul <vkoul@kernel.org>
Acked-by: Ulf Hansson <ulf.hansson@linaro.org>
Acked-by: Georgi Djakov <djakov@kernel.org>
Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>
Acked-by: Mark Brown <broonie@kernel.org>
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
Acked-by: Stephen Boyd <sboyd@kernel.org>
Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Acked-by: Marc Kleine-Budde <mkl@pengutronix.de>
Link: https://lore.kernel.org/r/20220119015038.2433585-1-robh@kernel.org
80 lines
1.8 KiB
YAML
80 lines
1.8 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/dsa/dsa-port.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Ethernet Switch port Device Tree Bindings
|
|
|
|
maintainers:
|
|
- Andrew Lunn <andrew@lunn.ch>
|
|
- Florian Fainelli <f.fainelli@gmail.com>
|
|
- Vivien Didelot <vivien.didelot@gmail.com>
|
|
|
|
description:
|
|
Ethernet switch port Description
|
|
|
|
allOf:
|
|
- $ref: "http://devicetree.org/schemas/net/ethernet-controller.yaml#"
|
|
|
|
properties:
|
|
reg:
|
|
description: Port number
|
|
|
|
label:
|
|
description:
|
|
Describes the label associated with this port, which will become
|
|
the netdev name
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
|
|
link:
|
|
description:
|
|
Should be a list of phandles to other switch's DSA port. This
|
|
port is used as the outgoing port towards the phandle ports. The
|
|
full routing information must be given, not just the one hop
|
|
routes to neighbouring switches
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
items:
|
|
maxItems: 1
|
|
|
|
ethernet:
|
|
description:
|
|
Should be a phandle to a valid Ethernet device node. This host
|
|
device is what the switch port is connected to
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
|
|
dsa-tag-protocol:
|
|
description:
|
|
Instead of the default, the switch will use this tag protocol if
|
|
possible. Useful when a device supports multiple protocols and
|
|
the default is incompatible with the Ethernet device.
|
|
enum:
|
|
- dsa
|
|
- edsa
|
|
- ocelot
|
|
- ocelot-8021q
|
|
- seville
|
|
|
|
phy-handle: true
|
|
|
|
phy-mode: true
|
|
|
|
fixed-link: true
|
|
|
|
mac-address: true
|
|
|
|
sfp: true
|
|
|
|
managed: true
|
|
|
|
rx-internal-delay-ps: true
|
|
|
|
tx-internal-delay-ps: true
|
|
|
|
required:
|
|
- reg
|
|
|
|
additionalProperties: true
|
|
|
|
...
|