Documentation/devicetree/bindings/firmware/intel,stratix10-svc.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/firmware/intel,stratix10-svc.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/firmware/intel,stratix10-svc.yaml
Extension
.yaml
Size
2985 bytes
Lines
109
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/firmware/intel,stratix10-svc.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Intel Service Layer Driver for Stratix10 SoC

maintainers:
  - Dinh Nguyen <dinguyen@kernel.org>
  - Mahesh Rao <mahesh.rao@altera.com>

description: >
  Intel Stratix10 SoC is composed of a 64 bit quad-core ARM Cortex A53 hard
  processor system (HPS) and Secure Device Manager (SDM). When the FPGA is
  configured from HPS, there needs to be a way for HPS to notify SDM the
  location and size of the configuration data. Then SDM will get the
  configuration data from that location and perform the FPGA configuration.

  To meet the whole system security needs and support virtual machine requesting
  communication with SDM, only the secure world of software (EL3, Exception
  Layer 3) can interface with SDM. All software entities running on other
  exception layers must channel through the EL3 software whenever it needs
  service from SDM.

  Intel Stratix10 service layer driver, running at privileged exception level
  (EL1, Exception Layer 1), interfaces with the service providers and provides
  the services for FPGA configuration, QSPI, Crypto and warm reset. Service layer
  driver also manages secure monitor call (SMC) to communicate with secure monitor
  code running in EL3.

properties:
  compatible:
    enum:
      - intel,stratix10-svc
      - intel,agilex-svc
      - intel,agilex5-svc

  method:
    description: |
      Supervisory call method to be used to communicate with the
      secure service layer.
      Permitted values are:
      - "smc" : SMC #0, following the SMCCC
      - "hvc" : HVC #0, following the SMCCC

    $ref: /schemas/types.yaml#/definitions/string-array
    enum:
      - smc
      - hvc

  memory-region:
    maxItems: 1
    description:
      reserved memory region for the service layer driver to
      communicate with the secure device manager.

  iommus:
    maxItems: 1

  fpga-mgr:
    $ref: /schemas/fpga/intel,stratix10-soc-fpga-mgr.yaml
    description: Optional child node for fpga manager to perform fabric configuration.

required:
  - compatible
  - method
  - memory-region

allOf:

Annotation

Implementation Notes