linux/Documentation/devicetree/bindings/rtc
Arnaud Ebalard 298ff0122a rtc: rtc-isl12057: add isil,irq2-can-wakeup-machine property for in-tree users
Current in-tree users of ISL12057 RTC chip (NETGEAR ReadyNAS 102, 104 and
2120) do not have the IRQ#2 pin of the chip (associated w/ the Alarm1
mechanism) connected to their SoC, but to a PMIC (TPS65251 FWIW).  This
specific hardware configuration allows the NAS to wake up when the alarms
rings.

Recently introduced alarm support for ISL12057 relies on the provision of
an "interrupts" property in system .dts file, which previous three users
will never get.  For that reason, alarm support on those devices is not
function.  To support this use case, this patch adds a new DT property for
ISL12057 (isil,irq2-can-wakeup-machine) to indicate that the chip is
capable of waking up the device using its IRQ#2 pin (even though it does
not have its IRQ#2 pin connected directly to the SoC).

This specific configuration was tested on a ReadyNAS 102 by setting an
alarm, powering off the device and see it reboot as expected when the
alarm rang w/:

  # echo `date '+%s' -d '+ 1 minutes'` > /sys/class/rtc/rtc0/wakealarm
  # shutdown -h now

As a side note, the ISL12057 remains in the list of trivial devices,
because the property is not per se required by the device to work but can
help handle system w/ specific requirements.  In exchange, the new feature
is described in details in a specific documentation file.

Signed-off-by: Arnaud Ebalard <arno@natisbad.org>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Alessandro Zummo <a.zummo@towertech.it>
Cc: Peter Huewe <peter.huewe@infineon.com>
Cc: Linus Walleij <linus.walleij@linaro.org>
Cc: Thierry Reding <treding@nvidia.com>
Cc: Mark Brown <broonie@kernel.org>
Cc: Arnd Bergmann <arnd@arndb.de>
Cc: Darshana Padmadas <darshanapadmadas@gmail.com>
Cc: Rob Herring <rob.herring@calxeda.com>
Cc: Pawel Moll <pawel.moll@arm.com>
Cc: Stephen Warren <swarren@wwwdotorg.org>
Cc: Ian Campbell <ijc+devicetree@hellion.org.uk>
Cc: Grant Likely <grant.likely@linaro.org>
Cc: Rob Landley <rob@landley.net>
Cc: Jason Cooper <jason@lakedaemon.net>
Cc: Guenter Roeck <linux@roeck-us.net>
Cc: Jason Gunthorpe <jgunthorpe@obsidianresearch.com>
Cc: Kumar Gala <galak@codeaurora.org>
Cc: Uwe Kleine-König <uwe@kleine-koenig.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2015-02-13 21:21:42 -08:00
..
atmel,at91rm9200-rtc.txt rtc-at91rm9200: use shadow IMR on at91sam9x5 2013-06-12 16:29:46 -07:00
atmel,at91sam9-rtc.txt rtc: at91sam9: add DT bindings documentation 2014-11-13 16:08:48 +01:00
dallas,ds1339.txt Documentation: dt-bindings: trickle charger dt binding document for ds1339 2014-10-14 02:18:18 +02:00
dw-apb.txt dts: Rename DW APB timer compatible strings 2013-08-29 12:59:02 -07:00
haoyu,hym8563.txt drivers/rtc/rtc-hym8563.c: add optional clock-output-names property 2014-06-06 16:08:08 -07:00
imxdi-rtc.txt drivers/rtc/rtc-imxdi.c: add devicetree support 2012-12-17 17:15:20 -08:00
isil,isl12057.txt rtc: rtc-isl12057: add isil,irq2-can-wakeup-machine property for in-tree users 2015-02-13 21:21:42 -08:00
lpc32xx-rtc.txt drivers/rtc/rtc-lpc32xx.c: add device tree support 2012-05-29 16:22:34 -07:00
maxim,ds1742.txt drivers/rtc/rtc-ds1742.c: add devicetree support 2014-01-23 16:36:59 -08:00
moxa,moxart-rtc.txt rtc: add MOXA ART RTC driver 2013-09-11 15:58:54 -07:00
nvidia,tegra20-rtc.txt Documentation: DT bindings: add more Tegra chip compatible strings 2015-02-03 20:37:31 -06:00
nxp,rtc-2123.txt drivers/rtc/rtc-pcf2123.c: add support for devicetree 2015-02-13 21:21:42 -08:00
olpc-xo1-rtc.txt
orion-rtc.txt rtc: rtc-mv: Add the device tree binding documentation 2012-12-10 21:49:14 +00:00
pxa-rtc.txt RTC: add DT bindings to pxa-rtc 2012-08-16 16:13:07 +08:00
rtc-cmos.txt
rtc-omap.txt rtc: omap: drop vendor-prefix from power-controller dt property 2014-12-10 17:41:16 -08:00
rtc-opal.txt rtc/tpo: Driver to support rtc and wakeup on PowerNV platform 2014-11-17 18:04:01 +11:00
rtc-palmas.txt drivers/rtc/rtc-palmas.c: support for backup battery charging 2013-09-11 15:58:55 -07:00
s3c-rtc.txt rtc: s3c: add support for RTC of Exynos3250 SoC 2014-10-14 02:18:17 +02:00
sa1100-rtc.txt Document: devicetree: add OF documents for arch-mmp 2012-03-07 09:32:52 +08:00
snvs-rtc.txt rtc: snvs: add Freescale rtc-snvs driver 2012-10-06 03:05:01 +09:00
spear-rtc.txt rtc/spear: add Device Tree probing capability 2012-05-29 16:22:33 -07:00
stmp3xxx-rtc.txt rtc: stmp3xxx: Add simple binding for the stmp3xxx-rtc 2012-07-03 13:22:36 +08:00
sun6i-rtc.txt rtc: sun6i: Add sun6i RTC driver 2014-09-19 12:39:19 +02:00
sunxi-rtc.txt rtc: sunxi: change compatibles 2014-04-03 16:21:21 -07:00
twl-rtc.txt drivers/rtc/rtc-twl.c: add DT support for RTC inside twl4030/twl6030 2012-01-10 16:30:53 -08:00
via,vt8500-rtc.txt arm: vt8500: doc: Add device tree bindings for arch-vt8500 devices 2012-09-21 19:23:58 +12:00
xgene-rtc.txt Documentation/devicetree/bindings: add documentation for the APM X-Gene SoC RTC DTS binding 2014-06-06 16:08:06 -07:00