share/man/man4/acpi.4

   1 .\"
   2 .\" Copyright (c) 2001 Michael Smith
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD: src/share/man/man4/acpi.4,v 1.61.8.1 2009/04/15 03:14:26 kensmith Exp $
  27 .\"
  28 .Dd December 14, 2018
  29 .Dt ACPI 4
  30 .Os
  31 .Sh NAME
  32 .Nm acpi
  33 .Nd Advanced Configuration and Power Management support
  34 .Sh SYNOPSIS
  35 .Cd "device acpi"
  36 .Pp
  37 .Cd "options ACPI_DEBUG"
  38 .Cd "options DDB"
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 driver provides support for the Intel/Microsoft/Compaq/Toshiba ACPI
  43 standard.
  44 This support includes platform hardware discovery (superseding the
  45 PnP and PCI BIOS), as well as power management (superseding APM) and
  46 other features.
  47 ACPI core support is provided by the ACPICA reference implementation
  48 from Intel.
  49 .Pp
  50 The
  51 .Nm
  52 driver is usually compiled into the kernel, and it is automatically loaded
  53 by the
  54 .Xr loader 8
  55 if it is not in the kernel configuration file.
  56 The loader menu provides a menu item to boot without ACPI.
  57 See also
  58 .Sx DISABLING ACPI
  59 below.
  60 .Sh SYSCTL VARIABLES
  61 The
  62 .Nm
  63 driver is intended to provide power management without user intervention.
  64 If the default settings are not optimal, the following sysctls can be
  65 used to modify or monitor
  66 .Nm
  67 behavior.
  68 .Bl -tag -width indent
  69 .It Va debug.acpi.enable_debug_objects
  70 Enable dumping Debug objects without
  71 .Cd "options ACPI_DEBUG" .
  72 Default is 0, ignore Debug objects.
  73 .It Va hw.acpi.acline
  74 AC line state (1 means online, 0 means on battery power).
  75 .It Va hw.acpi.cpu.cx_usage
  76 Debugging information listing the percent of total usage for each sleep state.
  77 The values are reset when
  78 .Va hw.acpi.cpu.cx_lowest
  79 is modified.
  80 .It Va hw.acpi.cpu.cx_lowest
  81 Lowest Cx state to use for idling the CPU.
  82 A scheduling algorithm will select states between
  83 .Li C1
  84 and this setting
  85 as system load dictates.
  86 To enable ACPI CPU idling control,
  87 .Va machdep.cpu_idle_hlt
  88 must be set to 2 (the default value).
  89 .It Va hw.acpi.cpu.cx_supported
  90 List of supported CPU idle states and their transition latency
  91 in microseconds.
  92 Each state has a type (e.g.,
  93 .Li C2 ) .
  94 .Li C1
  95 is equivalent to the ia32
  96 .Li HLT
  97 instruction,
  98 .Li C2
  99 provides a deeper
 100 sleep with the same semantics, and
 101 .Li C3
 102 provides the deepest sleep
 103 but additionally requires bus mastering to be disabled.
 104 States greater than
 105 .Li C3
 106 provide even more power savings with the same
 107 semantics as the
 108 .Li C3
 109 state.
 110 Deeper sleeps provide more power savings but increased transition
 111 latency when an interrupt occurs.
 112 .It Va hw.acpi.disable_on_reboot
 113 Disable ACPI during the reboot process.
 114 Most systems reboot fine with ACPI still enabled, but some require
 115 exiting to legacy mode first.
 116 Default is 0, leave ACPI enabled.
 117 .It Va hw.acpi.handle_reboot
 118 Use the ACPI Reset Register capability to reboot the system.
 119 Default is 0, use legacy reboot support.
 120 Some newer systems require use of this register, while some only work
 121 with legacy rebooting support.
 122 .It Va hw.acpi.lid_switch_state
 123 Suspend state
 124 .Pq Li S1 Ns \[en] Ns Li S5
 125 to enter when the lid switch (i.e., a notebook screen) is closed.
 126 Default is
 127 .Dq Li NONE
 128 (do nothing).
 129 .It Va hw.acpi.power_button_state
 130 Suspend state
 131 .Pq Li S1 Ns \[en] Ns Li S5
 132 to enter when the power button is pressed.
 133 Default is
 134 .Li S5
 135 (power-off nicely).
 136 .It Va hw.acpi.reset_video
 137 Reset the video adapter from real mode during the resume path.
 138 Some systems need this help, others have display problems if it is enabled.
 139 Default is 0 (disabled).
 140 .It Va hw.acpi.s4bios
 141 Indicate whether the system supports
 142 .Li S4BIOS .
 143 This means that the BIOS can handle all the functions of suspending the
 144 system to disk.
 145 Otherwise, the OS is responsible for suspending to disk
 146 .Pq Li S4OS .
 147 Most current systems do not support
 148 .Li S4BIOS .
 149 .It Va hw.acpi.sleep_button_state
 150 Suspend state
 151 .Pq Li S1 Ns \[en] Ns Li S5
 152 to enter when the sleep button is pressed.
 153 This is usually a special function button on the keyboard.
 154 Default is
 155 .Li S3
 156 (suspend-to-RAM).
 157 .It Va hw.acpi.sleep_delay
 158 Wait this number of seconds between preparing the system to suspend and
 159 actually entering the suspend state.
 160 Default is 1 second.
 161 .It Va hw.acpi.supported_sleep_state
 162 Suspend states
 163 .Pq Li S1 Ns \[en] Ns Li S5
 164 supported by the BIOS.
 165 .Bl -tag -width indent
 166 .It Li S1
 167 Quick suspend to RAM.
 168 The CPU enters a lower power state, but most peripherals are left running.
 169 .It Li S2
 170 Lower power state than
 171 .Li S1 ,
 172 but with the same basic characteristics.
 173 Not supported by many systems.
 174 .It Li S3
 175 Suspend to RAM.
 176 Most devices are powered off, and the system stops running except for
 177 memory refresh.
 178 .It Li S4
 179 Suspend to disk.
 180 All devices are powered off, and the system stops running.
 181 When resuming, the system starts as if from a cold power on.
 182 Not yet supported by
 183 .Fx
 184 unless
 185 .Li S4BIOS
 186 is available.
 187 .It Li S5
 188 System shuts down cleanly and powers off.
 189 .El
 190 .It Va hw.acpi.verbose
 191 Enable verbose printing from the various ACPI subsystems.
 192 .El
 193 .Sh LOADER TUNABLES
 194 Tunables can be set at the
 195 .Xr loader 8
 196 prompt before booting the kernel or stored in
 197 .Pa /boot/loader.conf .
 198 Many of these tunables also have a matching
 199 .Xr sysctl 8
 200 entry for access after boot.
 201 .Bl -tag -width indent
 202 .It Va acpi_dsdt_load
 203 Enables loading of a custom ACPI DSDT.
 204 .It Va acpi_dsdt_name
 205 Name of the DSDT table to load, if loading is enabled.
 206 It is relative to
 207 .Pa /boot/kernel .
 208 .It Va debug.acpi.allow_method_calls
 209 If set, the
 210 .Xr acpicall 8
 211 utility can be used to directly call ACPI methods for debugging and
 212 tweaking purposes.
 213 .It Va debug.acpi.disabled
 214 Selectively disables portions of ACPI that are enabled by default, for
 215 debugging purposes.
 216 .It Va debug.acpi.enabled
 217 Selectively enables portions of ACPI that are disabled by default, for
 218 debugging purposes.
 219 .It Va debug.acpi.facs_addr32
 220 Favor 32-bit FACS table addresses over the 64-bit addresses.
 221 .It Va debug.acpi.fadt_addr32
 222 Favor 32-bit FADT register addresses over the 64-bit addresses.
 223 .It Va debug.acpi.group_module_level_code
 224 Group the execution of module-level code after all of the tables have
 225 been loaded instead of executing it as tables are loaded into the namespace
 226 during ACPICA initialization.
 227 The default is to not group.
 228 .It Va debug.acpi.ignore_xsdt
 229 Ignore the XSDT, forcing the use of the RSDT.
 230 .It Va debug.acpi.interpreter_slack
 231 Enable less strict ACPI implementations.
 232 Default is 1, ignore common BIOS mistakes.
 233 .It Va debug.acpi.max_threads
 234 Specify the number of task threads that are started on boot.
 235 Limiting this to 1 may help work around various BIOSes that cannot
 236 handle parallel requests.
 237 The default value is 3.
 238 .It Va debug.acpi.quirks
 239 Override any automatic quirks completely.
 240 .It Va debug.acpi.resume_beep
 241 Beep the PC speaker on resume.
 242 This can help diagnose suspend/resume problems.
 243 Default is 0 (disabled).
 244 .It Va hint.acpi.0.disabled
 245 Set this to 1 to disable all of ACPI.
 246 If ACPI has been disabled on your system due to a blacklist entry for your
 247 BIOS, you can set this to 0 to re-enable ACPI for testing.
 248 .It Va hw.acpi.ec.poll_timeout
 249 Delay in milliseconds to wait for the EC to respond.
 250 Try increasing this number if you get the error
 251 .Qq Li AE_NO_HARDWARE_RESPONSE .
 252 .It Va hw.acpi.host_mem_start
 253 Override the assumed memory starting address for PCI host bridges.
 254 .It Va hw.acpi.install_interface , hw.acpi.remove_interface
 255 Install or remove OS interface(s) to control the return value of the
 256 .Ql _OSI
 257 query method.
 258 When an OS interface is specified in
 259 .Va hw.acpi.install_interface ,
 260 the
 261 .Li _OSI
 262 query for the interface returns it is
 263 .Em supported .
 264 Conversely, when an OS interface is specified in
 265 .Va hw.acpi.remove_interface ,
 266 the
 267 .Li _OSI
 268 query returns it is
 269 .Em not supported .
 270 Multiple interfaces can be specified in a comma-separated list and
 271 any leading white spaces will be ignored.
 272 For example,
 273 .Qq Li FreeBSD, Linux
 274 is a valid list of two interfaces
 275 .Qq Li FreeBSD
 276 and
 277 .Qq Li Linux .
 278 .It Va hw.acpi.reset_video
 279 Enables calling the VESA reset BIOS vector on the resume path.
 280 This can fix some graphics cards that have problems such as LCD white-out
 281 after resume.
 282 Default is 0 (disabled).
 283 .It Va hw.acpi.auto_serialize_methods
 284 Auto-serialization of control methods to proactively prevent problems with
 285 ill-behaved reentrant control methods that create named ACPI objects.
 286 Default is 1 (enabled).
 287 .It Va hw.acpi.verbose
 288 Turn on verbose debugging information about what ACPI is doing.
 289 .It Va hw.pci.link.%s.%d.irq
 290 Override the interrupt to use for this link and index.
 291 This capability should be used carefully, and only if a device is not
 292 working with
 293 .Nm
 294 enabled.
 295 .Qq %s
 296 is the name of the link (e.g., LNKA).
 297 .Qq %d
 298 is the resource index when the link supports multiple IRQs.
 299 Most PCI links only have one IRQ resource, so the below form should be used.
 300 .It Va hw.pci.link.%s.irq
 301 Override the interrupt to use.
 302 This capability should be used carefully, and only if a device is not
 303 working with
 304 .Nm
 305 enabled.
 306 .Qq %s
 307 is the name of the link (e.g., LNKA).
 308 .El
 309 .Sh DISABLING ACPI
 310 Since ACPI support on different platforms varies greatly, there are many
 311 debugging and tuning options available.
 312 .Pp
 313 For machines known not to work with
 314 .Nm
 315 enabled, there is a BIOS blacklist.
 316 Currently, the blacklist only controls whether
 317 .Nm
 318 should be disabled or not.
 319 In the future, it will have more granularity to control features (the
 320 infrastructure for that is already there).
 321 .Pp
 322 To enable
 323 .Nm
 324 (for debugging purposes, etc.) on machines that are on the blacklist, set the
 325 kernel environment variable
 326 .Va hint.acpi.0.disabled
 327 to 0.
 328 Before trying this, consider updating your BIOS to a more recent version that
 329 may be compatible with ACPI.
 330 .Pp
 331 To disable the
 332 .Nm
 333 driver completely, set the kernel environment variable
 334 .Va hint.acpi.0.disabled
 335 to 1.
 336 .Pp
 337 Disabling all or part of ACPI may result in a non-functional system.
 338 .Pp
 339 The
 340 .Nm
 341 driver comprises a set of drivers, which may be selectively disabled
 342 in case of problems.
 343 To disable a sub-driver, list it in the kernel
 344 environment variable
 345 .Va debug.acpi.disabled .
 346 Multiple entries can be listed, separated by a space.
 347 .Pp
 348 ACPI sub-devices and features that can be disabled:
 349 .Bl -tag -width ".Li sysresource"
 350 .It Li all
 351 Disable all ACPI features and devices.
 352 .It Li acad
 353 .Pq Vt device
 354 Supports AC adapter.
 355 .It Li bus
 356 .Pq Vt feature
 357 Probes and attaches subdevices.
 358 Disabling will avoid scanning the ACPI namespace entirely.
 359 .It Li children
 360 .Pq Vt feature
 361 Attaches standard ACPI sub-drivers and devices enumerated in the
 362 ACPI namespace.
 363 Disabling this has a similar effect to disabling
 364 .Dq Li bus ,
 365 except that the
 366 ACPI namespace will still be scanned.
 367 .It Li button
 368 .Pq Vt device
 369 Supports ACPI button devices (typically power and sleep buttons).
 370 .It Li cmbat
 371 .Pq Vt device
 372 Control-method batteries device.
 373 .It Li cpu
 374 .Pq Vt device
 375 Supports CPU power-saving and speed-setting functions.
 376 .It Li cpu_cst
 377 .Pq Vt device
 378 Supports CPU power-saving.
 379 Disabling
 380 .Dq Li cpu
 381 will also disable this device.
 382 .It Li cpu_pst
 383 .Pq Vt device
 384 Supports CPU speed-setting.
 385 Disabling
 386 .Dq Li cpu
 387 will also disable this device.
 388 .It Li dock
 389 .Pq Vt device
 390 Docking station device.
 391 .It Li ec
 392 .Pq Vt device
 393 Supports the ACPI Embedded Controller interface, used to communicate
 394 with embedded platform controllers.
 395 .It Li hpet
 396 .Pq Vt feature
 397 Supports the High Precision Event Timer.
 398 .It Li isa
 399 .Pq Vt device
 400 Supports an ISA bus bridge defined in the ACPI namespace,
 401 typically as a child of a PCI bus.
 402 .It Li lid
 403 .Pq Vt device
 404 Supports an ACPI laptop lid switch, which typically puts a
 405 system to sleep.
 406 .It Li quirks
 407 .Pq Vt feature
 408 Do not honor quirks.
 409 Quirks automatically disable ACPI functionality based on the XSDT table's
 410 OEM vendor name and revision date.
 411 .It Li pci
 412 .Pq Vt device
 413 Supports Host to PCI bridges.
 414 .It Li pci_link
 415 .Pq Vt feature
 416 Performs PCI interrupt routing.
 417 .It Li sysresource
 418 .Pq Vt device
 419 Pseudo-devices containing resources which ACPI claims.
 420 .It Li thermal
 421 .Pq Vt device
 422 Supports system cooling and heat management.
 423 .It Li timer
 424 .Pq Vt device
 425 Implements a timecounter using the ACPI fixed-frequency timer.
 426 .It Li video
 427 .Pq Vt device
 428 Supports
 429 .Xr acpi_video 4
 430 which may conflict with
 431 .Xr agp 4
 432 device.
 433 .El
 434 .Pp
 435 .\"The
 436 .\".Nm
 437 .\"driver comprises a set of drivers,
 438 .\"which may be selectively enabled in case of testing.
 439 .\"To enable a sub-driver,
 440 .\"list it in the kernel environment variable
 441 .\".Va debug.acpi.enabled .
 442 .\"Multiple entries can be listed,
 443 .\"separated by a space.
 444 .\".Pp
 445 .\"ACPI sub-devices and features that can be enabled:
 446 .\".Bl -tag -width ".Li sysresource"
 447 .\"[...]
 448 .\".El
 449 .\".Pp
 450 It is also possible to avoid portions of the ACPI namespace which
 451 may be causing problems, by listing the full path of the root of
 452 the region to be avoided in the kernel environment variable
 453 .Va debug.acpi.avoid .
 454 The object and all of its children will be ignored during the
 455 bus/children scan of the namespace.
 456 The ACPICA code will still know about the avoided region.
 457 .Sh DEBUGGING OUTPUT
 458 To enable debugging output,
 459 .Nm
 460 must be compiled with
 461 .Cd "options ACPI_DEBUG" .
 462 Debugging output is separated between layers and levels, where a layer is
 463 a component of the ACPI subsystem, and a level is a particular kind
 464 of debugging output.
 465 .Pp
 466 Both layers and levels are specified as a whitespace-separated list of
 467 tokens, with layers listed in
 468 .Va debug.acpi.layer
 469 and levels in
 470 .Va debug.acpi.level .
 471 .Pp
 472 The first set of layers is for ACPICA components, and the second is for
 473 .Dx
 474 drivers.
 475 The ACPICA layer descriptions include the prefix for the files they
 476 refer to.
 477 The supported layers are:
 478 .Pp
 479 .Bl -tag -compact -width ".Li ACPI_CA_DISASSEMBLER"
 480 .It Li ACPI_UTILITIES
 481 Utility ("ut") functions
 482 .It Li ACPI_HARDWARE
 483 Hardware access ("hw")
 484 .It Li ACPI_EVENTS
 485 Event and GPE ("ev")
 486 .It Li ACPI_TABLES
 487 Table access ("tb")
 488 .It Li ACPI_NAMESPACE
 489 Namespace evaluation ("ns")
 490 .It Li ACPI_PARSER
 491 AML parser ("ps")
 492 .It Li ACPI_DISPATCHER
 493 Internal representation of interpreter state ("ds")
 494 .It Li ACPI_EXECUTER
 495 Execute AML methods ("ex")
 496 .It Li ACPI_RESOURCES
 497 Resource parsing ("rs")
 498 .It Li ACPI_CA_DEBUGGER
 499 Debugger implementation ("db", "dm")
 500 .It Li ACPI_OS_SERVICES
 501 Usermode support routines ("os")
 502 .It Li ACPI_CA_DISASSEMBLER
 503 Disassembler implementation (unused)
 504 .It Li ACPI_ALL_COMPONENTS
 505 All the above ACPICA components
 506 .It Li ACPI_AC_ADAPTER
 507 AC adapter driver
 508 .It Li ACPI_BATTERY
 509 Control-method battery driver
 510 .It Li ACPI_BUS
 511 ACPI, ISA, and PCI bus drivers
 512 .It Li ACPI_BUTTON
 513 Power and sleep button driver
 514 .It Li ACPI_EC
 515 Embedded controller driver
 516 .It Li ACPI_FAN
 517 Fan driver
 518 .It Li ACPI_OEM
 519 Platform-specific driver for hotkeys, LED, etc.
 520 .It Li ACPI_POWER
 521 Power resource driver
 522 .It Li ACPI_PROCESSOR
 523 CPU driver
 524 .It Li ACPI_THERMAL
 525 Thermal zone driver
 526 .It Li ACPI_TIMER
 527 Timer driver
 528 .It Li ACPI_ALL_DRIVERS
 529 All the above
 530 .Dx
 531 ACPI drivers
 532 .El
 533 .Pp
 534 The supported levels are:
 535 .Pp
 536 .Bl -tag -compact -width ".Li ACPI_LV_AML_DISASSEMBLE"
 537 .It Li ACPI_LV_INIT
 538 Initialization progress
 539 .It Li ACPI_LV_DEBUG_OBJECT
 540 Stores to objects
 541 .It Li ACPI_LV_INFO
 542 General information and progress
 543 .It Li ACPI_LV_REPAIR
 544 Repair a common problem with predefined methods
 545 .It Li ACPI_LV_ALL_EXCEPTIONS
 546 All the previous levels
 547 .It Li ACPI_LV_PARSE
 548 .It Li ACPI_LV_DISPATCH
 549 .It Li ACPI_LV_EXEC
 550 .It Li ACPI_LV_NAMES
 551 .It Li ACPI_LV_OPREGION
 552 .It Li ACPI_LV_BFIELD
 553 .It Li ACPI_LV_TABLES
 554 .It Li ACPI_LV_VALUES
 555 .It Li ACPI_LV_OBJECTS
 556 .It Li ACPI_LV_RESOURCES
 557 .It Li ACPI_LV_USER_REQUESTS
 558 .It Li ACPI_LV_PACKAGE
 559 .It Li ACPI_LV_EVALUATION
 560 .It Li ACPI_LV_VERBOSITY1
 561 All the previous levels
 562 .It Li ACPI_LV_ALLOCATIONS
 563 .It Li ACPI_LV_FUNCTIONS
 564 .It Li ACPI_LV_OPTIMIZATIONS
 565 .It Li ACPI_LV_VERBOSITY2
 566 All the previous levels
 567 .It Li ACPI_LV_ALL
 568 Alias for
 569 .Qq Li ACPI_LV_VERBOSITY2
 570 .It Li ACPI_LV_MUTEX
 571 .It Li ACPI_LV_THREADS
 572 .It Li ACPI_LV_IO
 573 .It Li ACPI_LV_INTERRUPTS
 574 .It Li ACPI_LV_VERBOSITY3
 575 All the previous levels
 576 .It Li ACPI_LV_AML_DISASSEMBLE
 577 .It Li ACPI_LV_VERBOSE_INFO
 578 .It Li ACPI_LV_FULL_TABLES
 579 .It Li ACPI_LV_EVENTS
 580 .It Li ACPI_LV_VERBOSE
 581 All levels after
 582 .Qq Li ACPI_LV_VERBOSITY3
 583 .It Li ACPI_LV_INIT_NAMES
 584 Needs to be specified separately
 585 .It Li ACPI_LV_LOAD
 586 Needs to be specified separately
 587 .El
 588 .Pp
 589 Selection of the appropriate layer and level values is important
 590 to avoid massive amounts of debugging output.
 591 For example, the following configuration is a good way to gather initial
 592 information.
 593 It enables debug output for both ACPICA and the
 594 .Nm
 595 driver, printing basic information about errors, warnings, and progress.
 596 .Bd -literal -offset indent
 597 debug.acpi.layer="ACPI_ALL_COMPONENTS ACPI_ALL_DRIVERS"
 598 debug.acpi.level="ACPI_LV_ALL_EXCEPTIONS"
 599 .Ed
 600 .Pp
 601 Debugging output by the ACPICA subsystem is prefixed with the
 602 module name in lowercase, followed by a source line number.
 603 Output from the
 604 .Dx Ns -local
 605 code follows the same format, but
 606 the module name is uppercased.
 607 .Sh OVERRIDING YOUR BIOS BYTECODE
 608 ACPI interprets bytecode named AML
 609 (ACPI Machine Language)
 610 provided by the BIOS vendor as a memory image at boot time.
 611 Sometimes, the AML code contains a bug that does not appear when parsed
 612 by the Microsoft implementation.
 613 .Dx
 614 provides a way to override it with your own AML code to work around
 615 or debug such problems.
 616 Note that all AML in your DSDT and any SSDT tables is overridden.
 617 .Pp
 618 In order to load your AML code, copy it to
 619 .Pa /boot/kernel/acpi_dsdt.aml
 620 and add the following line to
 621 .Pa /boot/loader.conf .
 622 .Bd -literal -offset indent
 623 acpi_dsdt_load="YES"
 624 .Ed
 625 .Pp
 626 In order to prepare your AML code, you will need the
 627 .Xr acpidump 8
 628 and
 629 .Xr iasl 8
 630 utilities and some ACPI knowledge.
 631 .Sh SEE ALSO
 632 .Xr kenv 1 ,
 633 .Xr acpi_asus 4 ,
 634 .Xr acpi_dock 4 ,
 635 .Xr acpi_fujitsu 4 ,
 636 .Xr acpi_hp 4 ,
 637 .Xr acpi_panasonic 4 ,
 638 .Xr acpi_sony 4 ,
 639 .Xr acpi_thermal 4 ,
 640 .Xr acpi_thinkpad 4 ,
 641 .Xr acpi_toshiba 4 ,
 642 .Xr acpi_video 4 ,
 643 .Xr aibs 4 ,
 644 .Xr loader.conf 5 ,
 645 .Xr acpibin 8 ,
 646 .Xr acpicall 8 ,
 647 .Xr acpiconf 8 ,
 648 .Xr acpidump 8 ,
 649 .Xr acpiexec 8 ,
 650 .Xr acpinames 8 ,
 651 .Xr acpixtract 8 ,
 652 .Xr config 8 ,
 653 .Xr iasl 8
 654 .Rs
 655 .%A "Hewlett-Packard Corporation"
 656 .%A "Intel Corporation"
 657 .%A "Microsoft Corporation"
 658 .%A "Phoenix Technologies Ltd."
 659 .%A "Toshiba Corporation"
 660 .%D November 13, 2013
 661 .%T "Advanced Configuration and Power Interface Specification"
 662 .%O http://acpi.info/spec.htm
 663 .Re
 664 .Sh AUTHORS
 665 .An -nosplit
 666 The ACPICA subsystem is developed and maintained by
 667 Intel Architecture Labs.
 668 .Pp
 669 The following people made notable contributions to the ACPI subsystem
 670 in
 671 .Dx :
 672 .An Michael Smith ,
 673 .An Takanori Watanabe Aq Mt takawata@jp.FreeBSD.org ,
 674 .An Mitsuru IWASAKI Aq Mt iwasaki@jp.FreeBSD.org ,
 675 .An Munehiro Matsuda ,
 676 .An Nate Lawson ,
 677 the ACPI-jp mailing list at
 678 .Aq Mt acpi-jp@jp.FreeBSD.org ,
 679 and many other contributors.
 680 .Pp
 681 This manual page was written by
 682 .An Michael Smith Aq Mt msmith@FreeBSD.org .
 683 .Sh BUGS
 684 Many BIOS versions have serious bugs that may cause system instability,
 685 break suspend/resume, or prevent devices from operating properly due to
 686 IRQ routing problems.
 687 Upgrade your BIOS to the latest version available from the vendor before
 688 deciding it is a problem with
 689 .Nm .
 690 .\".Pp
 691 .\"The
 692 .\".Nm
 693 .\"CPU idle power management drive conflicts with the local APIC (LAPIC)
 694 .\"timer.
 695 .\"Disable APIC mode with
 696 .\".Va hint.apic.0.disabled
 697 .\"or do not use the
 698 .\".Li C2
 699 .\"and
 700 .\".Li C3
 701 .\"states if APIC mode is enabled.