1 /******************************************************************************
3 * Module Name: aslcodegen - AML code generation
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2014, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
44 #include "aslcompiler.h"
45 #include "aslcompiler.y.h"
48 #define _COMPONENT ACPI_COMPILER
49 ACPI_MODULE_NAME ("aslcodegen")
51 /* Local prototypes */
55 ACPI_PARSE_OBJECT *Op,
61 ACPI_PARSE_OBJECT *Op,
67 ACPI_PARSE_OBJECT *Op);
71 ACPI_PARSE_OBJECT *Op);
79 ACPI_PARSE_OBJECT *Op);
82 /*******************************************************************************
84 * FUNCTION: CgGenerateAmlOutput
90 * DESCRIPTION: Generate AML code. Currently generates the listing file
93 ******************************************************************************/
100 DbgPrint (ASL_DEBUG_OUTPUT, "\nWriting AML\n\n");
102 /* Generate the AML output file */
104 FlSeekFile (ASL_FILE_SOURCE_OUTPUT, 0);
106 Gbl_NextError = Gbl_ErrorLog;
108 TrWalkParseTree (RootNode, ASL_WALK_VISIT_DOWNWARD,
109 CgAmlWriteWalk, NULL, NULL);
111 DbgPrint (ASL_TREE_OUTPUT,
112 "%*s Value P_Op A_Op OpLen PByts Len SubLen PSubLen OpPtr"
113 " Parent Child Next Flags AcTyp Final Col L\n",
120 /*******************************************************************************
122 * FUNCTION: CgAmlWriteWalk
124 * PARAMETERS: ASL_WALK_CALLBACK
128 * DESCRIPTION: Parse tree walk to generate the AML code.
130 ******************************************************************************/
134 ACPI_PARSE_OBJECT *Op,
140 * Print header at level 0. Alignment assumes 32-bit pointers
144 DbgPrint (ASL_TREE_OUTPUT,
145 "Final parse tree used for AML output:\n");
146 DbgPrint (ASL_TREE_OUTPUT,
147 "%*s Value P_Op A_Op OpLen PByts Len SubLen PSubLen OpPtr"
148 " Parent Child Next Flags AcTyp Final Col L\n",
154 DbgPrint (ASL_TREE_OUTPUT,
155 "%5.5d [%2d]", Op->Asl.LogicalLineNumber, Level);
156 UtPrintFormattedName (Op->Asl.ParseOpcode, Level);
158 if (Op->Asl.ParseOpcode == PARSEOP_NAMESEG ||
159 Op->Asl.ParseOpcode == PARSEOP_NAMESTRING ||
160 Op->Asl.ParseOpcode == PARSEOP_METHODCALL)
162 DbgPrint (ASL_TREE_OUTPUT,
163 "%10.32s ", Op->Asl.ExternalName);
167 DbgPrint (ASL_TREE_OUTPUT, " ");
170 DbgPrint (ASL_TREE_OUTPUT,
171 "%08X %04X %04X %01X %04X %04X %04X %04X "
172 "%08X %08X %08X %08X %08X %08X %04X %02d %02d\n",
173 /* 1 */ (UINT32) Op->Asl.Value.Integer,
174 /* 2 */ Op->Asl.ParseOpcode,
175 /* 3 */ Op->Asl.AmlOpcode,
176 /* 4 */ Op->Asl.AmlOpcodeLength,
177 /* 5 */ Op->Asl.AmlPkgLenBytes,
178 /* 6 */ Op->Asl.AmlLength,
179 /* 7 */ Op->Asl.AmlSubtreeLength,
180 /* 8 */ Op->Asl.Parent ? Op->Asl.Parent->Asl.AmlSubtreeLength : 0,
182 /* 10 */ Op->Asl.Parent,
183 /* 11 */ Op->Asl.Child,
184 /* 12 */ Op->Asl.Next,
185 /* 13 */ Op->Asl.CompileFlags,
186 /* 14 */ Op->Asl.AcpiBtype,
187 /* 15 */ Op->Asl.FinalAmlLength,
188 /* 16 */ Op->Asl.Column,
189 /* 17 */ Op->Asl.LineNumber);
191 /* Generate the AML for this node */
198 /*******************************************************************************
200 * FUNCTION: CgLocalWriteAmlData
202 * PARAMETERS: Op - Current parse op
203 * Buffer - Buffer to write
204 * Length - Size of data in buffer
208 * DESCRIPTION: Write a buffer of AML data to the AML output file.
210 ******************************************************************************/
213 CgLocalWriteAmlData (
214 ACPI_PARSE_OBJECT *Op,
219 /* Write the raw data to the AML file */
221 FlWriteFile (ASL_FILE_AML_OUTPUT, Buffer, Length);
223 /* Update the final AML length for this node (used for listings) */
227 Op->Asl.FinalAmlLength += Length;
232 /*******************************************************************************
234 * FUNCTION: CgWriteAmlOpcode
236 * PARAMETERS: Op - Parse node with an AML opcode
240 * DESCRIPTION: Write the AML opcode corresponding to a parse node.
242 ******************************************************************************/
246 ACPI_PARSE_OBJECT *Op)
248 UINT8 PkgLenFirstByte;
252 UINT8 OpcodeBytes[2];
260 /* We expect some DEFAULT_ARGs, just ignore them */
262 if (Op->Asl.ParseOpcode == PARSEOP_DEFAULT_ARG)
267 switch (Op->Asl.AmlOpcode)
269 case AML_UNASSIGNED_OPCODE:
271 /* These opcodes should not get here */
273 printf ("Found a node with an unassigned AML opcode\n");
274 FlPrintFile (ASL_FILE_STDERR, "Found a node with an unassigned AML opcode\n");
277 case AML_INT_RESERVEDFIELD_OP:
279 /* Special opcodes for within a field definition */
281 Aml.Opcode = AML_FIELD_OFFSET_OP;
284 case AML_INT_ACCESSFIELD_OP:
286 Aml.Opcode = AML_FIELD_ACCESS_OP;
289 case AML_INT_CONNECTION_OP:
291 Aml.Opcode = AML_FIELD_CONNECTION_OP;
296 Aml.Opcode = Op->Asl.AmlOpcode;
303 case AML_PACKAGE_LENGTH:
305 /* Value is the length to be encoded (Used in field definitions) */
307 PkgLen.Len = (UINT32) Op->Asl.Value.Integer;
312 /* Check for two-byte opcode */
314 if (Aml.Opcode > 0x00FF)
316 /* Write the high byte first */
318 CgLocalWriteAmlData (Op, &Aml.OpcodeBytes[1], 1);
321 CgLocalWriteAmlData (Op, &Aml.OpcodeBytes[0], 1);
323 /* Subtreelength doesn't include length of package length bytes */
325 PkgLen.Len = Op->Asl.AmlSubtreeLength + Op->Asl.AmlPkgLenBytes;
329 /* Does this opcode have an associated "PackageLength" field? */
331 if (Op->Asl.CompileFlags & NODE_AML_PACKAGE)
333 if (Op->Asl.AmlPkgLenBytes == 1)
335 /* Simplest case -- no bytes to follow, just write the count */
337 CgLocalWriteAmlData (Op, &PkgLen.LenBytes[0], 1);
339 else if (Op->Asl.AmlPkgLenBytes != 0)
342 * Encode the "bytes to follow" in the first byte, top two bits.
343 * The low-order nybble of the length is in the bottom 4 bits
345 PkgLenFirstByte = (UINT8)
346 (((UINT32) (Op->Asl.AmlPkgLenBytes - 1) << 6) |
347 (PkgLen.LenBytes[0] & 0x0F));
349 CgLocalWriteAmlData (Op, &PkgLenFirstByte, 1);
352 * Shift the length over by the 4 bits we just stuffed
357 /* Now we can write the remaining bytes - either 1, 2, or 3 bytes */
359 for (i = 0; i < (UINT32) (Op->Asl.AmlPkgLenBytes - 1); i++)
361 CgLocalWriteAmlData (Op, &PkgLen.LenBytes[i], 1);
370 CgLocalWriteAmlData (Op, &Op->Asl.Value.Integer, 1);
375 CgLocalWriteAmlData (Op, &Op->Asl.Value.Integer, 2);
380 CgLocalWriteAmlData (Op, &Op->Asl.Value.Integer, 4);
385 CgLocalWriteAmlData (Op, &Op->Asl.Value.Integer, 8);
390 CgLocalWriteAmlData (Op, Op->Asl.Value.String, Op->Asl.AmlLength);
395 /* All data opcodes must appear above */
402 /*******************************************************************************
404 * FUNCTION: CgWriteTableHeader
406 * PARAMETERS: Op - The DEFINITIONBLOCK node
410 * DESCRIPTION: Write a table header corresponding to the DEFINITIONBLOCK
412 ******************************************************************************/
416 ACPI_PARSE_OBJECT *Op)
418 ACPI_PARSE_OBJECT *Child;
423 Child = Op->Asl.Child;
427 Child = Child->Asl.Next;
428 strncpy (TableHeader.Signature, Child->Asl.Value.String, 4);
432 Child = Child->Asl.Next;
433 TableHeader.Revision = (UINT8) Child->Asl.Value.Integer;
435 /* Command-line Revision override */
437 if (Gbl_RevisionOverride)
439 TableHeader.Revision = Gbl_RevisionOverride;
444 Child = Child->Asl.Next;
445 strncpy (TableHeader.OemId, Child->Asl.Value.String, 6);
449 Child = Child->Asl.Next;
450 strncpy (TableHeader.OemTableId, Child->Asl.Value.String, 8);
454 Child = Child->Asl.Next;
455 TableHeader.OemRevision = (UINT32) Child->Asl.Value.Integer;
459 ACPI_MOVE_NAME (TableHeader.AslCompilerId, ASL_CREATOR_ID);
461 /* Compiler version */
463 TableHeader.AslCompilerRevision = ASL_REVISION;
465 /* Table length. Checksum zero for now, will rewrite later */
467 TableHeader.Length = Gbl_TableLength;
468 TableHeader.Checksum = 0;
470 CgLocalWriteAmlData (Op, &TableHeader, sizeof (ACPI_TABLE_HEADER));
474 /*******************************************************************************
476 * FUNCTION: CgCloseTable
482 * DESCRIPTION: Complete the ACPI table by calculating the checksum and
483 * re-writing the header.
485 ******************************************************************************/
495 FlSeekFile (ASL_FILE_AML_OUTPUT, 0);
498 /* Calculate the checksum over the entire file */
500 while (FlReadFile (ASL_FILE_AML_OUTPUT, &FileByte, 1) == AE_OK)
502 Sum = (signed char) (Sum + FileByte);
505 /* Re-write the table header with the checksum */
507 TableHeader.Checksum = (UINT8) (0 - Sum);
509 FlSeekFile (ASL_FILE_AML_OUTPUT, 0);
510 CgLocalWriteAmlData (NULL, &TableHeader, sizeof (ACPI_TABLE_HEADER));
514 /*******************************************************************************
516 * FUNCTION: CgWriteNode
518 * PARAMETERS: Op - Parse node to write.
522 * DESCRIPTION: Write the AML that corresponds to a parse node.
524 ******************************************************************************/
528 ACPI_PARSE_OBJECT *Op)
530 ASL_RESOURCE_NODE *Rnode;
533 /* Always check for DEFAULT_ARG and other "Noop" nodes */
534 /* TBD: this may not be the best place for this check */
536 if ((Op->Asl.ParseOpcode == PARSEOP_DEFAULT_ARG) ||
537 (Op->Asl.ParseOpcode == PARSEOP_EXTERNAL) ||
538 (Op->Asl.ParseOpcode == PARSEOP_INCLUDE) ||
539 (Op->Asl.ParseOpcode == PARSEOP_INCLUDE_END))
544 Op->Asl.FinalAmlLength = 0;
546 switch (Op->Asl.AmlOpcode)
548 case AML_RAW_DATA_BYTE:
549 case AML_RAW_DATA_WORD:
550 case AML_RAW_DATA_DWORD:
551 case AML_RAW_DATA_QWORD:
553 CgLocalWriteAmlData (Op, &Op->Asl.Value.Integer, Op->Asl.AmlLength);
557 case AML_RAW_DATA_BUFFER:
559 CgLocalWriteAmlData (Op, Op->Asl.Value.Buffer, Op->Asl.AmlLength);
563 case AML_RAW_DATA_CHAIN:
565 Rnode = ACPI_CAST_PTR (ASL_RESOURCE_NODE, Op->Asl.Value.Buffer);
568 CgLocalWriteAmlData (Op, Rnode->Buffer, Rnode->BufferLength);
575 /* Internal data opcodes must all appear above */
580 switch (Op->Asl.ParseOpcode)
582 case PARSEOP_DEFAULT_ARG:
586 case PARSEOP_DEFINITIONBLOCK:
588 CgWriteTableHeader (Op);
591 case PARSEOP_NAMESEG:
592 case PARSEOP_NAMESTRING:
593 case PARSEOP_METHODCALL:
595 CgLocalWriteAmlData (Op, Op->Asl.Value.String, Op->Asl.AmlLength);
600 CgWriteAmlOpcode (Op);