xref: /linux/Documentation/devicetree/bindings/bus/fsl,imx8mp-aipstz.yaml (revision 115e74a29b530d121891238e9551c4bcdf7b04b5) 
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    };
105