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