mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-01 06:33:07 +00: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
109 lines
2.7 KiB
YAML
109 lines
2.7 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
# Copyright 2018 Linaro Ltd.
|
|
%YAML 1.2
|
|
---
|
|
$id: "http://devicetree.org/schemas/net/intel,ixp4xx-ethernet.yaml#"
|
|
$schema: "http://devicetree.org/meta-schemas/core.yaml#"
|
|
|
|
title: Intel IXP4xx ethernet
|
|
|
|
allOf:
|
|
- $ref: "ethernet-controller.yaml#"
|
|
|
|
maintainers:
|
|
- Linus Walleij <linus.walleij@linaro.org>
|
|
|
|
description: |
|
|
The Intel IXP4xx ethernet makes use of the IXP4xx NPE (Network
|
|
Processing Engine) and the IXP4xx Queue Manager to process
|
|
the ethernet frames. It can optionally contain an MDIO bus to
|
|
talk to PHYs.
|
|
|
|
properties:
|
|
compatible:
|
|
const: intel,ixp4xx-ethernet
|
|
|
|
reg:
|
|
maxItems: 1
|
|
description: Ethernet MMIO address range
|
|
|
|
queue-rx:
|
|
$ref: '/schemas/types.yaml#/definitions/phandle-array'
|
|
items:
|
|
- items:
|
|
- description: phandle to the RX queue node
|
|
- description: RX queue instance to use
|
|
description: phandle to the RX queue on the NPE
|
|
|
|
queue-txready:
|
|
$ref: '/schemas/types.yaml#/definitions/phandle-array'
|
|
items:
|
|
- items:
|
|
- description: phandle to the TX READY queue node
|
|
- description: TX READY queue instance to use
|
|
description: phandle to the TX READY queue on the NPE
|
|
|
|
phy-mode: true
|
|
|
|
phy-handle: true
|
|
|
|
intel,npe-handle:
|
|
$ref: '/schemas/types.yaml#/definitions/phandle-array'
|
|
items:
|
|
- items:
|
|
- description: phandle to the NPE this ethernet instance is using
|
|
- description: the NPE instance to use
|
|
description: phandle to the NPE this ethernet instance is using
|
|
and the instance to use in the second cell
|
|
|
|
mdio:
|
|
$ref: mdio.yaml#
|
|
unevaluatedProperties: false
|
|
description: optional node for embedded MDIO controller
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- queue-rx
|
|
- queue-txready
|
|
- intel,npe-handle
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
npe: npe@c8006000 {
|
|
compatible = "intel,ixp4xx-network-processing-engine";
|
|
reg = <0xc8006000 0x1000>, <0xc8007000 0x1000>, <0xc8008000 0x1000>;
|
|
};
|
|
|
|
ethernet@c8009000 {
|
|
compatible = "intel,ixp4xx-ethernet";
|
|
reg = <0xc8009000 0x1000>;
|
|
queue-rx = <&qmgr 4>;
|
|
queue-txready = <&qmgr 21>;
|
|
intel,npe-handle = <&npe 1>;
|
|
phy-mode = "rgmii";
|
|
phy-handle = <&phy1>;
|
|
};
|
|
|
|
ethernet@c800c000 {
|
|
compatible = "intel,ixp4xx-ethernet";
|
|
reg = <0xc800c000 0x1000>;
|
|
queue-rx = <&qmgr 3>;
|
|
queue-txready = <&qmgr 20>;
|
|
intel,npe-handle = <&npe 2>;
|
|
phy-mode = "rgmii";
|
|
phy-handle = <&phy2>;
|
|
|
|
mdio {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
phy1: ethernet-phy@1 {
|
|
reg = <1>;
|
|
};
|
|
phy2: ethernet-phy@2 {
|
|
reg = <2>;
|
|
};
|
|
};
|
|
};
|