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