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 # cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 17 # cat /sys/devices/platfor !! 17 # echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 18 # echo <value> > /sys/devi << 19 << 20 Example:: << 21 18 22 # cat /sys/devices/platfor !! 19 Example: 23 # echo 0x1234ABCD > /sys/d !! 20 # cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 >> 21 # echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0 24 22 25 Users: Xilinx 23 Users: Xilinx 26 24 27 What: /sys/devices/platform/firmware 25 What: /sys/devices/platform/firmware\:zynqmp-firmware/pggs* 28 Date: March 2020 26 Date: March 2020 29 KernelVersion: 5.6 27 KernelVersion: 5.6 30 Contact: "Jolly Shah" <jollys@xilinx.com 28 Contact: "Jolly Shah" <jollys@xilinx.com> 31 Description: 29 Description: 32 Read/Write PMU persistent glob 30 Read/Write PMU persistent global general storage register 33 value, PERS_GLOB_GEN_STORAGE{0 31 value, PERS_GLOB_GEN_STORAGE{0:3}. 34 Persistent global general stor 32 Persistent global general storage register that 35 can be used by system to pass 33 can be used by system to pass information between 36 masters. 34 masters. 37 35 38 This register is only reset by 36 This register is only reset by the power-on reset 39 and maintains its value throug 37 and maintains its value through a system reset. 40 Four registers are used by the 38 Four registers are used by the FSBL and other Xilinx 41 software products: PERS_GLOB_G 39 software products: PERS_GLOB_GEN_STORAGE{4:7}. 42 Register is reset only by a PO 40 Register is reset only by a POR reset. 43 41 44 Usage:: !! 42 Usage: 45 !! 43 # cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 46 # cat /sys/devices/platfor !! 44 # echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 47 # echo <value> > /sys/devi << 48 << 49 Example:: << 50 45 51 # cat /sys/devices/platfor !! 46 Example: 52 # echo 0x1234ABCD > /sys/d !! 47 # cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 >> 48 # echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0 53 49 54 Users: Xilinx 50 Users: Xilinx 55 51 56 What: /sys/devices/platform/firmware 52 What: /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 57 Date: March 2020 53 Date: March 2020 58 KernelVersion: 5.6 54 KernelVersion: 5.6 59 Contact: "Jolly Shah" <jollys@xilinx.com 55 Contact: "Jolly Shah" <jollys@xilinx.com> 60 Description: 56 Description: 61 This sysfs interface allows to 57 This sysfs interface allows to set the shutdown scope for the 62 next shutdown request. When th 58 next shutdown request. When the next shutdown is performed, the 63 platform specific portion of P 59 platform specific portion of PSCI-system_off can use the chosen 64 shutdown scope. 60 shutdown scope. 65 61 66 Following are available shutdo 62 Following are available shutdown scopes(subtypes): 67 63 68 subsystem: !! 64 subsystem: Only the APU along with all of its peripherals 69 Only the APU a << 70 not used by ot 65 not used by other processing units will be 71 shut down. Thi 66 shut down. This may result in the FPD power 72 domain being s 67 domain being shut down provided that no other 73 processing uni 68 processing unit uses FPD peripherals or DRAM. 74 ps_only: !! 69 ps_only: The complete PS will be shut down, including the 75 The complete P << 76 RPU, PMU, etc. 70 RPU, PMU, etc. Only the PL domain (FPGA) 77 remains untouc 71 remains untouched. 78 system: !! 72 system: The complete system/device is shut down. 79 The complete s << 80 << 81 Usage:: << 82 73 83 # cat /sys/devices/platfor !! 74 Usage: 84 # echo <scope> > /sys/devi !! 75 # cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 85 !! 76 # echo <scope> > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 86 Example:: << 87 77 88 # cat /sys/devices/platfor !! 78 Example: 89 # echo "subsystem" > /sys/ !! 79 # cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope >> 80 # echo "subsystem" > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope 90 81 91 Users: Xilinx 82 Users: Xilinx 92 83 93 What: /sys/devices/platform/firmware 84 What: /sys/devices/platform/firmware\:zynqmp-firmware/health_status 94 Date: March 2020 85 Date: March 2020 95 KernelVersion: 5.6 86 KernelVersion: 5.6 96 Contact: "Jolly Shah" <jollys@xilinx.com 87 Contact: "Jolly Shah" <jollys@xilinx.com> 97 Description: 88 Description: 98 This sysfs interface allows to 89 This sysfs interface allows to set the health status. If PMUFW 99 is compiled with CHECK_HEALTHY 90 is compiled with CHECK_HEALTHY_BOOT, it will check the healthy 100 bit on FPD WDT expiration. If 91 bit on FPD WDT expiration. If healthy bit is set by a user 101 application running in Linux, 92 application running in Linux, PMUFW will do APU only restart. If 102 healthy bit is not set during 93 healthy bit is not set during FPD WDT expiration, PMUFW will do 103 system restart. 94 system restart. 104 95 105 Usage: 96 Usage: >> 97 Set healthy bit >> 98 # echo 1 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status 106 99 107 Set healthy bit:: !! 100 Unset healthy bit 108 !! 101 # echo 0 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status 109 # echo 1 > /sys/devices/pl << 110 << 111 Unset healthy bit:: << 112 << 113 # echo 0 > /sys/devices/pl << 114 << 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 102 256 Users: Xilinx 103 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.9.16)

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.9.16)

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