xref: /linux/Documentation/ABI/stable/sysfs-bus-mhi (revision c771600c6af14749609b49565ffb4cac2959710d)
121cb9b18SBhaumik BhattWhat:		/sys/bus/mhi/devices/.../serialnumber
221cb9b18SBhaumik BhattDate:		Sept 2020
321cb9b18SBhaumik BhattKernelVersion:	5.10
414a27140SJeffrey HugoContact:	mhi@lists.linux.dev
521cb9b18SBhaumik BhattDescription:	The file holds the serial number of the client device obtained
621cb9b18SBhaumik Bhatt		using a BHI (Boot Host Interface) register read after at least
721cb9b18SBhaumik Bhatt		one attempt to power up the device has been done. If read
821cb9b18SBhaumik Bhatt		without having the device power on at least once, the file will
921cb9b18SBhaumik Bhatt		read all 0's.
1021cb9b18SBhaumik BhattUsers:		Any userspace application or clients interested in device info.
1121cb9b18SBhaumik Bhatt
1221cb9b18SBhaumik BhattWhat:		/sys/bus/mhi/devices/.../oem_pk_hash
1321cb9b18SBhaumik BhattDate:		Sept 2020
1421cb9b18SBhaumik BhattKernelVersion:	5.10
1514a27140SJeffrey HugoContact:	mhi@lists.linux.dev
1621cb9b18SBhaumik BhattDescription:	The file holds the OEM PK Hash value of the endpoint device
1721cb9b18SBhaumik Bhatt		obtained using a BHI (Boot Host Interface) register read after
1821cb9b18SBhaumik Bhatt		at least one attempt to power up the device has been done. If
1921cb9b18SBhaumik Bhatt		read without having the device power on at least once, the file
2021cb9b18SBhaumik Bhatt		will read all 0's.
2121cb9b18SBhaumik BhattUsers:		Any userspace application or clients interested in device info.
2295c33ae4SJeffrey Hugo
2395c33ae4SJeffrey HugoWhat:           /sys/bus/mhi/devices/.../soc_reset
2495c33ae4SJeffrey HugoDate:           April 2022
2595c33ae4SJeffrey HugoKernelVersion:  5.19
2695c33ae4SJeffrey HugoContact:        mhi@lists.linux.dev
2795c33ae4SJeffrey HugoDescription:	Initiates a SoC reset on the MHI controller.  A SoC reset is
2895c33ae4SJeffrey Hugo                a reset of last resort, and will require a complete re-init.
2995c33ae4SJeffrey Hugo                This can be useful as a method of recovery if the device is
3095c33ae4SJeffrey Hugo                non-responsive, or as a means of loading new firmware as a
3195c33ae4SJeffrey Hugo                system administration task.
32*17553ba8SQiang Yu
33*17553ba8SQiang YuWhat:           /sys/bus/mhi/devices/.../trigger_edl
34*17553ba8SQiang YuDate:           April 2024
35*17553ba8SQiang YuKernelVersion:  6.10
36*17553ba8SQiang YuContact:        mhi@lists.linux.dev
37*17553ba8SQiang YuDescription:    Writing a non-zero value to this file will force devices to
38*17553ba8SQiang Yu                enter EDL (Emergency Download) mode. This entry only exists for
39*17553ba8SQiang Yu                devices capable of entering the EDL mode using the standard EDL
40*17553ba8SQiang Yu                triggering mechanism defined in the MHI spec v1.2. Once in EDL
41*17553ba8SQiang Yu                mode, the flash programmer image can be downloaded to the
42*17553ba8SQiang Yu                device to enter the flash programmer execution environment.
43*17553ba8SQiang Yu                This can be useful if user wants to use QDL (Qualcomm Download,
44*17553ba8SQiang Yu                which is used to download firmware over EDL) to update firmware.
45