| Message ID | 20211109113239.93493-5-robert.marko@sartura.hr |
|---|---|
| State | New |
| Headers | show |
| Series | [v9,1/6] mfd: simple-mfd-i2c: Add Delta TN48M CPLD support | expand |
On Tue, Nov 9, 2021 at 12:32 PM Robert Marko <robert.marko@sartura.hr> wrote: > > Add binding documents for the Delta TN48M CPLD drivers. > > Signed-off-by: Robert Marko <robert.marko@sartura.hr> > --- > Changes in v7: > * Update bindings to reflect driver updates > > Changes in v3: > * Include bindings for reset driver > > Changes in v2: > * Implement MFD as a simple I2C MFD > * Add GPIO bindings as separate > --- > .../bindings/gpio/delta,tn48m-gpio.yaml | 39 ++++++++ > .../bindings/mfd/delta,tn48m-cpld.yaml | 90 +++++++++++++++++++ > .../bindings/reset/delta,tn48m-reset.yaml | 35 ++++++++ > 3 files changed, 164 insertions(+) > create mode 100644 Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml > create mode 100644 Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml > create mode 100644 Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml > > diff --git a/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml b/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml > new file mode 100644 > index 000000000000..e3e668a12091 > --- /dev/null > +++ b/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml > @@ -0,0 +1,39 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/gpio/delta,tn48m-gpio.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Delta Networks TN48M CPLD GPIO controller > + > +maintainers: > + - Robert Marko <robert.marko@sartura.hr> > + > +description: | > + This module is part of the Delta TN48M multi-function device. For more > + details see ../mfd/delta,tn48m-cpld.yaml. > + > + Delta TN48M has an onboard Lattice CPLD that is used as an GPIO expander. > + It provides 12 pins in total, they are input-only or ouput-only type. > + > +properties: > + compatible: > + enum: > + - delta,tn48m-gpo > + - delta,tn48m-gpi > + > + reg: > + maxItems: 1 > + > + "#gpio-cells": > + const: 2 > + > + gpio-controller: true > + > +required: > + - compatible > + - reg > + - "#gpio-cells" > + - gpio-controller > + > +additionalProperties: false > diff --git a/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml b/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml > new file mode 100644 > index 000000000000..f6967c1f6235 > --- /dev/null > +++ b/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml > @@ -0,0 +1,90 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/mfd/delta,tn48m-cpld.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Delta Networks TN48M CPLD controller > + > +maintainers: > + - Robert Marko <robert.marko@sartura.hr> > + > +description: | > + Lattice CPLD onboard the TN48M switches is used for system > + management. > + > + It provides information about the hardware model, revision, > + PSU status etc. > + > + It is also being used as a GPIO expander and reset controller > + for the switch MAC-s and other peripherals. > + > +properties: > + compatible: > + const: delta,tn48m-cpld > + > + reg: > + description: > + I2C device address. > + maxItems: 1 > + > + "#address-cells": > + const: 1 > + > + "#size-cells": > + const: 0 > + > +required: > + - compatible > + - reg > + - "#address-cells" > + - "#size-cells" > + > +patternProperties: > + "^gpio(@[0-9a-f]+)?$": > + $ref: ../gpio/delta,tn48m-gpio.yaml > + > + "^reset-controller?$": > + $ref: ../reset/delta,tn48m-reset.yaml > + > +additionalProperties: false > + > +examples: > + - | > + i2c { > + #address-cells = <1>; > + #size-cells = <0>; > + > + cpld@41 { > + compatible = "delta,tn48m-cpld"; > + reg = <0x41>; > + #address-cells = <1>; > + #size-cells = <0>; > + > + gpio@31 { > + compatible = "delta,tn48m-gpo"; > + reg = <0x31>; > + gpio-controller; > + #gpio-cells = <2>; > + }; > + > + gpio@3a { > + compatible = "delta,tn48m-gpi"; > + reg = <0x3a>; > + gpio-controller; > + #gpio-cells = <2>; > + }; > + > + gpio@40 { > + compatible = "delta,tn48m-gpi"; > + reg = <0x40>; > + gpio-controller; > + #gpio-cells = <2>; > + }; > + > + reset-controller { > + compatible = "delta,tn48m-reset"; > + #reset-cells = <1>; > + }; > + }; > + }; > diff --git a/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml b/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml > new file mode 100644 > index 000000000000..0e5ee8decc0d > --- /dev/null > +++ b/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml > @@ -0,0 +1,35 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/reset/delta,tn48m-reset.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Delta Networks TN48M CPLD reset controller > + > +maintainers: > + - Robert Marko <robert.marko@sartura.hr> > + > +description: | > + This module is part of the Delta TN48M multi-function device. For more > + details see ../mfd/delta,tn48m-cpld.yaml. > + > + Reset controller modules provides resets for the following: > + * 88F7040 SoC > + * 88F6820 SoC > + * 98DX3265 switch MAC-s > + * 88E1680 PHY-s > + * 88E1512 PHY > + * PoE PSE controller > + > +properties: > + compatible: > + const: delta,tn48m-reset > + > + "#reset-cells": > + const: 1 > + > +required: > + - compatible > + - "#reset-cells" > + > +additionalProperties: false > -- > 2.33.1 > Rob, do you have any comments? The rest of the series has been reviewed, so I would like to move forward. Regards, Robert
On Tue, Nov 9, 2021 at 12:32 PM Robert Marko <robert.marko@sartura.hr> wrote: > > Add binding documents for the Delta TN48M CPLD drivers. > > Signed-off-by: Robert Marko <robert.marko@sartura.hr> > --- > Changes in v7: > * Update bindings to reflect driver updates > > Changes in v3: > * Include bindings for reset driver > > Changes in v2: > * Implement MFD as a simple I2C MFD > * Add GPIO bindings as separate > --- > .../bindings/gpio/delta,tn48m-gpio.yaml | 39 ++++++++ > .../bindings/mfd/delta,tn48m-cpld.yaml | 90 +++++++++++++++++++ > .../bindings/reset/delta,tn48m-reset.yaml | 35 ++++++++ > 3 files changed, 164 insertions(+) > create mode 100644 Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml > create mode 100644 Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml > create mode 100644 Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml > > diff --git a/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml b/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml > new file mode 100644 > index 000000000000..e3e668a12091 > --- /dev/null > +++ b/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml > @@ -0,0 +1,39 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/gpio/delta,tn48m-gpio.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Delta Networks TN48M CPLD GPIO controller > + > +maintainers: > + - Robert Marko <robert.marko@sartura.hr> > + > +description: | > + This module is part of the Delta TN48M multi-function device. For more > + details see ../mfd/delta,tn48m-cpld.yaml. > + > + Delta TN48M has an onboard Lattice CPLD that is used as an GPIO expander. > + It provides 12 pins in total, they are input-only or ouput-only type. > + > +properties: > + compatible: > + enum: > + - delta,tn48m-gpo > + - delta,tn48m-gpi > + > + reg: > + maxItems: 1 > + > + "#gpio-cells": > + const: 2 > + > + gpio-controller: true > + > +required: > + - compatible > + - reg > + - "#gpio-cells" > + - gpio-controller > + > +additionalProperties: false > diff --git a/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml b/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml > new file mode 100644 > index 000000000000..f6967c1f6235 > --- /dev/null > +++ b/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml > @@ -0,0 +1,90 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/mfd/delta,tn48m-cpld.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Delta Networks TN48M CPLD controller > + > +maintainers: > + - Robert Marko <robert.marko@sartura.hr> > + > +description: | > + Lattice CPLD onboard the TN48M switches is used for system > + management. > + > + It provides information about the hardware model, revision, > + PSU status etc. > + > + It is also being used as a GPIO expander and reset controller > + for the switch MAC-s and other peripherals. > + > +properties: > + compatible: > + const: delta,tn48m-cpld > + > + reg: > + description: > + I2C device address. > + maxItems: 1 > + > + "#address-cells": > + const: 1 > + > + "#size-cells": > + const: 0 > + > +required: > + - compatible > + - reg > + - "#address-cells" > + - "#size-cells" > + > +patternProperties: > + "^gpio(@[0-9a-f]+)?$": > + $ref: ../gpio/delta,tn48m-gpio.yaml > + > + "^reset-controller?$": > + $ref: ../reset/delta,tn48m-reset.yaml > + > +additionalProperties: false > + > +examples: > + - | > + i2c { > + #address-cells = <1>; > + #size-cells = <0>; > + > + cpld@41 { > + compatible = "delta,tn48m-cpld"; > + reg = <0x41>; > + #address-cells = <1>; > + #size-cells = <0>; > + > + gpio@31 { > + compatible = "delta,tn48m-gpo"; > + reg = <0x31>; > + gpio-controller; > + #gpio-cells = <2>; > + }; > + > + gpio@3a { > + compatible = "delta,tn48m-gpi"; > + reg = <0x3a>; > + gpio-controller; > + #gpio-cells = <2>; > + }; > + > + gpio@40 { > + compatible = "delta,tn48m-gpi"; > + reg = <0x40>; > + gpio-controller; > + #gpio-cells = <2>; > + }; > + > + reset-controller { > + compatible = "delta,tn48m-reset"; > + #reset-cells = <1>; > + }; > + }; > + }; > diff --git a/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml b/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml > new file mode 100644 > index 000000000000..0e5ee8decc0d > --- /dev/null > +++ b/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml > @@ -0,0 +1,35 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/reset/delta,tn48m-reset.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Delta Networks TN48M CPLD reset controller > + > +maintainers: > + - Robert Marko <robert.marko@sartura.hr> > + > +description: | > + This module is part of the Delta TN48M multi-function device. For more > + details see ../mfd/delta,tn48m-cpld.yaml. > + > + Reset controller modules provides resets for the following: > + * 88F7040 SoC > + * 88F6820 SoC > + * 98DX3265 switch MAC-s > + * 88E1680 PHY-s > + * 88E1512 PHY > + * PoE PSE controller > + > +properties: > + compatible: > + const: delta,tn48m-reset > + > + "#reset-cells": > + const: 1 > + > +required: > + - compatible > + - "#reset-cells" > + > +additionalProperties: false > -- > 2.33.1 > Linus, do you have any improvement points to the bindings? Regards, Robert
diff --git a/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml b/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml new file mode 100644 index 000000000000..e3e668a12091 --- /dev/null +++ b/Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml @@ -0,0 +1,39 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/gpio/delta,tn48m-gpio.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Delta Networks TN48M CPLD GPIO controller + +maintainers: + - Robert Marko <robert.marko@sartura.hr> + +description: | + This module is part of the Delta TN48M multi-function device. For more + details see ../mfd/delta,tn48m-cpld.yaml. + + Delta TN48M has an onboard Lattice CPLD that is used as an GPIO expander. + It provides 12 pins in total, they are input-only or ouput-only type. + +properties: + compatible: + enum: + - delta,tn48m-gpo + - delta,tn48m-gpi + + reg: + maxItems: 1 + + "#gpio-cells": + const: 2 + + gpio-controller: true + +required: + - compatible + - reg + - "#gpio-cells" + - gpio-controller + +additionalProperties: false diff --git a/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml b/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml new file mode 100644 index 000000000000..f6967c1f6235 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml @@ -0,0 +1,90 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/delta,tn48m-cpld.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Delta Networks TN48M CPLD controller + +maintainers: + - Robert Marko <robert.marko@sartura.hr> + +description: | + Lattice CPLD onboard the TN48M switches is used for system + management. + + It provides information about the hardware model, revision, + PSU status etc. + + It is also being used as a GPIO expander and reset controller + for the switch MAC-s and other peripherals. + +properties: + compatible: + const: delta,tn48m-cpld + + reg: + description: + I2C device address. + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + +required: + - compatible + - reg + - "#address-cells" + - "#size-cells" + +patternProperties: + "^gpio(@[0-9a-f]+)?$": + $ref: ../gpio/delta,tn48m-gpio.yaml + + "^reset-controller?$": + $ref: ../reset/delta,tn48m-reset.yaml + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + cpld@41 { + compatible = "delta,tn48m-cpld"; + reg = <0x41>; + #address-cells = <1>; + #size-cells = <0>; + + gpio@31 { + compatible = "delta,tn48m-gpo"; + reg = <0x31>; + gpio-controller; + #gpio-cells = <2>; + }; + + gpio@3a { + compatible = "delta,tn48m-gpi"; + reg = <0x3a>; + gpio-controller; + #gpio-cells = <2>; + }; + + gpio@40 { + compatible = "delta,tn48m-gpi"; + reg = <0x40>; + gpio-controller; + #gpio-cells = <2>; + }; + + reset-controller { + compatible = "delta,tn48m-reset"; + #reset-cells = <1>; + }; + }; + }; diff --git a/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml b/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml new file mode 100644 index 000000000000..0e5ee8decc0d --- /dev/null +++ b/Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml @@ -0,0 +1,35 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/reset/delta,tn48m-reset.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Delta Networks TN48M CPLD reset controller + +maintainers: + - Robert Marko <robert.marko@sartura.hr> + +description: | + This module is part of the Delta TN48M multi-function device. For more + details see ../mfd/delta,tn48m-cpld.yaml. + + Reset controller modules provides resets for the following: + * 88F7040 SoC + * 88F6820 SoC + * 98DX3265 switch MAC-s + * 88E1680 PHY-s + * 88E1512 PHY + * PoE PSE controller + +properties: + compatible: + const: delta,tn48m-reset + + "#reset-cells": + const: 1 + +required: + - compatible + - "#reset-cells" + +additionalProperties: false
Add binding documents for the Delta TN48M CPLD drivers. Signed-off-by: Robert Marko <robert.marko@sartura.hr> --- Changes in v7: * Update bindings to reflect driver updates Changes in v3: * Include bindings for reset driver Changes in v2: * Implement MFD as a simple I2C MFD * Add GPIO bindings as separate --- .../bindings/gpio/delta,tn48m-gpio.yaml | 39 ++++++++ .../bindings/mfd/delta,tn48m-cpld.yaml | 90 +++++++++++++++++++ .../bindings/reset/delta,tn48m-reset.yaml | 35 ++++++++ 3 files changed, 164 insertions(+) create mode 100644 Documentation/devicetree/bindings/gpio/delta,tn48m-gpio.yaml create mode 100644 Documentation/devicetree/bindings/mfd/delta,tn48m-cpld.yaml create mode 100644 Documentation/devicetree/bindings/reset/delta,tn48m-reset.yaml