1 /****************************************************************************** 2 * 3 * Module Name: asltypes.h - compiler data types and struct definitions 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2016, 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 */ 320