sys/contrib/dev/acpica-unix-20061109/compiler/readme.txt

   1
   2 Instructions for integrating iASL compiler into MS VC++ 6.0 environment.
   3
   4 Part 1.  Integration as a custom tool
   5
   6 This procedure adds the iASL compiler as a custom tool that can be used
   7 to compile ASL source files.  The output is sent to the VC output
   8 window.
   9
  10 a) Select Tools->Customize.
  11
  12 b) Select the "Tools" tab.
  13
  14 c) Scroll down to the bottom of the "Menu Contents" window.  There you
  15    will see an empty rectangle.  Click in the rectangle to enter a
  16    name for this tool.
  17
  18 d) Type "iASL Compiler" in the box and hit enter.  You can now edit
  19    the other fields for this new custom tool.
  20
  21 e) Enter the following into the fields:
  22
  23    Command:             C:\Acpi\iasl.exe
  24    Arguments:           -e "$(FilePath)"
  25    Initial Directory    "$(FileDir)"
  26    Use Output Window    <Check this option>
  27
  28    "Command" must be the path to wherever you copied the compiler.
  29    "-e" instructs the compiler to produce messages appropriate for VC.
  30    Quotes around FilePath and FileDir enable spaces in filenames.
  31
  32 f) Select "Close".
  33
  34 These steps will add the compiler to the tools menu as a custom tool.
  35 By enabling "Use Output Window", you can click on error messages in
  36 the output window and the source file and source line will be
  37 automatically displayed by VC.  Also, you can use F4 to step through
  38 the messages and the corresponding source line(s).
  39
  40
  41 Part 2.  Integration into a project build
  42
  43 This procedure creates a project that compiles ASL files to AML.
  44
  45 a) Create a new, empty project and add your .ASL files to the project
  46
  47 b) For all ASL files in the project, specify a custom build (under
  48 Project/Settings/CustomBuild with the following settings (or similar):
  49
  50 Commands:
  51 c:\acpi\libraries\iasl.exe -vs -vi "$(InputPath)"
  52
  53 Output:
  54 $(InputDir)\$(InputPath).aml
  55
  56
  57
  58 Compiler Generation From Source
  59
  60 Generation of the ASL compiler from source code requires these items:
  61
  62
  63 Required Tools
  64 1) The Flex (or Lex) lexical analyzer generator.
  65 2) The Bison (or Yacc) parser generator.
  66 3) An ANSI C compiler.
  67
  68
  69 Required Source Code.
  70
  71 There are three major source code components that are required to
  72 generate the compiler:
  73
  74 1) The ASL compiler source.
  75 2) The ACPI CA Core Subsystem source.  In particular, the Namespace Manager
  76      component is used to create an internal ACPI namespace and symbol table,
  77      and the AML Interpreter is used to evaluate constant expressions.
  78 3) The Common source for all ACPI components.
  79
  80
  81
  82
  83
  84
  85