mirror of
https://github.com/torvalds/linux.git
synced 2026-04-19 23:34:00 -04:00
ef7129db96
With the introduction of the SCMI (System Control and Management Interface), it is now possible to use the SCMI to handle the hold boot instead of a dedicated SMC call. As consequence two configurations are possible: - without SCMI server on OP-TEE: use the Linux rcc reset service and use syscon for the MCU hold boot - With SCMI server on OP-TEE: use the SCMI reset service for both the MCU reset and the MCU hold boot. This patch: - make optional and deprecated the use of the property st,syscfg-tz which was used to check if the trusted Zone was enable to use scm call, to manage the hold boot. The reset controller phandle is used instead to select the configurations. - make st,syscfg-holdboot optional - adds properties check on resets definitions. - adds an example of the SCMI reset service usage. Signed-off-by: Arnaud Pouliquen <arnaud.pouliquen@foss.st.com> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Link: https://lore.kernel.org/r/20230512093926.661509-2-arnaud.pouliquen@foss.st.com Signed-off-by: Mathieu Poirier <mathieu.poirier@linaro.org>
193 lines
5.8 KiB
YAML
193 lines
5.8 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/remoteproc/st,stm32-rproc.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: STMicroelectronics STM32 remote processor controller
|
|
|
|
description:
|
|
This document defines the binding for the remoteproc component that loads and
|
|
boots firmwares on the ST32MP family chipset.
|
|
|
|
maintainers:
|
|
- Fabien Dessenne <fabien.dessenne@foss.st.com>
|
|
- Arnaud Pouliquen <arnaud.pouliquen@foss.st.com>
|
|
|
|
properties:
|
|
compatible:
|
|
const: st,stm32mp1-m4
|
|
|
|
reg:
|
|
description:
|
|
Address ranges of the RETRAM and MCU SRAM memories used by the remote
|
|
processor.
|
|
maxItems: 3
|
|
|
|
resets:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
reset-names:
|
|
items:
|
|
- const: mcu_rst
|
|
- const: hold_boot
|
|
minItems: 1
|
|
|
|
st,syscfg-holdboot:
|
|
description: remote processor reset hold boot
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
items:
|
|
- items:
|
|
- description: Phandle of syscon block
|
|
- description: The offset of the hold boot setting register
|
|
- description: The field mask of the hold boot
|
|
|
|
st,syscfg-tz:
|
|
deprecated: true
|
|
description:
|
|
Reference to the system configuration which holds the RCC trust zone mode
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
items:
|
|
- items:
|
|
- description: Phandle of syscon block
|
|
- description: The offset of the trust zone setting register
|
|
- description: The field mask of the trust zone state
|
|
|
|
interrupts:
|
|
description: Should contain the WWDG1 watchdog reset interrupt
|
|
maxItems: 1
|
|
|
|
wakeup-source: true
|
|
|
|
mboxes:
|
|
description:
|
|
This property is required only if the rpmsg/virtio functionality is used.
|
|
items:
|
|
- description: |
|
|
A channel (a) used to communicate through virtqueues with the
|
|
remote proc.
|
|
Bi-directional channel:
|
|
- from local to remote = send message
|
|
- from remote to local = send message ack
|
|
- description: |
|
|
A channel (b) working the opposite direction of channel (a)
|
|
- description: |
|
|
A channel (c) used by the local proc to notify the remote proc that it
|
|
is about to be shut down.
|
|
Unidirectional channel:
|
|
- from local to remote, where ACK from the remote means that it is
|
|
ready for shutdown
|
|
- description: |
|
|
A channel (d) used by the local proc to notify the remote proc that it
|
|
has to stop interprocessor communication.
|
|
Unidirectional channel:
|
|
- from local to remote, where ACK from the remote means that communication
|
|
as been stopped on the remote side.
|
|
minItems: 1
|
|
|
|
mbox-names:
|
|
items:
|
|
- const: vq0
|
|
- const: vq1
|
|
- const: shutdown
|
|
- const: detach
|
|
minItems: 1
|
|
|
|
memory-region:
|
|
description:
|
|
List of phandles to the reserved memory regions associated with the
|
|
remoteproc device. This is variable and describes the memories shared with
|
|
the remote processor (e.g. remoteproc firmware and carveouts, rpmsg
|
|
vrings, ...).
|
|
(see ../reserved-memory/reserved-memory.txt)
|
|
|
|
st,syscfg-pdds:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
description: |
|
|
Reference to the system configuration which holds the remote
|
|
items:
|
|
- items:
|
|
- description: Phandle of syscon block
|
|
- description: The offset of the power setting register
|
|
- description: The field mask of the PDDS selection
|
|
|
|
st,syscfg-m4-state:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
description: |
|
|
Reference to the tamp register which exposes the Cortex-M4 state.
|
|
items:
|
|
- items:
|
|
- description: Phandle of syscon block with the tamp register
|
|
- description: The offset of the tamp register
|
|
- description: The field mask of the Cortex-M4 state
|
|
|
|
st,syscfg-rsc-tbl:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
description: |
|
|
Reference to the tamp register which references the Cortex-M4
|
|
resource table address.
|
|
items:
|
|
- items:
|
|
- description: Phandle of syscon block with the tamp register
|
|
- description: The offset of the tamp register
|
|
- description: The field mask of the Cortex-M4 resource table address
|
|
|
|
st,auto-boot:
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
description:
|
|
If defined, when remoteproc is probed, it loads the default firmware and
|
|
starts the remote processor.
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- resets
|
|
|
|
allOf:
|
|
- if:
|
|
properties:
|
|
reset-names:
|
|
not:
|
|
contains:
|
|
const: hold_boot
|
|
then:
|
|
required:
|
|
- st,syscfg-holdboot
|
|
else:
|
|
properties:
|
|
st,syscfg-holdboot: false
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/reset/stm32mp1-resets.h>
|
|
m4@10000000 {
|
|
compatible = "st,stm32mp1-m4";
|
|
reg = <0x10000000 0x40000>,
|
|
<0x30000000 0x40000>,
|
|
<0x38000000 0x10000>;
|
|
resets = <&rcc MCU_R>;
|
|
reset-names = "mcu_rst";
|
|
/* Hold boot managed using system config*/
|
|
st,syscfg-holdboot = <&rcc 0x10C 0x1>;
|
|
st,syscfg-rsc-tbl = <&tamp 0x144 0xFFFFFFFF>;
|
|
st,syscfg-m4-state = <&tamp 0x148 0xFFFFFFFF>;
|
|
};
|
|
- |
|
|
#include <dt-bindings/reset/stm32mp1-resets.h>
|
|
m4@10000000 {
|
|
compatible = "st,stm32mp1-m4";
|
|
reg = <0x10000000 0x40000>,
|
|
<0x30000000 0x40000>,
|
|
<0x38000000 0x10000>;
|
|
/* Hold boot managed using SCMI reset controller */
|
|
resets = <&scmi MCU_R>, <&scmi MCU_HOLD_BOOT_R>;
|
|
reset-names = "mcu_rst", "hold_boot";
|
|
st,syscfg-rsc-tbl = <&tamp 0x144 0xFFFFFFFF>;
|
|
st,syscfg-m4-state = <&tamp 0x148 0xFFFFFFFF>;
|
|
};
|
|
|
|
...
|