| 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 |
| failure detection mechanism. Values in between 0 and 65535 |
| indicate the number of milliseconds the EC should wait after a |
| sleep transition before declaring a timeout. This includes both |
| the duration after a sleep command was received but before the |
| hardware line changed, as well as the duration between when the |
| hardware line changed and the kernel sent an EC resume command. |
| |
| Output will be in the format: "%u\n". |
