kolibrios/drivers/devman/acpica/generate/unix/readme.txt

121 lines
3.2 KiB
Plaintext
Raw Normal View History

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