From: Tom Rini Date: Wed, 5 Sep 2018 11:43:00 -0400 Subject: [U-Boot] [PATCH] dm: Update README.txt to clarify device tree usage In-Reply-To: References: <1535731151-27305-1-git-send-email-trini@konsulko.com> Message-ID: <20180905154300.GF26633@bill-the-cat> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: u-boot@lists.denx.de On Wed, Sep 05, 2018 at 09:24:44AM -0600, Simon Glass wrote: > Hi Tom, > > On 31 August 2018 at 09:59, Tom Rini wrote: > > In the section about Device Trees add a paragraph at the end that > > clarifies how we decide of a tree is valid or not. We say that all > > bindings must either be in the specification (link provided) or in our > > device-tree-bindings directory. We say that most of these come from the > > Linux Kernel and as such some design decisions are made for us already, > > but that in most cases we wish to retain compatibility. > > > > Cc: Simon Glass > > Cc: Bin Meng > > Signed-off-by: Tom Rini > > --- > > doc/driver-model/README.txt | 9 +++++++++ > > 1 file changed, 9 insertions(+) > > > > Reviewed-by: Simon Glass > > nits below > > > diff --git a/doc/driver-model/README.txt b/doc/driver-model/README.txt > > index d6fa5c485793..e949ff63bae4 100644 > > --- a/doc/driver-model/README.txt > > +++ b/doc/driver-model/README.txt > > @@ -449,6 +449,15 @@ The driver model tree is intended to mirror that of the device tree. The > > root driver is at device tree offset 0 (the root node, '/'), and its > > children are the children of the root node. > > > > +In order for a device tree to be valid, the content must be correct with > > +respect to either device tree specification > > +(https://www.devicetree.org/specifications/) or the device tree bindings that > > +are found in the doc/device-tree-bindings directory. When not U-Boot specific > > When not U-Boot-specific, > > > +the bindings in this directory tend to come from the Linux Kernel. As such > > +certain design decisions may have been made already for us in terms of how > > +specific devices are described and bound. In most circumstances we wish to > > +retain compatibility without additional changes being made to the device tree > > +source files. > > > > Declaring Uclasses > > ------------------ Thanks, I'll add the comma when I commit, barring further comments from people. -- Tom -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 819 bytes Desc: not available URL: