bindings/dsp/fsl%2Cdsp.yaml

1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/dsp/fsl,dsp.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: NXP i.MX8 DSP core
10   - Daniel Baluta <daniel.baluta@nxp.com>
11   - Shengjiu Wang <shengjiu.wang@nxp.com>
14   Some boards from i.MX8 family contain a DSP core used for
15   advanced pre- and post- audio processing.
20       - fsl,imx8qxp-dsp
21       - fsl,imx8qm-dsp
22       - fsl,imx8mp-dsp
23       - fsl,imx8ulp-dsp
24       - fsl,imx8qxp-hifi4
25       - fsl,imx8qm-hifi4
26       - fsl,imx8mp-hifi4
27       - fsl,imx8ulp-hifi4
34       - description: ipg clock
35       - description: ocram clock
36       - description: core clock
37       - description: debug interface clock
38       - description: message unit clock
41   clock-names:
43       - const: ipg
44       - const: ocram
45       - const: core
46       - const: debug
47       - const: mu
50   power-domains:
59       List of <&phandle type channel> - 2 channels for TXDB, 2 channels for RXDB
60       or - 1 channel for TX, 1 channel for RX, 1 channel for RXDB
65   mbox-names:
69   memory-region:
72       used by DSP (see bindings/reserved-memory/reserved-memory.txt)
76   firmware-name:
80   fsl,dsp-ctrl:
88   reset-names:
91       - const: runstall
92       - const: softreset
95   - compatible
96   - reg
97   - clocks
98   - clock-names
99   - power-domains
100   - mboxes
101   - mbox-names
102   - memory-region
105   - if:
110               - fsl,imx8qxp-dsp
111               - fsl,imx8qxp-hifi4
114         power-domains:
118   - if:
123               - fsl,imx8qm-dsp
124               - fsl,imx8qm-hifi4
127         power-domains:
130   - if:
135               - fsl,imx8mp-dsp
136               - fsl,imx8mp-hifi4
137               - fsl,imx8ulp-dsp
138               - fsl,imx8ulp-hifi4
141         power-domains:
144   - if:
149               - fsl,imx8qxp-hifi4
150               - fsl,imx8qm-hifi4
151               - fsl,imx8mp-hifi4
152               - fsl,imx8ulp-hifi4
155         memory-region:
159         mbox-names:
161             - const: tx
162             - const: rx
163             - const: rxdb
166         memory-region:
170         mbox-names:
172             - const: txdb0
173             - const: txdb1
174             - const: rxdb0
175             - const: rxdb1
176   - if:
181               - fsl,imx8mp-dsp
182               - fsl,imx8mp-hifi4
185         - resets
186         - reset-names
191   - |
192     #include <dt-bindings/firmware/imx/rsrc.h>
193     #include <dt-bindings/clock/imx8-clock.h>
194     dsp@596e8000 {
195         compatible = "fsl,imx8qxp-dsp";
200         clock-names = "ipg", "ocram", "core";
201         power-domains = <&pd IMX_SC_R_MU_13B>,
203         mbox-names = "txdb0", "txdb1", "rxdb0", "rxdb1";
205         memory-region = <&dsp_reserved>;
207   - |
208     #include <dt-bindings/clock/imx8mp-clock.h>
209     #include <dt-bindings/reset/imx8mp-reset-audiomix.h>
210     dsp_reserved: dsp@92400000 {
212       no-map;
216       no-map;
220       no-map;
223       compatible = "shared-dma-pool";
225       no-map;
228     dsp: dsp@3b6e8000 {
229       compatible = "fsl,imx8mp-hifi4";
235       clock-names = "ipg", "ocram", "core", "debug";
236       firmware-name = "imx/dsp/hifi4.bin";
237       power-domains = <&audiomix_pd>;
238       mbox-names = "tx", "rx", "rxdb";
242       memory-region = <&dsp_vdev0buffer>, <&dsp_vdev0vring0>,
245       reset-names = "runstall";