1*0d02842fSSascha WildnerGeneric Unix ACPICA makefiles 2*0d02842fSSascha Wildner----------------------------- 3*0d02842fSSascha Wildner 4*0d02842fSSascha WildnerThese makefiles are intended to generate the ACPICA utilities in 5*0d02842fSSascha Wildnera Unix-like environment, with the original ACPICA code (not linuxized), 6*0d02842fSSascha Wildnerand in the original (git tree) ACPICA directory structure. 7*0d02842fSSascha Wildner 8*0d02842fSSascha WildnerWindows binary versions of these tools are available at: 9*0d02842fSSascha Wildner 10*0d02842fSSascha Wildnerhttp://www.acpica.org/downloads/binary_tools.php 11*0d02842fSSascha Wildner 12*0d02842fSSascha WildnerDocumentation is available at acpica.org: 13*0d02842fSSascha Wildner 14*0d02842fSSascha Wildnerhttp://www.acpica.org/documentation/ 15*0d02842fSSascha Wildner 16*0d02842fSSascha WildnerThe top level makefile will generate the following utilities: 17*0d02842fSSascha WildnerNote: These utilities are tested and supported as 32-bit versions 18*0d02842fSSascha Wildneronly. 19*0d02842fSSascha Wildner 20*0d02842fSSascha Wildneracpibin 21*0d02842fSSascha Wildneracpiexec 22*0d02842fSSascha Wildneracpihelp 23*0d02842fSSascha Wildneracpinames 24*0d02842fSSascha Wildneracpisrc 25*0d02842fSSascha Wildneracpixtract 26*0d02842fSSascha Wildneriasl 27*0d02842fSSascha Wildner 28*0d02842fSSascha WildnerTo generate all utilities: 29*0d02842fSSascha Wildner 30*0d02842fSSascha Wildnercd acpica/generate/unix 31*0d02842fSSascha Wildnermake 32*0d02842fSSascha Wildnermake install /* install all binaries to /usr/bin */ 33*0d02842fSSascha Wildner 34*0d02842fSSascha Wildner 35*0d02842fSSascha WildnerRequirements 36*0d02842fSSascha Wildner------------ 37*0d02842fSSascha Wildner 38*0d02842fSSascha Wildnermake 39*0d02842fSSascha Wildnergcc compiler (4+) 40*0d02842fSSascha Wildnerbison or yacc 41*0d02842fSSascha Wildnerflex or lex 42*0d02842fSSascha Wildner 43*0d02842fSSascha Wildner 44*0d02842fSSascha WildnerConfiguration 45*0d02842fSSascha Wildner------------- 46*0d02842fSSascha Wildner 47*0d02842fSSascha WildnerThe Makefile.config file contains the configuration information: 48*0d02842fSSascha Wildner 49*0d02842fSSascha WildnerHOST = _CYGWIN /* Host system, must appear in acenv.h */ 50*0d02842fSSascha WildnerCC = gcc /* C compiler */ 51*0d02842fSSascha WildnerACPICA_SRC = ../../../source /* Location of acpica source tree */ 52*0d02842fSSascha Wildner 53*0d02842fSSascha Wildner 54*0d02842fSSascha WildnerIntermediate Files 55*0d02842fSSascha Wildner------------------ 56*0d02842fSSascha Wildner 57*0d02842fSSascha WildnerThe intermediate files for each utility (.o, etc.) are placed in the 58*0d02842fSSascha Wildnersubdirectory corresponding to each utility, not in the source code 59*0d02842fSSascha Wildnertree itself. This prevents collisions when different utilities compile 60*0d02842fSSascha Wildnerthe same source modules with different options. 61*0d02842fSSascha Wildner 62*0d02842fSSascha Wildner 63*0d02842fSSascha WildnerOutput 64*0d02842fSSascha Wildner------ 65*0d02842fSSascha Wildner 66*0d02842fSSascha WildnerThe executable utilities are copied to the local bin directory. 67*0d02842fSSascha Wildner 68*0d02842fSSascha Wildner"make install" will install the binaries to /usr/bin 69*0d02842fSSascha Wildner 70*0d02842fSSascha Wildner 71*0d02842fSSascha Wildner 72*0d02842fSSascha Wildner1) acpibin, an AML file tool 73*0d02842fSSascha Wildner 74*0d02842fSSascha Wildneracpibin compares AML files, dumps AML binary files to text files, 75*0d02842fSSascha Wildnerextracts binary AML from text files, and other AML file 76*0d02842fSSascha Wildnermanipulation. 77*0d02842fSSascha Wildner 78*0d02842fSSascha Wildner 79*0d02842fSSascha Wildner2) acpiexec, a user-space AML interpreter 80*0d02842fSSascha Wildner 81*0d02842fSSascha Wildneracpiexec allows the loading of ACPI tables and execution of control 82*0d02842fSSascha Wildnermethods from user space. Useful for debugging AML code and testing 83*0d02842fSSascha Wildnerthe AML interpreter. Hardware access is simulated. 84*0d02842fSSascha Wildner 85*0d02842fSSascha Wildner 86*0d02842fSSascha Wildner3) acpihelp, syntax help for ASL operators and reserved names 87*0d02842fSSascha Wildner 88*0d02842fSSascha Wildneracpihelp displays the syntax for all of the ASL operators, as well 89*0d02842fSSascha Wildneras information about the ASL/ACPI reserved names (4-char names that 90*0d02842fSSascha Wildnerstart with underscore.) 91*0d02842fSSascha Wildner 92*0d02842fSSascha Wildner 93*0d02842fSSascha Wildner4) acpinames, load and dump acpi namespace 94*0d02842fSSascha Wildner 95*0d02842fSSascha Wildneracpinames loads an ACPI namespace from a binary ACPI table file. 96*0d02842fSSascha WildnerThis is a smaller version of acpiexec that loads an acpi table and 97*0d02842fSSascha Wildnerdumps the resulting namespace. It is primarily intended to demonstrate 98*0d02842fSSascha Wildnerthe configurability of ACPICA. 99*0d02842fSSascha Wildner 100*0d02842fSSascha Wildner 101*0d02842fSSascha Wildner5) acpisrc, a source code conversion tool 102*0d02842fSSascha Wildner 103*0d02842fSSascha Wildneracpisrc converts the standard form of the acpica source release (included 104*0d02842fSSascha Wildnerhere) into a version that meets Linux coding guidelines. This consists 105*0d02842fSSascha Wildnermainly of performing a series of string replacements and transformations 106*0d02842fSSascha Wildnerto the code. It can also be used to clean the acpica source and generate 107*0d02842fSSascha Wildnerstatistics. 108*0d02842fSSascha Wildner 109*0d02842fSSascha Wildner 110*0d02842fSSascha Wildner6) acpixtract, extract binary ACPI tables from an acpidump 111*0d02842fSSascha Wildner 112*0d02842fSSascha Wildneracpixtract is used to extract binary ACPI tables from the ASCII text 113*0d02842fSSascha Wildneroutput of an acpidump utility (available on several different hosts.) 114*0d02842fSSascha Wildner 115*0d02842fSSascha Wildner 116*0d02842fSSascha Wildner7) iasl, an optimizing ASL compiler/disassembler 117*0d02842fSSascha Wildner 118*0d02842fSSascha Wildneriasl compiles ASL (ACPI Source Language) into AML (ACPI Machine 119*0d02842fSSascha WildnerLanguage). This AML is suitable for inclusion as a DSDT in system 120*0d02842fSSascha Wildnerfirmware. It also can disassemble AML, for debugging purposes. 121