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