xref: /linux/Documentation/ABI/testing/sysfs-driver-chromeos-acpi (revision 0a4cad9c11ad46662ede48d94f08ecb7cd9f6916)
1What:		/sys/bus/platform/devices/GGL0001:*/BINF.2
2Date:		May 2022
3KernelVersion:	5.19
4Description:
5		This file shows information about the current boot of
6		the active EC firmware.
7		  * 0 - Read only (recovery) firmware.
8		  * 1 - Rewritable firmware.
9
10What:		/sys/bus/platform/devices/GGL0001:*/BINF.3
11Date:		May 2022
12KernelVersion:	5.19
13Description:
14		This file shows information about the current boot of
15		the active main	firmware type.
16		  * 0 - Recovery.
17		  * 1 - Normal.
18		  * 2 - Developer.
19		  * 3 - Netboot (factory installation only).
20
21What:		/sys/bus/platform/devices/GGL0001:*/CHSW
22Date:		May 2022
23KernelVersion:	5.19
24Description:
25		This file shows the switch position for the Chrome OS specific
26		hardware switches.
27		  * 0   - No changes.
28		  * 2   - Recovery button was pressed when firmware booted.
29		  * 4   - Recovery button was pressed when EC firmware booted.
30		  * 32  - Developer switch was enabled when firmware booted.
31		  * 512 - Firmware write protection was disabled when firmware
32			  booted.
33
34What:		/sys/bus/platform/devices/GGL0001:*/FMAP
35Date:		May 2022
36KernelVersion:	5.19
37Description:
38		This file shows the physical memory address of the start of
39		the main processor firmware flashmap.
40
41What:		/sys/bus/platform/devices/GGL0001:*/FRID
42Date:		May 2022
43KernelVersion:	5.19
44Description:
45		This file shows the firmware version for the read-only portion
46		of the main processor firmware.
47
48What:		/sys/bus/platform/devices/GGL0001:*/FWID
49Date:		May 2022
50KernelVersion:	5.19
51Description:
52		This file shows the firmware version for the rewritable portion
53		of the main processor firmware.
54
55What:		/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.0
56Date:		May 2022
57KernelVersion:	5.19
58Description:
59		This file shows the type of the GPIO signal for the Chrome OS
60		specific GPIO assignments.
61		  * 1   - Recovery button.
62		  * 2   - Developer mode switch.
63		  * 3   - Firmware write protection switch.
64		  * 256 to 511 - Debug header GPIO 0 to GPIO 255.
65
66What:		/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.1
67Date:		May 2022
68KernelVersion:	5.19
69Description:
70		This file shows the signal attributes of the GPIO signal.
71		  * 0 - Signal is active low.
72		  * 1 - Signal is active high.
73
74What:		/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.2
75Date:		May 2022
76KernelVersion:	5.19
77Description:
78		This file shows the GPIO number on the specified GPIO
79		controller.
80
81What:		/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.3
82Date:		May 2022
83KernelVersion:	5.19
84Description:
85		This file shows the name of the GPIO controller.
86
87What:		/sys/bus/platform/devices/GGL0001:*/HWID
88Date:		May 2022
89KernelVersion:	5.19
90Description:
91		This file shows the hardware ID for the Chromebook.
92
93What:		/sys/bus/platform/devices/GGL0001:*/MECK
94Date:		May 2022
95KernelVersion:	5.19
96Description:
97		This binary file returns the SHA-1 or SHA-256 hash that is
98		read out of the Management Engine extended registers during
99		boot. The hash is exported vi ACPI so the OS can verify that
100		the Management Engine firmware has not changed. If Management
101		Engine is not present, or if the firmware was unable to read the
102		extended registers, this buffer size can be zero.
103
104What:		/sys/bus/platform/devices/GGL0001:*/VBNV.0
105Date:		May 2022
106KernelVersion:	5.19
107Description:
108		This file shows the offset in CMOS bank 0 of the verified boot
109		non-volatile storage block, counting from the first writable
110		CMOS byte (that is, 'offset = 0' is the byte following the 14
111		bytes of clock data).
112
113What:		/sys/bus/platform/devices/GGL0001:*/VBNV.1
114Date:		May 2022
115KernelVersion:	5.19
116Description:
117		This file shows the size in bytes of the verified boot
118		non-volatile storage block.
119
120What:		/sys/bus/platform/devices/GGL0001:*/VDAT
121Date:		May 2022
122KernelVersion:	5.19
123Description:
124		This binary file returns the verified boot data block shared
125		between the firmware verification step and the kernel
126		verification step.
127