1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/soc/microchip/microchip,mpfs-sys-controller.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: Microchip PolarFire SoC (MPFS) MSS (microprocessor subsystem) system controller 8 9maintainers: 10 - Conor Dooley <conor.dooley@microchip.com> 11 12description: | 13 PolarFire SoC devices include a microcontroller acting as the system controller, 14 which provides "services" to the main processor and to the FPGA fabric. These 15 services include hardware rng, reprogramming of the FPGA and verification of the 16 eNVM contents etc. More information on these services can be found online, at 17 https://onlinedocs.microchip.com/pr/GUID-1409CF11-8EF9-4C24-A94E-70979A688632-en-US-1/index.html 18 19 Communication with the system controller is done via a mailbox, of which the client 20 portion is documented here. 21 22properties: 23 mboxes: 24 maxItems: 1 25 26 compatible: 27 enum: 28 - microchip,mpfs-sys-controller 29 - microchip,pic64gx-sys-controller 30 31 microchip,bitstream-flash: 32 $ref: /schemas/types.yaml#/definitions/phandle 33 description: 34 The SPI flash connected to the system controller's QSPI controller. 35 The system controller may retrieve FPGA bitstreams from this flash to 36 perform In-Application Programming (IAP) or during device initialisation 37 for Auto Update. The MSS and system controller have separate QSPI 38 controllers and this flash is connected to both. Software running in the 39 MSS can write bitstreams to the flash. 40 41required: 42 - compatible 43 - mboxes 44 45additionalProperties: false 46 47examples: 48 - | 49 syscontroller { 50 compatible = "microchip,mpfs-sys-controller"; 51 mboxes = <&mbox 0>; 52 }; 53