Home | History | Annotate | Line # | Download | only in debugger
      1       1.1  christos /*******************************************************************************
      2       1.1  christos  *
      3       1.1  christos  * Module Name: dbconvert - debugger miscellaneous conversion routines
      4       1.1  christos  *
      5       1.1  christos  ******************************************************************************/
      6       1.1  christos 
      7  1.1.1.18  christos /******************************************************************************
      8  1.1.1.18  christos  *
      9  1.1.1.18  christos  * 1. Copyright Notice
     10  1.1.1.18  christos  *
     11  1.1.1.19  christos  * Some or all of this work - Copyright (c) 1999 - 2025, Intel Corp.
     12       1.1  christos  * All rights reserved.
     13       1.1  christos  *
     14  1.1.1.18  christos  * 2. License
     15  1.1.1.18  christos  *
     16  1.1.1.18  christos  * 2.1. This is your license from Intel Corp. under its intellectual property
     17  1.1.1.18  christos  * rights. You may have additional license terms from the party that provided
     18  1.1.1.18  christos  * you this software, covering your right to use that party's intellectual
     19  1.1.1.18  christos  * property rights.
     20  1.1.1.18  christos  *
     21  1.1.1.18  christos  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
     22  1.1.1.18  christos  * copy of the source code appearing in this file ("Covered Code") an
     23  1.1.1.18  christos  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
     24  1.1.1.18  christos  * base code distributed originally by Intel ("Original Intel Code") to copy,
     25  1.1.1.18  christos  * make derivatives, distribute, use and display any portion of the Covered
     26  1.1.1.18  christos  * Code in any form, with the right to sublicense such rights; and
     27  1.1.1.18  christos  *
     28  1.1.1.18  christos  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
     29  1.1.1.18  christos  * license (with the right to sublicense), under only those claims of Intel
     30  1.1.1.18  christos  * patents that are infringed by the Original Intel Code, to make, use, sell,
     31  1.1.1.18  christos  * offer to sell, and import the Covered Code and derivative works thereof
     32  1.1.1.18  christos  * solely to the minimum extent necessary to exercise the above copyright
     33  1.1.1.18  christos  * license, and in no event shall the patent license extend to any additions
     34  1.1.1.18  christos  * to or modifications of the Original Intel Code. No other license or right
     35  1.1.1.18  christos  * is granted directly or by implication, estoppel or otherwise;
     36  1.1.1.18  christos  *
     37  1.1.1.18  christos  * The above copyright and patent license is granted only if the following
     38  1.1.1.18  christos  * conditions are met:
     39  1.1.1.18  christos  *
     40  1.1.1.18  christos  * 3. Conditions
     41  1.1.1.18  christos  *
     42  1.1.1.18  christos  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
     43  1.1.1.18  christos  * Redistribution of source code of any substantial portion of the Covered
     44  1.1.1.18  christos  * Code or modification with rights to further distribute source must include
     45  1.1.1.18  christos  * the above Copyright Notice, the above License, this list of Conditions,
     46  1.1.1.18  christos  * and the following Disclaimer and Export Compliance provision. In addition,
     47  1.1.1.18  christos  * Licensee must cause all Covered Code to which Licensee contributes to
     48  1.1.1.18  christos  * contain a file documenting the changes Licensee made to create that Covered
     49  1.1.1.18  christos  * Code and the date of any change. Licensee must include in that file the
     50  1.1.1.18  christos  * documentation of any changes made by any predecessor Licensee. Licensee
     51  1.1.1.18  christos  * must include a prominent statement that the modification is derived,
     52  1.1.1.18  christos  * directly or indirectly, from Original Intel Code.
     53  1.1.1.18  christos  *
     54  1.1.1.18  christos  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
     55  1.1.1.18  christos  * Redistribution of source code of any substantial portion of the Covered
     56  1.1.1.18  christos  * Code or modification without rights to further distribute source must
     57  1.1.1.18  christos  * include the following Disclaimer and Export Compliance provision in the
     58  1.1.1.18  christos  * documentation and/or other materials provided with distribution. In
     59  1.1.1.18  christos  * addition, Licensee may not authorize further sublicense of source of any
     60  1.1.1.18  christos  * portion of the Covered Code, and must include terms to the effect that the
     61  1.1.1.18  christos  * license from Licensee to its licensee is limited to the intellectual
     62  1.1.1.18  christos  * property embodied in the software Licensee provides to its licensee, and
     63  1.1.1.18  christos  * not to intellectual property embodied in modifications its licensee may
     64  1.1.1.18  christos  * make.
     65  1.1.1.18  christos  *
     66  1.1.1.18  christos  * 3.3. Redistribution of Executable. Redistribution in executable form of any
     67  1.1.1.18  christos  * substantial portion of the Covered Code or modification must reproduce the
     68  1.1.1.18  christos  * above Copyright Notice, and the following Disclaimer and Export Compliance
     69  1.1.1.18  christos  * provision in the documentation and/or other materials provided with the
     70  1.1.1.18  christos  * distribution.
     71  1.1.1.18  christos  *
     72  1.1.1.18  christos  * 3.4. Intel retains all right, title, and interest in and to the Original
     73  1.1.1.18  christos  * Intel Code.
     74  1.1.1.18  christos  *
     75  1.1.1.18  christos  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
     76  1.1.1.18  christos  * Intel shall be used in advertising or otherwise to promote the sale, use or
     77  1.1.1.18  christos  * other dealings in products derived from or relating to the Covered Code
     78  1.1.1.18  christos  * without prior written authorization from Intel.
     79  1.1.1.18  christos  *
     80  1.1.1.18  christos  * 4. Disclaimer and Export Compliance
     81  1.1.1.18  christos  *
     82  1.1.1.18  christos  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
     83  1.1.1.18  christos  * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
     84  1.1.1.18  christos  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
     85  1.1.1.18  christos  * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
     86  1.1.1.18  christos  * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
     87  1.1.1.18  christos  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
     88  1.1.1.18  christos  * PARTICULAR PURPOSE.
     89  1.1.1.18  christos  *
     90  1.1.1.18  christos  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
     91  1.1.1.18  christos  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
     92  1.1.1.18  christos  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
     93  1.1.1.18  christos  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
     94  1.1.1.18  christos  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
     95  1.1.1.18  christos  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
     96  1.1.1.18  christos  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
     97  1.1.1.18  christos  * LIMITED REMEDY.
     98  1.1.1.18  christos  *
     99  1.1.1.18  christos  * 4.3. Licensee shall not export, either directly or indirectly, any of this
    100  1.1.1.18  christos  * software or system incorporating such software without first obtaining any
    101  1.1.1.18  christos  * required license or other approval from the U. S. Department of Commerce or
    102  1.1.1.18  christos  * any other agency or department of the United States Government. In the
    103  1.1.1.18  christos  * event Licensee exports any such software from the United States or
    104  1.1.1.18  christos  * re-exports any such software from a foreign destination, Licensee shall
    105  1.1.1.18  christos  * ensure that the distribution and export/re-export of the software is in
    106  1.1.1.18  christos  * compliance with all laws, regulations, orders, or other restrictions of the
    107  1.1.1.18  christos  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
    108  1.1.1.18  christos  * any of its subsidiaries will export/re-export any technical data, process,
    109  1.1.1.18  christos  * software, or service, directly or indirectly, to any country for which the
    110  1.1.1.18  christos  * United States government or any agency thereof requires an export license,
    111  1.1.1.18  christos  * other governmental approval, or letter of assurance, without first obtaining
    112  1.1.1.18  christos  * such license, approval or letter.
    113  1.1.1.18  christos  *
    114  1.1.1.18  christos  *****************************************************************************
    115  1.1.1.18  christos  *
    116  1.1.1.18  christos  * Alternatively, you may choose to be licensed under the terms of the
    117  1.1.1.18  christos  * following license:
    118  1.1.1.18  christos  *
    119       1.1  christos  * Redistribution and use in source and binary forms, with or without
    120       1.1  christos  * modification, are permitted provided that the following conditions
    121       1.1  christos  * are met:
    122       1.1  christos  * 1. Redistributions of source code must retain the above copyright
    123       1.1  christos  *    notice, this list of conditions, and the following disclaimer,
    124       1.1  christos  *    without modification.
    125       1.1  christos  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
    126       1.1  christos  *    substantially similar to the "NO WARRANTY" disclaimer below
    127       1.1  christos  *    ("Disclaimer") and any redistribution must be conditioned upon
    128       1.1  christos  *    including a substantially similar Disclaimer requirement for further
    129       1.1  christos  *    binary redistribution.
    130       1.1  christos  * 3. Neither the names of the above-listed copyright holders nor the names
    131       1.1  christos  *    of any contributors may be used to endorse or promote products derived
    132       1.1  christos  *    from this software without specific prior written permission.
    133       1.1  christos  *
    134       1.1  christos  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    135       1.1  christos  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    136  1.1.1.14  christos  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    137       1.1  christos  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
    138  1.1.1.18  christos  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    139  1.1.1.18  christos  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    140  1.1.1.18  christos  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    141  1.1.1.18  christos  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    142  1.1.1.18  christos  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    143  1.1.1.18  christos  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    144  1.1.1.18  christos  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    145  1.1.1.18  christos  *
    146  1.1.1.18  christos  * Alternatively, you may choose to be licensed under the terms of the
    147  1.1.1.18  christos  * GNU General Public License ("GPL") version 2 as published by the Free
    148  1.1.1.18  christos  * Software Foundation.
    149  1.1.1.18  christos  *
    150  1.1.1.18  christos  *****************************************************************************/
    151       1.1  christos 
    152       1.1  christos #include "acpi.h"
    153       1.1  christos #include "accommon.h"
    154       1.1  christos #include "acdebug.h"
    155       1.1  christos 
    156       1.1  christos 
    157       1.1  christos #define _COMPONENT          ACPI_CA_DEBUGGER
    158       1.1  christos         ACPI_MODULE_NAME    ("dbconvert")
    159       1.1  christos 
    160       1.1  christos 
    161       1.1  christos #define DB_DEFAULT_PKG_ELEMENTS     33
    162       1.1  christos 
    163       1.1  christos 
    164       1.1  christos /*******************************************************************************
    165       1.1  christos  *
    166       1.1  christos  * FUNCTION:    AcpiDbHexCharToValue
    167       1.1  christos  *
    168       1.1  christos  * PARAMETERS:  HexChar             - Ascii Hex digit, 0-9|a-f|A-F
    169       1.1  christos  *              ReturnValue         - Where the converted value is returned
    170       1.1  christos  *
    171       1.1  christos  * RETURN:      Status
    172       1.1  christos  *
    173       1.1  christos  * DESCRIPTION: Convert a single hex character to a 4-bit number (0-16).
    174       1.1  christos  *
    175       1.1  christos  ******************************************************************************/
    176       1.1  christos 
    177       1.1  christos ACPI_STATUS
    178       1.1  christos AcpiDbHexCharToValue (
    179       1.1  christos     int                     HexChar,
    180       1.1  christos     UINT8                   *ReturnValue)
    181       1.1  christos {
    182       1.1  christos     UINT8                   Value;
    183       1.1  christos 
    184       1.1  christos 
    185       1.1  christos     /* Digit must be ascii [0-9a-fA-F] */
    186       1.1  christos 
    187   1.1.1.4  christos     if (!isxdigit (HexChar))
    188       1.1  christos     {
    189       1.1  christos         return (AE_BAD_HEX_CONSTANT);
    190       1.1  christos     }
    191       1.1  christos 
    192       1.1  christos     if (HexChar <= 0x39)
    193       1.1  christos     {
    194       1.1  christos         Value = (UINT8) (HexChar - 0x30);
    195       1.1  christos     }
    196       1.1  christos     else
    197       1.1  christos     {
    198   1.1.1.4  christos         Value = (UINT8) (toupper (HexChar) - 0x37);
    199       1.1  christos     }
    200       1.1  christos 
    201       1.1  christos     *ReturnValue = Value;
    202       1.1  christos     return (AE_OK);
    203       1.1  christos }
    204       1.1  christos 
    205       1.1  christos 
    206       1.1  christos /*******************************************************************************
    207       1.1  christos  *
    208       1.1  christos  * FUNCTION:    AcpiDbHexByteToBinary
    209       1.1  christos  *
    210       1.1  christos  * PARAMETERS:  HexByte             - Double hex digit (0x00 - 0xFF) in format:
    211       1.1  christos  *                                    HiByte then LoByte.
    212       1.1  christos  *              ReturnValue         - Where the converted value is returned
    213       1.1  christos  *
    214       1.1  christos  * RETURN:      Status
    215       1.1  christos  *
    216       1.1  christos  * DESCRIPTION: Convert two hex characters to an 8 bit number (0 - 255).
    217       1.1  christos  *
    218       1.1  christos  ******************************************************************************/
    219       1.1  christos 
    220       1.1  christos static ACPI_STATUS
    221       1.1  christos AcpiDbHexByteToBinary (
    222       1.1  christos     char                    *HexByte,
    223       1.1  christos     UINT8                   *ReturnValue)
    224       1.1  christos {
    225       1.1  christos     UINT8                   Local0;
    226       1.1  christos     UINT8                   Local1;
    227       1.1  christos     ACPI_STATUS             Status;
    228       1.1  christos 
    229       1.1  christos 
    230       1.1  christos     /* High byte */
    231       1.1  christos 
    232       1.1  christos     Status = AcpiDbHexCharToValue (HexByte[0], &Local0);
    233       1.1  christos     if (ACPI_FAILURE (Status))
    234       1.1  christos     {
    235       1.1  christos         return (Status);
    236       1.1  christos     }
    237       1.1  christos 
    238       1.1  christos     /* Low byte */
    239       1.1  christos 
    240       1.1  christos     Status = AcpiDbHexCharToValue (HexByte[1], &Local1);
    241       1.1  christos     if (ACPI_FAILURE (Status))
    242       1.1  christos     {
    243       1.1  christos         return (Status);
    244       1.1  christos     }
    245       1.1  christos 
    246       1.1  christos     *ReturnValue = (UINT8) ((Local0 << 4) | Local1);
    247       1.1  christos     return (AE_OK);
    248       1.1  christos }
    249       1.1  christos 
    250       1.1  christos 
    251       1.1  christos /*******************************************************************************
    252       1.1  christos  *
    253       1.1  christos  * FUNCTION:    AcpiDbConvertToBuffer
    254       1.1  christos  *
    255       1.1  christos  * PARAMETERS:  String              - Input string to be converted
    256       1.1  christos  *              Object              - Where the buffer object is returned
    257       1.1  christos  *
    258       1.1  christos  * RETURN:      Status
    259       1.1  christos  *
    260       1.1  christos  * DESCRIPTION: Convert a string to a buffer object. String is treated a list
    261       1.1  christos  *              of buffer elements, each separated by a space or comma.
    262       1.1  christos  *
    263       1.1  christos  ******************************************************************************/
    264       1.1  christos 
    265       1.1  christos static ACPI_STATUS
    266       1.1  christos AcpiDbConvertToBuffer (
    267       1.1  christos     char                    *String,
    268       1.1  christos     ACPI_OBJECT             *Object)
    269       1.1  christos {
    270       1.1  christos     UINT32                  i;
    271       1.1  christos     UINT32                  j;
    272       1.1  christos     UINT32                  Length;
    273       1.1  christos     UINT8                   *Buffer;
    274       1.1  christos     ACPI_STATUS             Status;
    275       1.1  christos 
    276       1.1  christos 
    277  1.1.1.12  christos     /* Skip all preceding white space*/
    278  1.1.1.12  christos 
    279  1.1.1.12  christos     AcpiUtRemoveWhitespace (&String);
    280  1.1.1.12  christos 
    281       1.1  christos     /* Generate the final buffer length */
    282       1.1  christos 
    283       1.1  christos     for (i = 0, Length = 0; String[i];)
    284       1.1  christos     {
    285       1.1  christos         i+=2;
    286       1.1  christos         Length++;
    287       1.1  christos 
    288       1.1  christos         while (String[i] &&
    289       1.1  christos               ((String[i] == ',') || (String[i] == ' ')))
    290       1.1  christos         {
    291       1.1  christos             i++;
    292       1.1  christos         }
    293       1.1  christos     }
    294       1.1  christos 
    295       1.1  christos     Buffer = ACPI_ALLOCATE (Length);
    296       1.1  christos     if (!Buffer)
    297       1.1  christos     {
    298       1.1  christos         return (AE_NO_MEMORY);
    299       1.1  christos     }
    300       1.1  christos 
    301       1.1  christos     /* Convert the command line bytes to the buffer */
    302       1.1  christos 
    303       1.1  christos     for (i = 0, j = 0; String[i];)
    304       1.1  christos     {
    305       1.1  christos         Status = AcpiDbHexByteToBinary (&String[i], &Buffer[j]);
    306       1.1  christos         if (ACPI_FAILURE (Status))
    307       1.1  christos         {
    308       1.1  christos             ACPI_FREE (Buffer);
    309       1.1  christos             return (Status);
    310       1.1  christos         }
    311       1.1  christos 
    312       1.1  christos         j++;
    313   1.1.1.5  christos         i += 2;
    314       1.1  christos         while (String[i] &&
    315       1.1  christos               ((String[i] == ',') || (String[i] == ' ')))
    316       1.1  christos         {
    317       1.1  christos             i++;
    318       1.1  christos         }
    319       1.1  christos     }
    320       1.1  christos 
    321       1.1  christos     Object->Type = ACPI_TYPE_BUFFER;
    322       1.1  christos     Object->Buffer.Pointer = Buffer;
    323       1.1  christos     Object->Buffer.Length = Length;
    324       1.1  christos     return (AE_OK);
    325       1.1  christos }
    326       1.1  christos 
    327       1.1  christos 
    328       1.1  christos /*******************************************************************************
    329       1.1  christos  *
    330       1.1  christos  * FUNCTION:    AcpiDbConvertToPackage
    331       1.1  christos  *
    332       1.1  christos  * PARAMETERS:  String              - Input string to be converted
    333       1.1  christos  *              Object              - Where the package object is returned
    334       1.1  christos  *
    335       1.1  christos  * RETURN:      Status
    336       1.1  christos  *
    337       1.1  christos  * DESCRIPTION: Convert a string to a package object. Handles nested packages
    338       1.1  christos  *              via recursion with AcpiDbConvertToObject.
    339       1.1  christos  *
    340       1.1  christos  ******************************************************************************/
    341       1.1  christos 
    342       1.1  christos ACPI_STATUS
    343       1.1  christos AcpiDbConvertToPackage (
    344       1.1  christos     char                    *String,
    345       1.1  christos     ACPI_OBJECT             *Object)
    346       1.1  christos {
    347       1.1  christos     char                    *This;
    348       1.1  christos     char                    *Next;
    349       1.1  christos     UINT32                  i;
    350       1.1  christos     ACPI_OBJECT_TYPE        Type;
    351       1.1  christos     ACPI_OBJECT             *Elements;
    352       1.1  christos     ACPI_STATUS             Status;
    353       1.1  christos 
    354       1.1  christos 
    355       1.1  christos     Elements = ACPI_ALLOCATE_ZEROED (
    356       1.1  christos         DB_DEFAULT_PKG_ELEMENTS * sizeof (ACPI_OBJECT));
    357  1.1.1.17  christos     if (!Elements)
    358  1.1.1.17  christos         return (AE_NO_MEMORY);
    359       1.1  christos 
    360       1.1  christos     This = String;
    361       1.1  christos     for (i = 0; i < (DB_DEFAULT_PKG_ELEMENTS - 1); i++)
    362       1.1  christos     {
    363       1.1  christos         This = AcpiDbGetNextToken (This, &Next, &Type);
    364       1.1  christos         if (!This)
    365       1.1  christos         {
    366       1.1  christos             break;
    367       1.1  christos         }
    368       1.1  christos 
    369       1.1  christos         /* Recursive call to convert each package element */
    370       1.1  christos 
    371       1.1  christos         Status = AcpiDbConvertToObject (Type, This, &Elements[i]);
    372       1.1  christos         if (ACPI_FAILURE (Status))
    373       1.1  christos         {
    374       1.1  christos             AcpiDbDeleteObjects (i + 1, Elements);
    375       1.1  christos             ACPI_FREE (Elements);
    376       1.1  christos             return (Status);
    377       1.1  christos         }
    378       1.1  christos 
    379       1.1  christos         This = Next;
    380       1.1  christos     }
    381       1.1  christos 
    382       1.1  christos     Object->Type = ACPI_TYPE_PACKAGE;
    383       1.1  christos     Object->Package.Count = i;
    384       1.1  christos     Object->Package.Elements = Elements;
    385       1.1  christos     return (AE_OK);
    386       1.1  christos }
    387       1.1  christos 
    388       1.1  christos 
    389       1.1  christos /*******************************************************************************
    390       1.1  christos  *
    391       1.1  christos  * FUNCTION:    AcpiDbConvertToObject
    392       1.1  christos  *
    393       1.1  christos  * PARAMETERS:  Type                - Object type as determined by parser
    394       1.1  christos  *              String              - Input string to be converted
    395       1.1  christos  *              Object              - Where the new object is returned
    396       1.1  christos  *
    397       1.1  christos  * RETURN:      Status
    398       1.1  christos  *
    399       1.1  christos  * DESCRIPTION: Convert a typed and tokenized string to an ACPI_OBJECT. Typing:
    400       1.1  christos  *              1) String objects were surrounded by quotes.
    401       1.1  christos  *              2) Buffer objects were surrounded by parentheses.
    402       1.1  christos  *              3) Package objects were surrounded by brackets "[]".
    403       1.1  christos  *              4) All standalone tokens are treated as integers.
    404       1.1  christos  *
    405       1.1  christos  ******************************************************************************/
    406       1.1  christos 
    407       1.1  christos ACPI_STATUS
    408       1.1  christos AcpiDbConvertToObject (
    409       1.1  christos     ACPI_OBJECT_TYPE        Type,
    410       1.1  christos     char                    *String,
    411       1.1  christos     ACPI_OBJECT             *Object)
    412       1.1  christos {
    413       1.1  christos     ACPI_STATUS             Status = AE_OK;
    414       1.1  christos 
    415       1.1  christos 
    416       1.1  christos     switch (Type)
    417       1.1  christos     {
    418       1.1  christos     case ACPI_TYPE_STRING:
    419       1.1  christos 
    420       1.1  christos         Object->Type = ACPI_TYPE_STRING;
    421       1.1  christos         Object->String.Pointer = String;
    422   1.1.1.4  christos         Object->String.Length = (UINT32) strlen (String);
    423       1.1  christos         break;
    424       1.1  christos 
    425       1.1  christos     case ACPI_TYPE_BUFFER:
    426       1.1  christos 
    427       1.1  christos         Status = AcpiDbConvertToBuffer (String, Object);
    428       1.1  christos         break;
    429       1.1  christos 
    430       1.1  christos     case ACPI_TYPE_PACKAGE:
    431       1.1  christos 
    432       1.1  christos         Status = AcpiDbConvertToPackage (String, Object);
    433       1.1  christos         break;
    434       1.1  christos 
    435       1.1  christos     default:
    436       1.1  christos 
    437       1.1  christos         Object->Type = ACPI_TYPE_INTEGER;
    438   1.1.1.9  christos         Status = AcpiUtStrtoul64 (String, &Object->Integer.Value);
    439       1.1  christos         break;
    440       1.1  christos     }
    441       1.1  christos 
    442       1.1  christos     return (Status);
    443       1.1  christos }
    444       1.1  christos 
    445       1.1  christos 
    446       1.1  christos /*******************************************************************************
    447       1.1  christos  *
    448       1.1  christos  * FUNCTION:    AcpiDbEncodePldBuffer
    449       1.1  christos  *
    450       1.1  christos  * PARAMETERS:  PldInfo             - _PLD buffer struct (Using local struct)
    451       1.1  christos  *
    452       1.1  christos  * RETURN:      Encode _PLD buffer suitable for return value from _PLD
    453       1.1  christos  *
    454       1.1  christos  * DESCRIPTION: Bit-packs a _PLD buffer struct. Used to test the _PLD macros
    455       1.1  christos  *
    456       1.1  christos  ******************************************************************************/
    457       1.1  christos 
    458       1.1  christos UINT8 *
    459       1.1  christos AcpiDbEncodePldBuffer (
    460       1.1  christos     ACPI_PLD_INFO           *PldInfo)
    461       1.1  christos {
    462       1.1  christos     UINT32                  *Buffer;
    463       1.1  christos     UINT32                  Dword;
    464       1.1  christos 
    465       1.1  christos 
    466       1.1  christos     Buffer = ACPI_ALLOCATE_ZEROED (ACPI_PLD_BUFFER_SIZE);
    467       1.1  christos     if (!Buffer)
    468       1.1  christos     {
    469       1.1  christos         return (NULL);
    470       1.1  christos     }
    471       1.1  christos 
    472       1.1  christos     /* First 32 bits */
    473       1.1  christos 
    474       1.1  christos     Dword = 0;
    475       1.1  christos     ACPI_PLD_SET_REVISION       (&Dword, PldInfo->Revision);
    476       1.1  christos     ACPI_PLD_SET_IGNORE_COLOR   (&Dword, PldInfo->IgnoreColor);
    477   1.1.1.3  christos     ACPI_PLD_SET_RED            (&Dword, PldInfo->Red);
    478   1.1.1.3  christos     ACPI_PLD_SET_GREEN          (&Dword, PldInfo->Green);
    479   1.1.1.3  christos     ACPI_PLD_SET_BLUE           (&Dword, PldInfo->Blue);
    480       1.1  christos     ACPI_MOVE_32_TO_32 (&Buffer[0], &Dword);
    481       1.1  christos 
    482       1.1  christos     /* Second 32 bits */
    483       1.1  christos 
    484       1.1  christos     Dword = 0;
    485       1.1  christos     ACPI_PLD_SET_WIDTH          (&Dword, PldInfo->Width);
    486       1.1  christos     ACPI_PLD_SET_HEIGHT         (&Dword, PldInfo->Height);
    487       1.1  christos     ACPI_MOVE_32_TO_32 (&Buffer[1], &Dword);
    488       1.1  christos 
    489       1.1  christos     /* Third 32 bits */
    490       1.1  christos 
    491       1.1  christos     Dword = 0;
    492       1.1  christos     ACPI_PLD_SET_USER_VISIBLE   (&Dword, PldInfo->UserVisible);
    493       1.1  christos     ACPI_PLD_SET_DOCK           (&Dword, PldInfo->Dock);
    494       1.1  christos     ACPI_PLD_SET_LID            (&Dword, PldInfo->Lid);
    495       1.1  christos     ACPI_PLD_SET_PANEL          (&Dword, PldInfo->Panel);
    496       1.1  christos     ACPI_PLD_SET_VERTICAL       (&Dword, PldInfo->VerticalPosition);
    497       1.1  christos     ACPI_PLD_SET_HORIZONTAL     (&Dword, PldInfo->HorizontalPosition);
    498       1.1  christos     ACPI_PLD_SET_SHAPE          (&Dword, PldInfo->Shape);
    499       1.1  christos     ACPI_PLD_SET_ORIENTATION    (&Dword, PldInfo->GroupOrientation);
    500       1.1  christos     ACPI_PLD_SET_TOKEN          (&Dword, PldInfo->GroupToken);
    501       1.1  christos     ACPI_PLD_SET_POSITION       (&Dword, PldInfo->GroupPosition);
    502       1.1  christos     ACPI_PLD_SET_BAY            (&Dword, PldInfo->Bay);
    503       1.1  christos     ACPI_MOVE_32_TO_32 (&Buffer[2], &Dword);
    504       1.1  christos 
    505       1.1  christos     /* Fourth 32 bits */
    506       1.1  christos 
    507       1.1  christos     Dword = 0;
    508       1.1  christos     ACPI_PLD_SET_EJECTABLE      (&Dword, PldInfo->Ejectable);
    509       1.1  christos     ACPI_PLD_SET_OSPM_EJECT     (&Dword, PldInfo->OspmEjectRequired);
    510       1.1  christos     ACPI_PLD_SET_CABINET        (&Dword, PldInfo->CabinetNumber);
    511       1.1  christos     ACPI_PLD_SET_CARD_CAGE      (&Dword, PldInfo->CardCageNumber);
    512       1.1  christos     ACPI_PLD_SET_REFERENCE      (&Dword, PldInfo->Reference);
    513       1.1  christos     ACPI_PLD_SET_ROTATION       (&Dword, PldInfo->Rotation);
    514       1.1  christos     ACPI_PLD_SET_ORDER          (&Dword, PldInfo->Order);
    515       1.1  christos     ACPI_MOVE_32_TO_32 (&Buffer[3], &Dword);
    516       1.1  christos 
    517       1.1  christos     if (PldInfo->Revision >= 2)
    518       1.1  christos     {
    519       1.1  christos         /* Fifth 32 bits */
    520       1.1  christos 
    521       1.1  christos         Dword = 0;
    522       1.1  christos         ACPI_PLD_SET_VERT_OFFSET    (&Dword, PldInfo->VerticalOffset);
    523       1.1  christos         ACPI_PLD_SET_HORIZ_OFFSET   (&Dword, PldInfo->HorizontalOffset);
    524       1.1  christos         ACPI_MOVE_32_TO_32 (&Buffer[4], &Dword);
    525       1.1  christos     }
    526       1.1  christos 
    527       1.1  christos     return (ACPI_CAST_PTR (UINT8, Buffer));
    528       1.1  christos }
    529       1.1  christos 
    530       1.1  christos 
    531       1.1  christos /*******************************************************************************
    532       1.1  christos  *
    533       1.1  christos  * FUNCTION:    AcpiDbDumpPldBuffer
    534       1.1  christos  *
    535       1.1  christos  * PARAMETERS:  ObjDesc             - Object returned from _PLD method
    536       1.1  christos  *
    537       1.1  christos  * RETURN:      None.
    538       1.1  christos  *
    539       1.1  christos  * DESCRIPTION: Dumps formatted contents of a _PLD return buffer.
    540       1.1  christos  *
    541       1.1  christos  ******************************************************************************/
    542       1.1  christos 
    543       1.1  christos #define ACPI_PLD_OUTPUT     "%20s : %-6X\n"
    544       1.1  christos 
    545       1.1  christos void
    546       1.1  christos AcpiDbDumpPldBuffer (
    547       1.1  christos     ACPI_OBJECT             *ObjDesc)
    548       1.1  christos {
    549       1.1  christos     ACPI_OBJECT             *BufferDesc;
    550       1.1  christos     ACPI_PLD_INFO           *PldInfo;
    551       1.1  christos     UINT8                   *NewBuffer;
    552       1.1  christos     ACPI_STATUS             Status;
    553       1.1  christos 
    554       1.1  christos 
    555       1.1  christos     /* Object must be of type Package with at least one Buffer element */
    556       1.1  christos 
    557       1.1  christos     if (ObjDesc->Type != ACPI_TYPE_PACKAGE)
    558       1.1  christos     {
    559       1.1  christos         return;
    560       1.1  christos     }
    561       1.1  christos 
    562       1.1  christos     BufferDesc = &ObjDesc->Package.Elements[0];
    563       1.1  christos     if (BufferDesc->Type != ACPI_TYPE_BUFFER)
    564       1.1  christos     {
    565       1.1  christos         return;
    566       1.1  christos     }
    567       1.1  christos 
    568       1.1  christos     /* Convert _PLD buffer to local _PLD struct */
    569       1.1  christos 
    570       1.1  christos     Status = AcpiDecodePldBuffer (BufferDesc->Buffer.Pointer,
    571       1.1  christos         BufferDesc->Buffer.Length, &PldInfo);
    572       1.1  christos     if (ACPI_FAILURE (Status))
    573       1.1  christos     {
    574       1.1  christos         return;
    575       1.1  christos     }
    576       1.1  christos 
    577       1.1  christos     /* Encode local _PLD struct back to a _PLD buffer */
    578       1.1  christos 
    579       1.1  christos     NewBuffer = AcpiDbEncodePldBuffer (PldInfo);
    580       1.1  christos     if (!NewBuffer)
    581       1.1  christos     {
    582   1.1.1.6  christos         goto Exit;
    583       1.1  christos     }
    584       1.1  christos 
    585       1.1  christos     /* The two bit-packed buffers should match */
    586       1.1  christos 
    587   1.1.1.4  christos     if (memcmp (NewBuffer, BufferDesc->Buffer.Pointer,
    588       1.1  christos         BufferDesc->Buffer.Length))
    589       1.1  christos     {
    590       1.1  christos         AcpiOsPrintf ("Converted _PLD buffer does not compare. New:\n");
    591       1.1  christos 
    592       1.1  christos         AcpiUtDumpBuffer (NewBuffer,
    593       1.1  christos             BufferDesc->Buffer.Length, DB_BYTE_DISPLAY, 0);
    594       1.1  christos     }
    595       1.1  christos 
    596       1.1  christos     /* First 32-bit dword */
    597       1.1  christos 
    598   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Revision", PldInfo->Revision);
    599   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_IgnoreColor", PldInfo->IgnoreColor);
    600   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Red", PldInfo->Red);
    601   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Green", PldInfo->Green);
    602   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Blue", PldInfo->Blue);
    603       1.1  christos 
    604       1.1  christos     /* Second 32-bit dword */
    605       1.1  christos 
    606   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Width", PldInfo->Width);
    607   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Height", PldInfo->Height);
    608       1.1  christos 
    609       1.1  christos     /* Third 32-bit dword */
    610       1.1  christos 
    611   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_UserVisible", PldInfo->UserVisible);
    612   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Dock", PldInfo->Dock);
    613   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Lid", PldInfo->Lid);
    614   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Panel", PldInfo->Panel);
    615   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_VerticalPosition", PldInfo->VerticalPosition);
    616   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_HorizontalPosition", PldInfo->HorizontalPosition);
    617   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Shape", PldInfo->Shape);
    618   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_GroupOrientation", PldInfo->GroupOrientation);
    619   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_GroupToken", PldInfo->GroupToken);
    620   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_GroupPosition", PldInfo->GroupPosition);
    621   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Bay", PldInfo->Bay);
    622       1.1  christos 
    623       1.1  christos     /* Fourth 32-bit dword */
    624       1.1  christos 
    625   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Ejectable", PldInfo->Ejectable);
    626   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_EjectRequired", PldInfo->OspmEjectRequired);
    627   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_CabinetNumber", PldInfo->CabinetNumber);
    628   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_CardCageNumber", PldInfo->CardCageNumber);
    629   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Reference", PldInfo->Reference);
    630   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Rotation", PldInfo->Rotation);
    631   1.1.1.3  christos     AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Order", PldInfo->Order);
    632       1.1  christos 
    633       1.1  christos     /* Fifth 32-bit dword */
    634       1.1  christos 
    635       1.1  christos     if (BufferDesc->Buffer.Length > 16)
    636       1.1  christos     {
    637   1.1.1.3  christos         AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_VerticalOffset", PldInfo->VerticalOffset);
    638   1.1.1.3  christos         AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_HorizontalOffset", PldInfo->HorizontalOffset);
    639       1.1  christos     }
    640       1.1  christos 
    641       1.1  christos     ACPI_FREE (NewBuffer);
    642   1.1.1.6  christos Exit:
    643   1.1.1.6  christos     ACPI_FREE (PldInfo);
    644       1.1  christos }
    645