Documentation/devicetree/bindings/firmware/xilinx/xlnx,zynqmp-firmware.txt

   1 -----------------------------------------------------------------
   2 Device Tree Bindings for the Xilinx Zynq MPSoC Firmware Interface
   3 -----------------------------------------------------------------
   4
   5 The zynqmp-firmware node describes the interface to platform firmware.
   6 ZynqMP has an interface to communicate with secure firmware. Firmware
   7 driver provides an interface to firmware APIs. Interface APIs can be
   8 used by any driver to communicate to PMUFW(Platform Management Unit).
   9 These requests include clock management, pin control, device control,
  10 power management service, FPGA service and other platform management
  11 services.
  12
  13 Required properties:
  14  - compatible:  Must contain any of below:
  15                 "xlnx,zynqmp-firmware" for Zynq Ultrascale+ MPSoC
  16                 "xlnx,versal-firmware" for Versal
  17  - method:      The method of calling the PM-API firmware layer.
  18                 Permitted values are:
  19                   - "smc" : SMC #0, following the SMCCC
  20                   - "hvc" : HVC #0, following the SMCCC
  21
  22 -------
  23 Example
  24 -------
  25
  26 Zynq Ultrascale+ MPSoC
  27 ----------------------
  28 firmware {
  29         zynqmp_firmware: zynqmp-firmware {
  30                 compatible = "xlnx,zynqmp-firmware";
  31                 method = "smc";
  32                 ...
  33         };
  34 };
  35
  36 Versal
  37 ------
  38 firmware {
  39         versal_firmware: versal-firmware {
  40                 compatible = "xlnx,versal-firmware";
  41                 method = "smc";
  42                 ...
  43         };
  44 };