On Tue, Oct 19, 2021 at 01:52:04PM +0200, Horatiu Vultur wrote: > Document the lan966x phy reset device driving bindings. > It is using register access for the internal PHYs and toggles > GPIO for external PHYs. > > Signed-off-by: Horatiu Vultur <horatiu.vultur@xxxxxxxxxxxxx> > --- > .../bindings/reset/lan966x-phy,rst.yaml | 53 +++++++++++++++++++ > 1 file changed, 53 insertions(+) > create mode 100644 Documentation/devicetree/bindings/reset/lan966x-phy,rst.yaml > > diff --git a/Documentation/devicetree/bindings/reset/lan966x-phy,rst.yaml b/Documentation/devicetree/bindings/reset/lan966x-phy,rst.yaml > new file mode 100644 > index 000000000000..35a32458cafe > --- /dev/null > +++ b/Documentation/devicetree/bindings/reset/lan966x-phy,rst.yaml > @@ -0,0 +1,53 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: "http://devicetree.org/schemas/reset/lan966x-phy,rst.yaml#"; > +$schema: "http://devicetree.org/meta-schemas/core.yaml#"; > + > +title: Microchip Lan966x PHY Reset > + > +maintainers: > + - Horatiu Vultur <horatiu.vultur@xxxxxxxxxxxxx> > + > +description: | > + The Microchip Lan966x Switch provides 2 internal PHY which needs to be > + released from reset before they can be accessed. Also it might have external > + PHYs which requires to toggle a GPIO before the access to the PHYs. > + > +properties: > + $nodename: > + pattern: "^phy-reset@[0-9a-f]+$" ^reset-controller@[0-9a-f]+$ > + > + compatible: > + const: microchip,lan966x-phy-reset > + > + reg: > + items: > + - description: internal phy reset registers Just: maxItems: 1 > + > + reg-names: > + const: phy Not all that useful with only 1 entry. > + > + "#reset-cells": > + const: 1 > + > + external-phy-reset-gpios: > + description: used for release of reset of the external PHY > + maxItems: 1 This belongs in the external PHY's node. > + > +required: > + - compatible > + - reg > + - reg-names > + - "#reset-cells" > + > +additionalProperties: false > + > +examples: > + - | > + phy_reset: phy-reset@e2010010 { > + compatible = "microchip,lan966x-phy-reset"; > + reg = <0xe2010010 0x14>; > + reg-names = "phy"; > + #reset-cells = <1>; > + }; > -- > 2.33.0 > >
