|
Packit Service |
1fb00e |
Generic Unix ACPICA makefiles
|
|
Packit Service |
1fb00e |
-----------------------------
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
These makefiles are intended to generate the ACPICA utilities in
|
|
Packit Service |
1fb00e |
a Unix-like environment, with the original ACPICA code (not linuxized),
|
|
Packit Service |
1fb00e |
and in the original (git tree) ACPICA directory structure.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
Windows binary versions of these tools are available at:
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
http://www.acpica.org/downloads/binary_tools.php
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
Documentation is available at acpica.org:
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
http://www.acpica.org/documentation/
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
The top level makefile will generate the following utilities:
|
|
Packit Service |
1fb00e |
Note: These utilities are tested and supported as 32-bit versions
|
|
Packit Service |
1fb00e |
only.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
acpibin
|
|
Packit Service |
1fb00e |
acpiexec
|
|
Packit Service |
1fb00e |
acpihelp
|
|
Packit Service |
1fb00e |
acpinames
|
|
Packit Service |
1fb00e |
acpisrc
|
|
Packit Service |
1fb00e |
acpixtract
|
|
Packit Service |
1fb00e |
iasl
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
To generate all utilities:
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
cd acpica/generate/unix
|
|
Packit Service |
1fb00e |
make
|
|
Packit Service |
1fb00e |
make install /* install all binaries to /usr/bin */
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
Requirements
|
|
Packit Service |
1fb00e |
------------
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
make
|
|
Packit Service |
1fb00e |
gcc compiler (4+)
|
|
Packit Service |
1fb00e |
bison or yacc
|
|
Packit Service |
1fb00e |
flex or lex
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
Configuration
|
|
Packit Service |
1fb00e |
-------------
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
The Makefile.config file contains the configuration information:
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
HOST = _CYGWIN /* Host system, must appear in acenv.h */
|
|
Packit Service |
1fb00e |
CC = gcc /* C compiler */
|
|
Packit Service |
1fb00e |
ACPICA_SRC = ../../../source /* Location of acpica source tree */
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
Intermediate Files
|
|
Packit Service |
1fb00e |
------------------
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
The intermediate files for each utility (.o, etc.) are placed in the
|
|
Packit Service |
1fb00e |
subdirectory corresponding to each utility, not in the source code
|
|
Packit Service |
1fb00e |
tree itself. This prevents collisions when different utilities compile
|
|
Packit Service |
1fb00e |
the same source modules with different options.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
Output
|
|
Packit Service |
1fb00e |
------
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
The executable utilities are copied to the local bin directory.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
"make install" will install the binaries to /usr/bin
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
1) acpibin, an AML file tool
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
acpibin compares AML files, dumps AML binary files to text files,
|
|
Packit Service |
1fb00e |
extracts binary AML from text files, and other AML file
|
|
Packit Service |
1fb00e |
manipulation.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
2) acpiexec, a user-space AML interpreter
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
acpiexec allows the loading of ACPI tables and execution of control
|
|
Packit Service |
1fb00e |
methods from user space. Useful for debugging AML code and testing
|
|
Packit Service |
1fb00e |
the AML interpreter. Hardware access is simulated.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
3) acpihelp, syntax help for ASL operators and reserved names
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
acpihelp displays the syntax for all of the ASL operators, as well
|
|
Packit Service |
1fb00e |
as information about the ASL/ACPI reserved names (4-char names that
|
|
Packit Service |
1fb00e |
start with underscore.)
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
4) acpinames, load and dump acpi namespace
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
acpinames loads an ACPI namespace from a binary ACPI table file.
|
|
Packit Service |
1fb00e |
This is a smaller version of acpiexec that loads an acpi table and
|
|
Packit Service |
1fb00e |
dumps the resulting namespace. It is primarily intended to demonstrate
|
|
Packit Service |
1fb00e |
the configurability of ACPICA.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
5) acpisrc, a source code conversion tool
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
acpisrc converts the standard form of the acpica source release (included
|
|
Packit Service |
1fb00e |
here) into a version that meets Linux coding guidelines. This consists
|
|
Packit Service |
1fb00e |
mainly of performing a series of string replacements and transformations
|
|
Packit Service |
1fb00e |
to the code. It can also be used to clean the acpica source and generate
|
|
Packit Service |
1fb00e |
statistics.
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
6) acpixtract, extract binary ACPI tables from an acpidump
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
acpixtract is used to extract binary ACPI tables from the ASCII text
|
|
Packit Service |
1fb00e |
output of an acpidump utility (available on several different hosts.)
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
7) iasl, an optimizing ASL compiler/disassembler
|
|
Packit Service |
1fb00e |
|
|
Packit Service |
1fb00e |
iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine
|
|
Packit Service |
1fb00e |
Language). This AML is suitable for inclusion as a DSDT in system
|
|
Packit Service |
1fb00e |
firmware. It also can disassemble AML, for debugging purposes.
|