readme.txt
1Generic Unix ACPICA makefiles
2-----------------------------
3
4These makefiles are intended to generate the ACPICA utilities in
5a Unix-like environment, with the original ACPICA code (not linuxized),
6and in the original (git tree) ACPICA directory structure.
7
8Windows binary versions of these tools are available at:
9
10http://www.acpica.org/downloads/binary_tools.php
11
12Documentation is available at acpica.org:
13
14http://www.acpica.org/documentation/
15
16The top level makefile will generate the following utilities:
17Note: These utilities are tested and supported as 32-bit versions
18only.
19
20acpibin
21acpiexec
22acpihelp
23acpinames
24acpisrc
25acpixtract
26iasl
27
28To generate all utilities:
29
30cd acpica/generate/unix
31make
32make install /* install all binaries to /usr/bin */
33
34
35Requirements
36------------
37
38make
39gcc compiler (4+)
40bison or yacc
41flex or lex
42
43
44Configuration
45-------------
46
47The Makefile.config file contains the configuration information:
48
49HOST = _CYGWIN /* Host system, must appear in acenv.h */
50CC = gcc /* C compiler */
51ACPICA_SRC = ../../../source /* Location of acpica source tree */
52
53
54Intermediate Files
55------------------
56
57The intermediate files for each utility (.o, etc.) are placed in the
58subdirectory corresponding to each utility, not in the source code
59tree itself. This prevents collisions when different utilities compile
60the same source modules with different options.
61
62
63Output
64------
65
66The executable utilities are copied to the local bin directory.
67
68"make install" will install the binaries to /usr/bin
69
70
71
721) acpibin, an AML file tool
73
74acpibin compares AML files, dumps AML binary files to text files,
75extracts binary AML from text files, and other AML file
76manipulation.
77
78
792) acpiexec, a user-space AML interpreter
80
81acpiexec allows the loading of ACPI tables and execution of control
82methods from user space. Useful for debugging AML code and testing
83the AML interpreter. Hardware access is simulated.
84
85
863) acpihelp, syntax help for ASL operators and reserved names
87
88acpihelp displays the syntax for all of the ASL operators, as well
89as information about the ASL/ACPI reserved names (4-char names that
90start with underscore.)
91
92
934) acpinames, load and dump acpi namespace
94
95acpinames loads an ACPI namespace from a binary ACPI table file.
96This is a smaller version of acpiexec that loads an acpi table and
97dumps the resulting namespace. It is primarily intended to demonstrate
98the configurability of ACPICA.
99
100
1015) acpisrc, a source code conversion tool
102
103acpisrc converts the standard form of the acpica source release (included
104here) into a version that meets Linux coding guidelines. This consists
105mainly of performing a series of string replacements and transformations
106to the code. It can also be used to clean the acpica source and generate
107statistics.
108
109
1106) acpixtract, extract binary ACPI tables from an acpidump
111
112acpixtract is used to extract binary ACPI tables from the ASCII text
113output of an acpidump utility (available on several different hosts.)
114
115
1167) iasl, an optimizing ASL compiler/disassembler
117
118iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine
119Language). This AML is suitable for inclusion as a DSDT in system
120firmware. It also can disassemble AML, for debugging purposes.
121
