Home | History | Annotate | Line # | Download | only in compiler
aslhex.c revision 1.1.1.7
      1 /******************************************************************************
      2  *
      3  * Module Name: aslhex - ASCII hex output file generation (C, ASM, and ASL)
      4  *
      5  *****************************************************************************/
      6 
      7 /*
      8  * Copyright (C) 2000 - 2018, 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 #include "aslcompiler.h"
     45 #include "acapps.h"
     46 
     47 #define _COMPONENT          ACPI_COMPILER
     48         ACPI_MODULE_NAME    ("ashex")
     49 
     50 /*
     51  * This module emits ASCII hex output files in either C, ASM, or ASL format
     52  */
     53 
     54 /* Local prototypes */
     55 
     56 static void
     57 HxDoHexOutputC (
     58     void);
     59 
     60 static void
     61 HxDoHexOutputAsl (
     62     void);
     63 
     64 static void
     65 HxDoHexOutputAsm (
     66     void);
     67 
     68 static UINT32
     69 HxReadAmlOutputFile (
     70     UINT8                   *Buffer);
     71 
     72 
     73 /*******************************************************************************
     74  *
     75  * FUNCTION:    HxDoHexOutput
     76  *
     77  * PARAMETERS:  None
     78  *
     79  * RETURN:      None
     80  *
     81  * DESCRIPTION: Create the hex output file. Note: data is obtained by reading
     82  *              the entire AML output file that was previously generated.
     83  *
     84  ******************************************************************************/
     85 
     86 void
     87 HxDoHexOutput (
     88     void)
     89 {
     90 
     91     switch (Gbl_HexOutputFlag)
     92     {
     93     case HEX_OUTPUT_C:
     94 
     95         HxDoHexOutputC ();
     96         break;
     97 
     98     case HEX_OUTPUT_ASM:
     99 
    100         HxDoHexOutputAsm ();
    101         break;
    102 
    103     case HEX_OUTPUT_ASL:
    104 
    105         HxDoHexOutputAsl ();
    106         break;
    107 
    108     default:
    109 
    110         /* No other output types supported */
    111 
    112         break;
    113     }
    114 }
    115 
    116 
    117 /*******************************************************************************
    118  *
    119  * FUNCTION:    HxReadAmlOutputFile
    120  *
    121  * PARAMETERS:  Buffer              - Where to return data
    122  *
    123  * RETURN:      None
    124  *
    125  * DESCRIPTION: Read a line of the AML output prior to formatting the data
    126  *
    127  ******************************************************************************/
    128 
    129 static UINT32
    130 HxReadAmlOutputFile (
    131     UINT8                   *Buffer)
    132 {
    133     UINT32                  Actual;
    134 
    135 
    136     Actual = fread (Buffer, 1, HEX_TABLE_LINE_SIZE,
    137         Gbl_Files[ASL_FILE_AML_OUTPUT].Handle);
    138 
    139     if (ferror (Gbl_Files[ASL_FILE_AML_OUTPUT].Handle))
    140     {
    141         FlFileError (ASL_FILE_AML_OUTPUT, ASL_MSG_READ);
    142         AslAbort ();
    143     }
    144 
    145     return (Actual);
    146 }
    147 
    148 
    149 /*******************************************************************************
    150  *
    151  * FUNCTION:    HxDoHexOutputC
    152  *
    153  * PARAMETERS:  None
    154  *
    155  * RETURN:      None
    156  *
    157  * DESCRIPTION: Create the hex output file. This is the same data as the AML
    158  *              output file, but formatted into hex/ascii bytes suitable for
    159  *              inclusion into a C source file.
    160  *
    161  *              Note: the base name of the hex output file is prepended to
    162  *              all symbols as they are output to the file.
    163  *
    164  ******************************************************************************/
    165 
    166 static void
    167 HxDoHexOutputC (
    168     void)
    169 {
    170     UINT8                   FileData[HEX_TABLE_LINE_SIZE];
    171     UINT32                  LineLength;
    172     UINT32                  Offset = 0;
    173     UINT32                  AmlFileSize;
    174     UINT32                  i;
    175     char                    *FileBasename;
    176 
    177 
    178     /* Obtain the file basename (filename with no extension) */
    179 
    180     FileBasename = FlGetFileBasename (Gbl_Files [ASL_FILE_HEX_OUTPUT].Filename);
    181 
    182     /* Get AML size, seek back to start */
    183 
    184     AmlFileSize = FlGetFileSize (ASL_FILE_AML_OUTPUT);
    185     FlSeekFile (ASL_FILE_AML_OUTPUT, 0);
    186 
    187     /* Finish the file header and emit the non-data symbols */
    188 
    189     FlPrintFile (ASL_FILE_HEX_OUTPUT, " * C source code output\n");
    190     FlPrintFile (ASL_FILE_HEX_OUTPUT, " * AML code block contains 0x%X bytes\n *\n */\n",
    191         AmlFileSize);
    192 
    193     FlPrintFile (ASL_FILE_HEX_OUTPUT, "#ifndef __%s_HEX__\n", FileBasename);
    194     FlPrintFile (ASL_FILE_HEX_OUTPUT, "#define __%s_HEX__\n\n", FileBasename);
    195 
    196     AcpiUtStrlwr (FileBasename);
    197     FlPrintFile (ASL_FILE_HEX_OUTPUT, "unsigned char %s_aml_code[] =\n{\n", FileBasename);
    198 
    199     while (Offset < AmlFileSize)
    200     {
    201         /* Read enough bytes needed for one output line */
    202 
    203         LineLength = HxReadAmlOutputFile (FileData);
    204         if (!LineLength)
    205         {
    206             break;
    207         }
    208 
    209         FlPrintFile (ASL_FILE_HEX_OUTPUT, "    ");
    210 
    211         for (i = 0; i < LineLength; i++)
    212         {
    213             /*
    214              * Output each hex byte in the form: "0xnn,"
    215              * Add a comma until the very last byte of the AML file
    216              * (Some C compilers complain about a trailing comma)
    217              */
    218             FlPrintFile (ASL_FILE_HEX_OUTPUT, "0x%2.2X", FileData[i]);
    219             if ((Offset + i + 1) < AmlFileSize)
    220             {
    221                 FlPrintFile (ASL_FILE_HEX_OUTPUT, ",");
    222             }
    223             else
    224             {
    225                 FlPrintFile (ASL_FILE_HEX_OUTPUT, " ");
    226             }
    227         }
    228 
    229         /* Add fill spaces if needed for last line */
    230 
    231         if (LineLength < HEX_TABLE_LINE_SIZE)
    232         {
    233             FlPrintFile (ASL_FILE_HEX_OUTPUT, "%*s",
    234                 5 * (HEX_TABLE_LINE_SIZE - LineLength), " ");
    235         }
    236 
    237         /* Emit the offset and ascii dump for the entire line */
    238 
    239         FlPrintFile (ASL_FILE_HEX_OUTPUT, "  /* %8.8X", Offset);
    240         LsDumpAsciiInComment (ASL_FILE_HEX_OUTPUT, LineLength, FileData);
    241 
    242         FlPrintFile (ASL_FILE_HEX_OUTPUT, "%*s*/\n",
    243             HEX_TABLE_LINE_SIZE - LineLength + 1, " ");
    244 
    245         Offset += LineLength;
    246     }
    247 
    248     FlPrintFile (ASL_FILE_HEX_OUTPUT, "};\n\n");
    249     FlPrintFile (ASL_FILE_HEX_OUTPUT, "#endif\n");
    250 }
    251 
    252 
    253 /*******************************************************************************
    254  *
    255  * FUNCTION:    HxDoHexOutputAsl
    256  *
    257  * PARAMETERS:  None
    258  *
    259  * RETURN:      None
    260  *
    261  * DESCRIPTION: Create the hex output file. This is the same data as the AML
    262  *              output file, but formatted into hex/ascii bytes suitable for
    263  *              inclusion into a C source file.
    264  *
    265  ******************************************************************************/
    266 
    267 static void
    268 HxDoHexOutputAsl (
    269     void)
    270 {
    271     UINT8                   FileData[HEX_TABLE_LINE_SIZE];
    272     UINT32                  LineLength;
    273     UINT32                  Offset = 0;
    274     UINT32                  AmlFileSize;
    275     UINT32                  i;
    276 
    277 
    278     /* Get AML size, seek back to start */
    279 
    280     AmlFileSize = FlGetFileSize (ASL_FILE_AML_OUTPUT);
    281     FlSeekFile (ASL_FILE_AML_OUTPUT, 0);
    282 
    283     FlPrintFile (ASL_FILE_HEX_OUTPUT, " * ASL source code output\n");
    284     FlPrintFile (ASL_FILE_HEX_OUTPUT, " * AML code block contains 0x%X bytes\n *\n */\n",
    285         AmlFileSize);
    286     FlPrintFile (ASL_FILE_HEX_OUTPUT, "    Name (BUF1, Buffer()\n    {\n");
    287 
    288     while (Offset < AmlFileSize)
    289     {
    290         /* Read enough bytes needed for one output line */
    291 
    292         LineLength = HxReadAmlOutputFile (FileData);
    293         if (!LineLength)
    294         {
    295             break;
    296         }
    297 
    298         FlPrintFile (ASL_FILE_HEX_OUTPUT, "        ");
    299 
    300         for (i = 0; i < LineLength; i++)
    301         {
    302             /*
    303              * Print each hex byte.
    304              * Add a comma until the very last byte of the AML file
    305              * (Some C compilers complain about a trailing comma)
    306              */
    307             FlPrintFile (ASL_FILE_HEX_OUTPUT, "0x%2.2X", FileData[i]);
    308             if ((Offset + i + 1) < AmlFileSize)
    309             {
    310                 FlPrintFile (ASL_FILE_HEX_OUTPUT, ",");
    311             }
    312             else
    313             {
    314                 FlPrintFile (ASL_FILE_HEX_OUTPUT, " ");
    315             }
    316         }
    317 
    318         /* Add fill spaces if needed for last line */
    319 
    320         if (LineLength < HEX_TABLE_LINE_SIZE)
    321         {
    322             FlPrintFile (ASL_FILE_HEX_OUTPUT, "%*s",
    323                 5 * (HEX_TABLE_LINE_SIZE - LineLength), " ");
    324         }
    325 
    326         /* Emit the offset and ascii dump for the entire line */
    327 
    328         FlPrintFile (ASL_FILE_HEX_OUTPUT, "  /* %8.8X", Offset);
    329         LsDumpAsciiInComment (ASL_FILE_HEX_OUTPUT, LineLength, FileData);
    330 
    331         FlPrintFile (ASL_FILE_HEX_OUTPUT, "%*s*/\n",
    332             HEX_TABLE_LINE_SIZE - LineLength + 1, " ");
    333 
    334         Offset += LineLength;
    335     }
    336 
    337     FlPrintFile (ASL_FILE_HEX_OUTPUT, "    })\n");
    338 }
    339 
    340 
    341 /*******************************************************************************
    342  *
    343  * FUNCTION:    HxDoHexOutputAsm
    344  *
    345  * PARAMETERS:  None
    346  *
    347  * RETURN:      None
    348  *
    349  * DESCRIPTION: Create the hex output file. This is the same data as the AML
    350  *              output file, but formatted into hex/ascii bytes suitable for
    351  *              inclusion into a ASM source file.
    352  *
    353  ******************************************************************************/
    354 
    355 static void
    356 HxDoHexOutputAsm (
    357     void)
    358 {
    359     UINT8                   FileData[HEX_TABLE_LINE_SIZE];
    360     UINT32                  LineLength;
    361     UINT32                  Offset = 0;
    362     UINT32                  AmlFileSize;
    363     UINT32                  i;
    364 
    365 
    366     /* Get AML size, seek back to start */
    367 
    368     AmlFileSize = FlGetFileSize (ASL_FILE_AML_OUTPUT);
    369     FlSeekFile (ASL_FILE_AML_OUTPUT, 0);
    370 
    371     FlPrintFile (ASL_FILE_HEX_OUTPUT, "; Assembly code source output\n");
    372     FlPrintFile (ASL_FILE_HEX_OUTPUT, "; AML code block contains 0x%X bytes\n;\n",
    373         AmlFileSize);
    374 
    375     while (Offset < AmlFileSize)
    376     {
    377         /* Read enough bytes needed for one output line */
    378 
    379         LineLength = HxReadAmlOutputFile (FileData);
    380         if (!LineLength)
    381         {
    382             break;
    383         }
    384 
    385         FlPrintFile (ASL_FILE_HEX_OUTPUT, "  db  ");
    386 
    387         for (i = 0; i < LineLength; i++)
    388         {
    389             /*
    390              * Print each hex byte.
    391              * Add a comma until the last byte of the line
    392              */
    393             FlPrintFile (ASL_FILE_HEX_OUTPUT, "0%2.2Xh", FileData[i]);
    394             if ((i + 1) < LineLength)
    395             {
    396                 FlPrintFile (ASL_FILE_HEX_OUTPUT, ",");
    397             }
    398         }
    399 
    400         FlPrintFile (ASL_FILE_HEX_OUTPUT, " ");
    401 
    402         /* Add fill spaces if needed for last line */
    403 
    404         if (LineLength < HEX_TABLE_LINE_SIZE)
    405         {
    406             FlPrintFile (ASL_FILE_HEX_OUTPUT, "%*s",
    407                 5 * (HEX_TABLE_LINE_SIZE - LineLength), " ");
    408         }
    409 
    410         /* Emit the offset and ascii dump for the entire line */
    411 
    412         FlPrintFile (ASL_FILE_HEX_OUTPUT, "  ; %8.8X", Offset);
    413         LsDumpAsciiInComment (ASL_FILE_HEX_OUTPUT, LineLength, FileData);
    414 
    415         FlPrintFile (ASL_FILE_HEX_OUTPUT, "\n");
    416 
    417         Offset += LineLength;
    418     }
    419 
    420     FlPrintFile (ASL_FILE_HEX_OUTPUT, "\n");
    421 }
    422