From: Andrew Jeffery <andrew@aj.id.au>
To: Lee Jones <lee.jones@linaro.org>
Cc: "Andrew Jeffery" <andrew@aj.id.au>,
"Rob Herring" <robh+dt@kernel.org>,
"Mark Rutland" <mark.rutland@arm.com>,
"Linus Walleij" <linus.walleij@linaro.org>,
"Corey Minyard" <minyard@acm.org>,
"Cédric Le Goater" <clg@kaod.org>,
"Joel Stanley" <joel@jms.id.au>,
devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
linux-kernel@vger.kernel.org
Subject: [PATCH v3 2/6] mfd: dt: ranges, #address-cells and #size-cells as optional properties
Date: Tue, 6 Dec 2016 13:53:17 +1100 [thread overview]
Message-ID: <20161206025321.1792-3-andrew@aj.id.au> (raw)
In-Reply-To: <20161206025321.1792-1-andrew@aj.id.au>
Whilst describing a device and not a bus, simple-mfd is modelled on
simple-bus where child nodes are iterated and registered as platform
devices. Some complex devices, e.g. the Aspeed LPC controller, can
benefit from address space mapping such that child nodes can use the
regs property to describe their resources within the multi-function
device.
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>
---
Documentation/devicetree/bindings/mfd/mfd.txt | 10 ++++++++++
1 file changed, 10 insertions(+)
diff --git a/Documentation/devicetree/bindings/mfd/mfd.txt b/Documentation/devicetree/bindings/mfd/mfd.txt
index f1fceeda12f1..bcb6abb9d413 100644
--- a/Documentation/devicetree/bindings/mfd/mfd.txt
+++ b/Documentation/devicetree/bindings/mfd/mfd.txt
@@ -25,6 +25,16 @@ Optional properties:
be used. In the latter case the child devices will be determined by the
operating system.
+- ranges: Describes the address mapping relationship to the parent. Should set
+ the child's base address to 0, the physical address within parent's address
+ space, and the length of the address map.
+
+- #address-cells: Specifies the number of cells used to represent physical base
+ addresses. Must be present if ranges is used.
+
+- #size-cells: Specifies the number of cells used to represent the size of an
+ address. Must be present if ranges is used.
+
Example:
foo@1000 {
--
2.9.3
next prev parent reply other threads:[~2016-12-06 2:53 UTC|newest]
Thread overview: 30+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-12-06 2:53 [PATCH v3 0/6] mfd: dt: Add bindings for the Aspeed MFDs Andrew Jeffery
2016-12-06 2:53 ` [PATCH v3 1/6] mfd: dt: Fix "indicates" typo in mfd bindings document Andrew Jeffery
[not found] ` <20161206025321.1792-2-andrew-zrmu5oMJ5Fs@public.gmane.org>
2016-12-07 15:08 ` Linus Walleij
2016-12-09 22:42 ` Rob Herring
2017-01-03 17:49 ` Lee Jones
2016-12-06 2:53 ` Andrew Jeffery [this message]
[not found] ` <20161206025321.1792-3-andrew-zrmu5oMJ5Fs@public.gmane.org>
2016-12-09 22:49 ` [PATCH v3 2/6] mfd: dt: ranges, #address-cells and #size-cells as optional properties Rob Herring
2016-12-09 22:55 ` Andrew Jeffery
2017-01-03 17:49 ` Lee Jones
2016-12-06 2:53 ` [PATCH v3 3/6] mfd: dt: Add Aspeed Low Pin Count Controller bindings Andrew Jeffery
2016-12-07 15:11 ` Linus Walleij
2016-12-08 2:07 ` Joel Stanley
2016-12-12 15:28 ` Rob Herring
[not found] ` <20161206025321.1792-4-andrew-zrmu5oMJ5Fs@public.gmane.org>
2017-01-03 17:49 ` Lee Jones
2016-12-06 2:53 ` [PATCH v3 4/6] mfd: dt: Add bindings for the Aspeed LPC Host Controller (LHC) Andrew Jeffery
[not found] ` <20161206025321.1792-5-andrew-zrmu5oMJ5Fs@public.gmane.org>
2016-12-07 15:12 ` Linus Walleij
2016-12-08 2:12 ` Joel Stanley
[not found] ` <CACPK8XfuZ14Ud3Kginut7f0-_-UjTB-=Pma-9WwNecF93k0Ktg-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2016-12-08 12:08 ` Andrew Jeffery
2016-12-12 15:30 ` Rob Herring
2016-12-13 4:40 ` Andrew Jeffery
2017-01-03 17:49 ` Lee Jones
2016-12-06 2:53 ` [PATCH v3 5/6] mfd: dt: Add bindings for the Aspeed SoC Display Controller (GFX) Andrew Jeffery
2017-01-03 17:49 ` Lee Jones
2016-12-06 2:53 ` [PATCH v3 6/6] mfd: dt: Move syscon bindings to syscon subdirectory Andrew Jeffery
[not found] ` <20161206025321.1792-7-andrew-zrmu5oMJ5Fs@public.gmane.org>
2016-12-12 15:39 ` Rob Herring
2016-12-13 4:53 ` Andrew Jeffery
2016-12-13 11:07 ` Lee Jones
2016-12-13 12:05 ` Andrew Jeffery
[not found] ` <1481630734.3112.40.camel-zrmu5oMJ5Fs@public.gmane.org>
2016-12-13 12:17 ` Arnd Bergmann
2016-12-13 12:39 ` Andrew Jeffery
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20161206025321.1792-3-andrew@aj.id.au \
--to=andrew@aj.id.au \
--cc=clg@kaod.org \
--cc=devicetree@vger.kernel.org \
--cc=joel@jms.id.au \
--cc=lee.jones@linaro.org \
--cc=linus.walleij@linaro.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mark.rutland@arm.com \
--cc=minyard@acm.org \
--cc=robh+dt@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).