From: Peter Chen <hzpeterchen@gmail.com>
To: Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
"Rafael J. Wysocki" <rafael@kernel.org>
Cc: "Rafael J. Wysocki" <rafael@kernel.org>,
Peter Chen <peter.chen@nxp.com>,
Alan Stern <stern@rowland.harvard.edu>,
Ulf Hansson <ulf.hansson@linaro.org>,
Mark Brown <broonie@kernel.org>,
Sebastian Reichel <sre@kernel.org>,
Rob Herring <robh+dt@kernel.org>, Shawn Guo <shawnguo@kernel.org>,
"Rafael J. Wysocki" <rjw@rjwysocki.net>,
Dmitry Eremin-Solenikov <dbaryshkov@gmail.com>,
Heiko Stuebner <heiko@sntech.de>,
"linux-arm-kernel@lists.infradead.org"
<linux-arm-kernel@lists.infradead.org>,
p.zabel@pengutronix.de,
"devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
Pawel Moll <pawel.moll@arm.com>,
Mark Rutland <mark.rutland@arm.com>,
"open list:ULTRA-WIDEBAND (UWB) SUBSYSTEM:"
<linux-usb@vger.kernel.org>, Arnd Bergmann <arnd@arndb.de>,
Sascha Hauer <s.hauer@pengutronix.de>,
mail@maciej.szmigiero.name, troy.kisky@boundarydevices.com,
Fabio Estevam <festevam@gmail.com>,
oscar@naiandei.net, Stephen Boyd <stephen.boyd@linaro.org>,
Linux PM <linux-pm@vger.kernel.org>,
Joshua Clayton <stillcompiling@gmail.com>,
Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
mka@chromium.org, Vaibhav Hiremath <vaibhav.hiremath@linaro.org>,
Gary Bisson <gary.bisson@boundarydevices.com>,
hverkuil@xs4all.nl, Krzysztof Kozlowski <krzk@kernel.org>
Subject: Re: [PATCH 2/8] power: add power sequence library
Date: Fri, 3 Feb 2017 16:16:15 +0800 [thread overview]
Message-ID: <20170203081614.GA24614@b29397-desktop> (raw)
In-Reply-To: <20170201080817.GD17968@kroah.com>
On Wed, Feb 01, 2017 at 09:08:17AM +0100, Greg Kroah-Hartman wrote:
> On Wed, Feb 01, 2017 at 12:10:17AM +0100, Rafael J. Wysocki wrote:
> > On Tue, Jan 3, 2017 at 7:33 AM, Peter Chen <peter.chen@nxp.com> wrote:
> > > We have an well-known problem that the device needs to do some power
> > > sequence before it can be recognized by related host, the typical
> > > example like hard-wired mmc devices and usb devices.
> > >
> > > This power sequence is hard to be described at device tree and handled by
> > > related host driver, so we have created a common power sequence
> > > library to cover this requirement. The core code has supplied
> > > some common helpers for host driver, and individual power sequence
> > > libraries handle kinds of power sequence for devices. The pwrseq
> > > librares always need to allocate extra instance for compatible
> > > string match.
> > >
> > > pwrseq_generic is intended for general purpose of power sequence, which
> > > handles gpios and clocks currently, and can cover other controls in
> > > future. The host driver just needs to call of_pwrseq_on/of_pwrseq_off
> > > if only one power sequence is needed, else call of_pwrseq_on_list
> > > /of_pwrseq_off_list instead (eg, USB hub driver).
> > >
> > > For new power sequence library, it can add its compatible string
> > > to pwrseq_of_match_table, then the pwrseq core will match it with
> > > DT's, and choose this library at runtime.
> > >
> > > Signed-off-by: Peter Chen <peter.chen@nxp.com>
> > > Tested-by: Maciej S. Szmigiero <mail@maciej.szmigiero.name>
> > > Tested-by Joshua Clayton <stillcompiling@gmail.com>
> > > Reviewed-by: Matthias Kaehlcke <mka@chromium.org>
> > > Tested-by: Matthias Kaehlcke <mka@chromium.org>
> >
> > Quite honestly, I have a really hard time with trying to follow this
> > code and the total lack of documentation makes it even harder.
Sorry about that, Is it ok I add the design doc at:
Documentation/power/power-sequence/design.rst?
> > particular, the generic power sequence code is not even commented at
> > all,
The generic power sequence code just implements the APIs which are
called at power/pwrseq/core.c, and those API are commented at
include/linux/power/pwrseq.h. Anyway, I will add more comments at it.
--
Best Regards,
Peter Chen
next prev parent reply other threads:[~2017-02-03 8:16 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-01-03 6:33 [PATCH 0/8] power: add power sequence library Peter Chen
2017-01-03 6:33 ` [PATCH 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic " Peter Chen
2017-01-03 6:33 ` [PATCH 2/8] power: add " Peter Chen
2017-01-31 23:10 ` Rafael J. Wysocki
2017-02-01 8:08 ` Greg Kroah-Hartman
2017-02-03 8:16 ` Peter Chen [this message]
2017-02-03 21:14 ` Rafael J. Wysocki
2017-02-04 1:56 ` Peter Chen
2017-01-03 6:33 ` [PATCH 3/8] binding-doc: usb: usb-device: add optional properties for power sequence Peter Chen
2017-01-03 6:33 ` [PATCH 4/8] usb: core: add power sequence handling for USB devices Peter Chen
2017-01-03 6:33 ` [PATCH 5/8] usb: chipidea: let chipidea core device of_node equal's glue layer device of_node Peter Chen
2017-01-03 6:33 ` [PATCH 6/8] ARM: dts: imx6qdl: Enable usb node children with <reg> Peter Chen
2017-01-03 6:33 ` [PATCH 7/8] ARM: dts: imx6qdl-udoo.dtsi: fix onboard USB HUB property Peter Chen
2017-01-03 6:33 ` [PATCH 8/8] ARM: dts: imx6q-evi: Fix onboard hub reset line Peter Chen
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=20170203081614.GA24614@b29397-desktop \
--to=hzpeterchen@gmail.com \
--cc=arnd@arndb.de \
--cc=broonie@kernel.org \
--cc=dbaryshkov@gmail.com \
--cc=devicetree@vger.kernel.org \
--cc=festevam@gmail.com \
--cc=gary.bisson@boundarydevices.com \
--cc=gregkh@linuxfoundation.org \
--cc=heiko@sntech.de \
--cc=hverkuil@xs4all.nl \
--cc=krzk@kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-pm@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=mail@maciej.szmigiero.name \
--cc=mark.rutland@arm.com \
--cc=mka@chromium.org \
--cc=oscar@naiandei.net \
--cc=p.zabel@pengutronix.de \
--cc=pawel.moll@arm.com \
--cc=peter.chen@nxp.com \
--cc=rafael@kernel.org \
--cc=rjw@rjwysocki.net \
--cc=robh+dt@kernel.org \
--cc=s.hauer@pengutronix.de \
--cc=shawnguo@kernel.org \
--cc=sre@kernel.org \
--cc=stephen.boyd@linaro.org \
--cc=stern@rowland.harvard.edu \
--cc=stillcompiling@gmail.com \
--cc=troy.kisky@boundarydevices.com \
--cc=ulf.hansson@linaro.org \
--cc=vaibhav.hiremath@linaro.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).