Documentation/devicetree/bindings/dsp/mediatek,mt8195-dsp.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/dsp/mediatek,mt8195-dsp.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Mediatek mt8195 DSP core
   8
   9 maintainers:
  10   - YC Hung <yc.hung@mediatek.com>
  11
  12 description: |
  13   Some boards from mt8195 contain a DSP core used for
  14   advanced pre- and post- audio processing.
  15
  16 properties:
  17   compatible:
  18     const: mediatek,mt8195-dsp
  19
  20   reg:
  21     items:
  22       - description: Address and size of the DSP Cfg registers
  23       - description: Address and size of the DSP SRAM
  24
  25   reg-names:
  26     items:
  27       - const: cfg
  28       - const: sram
  29
  30   clocks:
  31     items:
  32       - description: mux for audio dsp clock
  33       - description: 26M clock
  34       - description: mux for audio dsp local bus
  35       - description: default audio dsp local bus clock source
  36       - description: clock gate for audio dsp clock
  37       - description: mux for audio dsp access external bus
  38
  39   clock-names:
  40     items:
  41       - const: adsp_sel
  42       - const: clk26m_ck
  43       - const: audio_local_bus
  44       - const: mainpll_d7_d2
  45       - const: scp_adsp_audiodsp
  46       - const: audio_h
  47
  48   power-domains:
  49     maxItems: 1
  50
  51   mboxes:
  52     items:
  53       - description: mailbox for receiving audio DSP requests.
  54       - description: mailbox for transmitting requests to audio DSP.
  55
  56   mbox-names:
  57     items:
  58       - const: rx
  59       - const: tx
  60
  61   memory-region:
  62     items:
  63       - description: dma buffer between host and DSP.
  64       - description: DSP system memory.
  65
  66 required:
  67   - compatible
  68   - reg
  69   - reg-names
  70   - clocks
  71   - clock-names
  72   - memory-region
  73   - power-domains
  74   - mbox-names
  75   - mboxes
  76
  77 additionalProperties: false
  78
  79 examples:
  80   - |
  81     #include <dt-bindings/interrupt-controller/arm-gic.h>
  82     #include <dt-bindings/interrupt-controller/irq.h>
  83     dsp@10803000 {
  84        compatible =  "mediatek,mt8195-dsp";
  85        reg = <0x10803000  0x1000>,
  86              <0x10840000  0x40000>;
  87        reg-names = "cfg", "sram";
  88        clocks = <&topckgen 10>, //CLK_TOP_ADSP
  89                 <&clk26m>,
  90                 <&topckgen 107>, //CLK_TOP_AUDIO_LOCAL_BUS
  91                 <&topckgen 136>, //CLK_TOP_MAINPLL_D7_D2
  92                 <&scp_adsp 0>, //CLK_SCP_ADSP_AUDIODSP
  93                 <&topckgen 34>; //CLK_TOP_AUDIO_H
  94        clock-names = "adsp_sel",
  95                      "clk26m_ck",
  96                      "audio_local_bus",
  97                      "mainpll_d7_d2",
  98                      "scp_adsp_audiodsp",
  99                      "audio_h";
 100        memory-region = <&adsp_dma_mem_reserved>,
 101                        <&adsp_mem_reserved>;
 102        power-domains = <&spm 6>; //MT8195_POWER_DOMAIN_ADSP
 103        mbox-names = "rx", "tx";
 104        mboxes = <&adsp_mailbox0>, <&adsp_mailbox1>;
 105     };