| 1,79 → 1,137 |
|---|
| acpica-unix |
| ----------- |
| Makefiles for tool generation from the unix tarball |
| --------------------------------------------------- |
| |
| This source release includes: |
| 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: |
| |
| 1) a cross-OS AML interpreter |
| http://www.acpica.org/downloads/binary_tools.php |
| |
| This is intended to allow commercial and open source operating systems |
| to be enabled for ACPI. OS specific code is still needed, but the |
| AML interpreter should greatly improve the development speed of ACPI |
| support. |
| Documentation is available at acpica.org: |
| |
| The AML interpreter source should be integrated into the kernel's |
| build process. We recommend establishing an automated method for |
| this, so later versions can also be incorporated easily. Please see |
| the documentation on the website for API and other implementation |
| information. |
| 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. |
| |
| 2) iasl, an ASL compiler/decompiler |
| acpibin |
| acpiexec |
| acpihelp |
| acpinames |
| acpisrc |
| acpixtract |
| iasl |
| |
| 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. |
| |
| 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 compiler |
| cd acpica/source/tools/acpibin |
| make |
| make install /* install the binary to /usr/bin */ |
| |
| It has been compiled on Linux, but should easily port to other Unix |
| environments. |
| |
| Run 'iasl -h' for more information, or download the binary version for |
| documentation in PDF format. |
| 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) acpisrc, a source code conversion tool |
| 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. |
| to the code. It can also be used to clean the acpica source and generate |
| statistics. |
| |
| To compile: |
| |
| cd tools/acpisrc |
| cd acpica/source/tools/acpisrc |
| make |
| make install /* install the binary to /usr/bin */ |
| |
| It has been compiled on Linux, but should easily port to other Unix |
| environments. |
| |
| 6) acpixtract, extract binary ACPI tables from an acpidump |
| |
| 4) acpibin, an AML file tool |
| acpixtract is used to extract binary ACPI tables from the ASCII text |
| output of an acpidump utility (available on several different hosts.) |
| |
| 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 tools/acpibin |
| cd acpica/source/tools/acpixtract |
| make |
| make install /* install the binary to /usr/bin */ |
| |
| |
| 5) acpiexec, a user-space AML interpreter |
| 7) iasl, an optimizing ASL compiler/disassembler |
| |
| 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. |
| 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 tools/acpiexec |
| cd acpica/source/compiler |
| make |
| |
| |
| Thanks -- The ACPI CA Team |
| make install /* install the binary to /usr/bin */ |