From mboxrd@z Thu Jan 1 00:00:00 1970 From: Grant Likely Subject: Re: [PATCH] Clarify DTB section preable Date: Tue, 12 Dec 2017 11:21:43 +0000 Message-ID: References: <20171212110836.31537-1-grant.likely@arm.com> Mime-Version: 1.0 Return-path: DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=secretlab-ca.20150623.gappssmtp.com; s=20150623; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc; bh=kzHclQEv+dcnmmuNeE2x0vwU8sPncWlvcE9H8Twmt/s=; b=KOWuo1VvG3+9vclYL4GSi5PrhJTEEQmuHbewicbEMuUOoHcvESzAPTc/zLtM0njp5S 5FzoqNffX46KzZEKpdAgqkeHSao2mrYyCmcy7yu+tO1MBpoGr8HBvebseht28IsQVJUG INq3mg2tmTupKoFPzBY4YEHNK38RN35fnohieSj0FcOgi68kmGWEpYwWz3dw6Px6v6Xy yxyDSv8klTasHeQ8bvsyXAR/au4kjm7pIncnN0f0frEdoZhfiyntQo89qzda+qUyaVIy QvaPDe6CzauH48BxprvauIz45yDvQyaETRAph2macr/LKak9UZ1oCchn5cxa7XBGzd0e KhKA== In-Reply-To: <20171212110836.31537-1-grant.likely-5wv7dgnIgG8@public.gmane.org> Sender: devicetree-spec-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org List-ID: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: devicetree-spec-u79uwXL29TY76Z2rM5mHXA@public.gmane.org Cc: Grant Likely On Tue, Dec 12, 2017 at 11:08 AM, Grant Likely wrote: > The DTB chapter used to be titled the "Flattened Devicetree Structure" > chapter, but that seems to be unclear when it is talking about a > specific encoding of devicetree. In this case, the encoding is 'dtb'. > The source format chapter specifies "DTS", so change the start of this > chapter to line up with the DTS chapter. > > At the same time, update the introduction to include the source format > chapter. > > Signed-off-by: Grant Likely > --- > source/flattened-format.rst | 17 ++++++++++++----- > source/source-language.rst | 2 +- > 2 files changed, 13 insertions(+), 6 deletions(-) > > diff --git a/source/flattened-format.rst b/source/flattened-format.rst > index a1c358e..bd98891 100644 > --- a/source/flattened-format.rst > +++ b/source/flattened-format.rst > @@ -1,13 +1,20 @@ > .. _chapter-fdt-structure: > > -Flat Devicetree Physical Structure > +Flattened Devicetree (DTB) Format > ================================== > > -With the exception of platforms using IEEE1275 Open Firmware [IEEE1275], the > -devicetree data is contained within a single, linear, pointerless data structure > -known as the flattened devicetree or devicetree blob. > +The Devicetree Blob (DTB) format is a flat binary encoding of devicetree data. > +It used to exchange devicetree data between software programs. > +For example, when booting an operating system, firmware will pass a DTB to the OS kernel. > > -This data structure consists of a small header > +.. note:: > + > + IEEE1275 Open Firmware [IEEE1275] does not define the DTB format. > + On most Open Firmware compliant platforms the devicetree is extracted by calling firmware methods > + to walk through the tree structure. > + > +The DTB format encodes the devicetree data within a single, linear, pointerless data structure. > +It consists of a small header > (see section :ref:`sect-fdt-header`), > followed by three variable sized sections: > the memory reservation block (see section :ref:`sect-fdt-memory-reservation-block`), > diff --git a/source/source-language.rst b/source/source-language.rst > index fd6f8af..8dd9710 100755 > --- a/source/source-language.rst > +++ b/source/source-language.rst > @@ -1,6 +1,6 @@ > .. _chapter-devicetree-source-format: > > -Devicetree Source Format (version 1) > +Devicetree Source (DTS) Format (version 1) > ================================================ > > The Devicetree Source (DTS) format is a textual representation of a > -- Oops, this hunk got omitted from the patch: diff --git a/source/introduction.rst b/source/introduction.rst index d7dc2fc..8105c4f 100644 --- a/source/introduction.rst +++ b/source/introduction.rst @@ -55,8 +55,8 @@ may include: devicetrees. * Chapter :ref:`chapter-device-bindings` describes device bindings for certain classes of devices and specific device types. -* Chapter :ref:`chapter-fdt-structure` specifies the physical structure - of devicetrees. +* Chapter :ref:`chapter-fdt-structure` specifies the DTB encoding of devicetrees. +* Chapter :ref:`chapter-devicetree-source-format` specifies the DTS source language. **Conventions Used in this Document** > 2.11.0 >