xref: /freebsd/sys/contrib/device-tree/Bindings/firmware/xilinx/xlnx,zynqmp-firmware.txt (revision 8ddb146abcdf061be9f2c0db7e391697dafad85c)
1-----------------------------------------------------------------
2Device Tree Bindings for the Xilinx Zynq MPSoC Firmware Interface
3-----------------------------------------------------------------
4
5The zynqmp-firmware node describes the interface to platform firmware.
6ZynqMP has an interface to communicate with secure firmware. Firmware
7driver provides an interface to firmware APIs. Interface APIs can be
8used by any driver to communicate to PMUFW(Platform Management Unit).
9These requests include clock management, pin control, device control,
10power management service, FPGA service and other platform management
11services.
12
13Required 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-------
23Example
24-------
25
26Zynq Ultrascale+ MPSoC
27----------------------
28firmware {
29	zynqmp_firmware: zynqmp-firmware {
30		compatible = "xlnx,zynqmp-firmware";
31		method = "smc";
32		...
33	};
34};
35
36Versal
37------
38firmware {
39	versal_firmware: versal-firmware {
40		compatible = "xlnx,versal-firmware";
41		method = "smc";
42		...
43	};
44};
45