sys/contrib/dev/acpica/source/compiler/asltypes.h

   1 /******************************************************************************
   2  *
   3  * Module Name: asltypes.h - compiler data types and struct definitions
   4  *
   5  *****************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2015, Intel Corp.
   9  * All rights reserved.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions, and the following disclaimer,
  16  *    without modification.
  17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  18  *    substantially similar to the "NO WARRANTY" disclaimer below
  19  *    ("Disclaimer") and any redistribution must be conditioned upon
  20  *    including a substantially similar Disclaimer requirement for further
  21  *    binary redistribution.
  22  * 3. Neither the names of the above-listed copyright holders nor the names
  23  *    of any contributors may be used to endorse or promote products derived
  24  *    from this software without specific prior written permission.
  25  *
  26  * Alternatively, this software may be distributed under the terms of the
  27  * GNU General Public License ("GPL") version 2 as published by the Free
  28  * Software Foundation.
  29  *
  30  * NO WARRANTY
  31  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  32  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  33  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  34  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  35  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  39  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  40  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  41  * POSSIBILITY OF SUCH DAMAGES.
  42  */
  43
  44 #ifndef __ASLTYPES_H
  45 #define __ASLTYPES_H
  46
  47
  48 /*******************************************************************************
  49  *
  50  * Structure definitions
  51  *
  52  ******************************************************************************/
  53
  54
  55 /* Op flags for the ACPI_PARSE_OBJECT */
  56
  57 #define NODE_VISITED                0x00000001
  58 #define NODE_AML_PACKAGE            0x00000002
  59 #define NODE_IS_TARGET              0x00000004
  60 #define NODE_IS_RESOURCE_DESC       0x00000008
  61 #define NODE_IS_RESOURCE_FIELD      0x00000010
  62 #define NODE_HAS_NO_EXIT            0x00000020
  63 #define NODE_IF_HAS_NO_EXIT         0x00000040
  64 #define NODE_NAME_INTERNALIZED      0x00000080
  65 #define NODE_METHOD_NO_RETVAL       0x00000100
  66 #define NODE_METHOD_SOME_NO_RETVAL  0x00000200
  67 #define NODE_RESULT_NOT_USED        0x00000400
  68 #define NODE_METHOD_TYPED           0x00000800
  69 #define NODE_COULD_NOT_REDUCE       0x00001000
  70 #define NODE_COMPILE_TIME_CONST     0x00002000
  71 #define NODE_IS_TERM_ARG            0x00004000
  72 #define NODE_WAS_ONES_OP            0x00008000
  73 #define NODE_IS_NAME_DECLARATION    0x00010000
  74 #define NODE_COMPILER_EMITTED       0x00020000
  75 #define NODE_IS_DUPLICATE           0x00040000
  76 #define NODE_IS_RESOURCE_DATA       0x00080000
  77 #define NODE_IS_NULL_RETURN         0x00100000
  78
  79 /* Keeps information about individual control methods */
  80
  81 typedef struct asl_method_info
  82 {
  83     ACPI_PARSE_OBJECT       *Op;
  84     struct asl_method_info  *Next;
  85     UINT32                  ValidArgTypes[ACPI_METHOD_NUM_ARGS];
  86     UINT32                  ValidReturnTypes;
  87     UINT32                  NumReturnNoValue;
  88     UINT32                  NumReturnWithValue;
  89     UINT8                   NumArguments;
  90     UINT8                   LocalInitialized[ACPI_METHOD_NUM_LOCALS];
  91     UINT8                   ArgInitialized[ACPI_METHOD_NUM_ARGS];
  92     UINT8                   HasBeenTyped;
  93     UINT8                   ShouldBeSerialized;
  94
  95 } ASL_METHOD_INFO;
  96
  97
  98 /* Parse tree walk info for control method analysis */
  99
 100 typedef struct asl_analysis_walk_info
 101 {
 102     ASL_METHOD_INFO         *MethodStack;
 103
 104 } ASL_ANALYSIS_WALK_INFO;
 105
 106
 107 /* An entry in the ParseOpcode to AmlOpcode mapping table */
 108
 109 typedef struct asl_mapping_entry
 110 {
 111     UINT32                      Value;
 112     UINT32                      AcpiBtype;   /* Object type or return type */
 113     UINT16                      AmlOpcode;
 114     UINT8                       Flags;
 115
 116 } ASL_MAPPING_ENTRY;
 117
 118
 119 /* Parse tree walk info structure */
 120
 121 typedef struct asl_walk_info
 122 {
 123     ACPI_PARSE_OBJECT           **NodePtr;
 124     UINT32                      *LevelPtr;
 125
 126 } ASL_WALK_INFO;
 127
 128
 129 /* File info */
 130
 131 typedef struct asl_file_info
 132 {
 133     FILE                        *Handle;
 134     char                        *Filename;
 135     const char                  *ShortDescription;
 136     const char                  *Description;
 137
 138 } ASL_FILE_INFO;
 139
 140 typedef struct asl_file_status
 141 {
 142     UINT32                  Line;
 143     UINT32                  Offset;
 144
 145 } ASL_FILE_STATUS;
 146
 147
 148 /*
 149  * File types. Note: Any changes to this table must also be reflected
 150  * in the Gbl_Files array.
 151  *
 152  * Corresponding filename suffixes are in comments
 153  *
 154  * NOTE: Don't move the first 4 file types
 155  */
 156 typedef enum
 157 {
 158     ASL_FILE_STDOUT             = 0,
 159     ASL_FILE_STDERR,
 160     ASL_FILE_INPUT,             /* .asl */
 161     ASL_FILE_AML_OUTPUT,        /* .aml */
 162     ASL_FILE_SOURCE_OUTPUT,     /* .src */
 163     ASL_FILE_PREPROCESSOR,      /* .pre */
 164     ASL_FILE_PREPROCESSOR_USER, /* .i   */
 165     ASL_FILE_LISTING_OUTPUT,    /* .lst */
 166     ASL_FILE_HEX_OUTPUT,        /* .hex */
 167     ASL_FILE_NAMESPACE_OUTPUT,  /* .nsp */
 168     ASL_FILE_DEBUG_OUTPUT,      /* .txt */
 169     ASL_FILE_ASM_SOURCE_OUTPUT, /* .asm */
 170     ASL_FILE_C_SOURCE_OUTPUT,   /* .c   */
 171     ASL_FILE_ASM_INCLUDE_OUTPUT,/* .inc */
 172     ASL_FILE_C_INCLUDE_OUTPUT,  /* .h   */
 173     ASL_FILE_C_OFFSET_OUTPUT,   /* .offset.h */
 174     ASL_FILE_MAP_OUTPUT         /* .map */
 175
 176 } ASL_FILE_TYPES;
 177
 178
 179 #define ASL_MAX_FILE_TYPE       16
 180 #define ASL_NUM_FILES           (ASL_MAX_FILE_TYPE + 1)
 181
 182 /* Name suffixes used to create filenames for output files */
 183
 184 #define FILE_SUFFIX_ASL_CODE        "asl"
 185 #define FILE_SUFFIX_AML_CODE        "aml"
 186 #define FILE_SUFFIX_SOURCE          "src"
 187 #define FILE_SUFFIX_PREPROCESSOR    "pre"
 188 #define FILE_SUFFIX_PREPROC_USER    "i"
 189 #define FILE_SUFFIX_LISTING         "lst"
 190 #define FILE_SUFFIX_HEX_DUMP        "hex"
 191 #define FILE_SUFFIX_NAMESPACE       "nsp"
 192 #define FILE_SUFFIX_DEBUG           "txt"
 193 #define FILE_SUFFIX_ASM_SOURCE      "asm"
 194 #define FILE_SUFFIX_C_SOURCE        "c"
 195 #define FILE_SUFFIX_ASM_INCLUDE     "inc"
 196 #define FILE_SUFFIX_C_INCLUDE       "h"
 197 #define FILE_SUFFIX_C_OFFSET        "offset.h"
 198 #define FILE_SUFFIX_MAP             "map"
 199
 200
 201 /* Cache block structure for ParseOps and Strings */
 202
 203 typedef struct asl_cache_info
 204 {
 205     void                            *Next;
 206     char                            Buffer[1];
 207
 208 } ASL_CACHE_INFO;
 209
 210
 211 typedef struct asl_include_dir
 212 {
 213     char                        *Dir;
 214     struct asl_include_dir      *Next;
 215
 216 } ASL_INCLUDE_DIR;
 217
 218
 219 /* An entry in the exception list, one for each error/warning */
 220
 221 typedef struct asl_error_msg
 222 {
 223     UINT32                      LineNumber;
 224     UINT32                      LogicalLineNumber;
 225     UINT32                      LogicalByteOffset;
 226     UINT32                      Column;
 227     char                        *Message;
 228     struct asl_error_msg        *Next;
 229     char                        *Filename;
 230     char                        *SourceLine;
 231     UINT32                      FilenameLength;
 232     UINT16                      MessageId;
 233     UINT8                       Level;
 234
 235 } ASL_ERROR_MSG;
 236
 237
 238 /* An entry in the listing file stack (for include files) */
 239
 240 typedef struct asl_listing_node
 241 {
 242     char                        *Filename;
 243     UINT32                      LineNumber;
 244     struct asl_listing_node     *Next;
 245
 246 } ASL_LISTING_NODE;
 247
 248
 249 /* Callback interface for a parse tree walk */
 250
 251 /*
 252  * TBD - another copy of this is in adisasm.h, fix
 253  */
 254 #ifndef ASL_WALK_CALLBACK_DEFINED
 255 typedef
 256 ACPI_STATUS (*ASL_WALK_CALLBACK) (
 257     ACPI_PARSE_OBJECT           *Op,
 258     UINT32                      Level,
 259     void                        *Context);
 260 #define ASL_WALK_CALLBACK_DEFINED
 261 #endif
 262
 263
 264 typedef struct asl_event_info
 265 {
 266     UINT64                      StartTime;
 267     UINT64                      EndTime;
 268     char                        *EventName;
 269     BOOLEAN                     Valid;
 270
 271 } ASL_EVENT_INFO;
 272
 273
 274 /* Hardware mapping file structures */
 275
 276 typedef struct acpi_gpio_info
 277 {
 278     struct acpi_gpio_info   *Next;
 279     ACPI_PARSE_OBJECT       *Op;
 280     char                    *DeviceName;
 281     ACPI_NAMESPACE_NODE     *TargetNode;
 282     UINT32                  References;
 283     UINT32                  PinCount;
 284     UINT32                  PinIndex;
 285     UINT16                  PinNumber;
 286     UINT8                   Type;
 287     UINT8                   Direction;
 288     UINT8                   Polarity;
 289
 290 } ACPI_GPIO_INFO;
 291
 292 typedef struct acpi_serial_info
 293 {
 294     struct acpi_serial_info *Next;
 295     ACPI_PARSE_OBJECT       *Op;
 296     char                    *DeviceName;
 297     ACPI_NAMESPACE_NODE     *TargetNode;
 298     AML_RESOURCE            *Resource;
 299     UINT32                  Speed;
 300     UINT16                  Address;
 301
 302 } ACPI_SERIAL_INFO;
 303
 304 typedef struct asl_method_local
 305 {
 306     ACPI_PARSE_OBJECT       *Op;
 307     UINT8                   Flags;
 308
 309 } ASL_METHOD_LOCAL;
 310
 311 /* Values for Flags field above */
 312
 313 #define ASL_LOCAL_INITIALIZED   (1)
 314 #define ASL_LOCAL_REFERENCED    (1<<1)
 315 #define ASL_ARG_IS_LOCAL        (1<<2)
 316 #define ASL_ARG_INITIALIZED     (1<<3)
 317 #define ASL_ARG_REFERENCED      (1<<4)
 318
 319 #endif  /* __ASLTYPES_H */