Rev 1498 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed
| Rev 1498 | Rev 2216 | ||
|---|---|---|---|
| Line 1... | Line 1... | ||
| 1 | acpica-unix |
1 | Makefiles for tool generation from the unix tarball |
| 2 | ----------- |
2 | --------------------------------------------------- |
| Line -... | Line 3... | ||
| - | 3 | ||
| - | 4 | These makefiles are intended to generate the ACPICA utilities in |
|
| 3 | 5 | a Linux or Unix-like environment, from the ACPICA source code |
|
| Line -... | Line 6... | ||
| - | 6 | as released in the unix tarball. |
|
| Line 4... | Line 7... | ||
| 4 | This source release includes: |
7 | |
| Line 5... | Line 8... | ||
| 5 | 8 | Windows binary versions of these tools are available at: |
|
| 6 | - | ||
| 7 | 1) a cross-OS AML interpreter |
- | |
| 8 | - | ||
| Line 9... | Line -... | ||
| 9 | This is intended to allow commercial and open source operating systems |
- | |
| 10 | to be enabled for ACPI. OS specific code is still needed, but the |
- | |
| 11 | AML interpreter should greatly improve the development speed of ACPI |
- | |
| 12 | support. |
9 | |
| 13 | - | ||
| Line -... | Line 10... | ||
| - | 10 | http://www.acpica.org/downloads/binary_tools.php |
|
| - | 11 | ||
| - | 12 | Documentation is available at acpica.org: |
|
| Line -... | Line 13... | ||
| - | 13 | ||
| - | 14 | http://www.acpica.org/documentation/ |
|
| - | 15 | ||
| - | 16 | The acpica/source/tools directory contains the following utilities. |
|
| - | 17 | Note: These utilities are tested and supported as 32-bit versions |
|
| 14 | The AML interpreter source should be integrated into the kernel's |
18 | only. |
| - | 19 | ||
| Line -... | Line 20... | ||
| - | 20 | acpibin |
|
| - | 21 | acpiexec |
|
| - | 22 | acpihelp |
|
| - | 23 | acpinames |
|
| - | 24 | acpisrc |
|
| - | 25 | acpixtract |
|
| - | 26 | iasl |
|
| - | 27 | ||
| - | 28 | ||
| - | 29 | Requirements |
|
| - | 30 | ------------ |
|
| - | 31 | ||
| - | 32 | make |
|
| 15 | build process. We recommend establishing an automated method for |
33 | gcc compiler (4+) |
| - | 34 | bison or yacc |
|
| - | 35 | flex or lex |
|
| - | 36 | ||
| - | 37 | ||
| - | 38 | Configuration |
|
| - | 39 | ------------- |
|
| - | 40 | ||
| 16 | this, so later versions can also be incorporated easily. Please see |
41 | The Makefiles contain this configuration information: |
| 17 | the documentation on the website for API and other implementation |
42 | |
| - | 43 | HOST = _LINUX /* Host system, must appear in acenv.h */ |
|
| Line 18... | Line 44... | ||
| 18 | information. |
44 | CC = gcc /* C compiler */ |
| Line 19... | Line 45... | ||
| 19 | 45 | ||
| 20 | 46 | ||
| - | 47 | 1) acpibin, an AML file tool |
|
| - | 48 | ||
| Line 21... | Line 49... | ||
| 21 | 2) iasl, an ASL compiler/decompiler |
49 | acpibin compares AML files, dumps AML binary files to text files, |
| 22 | - | ||
| Line 23... | Line 50... | ||
| 23 | iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine |
50 | extracts binary AML from text files, and other AML file |
| - | 51 | manipulation. |
|
| 24 | Language). This AML is suitable for inclusion as a DSDT in system |
52 | |
| Line -... | Line 53... | ||
| - | 53 | To compile: |
|
| Line 25... | Line 54... | ||
| 25 | firmware. It also can disassemble AML, for debugging purposes. |
54 | |
| - | 55 | cd acpica/source/tools/acpibin |
|
| - | 56 | make |
|
| Line -... | Line 57... | ||
| - | 57 | make install /* install the binary to /usr/bin */ |
|
| 26 | 58 | ||
| - | 59 | ||
| 27 | To compile: |
60 | 2) acpiexec, a user-space AML interpreter |
| 28 | 61 | ||
| 29 | cd compiler |
62 | acpiexec allows the loading of ACPI tables and execution of control |
| Line 30... | Line 63... | ||
| 30 | make |
63 | methods from user space. Useful for debugging AML code and testing |
| Line 31... | Line 64... | ||
| 31 | 64 | the AML interpreter. Hardware access is simulated. |
|
| 32 | It has been compiled on Linux, but should easily port to other Unix |
65 | |
| - | 66 | To compile: |
|
| Line 33... | Line -... | ||
| 33 | environments. |
- | |
| 34 | - | ||
| Line -... | Line 67... | ||
| - | 67 | ||
| Line -... | Line 68... | ||
| - | 68 | cd acpica/source/tools/acpiexec |
|
| - | 69 | make |
|
| - | 70 | make install /* install the binary to /usr/bin */ |
|
| 35 | Run 'iasl -h' for more information, or download the binary version for |
71 | |
| Line -... | Line 72... | ||
| - | 72 | ||
| - | 73 | 3) acpihelp, syntax help for ASL operators and reserved names |
|
| - | 74 | ||
| - | 75 | acpihelp displays the syntax for all of the ASL operators, as well |
|
| 36 | documentation in PDF format. |
76 | as information about the ASL/ACPI reserved names (4-char names that |
| - | 77 | start with underscore.) |
|
| - | 78 | ||
| 37 | 79 | To compile: |
|
| - | 80 | ||
| - | 81 | cd acpica/source/tools/acpihelp |
|
| - | 82 | make |
|
| - | 83 | make install /* install the binary to /usr/bin */ |
|
| - | 84 | ||
| 38 | 85 | ||
| Line 39... | Line 86... | ||
| 39 | 3) acpisrc, a source code conversion tool |
86 | 4) acpinames, load and dump acpi namespace |
| Line 40... | Line 87... | ||
| 40 | 87 | ||
| 41 | acpisrc converts the standard form of the acpica source release (included |
88 | acpinames loads an ACPI namespace from a binary ACPI table file. |
| - | 89 | This is a smaller version of acpiexec that loads an acpi table and |
|
| Line 42... | Line 90... | ||
| 42 | here) into a version that meets Linux coding guidelines. This consists |
90 | dumps the resulting namespace. It is primarily intended to demonstrate |
| Line 43... | Line 91... | ||
| 43 | mainly of performing a series of string replacements and transformations |
91 | the configurability of ACPICA. |
| 44 | to the code. |
92 | |
| 45 | - | ||
| Line 46... | Line 93... | ||
| 46 | To compile: |
93 | To compile: |
| Line 47... | Line 94... | ||
| 47 | 94 | ||
| 48 | cd tools/acpisrc |
95 | cd acpica/source/tools/acpinames |
| - | 96 | make |
|
| - | 97 | make install /* install the binary to /usr/bin */ |
|
| - | 98 | ||
| - | 99 | ||
| Line -... | Line 100... | ||
| - | 100 | 5) acpisrc, a source code conversion tool |
|
| - | 101 | ||
| - | 102 | acpisrc converts the standard form of the acpica source release (included |
|
| Line -... | Line 103... | ||
| - | 103 | here) into a version that meets Linux coding guidelines. This consists |
|
| - | 104 | mainly of performing a series of string replacements and transformations |
|
| 49 | make |
105 | to the code. It can also be used to clean the acpica source and generate |
| - | 106 | statistics. |
|
| - | 107 | ||