Merge tag 'mvebu-fixes-5.9-1' of git://git.kernel.org/pub/scm/linux/kernel/git/gcleme...
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / mailbox / qcom,apcs-kpss-global.yaml
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: "http://devicetree.org/schemas/mailbox/qcom,apcs-kpss-global.yaml#"
5 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
6
7 title: Qualcomm APCS global block bindings
8
9 description:
10   This binding describes the APCS "global" block found in various Qualcomm
11   platforms.
12
13 maintainers:
14   - Sivaprakash Murugesan <sivaprak@codeaurora.org>
15
16 properties:
17   compatible:
18     enum:
19       - qcom,ipq6018-apcs-apps-global
20       - qcom,ipq8074-apcs-apps-global
21       - qcom,msm8916-apcs-kpss-global
22       - qcom,msm8994-apcs-kpss-global
23       - qcom,msm8996-apcs-hmss-global
24       - qcom,msm8998-apcs-hmss-global
25       - qcom,qcs404-apcs-apps-global
26       - qcom,sc7180-apss-shared
27       - qcom,sdm660-apcs-hmss-global
28       - qcom,sdm845-apss-shared
29       - qcom,sm8150-apss-shared
30
31   reg:
32     maxItems: 1
33
34   clocks:
35     description: phandles to the parent clocks of the clock driver
36     items:
37       - description: primary pll parent of the clock driver
38       - description: auxiliary parent
39
40   '#mbox-cells':
41     const: 1
42
43   '#clock-cells':
44     const: 0
45
46   clock-names:
47     items:
48       - const: pll
49       - const: aux
50
51 required:
52   - compatible
53   - reg
54   - '#mbox-cells'
55
56 additionalProperties: false
57
58 examples:
59
60   # Example apcs with msm8996
61   - |
62     #include <dt-bindings/interrupt-controller/arm-gic.h>
63     apcs_glb: mailbox@9820000 {
64         compatible = "qcom,msm8996-apcs-hmss-global";
65         reg = <0x9820000 0x1000>;
66
67         #mbox-cells = <1>;
68     };
69
70     rpm-glink {
71         compatible = "qcom,glink-rpm";
72         interrupts = <GIC_SPI 168 IRQ_TYPE_EDGE_RISING>;
73         qcom,rpm-msg-ram = <&rpm_msg_ram>;
74         mboxes = <&apcs_glb 0>;
75         mbox-names = "rpm_hlos";
76     };
77
78   # Example apcs with qcs404
79   - |
80     #define GCC_APSS_AHB_CLK_SRC  1
81     #define GCC_GPLL0_AO_OUT_MAIN 123
82     apcs: mailbox@b011000 {
83         compatible = "qcom,qcs404-apcs-apps-global";
84         reg = <0x0b011000 0x1000>;
85         #mbox-cells = <1>;
86         clocks = <&apcs_hfpll>, <&gcc GCC_GPLL0_AO_OUT_MAIN>;
87         clock-names = "pll", "aux";
88         #clock-cells = <0>;
89     };