xref: /openbmc/linux/Documentation/devicetree/bindings/soc/microchip/microchip,mpfs-sys-controller.yaml (revision c900529f3d9161bfde5cca0754f83b4d3c3e0220)
121355623SConor Dooley# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
221355623SConor Dooley%YAML 1.2
321355623SConor Dooley---
443f45415SKrzysztof Kozlowski$id: http://devicetree.org/schemas/soc/microchip/microchip,mpfs-sys-controller.yaml#
543f45415SKrzysztof Kozlowski$schema: http://devicetree.org/meta-schemas/core.yaml#
621355623SConor Dooley
721355623SConor Dooleytitle: Microchip PolarFire SoC (MPFS) MSS (microprocessor subsystem) system controller
821355623SConor Dooley
921355623SConor Dooleymaintainers:
1021355623SConor Dooley  - Conor Dooley <conor.dooley@microchip.com>
1121355623SConor Dooley
1221355623SConor Dooleydescription: |
13b435a172SConor Dooley  PolarFire SoC devices include a microcontroller acting as the system controller,
14b435a172SConor Dooley  which provides "services" to the main processor and to the FPGA fabric. These
15*47aab533SBjorn Helgaas  services include hardware rng, reprogramming of the FPGA and verification of the
16b435a172SConor Dooley  eNVM contents etc. More information on these services can be found online, at
17b435a172SConor Dooley  https://onlinedocs.microchip.com/pr/GUID-1409CF11-8EF9-4C24-A94E-70979A688632-en-US-1/index.html
1821355623SConor Dooley
19b435a172SConor Dooley  Communication with the system controller is done via a mailbox, of which the client
20b435a172SConor Dooley  portion is documented here.
2121355623SConor Dooley
2221355623SConor Dooleyproperties:
2321355623SConor Dooley  mboxes:
2421355623SConor Dooley    maxItems: 1
2521355623SConor Dooley
2621355623SConor Dooley  compatible:
2721355623SConor Dooley    const: microchip,mpfs-sys-controller
2821355623SConor Dooley
2921355623SConor Dooleyrequired:
3021355623SConor Dooley  - compatible
3121355623SConor Dooley  - mboxes
3221355623SConor Dooley
3321355623SConor DooleyadditionalProperties: false
3421355623SConor Dooley
3521355623SConor Dooleyexamples:
3621355623SConor Dooley  - |
37b435a172SConor Dooley    syscontroller {
3821355623SConor Dooley      compatible = "microchip,mpfs-sys-controller";
3921355623SConor Dooley      mboxes = <&mbox 0>;
4021355623SConor Dooley    };
41