ACPI是现代计算机系统中BIOS与操作系统间的桥梁。ACPI不仅定义了很多电源和休眠有关的标准，它还定义了如何通过FADT、XSDT、RSDT以及ASL语言来实现与操作系统的交互。
有些系统问题，比如无法进入睡眠状态，无法唤醒（自动重启，或死机）等，是与ACPI直接有关的。但如何定位出错的具体原因一直是一个比较困难的课题。很多时候不得不使用排除及试探等间接方法来解决，效率很低。本文介绍一种直接跟踪ASL源代码的直接方法。
1， 建立两台机器组成的内核调试环境（详见WinDbg帮助文档）。
2， 在调试机上按Ctrl+Break将被调试机中断到调试器。
3， 尝试使用!amli debugger命令启动AMLI调试器。第一次运行该命令可能失败。典型的出错信息如下：
AMLI_DBGERR: failed to get debugger flag address
此错误的根本原因是本地的AMLI调试模块没有找到合适的调试符号。原因有两个：
1） 被调试机没有使用调试版本的ACPI驱动（ACPI.DLL）；
2） WinDbg还没有加载ACPI调试符号文件。对于此种情况，可尝试使用.reload命令，通常就可以解决问题了。
重新运行!amli debugger，如果没有任何显示，那么本地的AMLI调试模块就合被调试机的ACPI解释器成功握手了（通信）。当ACPI解释器再得到执行时，它就会立刻break到调试机的调试器中。因此，需要执行g命令让被调试机跑起来，才可能真正中断到AMLI的脚本调试器。
本地的AMLI调试扩展模块名称如下：
|
Windows NT 4.0 |
Not available |
|
Windows 2000 |
acpikd.dll |
|
Windows XP and later |
kdexts.dll |
4， 可以运行一些AMLI命令来检查它是否工作正常。比如!amli dns可以打印出ACPI空间中的所有对象。
!amli dns
ACPI Name Space: / (ffffffff81b3c024)
Unknown(/___)
| Unknown(_GPE)
| | Method(_L03:Flags=0x0,CodeBuff=ffffffff81b3c841,Len=31)
| | Method(_L04:Flags=0x0,CodeBuff=ffffffff81b3c8c1,Len=31)
| | Method(_L05:Flags=0x0,CodeBuff=ffffffff81b3c941,Len=31)
| | Method(_L0B:Flags=0x0,CodeBuff=ffffffff81b3c9c1,Len=31)
| | Method(_L0C:Flags=0x0,CodeBuff=ffffffff81b3ca41,Len=31)
| | Method(_L0D:Flags=0x0,CodeBuff=ffffffff81b3cac1,Len=31)
| | Method(_L0E:Flags=0x0,CodeBuff=ffffffff81b3cb41,Len=31)
| | Method(_L1D:Flags=0x0,CodeBuff=ffffffff81b3cbc1,Len=32)
| Unknown(_PR_)
| | Processor(CPU0:Processor ID=0x1,PBlk=0x410,PBlkLen=6)
| | Processor(CPU1:Processor ID=0x2,PBlk=0x410,PBlkLen=6)
| Unknown(_SB_)
| | Device(SLPB)
| | | Integer(_HID:Value=0x000000000e0cd041[235720769])
| | | Method(_PRW:Flags=0x0,CodeBuff=ffffffff81b3cccd,Len=8)
| | Device(PCI0)
| | | Integer(_HID:Value=0x00000000030ad041[51040321])
| | | Integer(_ADR:Value=0x0000000000000000[0])
| | | Method(_INI:Flags=0x0,CodeBuff=ffffffff81b3d6dd,Len=16)
| | | Buffer(PBRS:Ptr=ffffffff81b3d71c,Len=136){
0x88,0x0d,0x00,0x02,0x0c,0x00,0x00,0x00,0x00,0x00,0xff,0x00,0x00,0x00
0x00,0x01,0x47,0x01,0xf8,0x0c,0xf8,0x0c,0x01,0x08,0x88,0x0d,0x00,0x01
0x0c,0x03,0x00,0x00,0x00,0x00,0xf7,0x0c,0x00,0x00,0xf8,0x0c,0x88,0x0d
……（省略很多行）
也可以通过命令行参数，显示ACPI空间树中从某个设备开始的子树。比如一下命令显示的是电池设备。
kd> !amli dns /s /_sb_.pci0.bat0
ACPI Name Space: /_SB_.PCI0.BAT0 (ffffffff81b290f4)
Device(BAT0)
| Integer(_HID:Value=0x000000000a0cd041[168611905])
| Method(_STA:Flags=0x0,CodeBuff=ffffffff81b291d1,Len=32)
| Method(_BIF:Flags=0x0,CodeBuff=ffffffff81b29255,Len=274)
| Method(_BST:Flags=0x0,CodeBuff=ffffffff81b293c9,Len=262)
| | Package(PBST:NumElements=4){
| | | Integer(:Value=0x0000000000000001[1])
| | | Integer(:Value=0x0000000000000a6e[2670])
| | | Integer(:Value=0x0000000000000000[0])
| | | Integer(:Value=0x0000000000002ee0[12000])
| | }
| Method(_PCL:Flags=0x0,CodeBuff=ffffffff81b29531,Len=5)
5， 发出g命令，让被调试机恢复运行状态。因为ACPI的代码的使用频率很高，所以被调试机的ACPI解释器通常很快就会得到执行，并中断进调试器。其状态如图1所示。可见，命令行提示符已经由原来的kd>变为Input> （AMLI(? For help)）。在此状态下，只可以运行AMLI调试器的命令。而且不需要再使用!amli前缀。
图1，中断到AMLI调试器
6， AMLI调试器也提高了一系列断点命令以实现跟踪功能。比如可以通过以下命令在电池设备的_STA方法入口处设置断点。
AMLI(? for help)-> bp /_sb.pci0.bat0._sta
bp /_sb.pci0.bat0._sta
成功设置的断点，AMLI调试器仅仅会回显该断点命令。如果设置失败，还会附加有错误信息，例如：
AMLI(? for help)-> bp /_sb.pci0.bat0.sta
bp /_sb.pci0.bat0.sta
AMLI_DBGERR: object not found or object is not a method - /_SB.PCI0.BAT0.STA
7， 设置断点后，可发出g命令让被调试机恢复运行。
8， 当断点被触发时，被调试机会被中断到调试器。
AMLI(? for help)-> g
g
Hit Breakpoint 0.
AMLI(? for help)->
可以通过ln命令判断本次断点最近的方法名：
AMLI(? for help)-> ln
ln
81b291d1: /_SB.PCI0.BAT0._STA
通过r命令可以显示出当前的上下文。包括线程、堆栈、ASL变量值等信息。
AMLI(? for help)-> r
r
Context=81adf000*, Queue=00000000, ResList=00000000
ThreadID=81b4c020, Flags=00000030
StackTop=81ae0f0c, UsedStackSize=244 bytes, FreeStackSize=7708 bytes
LocalHeap=81adf0bc, CurrentHeap=81adf0bc, UsedHeapSize=52 bytes
Object=/_SB.PCI0.BAT0._STA, Scope=/_SB.PCI0.BAT0._STA, ObjectOwner=81adf0e0, SyncLevel=0
AsyncCallBack=f99e6e98, CallBackData=e32de8b0, CallBackContext=f9e9a760
MethodObject=/_SB.PCI0.BAT0._STA
81ae0f5c: Local0=Unknown()
81ae0f70: Local1=Unknown()
81ae0f84: Local2=Unknown()
81ae0f98: Local3=Unknown()
81ae0fac: Local4=Unknown()
81ae0fc0: Local5=Unknown()
81ae0fd4: Local6=Unknown()
81ae0fe8: Local7=Unknown()
81adf040: RetObj=Unknown()
Next AML Pointer: 81b291d1 [/_SB.PCI0.BAT0._STA]
81b291d1: Store(^^SBUS.SRDW(0x16, 0xa), Local0)
81b291e2: If(LEqual(Local0, 0xffff))
81b291e9: {
81b291e9: | Return(0xf)
81b291ec: }
Press to continue and 'q' to quit?
81b291ec: Else
81b291ee: {
81b291ee: | Return(0x1f)
81b291f1: }
通过u命令可以将当前的AML代码反汇编成ASL。
9， 可以使用p或t命令跟踪ASL代码。
AMLI(? for help)-> p
p
Store(^^SBUS.SRDW(0x16,0xa)
81b4bc69: {
81b4bc69: If(LNot(LEqual(Acquire(MSMB,0xfffe)=0x0,Zero)=0xffffffff)=0x0)
AMLI(? for help)-> p
p
81b4bc7a: If(STRT()
81b4bf55: {
81b4bf55: Store(0x3e8,Local0)=0x3e8
AMLI(? for help)->
10， 执行set traceon 命令，可以使能ACPI解释器的踪迹功能，打印出所有ACPI代码的执行情况。