17ee9e21cSNobuhiro Iwamatsu# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
27ee9e21cSNobuhiro Iwamatsu%YAML 1.2
37ee9e21cSNobuhiro Iwamatsu---
47ee9e21cSNobuhiro Iwamatsu$id: http://devicetree.org/schemas/power/reset/xlnx,zynqmp-power.yaml#
57ee9e21cSNobuhiro Iwamatsu$schema: http://devicetree.org/meta-schemas/core.yaml#
67ee9e21cSNobuhiro Iwamatsu
7a612130cSKrzysztof Kozlowskititle: Xilinx Zynq MPSoC Power Management
87ee9e21cSNobuhiro Iwamatsu
97ee9e21cSNobuhiro Iwamatsumaintainers:
10*d5c421d2SMichal Simek  - Michal Simek <michal.simek@amd.com>
117ee9e21cSNobuhiro Iwamatsu
127ee9e21cSNobuhiro Iwamatsudescription: |
137ee9e21cSNobuhiro Iwamatsu  The zynqmp-power node describes the power management configurations.
147ee9e21cSNobuhiro Iwamatsu  It will control remote suspend/shutdown interfaces.
157ee9e21cSNobuhiro Iwamatsu
167ee9e21cSNobuhiro Iwamatsuproperties:
177ee9e21cSNobuhiro Iwamatsu  compatible:
187ae0d493SKrzysztof Kozlowski    const: xlnx,zynqmp-power
197ee9e21cSNobuhiro Iwamatsu
207ee9e21cSNobuhiro Iwamatsu  interrupts:
217ee9e21cSNobuhiro Iwamatsu    maxItems: 1
227ee9e21cSNobuhiro Iwamatsu
237ee9e21cSNobuhiro Iwamatsu  mboxes:
247ee9e21cSNobuhiro Iwamatsu    description: |
257ee9e21cSNobuhiro Iwamatsu      Standard property to specify a Mailbox. Each value of
267ee9e21cSNobuhiro Iwamatsu      the mboxes property should contain a phandle to the
277ee9e21cSNobuhiro Iwamatsu      mailbox controller device node and an args specifier
287ee9e21cSNobuhiro Iwamatsu      that will be the phandle to the intended sub-mailbox
297ee9e21cSNobuhiro Iwamatsu      child node to be used for communication. See
307ee9e21cSNobuhiro Iwamatsu      Documentation/devicetree/bindings/mailbox/mailbox.txt
317ee9e21cSNobuhiro Iwamatsu      for more details about the generic mailbox controller
327ee9e21cSNobuhiro Iwamatsu      and client driver bindings. Also see
337ee9e21cSNobuhiro Iwamatsu      Documentation/devicetree/bindings/mailbox/ \
347ee9e21cSNobuhiro Iwamatsu      xlnx,zynqmp-ipi-mailbox.txt for typical controller that
357ee9e21cSNobuhiro Iwamatsu      is used to communicate with this System controllers.
367ee9e21cSNobuhiro Iwamatsu    items:
377ee9e21cSNobuhiro Iwamatsu      - description: tx channel
387ee9e21cSNobuhiro Iwamatsu      - description: rx channel
397ee9e21cSNobuhiro Iwamatsu
407ee9e21cSNobuhiro Iwamatsu  mbox-names:
417ee9e21cSNobuhiro Iwamatsu    description:
427ee9e21cSNobuhiro Iwamatsu      Name given to channels seen in the 'mboxes' property.
437ee9e21cSNobuhiro Iwamatsu    items:
447ee9e21cSNobuhiro Iwamatsu      - const: tx
457ee9e21cSNobuhiro Iwamatsu      - const: rx
467ee9e21cSNobuhiro Iwamatsu
477ee9e21cSNobuhiro Iwamatsurequired:
487ee9e21cSNobuhiro Iwamatsu  - compatible
497ee9e21cSNobuhiro Iwamatsu  - interrupts
507ee9e21cSNobuhiro Iwamatsu
517ee9e21cSNobuhiro IwamatsuadditionalProperties: false
527ee9e21cSNobuhiro Iwamatsu
537ee9e21cSNobuhiro Iwamatsuexamples:
547ee9e21cSNobuhiro Iwamatsu  - |+
557ee9e21cSNobuhiro Iwamatsu
567ee9e21cSNobuhiro Iwamatsu    // Example with interrupt method:
577ee9e21cSNobuhiro Iwamatsu
587ee9e21cSNobuhiro Iwamatsu    firmware {
597ee9e21cSNobuhiro Iwamatsu      zynqmp-firmware {
607ee9e21cSNobuhiro Iwamatsu        zynqmp-power {
617ee9e21cSNobuhiro Iwamatsu          compatible = "xlnx,zynqmp-power";
627ee9e21cSNobuhiro Iwamatsu          interrupts = <0 35 4>;
637ee9e21cSNobuhiro Iwamatsu        };
647ee9e21cSNobuhiro Iwamatsu      };
657ee9e21cSNobuhiro Iwamatsu    };
667ee9e21cSNobuhiro Iwamatsu
677ee9e21cSNobuhiro Iwamatsu  - |+
687ee9e21cSNobuhiro Iwamatsu
697ee9e21cSNobuhiro Iwamatsu    // Example with IPI mailbox method:
707ee9e21cSNobuhiro Iwamatsu
717ee9e21cSNobuhiro Iwamatsu    firmware {
727ee9e21cSNobuhiro Iwamatsu      zynqmp-firmware {
737ee9e21cSNobuhiro Iwamatsu        zynqmp-power {
747ee9e21cSNobuhiro Iwamatsu          compatible = "xlnx,zynqmp-power";
757ee9e21cSNobuhiro Iwamatsu          interrupt-parent = <&gic>;
767ee9e21cSNobuhiro Iwamatsu          interrupts = <0 35 4>;
777ee9e21cSNobuhiro Iwamatsu          mboxes = <&ipi_mailbox_pmu1 0>,
787ee9e21cSNobuhiro Iwamatsu                   <&ipi_mailbox_pmu1 1>;
797ee9e21cSNobuhiro Iwamatsu          mbox-names = "tx", "rx";
807ee9e21cSNobuhiro Iwamatsu        };
817ee9e21cSNobuhiro Iwamatsu      };
827ee9e21cSNobuhiro Iwamatsu    };
837ee9e21cSNobuhiro Iwamatsu...
84