Rev 1498 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
2216 | Serge | 1 | Makefiles for tool generation from the unix tarball |
2 | --------------------------------------------------- |
||
1498 | serge | 3 | |
2216 | Serge | 4 | These makefiles are intended to generate the ACPICA utilities in |
5 | a Linux or Unix-like environment, from the ACPICA source code |
||
6 | as released in the unix tarball. |
||
1498 | serge | 7 | |
2216 | Serge | 8 | Windows binary versions of these tools are available at: |
1498 | serge | 9 | |
2216 | Serge | 10 | http://www.acpica.org/downloads/binary_tools.php |
1498 | serge | 11 | |
2216 | Serge | 12 | Documentation is available at acpica.org: |
1498 | serge | 13 | |
2216 | Serge | 14 | http://www.acpica.org/documentation/ |
1498 | serge | 15 | |
2216 | Serge | 16 | The acpica/source/tools directory contains the following utilities. |
17 | Note: These utilities are tested and supported as 32-bit versions |
||
18 | only. |
||
1498 | serge | 19 | |
2216 | Serge | 20 | acpibin |
21 | acpiexec |
||
22 | acpihelp |
||
23 | acpinames |
||
24 | acpisrc |
||
25 | acpixtract |
||
26 | iasl |
||
1498 | serge | 27 | |
28 | |||
2216 | Serge | 29 | Requirements |
30 | ------------ |
||
31 | |||
32 | make |
||
33 | gcc compiler (4+) |
||
34 | bison or yacc |
||
35 | flex or lex |
||
36 | |||
37 | |||
38 | Configuration |
||
39 | ------------- |
||
40 | |||
41 | The Makefiles contain this configuration information: |
||
42 | |||
43 | HOST = _LINUX /* Host system, must appear in acenv.h */ |
||
44 | CC = gcc /* C compiler */ |
||
45 | |||
46 | |||
47 | 1) acpibin, an AML file tool |
||
48 | |||
49 | acpibin compares AML files, dumps AML binary files to text files, |
||
50 | extracts binary AML from text files, and other AML file |
||
51 | manipulation. |
||
52 | |||
1498 | serge | 53 | To compile: |
54 | |||
2216 | Serge | 55 | cd acpica/source/tools/acpibin |
1498 | serge | 56 | make |
2216 | Serge | 57 | make install /* install the binary to /usr/bin */ |
1498 | serge | 58 | |
59 | |||
2216 | Serge | 60 | 2) acpiexec, a user-space AML interpreter |
1498 | serge | 61 | |
2216 | Serge | 62 | acpiexec allows the loading of ACPI tables and execution of control |
63 | methods from user space. Useful for debugging AML code and testing |
||
64 | the AML interpreter. Hardware access is simulated. |
||
1498 | serge | 65 | |
2216 | Serge | 66 | To compile: |
1498 | serge | 67 | |
2216 | Serge | 68 | cd acpica/source/tools/acpiexec |
69 | make |
||
70 | make install /* install the binary to /usr/bin */ |
||
71 | |||
72 | |||
73 | 3) acpihelp, syntax help for ASL operators and reserved names |
||
74 | |||
75 | acpihelp displays the syntax for all of the ASL operators, as well |
||
76 | as information about the ASL/ACPI reserved names (4-char names that |
||
77 | start with underscore.) |
||
78 | |||
79 | To compile: |
||
80 | |||
81 | cd acpica/source/tools/acpihelp |
||
82 | make |
||
83 | make install /* install the binary to /usr/bin */ |
||
84 | |||
85 | |||
86 | 4) acpinames, load and dump acpi namespace |
||
87 | |||
88 | acpinames loads an ACPI namespace from a binary ACPI table file. |
||
89 | This is a smaller version of acpiexec that loads an acpi table and |
||
90 | dumps the resulting namespace. It is primarily intended to demonstrate |
||
91 | the configurability of ACPICA. |
||
92 | |||
93 | To compile: |
||
94 | |||
95 | cd acpica/source/tools/acpinames |
||
96 | make |
||
97 | make install /* install the binary to /usr/bin */ |
||
98 | |||
99 | |||
100 | 5) acpisrc, a source code conversion tool |
||
101 | |||
1498 | serge | 102 | acpisrc converts the standard form of the acpica source release (included |
103 | here) into a version that meets Linux coding guidelines. This consists |
||
104 | mainly of performing a series of string replacements and transformations |
||
2216 | Serge | 105 | to the code. It can also be used to clean the acpica source and generate |
106 | statistics. |
||
1498 | serge | 107 | |
108 | To compile: |
||
109 | |||
2216 | Serge | 110 | cd acpica/source/tools/acpisrc |
1498 | serge | 111 | make |
2216 | Serge | 112 | make install /* install the binary to /usr/bin */ |
1498 | serge | 113 | |
114 | |||
2216 | Serge | 115 | 6) acpixtract, extract binary ACPI tables from an acpidump |
1498 | serge | 116 | |
2216 | Serge | 117 | acpixtract is used to extract binary ACPI tables from the ASCII text |
118 | output of an acpidump utility (available on several different hosts.) |
||
1498 | serge | 119 | |
120 | To compile: |
||
121 | |||
2216 | Serge | 122 | cd acpica/source/tools/acpixtract |
1498 | serge | 123 | make |
2216 | Serge | 124 | make install /* install the binary to /usr/bin */ |
1498 | serge | 125 | |
126 | |||
2216 | Serge | 127 | 7) iasl, an optimizing ASL compiler/disassembler |
1498 | serge | 128 | |
2216 | Serge | 129 | iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine |
130 | Language). This AML is suitable for inclusion as a DSDT in system |
||
131 | firmware. It also can disassemble AML, for debugging purposes. |
||
1498 | serge | 132 | |
133 | To compile: |
||
134 | |||
2216 | Serge | 135 | cd acpica/source/compiler |
1498 | serge | 136 | make |
2216 | Serge | 137 | make install /* install the binary to /usr/bin */ |