Documentation/ABI/testing/sysfs-driver-chromeos-acpi

   1 What:           /sys/bus/platform/devices/GGL0001:*/BINF.2
   2                 /sys/bus/platform/devices/GOOG0016:*/BINF.2
   3 Date:           May 2022
   4 KernelVersion:  5.19
   5 Description:
   6                 Returns active EC firmware of current boot (boolean).
   7
   8                 == ===============================
   9                 0  Read only (recovery) firmware.
  10                 1  Rewritable firmware.
  11                 == ===============================
  12
  13 What:           /sys/bus/platform/devices/GGL0001:*/BINF.3
  14                 /sys/bus/platform/devices/GOOG0016:*/BINF.3
  15 Date:           May 2022
  16 KernelVersion:  5.19
  17 Description:
  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
  27 What:           /sys/bus/platform/devices/GGL0001:*/CHSW
  28                 /sys/bus/platform/devices/GOOG0016:*/CHSW
  29 Date:           May 2022
  30 KernelVersion:  5.19
  31 Description:
  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
  43 What:           /sys/bus/platform/devices/GGL0001:*/FMAP
  44                 /sys/bus/platform/devices/GOOG0016:*/FMAP
  45 Date:           May 2022
  46 KernelVersion:  5.19
  47 Description:
  48                 Returns physical memory address of the start of the main
  49                 processor firmware flashmap.
  50
  51 What:           /sys/bus/platform/devices/GGL0001:*/FRID
  52                 /sys/bus/platform/devices/GOOG0016:*/FRID
  53 Date:           May 2022
  54 KernelVersion:  5.19
  55 Description:
  56                 Returns firmware version for the read-only portion of the
  57                 main processor firmware.
  58
  59 What:           /sys/bus/platform/devices/GGL0001:*/FWID
  60                 /sys/bus/platform/devices/GOOG0016:*/FWID
  61 Date:           May 2022
  62 KernelVersion:  5.19
  63 Description:
  64                 Returns firmware version for the rewritable portion of the
  65                 main processor firmware.
  66
  67 What:           /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.0
  68                 /sys/bus/platform/devices/GOOG0016:*/GPIO.X/GPIO.0
  69 Date:           May 2022
  70 KernelVersion:  5.19
  71 Description:
  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
  82 What:           /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.1
  83                 /sys/bus/platform/devices/GOOG0016:*/GPIO.X/GPIO.1
  84 Date:           May 2022
  85 KernelVersion:  5.19
  86 Description:
  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
  94 What:           /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.2
  95                 /sys/bus/platform/devices/GOOG0016:*/GPIO.X/GPIO.2
  96 Date:           May 2022
  97 KernelVersion:  5.19
  98 Description:
  99                 Returns the GPIO number on the specified GPIO
 100                 controller.
 101
 102 What:           /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.3
 103                 /sys/bus/platform/devices/GOOG0016:*/GPIO.X/GPIO.3
 104 Date:           May 2022
 105 KernelVersion:  5.19
 106 Description:
 107                 Returns name of the GPIO controller.
 108
 109 What:           /sys/bus/platform/devices/GGL0001:*/HWID
 110                 /sys/bus/platform/devices/GOOG0016:*/HWID
 111 Date:           May 2022
 112 KernelVersion:  5.19
 113 Description:
 114                 Returns hardware ID for the Chromebook.
 115
 116 What:           /sys/bus/platform/devices/GGL0001:*/MECK
 117                 /sys/bus/platform/devices/GOOG0016:*/MECK
 118 Date:           May 2022
 119 KernelVersion:  5.19
 120 Description:
 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
 127 What:           /sys/bus/platform/devices/GGL0001:*/VBNV.0
 128                 /sys/bus/platform/devices/GOOG0016:*/VBNV.0
 129 Date:           May 2022
 130 KernelVersion:  5.19
 131 Description:
 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
 137 What:           /sys/bus/platform/devices/GGL0001:*/VBNV.1
 138                 /sys/bus/platform/devices/GOOG0016:*/VBNV.1
 139 Date:           May 2022
 140 KernelVersion:  5.19
 141 Description:
 142                 Return the size in bytes of the verified boot non-volatile
 143                 storage block.
 144
 145 What:           /sys/bus/platform/devices/GGL0001:*/VDAT
 146                 /sys/bus/platform/devices/GOOG0016:*/VDAT
 147 Date:           May 2022
 148 KernelVersion:  5.19
 149 Description:
 150                 Returns the verified boot data block shared between the
 151                 firmware verification step and the kernel verification step
 152                 (hex dump).