tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1# SPDX-License-Identifier: GPL-2.0+
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/qca,ar803x.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Qualcomm Atheros AR803x PHY
8
9maintainers:
10 - Andrew Lunn <andrew@lunn.ch>
11 - Florian Fainelli <f.fainelli@gmail.com>
12 - Heiner Kallweit <hkallweit1@gmail.com>
13
14description: |
15 Bindings for Qualcomm Atheros AR803x PHYs
16
17allOf:
18 - $ref: ethernet-phy.yaml#
19
20properties:
21 qca,clk-out-frequency:
22 description: Clock output frequency in Hertz.
23 $ref: /schemas/types.yaml#/definitions/uint32
24 enum: [25000000, 50000000, 62500000, 125000000]
25
26 qca,clk-out-strength:
27 description: Clock output driver strength.
28 $ref: /schemas/types.yaml#/definitions/uint32
29 enum: [0, 1, 2]
30
31 qca,disable-smarteee:
32 description: Disable Atheros SmartEEE feature.
33 type: boolean
34
35 qca,keep-pll-enabled:
36 description: |
37 If set, keep the PLL enabled even if there is no link. Useful if you
38 want to use the clock output without an ethernet link.
39
40 Only supported on the AR8031.
41 type: boolean
42
43 qca,disable-hibernation-mode:
44 description: |
45 Disable Atheros AR803X PHYs hibernation mode. If present, indicates
46 that the hardware of PHY will not enter power saving mode when the
47 cable is disconnected. And the RX_CLK always keeps outputting a
48 valid clock.
49 type: boolean
50
51 qca,smarteee-tw-us-100m:
52 description: EEE Tw parameter for 100M links.
53 $ref: /schemas/types.yaml#/definitions/uint32
54 minimum: 1
55 maximum: 255
56
57 qca,smarteee-tw-us-1g:
58 description: EEE Tw parameter for gigabit links.
59 $ref: /schemas/types.yaml#/definitions/uint32
60 minimum: 1
61 maximum: 255
62
63 vddio-supply:
64 description: |
65 RGMII I/O voltage regulator (see regulator/regulator.yaml).
66
67 The PHY supports RGMII I/O voltages of 1.5V, 1.8V and 2.5V. You can
68 either connect this to the vddio-regulator (1.5V / 1.8V) or the
69 vddh-regulator (2.5V).
70
71 Only supported on the AR8031.
72
73 vddio-regulator:
74 type: object
75 description:
76 Initial data for the VDDIO regulator. Set this to 1.5V or 1.8V.
77 $ref: /schemas/regulator/regulator.yaml
78
79 vddh-regulator:
80 type: object
81 description:
82 Dummy subnode to model the external connection of the PHY VDDH
83 regulator to VDDIO.
84 $ref: /schemas/regulator/regulator.yaml
85
86unevaluatedProperties: false
87
88examples:
89 - |
90 #include <dt-bindings/net/qca-ar803x.h>
91
92 ethernet {
93 #address-cells = <1>;
94 #size-cells = <0>;
95
96 phy-mode = "rgmii-id";
97
98 ethernet-phy@0 {
99 reg = <0>;
100
101 qca,clk-out-frequency = <125000000>;
102 qca,clk-out-strength = <AR803X_STRENGTH_FULL>;
103
104 vddio-supply = <&vddio>;
105
106 vddio: vddio-regulator {
107 regulator-min-microvolt = <1800000>;
108 regulator-max-microvolt = <1800000>;
109 };
110 };
111 };
112 - |
113 #include <dt-bindings/net/qca-ar803x.h>
114
115 ethernet {
116 #address-cells = <1>;
117 #size-cells = <0>;
118
119 phy-mode = "rgmii-id";
120
121 ethernet-phy@0 {
122 reg = <0>;
123
124 qca,clk-out-frequency = <50000000>;
125 qca,keep-pll-enabled;
126
127 vddio-supply = <&vddh>;
128
129 vddh: vddh-regulator {
130 };
131 };
132 };