Merge tag 'gcc-plugins-v5.11-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git...
[linux-2.6-microblaze.git] / Documentation / ABI / testing / debugfs-cros-ec
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
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.
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".