Documentation/process/maintainer-soc.rst

61 Devicetree ABI Stability
65 document the ABI between the devicetree and the kernel.
66 Please read Documentation/devicetree/bindings/ABI.rst.
68 If changes are being made to a devicetree that are incompatible with old
69 kernels, the devicetree patch should not be applied until the driver is, or an
78 A common problem is synchronizing changes between device drivers and devicetree
83 corresponding change to the devicetree binding description, to ensure they are
84 in fact compatible.  This means that the devicetree branch can end up causing
85 warnings in the "make dtbs_check" step.  If a devicetree change depends on
95 * Use literal values in the devicetree file in place of macros even when a
99 * Defer the devicetree changes to a release after the binding and driver have
103   both the driver change and the devicetree changes
105 * Add duplicate defines in the devicetree file guarded by an #ifndef section,
108 Devicetree Naming Convention
111 The general naming scheme for devicetree files is as follows.  The aspects of a
127 Validating Devicetree Files
130 ``make dtbs_check`` can be used to validate that devicetree files are compliant
132 "Running checks" of Documentation/devicetree/bindings/writing-schema.rst for
138 If in any doubt about a devicetree change, reach out to the devicetree
145 submaintainers will do the same. Driver, defconfig and devicetree changes should
159 SoC tree.  An example here would be one branch for devicetree warning fixes, one