1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/remoteproc/ 4 $id: http://devicetree.org/schemas/remoteproc/qcom,smd-edge.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Qualcomm SMD Edge communication channel 7 title: Qualcomm SMD Edge communication channel nodes
8 8
9 maintainers: 9 maintainers:
10 - Bjorn Andersson <bjorn.andersson@linaro.org 10 - Bjorn Andersson <bjorn.andersson@linaro.org>
11 11
12 description: 12 description:
13 Qualcomm SMD subnode represents a remote sub 13 Qualcomm SMD subnode represents a remote subsystem or a remote processor of
14 some sort - or in SMD language an "edge". Th 14 some sort - or in SMD language an "edge". The name of the edges are not
15 important. 15 important.
16 <<
17 In turn, subnodes of the "edges" represent d <<
18 that "edge". The names of the devices are no <<
19 these nodes are defined by the individual bi <<
20 See also Documentation/devicetree/bindings/s 16 See also Documentation/devicetree/bindings/soc/qcom/qcom,smd.yaml
21 17
22 properties: 18 properties:
23 $nodename: 19 $nodename:
24 const: smd-edge !! 20 const: "smd-edge"
25 <<
26 apr: <<
27 $ref: /schemas/soc/qcom/qcom,apr.yaml# <<
28 required: <<
29 - qcom,smd-channels <<
30 description: <<
31 Qualcomm APR/GPR (Asynchronous/Generic P <<
32 <<
33 fastrpc: <<
34 $ref: /schemas/misc/qcom,fastrpc.yaml# <<
35 required: <<
36 - qcom,smd-channels <<
37 description: <<
38 Qualcomm FastRPC <<
39 21
40 interrupts: 22 interrupts:
41 maxItems: 1 23 maxItems: 1
42 24
43 label: 25 label:
44 description: 26 description:
45 Name of the edge, used for debugging and 27 Name of the edge, used for debugging and identification purposes. The
46 node name will be used if this is not pr 28 node name will be used if this is not present.
47 29
48 mboxes: 30 mboxes:
49 maxItems: 1 31 maxItems: 1
50 description: 32 description:
51 Reference to the mailbox representing th 33 Reference to the mailbox representing the outgoing doorbell in APCS for
52 this client. 34 this client.
53 35
54 qcom,ipc: 36 qcom,ipc:
55 $ref: /schemas/types.yaml#/definitions/pha 37 $ref: /schemas/types.yaml#/definitions/phandle-array
56 items: 38 items:
57 - items: 39 - items:
58 - description: phandle to a syscon n 40 - description: phandle to a syscon node representing the APCS registers
59 - description: u32 representing offs 41 - description: u32 representing offset to the register within the syscon
60 - description: u32 representing the 42 - description: u32 representing the ipc bit within the register
61 description: 43 description:
62 Three entries specifying the outgoing ip 44 Three entries specifying the outgoing ipc bit used for signaling the
63 remote processor. 45 remote processor.
64 deprecated: true <<
65 46
66 qcom,smd-edge: 47 qcom,smd-edge:
67 $ref: /schemas/types.yaml#/definitions/uin 48 $ref: /schemas/types.yaml#/definitions/uint32
68 description: 49 description:
69 The identifier of the remote processor i 50 The identifier of the remote processor in the smd channel allocation
70 table. 51 table.
71 52
72 qcom,remote-pid: 53 qcom,remote-pid:
73 $ref: /schemas/types.yaml#/definitions/uin 54 $ref: /schemas/types.yaml#/definitions/uint32
74 description: 55 description:
75 The identifier for the remote processor 56 The identifier for the remote processor as known by the rest of the
76 system. 57 system.
77 58
78 rpm-requests: <<
79 $ref: /schemas/soc/qcom/qcom,smd-rpm.yaml# <<
80 required: <<
81 - qcom,smd-channels <<
82 description: <<
83 Qualcomm Resource Power Manager (RPM) ov <<
84 <<
85 wcnss: <<
86 $ref: /schemas/soc/qcom/qcom,wcnss.yaml <<
87 required: <<
88 - qcom,smd-channels <<
89 description: <<
90 Qualcomm WCNSS for Bluetooth, WiFi and F <<
91 <<
92 required: 59 required:
93 - interrupts 60 - interrupts
94 - qcom,smd-edge 61 - qcom,smd-edge
95 62
96 oneOf: 63 oneOf:
97 - required: 64 - required:
98 - mboxes 65 - mboxes
99 - required: 66 - required:
100 - qcom,ipc 67 - qcom,ipc
101 68
102 additionalProperties: false !! 69 additionalProperties: true
103 70
104 examples: 71 examples:
105 - | 72 - |
106 #include <dt-bindings/interrupt-controller 73 #include <dt-bindings/interrupt-controller/arm-gic.h>
107 #include <dt-bindings/mailbox/qcom-ipcc.h> 74 #include <dt-bindings/mailbox/qcom-ipcc.h>
108 75
109 remoteproc { 76 remoteproc {
110 // ... 77 // ...
111 78
112 smd-edge { 79 smd-edge {
113 interrupts = <GIC_SPI 156 IRQ_TYPE 80 interrupts = <GIC_SPI 156 IRQ_TYPE_EDGE_RISING>;
114 81
115 mboxes = <&apcs 8>; !! 82 qcom,ipc = <&apcs 8 8>;
116 qcom,smd-edge = <1>; 83 qcom,smd-edge = <1>;
117 }; 84 };
118 }; 85 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.