Re: [PATCH] dt-bindings: mfd: atmel,at91sam9260: Convert to json schema

[<Charan.Pedumuru@microchip.com>]

On 16/12/24 15:44, Krzysztof Kozlowski wrote:
> EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe
>
> On Wed, Dec 11, 2024 at 04:59:22PM +0530, Charan Pedumuru wrote:
>> Convert old text based binding to json schema.
>> Changes during conversion:
>> Add a fallback for all compatibles as the IP core is compatible
>> with `syscon`.
> I don't understand. The syscon was already there. You added different
> fallback, so provide explanation why do you think they are compatible.

The old binding was misleading, `microchip,sam9x60-matrix` has a 
compatible `atmel,at91sam9x5-matrix` and `atmel,at91sam9x5-matrix` has a 
compatible `syscon`, which was missing in the old binding. I will add 
this to the commit message.

>
>> Signed-off-by: Charan Pedumuru <charan.pedumuru@microchip.com>
>> ---
>>   .../bindings/mfd/atmel,at91sam9260-matrix.yaml     | 54 ++++++++++++++++++++++
>>   .../devicetree/bindings/mfd/atmel-matrix.txt       | 26 -----------
>>   2 files changed, 54 insertions(+), 26 deletions(-)
>>
>> diff --git a/Documentation/devicetree/bindings/mfd/atmel,at91sam9260-matrix.yaml b/Documentation/devicetree/bindings/mfd/atmel,at91sam9260-matrix.yaml
>> new file mode 100644
>> index 000000000000..0e827882823f
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/mfd/atmel,at91sam9260-matrix.yaml
>> @@ -0,0 +1,54 @@
>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>> +%YAML 1.2
>> +---
>> +$id: http://devicetree.org/schemas/mfd/atmel,at91sam9260-matrix.yaml#
>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
>> +
>> +title: Microchip AT91 Bus Matrix
>> +
>> +maintainers:
>> +  - Nicolas Ferre <nicolas.ferre@microchip.com>
>> +
>> +description:
>> +  The Bus Matrix (MATRIX) implements a multi-layer AHB, based on the
>> +  AHB-Lite protocol, that enables parallel access paths between multiple
>> +  masters and slaves in a system, thus increasing the overall bandwidth.
>> +
>> +properties:
>> +  compatible:
>> +    anyOf:
> oneOf
> See other bindings for preferred syntax. There is never anyOf.

Yes, I will change that.

>
>> +      - items:
>> +          - enum:
>> +              - atmel,at91sam9260-matrix
>> +              - atmel,at91sam9261-matrix
>> +              - atmel,at91sam9263-matrix
>> +              - atmel,at91sam9rl-matrix
>> +              - atmel,at91sam9g45-matrix
>> +              - atmel,at91sam9n12-matrix
>> +              - atmel,at91sam9x5-matrix
>> +              - atmel,sama5d3-matrix
>> +          - const: syscon
>> +      - items:
>> +          - const: microchip,sam9x60-matrix
>> +          - const: atmel,at91sam9x5-matrix
>> +          - const: syscon
>> +      - items:
>> +          - const: microchip,sam9x7-matrix
> So that's just enum with previous group.

Yes, as both boards have 2 compatibles one after another, I defined them 
as two different groups to resolve dt_check warnings.

>
>
>> +          - const: atmel,at91sam9x5-matrix
>> +          - const: syscon
>> +
>> +  reg:
>> +    maxItems: 1
>> +
>> +required:
>> +  - compatible
>> +  - reg
>> +
>> +additionalProperties: false
>> +
>> +examples:
>> +  - |
>> +    matrix@ffffec00 {
> syscon@
> or system-controller@

Will use `syscon@` instead of  `matrix@` in next revision.

>
>
> Best regards,
> Krzysztof
>


-- 
Best Regards,
Charan.