27.10.2015 Views

Advanced Configuration and Power Interface Specification

ACPI_6.0

ACPI_6.0

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Device <strong>Configuration</strong><br />

Return Value:<br />

None<br />

For hot removal, the device must be immediately ejected when OSPM calls the _EJ0 control<br />

method. The _EJ0 control method does not return until ejection is complete. After calling _EJ0,<br />

OSPM verifies the device no longer exists to determine if the eject succeeded. For _HID devices,<br />

OSPM evaluates the _STA method. For _ADR devices, OSPM checks with the bus driver for that<br />

device.<br />

For warm removal, the _EJ1–_EJ4 control methods do not cause the device to be immediately<br />

ejected. Instead, they set proprietary registers to prepare the hardware to eject when the system goes<br />

into the given sleep state. The hardware ejects the device only after OSPM has put the system in a<br />

sleep state by writing to the SLP_EN register. After the system resumes, OSPM calls _STA to<br />

determine if the eject succeeded.<br />

A device object may have multiple _EJx control methods. First, it lists an EJx control method for the<br />

preferred sleeping state to eject the device. Optionally, the device may list an EJ4 control method to<br />

be used when the system has no power (for example, no battery) after the eject. For example, a hotdocking<br />

notebook might list _EJ0 <strong>and</strong> _EJ4.<br />

6.3.4 _LCK (Lock)<br />

This control method is optional <strong>and</strong> is required only for a device that supports a software-controlled<br />

locking mechanism. When the OS invokes this control method, the associated device is to be locked<br />

or unlocked based upon the value of the argument that is passed. On a lock request, the control<br />

method must not complete until the device is completely locked.<br />

Arguments: (1)<br />

Arg0 – An Integer containing a device lock control<br />

0 – Unlock the device<br />

1 – Lock the device<br />

Return Value:<br />

None<br />

When describing a platform, devices use either a _LCK control method or an _EJx control method<br />

for a device.<br />

6.3.5 _OST (OSPM Status Indication)<br />

This object is an optional control method that is invoked by OSPM to indicate processing status to<br />

the platform. During device ejection, device hot add, or other event processing, OSPM may need to<br />

perform specific h<strong>and</strong>shaking with the platform. OSPM may also need to indicate to the platform its<br />

inability to complete a requested operation; for example, when a user presses an ejection button for a<br />

device that is currently in use or is otherwise currently incapable of being ejected. In this case, the<br />

processing of the ACPI Eject Request notification by OSPM fails. OSPM may indicate this failure<br />

to the platform through the invocation of the _OST control method. As a result of the status<br />

notification indicating ejection failure, the platform may take certain action including reissuing the<br />

notification or perhaps turning on an appropriate indicator light to signal the failure to the user.<br />

Version 6.0 335

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!