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 <redacted>
---
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