74 lines · plain
1Specifying wakeup capability for devices2============================================3 4Any device nodes5----------------6Nodes that describe devices which have wakeup capability may contain a7"wakeup-source" boolean property.8 9If the device is marked as a wakeup-source, interrupt wake capability depends10on the device specific "interrupt-names" property. If no interrupts are labeled11as wake capable, then it is up to the device to determine which interrupts can12wake the system.13 14However if a device has a dedicated interrupt as the wakeup source, then it15needs to specify/identify it using a device specific interrupt name. In such16cases only that interrupt can be used as a wakeup interrupt.17 18While various legacy interrupt names exist, new devices should use "wakeup" as19the canonical interrupt name.20 21List of legacy properties and respective binding document22---------------------------------------------------------23 241. "gpio-key,wakeup" Documentation/devicetree/bindings/input/gpio-keys{,-polled}.txt252. "has-tpo" Documentation/devicetree/bindings/rtc/rtc-opal.txt263. "linux,wakeup" Documentation/devicetree/bindings/input/gpio-matrix-keypad.txt27 Documentation/devicetree/bindings/mfd/tc3589x.txt28 Documentation/devicetree/bindings/input/touchscreen/ti,ads7843.yaml294. "linux,keypad-wakeup" Documentation/devicetree/bindings/input/qcom,pm8921-keypad.yaml305. "linux,input-wakeup" Documentation/devicetree/bindings/input/samsung,s3c6410-keypad.yaml316. "nvidia,wakeup-source" Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt32 33Examples34--------35 361. With "wakeup" interrupt name37 38 device@10000 {39 compatible = "vendor,device-id";40 reg = <0x10000 0x1000>;41 interrupts = <0 19 4>, <0 21 4>, <0 22 4>;42 interrupt-names = "ack", "err", "wakeup";43 wakeup-source;44 };45 462. Without "wakeup" interrupt name47 48 embedded-controller {49 compatible = "google,cros-ec-i2c";50 reg = <0x1e>;51 interrupts = <6 0>;52 interrupt-parent = <&gpx1>;53 pinctrl-names = "default";54 pinctrl-0 = <&ec_irq>;55 wakeup-source;56 };57 583. Without interrupts59 60 gpio_keys {61 compatible = "gpio-keys";62 #address-cells = <1>;63 #size-cells = <0>;64 65 button@1 {66 debounce-interval = <50>;67 wakeup-source;68 linux,code = <116>;69 label = "POWER";70 gpios = <&iofpga_gpio0 0 0x4>;71 };72 [....]73 };74