From: Rob Herring <robh@kernel.org>
To: Franklin S Cooper Jr <fcooper@ti.com>
Cc: thierry.reding@gmail.com, pawel.moll@arm.com,
mark.rutland@arm.com, ijc+devicetree@hellion.org.uk,
galak@codeaurora.org, bcousson@baylibre.com, tony@atomide.com,
linux@arm.linux.org.uk, t-kristo@ti.com, mturquette@baylibre.com,
sboyd@codeaurora.org, linux-pwm@vger.kernel.org,
devicetree@vger.kernel.org, linux-kernel@vger.kernel.org,
linux-omap@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
linux-clk@vger.kernel.org
Subject: Re: [PATCH 4/5] pwm: pwm-tipwmss: Update documentation to use empty range property
Date: Thu, 17 Mar 2016 10:01:40 -0500 [thread overview]
Message-ID: <20160317150140.GA25775@rob-hp-laptop> (raw)
In-Reply-To: <1457380318-15452-5-git-send-email-fcooper@ti.com>
On Mon, Mar 07, 2016 at 01:51:57PM -0600, Franklin S Cooper Jr wrote:
> Since the PWMSS and its subdevices (eCAP and ePWM) use the same address
> space then the range property should be empty. Update the documentation
> to show the correct usage.
Why does it matter? An empty ranges is generally not preferred.
>
> Signed-off-by: Franklin S Cooper Jr <fcooper@ti.com>
> ---
> Documentation/devicetree/bindings/pwm/pwm-tipwmss.txt | 12 ++++--------
> 1 file changed, 4 insertions(+), 8 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/pwm/pwm-tipwmss.txt b/Documentation/devicetree/bindings/pwm/pwm-tipwmss.txt
> index f7eae77..672fa71 100644
> --- a/Documentation/devicetree/bindings/pwm/pwm-tipwmss.txt
> +++ b/Documentation/devicetree/bindings/pwm/pwm-tipwmss.txt
> @@ -7,11 +7,9 @@ Required properties:
> Should set to 1.
> - size-cells: specify number of u32 entries needed to specify child nodes size
> in reg property. Should set to 1.
> -- ranges: describes the address mapping of a memory-mapped bus. Should set to
> - physical address map of child's base address, physical address within
> - parent's address space and length of the address map. For am33xx,
> - 3 set of child register maps present, ECAP register space, EQEP
> - register space, EHRPWM register space.
> +- ranges: describes the address mapping of a memory-mapped bus. Its value
> + should be empty since no address translation is needed between the
> + parent and the child.
>
> Also child nodes should also populated under PWMSS DT node.
>
> @@ -23,9 +21,7 @@ pwmss0: pwmss@48300000 {
> #address-cells = <1>;
> #size-cells = <1>;
> status = "disabled";
> - ranges = <0x48300100 0x48300100 0x80 /* ECAP */
> - 0x48300180 0x48300180 0x80 /* EQEP */
> - 0x48300200 0x48300200 0x80>; /* EHRPWM */
> + ranges;
>
> /* child nodes go here */
> };
> --
> 2.7.0
>
next prev parent reply other threads:[~2016-03-17 15:01 UTC|newest]
Thread overview: 18+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-03-07 19:51 [PATCH 0/5] ARM: am335x/am437x: Correct pwm bindings Franklin S Cooper Jr
2016-03-07 19:51 ` [PATCH 1/5] clk: ti: am335x/am4372: Add tbclk to pwm node Franklin S Cooper Jr
2016-04-16 0:46 ` Stephen Boyd
2016-03-07 19:51 ` [PATCH 2/5] ARM: DTS: da850/am4372/am33xx: Use generic node name for ehrpwm Franklin S Cooper Jr
2016-03-07 19:51 ` [PATCH 3/5] ARM: DTS: am33xx: Set pwmss ranges property to an empty value Franklin S Cooper Jr
2016-03-07 19:51 ` [PATCH 4/5] pwm: pwm-tipwmss: Update documentation to use empty range property Franklin S Cooper Jr
2016-03-17 15:01 ` Rob Herring [this message]
2016-03-17 16:56 ` Franklin S Cooper Jr.
2016-03-17 21:29 ` Franklin S Cooper Jr.
2016-03-07 19:51 ` [PATCH 5/5] pwm: pwm-tiehrpwm: Update dt binding document to use generic node name Franklin S Cooper Jr
2016-03-17 15:03 ` Rob Herring
2016-03-17 16:49 ` Franklin S Cooper Jr.
2016-03-17 18:00 ` Rob Herring
2016-03-17 18:20 ` Franklin S Cooper Jr.
2016-03-17 18:56 ` Rob Herring
2016-03-17 19:25 ` Franklin S Cooper Jr.
2016-03-17 19:48 ` Rob Herring
2016-03-17 19:51 ` Franklin S Cooper Jr.
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=20160317150140.GA25775@rob-hp-laptop \
--to=robh@kernel.org \
--cc=bcousson@baylibre.com \
--cc=devicetree@vger.kernel.org \
--cc=fcooper@ti.com \
--cc=galak@codeaurora.org \
--cc=ijc+devicetree@hellion.org.uk \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-clk@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-omap@vger.kernel.org \
--cc=linux-pwm@vger.kernel.org \
--cc=linux@arm.linux.org.uk \
--cc=mark.rutland@arm.com \
--cc=mturquette@baylibre.com \
--cc=pawel.moll@arm.com \
--cc=sboyd@codeaurora.org \
--cc=t-kristo@ti.com \
--cc=thierry.reding@gmail.com \
--cc=tony@atomide.com \
/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).