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/ti,k3-dsp-rproc.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: TI K3 DSP devices 7 title: TI K3 DSP devices
8 8
9 maintainers: 9 maintainers:
10 - Suman Anna <s-anna@ti.com> 10 - Suman Anna <s-anna@ti.com>
11 11
12 description: | 12 description: |
13 The TI K3 family of SoCs usually have one or 13 The TI K3 family of SoCs usually have one or more TI DSP Core sub-systems
14 that are used to offload some of the process 14 that are used to offload some of the processor-intensive tasks or algorithms,
15 for achieving various system level goals. 15 for achieving various system level goals.
16 16
17 These processor sub-systems usually contain 17 These processor sub-systems usually contain additional sub-modules like
18 L1 and/or L2 caches/SRAMs, an Interrupt Cont 18 L1 and/or L2 caches/SRAMs, an Interrupt Controller, an external memory
19 controller, a dedicated local power/sleep co 19 controller, a dedicated local power/sleep controller etc. The DSP processor
20 cores in the K3 SoCs are usually either a TM 20 cores in the K3 SoCs are usually either a TMS320C66x CorePac processor or a
21 TMS320C71x CorePac processor. 21 TMS320C71x CorePac processor.
22 22
23 Each DSP Core sub-system is represented as a 23 Each DSP Core sub-system is represented as a single DT node. Each node has a
24 number of required or optional properties th 24 number of required or optional properties that enable the OS running on the
25 host processor (Arm CorePac) to perform the 25 host processor (Arm CorePac) to perform the device management of the remote
26 processor and to communicate with the remote 26 processor and to communicate with the remote processor.
27 27
>> 28 allOf:
>> 29 - $ref: /schemas/arm/keystone/ti,k3-sci-common.yaml#
>> 30
28 properties: 31 properties:
29 compatible: 32 compatible:
30 enum: 33 enum:
31 - ti,am62a-c7xv-dsp 34 - ti,am62a-c7xv-dsp
32 - ti,j721e-c66-dsp 35 - ti,j721e-c66-dsp
33 - ti,j721e-c71-dsp 36 - ti,j721e-c71-dsp
34 - ti,j721s2-c71-dsp 37 - ti,j721s2-c71-dsp
35 description: 38 description:
36 Use "ti,am62a-c7xv-dsp" for AM62A Deep l 39 Use "ti,am62a-c7xv-dsp" for AM62A Deep learning DSPs on K3 AM62A SoCs
37 Use "ti,j721e-c66-dsp" for C66x DSPs on 40 Use "ti,j721e-c66-dsp" for C66x DSPs on K3 J721E SoCs
38 Use "ti,j721e-c71-dsp" for C71x DSPs on 41 Use "ti,j721e-c71-dsp" for C71x DSPs on K3 J721E SoCs
39 Use "ti,j721s2-c71-dsp" for C71x DSPs on 42 Use "ti,j721s2-c71-dsp" for C71x DSPs on K3 J721S2 SoCs
40 43
41 resets: 44 resets:
42 description: | 45 description: |
43 Should contain the phandle to the reset 46 Should contain the phandle to the reset controller node managing the
44 local resets for this device, and a rese 47 local resets for this device, and a reset specifier.
45 maxItems: 1 48 maxItems: 1
46 49
47 firmware-name: 50 firmware-name:
48 description: | 51 description: |
49 Should contain the name of the default f 52 Should contain the name of the default firmware image
50 file located on the firmware search path 53 file located on the firmware search path
51 54
52 mboxes: 55 mboxes:
53 description: | 56 description: |
54 OMAP Mailbox specifier denoting the sub- 57 OMAP Mailbox specifier denoting the sub-mailbox, to be used for
55 communication with the remote processor. 58 communication with the remote processor. This property should match
56 with the sub-mailbox node used in the fi 59 with the sub-mailbox node used in the firmware image.
57 maxItems: 1 60 maxItems: 1
58 61
59 memory-region: 62 memory-region:
60 minItems: 2 63 minItems: 2
61 maxItems: 8 64 maxItems: 8
62 description: | 65 description: |
63 phandle to the reserved memory nodes to 66 phandle to the reserved memory nodes to be associated with the remoteproc
64 device. There should be at least two res 67 device. There should be at least two reserved memory nodes defined. The
65 reserved memory nodes should be carveout 68 reserved memory nodes should be carveout nodes, and should be defined as
66 per the bindings in 69 per the bindings in
67 Documentation/devicetree/bindings/reserv 70 Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt
68 items: 71 items:
69 - description: region used for dynamic D 72 - description: region used for dynamic DMA allocations like vrings and
70 vring buffers 73 vring buffers
71 - description: region reserved for firmw 74 - description: region reserved for firmware image sections
72 additionalItems: true 75 additionalItems: true
73 76
74 # Optional properties: 77 # Optional properties:
75 # -------------------- 78 # --------------------
76 79
77 sram: 80 sram:
78 $ref: /schemas/types.yaml#/definitions/pha 81 $ref: /schemas/types.yaml#/definitions/phandle-array
79 minItems: 1 82 minItems: 1
80 maxItems: 4 83 maxItems: 4
81 items: 84 items:
82 maxItems: 1 85 maxItems: 1
83 description: | 86 description: |
84 phandles to one or more reserved on-chip 87 phandles to one or more reserved on-chip SRAM regions. The regions
85 should be defined as child nodes of the 88 should be defined as child nodes of the respective SRAM node, and
86 should be defined as per the generic bin 89 should be defined as per the generic bindings in,
87 Documentation/devicetree/bindings/sram/s 90 Documentation/devicetree/bindings/sram/sram.yaml
88 91
89 allOf: !! 92 if:
90 - if: !! 93 properties:
91 properties: !! 94 compatible:
92 compatible: !! 95 enum:
93 enum: !! 96 - ti,j721e-c66-dsp
94 - ti,j721e-c66-dsp !! 97 then:
95 then: !! 98 properties:
96 properties: !! 99 reg:
97 reg: !! 100 items:
98 items: !! 101 - description: Address and Size of the L2 SRAM internal memory region
99 - description: Address and Size of !! 102 - description: Address and Size of the L1 PRAM internal memory region
100 - description: Address and Size of !! 103 - description: Address and Size of the L1 DRAM internal memory region
101 - description: Address and Size of !! 104 reg-names:
102 reg-names: !! 105 items:
103 items: !! 106 - const: l2sram
104 - const: l2sram !! 107 - const: l1pram
105 - const: l1pram !! 108 - const: l1dram
106 - const: l1dram !! 109 else:
107 !! 110 if:
108 - if: !! 111 properties:
109 properties: !! 112 compatible:
110 compatible: !! 113 enum:
111 enum: !! 114 - ti,am62a-c7xv-dsp
112 - ti,j721e-c71-dsp !! 115 - ti,j721e-c71-dsp
113 - ti,j721s2-c71-dsp !! 116 - ti,j721s2-c71-dsp
114 then: !! 117 then:
115 properties: !! 118 properties:
116 reg: !! 119 reg:
117 items: !! 120 items:
118 - description: Address and Size of !! 121 - description: Address and Size of the L2 SRAM internal memory region
119 - description: Address and Size of !! 122 - description: Address and Size of the L1 DRAM internal memory region
120 reg-names: !! 123 reg-names:
121 items: !! 124 items:
122 - const: l2sram !! 125 - const: l2sram
123 - const: l1dram !! 126 - const: l1dram
124 <<
125 - if: <<
126 properties: <<
127 compatible: <<
128 enum: <<
129 - ti,am62a-c7xv-dsp <<
130 then: <<
131 properties: <<
132 reg: <<
133 items: <<
134 - description: Address and Size of <<
135 reg-names: <<
136 items: <<
137 - const: l2sram <<
138 <<
139 - $ref: /schemas/arm/keystone/ti,k3-sci-comm <<
140 127
141 required: 128 required:
142 - compatible 129 - compatible
143 - reg 130 - reg
144 - reg-names 131 - reg-names
145 - ti,sci 132 - ti,sci
146 - ti,sci-dev-id 133 - ti,sci-dev-id
147 - ti,sci-proc-ids 134 - ti,sci-proc-ids
148 - resets 135 - resets
149 - firmware-name 136 - firmware-name
150 - mboxes 137 - mboxes
151 - memory-region 138 - memory-region
152 139
153 unevaluatedProperties: false 140 unevaluatedProperties: false
154 141
155 examples: 142 examples:
156 - | 143 - |
157 soc { 144 soc {
158 #address-cells = <2>; 145 #address-cells = <2>;
159 #size-cells = <2>; 146 #size-cells = <2>;
160 147
161 mailbox0_cluster3: mailbox-0 { 148 mailbox0_cluster3: mailbox-0 {
162 #mbox-cells = <1>; 149 #mbox-cells = <1>;
163 }; 150 };
164 151
165 mailbox0_cluster4: mailbox-1 { 152 mailbox0_cluster4: mailbox-1 {
166 #mbox-cells = <1>; 153 #mbox-cells = <1>;
167 }; 154 };
168 155
169 bus@100000 { 156 bus@100000 {
170 compatible = "simple-bus"; 157 compatible = "simple-bus";
171 #address-cells = <2>; 158 #address-cells = <2>;
172 #size-cells = <2>; 159 #size-cells = <2>;
173 ranges = <0x00 0x00100000 0x00 0x0 160 ranges = <0x00 0x00100000 0x00 0x00100000 0x00 0x00020000>, /* ctrl mmr */
174 <0x00 0x64800000 0x00 0x6 161 <0x00 0x64800000 0x00 0x64800000 0x00 0x00800000>, /* C71_0 */
175 <0x4d 0x80800000 0x4d 0x8 162 <0x4d 0x80800000 0x4d 0x80800000 0x00 0x00800000>, /* C66_0 */
176 <0x4d 0x81800000 0x4d 0x8 163 <0x4d 0x81800000 0x4d 0x81800000 0x00 0x00800000>; /* C66_1 */
177 164
178 /* J721E C66_0 DSP node */ 165 /* J721E C66_0 DSP node */
179 dsp@4d80800000 { 166 dsp@4d80800000 {
180 compatible = "ti,j721e-c66-dsp 167 compatible = "ti,j721e-c66-dsp";
181 reg = <0x4d 0x80800000 0x00 0x 168 reg = <0x4d 0x80800000 0x00 0x00048000>,
182 <0x4d 0x80e00000 0x00 0x 169 <0x4d 0x80e00000 0x00 0x00008000>,
183 <0x4d 0x80f00000 0x00 0x 170 <0x4d 0x80f00000 0x00 0x00008000>;
184 reg-names = "l2sram", "l1pram" 171 reg-names = "l2sram", "l1pram", "l1dram";
185 ti,sci = <&dmsc>; 172 ti,sci = <&dmsc>;
186 ti,sci-dev-id = <142>; 173 ti,sci-dev-id = <142>;
187 ti,sci-proc-ids = <0x03 0xFF>; 174 ti,sci-proc-ids = <0x03 0xFF>;
188 resets = <&k3_reset 142 1>; 175 resets = <&k3_reset 142 1>;
189 firmware-name = "j7-c66_0-fw"; 176 firmware-name = "j7-c66_0-fw";
190 memory-region = <&c66_0_dma_me 177 memory-region = <&c66_0_dma_memory_region>,
191 <&c66_0_memory 178 <&c66_0_memory_region>;
192 mboxes = <&mailbox0_cluster3 & 179 mboxes = <&mailbox0_cluster3 &mbox_c66_0>;
193 }; 180 };
194 181
195 /* J721E C71_0 DSP node */ 182 /* J721E C71_0 DSP node */
196 c71_0: dsp@64800000 { 183 c71_0: dsp@64800000 {
197 compatible = "ti,j721e-c71-dsp 184 compatible = "ti,j721e-c71-dsp";
198 reg = <0x00 0x64800000 0x00 0x 185 reg = <0x00 0x64800000 0x00 0x00080000>,
199 <0x00 0x64e00000 0x00 0x 186 <0x00 0x64e00000 0x00 0x0000c000>;
200 reg-names = "l2sram", "l1dram" 187 reg-names = "l2sram", "l1dram";
201 ti,sci = <&dmsc>; 188 ti,sci = <&dmsc>;
202 ti,sci-dev-id = <15>; 189 ti,sci-dev-id = <15>;
203 ti,sci-proc-ids = <0x30 0xFF>; 190 ti,sci-proc-ids = <0x30 0xFF>;
204 resets = <&k3_reset 15 1>; 191 resets = <&k3_reset 15 1>;
205 firmware-name = "j7-c71_0-fw"; 192 firmware-name = "j7-c71_0-fw";
206 memory-region = <&c71_0_dma_me 193 memory-region = <&c71_0_dma_memory_region>,
207 <&c71_0_memory 194 <&c71_0_memory_region>;
208 mboxes = <&mailbox0_cluster4 & 195 mboxes = <&mailbox0_cluster4 &mbox_c71_0>;
209 }; 196 };
210 }; 197 };
211 }; 198 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.