devicetree/bindings/submitting-patches.rst

1 .. SPDX-License-Identifier: GPL-2.0
4 Submitting Devicetree (DT) binding patches
11      Documentation/process/submitting-patches.rst applies.
13   1) The Documentation/ and include/dt-bindings/ portion of the patch should
14      be a separate patch. The preferred subject prefix for binding patches is::
16        "dt-bindings: <binding dir>: ..."
21        "<binding dir>: dt-bindings: ..."
25      docs. Repeating "binding" again should also be avoided.
27   2) DT binding files are written in DT schema format using json-schema
28      vocabulary and YAML file format. The DT binding files must pass validation
33      See Documentation/devicetree/bindings/writing-schema.rst for more details
36   3) DT binding files should be dual licensed. The preferred license tag is
37      (GPL-2.0-only OR BSD-2-Clause).
43      and Cc: the DT maintainers. Use scripts/get_maintainer.pl to identify
44      all of the DT maintainers.
47      the code implementing the binding.
50      previously documented in the corresponding DT binding file
55      ("checkpatch: add DT compatible string documentation checks"). ]
68   1) If you aren't comfortable reviewing a given binding, reply to it and ask
73      binding, and it hasn't received an Acked-by from the devicetree
79   3) For a series going though multiple trees, the binding patch should be
80      kept with the driver using the binding.