Skip to content

Commit

Permalink
dt: submitting-patches: Document requirements for DT schema
Browse files Browse the repository at this point in the history
Update the DT submitting-patches.txt with additional requirements for DT
binding schemas. New binding documents should generally use the schema
format and have an explicit license.

Signed-off-by: Rob Herring <robh@kernel.org>
  • Loading branch information
Rob Herring committed Oct 25, 2019
1 parent 7054c20 commit 70145d1
Showing 1 changed file with 16 additions and 5 deletions.
21 changes: 16 additions & 5 deletions Documentation/devicetree/bindings/submitting-patches.txt
Original file line number Diff line number Diff line change
Expand Up @@ -15,25 +15,36 @@ I. For patch submitters
use "Documentation" or "doc" because that is implied. All bindings are
docs. Repeating "binding" again should also be avoided.

2) Submit the entire series to the devicetree mailinglist at
2) DT binding files are written in DT schema format using json-schema
vocabulary and YAML file format. The DT binding files must pass validation
by running:

make dt_binding_check

See ../writing-schema.rst for more details about schema and tools setup.

3) DT binding files should be dual licensed. The preferred license tag is
(GPL-2.0-only OR BSD-2-Clause).

4) Submit the entire series to the devicetree mailinglist at

devicetree@vger.kernel.org

and Cc: the DT maintainers. Use scripts/get_maintainer.pl to identify
all of the DT maintainers.

3) The Documentation/ portion of the patch should come in the series before
5) The Documentation/ portion of the patch should come in the series before
the code implementing the binding.

4) Any compatible strings used in a chip or board DTS file must be
6) Any compatible strings used in a chip or board DTS file must be
previously documented in the corresponding DT binding text file
in Documentation/devicetree/bindings. This rule applies even if
the Linux device driver does not yet match on the compatible
string. [ checkpatch will emit warnings if this step is not
followed as of commit bff5da4335256513497cc8c79f9a9d1665e09864
("checkpatch: add DT compatible string documentation checks"). ]

5) The wildcard "<chip>" may be used in compatible strings, as in
7) The wildcard "<chip>" may be used in compatible strings, as in
the following example:

- compatible: Must contain '"nvidia,<chip>-pcie",
Expand All @@ -42,7 +53,7 @@ I. For patch submitters
As in the above example, the known values of "<chip>" should be
documented if it is used.

6) If a documented compatible string is not yet matched by the
8) If a documented compatible string is not yet matched by the
driver, the documentation should also include a compatible
string that is matched by the driver (as in the "nvidia,tegra20-pcie"
example above).
Expand Down

0 comments on commit 70145d1

Please sign in to comment.