fsl,imx8mp-aipstz.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/bus/fsl,imx8mp-aipstz.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Secure AHB to IP Slave bus (AIPSTZ) bridge
  8
  9description:
 10  The secure AIPS bridge (AIPSTZ) acts as a bridge for AHB masters issuing
 11  transactions to IP Slave peripherals. Additionally, this module offers access
 12  control configurations meant to restrict which peripherals a master can
 13  access.
 14
 15maintainers:
 16  - Laurentiu Mihalcea <laurentiu.mihalcea@nxp.com>
 17
 18properties:
 19  compatible:
 20    const: fsl,imx8mp-aipstz
 21
 22  reg:
 23    maxItems: 1
 24
 25  power-domains:
 26    maxItems: 1
 27
 28  "#address-cells":
 29    const: 1
 30
 31  "#size-cells":
 32    const: 1
 33
 34  "#access-controller-cells":
 35    const: 3
 36    description:
 37      First cell - consumer ID
 38      Second cell - consumer type (master or peripheral)
 39      Third cell - configuration value
 40
 41  ranges: true
 42
 43# borrowed from simple-bus.yaml, no additional requirements for children
 44patternProperties:
 45  "@(0|[1-9a-f][0-9a-f]*)$":
 46    type: object
 47    additionalProperties: true
 48    properties:
 49      reg:
 50        items:
 51          minItems: 2
 52          maxItems: 4
 53        minItems: 1
 54        maxItems: 1024
 55      ranges:
 56        oneOf:
 57          - items:
 58              minItems: 3
 59              maxItems: 7
 60            minItems: 1
 61            maxItems: 1024
 62          - $ref: /schemas/types.yaml#/definitions/flag
 63    anyOf:
 64      - required:
 65          - reg
 66      - required:
 67          - ranges
 68
 69required:
 70  - compatible
 71  - reg
 72  - power-domains
 73  - "#address-cells"
 74  - "#size-cells"
 75  - "#access-controller-cells"
 76  - ranges
 77
 78additionalProperties: false
 79
 80examples:
 81  - |
 82    #include <dt-bindings/clock/imx8mp-clock.h>
 83    #include <dt-bindings/interrupt-controller/arm-gic.h>
 84
 85    bus@30df0000 {
 86        compatible = "fsl,imx8mp-aipstz";
 87        reg = <0x30df0000 0x10000>;
 88        ranges = <0x30c00000 0x30c00000 0x400000>;
 89        power-domains = <&pgc_audio>;
 90        #address-cells = <1>;
 91        #size-cells = <1>;
 92        #access-controller-cells = <3>;
 93
 94        dma-controller@30e00000 {
 95            compatible = "fsl,imx8mp-sdma", "fsl,imx8mq-sdma";
 96            reg = <0x30e00000 0x10000>;
 97            #dma-cells = <3>;
 98            clocks = <&audio_blk_ctrl IMX8MP_CLK_AUDIOMIX_SDMA3_ROOT>,
 99                     <&clk IMX8MP_CLK_AUDIO_ROOT>;
100            clock-names = "ipg", "ahb";
101            interrupts = <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>;
102            fsl,sdma-ram-script-name = "imx/sdma/sdma-imx7d.bin";
103        };
104    };