Subversion Repositories Kolibri OS

Rev

Rev 1498 | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. Makefiles for tool generation from the unix tarball
  2. ---------------------------------------------------
  3.  
  4. These makefiles are intended to generate the ACPICA utilities in
  5. a Linux or Unix-like environment, from the ACPICA source code
  6. as released in the unix tarball.
  7.  
  8. Windows binary versions of these tools are available at:
  9.  
  10. http://www.acpica.org/downloads/binary_tools.php
  11.  
  12. Documentation is available at acpica.org:
  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
  18. only.
  19.  
  20. acpibin
  21. acpiexec
  22. acpihelp
  23. acpinames
  24. acpisrc
  25. acpixtract
  26. iasl
  27.  
  28.  
  29. Requirements
  30. ------------
  31.  
  32. make
  33. gcc compiler (4+)
  34. bison or yacc
  35. flex or lex
  36.  
  37.  
  38. Configuration
  39. -------------
  40.  
  41. The Makefiles contain this configuration information:
  42.  
  43. HOST =       _LINUX             /* Host system, must appear in acenv.h */
  44. CC =         gcc                /* C compiler */
  45.  
  46.  
  47. 1) acpibin, an AML file tool
  48.  
  49. acpibin compares AML files, dumps AML binary files to text files,
  50. extracts binary AML from text files, and other AML file
  51. manipulation.
  52.  
  53. To compile:
  54.  
  55. cd acpica/source/tools/acpibin
  56. make
  57. make install   /* install the binary to /usr/bin */
  58.  
  59.  
  60. 2) acpiexec, a user-space AML interpreter
  61.  
  62. acpiexec allows the loading of ACPI tables and execution of control
  63. methods from user space. Useful for debugging AML code and testing
  64. the AML interpreter. Hardware access is simulated.
  65.  
  66. To compile:
  67.  
  68. cd acpica/source/tools/acpiexec
  69. make
  70. make install   /* install the binary to /usr/bin */
  71.  
  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
  76. as information about the ASL/ACPI reserved names (4-char names that
  77. start with underscore.)
  78.  
  79. To compile:
  80.  
  81. cd acpica/source/tools/acpihelp
  82. make
  83. make install   /* install the binary to /usr/bin */
  84.  
  85.  
  86. 4) acpinames, load and dump acpi namespace
  87.  
  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
  90. dumps the resulting namespace. It is primarily intended to demonstrate
  91. the configurability of ACPICA.
  92.  
  93. To compile:
  94.  
  95. cd acpica/source/tools/acpinames
  96. make
  97. make install   /* install the binary to /usr/bin */
  98.  
  99.  
  100. 5) acpisrc, a source code conversion tool
  101.  
  102. acpisrc converts the standard form of the acpica source release (included
  103. here) into a version that meets Linux coding guidelines. This consists
  104. mainly of performing a series of string replacements and transformations
  105. to the code. It can also be used to clean the acpica source and generate
  106. statistics.
  107.  
  108. To compile:
  109.  
  110. cd acpica/source/tools/acpisrc
  111. make
  112. make install   /* install the binary to /usr/bin */
  113.  
  114.  
  115. 6) acpixtract, extract binary ACPI tables from an acpidump
  116.  
  117. acpixtract is used to extract binary ACPI tables from the ASCII text
  118. output of an acpidump utility (available on several different hosts.)
  119.  
  120. To compile:
  121.  
  122. cd acpica/source/tools/acpixtract
  123. make
  124. make install   /* install the binary to /usr/bin */
  125.  
  126.  
  127. 7) iasl, an optimizing ASL compiler/disassembler
  128.  
  129. iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine
  130. Language). This AML is suitable for inclusion as a DSDT in system
  131. firmware. It also can disassemble AML, for debugging purposes.
  132.  
  133. To compile:
  134.  
  135. cd acpica/source/compiler
  136. make
  137. make install   /* install the binary to /usr/bin */
  138.