kolibrios/drivers/devman/acpica
Sergey Semyonov (Serge) 8ec96e9db0 update acpica
git-svn-id: svn://kolibrios.org@2216 a494cfbc-eb01-0410-851d-a64ba20cac60
2011-09-20 16:54:11 +00:00
..
common update acpica 2011-09-20 16:54:11 +00:00
compiler update acpica 2011-09-20 16:54:11 +00:00
debugger update acpica 2011-09-20 16:54:11 +00:00
disassembler update acpica 2011-09-20 16:54:11 +00:00
dispatcher update acpica 2011-09-20 16:54:11 +00:00
events update acpica 2011-09-20 16:54:11 +00:00
executer update acpica 2011-09-20 16:54:11 +00:00
generate update acpica 2011-09-20 16:54:11 +00:00
hardware update acpica 2011-09-20 16:54:11 +00:00
include update acpica 2011-09-20 16:54:11 +00:00
namespace update acpica 2011-09-20 16:54:11 +00:00
os_specific/service_layers update acpica 2011-09-20 16:54:11 +00:00
parser update acpica 2011-09-20 16:54:11 +00:00
resources update acpica 2011-09-20 16:54:11 +00:00
tables update acpica 2011-09-20 16:54:11 +00:00
tests/misc update acpica 2011-09-20 16:54:11 +00:00
tools update acpica 2011-09-20 16:54:11 +00:00
utilities update acpica 2011-09-20 16:54:11 +00:00
changes.txt update acpica 2011-09-20 16:54:11 +00:00
Makefile update acpica 2011-09-20 16:54:11 +00:00
osunixxf.c update acpica 2011-09-20 16:54:11 +00:00
README update acpica 2011-09-20 16:54:11 +00:00

Makefiles for tool generation from the unix tarball
---------------------------------------------------

These makefiles are intended to generate the ACPICA utilities in
a Linux or Unix-like environment, from the ACPICA source code
as released in the unix tarball.

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 acpica/source/tools directory contains the following utilities.
Note: These utilities are tested and supported as 32-bit versions
only.

acpibin
acpiexec
acpihelp
acpinames
acpisrc
acpixtract
iasl


Requirements
------------

make
gcc compiler (4+)
bison or yacc
flex or lex


Configuration
-------------

The Makefiles contain this configuration information:

HOST =       _LINUX             /* Host system, must appear in acenv.h */
CC =         gcc                /* C compiler */


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.

To compile:

cd acpica/source/tools/acpibin
make
make install   /* install the binary to /usr/bin */


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.

To compile:

cd acpica/source/tools/acpiexec
make
make install   /* install the binary to /usr/bin */


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.)

To compile:

cd acpica/source/tools/acpihelp
make
make install   /* install the binary to /usr/bin */


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.

To compile:

cd acpica/source/tools/acpinames
make
make install   /* install the binary to /usr/bin */


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.

To compile:

cd acpica/source/tools/acpisrc
make
make install   /* install the binary to /usr/bin */


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.)

To compile:

cd acpica/source/tools/acpixtract
make
make install   /* install the binary to /usr/bin */


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.

To compile:

cd acpica/source/compiler
make
make install   /* install the binary to /usr/bin */