1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/mailbox/xlnx,zynqmp-ipi-mailbox.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: Xilinx IPI(Inter Processor Interrupt) mailbox controller 8 9description: | 10 The Xilinx IPI(Inter Processor Interrupt) mailbox controller is to manage 11 messaging between two Xilinx Zynq UltraScale+ MPSoC IPI agents. Each IPI 12 agent owns registers used for notification and buffers for message. 13 14 +-------------------------------------+ 15 | Xilinx ZynqMP IPI Controller | 16 +-------------------------------------+ 17 +--------------------------------------------------+ 18 TF-A | | 19 | | 20 | | 21 +--------------------------+ | 22 | | 23 | | 24 +--------------------------------------------------+ 25 +------------------------------------------+ 26 | +----------------+ +----------------+ | 27 Hardware | | IPI Agent | | IPI Buffers | | 28 | | Registers | | | | 29 | | | | | | 30 | +----------------+ +----------------+ | 31 | | 32 | Xilinx IPI Agent Block | 33 +------------------------------------------+ 34 35maintainers: 36 - Shubhrajyoti Datta <shubhrajyoti.datta@xilinx.com> 37 38properties: 39 compatible: 40 const: xlnx,zynqmp-ipi-mailbox 41 42 method: 43 description: | 44 The method of calling the PM-API firmware layer. 45 Permitted values are. 46 - "smc" : SMC #0, following the SMCCC 47 - "hvc" : HVC #0, following the SMCCC 48 49 $ref: /schemas/types.yaml#/definitions/string 50 enum: 51 - smc 52 - hvc 53 default: smc 54 55 '#address-cells': 56 const: 2 57 58 '#size-cells': 59 const: 2 60 61 xlnx,ipi-id: 62 description: | 63 Remote Xilinx IPI agent ID of which the mailbox is connected to. 64 $ref: /schemas/types.yaml#/definitions/uint32 65 66 interrupts: 67 maxItems: 1 68 69 ranges: true 70 71patternProperties: 72 '^mailbox@[0-9a-f]+$': 73 description: Internal ipi mailbox node 74 type: object # DT nodes are json objects 75 additionalProperties: false 76 properties: 77 xlnx,ipi-id: 78 description: 79 Remote Xilinx IPI agent ID of which the mailbox is connected to. 80 $ref: /schemas/types.yaml#/definitions/uint32 81 82 '#mbox-cells': 83 const: 1 84 description: 85 It contains tx(0) or rx(1) channel IPI id number. 86 87 reg: 88 maxItems: 4 89 90 reg-names: 91 items: 92 - const: local_request_region 93 - const: local_response_region 94 - const: remote_request_region 95 - const: remote_response_region 96 97 required: 98 - reg 99 - reg-names 100 - "#mbox-cells" 101 102additionalProperties: false 103 104required: 105 - compatible 106 - interrupts 107 - '#address-cells' 108 - '#size-cells' 109 - xlnx,ipi-id 110 111examples: 112 - | 113 #include<dt-bindings/interrupt-controller/arm-gic.h> 114 115 amba { 116 #address-cells = <0x2>; 117 #size-cells = <0x2>; 118 zynqmp-mailbox { 119 compatible = "xlnx,zynqmp-ipi-mailbox"; 120 interrupts = <GIC_SPI 29 IRQ_TYPE_LEVEL_HIGH>; 121 xlnx,ipi-id = <0>; 122 #address-cells = <2>; 123 #size-cells = <2>; 124 ranges; 125 126 mailbox: mailbox@ff9905c0 { 127 reg = <0x0 0xff9905c0 0x0 0x20>, 128 <0x0 0xff9905e0 0x0 0x20>, 129 <0x0 0xff990e80 0x0 0x20>, 130 <0x0 0xff990ea0 0x0 0x20>; 131 reg-names = "local_request_region", 132 "local_response_region", 133 "remote_request_region", 134 "remote_response_region"; 135 #mbox-cells = <1>; 136 xlnx,ipi-id = <4>; 137 }; 138 }; 139 }; 140 141... 142