diff options
Diffstat (limited to 'static/netbsd/man4/acpi.4 4.html')
| -rw-r--r-- | static/netbsd/man4/acpi.4 4.html | 626 |
1 files changed, 0 insertions, 626 deletions
diff --git a/static/netbsd/man4/acpi.4 4.html b/static/netbsd/man4/acpi.4 4.html deleted file mode 100644 index 9f116eac..00000000 --- a/static/netbsd/man4/acpi.4 4.html +++ /dev/null @@ -1,626 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">ACPI(4)</td> - <td class="head-vol">Device Drivers Manual</td> - <td class="head-rtitle">ACPI(4)</td> - </tr> -</table> -<div class="manual-text"> -<section class="Sh"> -<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> -<p class="Pp"><code class="Nm">acpi</code> — <span class="Nd">Advanced - Configuration and Power Interface</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<p class="Pp"><code class="Cd">acpi0 at mainbus0</code></p> -<p class="Pp"> - <br/> - <code class="Cd">options ACPI_DEBUG</code> - <br/> - <code class="Cd">options ACPIVERBOSE</code> - <br/> - <code class="Cd">options ACPI_ACTIVATE_DEV</code> - <br/> - <code class="Cd">options ACPI_DSDT_OVERRIDE</code> - <br/> - <code class="Cd">options ACPI_DSDT_FILE=""</code> - <br/> - <code class="Cd">options ACPI_BLACKLIST_YEAR=2000</code> - <br/> - <code class="Cd">options ACPI__DIS_IS_BROKEN</code></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp"><span class="Ux">NetBSD</span> provides machine-independent bus - support for Advanced Configuration and Power Interface (ACPI) devices and - includes several ACPI device drivers.</p> -<p class="Pp">The <span class="Ux">NetBSD</span> implementation of ACPI - integrates Intel's ACPI Component Architecture (ACPI-CA) for the - OS-independent part. The ACPI-CA provides OS-neutral ACPI functionalities - such as ACPI BIOS table support, an ACPI event framework and an ACPI Machine - Language (AML) interpreter.</p> -<p class="Pp">Options:</p> -<div class="Bd-indent"> -<dl class="Bl-tag"> - <dt id="ACPI_DEBUG"><a class="permalink" href="#ACPI_DEBUG"><code class="Dv">ACPI_DEBUG</code></a></dt> - <dd>Enable various debug facilities.</dd> - <dt id="ACPIVERBOSE"><a class="permalink" href="#ACPIVERBOSE"><code class="Dv">ACPIVERBOSE</code></a></dt> - <dd>Enable verbose debug messages.</dd> - <dt id="ACPI_ACTIVATE_DEV"><a class="permalink" href="#ACPI_ACTIVATE_DEV"><code class="Dv">ACPI_ACTIVATE_DEV</code></a></dt> - <dd>Determine if the ACPI driver should attempt to activate inactive devices. - The default is off.</dd> - <dt id="ACPI_DSDT_OVERRIDE"><a class="permalink" href="#ACPI_DSDT_OVERRIDE"><code class="Dv">ACPI_DSDT_OVERRIDE</code></a></dt> - <dd>Force a given Differentiated System Description Table (DSDT) instead of - the version supplied by the BIOS. Use - <code class="Dv">ACPI_DSDT_FILE</code> to specify a DSDT.</dd> - <dt id="ACPI_DSDT_FILE=_filename_"><a class="permalink" href="#ACPI_DSDT_FILE=_filename_"><code class="Dv">ACPI_DSDT_FILE="filename"</code></a></dt> - <dd>If <code class="Dv">ACPI_DSDT_FILE</code> is not specified, default to - “dsdt.hex” in the build directory.</dd> - <dt id="ACPI_BLACKLIST_YEAR=2000"><a class="permalink" href="#ACPI_BLACKLIST_YEAR=2000"><code class="Dv">ACPI_BLACKLIST_YEAR=2000</code></a></dt> - <dd>Do not use ACPI with any BIOS made on or before the specified year.</dd> - <dt id="ACPI__DIS_IS_BROKEN"><a class="permalink" href="#ACPI__DIS_IS_BROKEN"><code class="Dv">ACPI__DIS_IS_BROKEN</code></a></dt> - <dd>Do not call the ACPI "_DIS" method to disable interrupt links. - This may be required on specific “nForce4” chipset systems, - which hard hang when this method is called instead of having it fail - gracefully.</dd> -</dl> -</div> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYSCTL_SUPPORT"><a class="permalink" href="#SYSCTL_SUPPORT">SYSCTL - SUPPORT</a></h1> -<p class="Pp">The following <a class="Xr">sysctl(8)</a> variables are provided - by the <code class="Nm">acpi</code> driver:</p> -<div class="Bd-indent"> -<dl class="Bl-tag"> - <dt id="hw.acpi.root"><a class="permalink" href="#hw.acpi.root"><code class="Ic">hw.acpi.root</code></a></dt> - <dd>The address of the ACPI root pointer in system memory.</dd> - <dt id="hw.acpi.sleep.state"><a class="permalink" href="#hw.acpi.sleep.state"><code class="Ic">hw.acpi.sleep.state</code></a></dt> - <dd>The system sleep state.</dd> - <dt id="hw.acpi.sleep.states"><a class="permalink" href="#hw.acpi.sleep.states"><code class="Ic">hw.acpi.sleep.states</code></a></dt> - <dd>A list of system sleep states that the machine supports. The possible - values are: - <p class="Pp"></p> - <div class="Bd-indent"> - <dl class="Bl-tag Bl-compact"> - <dt>S0</dt> - <dd>fully running</dd> - <dt>S1</dt> - <dd>power on suspend (CPU and hard disks are off)</dd> - <dt>S2</dt> - <dd>similar to S3, usually not implemented</dd> - <dt>S3</dt> - <dd>suspend-to-RAM</dd> - <dt>S4</dt> - <dd>suspend-to-disk (not supported on <span class="Ux">NetBSD</span>)</dd> - <dt>S5</dt> - <dd>power off</dd> - </dl> - </div> - </dd> - <dt id="hw.acpi.sleep.beep"><a class="permalink" href="#hw.acpi.sleep.beep"><code class="Ic">hw.acpi.sleep.beep</code></a></dt> - <dd>A boolean variable that controls whether the PC speaker beeps upon resume. - Only available on i386 and amd64 architectures.</dd> - <dt id="hw.acpi.sleep.vbios"><a class="permalink" href="#hw.acpi.sleep.vbios"><code class="Ic">hw.acpi.sleep.vbios</code></a></dt> - <dd>Defines the handling of the graphics card on i386 and amd64 architectures. - The supported values are: - <div class="Bd-indent"> - <dl class="Bl-tag"> - <dt>0</dt> - <dd>No attempt to reset the VGA controller will be made.</dd> - <dt>1</dt> - <dd>Call the VGA BIOS when still in real mode. This can result in direct - reboots. In that case, use ‘2’ or - <code class="Ic">vbetool post</code> from the - <span class="Pa">pkgsrc/sysutils/vbetool</span> package.</dd> - <dt>2</dt> - <dd>Call the VGA BIOS using the in-kernel x86 emulator.</dd> - </dl> - </div> - <p class="Pp">If the system has problems in resuming from the S3 state, - experimenting with different values may provide a solution.</p> - </dd> - <dt id="hw.acpi.stat.gpe"><a class="permalink" href="#hw.acpi.stat.gpe"><code class="Ic">hw.acpi.stat.gpe</code></a></dt> - <dd>The number of dispatched General Purpose Events (GPEs).</dd> - <dt id="hw.acpi.stat.sci"><a class="permalink" href="#hw.acpi.stat.sci"><code class="Ic">hw.acpi.stat.sci</code></a></dt> - <dd>The number of System Control Interrupts (SCIs). See - <a class="Xr">acpiec(4)</a> for a brief description of both GPEs and - SCIs.</dd> - <dt id="hw.acpi.stat.fixed"><a class="permalink" href="#hw.acpi.stat.fixed"><code class="Ic">hw.acpi.stat.fixed</code></a></dt> - <dd>The number of “fixed events”.</dd> - <dt id="hw.acpi.stat.method"><a class="permalink" href="#hw.acpi.stat.method"><code class="Ic">hw.acpi.stat.method</code></a></dt> - <dd>The number of AML methods executed by the interpreter.</dd> - <dt id="hw.acpi.power"><a class="permalink" href="#hw.acpi.power"><code class="Ic">hw.acpi.power</code></a></dt> - <dd>This read-only node describes the ACPI power state of devices. The values - range from D0 (“on”) to D3 (“off”).</dd> - <dt id="hw.acpi.wake"><a class="permalink" href="#hw.acpi.wake"><code class="Ic">hw.acpi.wake</code></a></dt> - <dd>This node represents devices that can wake the system from the S3 or S4 - sleep state. By default, <a class="Xr">acpibut(4)</a>, - <a class="Xr">acpilid(4)</a>, and <a class="Xr">pckbd(4)</a> are allowed - to wake the system, provided that the devices are present and the firmware - supports wake-up capabilities for the devices.</dd> -</dl> -</div> -</section> -<section class="Sh"> -<h1 class="Sh" id="SUPPORTED_DEVICES"><a class="permalink" href="#SUPPORTED_DEVICES">SUPPORTED - DEVICES</a></h1> -<p class="Pp"><span class="Ux">NetBSD</span> ACPI supports several - machine-dependent and machine-independent devices, some specific to ACPI and - some configured via it.</p> -<section class="Ss"> -<h2 class="Ss" id="Machine-independent_devices"><a class="permalink" href="#Machine-independent_devices">Machine-independent - devices</a></h2> -<div class="Bd-indent"> -<dl class="Bl-tag Bl-compact"> - <dt><a class="Xr">acpiacad(4)</a></dt> - <dd>ACPI AC adapters.</dd> - <dt><a class="Xr">acpibat(4)</a></dt> - <dd>ACPI batteries.</dd> - <dt><a class="Xr">acpibut(4)</a></dt> - <dd>ACPI power and sleep buttons.</dd> - <dt><a class="Xr">acpicpu(4)</a></dt> - <dd>ACPI processors.</dd> - <dt><a class="Xr">acpidalb(4)</a></dt> - <dd>ACPI direction application launch buttons.</dd> - <dt><a class="Xr">acpiec(4)</a></dt> - <dd>ACPI embedded controllers.</dd> - <dt><a class="Xr">acpiecdt(4)</a></dt> - <dd>ACPI Embedded Controller Boot Resource Table (ECDT).</dd> - <dt><a class="Xr">acpifan(4)</a></dt> - <dd>ACPI fans.</dd> - <dt><a class="Xr">acpilid(4)</a></dt> - <dd>ACPI lid switches.</dd> - <dt><a class="Xr">acpipmtr(4)</a></dt> - <dd>ACPI power meters.</dd> - <dt><a class="Xr">acpismbus(4)</a></dt> - <dd>ACPI SMBus via control method interface (CMI).</dd> - <dt><a class="Xr">acpitz(4)</a></dt> - <dd>ACPI thermal zones.</dd> - <dt><a class="Xr">acpivga(4)</a></dt> - <dd>ACPI display adapter and output devices.</dd> - <dt><a class="Xr">acpiwmi(4)</a></dt> - <dd>ACPI support for Windows Management Instrumentation.</dd> - <dt><a class="Xr">acpiwdrt(4)</a></dt> - <dd>ACPI watchdogs.</dd> - <dt><a class="Xr">aibs(4)</a></dt> - <dd>ASUSTeK voltage, temperature and fan sensors.</dd> - <dt><a class="Xr">asus(4)</a></dt> - <dd>ASUS laptop hotkeys.</dd> - <dt><a class="Xr">attimer(4)</a></dt> - <dd>AT Timer.</dd> - <dt><a class="Xr">com(4)</a></dt> - <dd>NS8250-, NS16450-, and NS16550-based serial ports.</dd> - <dt><a class="Xr">fdc(4)</a></dt> - <dd>Floppy disk controllers.</dd> - <dt><a class="Xr">fujbp(4)</a></dt> - <dd>Fujitsu brightness and pointer.</dd> - <dt><a class="Xr">fujhk(4)</a></dt> - <dd>Fujitsu hotkeys.</dd> - <dt><a class="Xr">hpacel(4)</a></dt> - <dd>HP 3D DriveGuard accelerometer.</dd> - <dt><a class="Xr">hpet(4)</a></dt> - <dd>High Precision Event Timer (HPET).</dd> - <dt><a class="Xr">hpqlb(4)</a></dt> - <dd>HP Quick Launch Buttons.</dd> - <dt><a class="Xr">joy(4)</a></dt> - <dd>Joystick/Game port interface.</dd> - <dt><a class="Xr">lpt(4)</a></dt> - <dd>Standard ISA parallel port interface.</dd> - <dt><a class="Xr">mpu(4)</a></dt> - <dd>Roland MPU-401 (compatible) MIDI UART.</dd> - <dt><a class="Xr">pcppi(4)</a></dt> - <dd>AT-style speaker sound.</dd> - <dt><a class="Xr">sdhc(4)</a></dt> - <dd>SD Host Controller.</dd> - <dt><a class="Xr">thinkpad(4)</a></dt> - <dd>IBM/Lenovo ThinkPad laptop device driver.</dd> - <dt><a class="Xr">ug(4)</a></dt> - <dd>Abit uGuru Hardware monitor.</dd> - <dt><a class="Xr">vald(4)</a></dt> - <dd>Toshiba Libretto device.</dd> - <dt><a class="Xr">valz(4)</a></dt> - <dd>Toshiba Dynabook device.</dd> - <dt><a class="Xr">wb(4)</a></dt> - <dd>Winbond W83L518D Integrated Media Reader.</dd> - <dt><a class="Xr">wss(4)</a></dt> - <dd>Windows Sound System-compatible sound cards</dd> - <dt><a class="Xr">ym(4)</a></dt> - <dd>Yamaha OPL3-SA2 and OPL3-SA3 audio device driver.</dd> -</dl> -</div> -</section> -<section class="Ss"> -<h2 class="Ss" id="i386-dependent_devices"><a class="permalink" href="#i386-dependent_devices">i386-dependent - devices</a></h2> -<div class="Bd-indent"> -<dl class="Bl-tag Bl-compact"> - <dt><a class="Xr">pckbc(4)</a></dt> - <dd>PC keyboard controllers.</dd> - <dt><a class="Xr">sony(4)</a></dt> - <dd>Sony Miscellaneous Controller</dd> - <dt><a class="Xr">spic(4)</a></dt> - <dd>Sony programmable I/O controller.</dd> -</dl> -</div> -</section> -</section> -<section class="Sh"> -<h1 class="Sh" id="DEBUGGING"><a class="permalink" href="#DEBUGGING">DEBUGGING</a></h1> -<p class="Pp">Although the situation has become better over the years, ACPI is - typically prone to various errors, ranging from blatant flaws in the - firmware to bugs in the implementation. Before anything else, it is a good - practice to upgrade the BIOS to the latest version available from the - vendor.</p> -<p class="Pp">To ease the task of diagnosing and fixing different problems, the - ACPICA reference implementation provides a rich facility of different - debugging methods. In <span class="Ux">NetBSD</span> these are generally - only available if the kernel has been compiled with the - <code class="Dv">ACPI_DEBUG</code> option.</p> -<section class="Ss"> -<h2 class="Ss" id="Verbose_messages"><a class="permalink" href="#Verbose_messages">Verbose - messages</a></h2> -<p class="Pp">The <code class="Dv">ACPIVERBOSE</code> compile time option - enables some verbose debug messages printed during the system startup. In a - <code class="Dv">MODULAR</code> (see <a class="Xr">options(4)</a>) system, - the information can be printed also at runtime, regardless of the presence - of <code class="Dv">ACPIVERBOSE</code>. To print the messages, - <a class="Xr">modload(8)</a> the <code class="Ic">acpiverbose</code> module - using the option <code class="Fl">-b</code> - <code class="Cm">dump=true</code>.</p> -</section> -<section class="Ss"> -<h2 class="Ss" id="Custom_DSDT"><a class="permalink" href="#Custom_DSDT">Custom - DSDT</a></h2> -<p class="Pp">ACPI interprets bytecode known as ACPI Machine Language (AML), - provided by the BIOS as a memory image during the system bootstrap. Most of - the AML relevant to <code class="Nm">acpi</code> is implemented in the - so-called Differentiated System Descriptor Table (DSDT). - <span class="Ux">NetBSD</span> provides support for overriding the default - DSDT supplied by the BIOS.</p> -<p class="Pp">The following steps can be used to override the DSDT:</p> -<ol class="Bl-enum Bd-indent"> - <li>Dump the raw DSDT with <a class="Xr">acpidump(8)</a>.</li> - <li>Disassemble the table with <a class="Xr">iasl(8)</a>.</li> - <li>Modify the disassembled table.</li> - <li>Compile the table with <a class="Xr">iasl(8)</a> using the option - <code class="Fl">-tc</code>.</li> - <li>Either copy the (<span class="Pa">*.hex</span>) file to - <div class="Bd Pp Bd-indent Li"> - <pre>src/sys/dev/acpi/acpica/Osd/custom_dsdt.hex</pre> - </div> - <p class="Pp">or use the option</p> - <div class="Bd Pp Bd-indent Li"> - <pre>ACPI_DSDT_FILE="/some/directory/custom_dsdt.hex"</pre> - </div> - <p class="Pp">in the kernel configuration file.</p> - </li> - <li>Define <code class="Dv">ACPI_DSDT_OVERRIDE</code> in the kernel - configuration file and rebuild.</li> -</ol> -</section> -<section class="Ss"> -<h2 class="Ss" id="Debugger"><a class="permalink" href="#Debugger">Debugger</a></h2> -<p class="Pp">The ACPICA interpreter provides its own debugger for low-level - debugging. It can be used to display internal data structures and namespace - objects, and to debug the execution of control methods. Single step and - breakpoint functionality are available. In <span class="Ux">NetBSD</span> - this is integrated to the in-kernel <a class="Xr">ddb(4)</a>. In order to - enter the ACPICA debugger from <a class="Xr">ddb(4)</a>, use the command - <code class="Ic">call</code> with the argument - <code class="Ic">acpi_osd_debugger</code>.</p> -</section> -<section class="Ss"> -<h2 class="Ss" id="Debug_Output"><a class="permalink" href="#Debug_Output">Debug - Output</a></h2> -<p class="Pp"><span class="Ux">NetBSD</span> provides three - <a class="Xr">sysctl(8)</a> variables that control the debug output at - runtime. The <code class="Ic">hw.acpi.debug.layer</code> variable limits the - output to a specific ACPI layer and the - <code class="Ic">hw.acpi.debug.level</code> variable controls the debug - level. Both <a class="Xr">sysctl(8)</a> variables are string literals. The - third variable is <code class="Ic">hw.acpi.debug.object</code>. This is a - boolean that controls whether debug messages internal to the AML are - enabled.</p> -<p class="Pp">For the first two variables, the possible values are:</p> -<table class="Bl-column Bd-indent"> - <tr id="LAYER"> - <td><a class="permalink" href="#LAYER"><b class="Sy">LAYER</b></a></td> - <td><a class="permalink" href="#LEVEL"><b class="Sy" id="LEVEL">LEVEL</b></a></td> - </tr> - <tr id="ACPI_DEBUG_NONE"> - <td><a class="permalink" href="#ACPI_DEBUG_NONE"><code class="Dv">ACPI_DEBUG_NONE</code></a></td> - <td><a class="permalink" href="#ACPI_DEBUG_NONE~2"><code class="Dv" id="ACPI_DEBUG_NONE~2">ACPI_DEBUG_NONE</code></a></td> - </tr> - <tr> - <td></td> - <td></td> - </tr> - <tr id="ACPI_UTILITIES"> - <td><a class="permalink" href="#ACPI_UTILITIES"><code class="Dv">ACPI_UTILITIES</code></a></td> - <td><a class="permalink" href="#ACPI_LV_INIT"><code class="Dv" id="ACPI_LV_INIT">ACPI_LV_INIT</code></a></td> - </tr> - <tr id="ACPI_HARDWARE"> - <td><a class="permalink" href="#ACPI_HARDWARE"><code class="Dv">ACPI_HARDWARE</code></a></td> - <td><a class="permalink" href="#ACPI_LV_DEBUG_OBJECT"><code class="Dv" id="ACPI_LV_DEBUG_OBJECT">ACPI_LV_DEBUG_OBJECT</code></a></td> - </tr> - <tr id="ACPI_EVENTS"> - <td><a class="permalink" href="#ACPI_EVENTS"><code class="Dv">ACPI_EVENTS</code></a></td> - <td><a class="permalink" href="#ACPI_LV_INFO"><code class="Dv" id="ACPI_LV_INFO">ACPI_LV_INFO</code></a></td> - </tr> - <tr id="ACPI_TABLES"> - <td><a class="permalink" href="#ACPI_TABLES"><code class="Dv">ACPI_TABLES</code></a></td> - <td><a class="permalink" href="#ACPI_LV_ALL_EXCEPTIONS"><code class="Dv" id="ACPI_LV_ALL_EXCEPTIONS">ACPI_LV_ALL_EXCEPTIONS</code></a> - <span class="No">*</span></td> - </tr> - <tr id="ACPI_NAMESPACE"> - <td><a class="permalink" href="#ACPI_NAMESPACE"><code class="Dv">ACPI_NAMESPACE</code></a></td> - <td></td> - </tr> - <tr id="ACPI_PARSER"> - <td><a class="permalink" href="#ACPI_PARSER"><code class="Dv">ACPI_PARSER</code></a></td> - <td><a class="permalink" href="#ACPI_LV_INIT_NAMES"><code class="Dv" id="ACPI_LV_INIT_NAMES">ACPI_LV_INIT_NAMES</code></a></td> - </tr> - <tr id="ACPI_DISPATCHER"> - <td><a class="permalink" href="#ACPI_DISPATCHER"><code class="Dv">ACPI_DISPATCHER</code></a></td> - <td><a class="permalink" href="#ACPI_LV_PARSE"><code class="Dv" id="ACPI_LV_PARSE">ACPI_LV_PARSE</code></a></td> - </tr> - <tr id="ACPI_EXECUTER"> - <td><a class="permalink" href="#ACPI_EXECUTER"><code class="Dv">ACPI_EXECUTER</code></a></td> - <td><a class="permalink" href="#ACPI_LV_LOAD"><code class="Dv" id="ACPI_LV_LOAD">ACPI_LV_LOAD</code></a></td> - </tr> - <tr id="ACPI_RESOURCES"> - <td><a class="permalink" href="#ACPI_RESOURCES"><code class="Dv">ACPI_RESOURCES</code></a></td> - <td><a class="permalink" href="#ACPI_LV_DISPATCH"><code class="Dv" id="ACPI_LV_DISPATCH">ACPI_LV_DISPATCH</code></a></td> - </tr> - <tr id="ACPI_CA_DEBUGGER"> - <td><a class="permalink" href="#ACPI_CA_DEBUGGER"><code class="Dv">ACPI_CA_DEBUGGER</code></a></td> - <td><a class="permalink" href="#ACPI_LV_EXEC"><code class="Dv" id="ACPI_LV_EXEC">ACPI_LV_EXEC</code></a></td> - </tr> - <tr id="ACPI_OS_SERVICES"> - <td><a class="permalink" href="#ACPI_OS_SERVICES"><code class="Dv">ACPI_OS_SERVICES</code></a></td> - <td><a class="permalink" href="#ACPI_LV_NAMES"><code class="Dv" id="ACPI_LV_NAMES">ACPI_LV_NAMES</code></a></td> - </tr> - <tr id="ACPI_CA_DISASSEMBLER"> - <td><a class="permalink" href="#ACPI_CA_DISASSEMBLER"><code class="Dv">ACPI_CA_DISASSEMBLER</code></a></td> - <td><a class="permalink" href="#ACPI_LV_OPREGION"><code class="Dv" id="ACPI_LV_OPREGION">ACPI_LV_OPREGION</code></a></td> - </tr> - <tr id="ACPI_COMPILER"> - <td><a class="permalink" href="#ACPI_COMPILER"><code class="Dv">ACPI_COMPILER</code></a></td> - <td><a class="permalink" href="#ACPI_LV_BFIELD"><code class="Dv" id="ACPI_LV_BFIELD">ACPI_LV_BFIELD</code></a></td> - </tr> - <tr id="ACPI_TOOLS"> - <td><a class="permalink" href="#ACPI_TOOLS"><code class="Dv">ACPI_TOOLS</code></a></td> - <td><a class="permalink" href="#ACPI_LV_TABLES"><code class="Dv" id="ACPI_LV_TABLES">ACPI_LV_TABLES</code></a></td> - </tr> - <tr id="ACPI_EXAMPLE"> - <td><a class="permalink" href="#ACPI_EXAMPLE"><code class="Dv">ACPI_EXAMPLE</code></a></td> - <td><a class="permalink" href="#ACPI_LV_VALUES"><code class="Dv" id="ACPI_LV_VALUES">ACPI_LV_VALUES</code></a></td> - </tr> - <tr id="ACPI_DRIVER"> - <td><a class="permalink" href="#ACPI_DRIVER"><code class="Dv">ACPI_DRIVER</code></a></td> - <td><a class="permalink" href="#ACPI_LV_OBJECTS"><code class="Dv" id="ACPI_LV_OBJECTS">ACPI_LV_OBJECTS</code></a></td> - </tr> - <tr id="ACPI_ALL_COMPONENTS"> - <td><a class="permalink" href="#ACPI_ALL_COMPONENTS"><code class="Dv">ACPI_ALL_COMPONENTS</code></a> - <span class="No">*</span></td> - <td><a class="permalink" href="#ACPI_LV_RESOURCES"><code class="Dv" id="ACPI_LV_RESOURCES">ACPI_LV_RESOURCES</code></a></td> - </tr> - <tr id="ACPI_LV_USER_REQUESTS"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_USER_REQUESTS"><code class="Dv">ACPI_LV_USER_REQUESTS</code></a></td> - </tr> - <tr id="ACPI_BUS_COMPONENT"> - <td><a class="permalink" href="#ACPI_BUS_COMPONENT"><code class="Dv">ACPI_BUS_COMPONENT</code></a></td> - <td><a class="permalink" href="#ACPI_LV_PACKAGE"><code class="Dv" id="ACPI_LV_PACKAGE">ACPI_LV_PACKAGE</code></a></td> - </tr> - <tr id="ACPI_ACAD_COMPONENT"> - <td><a class="permalink" href="#ACPI_ACAD_COMPONENT"><code class="Dv">ACPI_ACAD_COMPONENT</code></a></td> - <td><a class="permalink" href="#ACPI_LV_VERBOSITY1"><code class="Dv" id="ACPI_LV_VERBOSITY1">ACPI_LV_VERBOSITY1</code></a> - <span class="No">*</span></td> - </tr> - <tr id="ACPI_BAT_COMPONENT"> - <td><a class="permalink" href="#ACPI_BAT_COMPONENT"><code class="Dv">ACPI_BAT_COMPONENT</code></a></td> - <td></td> - </tr> - <tr id="ACPI_BUTTON_COMPONENT"> - <td><a class="permalink" href="#ACPI_BUTTON_COMPONENT"><code class="Dv">ACPI_BUTTON_COMPONENT</code></a></td> - <td><a class="permalink" href="#ACPI_LV_ALLOCATIONS"><code class="Dv" id="ACPI_LV_ALLOCATIONS">ACPI_LV_ALLOCATIONS</code></a></td> - </tr> - <tr id="ACPI_EC_COMPONENT"> - <td><a class="permalink" href="#ACPI_EC_COMPONENT"><code class="Dv">ACPI_EC_COMPONENT</code></a></td> - <td><a class="permalink" href="#ACPI_LV_FUNCTIONS"><code class="Dv" id="ACPI_LV_FUNCTIONS">ACPI_LV_FUNCTIONS</code></a></td> - </tr> - <tr id="ACPI_LID_COMPONENT"> - <td><a class="permalink" href="#ACPI_LID_COMPONENT"><code class="Dv">ACPI_LID_COMPONENT</code></a></td> - <td><a class="permalink" href="#ACPI_LV_OPTIMIZATIONS"><code class="Dv" id="ACPI_LV_OPTIMIZATIONS">ACPI_LV_OPTIMIZATIONS</code></a></td> - </tr> - <tr id="ACPI_RESOURCE_COMPONENT"> - <td><a class="permalink" href="#ACPI_RESOURCE_COMPONENT"><code class="Dv">ACPI_RESOURCE_COMPONENT</code></a></td> - <td><a class="permalink" href="#ACPI_LV_VERBOSITY2"><code class="Dv" id="ACPI_LV_VERBOSITY2">ACPI_LV_VERBOSITY2</code></a> - <span class="No">*</span></td> - </tr> - <tr id="ACPI_TZ_COMPONENT"> - <td><a class="permalink" href="#ACPI_TZ_COMPONENT"><code class="Dv">ACPI_TZ_COMPONENT</code></a></td> - <td></td> - </tr> - <tr id="ACPI_DISPLAY_COMPONENT"> - <td><a class="permalink" href="#ACPI_DISPLAY_COMPONENT"><code class="Dv">ACPI_DISPLAY_COMPONENT</code></a></td> - <td></td> - </tr> - <tr id="ACPI_ALL_DRIVERS"> - <td><a class="permalink" href="#ACPI_ALL_DRIVERS"><code class="Dv">ACPI_ALL_DRIVERS</code></a> - <span class="No">*</span></td> - <td><a class="permalink" href="#ACPI_LV_MUTEX"><code class="Dv" id="ACPI_LV_MUTEX">ACPI_LV_MUTEX</code></a></td> - </tr> - <tr id="ACPI_LV_THREADS"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_THREADS"><code class="Dv">ACPI_LV_THREADS</code></a></td> - </tr> - <tr id="ACPI_LV_IO"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_IO"><code class="Dv">ACPI_LV_IO</code></a></td> - </tr> - <tr id="ACPI_LV_AML_INTERRUPTS"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_AML_INTERRUPTS"><code class="Dv">ACPI_LV_AML_INTERRUPTS</code></a></td> - </tr> - <tr id="ACPI_LV_VERBOSITY3"> - <td>* This is a compound</td> - <td><a class="permalink" href="#ACPI_LV_VERBOSITY3"><code class="Dv">ACPI_LV_VERBOSITY3</code></a> - <span class="No">*</span></td> - </tr> - <tr> - <td> constant, including</td> - <td></td> - </tr> - <tr id="ACPI_LV_AML_DISASSEMBLE"> - <td> all previous elements.</td> - <td><a class="permalink" href="#ACPI_LV_AML_DISASSEMBLE"><code class="Dv">ACPI_LV_AML_DISASSEMBLE</code></a></td> - </tr> - <tr id="ACPI_LV_VERBOSE_INFO"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_VERBOSE_INFO"><code class="Dv">ACPI_LV_VERBOSE_INFO</code></a></td> - </tr> - <tr id="ACPI_LV_FULL_TABLES"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_FULL_TABLES"><code class="Dv">ACPI_LV_FULL_TABLES</code></a></td> - </tr> - <tr id="ACPI_LV_EVENTS"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_EVENTS"><code class="Dv">ACPI_LV_EVENTS</code></a></td> - </tr> - <tr id="ACPI_LV_VERBOSE"> - <td></td> - <td><a class="permalink" href="#ACPI_LV_VERBOSE"><code class="Dv">ACPI_LV_VERBOSE</code></a> - <span class="No">*</span></td> - </tr> -</table> -<p class="Pp">In addition, there is <code class="Dv">ACPI_DEBUG_DEFAULT</code> - that is used by ACPICA as the default debug level. It includes - <code class="Dv">ACPI_LV_INIT</code> and - <code class="Dv">ACPI_LV_DEBUG_OBJECT</code>.</p> -<p class="Pp">The debug layer can be divided into two groups: the first one is - specific to the ACPICA interpreter and the second one contains the internal - ACPI components of <span class="Ux">NetBSD</span>. The constant - <code class="Dv">ACPI_ALL_DRIVERS</code> includes all - <span class="Ux">NetBSD</span> specific parts.</p> -<p class="Pp">The ACPICA interpreter uses several debug levels internally, but - the <span class="Ux">NetBSD</span> specific parts are typically limited to - <code class="Dv">ACPI_LV_DEBUG_OBJECT</code> and - <code class="Dv">ACPI_LV_INFO</code>. The debug output can be stopped by - setting <code class="Ic">hw.acpi.debug.level</code> to - <code class="Dv">ACPI_DEBUG_NONE</code>.</p> -</section> -<section class="Ss"> -<h2 class="Ss" id="Example"><a class="permalink" href="#Example">Example</a></h2> -<p class="Pp">As an example, a driver may have defined the component it belongs - to and the name of the module:</p> -<div class="Bd Pp Bd-indent Li"> -<pre>#define _COMPONENT ACPI_BUS_COMPONENT -ACPI_MODULE_NAME ("acpi_example")</pre> -</div> -<p class="Pp">The driver may also utilize the debug facility:</p> -<div class="Bd Pp Bd-indent Li"> -<pre>ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Failed to evaluate _STA\n"));</pre> -</div> -<p class="Pp">With these options the debug message from the - <code class="Dv">ACPI_DEBUG_PRINT</code> macro is only visible when - <code class="Ic">hw.acpi.debug.layer</code> is either - <code class="Dv">ACPI_BUS_COMPONENT</code> or a compound constant including - it, and <code class="Ic">hw.acpi.debug.level</code> is - <code class="Dv">ACPI_LV_INFO</code> or some constant that includes it. - Finally, it can be noted that the ACPI implementation uses the prefix - <code class="Dv">ACPI_DB</code>, whereas the debug level - <a class="Xr">sysctl(8)</a> variable is always specified with the prefix - <code class="Dv">ACPI_LV</code>.</p> -<p class="Pp">Another example can be mentioned for the use of - <code class="Ic">hw.acpi.debug.object</code>. The following could appear in - an ASL code:</p> -<div class="Bd Pp Bd-indent Li"> -<pre>Method(_Q19, 0, NotSerialized) -{ - Store("_Q19 invoked", Debug) - Notify(ACAD, 0x80) -}</pre> -</div> -<p class="Pp">When <code class="Ic">hw.acpi.debug.object</code> is set to 1, the - message stored to the debug object is printed every time the method is - called by the interpreter.</p> -</section> -</section> -<section class="Sh"> -<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1> -<dl class="Bl-tag"> - <dt><span class="Pa">/dev/acpi</span></dt> - <dd style="width: auto;"> </dd> -</dl> -</section> -<section class="Sh"> -<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE - ALSO</a></h1> -<p class="Pp"><a class="Xr">ioapic(4)</a>, <a class="Xr">acpidump(8)</a>, - <a class="Xr">amldb(8)</a>, <a class="Xr">iasl(8)</a></p> -<p class="Pp"><cite class="Rs"><span class="RsA">Hewlett-Packard - Corporation</span>, <span class="RsA">Intel Corporation</span>, - <span class="RsA">Microsoft Corporation</span>, <span class="RsA">Phoenix - Technologies Ltd.</span>, and <span class="RsA">Toshiba Corporation</span>, - <span class="RsT">Advanced Configuration and Power Interface - Specification</span>, <span class="RsN">Revision 4.0</span>, - <a class="RsU" href="http://www.acpi.info/spec.htm">http://www.acpi.info/spec.htm</a>, - <span class="RsD">June 16, 2009</span>.</cite></p> -<p class="Pp"><cite class="Rs"><span class="RsA">Intel Corporation</span>, - <span class="RsT">ACPI Component Architecture,</span>, - <span class="RsT">Programmer Reference,</span>, - <span class="RsT">OS-Independent Subsystem, Debugger, and Utilities</span>, - <span class="RsN">Revision 1.27</span>, - <a class="RsU" href="http://www.acpica.org/download/acpica-reference.pdf">http://www.acpica.org/download/acpica-reference.pdf</a>, - <span class="RsD">January 20, 2010</span>.</cite></p> -<p class="Pp"><cite class="Rs"><span class="RsA">Len Brown</span>, - <span class="RsT">ACPI in Linux - Myths vs. Reality</span>, - <a class="RsU" href="http://www.linuxsymposium.org/archives/OLS/Reprints-2007/brown_1-Reprint.pdf">http://www.linuxsymposium.org/archives/OLS/Reprints-2007/brown_1-Reprint.pdf</a>, - <span class="RsP">65-74</span>, <span class="RsD">June 27-30, 2007</span>, - <span class="RsO">Proceedings of the Linux Symposium</span>.</cite></p> -<p class="Pp"><cite class="Rs"><span class="RsA">Joerg Sonnenberger</span> and - <span class="RsA">Jared D. McNeill</span>, <span class="RsT">Sleeping Beauty - - NetBSD on Modern Laptops</span>, - <a class="RsU" href="https://2008.asiabsdcon.org/papers/P9A-paper.pdf">https://2008.asiabsdcon.org/papers/P9A-paper.pdf</a>, - <span class="RsP">127-134</span>, <span class="RsD">February 3, 2008</span>, - <span class="RsO">Proceedings of AsiaBSDCon 2008</span>.</cite></p> -<p class="Pp"><cite class="Rs"><span class="RsA">Takanori Watanabe</span>, - <span class="RsT">ACPI Implementation on FreeBSD</span>, - <i class="RsB">Proceedings of the FREENIX Track: 2002 USENIX Annual - Technical Conference</i>, <i class="RsI">USENIX Association</i>, - <a class="RsU" href="https://www.usenix.org/legacy/event/usenix02/tech/freenix/full_papers/watanabe/watanabe.pdf">https://www.usenix.org/legacy/event/usenix02/tech/freenix/full_papers/watanabe/watanabe.pdf</a>, - <span class="RsP">121-131</span>, <span class="RsD">June 10-15, - 2002</span>.</cite></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1> -<p class="Pp">The <code class="Nm">acpi</code> driver appeared in - <span class="Ux">NetBSD 1.6</span>.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> -<p class="Pp">Authors of the <code class="Nm">acpi</code> subsystem include - <span class="An">Charles M. Hannum</span>, <span class="An">Frank van der - Linden</span>, <span class="An">Jared D. McNeill</span>, - <span class="An">Jason R. Thorpe</span>, <span class="An">Joerg - Sonnenberger</span>, and <span class="An">Jukka Ruohonen</span>, among - others.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> -<p class="Pp">Most of the ACPI power management functionalities are not - implemented.</p> -<p class="Pp">The <code class="Dv">ACPI__DIS_IS_BROKEN</code> option should not - be necessary.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">December 5, 2020</td> - <td class="foot-os">NetBSD 10.1</td> - </tr> -</table> |