xref: /openbmc/linux/Documentation/ABI/testing/sysfs-class-firmware (revision 97730bbb242cde22b7140acd202ffd88823886c9)
1*97730bbbSRuss WeightWhat: 		/sys/class/firmware/.../data
2*97730bbbSRuss WeightDate:		July 2022
3*97730bbbSRuss WeightKernelVersion:	5.19
4*97730bbbSRuss WeightContact:	Russ Weight <russell.h.weight@intel.com>
5*97730bbbSRuss WeightDescription:	The data sysfs file is used for firmware-fallback and for
6*97730bbbSRuss Weight		firmware uploads. Cat a firmware image to this sysfs file
7*97730bbbSRuss Weight		after you echo 1 to the loading sysfs file. When the firmware
8*97730bbbSRuss Weight		image write is complete, echo 0 to the loading sysfs file. This
9*97730bbbSRuss Weight		sequence will signal the completion of the firmware write and
10*97730bbbSRuss Weight		signal the lower-level driver that the firmware data is
11*97730bbbSRuss Weight		available.
12*97730bbbSRuss Weight
13*97730bbbSRuss WeightWhat: 		/sys/class/firmware/.../loading
14*97730bbbSRuss WeightDate:		July 2022
15*97730bbbSRuss WeightKernelVersion:	5.19
16*97730bbbSRuss WeightContact:	Russ Weight <russell.h.weight@intel.com>
17*97730bbbSRuss WeightDescription:	The loading sysfs file is used for both firmware-fallback and
18*97730bbbSRuss Weight		for firmware uploads. Echo 1 onto the loading file to indicate
19*97730bbbSRuss Weight		you are writing a firmware file to the data sysfs node. Echo
20*97730bbbSRuss Weight		-1 onto this file to abort the data write or echo 0 onto this
21*97730bbbSRuss Weight		file to indicate that the write is complete. For firmware
22*97730bbbSRuss Weight		uploads, the zero value also triggers the transfer of the
23*97730bbbSRuss Weight		firmware data to the lower-level device driver.
24*97730bbbSRuss Weight
25*97730bbbSRuss WeightWhat: 		/sys/class/firmware/.../timeout
26*97730bbbSRuss WeightDate:		July 2022
27*97730bbbSRuss WeightKernelVersion:	5.19
28*97730bbbSRuss WeightContact:	Russ Weight <russell.h.weight@intel.com>
29*97730bbbSRuss WeightDescription:	This file supports the timeout mechanism for firmware
30*97730bbbSRuss Weight		fallback.  This file has no affect on firmware uploads. For
31*97730bbbSRuss Weight		more information on timeouts please see the documentation
32*97730bbbSRuss Weight		for firmware fallback.
33