1 .. SPDX-License-Identifier: GPL-2.0
2
3 ===================
4 Devicetree (DT) ABI
5 ===================
6
7 I. Regarding stable bindings/ABI, we quote fro
8 summary document:
9
10 "That still leaves the question of, what
11 like? Certainly a stable binding means t
12 break on an older device tree, but that d
13 frozen for all time. Grant said there are
14 don't result in breakage. For instance, i
15 then default to the previous behaviour if
16 truly needs an incompatible change, then
17 at the same time. The driver can bind ag
18 new. These guidelines aren't new, but the
19 documented."
20
21 II. General binding rules
22
23 1) Maintainers, don't let perfect be the ene
24 binding because it isn't perfect.
25
26 2) Use specific compatible strings so that i
27 in the future, we can create a new compat
28
29 3) Bindings can be augmented, but the driver
30 the old binding. ie. add additional prope
31 meaning of an existing property. For driv
32 behaviour when a newly added property is
33
34 4) Don't submit bindings for staging or unst
35 the devicetree maintainers *after* discus
36
37 III. Notes
38
39 1) This document is intended as a general fa
40 decided at the 2013 Kernel Summit. When
41 devicetree maintainers overrules this doc
42 updating this document would be appreciat
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.