1cd C:\Documents and Settings\pva\My Documents\acpi\wk\grammar\ABBU\utility
2==========================================================================
3
4Install instructions for ACPI CA BlackBox Utility on Windows XP.
5
6- Copy everything into a target directory
7
8- Run the ACPI BlackBox Utility (abbu.exe)
9
10- Select Options | Dump DSDT AML to get the current DSDT.AML file
11
12- Use AcpiDump to convert the AML file to a readable format (acpidump DSDT.AML)
13  The default output name is "dsdt.dsl".
14
15- Create a file extra.asl with the following:
16
17DefinitionBlock("extra.aml", "DSDT", 0x1, "INTEL", "ABCDE", 0x1)
18{
19    Scope(\_SB)
20    {
21        Device(ABBU)
22        {
23            Name(_HID, "ACPIABB0")
24            Method(ENBL)
25            {
26                Return(Zero)
27            }
28
29            Method(TEST)
30            {
31                Return(Zero)
32            }
33
34	    // List all test names here, separated by commas
35	    // It provides a convenient list of tests available on the platform
36	    Name(TSTS, Package()
37	    {
38		"ENBL",
39		"TEST"
40	    })
41        }
42    }
43}
44
45NOTE: The closing bracket of the DefinitionBlock MUST come after the closing bracket of this SB scope.
46      Also, this is a minimum injected code sample.  Added Methods to test specific DSDT functions found
47      in the DSDT.ASL file created earlier.
48
49- Use iasl.exe to compile EXTRA.ASL to create EXTRA.AML.  Use the -i switch to ignore errors
50
51- Run abbu.exe and press the 'Modify DSDT...' button
52
53- Point the Original DSDT path to DSDT.AML - It should be pointing to the file already
54
55- Point the Injected code path to EXTRA.AML - It should be pointing to the file already
56
57- Reboot
58
59- Windows XP should find your new device and want to load a driver.
60  Point it to the directory into which you copied the abbu.sys and abbu.inf files
61
62- Using the abbu.exe in the target directory:
63  - Use the 'Connect Driver' button to connect to the driver
64  - Use the 'Execute Ctrl Method' button to open a dialog box and enter a Method name (i.e. TEST)
65  - The driver will return a DWORD only with the results in the output box.
66
67Use Method(TEST) as a template to create new methods.
68
69TO UNINSTALL:
70=============
71- Use Device Manager to uninstall the 'Intel ACPI Black Box Utility Control Device' under 'System Devices'
72
73- Use Regedit and delete the following Keys:
74    - HKLM\System\CurrentControlSet\Services\Acpi\Parameters\DSDT
75    - HKLM\System\CurrentControlSet\Services\ABBU
76
77- Delete \Windows\System32\Drivers\abbu.sys
78