Linux/Documentation/ABI/stable/sysfs-driver-firmware-zynqmp

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

1 What: /sys/devices/platform/firmware 1 What: /sys/devices/platform/firmware\:zynqmp-firmware/ggs* 2 Date: March 2020 2 Date: March 2020 3 KernelVersion: 5.6 3 KernelVersion: 5.6 4 Contact: "Jolly Shah" <jollys@xilinx.com 4 Contact: "Jolly Shah" <jollys@xilinx.com> 5 Description: 5 Description: 6 Read/Write PMU global general 6 Read/Write PMU global general storage register value, 7 GLOBAL_GEN_STORAGE{0:3}. 7 GLOBAL_GEN_STORAGE{0:3}. 8 Global general storage registe 8 Global general storage register that can be used 9 by system to pass information 9 by system to pass information between masters. 10 10 11 The register is reset during s 11 The register is reset during system or power-on 12 resets. Three registers are us 12 resets. Three registers are used by the FSBL and 13 other Xilinx software products 13 other Xilinx software products: GLOBAL_GEN_STORAGE{4:6}. 14 14 15 Usage:: 15 Usage:: 16 16 17 # cat /sys/devices/platfor 17 # cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 18 # echo <value> > /sys/devi 18 # echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 19 19 20 Example:: 20 Example:: 21 21 22 # cat /sys/devices/platfor 22 # cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 23 # echo 0x1234ABCD > /sys/d 23 # echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 24 24 25 Users: Xilinx 25 Users: Xilinx 26 26 27 What: /sys/devices/platform/firmware 27 What: /sys/devices/platform/firmware\:zynqmp-firmware/pggs* 28 Date: March 2020 28 Date: March 2020 29 KernelVersion: 5.6 29 KernelVersion: 5.6 30 Contact: "Jolly Shah" <jollys@xilinx.com 30 Contact: "Jolly Shah" <jollys@xilinx.com> 31 Description: 31 Description: 32 Read/Write PMU persistent glob 32 Read/Write PMU persistent global general storage register 33 value, PERS_GLOB_GEN_STORAGE{0 33 value, PERS_GLOB_GEN_STORAGE{0:3}. 34 Persistent global general stor 34 Persistent global general storage register that 35 can be used by system to pass 35 can be used by system to pass information between 36 masters. 36 masters. 37 37 38 This register is only reset by 38 This register is only reset by the power-on reset 39 and maintains its value throug 39 and maintains its value through a system reset. 40 Four registers are used by the 40 Four registers are used by the FSBL and other Xilinx 41 software products: PERS_GLOB_G 41 software products: PERS_GLOB_GEN_STORAGE{4:7}. 42 Register is reset only by a PO 42 Register is reset only by a POR reset. 43 43 44 Usage:: 44 Usage:: 45 45 46 # cat /sys/devices/platfor 46 # cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 47 # echo <value> > /sys/devi 47 # echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 48 48 49 Example:: 49 Example:: 50 50 51 # cat /sys/devices/platfor 51 # cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 52 # echo 0x1234ABCD > /sys/d 52 # echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 53 53 54 Users: Xilinx 54 Users: Xilinx 55 55 56 What: /sys/devices/platform/firmware 56 What: /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 57 Date: March 2020 57 Date: March 2020 58 KernelVersion: 5.6 58 KernelVersion: 5.6 59 Contact: "Jolly Shah" <jollys@xilinx.com 59 Contact: "Jolly Shah" <jollys@xilinx.com> 60 Description: 60 Description: 61 This sysfs interface allows to 61 This sysfs interface allows to set the shutdown scope for the 62 next shutdown request. When th 62 next shutdown request. When the next shutdown is performed, the 63 platform specific portion of P 63 platform specific portion of PSCI-system_off can use the chosen 64 shutdown scope. 64 shutdown scope. 65 65 66 Following are available shutdo 66 Following are available shutdown scopes(subtypes): 67 67 68 subsystem: 68 subsystem: 69 Only the APU a 69 Only the APU along with all of its peripherals 70 not used by ot 70 not used by other processing units will be 71 shut down. Thi 71 shut down. This may result in the FPD power 72 domain being s 72 domain being shut down provided that no other 73 processing uni 73 processing unit uses FPD peripherals or DRAM. 74 ps_only: 74 ps_only: 75 The complete P 75 The complete PS will be shut down, including the 76 RPU, PMU, etc. 76 RPU, PMU, etc. Only the PL domain (FPGA) 77 remains untouc 77 remains untouched. 78 system: 78 system: 79 The complete s 79 The complete system/device is shut down. 80 80 81 Usage:: 81 Usage:: 82 82 83 # cat /sys/devices/platfor 83 # cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 84 # echo <scope> > /sys/devi 84 # echo <scope> > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 85 85 86 Example:: 86 Example:: 87 87 88 # cat /sys/devices/platfor 88 # cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 89 # echo "subsystem" > /sys/ 89 # echo "subsystem" > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 90 90 91 Users: Xilinx 91 Users: Xilinx 92 92 93 What: /sys/devices/platform/firmware 93 What: /sys/devices/platform/firmware\:zynqmp-firmware/health_status 94 Date: March 2020 94 Date: March 2020 95 KernelVersion: 5.6 95 KernelVersion: 5.6 96 Contact: "Jolly Shah" <jollys@xilinx.com 96 Contact: "Jolly Shah" <jollys@xilinx.com> 97 Description: 97 Description: 98 This sysfs interface allows to 98 This sysfs interface allows to set the health status. If PMUFW 99 is compiled with CHECK_HEALTHY 99 is compiled with CHECK_HEALTHY_BOOT, it will check the healthy 100 bit on FPD WDT expiration. If 100 bit on FPD WDT expiration. If healthy bit is set by a user 101 application running in Linux, 101 application running in Linux, PMUFW will do APU only restart. If 102 healthy bit is not set during 102 healthy bit is not set during FPD WDT expiration, PMUFW will do 103 system restart. 103 system restart. 104 104 105 Usage: 105 Usage: 106 106 107 Set healthy bit:: 107 Set healthy bit:: 108 108 109 # echo 1 > /sys/devices/pl 109 # echo 1 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status 110 110 111 Unset healthy bit:: 111 Unset healthy bit:: 112 112 113 # echo 0 > /sys/devices/pl 113 # echo 0 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status 114 114 115 Users: Xilinx 115 Users: Xilinx 116 << 117 What: /sys/devices/platform/firmware << 118 Date: Feb 2022 << 119 KernelVersion: 5.18 << 120 Contact: "Ronak Jain" <ronak.jain@xilinx << 121 Description: << 122 This sysfs interface allows us << 123 runtime. The user can enable o << 124 firmware as well as the user c << 125 the features at runtime. The s << 126 temperature and external watch << 127 is completely different than t << 128 watchdog is running on the fir << 129 the health of firmware not APU << 130 watchdog is interfaced outside << 131 << 132 The supported config ids are f << 133 1. PM_FEATURE_OVERTEMP_STATUS << 134 disable the over temperature f << 135 2. PM_FEATURE_OVERTEMP_VALUE = << 136 over temperature limit in Degr << 137 3. PM_FEATURE_EXTWDT_STATUS = << 138 the external watchdog feature. << 139 4. PM_FEATURE_EXTWDT_VALUE = 4 << 140 external watchdog feature. << 141 << 142 Usage: << 143 << 144 Select over temperature config << 145 # echo 1 > /sys/devices/platfo << 146 << 147 Check over temperature config << 148 # cat /sys/devices/platform/fi << 149 The expected result is 1. << 150 << 151 Select over temperature config << 152 # echo 2 > /sys/devices/platfo << 153 << 154 Check over temperature config << 155 # cat /sys/devices/platform/fi << 156 The expected result is 2. << 157 << 158 Select external watchdog confi << 159 # echo 3 > /sys/devices/platfo << 160 << 161 Check external watchdog config << 162 # cat /sys/devices/platform/fi << 163 The expected result is 3. << 164 << 165 Select external watchdog confi << 166 # echo 4 > /sys/devices/platfo << 167 << 168 Check external watchdog config << 169 # cat /sys/devices/platform/fi << 170 The expected result is 4. << 171 << 172 Users: Xilinx << 173 << 174 What: /sys/devices/platform/firmware << 175 Date: Feb 2022 << 176 KernelVersion: 5.18 << 177 Contact: "Ronak Jain" <ronak.jain@xilinx << 178 Description: << 179 This sysfs interface allows to << 180 The user can enable or disable << 181 Also, the user can configure t << 182 at runtime. The supported feat << 183 external watchdog. Here, the e << 184 different than the /dev/watchd << 185 running on the firmware and it << 186 of firmware not APU(Linux). Al << 187 interfaced outside of the zynq << 188 << 189 By default the features are di << 190 can enable features by queryin << 191 features. << 192 << 193 The default limit for the over << 194 The default timer interval for << 195 << 196 The supported config ids are f << 197 1. PM_FEATURE_OVERTEMP_STATUS << 198 disable the over temperature f << 199 2. PM_FEATURE_OVERTEMP_VALUE = << 200 over temperature limit in Degr << 201 3. PM_FEATURE_EXTWDT_STATUS = << 202 the external watchdog feature. << 203 4. PM_FEATURE_EXTWDT_VALUE = 4 << 204 external watchdog feature. << 205 << 206 Usage: << 207 << 208 Enable over temperature featur << 209 # echo 1 > /sys/devices/platfo << 210 # echo 1 > /sys/devices/platfo << 211 << 212 Check whether the over tempera << 213 # cat /sys/devices/platform/fi << 214 The expected result is 1. << 215 << 216 Disable over temperature featu << 217 # echo 1 > /sys/devices/platfo << 218 # echo 0 > /sys/devices/platfo << 219 << 220 Check whether the over tempera << 221 # cat /sys/devices/platform/fi << 222 The expected result is 0. << 223 << 224 Configure over temperature lim << 225 # echo 2 > /sys/devices/platfo << 226 # echo 50 > /sys/devices/platf << 227 << 228 Check whether the over tempera << 229 # cat /sys/devices/platform/fi << 230 The expected result is 50. << 231 << 232 Enable external watchdog featu << 233 # echo 3 > /sys/devices/platfo << 234 # echo 1 > /sys/devices/platfo << 235 << 236 Check whether the external wat << 237 # cat /sys/devices/platform/fi << 238 The expected result is 1. << 239 << 240 Disable external watchdog feat << 241 # echo 3 > /sys/devices/platfo << 242 # echo 0 > /sys/devices/platfo << 243 << 244 Check whether the external wat << 245 # cat /sys/devices/platform/fi << 246 The expected result is 0. << 247 << 248 Configure external watchdog ti << 249 # echo 4 > /sys/devices/platfo << 250 # echo 500 > /sys/devices/plat << 251 << 252 Check whether the external wat << 253 # cat /sys/devices/platform/fi << 254 The expected result is 500. << 255 << 256 Users: Xilinx <<

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/stable/sysfs-driver-firmware-zynqmp

Diff markup

Differences between /Documentation/ABI/stable/sysfs-driver-firmware-zynqmp (Version linux-6.12-rc7) and /Documentation/ABI/stable/sysfs-driver-firmware-zynqmp (Version linux-5.12.19)

TOMOYO Linux Cross Reference Linux/Documentation/ABI/stable/sysfs-driver-firmware-zynqmp

Diff markup

Differences between /Documentation/ABI/stable/sysfs-driver-firmware-zynqmp (Version linux-6.12-rc7) and /Documentation/ABI/stable/sysfs-driver-firmware-zynqmp (Version linux-5.12.19)

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/stable/sysfs-driver-firmware-zynqmp