xref: /linux/Documentation/process/maintainer-soc-clean-dts.rst (revision a34b0e4e21d6be3c3d620aa7f9dfbf0e9550c19e)
1.. SPDX-License-Identifier: GPL-2.0
2
3==============================================
4SoC Platforms with DTS Compliance Requirements
5==============================================
6
7Overview
8--------
9
10SoC platforms or subarchitectures should follow all the rules from
11Documentation/process/maintainer-soc.rst.  This document referenced in
12MAINTAINERS impose additional requirements listed below.
13
14Strict DTS DT Schema and dtc Compliance
15---------------------------------------
16
17No changes to the SoC platform Devicetree sources (DTS files) should introduce
18new ``make dtbs_check W=1`` warnings.  Warnings in a new board DTS, which are
19results of issues in an included DTSI file, are considered existing, not new
20warnings.  For series split between different trees (DT bindings go via driver
21subsystem tree), warnings on linux-next are decisive.  The platform maintainers
22have automation in place which should point out any new warnings.
23
24If a commit introducing new warnings gets accepted somehow, the resulting
25issues shall be fixed in reasonable time (e.g. within one release) or the
26commit reverted.
27