Documentation/ABI/testing/debugfs-cros-ec

Source file repositories/reference/linux-study-clean/Documentation/ABI/testing/debugfs-cros-ec

File Facts

System
Linux kernel
Corpus path
Documentation/ABI/testing/debugfs-cros-ec
Extension
[no extension]
Size
3224 bytes
Lines
79
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: Documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

What:		/sys/kernel/debug/<cros-ec-device>/console_log
Date:		September 2017
KernelVersion:	4.13
Description:
		If the EC supports the CONSOLE_READ command type, this file
		can be used to grab the EC logs. The kernel polls for the log
		and keeps its own buffer but userspace should grab this and
		write it out to some logs.

What:		/sys/kernel/debug/<cros-ec-device>/panicinfo
Date:		September 2017
KernelVersion:	4.13
Description:
		This file dumps the EC panic information from the previous
		reboot. This file will only exist if the PANIC_INFO command
		type is supported by the EC.

What:		/sys/kernel/debug/<cros-ec-device>/pdinfo
Date:		June 2018
KernelVersion:	4.17
Description:
		This file provides the port role, muxes and power debug
		information for all the USB PD/type-C ports available. If
		the are no ports available, this file will be just an empty
		file.

What:		/sys/kernel/debug/<cros-ec-device>/uptime
Date:		June 2019
KernelVersion:	5.3
Description:
		A u32 providing the time since EC booted in ms. This is
		is used for synchronizing the AP host time with the EC
		log. An error is returned if the command is not supported
		by the EC or there is a communication problem.

What:		/sys/kernel/debug/<cros-ec-device>/last_resume_result
Date:		June 2019
KernelVersion:	5.3
Description:
		Some ECs have a feature where they will track transitions to
		the (Intel) processor's SLP_S0 line, in order to detect cases
		where a system failed to go into S0ix. When the system resumes,
		an EC with this feature will return a summary of SLP_S0
		transitions that occurred. The last_resume_result file returns
		the most recent response from the AP's resume message to the EC.

		The bottom 31 bits contain a count of the number of SLP_S0
		transitions that occurred since the suspend message was
		received. Bit 31 is set if the EC attempted to wake the
		system due to a timeout when watching for SLP_S0 transitions.
		Callers can use this to detect a wake from the EC due to
		S0ix timeouts. The result will be zero if no suspend
		transitions have been attempted, or the EC does not support
		this feature.

		Output will be in the format: "0x%08x\n".

What:		/sys/kernel/debug/<cros-ec-device>/suspend_timeout_ms
Date:		August 2022
KernelVersion:	6.1
Description:
		Some ECs have a feature where they will track transitions of
		a hardware-controlled sleep line, such as Intel's SLP_S0 line,
		in order to detect cases where a system failed to go into deep
		sleep states. The suspend_timeout_ms file controls the amount of
		time in milliseconds the EC will wait before declaring a sleep
		timeout event and attempting to wake the system.

		Supply 0 to use the default value coded into EC firmware. Supply
		65535 (EC_HOST_SLEEP_TIMEOUT_INFINITE) to disable the EC sleep

Annotation

Implementation Notes