212 lines · yaml
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)2%YAML 1.23---4$id: http://devicetree.org/schemas/remoteproc/ti,k3-dsp-rproc.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: TI K3 DSP devices8 9maintainers:10 - Suman Anna <s-anna@ti.com>11 12description: |13 The TI K3 family of SoCs usually have one or more TI DSP Core sub-systems14 that are used to offload some of the processor-intensive tasks or algorithms,15 for achieving various system level goals.16 17 These processor sub-systems usually contain additional sub-modules like18 L1 and/or L2 caches/SRAMs, an Interrupt Controller, an external memory19 controller, a dedicated local power/sleep controller etc. The DSP processor20 cores in the K3 SoCs are usually either a TMS320C66x CorePac processor or a21 TMS320C71x CorePac processor.22 23 Each DSP Core sub-system is represented as a single DT node. Each node has a24 number of required or optional properties that enable the OS running on the25 host processor (Arm CorePac) to perform the device management of the remote26 processor and to communicate with the remote processor.27 28properties:29 compatible:30 enum:31 - ti,am62a-c7xv-dsp32 - ti,j721e-c66-dsp33 - ti,j721e-c71-dsp34 - ti,j721s2-c71-dsp35 description:36 Use "ti,am62a-c7xv-dsp" for AM62A Deep learning DSPs on K3 AM62A SoCs37 Use "ti,j721e-c66-dsp" for C66x DSPs on K3 J721E SoCs38 Use "ti,j721e-c71-dsp" for C71x DSPs on K3 J721E SoCs39 Use "ti,j721s2-c71-dsp" for C71x DSPs on K3 J721S2 SoCs40 41 resets:42 description: |43 Should contain the phandle to the reset controller node managing the44 local resets for this device, and a reset specifier.45 maxItems: 146 47 firmware-name:48 description: |49 Should contain the name of the default firmware image50 file located on the firmware search path51 52 mboxes:53 description: |54 OMAP Mailbox specifier denoting the sub-mailbox, to be used for55 communication with the remote processor. This property should match56 with the sub-mailbox node used in the firmware image.57 maxItems: 158 59 memory-region:60 minItems: 261 maxItems: 862 description: |63 phandle to the reserved memory nodes to be associated with the remoteproc64 device. There should be at least two reserved memory nodes defined. The65 reserved memory nodes should be carveout nodes, and should be defined as66 per the bindings in67 Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt68 items:69 - description: region used for dynamic DMA allocations like vrings and70 vring buffers71 - description: region reserved for firmware image sections72 additionalItems: true73 74# Optional properties:75# --------------------76 77 sram:78 $ref: /schemas/types.yaml#/definitions/phandle-array79 minItems: 180 maxItems: 481 items:82 maxItems: 183 description: |84 phandles to one or more reserved on-chip SRAM regions. The regions85 should be defined as child nodes of the respective SRAM node, and86 should be defined as per the generic bindings in,87 Documentation/devicetree/bindings/sram/sram.yaml88 89allOf:90 - if:91 properties:92 compatible:93 enum:94 - ti,j721e-c66-dsp95 then:96 properties:97 reg:98 items:99 - description: Address and Size of the L2 SRAM internal memory region100 - description: Address and Size of the L1 PRAM internal memory region101 - description: Address and Size of the L1 DRAM internal memory region102 reg-names:103 items:104 - const: l2sram105 - const: l1pram106 - const: l1dram107 108 - if:109 properties:110 compatible:111 enum:112 - ti,j721e-c71-dsp113 - ti,j721s2-c71-dsp114 then:115 properties:116 reg:117 items:118 - description: Address and Size of the L2 SRAM internal memory region119 - description: Address and Size of the L1 DRAM internal memory region120 reg-names:121 items:122 - const: l2sram123 - const: l1dram124 125 - if:126 properties:127 compatible:128 enum:129 - ti,am62a-c7xv-dsp130 then:131 properties:132 reg:133 items:134 - description: Address and Size of the L2 SRAM internal memory region135 reg-names:136 items:137 - const: l2sram138 139 - $ref: /schemas/arm/keystone/ti,k3-sci-common.yaml#140 141required:142 - compatible143 - reg144 - reg-names145 - ti,sci146 - ti,sci-dev-id147 - ti,sci-proc-ids148 - resets149 - firmware-name150 - mboxes151 - memory-region152 153unevaluatedProperties: false154 155examples:156 - |157 soc {158 #address-cells = <2>;159 #size-cells = <2>;160 161 mailbox0_cluster3: mailbox-0 {162 #mbox-cells = <1>;163 };164 165 mailbox0_cluster4: mailbox-1 {166 #mbox-cells = <1>;167 };168 169 bus@100000 {170 compatible = "simple-bus";171 #address-cells = <2>;172 #size-cells = <2>;173 ranges = <0x00 0x00100000 0x00 0x00100000 0x00 0x00020000>, /* ctrl mmr */174 <0x00 0x64800000 0x00 0x64800000 0x00 0x00800000>, /* C71_0 */175 <0x4d 0x80800000 0x4d 0x80800000 0x00 0x00800000>, /* C66_0 */176 <0x4d 0x81800000 0x4d 0x81800000 0x00 0x00800000>; /* C66_1 */177 178 /* J721E C66_0 DSP node */179 dsp@4d80800000 {180 compatible = "ti,j721e-c66-dsp";181 reg = <0x4d 0x80800000 0x00 0x00048000>,182 <0x4d 0x80e00000 0x00 0x00008000>,183 <0x4d 0x80f00000 0x00 0x00008000>;184 reg-names = "l2sram", "l1pram", "l1dram";185 ti,sci = <&dmsc>;186 ti,sci-dev-id = <142>;187 ti,sci-proc-ids = <0x03 0xFF>;188 resets = <&k3_reset 142 1>;189 firmware-name = "j7-c66_0-fw";190 memory-region = <&c66_0_dma_memory_region>,191 <&c66_0_memory_region>;192 mboxes = <&mailbox0_cluster3 &mbox_c66_0>;193 };194 195 /* J721E C71_0 DSP node */196 c71_0: dsp@64800000 {197 compatible = "ti,j721e-c71-dsp";198 reg = <0x00 0x64800000 0x00 0x00080000>,199 <0x00 0x64e00000 0x00 0x0000c000>;200 reg-names = "l2sram", "l1dram";201 ti,sci = <&dmsc>;202 ti,sci-dev-id = <15>;203 ti,sci-proc-ids = <0x30 0xFF>;204 resets = <&k3_reset 15 1>;205 firmware-name = "j7-c71_0-fw";206 memory-region = <&c71_0_dma_memory_region>,207 <&c71_0_memory_region>;208 mboxes = <&mailbox0_cluster4 &mbox_c71_0>;209 };210 };211 };212