intel,stratix10-svc.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/firmware/intel,stratix10-svc.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Intel Service Layer Driver for Stratix10 SoC
  8
  9maintainers:
 10  - Dinh Nguyen <dinguyen@kernel.org>
 11  - Mahesh Rao <mahesh.rao@altera.com>
 12
 13description: >
 14  Intel Stratix10 SoC is composed of a 64 bit quad-core ARM Cortex A53 hard
 15  processor system (HPS) and Secure Device Manager (SDM). When the FPGA is
 16  configured from HPS, there needs to be a way for HPS to notify SDM the
 17  location and size of the configuration data. Then SDM will get the
 18  configuration data from that location and perform the FPGA configuration.
 19
 20  To meet the whole system security needs and support virtual machine requesting
 21  communication with SDM, only the secure world of software (EL3, Exception
 22  Layer 3) can interface with SDM. All software entities running on other
 23  exception layers must channel through the EL3 software whenever it needs
 24  service from SDM.
 25
 26  Intel Stratix10 service layer driver, running at privileged exception level
 27  (EL1, Exception Layer 1), interfaces with the service providers and provides
 28  the services for FPGA configuration, QSPI, Crypto and warm reset. Service layer
 29  driver also manages secure monitor call (SMC) to communicate with secure monitor
 30  code running in EL3.
 31
 32properties:
 33  compatible:
 34    enum:
 35      - intel,stratix10-svc
 36      - intel,agilex-svc
 37      - intel,agilex5-svc
 38
 39  method:
 40    description: |
 41      Supervisory call method to be used to communicate with the
 42      secure service layer.
 43      Permitted values are:
 44      - "smc" : SMC #0, following the SMCCC
 45      - "hvc" : HVC #0, following the SMCCC
 46
 47    $ref: /schemas/types.yaml#/definitions/string-array
 48    enum:
 49      - smc
 50      - hvc
 51
 52  memory-region:
 53    maxItems: 1
 54    description:
 55      reserved memory region for the service layer driver to
 56      communicate with the secure device manager.
 57
 58  iommus:
 59    maxItems: 1
 60
 61  fpga-mgr:
 62    $ref: /schemas/fpga/intel,stratix10-soc-fpga-mgr.yaml
 63    description: Optional child node for fpga manager to perform fabric configuration.
 64
 65required:
 66  - compatible
 67  - method
 68  - memory-region
 69
 70allOf:
 71  - if:
 72      properties:
 73        compatible:
 74          contains:
 75            enum:
 76              - intel,agilex5-svc
 77    then:
 78      required:
 79        - iommus
 80
 81additionalProperties: false
 82
 83examples:
 84  - |
 85    reserved-memory {
 86      #address-cells = <2>;
 87      #size-cells = <2>;
 88
 89      service_reserved: svcbuffer@0 {
 90              compatible = "shared-dma-pool";
 91              reg = <0x0 0x0 0x0 0x1000000>;
 92              alignment = <0x1000>;
 93              no-map;
 94      };
 95    };
 96
 97    firmware {
 98      svc {
 99        compatible = "intel,stratix10-svc";
100        method = "smc";
101        memory-region = <&service_reserved>;
102
103        fpga-mgr {
104          compatible = "intel,stratix10-soc-fpga-mgr";
105        };
106      };
107    };
108