dt-bindings: kbuild: Use DTB files for validation
authorRob Herring <robh@kernel.org>
Thu, 10 Mar 2022 16:05:13 +0000 (10:05 -0600)
committerRob Herring <robh@kernel.org>
Fri, 11 Mar 2022 17:16:16 +0000 (11:16 -0600)
commitef8795f3f1cef2b2d2cd5dfab3758a7601898bc9
tree849f097b6158fe664bfee30ba4ee8a024d877afa
parent2783a7f56f9980f61ca809b826bcd14dc77eb7b9
dt-bindings: kbuild: Use DTB files for validation

Switch the DT validation to use DTB files directly instead of a DTS to
YAML conversion.

The original motivation for supporting validation on DTB files was to
enable running validation on a running system (e.g. 'dt-validate
/sys/firmware/fdt') or other cases where the original source DTS is not
available.

The YAML format was not without issues. Using DTBs with the schema type
information solves some of those problems. The YAML format relies on the
DTS source level information including bracketing of properties, size
directives, and phandle tags all of which are lost in a DTB file. While
standardizing the bracketing is a good thing, it does cause a lot of
extra warnings and churn to fix them.

Another issue has been signed types are not validated correctly as sign
information is not propagated to YAML. Using the schema type information
allows for proper handling of signed types. YAML also can't represent
the full range of 64-bit integers as numbers are stored as floats by
most/all parsers.

The DTB validation works by decoding property values using the type
information in the schemas themselves. The main corner case this does
not work for is matrix types where neither dimension is fixed. For
now, checking the dimensions in these cases are skipped.

Signed-off-by: Rob Herring <robh@kernel.org>
Tested-by: Geert Uytterhoeven <geert+renesas@glider.be>
Link: https://lore.kernel.org/r/20220310160513.1708182-3-robh@kernel.org
Documentation/devicetree/bindings/Makefile
Documentation/devicetree/bindings/writing-schema.rst
scripts/Makefile.lib
scripts/dtc/Makefile
scripts/dtc/update-dtc-source.sh