xref: /linux/Documentation/ABI/stable/sysfs-driver-firmware-zynqmp (revision b3ae24c44848c6403fb2333d7cbe494565058352)
1ae5c961dSRajan VajaWhat:		/sys/devices/platform/firmware\:zynqmp-firmware/ggs*
2ae5c961dSRajan VajaDate:		March 2020
3ae5c961dSRajan VajaKernelVersion:	5.6
4ae5c961dSRajan VajaContact:	"Jolly Shah" <jollys@xilinx.com>
5ae5c961dSRajan VajaDescription:
6ae5c961dSRajan Vaja		Read/Write PMU global general storage register value,
7ae5c961dSRajan Vaja		GLOBAL_GEN_STORAGE{0:3}.
8ae5c961dSRajan Vaja		Global general storage register that can be used
9ae5c961dSRajan Vaja		by system to pass information between masters.
10ae5c961dSRajan Vaja
11ae5c961dSRajan Vaja		The register is reset during system or power-on
12ae5c961dSRajan Vaja		resets. Three registers are used by the FSBL and
13ae5c961dSRajan Vaja		other Xilinx software products: GLOBAL_GEN_STORAGE{4:6}.
14ae5c961dSRajan Vaja
15ae5c961dSRajan Vaja		Usage:
16ae5c961dSRajan Vaja		# cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
17ae5c961dSRajan Vaja		# echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
18ae5c961dSRajan Vaja
19ae5c961dSRajan Vaja		Example:
20ae5c961dSRajan Vaja		# cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
21ae5c961dSRajan Vaja		# echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
22ae5c961dSRajan Vaja
23ae5c961dSRajan VajaUsers:		Xilinx
24ae5c961dSRajan Vaja
25ae5c961dSRajan VajaWhat:		/sys/devices/platform/firmware\:zynqmp-firmware/pggs*
26ae5c961dSRajan VajaDate:		March 2020
27ae5c961dSRajan VajaKernelVersion:	5.6
28ae5c961dSRajan VajaContact:	"Jolly Shah" <jollys@xilinx.com>
29ae5c961dSRajan VajaDescription:
30ae5c961dSRajan Vaja		Read/Write PMU persistent global general storage register
31ae5c961dSRajan Vaja		value, PERS_GLOB_GEN_STORAGE{0:3}.
32ae5c961dSRajan Vaja		Persistent global general storage register that
33ae5c961dSRajan Vaja		can be used by system to pass information between
34ae5c961dSRajan Vaja		masters.
35ae5c961dSRajan Vaja
36ae5c961dSRajan Vaja		This register is only reset by the power-on reset
37ae5c961dSRajan Vaja		and maintains its value through a system reset.
38ae5c961dSRajan Vaja		Four registers are used by the FSBL and other Xilinx
39ae5c961dSRajan Vaja		software products: PERS_GLOB_GEN_STORAGE{4:7}.
40ae5c961dSRajan Vaja		Register is reset only by a POR reset.
41ae5c961dSRajan Vaja
42ae5c961dSRajan Vaja		Usage:
43ae5c961dSRajan Vaja		# cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
44ae5c961dSRajan Vaja		# echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
45ae5c961dSRajan Vaja
46ae5c961dSRajan Vaja		Example:
47ae5c961dSRajan Vaja		# cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
48ae5c961dSRajan Vaja		# echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
49ae5c961dSRajan Vaja
50ae5c961dSRajan VajaUsers:		Xilinx
51*b3ae24c4SRajan Vaja
52*b3ae24c4SRajan VajaWhat:		/sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
53*b3ae24c4SRajan VajaDate:		March 2020
54*b3ae24c4SRajan VajaKernelVersion:	5.6
55*b3ae24c4SRajan VajaContact:	"Jolly Shah" <jollys@xilinx.com>
56*b3ae24c4SRajan VajaDescription:
57*b3ae24c4SRajan Vaja		This sysfs interface allows to set the shutdown scope for the
58*b3ae24c4SRajan Vaja		next shutdown request. When the next shutdown is performed, the
59*b3ae24c4SRajan Vaja		platform specific portion of PSCI-system_off can use the chosen
60*b3ae24c4SRajan Vaja		shutdown scope.
61*b3ae24c4SRajan Vaja
62*b3ae24c4SRajan Vaja		Following are available shutdown scopes(subtypes):
63*b3ae24c4SRajan Vaja
64*b3ae24c4SRajan Vaja		subsystem:	Only the APU along with all of its peripherals
65*b3ae24c4SRajan Vaja				not used by other processing units will be
66*b3ae24c4SRajan Vaja				shut down. This may result in the FPD power
67*b3ae24c4SRajan Vaja				domain being shut down provided that no other
68*b3ae24c4SRajan Vaja				processing unit uses FPD peripherals or DRAM.
69*b3ae24c4SRajan Vaja		ps_only:	The complete PS will be shut down, including the
70*b3ae24c4SRajan Vaja				RPU, PMU, etc.  Only the PL domain (FPGA)
71*b3ae24c4SRajan Vaja				remains untouched.
72*b3ae24c4SRajan Vaja		system:		The complete system/device is shut down.
73*b3ae24c4SRajan Vaja
74*b3ae24c4SRajan Vaja		Usage:
75*b3ae24c4SRajan Vaja		# cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
76*b3ae24c4SRajan Vaja		# echo <scope> > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
77*b3ae24c4SRajan Vaja
78*b3ae24c4SRajan Vaja		Example:
79*b3ae24c4SRajan Vaja		# cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
80*b3ae24c4SRajan Vaja		# echo "subsystem" > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
81*b3ae24c4SRajan Vaja
82*b3ae24c4SRajan VajaUsers:		Xilinx
83