mirror of
https://github.com/torvalds/linux.git
synced 2026-04-21 08:13:56 -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
97 lines
2.5 KiB
YAML
97 lines
2.5 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/nxp,dwmac-imx.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: NXP i.MX8 DWMAC glue layer Device Tree Bindings
|
|
|
|
maintainers:
|
|
- Joakim Zhang <qiangqing.zhang@nxp.com>
|
|
|
|
# We need a select here so we don't match all nodes with 'snps,dwmac'
|
|
select:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- nxp,imx8mp-dwmac-eqos
|
|
- nxp,imx8dxl-dwmac-eqos
|
|
required:
|
|
- compatible
|
|
|
|
allOf:
|
|
- $ref: "snps,dwmac.yaml#"
|
|
|
|
properties:
|
|
compatible:
|
|
oneOf:
|
|
- items:
|
|
- enum:
|
|
- nxp,imx8mp-dwmac-eqos
|
|
- nxp,imx8dxl-dwmac-eqos
|
|
- const: snps,dwmac-5.10a
|
|
|
|
clocks:
|
|
minItems: 3
|
|
items:
|
|
- description: MAC host clock
|
|
- description: MAC apb clock
|
|
- description: MAC timer clock
|
|
- description: MAC RGMII TX clock
|
|
- description: EQOS MEM clock
|
|
|
|
clock-names:
|
|
minItems: 3
|
|
maxItems: 5
|
|
contains:
|
|
enum:
|
|
- stmmaceth
|
|
- pclk
|
|
- ptp_ref
|
|
- tx
|
|
- mem
|
|
|
|
intf_mode:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
items:
|
|
- items:
|
|
- description: phandle to the GPR syscon
|
|
- description: the offset of the GPR register
|
|
description:
|
|
Should be phandle/offset pair. The phandle to the syscon node which
|
|
encompases the GPR register, and the offset of the GPR register.
|
|
|
|
snps,rmii_refclk_ext:
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
description:
|
|
To select RMII reference clock from external.
|
|
|
|
required:
|
|
- compatible
|
|
- clocks
|
|
- clock-names
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
|
#include <dt-bindings/clock/imx8mp-clock.h>
|
|
|
|
eqos: ethernet@30bf0000 {
|
|
compatible = "nxp,imx8mp-dwmac-eqos","snps,dwmac-5.10a";
|
|
reg = <0x30bf0000 0x10000>;
|
|
interrupts = <GIC_SPI 135 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 134 IRQ_TYPE_LEVEL_HIGH>;
|
|
interrupt-names = "macirq", "eth_wake_irq";
|
|
clocks = <&clk IMX8MP_CLK_ENET_QOS_ROOT>,
|
|
<&clk IMX8MP_CLK_QOS_ENET_ROOT>,
|
|
<&clk IMX8MP_CLK_ENET_QOS_TIMER>,
|
|
<&clk IMX8MP_CLK_ENET_QOS>;
|
|
clock-names = "stmmaceth", "pclk", "ptp_ref", "tx";
|
|
phy-mode = "rgmii";
|
|
status = "disabled";
|
|
};
|