Documentation/ABI/testing/sysfs-bus-acpi

   1 What:           /sys/bus/acpi/devices/.../path
   2 Date:           December 2006
   3 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
   4 Description:
   5                 This attribute indicates the full path of ACPI namespace
   6                 object associated with the device object.  For example,
   7                 \_SB_.PCI0.
   8
   9                 This file is not present for device objects representing
  10                 fixed ACPI hardware features (like power and sleep
  11                 buttons).
  12
  13 What:           /sys/bus/acpi/devices/.../modalias
  14 Date:           July 2007
  15 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  16 Description:
  17                 This attribute indicates the PNP IDs of the device object.
  18                 That is acpi:HHHHHHHH:[CCCCCCC:].  Where each HHHHHHHH or
  19                 CCCCCCCC contains device object's PNPID (_HID or _CID).
  20
  21 What:           /sys/bus/acpi/devices/.../hid
  22 Date:           April 2005
  23 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  24 Description:
  25                 This attribute indicates the hardware ID (_HID) of the
  26                 device object.  For example, PNP0103.
  27                 This file is present for device objects having the _HID
  28                 control method.
  29
  30 What:           /sys/bus/acpi/devices/.../description
  31 Date:           October 2012
  32 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  33 Description:
  34                 This attribute contains the output of the device object's
  35                 _STR control method, if present.
  36
  37 What:           /sys/bus/acpi/devices/.../adr
  38 Date:           October 2012
  39 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  40 Description:
  41                 This attribute contains the output of the device object's
  42                 _ADR control method, which is present for ACPI device
  43                 objects representing devices having standard enumeration
  44                 algorithms, such as PCI.
  45
  46 What:           /sys/bus/acpi/devices/.../uid
  47 Date:           October 2012
  48 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  49 Description:
  50                 This attribute contains the output of the device object's
  51                 _UID control method, if present.
  52
  53 What:           /sys/bus/acpi/devices/.../eject
  54 Date:           December 2006
  55 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  56 Description:
  57                 Writing 1 to this attribute will trigger hot removal of
  58                 this device object.  This file exists for every device
  59                 object that has _EJ0 method.
  60
  61 What:           /sys/bus/acpi/devices/.../status
  62 Date:           Jan, 2014
  63 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  64 Description:
  65                 (RO) Returns the ACPI device status: enabled, disabled or
  66                 functioning or present, if the method _STA is present.
  67
  68                 The return value is a decimal integer representing the device's
  69                 status bitmap:
  70
  71                 ===========  ==================================================
  72                 Bit [0]      Set if the device is present.
  73                 Bit [1]      Set if the device is enabled and decoding its
  74                              resources.
  75                 Bit [2]      Set if the device should be shown in the UI.
  76                 Bit [3]      Set if the device is functioning properly (cleared
  77                              if device failed its diagnostics).
  78                 Bit [4]      Set if the battery is present.
  79                 Bits [31:5]  Reserved (must be cleared)
  80                 ===========  ==================================================
  81
  82                 If bit [0] is clear, then bit 1 must also be clear (a device
  83                 that is not present cannot be enabled).
  84
  85                 Bit 0 can be clear (not present) with bit [3] set (device is
  86                 functional).  This case is used to indicate a valid device for
  87                 which no device driver should be loaded.
  88
  89                 More special cases are covered in the ACPI specification.
  90
  91 What:           /sys/bus/acpi/devices/.../hrv
  92 Date:           Apr, 2016
  93 Contact:        Rafael J. Wysocki <rjw@rjwysocki.net>
  94 Description:
  95                 (RO) Allows users to read the hardware version of non-PCI
  96                 hardware, if the _HRV control method is present.  It is mostly
  97                 useful for non-PCI devices because lspci can list the hardware
  98                 version for PCI devices.