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