sys/contrib/dev/acpica-unix/README

   1 acpica-unix
   2 -----------
   3
   4 This source release includes:
   5
   6
   7 1) a cross-OS AML interpreter
   8
   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.
  13
  14 The AML interpreter source should be integrated into the kernel's
  15 build process. We recommend establishing an automated method for
  16 this, so later versions can also be incorporated easily. Please see
  17 the documentation on the website for API and other implementation
  18 information.
  19
  20
  21 2) iasl, an ASL compiler/decompiler
  22
  23 iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine
  24 Language). This AML is suitable for inclusion as a DSDT in system
  25 firmware. It also can disassemble AML, for debugging purposes.
  26
  27 To compile:
  28
  29 cd compiler
  30 make
  31
  32 It has been compiled on Linux, but should easily port to other Unix
  33 environments.
  34
  35 Run 'iasl -h' for more information, or download the binary version for
  36 documentation in PDF format.
  37
  38
  39 3) acpisrc, a source code conversion tool
  40
  41 acpisrc converts the standard form of the acpica source release (included
  42 here) into a version that meets Linux coding guidelines. This consists
  43 mainly of performing a series of string replacements and transformations
  44 to the code.
  45
  46 To compile:
  47
  48 cd tools/acpisrc
  49 make
  50
  51 It has been compiled on Linux, but should easily port to other Unix
  52 environments.
  53
  54
  55 4) acpibin, an AML file tool
  56
  57 acpibin compares AML files, dumps AML binary files to text files,
  58 extracts binary AML from text files, and other AML file
  59 manipulation.
  60
  61 To compile:
  62
  63 cd tools/acpibin
  64 make
  65
  66
  67 5) acpiexec, a user-space AML interpreter
  68
  69 acpiexec allows the loading of ACPI tables and execution of control
  70 methods from user space.  Useful for debugging AML code and testing
  71 the AML interpreter.
  72
  73 To compile:
  74
  75 cd tools/acpiexec
  76 make
  77
  78
  79 Thanks -- The ACPI CA Team