dt: Add a check for undocumented compatible strings in kernel
authorRob Herring <robh@kernel.org>
Thu, 30 Jun 2022 21:37:22 +0000 (15:37 -0600)
committerRob Herring <robh@kernel.org>
Tue, 27 Sep 2022 15:36:16 +0000 (10:36 -0500)
commitb6acf807351781c3c3810df7873b3f0d793d59b2
treefff5e354658781909096294005007fdb1f9e51e7
parentd7c6ea024c08bbdb799768f51ffd9fdd6236d190
dt: Add a check for undocumented compatible strings in kernel

Add a make target, dt_compatible_check, to extract compatible strings
from kernel sources and check if they are documented by a schema.
At least version v2022.08 of dtschema with dt-check-compatible is
required.

This check can also be run manually on specific files or directories:

scripts/dtc/dt-extract-compatibles drivers/clk/ | \
  xargs dt-check-compatible -v -s Documentation/devicetree/bindings/processed-schema.json

Currently, there are about 3800 undocumented compatible strings. Most of
these are cases where the binding is not yet converted (given there
are 1900 .txt binding files remaining).

Link: https://lore.kernel.org/all/20220916012510.2718170-1-robh@kernel.org/
Signed-off-by: Rob Herring <robh@kernel.org>
Documentation/devicetree/bindings/Makefile
Makefile
scripts/dtc/dt-extract-compatibles [new file with mode: 0755]