readme.txt revision 1.1.1.2
1 1.1.1.2 jruoho Generic Unix ACPICA makefiles 2 1.1.1.2 jruoho ----------------------------- 3 1.1 jruoho 4 1.1.1.2 jruoho These makefiles are intended to generate the ACPICA utilities in 5 1.1 jruoho a Unix-like environment, with the original ACPICA code (not linuxized), 6 1.1 jruoho and in the original (git tree) ACPICA directory structure. 7 1.1 jruoho 8 1.1.1.2 jruoho Windows binary versions of these tools are available at: 9 1.1.1.2 jruoho 10 1.1.1.2 jruoho http://www.acpica.org/downloads/binary_tools.php 11 1.1.1.2 jruoho 12 1.1.1.2 jruoho Documentation is available at acpica.org: 13 1.1.1.2 jruoho 14 1.1.1.2 jruoho http://www.acpica.org/documentation/ 15 1.1.1.2 jruoho 16 1.1 jruoho The top level makefile will generate the following utilities: 17 1.1.1.2 jruoho Note: These utilities are tested and supported as 32-bit versions 18 1.1.1.2 jruoho only. 19 1.1 jruoho 20 1.1.1.2 jruoho acpibin 21 1.1 jruoho acpiexec 22 1.1.1.2 jruoho acpihelp 23 1.1 jruoho acpinames 24 1.1 jruoho acpisrc 25 1.1 jruoho acpixtract 26 1.1 jruoho iasl 27 1.1 jruoho 28 1.1.1.2 jruoho To generate all utilities: 29 1.1.1.2 jruoho 30 1.1.1.2 jruoho cd acpica/generate/unix 31 1.1.1.2 jruoho make 32 1.1.1.2 jruoho make install /* install all binaries to /usr/bin */ 33 1.1.1.2 jruoho 34 1.1 jruoho 35 1.1 jruoho Requirements 36 1.1 jruoho ------------ 37 1.1 jruoho 38 1.1 jruoho make 39 1.1.1.2 jruoho gcc compiler (4+) 40 1.1.1.2 jruoho bison or yacc 41 1.1.1.2 jruoho flex or lex 42 1.1 jruoho 43 1.1 jruoho 44 1.1 jruoho Configuration 45 1.1 jruoho ------------- 46 1.1 jruoho 47 1.1 jruoho The Makefile.config file contains the configuration information: 48 1.1 jruoho 49 1.1 jruoho HOST = _CYGWIN /* Host system, must appear in acenv.h */ 50 1.1.1.2 jruoho CC = gcc /* C compiler */ 51 1.1 jruoho ACPICA_SRC = ../../../source /* Location of acpica source tree */ 52 1.1 jruoho 53 1.1 jruoho 54 1.1 jruoho Intermediate Files 55 1.1 jruoho ------------------ 56 1.1 jruoho 57 1.1 jruoho The intermediate files for each utility (.o, etc.) are placed in the 58 1.1 jruoho subdirectory corresponding to each utility, not in the source code 59 1.1 jruoho tree itself. This prevents collisions when different utilities compile 60 1.1 jruoho the same source modules with different options. 61 1.1 jruoho 62 1.1 jruoho 63 1.1 jruoho Output 64 1.1 jruoho ------ 65 1.1 jruoho 66 1.1 jruoho The executable utilities are copied to the local bin directory. 67 1.1 jruoho 68 1.1 jruoho "make install" will install the binaries to /usr/bin 69 1.1 jruoho 70 1.1.1.2 jruoho 71 1.1.1.2 jruoho 72 1.1.1.2 jruoho 1) acpibin, an AML file tool 73 1.1.1.2 jruoho 74 1.1.1.2 jruoho acpibin compares AML files, dumps AML binary files to text files, 75 1.1.1.2 jruoho extracts binary AML from text files, and other AML file 76 1.1.1.2 jruoho manipulation. 77 1.1.1.2 jruoho 78 1.1.1.2 jruoho 79 1.1.1.2 jruoho 2) acpiexec, a user-space AML interpreter 80 1.1.1.2 jruoho 81 1.1.1.2 jruoho acpiexec allows the loading of ACPI tables and execution of control 82 1.1.1.2 jruoho methods from user space. Useful for debugging AML code and testing 83 1.1.1.2 jruoho the AML interpreter. Hardware access is simulated. 84 1.1.1.2 jruoho 85 1.1.1.2 jruoho 86 1.1.1.2 jruoho 3) acpihelp, syntax help for ASL operators and reserved names 87 1.1.1.2 jruoho 88 1.1.1.2 jruoho acpihelp displays the syntax for all of the ASL operators, as well 89 1.1.1.2 jruoho as information about the ASL/ACPI reserved names (4-char names that 90 1.1.1.2 jruoho start with underscore.) 91 1.1.1.2 jruoho 92 1.1.1.2 jruoho 93 1.1.1.2 jruoho 4) acpinames, load and dump acpi namespace 94 1.1.1.2 jruoho 95 1.1.1.2 jruoho acpinames loads an ACPI namespace from a binary ACPI table file. 96 1.1.1.2 jruoho This is a smaller version of acpiexec that loads an acpi table and 97 1.1.1.2 jruoho dumps the resulting namespace. It is primarily intended to demonstrate 98 1.1.1.2 jruoho the configurability of ACPICA. 99 1.1.1.2 jruoho 100 1.1.1.2 jruoho 101 1.1.1.2 jruoho 5) acpisrc, a source code conversion tool 102 1.1.1.2 jruoho 103 1.1.1.2 jruoho acpisrc converts the standard form of the acpica source release (included 104 1.1.1.2 jruoho here) into a version that meets Linux coding guidelines. This consists 105 1.1.1.2 jruoho mainly of performing a series of string replacements and transformations 106 1.1.1.2 jruoho to the code. It can also be used to clean the acpica source and generate 107 1.1.1.2 jruoho statistics. 108 1.1.1.2 jruoho 109 1.1.1.2 jruoho 110 1.1.1.2 jruoho 6) acpixtract, extract binary ACPI tables from an acpidump 111 1.1.1.2 jruoho 112 1.1.1.2 jruoho acpixtract is used to extract binary ACPI tables from the ASCII text 113 1.1.1.2 jruoho output of an acpidump utility (available on several different hosts.) 114 1.1.1.2 jruoho 115 1.1.1.2 jruoho 116 1.1.1.2 jruoho 7) iasl, an optimizing ASL compiler/disassembler 117 1.1.1.2 jruoho 118 1.1.1.2 jruoho iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine 119 1.1.1.2 jruoho Language). This AML is suitable for inclusion as a DSDT in system 120 1.1.1.2 jruoho firmware. It also can disassemble AML, for debugging purposes. 121
Indexes created Tue Sep 30 11:09:46 GMT 2025