2020-09-29 17:52:14 +00:00
|
|
|
What: /sys/bus/mhi/devices/.../serialnumber
|
|
|
|
|
Date: Sept 2020
|
|
|
|
|
KernelVersion: 5.10
|
2023-06-28 18:23:46 +00:00
|
|
|
Contact: mhi@lists.linux.dev
|
2020-09-29 17:52:14 +00:00
|
|
|
Description: The file holds the serial number of the client device obtained
|
|
|
|
|
using a BHI (Boot Host Interface) register read after at least
|
|
|
|
|
one attempt to power up the device has been done. If read
|
|
|
|
|
without having the device power on at least once, the file will
|
|
|
|
|
read all 0's.
|
|
|
|
|
Users: Any userspace application or clients interested in device info.
|
|
|
|
|
|
|
|
|
|
What: /sys/bus/mhi/devices/.../oem_pk_hash
|
|
|
|
|
Date: Sept 2020
|
|
|
|
|
KernelVersion: 5.10
|
2023-06-28 18:23:46 +00:00
|
|
|
Contact: mhi@lists.linux.dev
|
2020-09-29 17:52:14 +00:00
|
|
|
Description: The file holds the OEM PK Hash value of the endpoint device
|
|
|
|
|
obtained using a BHI (Boot Host Interface) register read after
|
|
|
|
|
at least one attempt to power up the device has been done. If
|
|
|
|
|
read without having the device power on at least once, the file
|
|
|
|
|
will read all 0's.
|
|
|
|
|
Users: Any userspace application or clients interested in device info.
|
bus: mhi: host: Add soc_reset sysfs
The MHI bus supports a standardized hardware reset, which is known as the
"SoC Reset". This reset is similar to the reset sysfs for PCI devices -
a hardware mechanism to reset the state back to square one.
The MHI SoC Reset is described in the spec as a reset of last resort. If
some unrecoverable error has occurred where other resets have failed, SoC
Reset is the "big hammer" that ungracefully resets the device. This is
effectivly the same as yanking the power on the device, and reapplying it.
However, depending on the nature of the particular issue, the underlying
transport link may remain active and configured. If the link remains up,
the device will flag a MHI system error early in the boot process after
the reset is executed, which allows the MHI bus to process a fatal error
event, and clean up appropiately.
While the SoC Reset is generally intended as a means of recovery when all
else has failed, it can be useful in non-error scenarios. For example,
if the device loads firmware from the host filesystem, the device may need
to be fully rebooted inorder to pick up the new firmware. In this
scenario, the system administrator may use the soc_reset sysfs to cause
the device to pick up the new firmware that the admin placed on the
filesystem.
Signed-off-by: Jeffrey Hugo <quic_jhugo@quicinc.com>
Reviewed-by: Bhaumik Bhatt <quic_bbhatt@quicinc.com>
Reviewed-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
Link: https://lore.kernel.org/r/1650302327-30439-1-git-send-email-quic_jhugo@quicinc.com
Signed-off-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
2022-04-18 17:18:47 +00:00
|
|
|
|
|
|
|
|
What: /sys/bus/mhi/devices/.../soc_reset
|
|
|
|
|
Date: April 2022
|
|
|
|
|
KernelVersion: 5.19
|
|
|
|
|
Contact: mhi@lists.linux.dev
|
|
|
|
|
Description: Initiates a SoC reset on the MHI controller. A SoC reset is
|
|
|
|
|
a reset of last resort, and will require a complete re-init.
|
|
|
|
|
This can be useful as a method of recovery if the device is
|
|
|
|
|
non-responsive, or as a means of loading new firmware as a
|
|
|
|
|
system administration task.
|
2024-04-24 03:21:53 +00:00
|
|
|
|
|
|
|
|
What: /sys/bus/mhi/devices/.../trigger_edl
|
|
|
|
|
Date: April 2024
|
|
|
|
|
KernelVersion: 6.10
|
|
|
|
|
Contact: mhi@lists.linux.dev
|
|
|
|
|
Description: Writing a non-zero value to this file will force devices to
|
|
|
|
|
enter EDL (Emergency Download) mode. This entry only exists for
|
|
|
|
|
devices capable of entering the EDL mode using the standard EDL
|
|
|
|
|
triggering mechanism defined in the MHI spec v1.2. Once in EDL
|
|
|
|
|
mode, the flash programmer image can be downloaded to the
|
|
|
|
|
device to enter the flash programmer execution environment.
|
|
|
|
|
This can be useful if user wants to use QDL (Qualcomm Download,
|
|
|
|
|
which is used to download firmware over EDL) to update firmware.
|