Re: [PATCH] dt-bindings: bus: add device tree bindings for fsl,p1021rdb-pc-cpld

["Pali Rohár" <pali@kernel.org>]

PING?

If you really do not care about documentation then just tell people to
not waste time on doing it. Because dts files can be compiled and used
on the real hardware without those superfluous YAML files.

On Wednesday 31 August 2022 13:46:40 Pali Rohár wrote:
> PING? Documentation binding patch is waiting there fore two months.
> Could we move forward?
> 
> Note that meanwhile turris1x.dts which uses this was merged.
> 
> On Tuesday 05 July 2022 19:54:50 Marek Behún wrote:
> > Add binding for CPLD bus interface of Freescale P1021RDB Combo Board
> > CPLD Design.
> > 
> > Signed-off-by: Marek Behún <kabel@kernel.org>
> > ---
> >  .../bindings/bus/fsl,p1021rdb-pc-cpld.yaml    | 73 +++++++++++++++++++
> >  1 file changed, 73 insertions(+)
> >  create mode 100644 Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml
> > 
> > diff --git a/Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml b/Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml
> > new file mode 100644
> > index 000000000000..822dfb93dcd8
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml
> > @@ -0,0 +1,73 @@
> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > +%YAML 1.2
> > +---
> > +$id: http://devicetree.org/schemas/bus/fsl,p1021rdb-pc-cpld.yaml#
> > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > +
> > +title: CPLD Bus Inteface for Freescale P1021RDB Combo Board CPLD Design
> > +
> > +maintainers:
> > +  - Pali Rohár <pali@kernel.org>
> > +
> > +description: |
> > +  A simple bus enabling access to peripherals on boards with use Freescale
> > +  P1021RDB Combo Board CPLD Design.
> > +
> > +  The "fsl,p1021rdb-pc-cpld" follows the "simple-bus" set of properties, as
> > +  specified in the Devicetree Specification. It is an extension of "simple-bus"
> > +  because some registers are CPLD specific and allows to identify if board has
> > +  wired CPLD according to Freescale P1021RDB Combo Board CPLD Design.
> > +
> > +select:
> > +  properties:
> > +    compatible:
> > +      contains:
> > +        const: fsl,p1021rdb-pc-cpld
> > +  required:
> > +    - compatible
> > +
> > +properties:
> > +  $nodename:
> > +    pattern: "^cpld(@[0-9a-f]+(,[0-9a-f]+)?)?$"
> > +
> > +  compatible:
> > +    items:
> > +      - const: fsl,p1021rdb-pc-cpld
> > +      - const: simple-bus
> > +
> > +  '#address-cells':
> > +    enum: [ 1, 2 ]
> > +
> > +  '#size-cells':
> > +    enum: [ 1, 2 ]
> > +
> > +  reg:
> > +    maxItems: 1
> > +
> > +  ranges: true
> > +
> > +required:
> > +  - compatible
> > +  - '#address-cells'
> > +  - '#size-cells'
> > +  - reg
> > +  - ranges
> > +
> > +additionalProperties:
> > +  type: object
> > +
> > +examples:
> > +  - |
> > +
> > +    localbus {
> > +        #address-cells = <2>;
> > +        #size-cells = <1>;
> > +
> > +        cpld@3,0 {
> > +            #address-cells = <1>;
> > +            #size-cells = <1>;
> > +            compatible = "fsl,p1021rdb-pc-cpld", "simple-bus";
> > +            reg = <0x3 0x0 0x20000>;
> > +            ranges = <0x0 0x3 0x0 0x20000>;
> > +        };
> > +    };
> > -- 
> > 2.35.1
> >