3d21a46093
json-schema versions draft7 and earlier have a weird behavior in that any keywords combined with a '$ref' are ignored (silently). The correct form was to put a '$ref' under an 'allOf'. This behavior is now changed in the 2019-09 json-schema spec and '$ref' can be mixed with other keywords. The json-schema library doesn't yet support this, but the tooling now does a fixup for this and either way works. This has been a constant source of review comments, so let's change this treewide so everyone copies the simpler syntax. Scripted with ruamel.yaml with some manual fixups. Some minor whitespace changes from the script. Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Maxime Ripard <mripard@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Wolfram Sang <wsa@the-dreams.de> # for I2C Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for-iio Reviewed-by: Stephen Boyd <sboyd@kernel.org> # clock Signed-off-by: Rob Herring <robh@kernel.org>
107 lines
2.5 KiB
YAML
107 lines
2.5 KiB
YAML
# SPDX-License-Identifier: GPL-2.0+
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/qca,ar803x.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Qualcomm Atheros AR803x PHY
|
|
|
|
maintainers:
|
|
- Andrew Lunn <andrew@lunn.ch>
|
|
- Florian Fainelli <f.fainelli@gmail.com>
|
|
- Heiner Kallweit <hkallweit1@gmail.com>
|
|
|
|
description: |
|
|
Bindings for Qualcomm Atheros AR803x PHYs
|
|
|
|
allOf:
|
|
- $ref: ethernet-phy.yaml#
|
|
|
|
properties:
|
|
qca,clk-out-frequency:
|
|
description: Clock output frequency in Hertz.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [25000000, 50000000, 62500000, 125000000]
|
|
|
|
qca,clk-out-strength:
|
|
description: Clock output driver strength.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [0, 1, 2]
|
|
|
|
qca,keep-pll-enabled:
|
|
description: |
|
|
If set, keep the PLL enabled even if there is no link. Useful if you
|
|
want to use the clock output without an ethernet link.
|
|
|
|
Only supported on the AR8031.
|
|
type: boolean
|
|
|
|
vddio-supply:
|
|
description: |
|
|
RGMII I/O voltage regulator (see regulator/regulator.yaml).
|
|
|
|
The PHY supports RGMII I/O voltages of 1.5V, 1.8V and 2.5V. You can
|
|
either connect this to the vddio-regulator (1.5V / 1.8V) or the
|
|
vddh-regulator (2.5V).
|
|
|
|
Only supported on the AR8031.
|
|
|
|
vddio-regulator:
|
|
type: object
|
|
description:
|
|
Initial data for the VDDIO regulator. Set this to 1.5V or 1.8V.
|
|
$ref: /schemas/regulator/regulator.yaml
|
|
|
|
vddh-regulator:
|
|
type: object
|
|
description:
|
|
Dummy subnode to model the external connection of the PHY VDDH
|
|
regulator to VDDIO.
|
|
$ref: /schemas/regulator/regulator.yaml
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/net/qca-ar803x.h>
|
|
|
|
ethernet {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
phy-mode = "rgmii-id";
|
|
|
|
ethernet-phy@0 {
|
|
reg = <0>;
|
|
|
|
qca,clk-out-frequency = <125000000>;
|
|
qca,clk-out-strength = <AR803X_STRENGTH_FULL>;
|
|
|
|
vddio-supply = <&vddio>;
|
|
|
|
vddio: vddio-regulator {
|
|
regulator-min-microvolt = <1800000>;
|
|
regulator-max-microvolt = <1800000>;
|
|
};
|
|
};
|
|
};
|
|
- |
|
|
#include <dt-bindings/net/qca-ar803x.h>
|
|
|
|
ethernet {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
phy-mode = "rgmii-id";
|
|
|
|
ethernet-phy@0 {
|
|
reg = <0>;
|
|
|
|
qca,clk-out-frequency = <50000000>;
|
|
qca,keep-pll-enabled;
|
|
|
|
vddio-supply = <&vddh>;
|
|
|
|
vddh: vddh-regulator {
|
|
};
|
|
};
|
|
};
|