[PATCH v2] dt-bindings: mailbox: Convert omap-mailbox.txt binding to YAML

[Suman Anna]

Hi Rob,

On 5/20/21 6:43 PM, Suman Anna wrote:
> Convert the current OMAP Mailbox binding from text format to YAML
> format/DT schema, and delete the legacy text binding file.
> 
> The new YAML binding conversion is an updated version compared to
> the original. The descriptions for certain properties have been
> improved to provide more clarity. Constraints are added to the
> properties 'ti,mbox-num-users', 'ti,mbox-num-fifos' and 'interrupts'.
> The 'ti,hwmods' is a legacy property and is retained only to reflect
> the existing usage on some older OMAP2 and OMAP3 platforms.
> 
> All the existing examples have also been updated to reflect the
> latest dts nodes (ti,hwmods removed from OMAP4 and AM33xx examples,
> and interrupts value updated for AM65x SoCs).
> 
> Signed-off-by: Suman Anna <s-anna at ti.com>
> ---
> v2: Address Rob's comments
>  - Replace definitions with $defs
>  - Dropping the trailing | character after all description keywords
>  - Marked ti,hwmods as deprecated
>  - Updated #mbox-cells description
> v1: 
> http://patchwork.ozlabs.org/project/devicetree-bindings/patch/20210518172022.10562-1-s-anna@ti.com/
> 
> Note that this would continue to generate the checkpatch warning
> "DT binding docs and includes should be a separate patch" for the
> deleted text file. The fixes for dtbs_check warnings on mailbox nodes
> with this yaml file are posted as well, please see v1 patch for links.
> 

Just following up on this, the mailbox nodes dtbs_check warning fixes are now
staged for v5.14, and are present in next as of next-20210528.

> regards
> Suman
> 
>  .../bindings/mailbox/omap-mailbox.txt         | 184 -----------
>  .../bindings/mailbox/ti,omap-mailbox.yaml     | 308 ++++++++++++++++++
>  2 files changed, 308 insertions(+), 184 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/mailbox/omap-mailbox.txt
>  create mode 100644 Documentation/devicetree/bindings/mailbox/ti,omap-mailbox.yaml
> 

[snip]

regards
Suman