On Sun, Dec 08, 2024 at 01:20:37AM +0100, Christian Marangi wrote: > Document support for Airoha AN8855 Virtual MDIO Passtrough. This is needed > as AN8855 require special handling as the same address on the MDIO bus is > shared for both Switch and PHY and special handling for the page > configuration is needed to switch accessing to Switch address space > or PHY. > > Signed-off-by: Christian Marangi <ansuelsmth@xxxxxxxxx> > --- > .../bindings/net/airoha,an8855-mdio.yaml | 86 +++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 87 insertions(+) > create mode 100644 Documentation/devicetree/bindings/net/airoha,an8855-mdio.yaml > > diff --git a/Documentation/devicetree/bindings/net/airoha,an8855-mdio.yaml b/Documentation/devicetree/bindings/net/airoha,an8855-mdio.yaml > new file mode 100644 > index 000000000000..2211df3cc3b7 > --- /dev/null > +++ b/Documentation/devicetree/bindings/net/airoha,an8855-mdio.yaml > @@ -0,0 +1,86 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/net/airoha,an8855-mdio.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Airoha AN8855 MDIO Passtrough > + > +maintainers: > + - Christian Marangi <ansuelsmth@xxxxxxxxx> > + > +description: > + Airoha AN8855 Virtual MDIO Passtrough. This is needed as AN8855 > + require special handling as the same address on the MDIO bus is > + shared for both Switch and PHY and special handling for the page > + configuration is needed to switch accessing to Switch address space > + or PHY. > + > +$ref: /schemas/net/mdio.yaml# > + > +properties: > + compatible: > + const: airoha,an8855-mdio > + > +required: > + - compatible > + > +unevaluatedProperties: false > + > +examples: > + - | > + mdio { > + compatible = "airoha,an8855-mdio"; > + #address-cells = <1>; > + #size-cells = <0>; > + > + internal_phy1: phy@1 { > + reg = <1>; > + > + nvmem-cells = <&shift_sel_port0_tx_a>, > + <&shift_sel_port0_tx_b>, > + <&shift_sel_port0_tx_c>, > + <&shift_sel_port0_tx_d>; > + nvmem-cell-names = "tx_a", "tx_b", "tx_c", "tx_d"; For this example nvmem is not relevant. Those are PHY properties, not MDIO properties. So you could simplify this. Andrew
