| Enric Balletbo i Serra | 1fbc6ec | 2019-06-14 12:23:47 +0200 | [diff] [blame] | 1 | What: /sys/kernel/debug/<cros-ec-device>/console_log |
| 2 | Date: September 2017 |
| 3 | KernelVersion: 4.13 |
| 4 | Description: |
| 5 | If the EC supports the CONSOLE_READ command type, this file |
| 6 | can be used to grab the EC logs. The kernel polls for the log |
| 7 | and keeps its own buffer but userspace should grab this and |
| 8 | write it out to some logs. |
| 9 | |
| 10 | What: /sys/kernel/debug/<cros-ec-device>/panicinfo |
| 11 | Date: September 2017 |
| 12 | KernelVersion: 4.13 |
| 13 | Description: |
| 14 | This file dumps the EC panic information from the previous |
| 15 | reboot. This file will only exist if the PANIC_INFO command |
| 16 | type is supported by the EC. |
| 17 | |
| 18 | What: /sys/kernel/debug/<cros-ec-device>/pdinfo |
| 19 | Date: June 2018 |
| 20 | KernelVersion: 4.17 |
| 21 | Description: |
| 22 | This file provides the port role, muxes and power debug |
| 23 | information for all the USB PD/type-C ports available. If |
| 24 | the are no ports available, this file will be just an empty |
| 25 | file. |
| 26 | |
| Tim Wawrzynczak | e90716a | 2019-06-13 11:57:36 -0600 | [diff] [blame] | 27 | What: /sys/kernel/debug/<cros-ec-device>/uptime |
| 28 | Date: June 2019 |
| 29 | KernelVersion: 5.3 |
| 30 | Description: |
| 31 | A u32 providing the time since EC booted in ms. This is |
| 32 | is used for synchronizing the AP host time with the EC |
| 33 | log. An error is returned if the command is not supported |
| 34 | by the EC or there is a communication problem. |
| Evan Green | 8c3166e | 2019-06-27 13:44:45 -0700 | [diff] [blame] | 35 | |
| 36 | What: /sys/kernel/debug/<cros-ec-device>/last_resume_result |
| 37 | Date: June 2019 |
| 38 | KernelVersion: 5.3 |
| 39 | Description: |
| 40 | Some ECs have a feature where they will track transitions to |
| 41 | the (Intel) processor's SLP_S0 line, in order to detect cases |
| 42 | where a system failed to go into S0ix. When the system resumes, |
| 43 | an EC with this feature will return a summary of SLP_S0 |
| 44 | transitions that occurred. The last_resume_result file returns |
| 45 | the most recent response from the AP's resume message to the EC. |
| 46 | |
| 47 | The bottom 31 bits contain a count of the number of SLP_S0 |
| 48 | transitions that occurred since the suspend message was |
| 49 | received. Bit 31 is set if the EC attempted to wake the |
| 50 | system due to a timeout when watching for SLP_S0 transitions. |
| 51 | Callers can use this to detect a wake from the EC due to |
| 52 | S0ix timeouts. The result will be zero if no suspend |
| 53 | transitions have been attempted, or the EC does not support |
| 54 | this feature. |
| 55 | |
| 56 | Output will be in the format: "0x%08x\n". |
| Evan Green | e8bf17d | 2022-08-22 14:40:40 -0700 | [diff] [blame] | 57 | |
| 58 | What: /sys/kernel/debug/<cros-ec-device>/suspend_timeout_ms |
| 59 | Date: August 2022 |
| 60 | KernelVersion: 6.1 |
| 61 | Description: |
| 62 | Some ECs have a feature where they will track transitions of |
| 63 | a hardware-controlled sleep line, such as Intel's SLP_S0 line, |
| 64 | in order to detect cases where a system failed to go into deep |
| 65 | sleep states. The suspend_timeout_ms file controls the amount of |
| 66 | time in milliseconds the EC will wait before declaring a sleep |
| 67 | timeout event and attempting to wake the system. |
| 68 | |
| 69 | Supply 0 to use the default value coded into EC firmware. Supply |
| 70 | 65535 (EC_HOST_SLEEP_TIMEOUT_INFINITE) to disable the EC sleep |
| 71 | failure detection mechanism. Values in between 0 and 65535 |
| 72 | indicate the number of milliseconds the EC should wait after a |
| 73 | sleep transition before declaring a timeout. This includes both |
| 74 | the duration after a sleep command was received but before the |
| 75 | hardware line changed, as well as the duration between when the |
| 76 | hardware line changed and the kernel sent an EC resume command. |
| 77 | |
| 78 | Output will be in the format: "%u\n". |
