linux-kernel - Re: [PATCH v2] max77693: added device tree support

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <52128BAD.6020903@wwwdotorg.org>
Date:	Mon, 19 Aug 2013 15:18:37 -0600
From:	Stephen Warren <swarren@...dotorg.org>
To:	Andrzej Hajda <a.hajda@...sung.com>
CC:	Lee Jones <lee.jones@...aro.org>,
	Rob Herring <rob.herring@...xeda.com>,
	Pawel Moll <pawel.moll@....com>,
	Mark Rutland <mark.rutland@....com>,
	Ian Campbell <ian.campbell@...rix.com>,
	Rob Landley <rob@...dley.net>,
	Samuel Ortiz <sameo@...ux.intel.com>,
	Grant Likely <grant.likely@...aro.org>,
	Sylwester Nawrocki <s.nawrocki@...sung.com>,
	Jonghwa Lee <jonghwa3.lee@...sung.com>,
	Kyungmin Park <kyungmin.park@...sung.com>,
	"open list:OPEN FIRMWARE AND..." <devicetree@...r.kernel.org>,
	open list <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH v2] max77693: added device tree support

On 08/19/2013 05:40 AM, Andrzej Hajda wrote:
> max77693 mfd main device uses only wakeup field
> from max77693_platform_data. This field is mapped
> to wakeup-source common property in device tree.

> diff --git a/Documentation/devicetree/bindings/mfd/max77693.txt b/Documentation/devicetree/bindings/mfd/max77693.txt

>  Optional properties:
>  - regulators : The regulators of max77693 have to be instantiated under subnod
>    named "regulators" using the following format.
> +- wakeup-source : Indicates if the device can wakeup the system from the sleep
> +  state.

Does the property mean "can" or "should"?

"Can" implies that the property means something about the HW. What
exactly does it mean; perhaps that some specific output pin of the chip
has been wired to an input IRQ/GPIO of the SoC or PMIC that (can) wake
up the system? If so, which pin, signal, ...? Also, doesn't this also
depend on the SoC itself supporting its input IRQ/GPIO as a wakeup
source, so isn't some co-ordination required between the SoC and chip,
such that this property doesn't mean "can wakeup the system", but simply
"a signal is routed to the SoC, so perhaps it can wakeup the system".

"Should" implies policy, which probably shouldn't be represented in
device tree, since DT should describe the HW and not how it should be used.

Finally, if there was already a binding for max77693.txt, I don't think
the patch subject "added device tree support" is entirely accurate; this
change to the binding document seems to be more about adding a new
feature than adding DT support to the driver...
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/