ich777/linux_media
1
0
Fork 0
mirror of https://github.com/tbsdtv/linux_media.git synced 2025-07-23 20:51:03 +02:00
Code Issues Packages Projects Releases Wiki Activity

platform/chrome: Use imperative mood for ChromeOS ACPI sysfs ABI descriptions

Browse Source 
The current descriptions all begin with ("This file shows something")
clause, which is incorrect wording since these mean return value from
sysfs.

Use imperative mood ("Returns something") instead, in line with
corresponding ACPI documentation at firmware-guide/.

Cc: Benson Leung <bleung@google.com>
Cc: Guenter Roeck <groeck@chromium.org>
Cc: Andy Shevchenko <andy.shevchenko@gmail.com>
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Cc: Enric Balletbo i Serra <enric.balletbo@collabora.com>
Cc: Muhammad Usama Anjum <usama.anjum@collabora.com>
Cc: Tzung-Bi Shih <tzungbi@kernel.org>
Cc: Linux Kernel Mailing List <linux-kernel@vger.kernel.org>
Cc: Linux Next Mailing List <linux-next@vger.kernel.org>
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Reviewed-by: Muhammad Usama Anjum <usama.anjum@collabora.com>
Signed-off-by: Tzung-Bi Shih <tzungbi@kernel.org>
Link: https://lore.kernel.org/r/20220518083524.37380-3-bagasdotme@gmail.com
This commit is contained in:
Bagas Sanjaya
2022-05-18 15:35:24 +07:00
committed by Tzung-Bi Shih
parent a6c13d87b4
commit abd4fd43f2
1 changed files with 30 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files

63
Documentation/ABI/testing/sysfs-driver-chromeos-acpi
View File

@@ -2,8 +2,7 @@ What: /sys/bus/platform/devices/GGL0001:*/BINF.2
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows information about the current boot of Returns active EC firmware of current boot (boolean).
the active EC firmware.
== =============================== == ===============================
0 Read only (recovery) firmware. 0 Read only (recovery) firmware.
@@ -14,8 +13,7 @@ What: /sys/bus/platform/devices/GGL0001:*/BINF.3
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows information about the current boot of Returns main firmware type for current boot (integer).
the active main firmware type.
== ===================================== == =====================================
0 Recovery. 0 Recovery.
@@ -28,8 +26,8 @@ What: /sys/bus/platform/devices/GGL0001:*/CHSW
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the switch position for the Chrome OS specific Returns switch position for Chrome OS specific hardware
hardware switches when the firmware is booted. switches when the firmware is booted (integer).
==== =========================================== ==== ===========================================
0 No changes. 0 No changes.
@@ -43,29 +41,29 @@ What: /sys/bus/platform/devices/GGL0001:*/FMAP
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the physical memory address of the start of Returns physical memory address of the start of the main
the main processor firmware flashmap. processor firmware flashmap.
What: /sys/bus/platform/devices/GGL0001:*/FRID What: /sys/bus/platform/devices/GGL0001:*/FRID
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the firmware version for the read-only portion Returns firmware version for the read-only portion of the
of the main processor firmware. main processor firmware.
What: /sys/bus/platform/devices/GGL0001:*/FWID What: /sys/bus/platform/devices/GGL0001:*/FWID
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the firmware version for the rewritable portion Returns firmware version for the rewritable portion of the
of the main processor firmware. main processor firmware.
What: /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.0 What: /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.0
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the type of the GPIO signal for the Chrome OS Returns type of the GPIO signal for the Chrome OS specific
specific GPIO assignments. GPIO assignments (integer).
=========== ================================== =========== ==================================
1 Recovery button. 1 Recovery button.
@@ -78,7 +76,7 @@ What: /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.1
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the signal attributes of the GPIO signal. Returns signal attributes of the GPIO signal (integer bitfield).
== ======================= == =======================
0 Signal is active low. 0 Signal is active low.
@@ -89,52 +87,51 @@ What: /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.2
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the GPIO number on the specified GPIO Returns the GPIO number on the specified GPIO
controller. controller.
What: /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.3 What: /sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.3
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the name of the GPIO controller. Returns name of the GPIO controller.
What: /sys/bus/platform/devices/GGL0001:*/HWID What: /sys/bus/platform/devices/GGL0001:*/HWID
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the hardware ID for the Chromebook. Returns hardware ID for the Chromebook.
What: /sys/bus/platform/devices/GGL0001:*/MECK What: /sys/bus/platform/devices/GGL0001:*/MECK
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This binary file returns the SHA-1 or SHA-256 hash that is Returns the SHA-1 or SHA-256 hash that is read out of the
read out of the Management Engine extended registers during Management Engine extended registers during boot. The hash
boot. The hash is exported vi ACPI so the OS can verify that is exported via ACPI so the OS can verify that the Management
the Management Engine firmware has not changed. If Management Engine firmware has not changed. If Management Engine is not
Engine is not present, or if the firmware was unable to read the present, or if the firmware was unable to read the extended registers, this buffer size can be zero.
extended registers, this buffer size can be zero.
What: /sys/bus/platform/devices/GGL0001:*/VBNV.0 What: /sys/bus/platform/devices/GGL0001:*/VBNV.0
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the offset in CMOS bank 0 of the verified boot Returns offset in CMOS bank 0 of the verified boot non-volatile
non-volatile storage block, counting from the first writable storage block, counting from the first writable CMOS byte
CMOS byte (that is, 'offset = 0' is the byte following the 14 (that is, 'offset = 0' is the byte following the 14 bytes of
bytes of clock data). clock data).
What: /sys/bus/platform/devices/GGL0001:*/VBNV.1 What: /sys/bus/platform/devices/GGL0001:*/VBNV.1
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This file shows the size in bytes of the verified boot Return the size in bytes of the verified boot non-volatile
non-volatile storage block. storage block.
What: /sys/bus/platform/devices/GGL0001:*/VDAT What: /sys/bus/platform/devices/GGL0001:*/VDAT
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Description: Description:
This binary file returns the verified boot data block shared Returns the verified boot data block shared between the
between the firmware verification step and the kernel firmware verification step and the kernel verification step
verification step. (binary).