1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
4 $id: "http://devicetree.org/schemas/remoteproc/st,stm32-rproc.yaml#"
5 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
7 title: STMicroelectronics STM32 remote processor controller bindings
10 This document defines the binding for the remoteproc component that loads and
11 boots firmwares on the ST32MP family chipset.
14 - Fabien Dessenne <fabien.dessenne@foss.st.com>
15 - Arnaud Pouliquen <arnaud.pouliquen@foss.st.com>
23 Address ranges of the RETRAM and MCU SRAM memories used by the remote
31 description: remote processor reset hold boot
32 $ref: "/schemas/types.yaml#/definitions/phandle-array"
35 - description: Phandle of syscon block
36 - description: The offset of the hold boot setting register
37 - description: The field mask of the hold boot
41 Reference to the system configuration which holds the RCC trust zone mode
42 $ref: "/schemas/types.yaml#/definitions/phandle-array"
45 - description: Phandle of syscon block
46 - description: The offset of the trust zone setting register
47 - description: The field mask of the trust zone state
50 description: Should contain the WWDG1 watchdog reset interrupt
57 This property is required only if the rpmsg/virtio functionality is used.
60 A channel (a) used to communicate through virtqueues with the
62 Bi-directional channel:
63 - from local to remote = send message
64 - from remote to local = send message ack
66 A channel (b) working the opposite direction of channel (a)
68 A channel (c) used by the local proc to notify the remote proc that it
69 is about to be shut down.
70 Unidirectional channel:
71 - from local to remote, where ACK from the remote means that it is
74 A channel (d) used by the local proc to notify the remote proc that it
75 has to stop interprocessor communnication.
76 Unidirectional channel:
77 - from local to remote, where ACK from the remote means that communnication
78 as been stopped on the remote side.
91 List of phandles to the reserved memory regions associated with the
92 remoteproc device. This is variable and describes the memories shared with
93 the remote processor (e.g. remoteproc firmware and carveouts, rpmsg
95 (see ../reserved-memory/reserved-memory.txt)
98 $ref: "/schemas/types.yaml#/definitions/phandle-array"
100 Reference to the system configuration which holds the remote
103 - description: Phandle of syscon block
104 - description: The offset of the power setting register
105 - description: The field mask of the PDDS selection
108 $ref: "/schemas/types.yaml#/definitions/phandle-array"
110 Reference to the tamp register which exposes the Cortex-M4 state.
113 - description: Phandle of syscon block with the tamp register
114 - description: The offset of the tamp register
115 - description: The field mask of the Cortex-M4 state
118 $ref: "/schemas/types.yaml#/definitions/phandle-array"
120 Reference to the tamp register which references the Cortex-M4
121 resource table address.
124 - description: Phandle of syscon block with the tamp register
125 - description: The offset of the tamp register
126 - description: The field mask of the Cortex-M4 resource table address
129 $ref: /schemas/types.yaml#/definitions/flag
131 If defined, when remoteproc is probed, it loads the default firmware and
132 starts the remote processor.
141 additionalProperties: false
145 #include <dt-bindings/reset/stm32mp1-resets.h>
146 m4_rproc: m4@10000000 {
147 compatible = "st,stm32mp1-m4";
148 reg = <0x10000000 0x40000>,
149 <0x30000000 0x40000>,
150 <0x38000000 0x10000>;
151 resets = <&rcc MCU_R>;
152 st,syscfg-holdboot = <&rcc 0x10C 0x1>;
153 st,syscfg-tz = <&rcc 0x000 0x1>;
154 st,syscfg-rsc-tbl = <&tamp 0x144 0xFFFFFFFF>;
155 st,syscfg-m4-state = <&tamp 0x148 0xFFFFFFFF>;