Home | History | Annotate | Line # | Download | only in compiler
aslopcodes.c revision 1.1.1.4
      1      1.1    jruoho /******************************************************************************
      2      1.1    jruoho  *
      3      1.1    jruoho  * Module Name: aslopcode - AML opcode generation
      4      1.1    jruoho  *
      5      1.1    jruoho  *****************************************************************************/
      6      1.1    jruoho 
      7  1.1.1.2    jruoho /*
      8  1.1.1.4  christos  * Copyright (C) 2000 - 2014, Intel Corp.
      9      1.1    jruoho  * All rights reserved.
     10      1.1    jruoho  *
     11  1.1.1.2    jruoho  * Redistribution and use in source and binary forms, with or without
     12  1.1.1.2    jruoho  * modification, are permitted provided that the following conditions
     13  1.1.1.2    jruoho  * are met:
     14  1.1.1.2    jruoho  * 1. Redistributions of source code must retain the above copyright
     15  1.1.1.2    jruoho  *    notice, this list of conditions, and the following disclaimer,
     16  1.1.1.2    jruoho  *    without modification.
     17  1.1.1.2    jruoho  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.1.1.2    jruoho  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.1.1.2    jruoho  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.1.1.2    jruoho  *    including a substantially similar Disclaimer requirement for further
     21  1.1.1.2    jruoho  *    binary redistribution.
     22  1.1.1.2    jruoho  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.1.1.2    jruoho  *    of any contributors may be used to endorse or promote products derived
     24  1.1.1.2    jruoho  *    from this software without specific prior written permission.
     25  1.1.1.2    jruoho  *
     26  1.1.1.2    jruoho  * Alternatively, this software may be distributed under the terms of the
     27  1.1.1.2    jruoho  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.1.1.2    jruoho  * Software Foundation.
     29  1.1.1.2    jruoho  *
     30  1.1.1.2    jruoho  * NO WARRANTY
     31  1.1.1.2    jruoho  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.1.1.2    jruoho  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.1.1.2    jruoho  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.1.1.2    jruoho  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.1.1.2    jruoho  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.1.1.2    jruoho  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.1.1.2    jruoho  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.1.1.2    jruoho  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.1.1.2    jruoho  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.1.1.2    jruoho  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.1.1.2    jruoho  * POSSIBILITY OF SUCH DAMAGES.
     42  1.1.1.2    jruoho  */
     43      1.1    jruoho 
     44      1.1    jruoho #include "aslcompiler.h"
     45      1.1    jruoho #include "aslcompiler.y.h"
     46      1.1    jruoho #include "amlcode.h"
     47      1.1    jruoho 
     48      1.1    jruoho #define _COMPONENT          ACPI_COMPILER
     49      1.1    jruoho         ACPI_MODULE_NAME    ("aslopcodes")
     50      1.1    jruoho 
     51      1.1    jruoho 
     52      1.1    jruoho /* Local prototypes */
     53      1.1    jruoho 
     54      1.1    jruoho static void
     55      1.1    jruoho OpcDoAccessAs (
     56      1.1    jruoho     ACPI_PARSE_OBJECT       *Op);
     57      1.1    jruoho 
     58      1.1    jruoho static void
     59  1.1.1.3  christos OpcDoConnection (
     60  1.1.1.3  christos     ACPI_PARSE_OBJECT       *Op);
     61  1.1.1.3  christos 
     62  1.1.1.3  christos static void
     63      1.1    jruoho OpcDoUnicode (
     64      1.1    jruoho     ACPI_PARSE_OBJECT       *Op);
     65      1.1    jruoho 
     66      1.1    jruoho static void
     67      1.1    jruoho OpcDoEisaId (
     68      1.1    jruoho     ACPI_PARSE_OBJECT       *Op);
     69      1.1    jruoho 
     70      1.1    jruoho static void
     71      1.1    jruoho OpcDoUuId (
     72      1.1    jruoho     ACPI_PARSE_OBJECT       *Op);
     73      1.1    jruoho 
     74      1.1    jruoho 
     75      1.1    jruoho /*******************************************************************************
     76      1.1    jruoho  *
     77      1.1    jruoho  * FUNCTION:    OpcAmlOpcodeUpdateWalk
     78      1.1    jruoho  *
     79      1.1    jruoho  * PARAMETERS:  ASL_WALK_CALLBACK
     80      1.1    jruoho  *
     81      1.1    jruoho  * RETURN:      Status
     82      1.1    jruoho  *
     83      1.1    jruoho  * DESCRIPTION: Opcode update walk, ascending callback
     84      1.1    jruoho  *
     85      1.1    jruoho  ******************************************************************************/
     86      1.1    jruoho 
     87      1.1    jruoho ACPI_STATUS
     88      1.1    jruoho OpcAmlOpcodeUpdateWalk (
     89      1.1    jruoho     ACPI_PARSE_OBJECT       *Op,
     90      1.1    jruoho     UINT32                  Level,
     91      1.1    jruoho     void                    *Context)
     92      1.1    jruoho {
     93      1.1    jruoho 
     94      1.1    jruoho     /*
     95      1.1    jruoho      * Handle the Package() case where the actual opcode cannot be determined
     96      1.1    jruoho      * until the PackageLength operand has been folded and minimized.
     97      1.1    jruoho      * (PackageOp versus VarPackageOp)
     98      1.1    jruoho      *
     99      1.1    jruoho      * This is (as of ACPI 3.0) the only case where the AML opcode can change
    100      1.1    jruoho      * based upon the value of a parameter.
    101      1.1    jruoho      *
    102      1.1    jruoho      * The parser always inserts a VarPackage opcode, which can possibly be
    103      1.1    jruoho      * optimized to a Package opcode.
    104      1.1    jruoho      */
    105      1.1    jruoho     if (Op->Asl.ParseOpcode == PARSEOP_VAR_PACKAGE)
    106      1.1    jruoho     {
    107      1.1    jruoho         OpnDoPackage (Op);
    108      1.1    jruoho     }
    109      1.1    jruoho 
    110      1.1    jruoho     return (AE_OK);
    111      1.1    jruoho }
    112      1.1    jruoho 
    113      1.1    jruoho 
    114      1.1    jruoho /*******************************************************************************
    115      1.1    jruoho  *
    116      1.1    jruoho  * FUNCTION:    OpcAmlOpcodeWalk
    117      1.1    jruoho  *
    118      1.1    jruoho  * PARAMETERS:  ASL_WALK_CALLBACK
    119      1.1    jruoho  *
    120      1.1    jruoho  * RETURN:      Status
    121      1.1    jruoho  *
    122      1.1    jruoho  * DESCRIPTION: Parse tree walk to generate both the AML opcodes and the AML
    123      1.1    jruoho  *              operands.
    124      1.1    jruoho  *
    125      1.1    jruoho  ******************************************************************************/
    126      1.1    jruoho 
    127      1.1    jruoho ACPI_STATUS
    128      1.1    jruoho OpcAmlOpcodeWalk (
    129      1.1    jruoho     ACPI_PARSE_OBJECT       *Op,
    130      1.1    jruoho     UINT32                  Level,
    131      1.1    jruoho     void                    *Context)
    132      1.1    jruoho {
    133      1.1    jruoho 
    134      1.1    jruoho     TotalParseNodes++;
    135      1.1    jruoho 
    136      1.1    jruoho     OpcGenerateAmlOpcode (Op);
    137      1.1    jruoho     OpnGenerateAmlOperands (Op);
    138      1.1    jruoho     return (AE_OK);
    139      1.1    jruoho }
    140      1.1    jruoho 
    141      1.1    jruoho 
    142      1.1    jruoho /*******************************************************************************
    143      1.1    jruoho  *
    144      1.1    jruoho  * FUNCTION:    OpcGetIntegerWidth
    145      1.1    jruoho  *
    146      1.1    jruoho  * PARAMETERS:  Op          - DEFINITION BLOCK op
    147      1.1    jruoho  *
    148      1.1    jruoho  * RETURN:      none
    149      1.1    jruoho  *
    150      1.1    jruoho  * DESCRIPTION: Extract integer width from the table revision
    151      1.1    jruoho  *
    152      1.1    jruoho  ******************************************************************************/
    153      1.1    jruoho 
    154      1.1    jruoho void
    155      1.1    jruoho OpcGetIntegerWidth (
    156      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    157      1.1    jruoho {
    158      1.1    jruoho     ACPI_PARSE_OBJECT       *Child;
    159      1.1    jruoho 
    160      1.1    jruoho 
    161      1.1    jruoho     if (!Op)
    162      1.1    jruoho     {
    163      1.1    jruoho         return;
    164      1.1    jruoho     }
    165      1.1    jruoho 
    166      1.1    jruoho     if (Gbl_RevisionOverride)
    167      1.1    jruoho     {
    168      1.1    jruoho         AcpiUtSetIntegerWidth (Gbl_RevisionOverride);
    169      1.1    jruoho     }
    170      1.1    jruoho     else
    171      1.1    jruoho     {
    172      1.1    jruoho         Child = Op->Asl.Child;
    173      1.1    jruoho         Child = Child->Asl.Next;
    174      1.1    jruoho         Child = Child->Asl.Next;
    175      1.1    jruoho 
    176      1.1    jruoho         /* Use the revision to set the integer width */
    177      1.1    jruoho 
    178      1.1    jruoho         AcpiUtSetIntegerWidth ((UINT8) Child->Asl.Value.Integer);
    179      1.1    jruoho     }
    180      1.1    jruoho }
    181      1.1    jruoho 
    182      1.1    jruoho 
    183      1.1    jruoho /*******************************************************************************
    184      1.1    jruoho  *
    185      1.1    jruoho  * FUNCTION:    OpcSetOptimalIntegerSize
    186      1.1    jruoho  *
    187      1.1    jruoho  * PARAMETERS:  Op        - A parse tree node
    188      1.1    jruoho  *
    189  1.1.1.3  christos  * RETURN:      Integer width, in bytes. Also sets the node AML opcode to the
    190      1.1    jruoho  *              optimal integer AML prefix opcode.
    191      1.1    jruoho  *
    192  1.1.1.3  christos  * DESCRIPTION: Determine the optimal AML encoding of an integer. All leading
    193      1.1    jruoho  *              zeros can be truncated to squeeze the integer into the
    194      1.1    jruoho  *              minimal number of AML bytes.
    195      1.1    jruoho  *
    196      1.1    jruoho  ******************************************************************************/
    197      1.1    jruoho 
    198      1.1    jruoho UINT32
    199      1.1    jruoho OpcSetOptimalIntegerSize (
    200      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    201      1.1    jruoho {
    202      1.1    jruoho 
    203      1.1    jruoho #if 0
    204      1.1    jruoho     /*
    205      1.1    jruoho      * TBD: - we don't want to optimize integers in the block header, but the
    206      1.1    jruoho      * code below does not work correctly.
    207      1.1    jruoho      */
    208      1.1    jruoho     if (Op->Asl.Parent &&
    209      1.1    jruoho         Op->Asl.Parent->Asl.Parent &&
    210      1.1    jruoho        (Op->Asl.Parent->Asl.Parent->Asl.ParseOpcode == PARSEOP_DEFINITIONBLOCK))
    211      1.1    jruoho     {
    212  1.1.1.3  christos         return (0);
    213      1.1    jruoho     }
    214      1.1    jruoho #endif
    215      1.1    jruoho 
    216      1.1    jruoho     /*
    217      1.1    jruoho      * Check for the special AML integers first - Zero, One, Ones.
    218      1.1    jruoho      * These are single-byte opcodes that are the smallest possible
    219      1.1    jruoho      * representation of an integer.
    220      1.1    jruoho      *
    221      1.1    jruoho      * This optimization is optional.
    222      1.1    jruoho      */
    223      1.1    jruoho     if (Gbl_IntegerOptimizationFlag)
    224      1.1    jruoho     {
    225      1.1    jruoho         switch (Op->Asl.Value.Integer)
    226      1.1    jruoho         {
    227      1.1    jruoho         case 0:
    228      1.1    jruoho 
    229      1.1    jruoho             Op->Asl.AmlOpcode = AML_ZERO_OP;
    230      1.1    jruoho             AslError (ASL_OPTIMIZATION, ASL_MSG_INTEGER_OPTIMIZATION,
    231      1.1    jruoho                 Op, "Zero");
    232  1.1.1.3  christos             return (1);
    233      1.1    jruoho 
    234      1.1    jruoho         case 1:
    235      1.1    jruoho 
    236      1.1    jruoho             Op->Asl.AmlOpcode = AML_ONE_OP;
    237      1.1    jruoho             AslError (ASL_OPTIMIZATION, ASL_MSG_INTEGER_OPTIMIZATION,
    238      1.1    jruoho                 Op, "One");
    239  1.1.1.3  christos             return (1);
    240      1.1    jruoho 
    241      1.1    jruoho         case ACPI_UINT32_MAX:
    242      1.1    jruoho 
    243      1.1    jruoho             /* Check for table integer width (32 or 64) */
    244      1.1    jruoho 
    245      1.1    jruoho             if (AcpiGbl_IntegerByteWidth == 4)
    246      1.1    jruoho             {
    247      1.1    jruoho                 Op->Asl.AmlOpcode = AML_ONES_OP;
    248      1.1    jruoho                 AslError (ASL_OPTIMIZATION, ASL_MSG_INTEGER_OPTIMIZATION,
    249      1.1    jruoho                     Op, "Ones");
    250  1.1.1.3  christos                 return (1);
    251      1.1    jruoho             }
    252      1.1    jruoho             break;
    253      1.1    jruoho 
    254      1.1    jruoho         case ACPI_UINT64_MAX:
    255      1.1    jruoho 
    256      1.1    jruoho             /* Check for table integer width (32 or 64) */
    257      1.1    jruoho 
    258      1.1    jruoho             if (AcpiGbl_IntegerByteWidth == 8)
    259      1.1    jruoho             {
    260      1.1    jruoho                 Op->Asl.AmlOpcode = AML_ONES_OP;
    261      1.1    jruoho                 AslError (ASL_OPTIMIZATION, ASL_MSG_INTEGER_OPTIMIZATION,
    262      1.1    jruoho                     Op, "Ones");
    263  1.1.1.3  christos                 return (1);
    264      1.1    jruoho             }
    265      1.1    jruoho             break;
    266      1.1    jruoho 
    267      1.1    jruoho         default:
    268  1.1.1.3  christos 
    269      1.1    jruoho             break;
    270      1.1    jruoho         }
    271      1.1    jruoho     }
    272      1.1    jruoho 
    273      1.1    jruoho     /* Find the best fit using the various AML integer prefixes */
    274      1.1    jruoho 
    275      1.1    jruoho     if (Op->Asl.Value.Integer <= ACPI_UINT8_MAX)
    276      1.1    jruoho     {
    277      1.1    jruoho         Op->Asl.AmlOpcode = AML_BYTE_OP;
    278  1.1.1.3  christos         return (1);
    279      1.1    jruoho     }
    280      1.1    jruoho     if (Op->Asl.Value.Integer <= ACPI_UINT16_MAX)
    281      1.1    jruoho     {
    282      1.1    jruoho         Op->Asl.AmlOpcode = AML_WORD_OP;
    283  1.1.1.3  christos         return (2);
    284      1.1    jruoho     }
    285      1.1    jruoho     if (Op->Asl.Value.Integer <= ACPI_UINT32_MAX)
    286      1.1    jruoho     {
    287      1.1    jruoho         Op->Asl.AmlOpcode = AML_DWORD_OP;
    288  1.1.1.3  christos         return (4);
    289      1.1    jruoho     }
    290      1.1    jruoho     else
    291      1.1    jruoho     {
    292      1.1    jruoho         if (AcpiGbl_IntegerByteWidth == 4)
    293      1.1    jruoho         {
    294      1.1    jruoho             AslError (ASL_WARNING, ASL_MSG_INTEGER_LENGTH,
    295      1.1    jruoho                 Op, NULL);
    296      1.1    jruoho 
    297      1.1    jruoho             if (!Gbl_IgnoreErrors)
    298      1.1    jruoho             {
    299      1.1    jruoho                 /* Truncate the integer to 32-bit */
    300      1.1    jruoho                 Op->Asl.AmlOpcode = AML_DWORD_OP;
    301  1.1.1.3  christos                 return (4);
    302      1.1    jruoho             }
    303      1.1    jruoho         }
    304      1.1    jruoho 
    305      1.1    jruoho         Op->Asl.AmlOpcode = AML_QWORD_OP;
    306  1.1.1.3  christos         return (8);
    307      1.1    jruoho     }
    308      1.1    jruoho }
    309      1.1    jruoho 
    310      1.1    jruoho 
    311      1.1    jruoho /*******************************************************************************
    312      1.1    jruoho  *
    313      1.1    jruoho  * FUNCTION:    OpcDoAccessAs
    314      1.1    jruoho  *
    315      1.1    jruoho  * PARAMETERS:  Op        - Parse node
    316      1.1    jruoho  *
    317      1.1    jruoho  * RETURN:      None
    318      1.1    jruoho  *
    319      1.1    jruoho  * DESCRIPTION: Implement the ACCESS_AS ASL keyword.
    320      1.1    jruoho  *
    321      1.1    jruoho  ******************************************************************************/
    322      1.1    jruoho 
    323      1.1    jruoho static void
    324      1.1    jruoho OpcDoAccessAs (
    325      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    326      1.1    jruoho {
    327  1.1.1.3  christos     ACPI_PARSE_OBJECT       *TypeOp;
    328  1.1.1.3  christos     ACPI_PARSE_OBJECT       *AttribOp;
    329  1.1.1.3  christos     ACPI_PARSE_OBJECT       *LengthOp;
    330  1.1.1.3  christos     UINT8                   Attribute;
    331      1.1    jruoho 
    332      1.1    jruoho 
    333      1.1    jruoho     Op->Asl.AmlOpcodeLength = 1;
    334  1.1.1.3  christos     TypeOp = Op->Asl.Child;
    335      1.1    jruoho 
    336      1.1    jruoho     /* First child is the access type */
    337      1.1    jruoho 
    338  1.1.1.3  christos     TypeOp->Asl.AmlOpcode = AML_RAW_DATA_BYTE;
    339  1.1.1.3  christos     TypeOp->Asl.ParseOpcode = PARSEOP_RAW_DATA;
    340      1.1    jruoho 
    341      1.1    jruoho     /* Second child is the optional access attribute */
    342      1.1    jruoho 
    343  1.1.1.3  christos     AttribOp = TypeOp->Asl.Next;
    344  1.1.1.3  christos     if (AttribOp->Asl.ParseOpcode == PARSEOP_DEFAULT_ARG)
    345  1.1.1.3  christos     {
    346  1.1.1.3  christos         AttribOp->Asl.Value.Integer = 0;
    347  1.1.1.3  christos     }
    348  1.1.1.3  christos     AttribOp->Asl.AmlOpcode = AML_RAW_DATA_BYTE;
    349  1.1.1.3  christos     AttribOp->Asl.ParseOpcode = PARSEOP_RAW_DATA;
    350  1.1.1.3  christos 
    351  1.1.1.3  christos     /* Only a few AccessAttributes support AccessLength */
    352  1.1.1.3  christos 
    353  1.1.1.3  christos     Attribute = (UINT8) AttribOp->Asl.Value.Integer;
    354  1.1.1.3  christos     if ((Attribute != AML_FIELD_ATTRIB_MULTIBYTE) &&
    355  1.1.1.3  christos         (Attribute != AML_FIELD_ATTRIB_RAW_BYTES) &&
    356  1.1.1.3  christos         (Attribute != AML_FIELD_ATTRIB_RAW_PROCESS))
    357  1.1.1.3  christos     {
    358  1.1.1.3  christos         return;
    359  1.1.1.3  christos     }
    360  1.1.1.3  christos 
    361  1.1.1.3  christos     Op->Asl.AmlOpcode = AML_FIELD_EXT_ACCESS_OP;
    362  1.1.1.3  christos 
    363  1.1.1.3  christos     /*
    364  1.1.1.3  christos      * Child of Attributes is the AccessLength (required for Multibyte,
    365  1.1.1.3  christos      * RawBytes, RawProcess.)
    366  1.1.1.3  christos      */
    367  1.1.1.3  christos     LengthOp = AttribOp->Asl.Child;
    368  1.1.1.3  christos     if (!LengthOp)
    369  1.1.1.3  christos     {
    370  1.1.1.3  christos         return;
    371  1.1.1.3  christos     }
    372  1.1.1.3  christos 
    373  1.1.1.3  christos     /* TBD: probably can remove */
    374  1.1.1.3  christos 
    375  1.1.1.3  christos     if (LengthOp->Asl.ParseOpcode == PARSEOP_DEFAULT_ARG)
    376  1.1.1.3  christos     {
    377  1.1.1.3  christos         LengthOp->Asl.Value.Integer = 16;
    378  1.1.1.3  christos     }
    379  1.1.1.3  christos 
    380  1.1.1.3  christos     LengthOp->Asl.AmlOpcode = AML_RAW_DATA_BYTE;
    381  1.1.1.3  christos     LengthOp->Asl.ParseOpcode = PARSEOP_RAW_DATA;
    382  1.1.1.3  christos }
    383  1.1.1.3  christos 
    384  1.1.1.3  christos 
    385  1.1.1.3  christos /*******************************************************************************
    386  1.1.1.3  christos  *
    387  1.1.1.3  christos  * FUNCTION:    OpcDoConnection
    388  1.1.1.3  christos  *
    389  1.1.1.3  christos  * PARAMETERS:  Op        - Parse node
    390  1.1.1.3  christos  *
    391  1.1.1.3  christos  * RETURN:      None
    392  1.1.1.3  christos  *
    393  1.1.1.3  christos  * DESCRIPTION: Implement the Connection ASL keyword.
    394  1.1.1.3  christos  *
    395  1.1.1.3  christos  ******************************************************************************/
    396  1.1.1.3  christos 
    397  1.1.1.3  christos static void
    398  1.1.1.3  christos OpcDoConnection (
    399  1.1.1.3  christos     ACPI_PARSE_OBJECT       *Op)
    400  1.1.1.3  christos {
    401  1.1.1.3  christos     ASL_RESOURCE_NODE       *Rnode;
    402  1.1.1.3  christos     ACPI_PARSE_OBJECT       *BufferOp;
    403  1.1.1.3  christos     ACPI_PARSE_OBJECT       *BufferLengthOp;
    404  1.1.1.3  christos     ACPI_PARSE_OBJECT       *BufferDataOp;
    405  1.1.1.4  christos     ASL_RESOURCE_INFO       Info;
    406  1.1.1.3  christos     UINT8                   State;
    407  1.1.1.3  christos 
    408  1.1.1.3  christos 
    409  1.1.1.3  christos     Op->Asl.AmlOpcodeLength = 1;
    410  1.1.1.3  christos 
    411  1.1.1.3  christos     if (Op->Asl.Child->Asl.AmlOpcode == AML_INT_NAMEPATH_OP)
    412  1.1.1.3  christos     {
    413  1.1.1.3  christos         return;
    414  1.1.1.3  christos     }
    415  1.1.1.3  christos 
    416  1.1.1.3  christos     BufferOp = Op->Asl.Child;
    417  1.1.1.3  christos     BufferLengthOp = BufferOp->Asl.Child;
    418  1.1.1.3  christos     BufferDataOp = BufferLengthOp->Asl.Next;
    419  1.1.1.3  christos 
    420  1.1.1.4  christos     Info.DescriptorTypeOp = BufferDataOp->Asl.Next;
    421  1.1.1.4  christos     Info.CurrentByteOffset = 0;
    422  1.1.1.3  christos     State = ACPI_RSTATE_NORMAL;
    423  1.1.1.4  christos     Rnode = RsDoOneResourceDescriptor (&Info, &State);
    424  1.1.1.3  christos     if (!Rnode)
    425      1.1    jruoho     {
    426  1.1.1.3  christos         return; /* error */
    427      1.1    jruoho     }
    428  1.1.1.3  christos 
    429  1.1.1.3  christos     /*
    430  1.1.1.3  christos      * Transform the nodes into the following
    431  1.1.1.3  christos      *
    432  1.1.1.3  christos      * Op           -> AML_BUFFER_OP
    433  1.1.1.3  christos      * First Child  -> BufferLength
    434  1.1.1.3  christos      * Second Child -> Descriptor Buffer (raw byte data)
    435  1.1.1.3  christos      */
    436  1.1.1.3  christos     BufferOp->Asl.ParseOpcode         = PARSEOP_BUFFER;
    437  1.1.1.3  christos     BufferOp->Asl.AmlOpcode           = AML_BUFFER_OP;
    438  1.1.1.3  christos     BufferOp->Asl.CompileFlags        = NODE_AML_PACKAGE | NODE_IS_RESOURCE_DESC;
    439  1.1.1.3  christos     UtSetParseOpName (BufferOp);
    440  1.1.1.3  christos 
    441  1.1.1.3  christos     BufferLengthOp->Asl.ParseOpcode   = PARSEOP_INTEGER;
    442  1.1.1.3  christos     BufferLengthOp->Asl.Value.Integer = Rnode->BufferLength;
    443  1.1.1.3  christos     (void) OpcSetOptimalIntegerSize (BufferLengthOp);
    444  1.1.1.3  christos     UtSetParseOpName (BufferLengthOp);
    445  1.1.1.3  christos 
    446  1.1.1.3  christos     BufferDataOp->Asl.ParseOpcode         = PARSEOP_RAW_DATA;
    447  1.1.1.3  christos     BufferDataOp->Asl.AmlOpcode           = AML_RAW_DATA_CHAIN;
    448  1.1.1.3  christos     BufferDataOp->Asl.AmlOpcodeLength     = 0;
    449  1.1.1.3  christos     BufferDataOp->Asl.AmlLength           = Rnode->BufferLength;
    450  1.1.1.3  christos     BufferDataOp->Asl.Value.Buffer        = (UINT8 *) Rnode;
    451  1.1.1.3  christos     UtSetParseOpName (BufferDataOp);
    452      1.1    jruoho }
    453      1.1    jruoho 
    454      1.1    jruoho 
    455      1.1    jruoho /*******************************************************************************
    456      1.1    jruoho  *
    457      1.1    jruoho  * FUNCTION:    OpcDoUnicode
    458      1.1    jruoho  *
    459      1.1    jruoho  * PARAMETERS:  Op        - Parse node
    460      1.1    jruoho  *
    461      1.1    jruoho  * RETURN:      None
    462      1.1    jruoho  *
    463      1.1    jruoho  * DESCRIPTION: Implement the UNICODE ASL "macro".  Convert the input string
    464  1.1.1.3  christos  *              to a unicode buffer. There is no Unicode AML opcode.
    465      1.1    jruoho  *
    466      1.1    jruoho  * Note:  The Unicode string is 16 bits per character, no leading signature,
    467      1.1    jruoho  *        with a 16-bit terminating NULL.
    468      1.1    jruoho  *
    469      1.1    jruoho  ******************************************************************************/
    470      1.1    jruoho 
    471      1.1    jruoho static void
    472      1.1    jruoho OpcDoUnicode (
    473      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    474      1.1    jruoho {
    475      1.1    jruoho     ACPI_PARSE_OBJECT       *InitializerOp;
    476      1.1    jruoho     UINT32                  Length;
    477      1.1    jruoho     UINT32                  Count;
    478      1.1    jruoho     UINT32                  i;
    479      1.1    jruoho     UINT8                   *AsciiString;
    480      1.1    jruoho     UINT16                  *UnicodeString;
    481      1.1    jruoho     ACPI_PARSE_OBJECT       *BufferLengthOp;
    482      1.1    jruoho 
    483      1.1    jruoho 
    484      1.1    jruoho     /* Change op into a buffer object */
    485      1.1    jruoho 
    486      1.1    jruoho     Op->Asl.CompileFlags &= ~NODE_COMPILE_TIME_CONST;
    487      1.1    jruoho     Op->Asl.ParseOpcode = PARSEOP_BUFFER;
    488      1.1    jruoho     UtSetParseOpName (Op);
    489      1.1    jruoho 
    490      1.1    jruoho     /* Buffer Length is first, followed by the string */
    491      1.1    jruoho 
    492      1.1    jruoho     BufferLengthOp = Op->Asl.Child;
    493      1.1    jruoho     InitializerOp = BufferLengthOp->Asl.Next;
    494      1.1    jruoho 
    495      1.1    jruoho     AsciiString = (UINT8 *) InitializerOp->Asl.Value.String;
    496      1.1    jruoho 
    497      1.1    jruoho     /* Create a new buffer for the Unicode string */
    498      1.1    jruoho 
    499      1.1    jruoho     Count = strlen (InitializerOp->Asl.Value.String) + 1;
    500      1.1    jruoho     Length = Count * sizeof (UINT16);
    501      1.1    jruoho     UnicodeString = UtLocalCalloc (Length);
    502      1.1    jruoho 
    503      1.1    jruoho     /* Convert to Unicode string (including null terminator) */
    504      1.1    jruoho 
    505      1.1    jruoho     for (i = 0; i < Count; i++)
    506      1.1    jruoho     {
    507      1.1    jruoho         UnicodeString[i] = (UINT16) AsciiString[i];
    508      1.1    jruoho     }
    509      1.1    jruoho 
    510      1.1    jruoho     /*
    511      1.1    jruoho      * Just set the buffer size node to be the buffer length, regardless
    512      1.1    jruoho      * of whether it was previously an integer or a default_arg placeholder
    513      1.1    jruoho      */
    514      1.1    jruoho     BufferLengthOp->Asl.ParseOpcode   = PARSEOP_INTEGER;
    515      1.1    jruoho     BufferLengthOp->Asl.AmlOpcode     = AML_DWORD_OP;
    516      1.1    jruoho     BufferLengthOp->Asl.Value.Integer = Length;
    517      1.1    jruoho     UtSetParseOpName (BufferLengthOp);
    518      1.1    jruoho 
    519      1.1    jruoho     (void) OpcSetOptimalIntegerSize (BufferLengthOp);
    520      1.1    jruoho 
    521      1.1    jruoho     /* The Unicode string is a raw data buffer */
    522      1.1    jruoho 
    523      1.1    jruoho     InitializerOp->Asl.Value.Buffer   = (UINT8 *) UnicodeString;
    524      1.1    jruoho     InitializerOp->Asl.AmlOpcode      = AML_RAW_DATA_BUFFER;
    525      1.1    jruoho     InitializerOp->Asl.AmlLength      = Length;
    526      1.1    jruoho     InitializerOp->Asl.ParseOpcode    = PARSEOP_RAW_DATA;
    527      1.1    jruoho     InitializerOp->Asl.Child          = NULL;
    528      1.1    jruoho     UtSetParseOpName (InitializerOp);
    529      1.1    jruoho }
    530      1.1    jruoho 
    531      1.1    jruoho 
    532      1.1    jruoho /*******************************************************************************
    533      1.1    jruoho  *
    534      1.1    jruoho  * FUNCTION:    OpcDoEisaId
    535      1.1    jruoho  *
    536      1.1    jruoho  * PARAMETERS:  Op        - Parse node
    537      1.1    jruoho  *
    538      1.1    jruoho  * RETURN:      None
    539      1.1    jruoho  *
    540  1.1.1.3  christos  * DESCRIPTION: Convert a string EISA ID to numeric representation. See the
    541  1.1.1.3  christos  *              Pnp BIOS Specification for details. Here is an excerpt:
    542      1.1    jruoho  *
    543      1.1    jruoho  *              A seven character ASCII representation of the product
    544  1.1.1.3  christos  *              identifier compressed into a 32-bit identifier. The seven
    545      1.1    jruoho  *              character ID consists of a three character manufacturer code,
    546      1.1    jruoho  *              a three character hexadecimal product identifier, and a one
    547  1.1.1.3  christos  *              character hexadecimal revision number. The manufacturer code
    548      1.1    jruoho  *              is a 3 uppercase character code that is compressed into 3 5-bit
    549      1.1    jruoho  *              values as follows:
    550      1.1    jruoho  *                  1) Find hex ASCII value for each letter
    551      1.1    jruoho  *                  2) Subtract 40h from each ASCII value
    552  1.1.1.3  christos  *                  3) Retain 5 least significant bits for each letter by
    553      1.1    jruoho  *                     discarding upper 3 bits because they are always 0.
    554      1.1    jruoho  *                  4) Compressed code = concatenate 0 and the 3 5-bit values
    555      1.1    jruoho  *
    556      1.1    jruoho  *              The format of the compressed product identifier is as follows:
    557      1.1    jruoho  *              Byte 0: Bit 7       - Reserved (0)
    558      1.1    jruoho  *                      Bits 6-2:   - 1st character of compressed mfg code
    559      1.1    jruoho  *                      Bits 1-0    - Upper 2 bits of 2nd character of mfg code
    560      1.1    jruoho  *              Byte 1: Bits 7-5    - Lower 3 bits of 2nd character of mfg code
    561      1.1    jruoho  *                      Bits 4-0    - 3rd character of mfg code
    562      1.1    jruoho  *              Byte 2: Bits 7-4    - 1st hex digit of product number
    563      1.1    jruoho  *                      Bits 3-0    - 2nd hex digit of product number
    564      1.1    jruoho  *              Byte 3: Bits 7-4    - 3st hex digit of product number
    565      1.1    jruoho  *                      Bits 3-0    - Hex digit of the revision number
    566      1.1    jruoho  *
    567      1.1    jruoho  ******************************************************************************/
    568      1.1    jruoho 
    569      1.1    jruoho static void
    570      1.1    jruoho OpcDoEisaId (
    571      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    572      1.1    jruoho {
    573      1.1    jruoho     UINT32                  EisaId = 0;
    574      1.1    jruoho     UINT32                  BigEndianId;
    575      1.1    jruoho     char                    *InString;
    576      1.1    jruoho     ACPI_STATUS             Status = AE_OK;
    577      1.1    jruoho     UINT32                  i;
    578      1.1    jruoho 
    579      1.1    jruoho 
    580      1.1    jruoho     InString = (char *) Op->Asl.Value.String;
    581      1.1    jruoho 
    582      1.1    jruoho     /*
    583      1.1    jruoho      * The EISAID string must be exactly 7 characters and of the form
    584      1.1    jruoho      * "UUUXXXX" -- 3 uppercase letters and 4 hex digits (e.g., "PNP0001")
    585      1.1    jruoho      */
    586      1.1    jruoho     if (ACPI_STRLEN (InString) != 7)
    587      1.1    jruoho     {
    588      1.1    jruoho         Status = AE_BAD_PARAMETER;
    589      1.1    jruoho     }
    590      1.1    jruoho     else
    591      1.1    jruoho     {
    592      1.1    jruoho         /* Check all 7 characters for correct format */
    593      1.1    jruoho 
    594      1.1    jruoho         for (i = 0; i < 7; i++)
    595      1.1    jruoho         {
    596      1.1    jruoho             /* First 3 characters must be uppercase letters */
    597      1.1    jruoho 
    598      1.1    jruoho             if (i < 3)
    599      1.1    jruoho             {
    600      1.1    jruoho                 if (!isupper ((int) InString[i]))
    601      1.1    jruoho                 {
    602      1.1    jruoho                     Status = AE_BAD_PARAMETER;
    603      1.1    jruoho                 }
    604      1.1    jruoho             }
    605      1.1    jruoho 
    606      1.1    jruoho             /* Last 4 characters must be hex digits */
    607      1.1    jruoho 
    608      1.1    jruoho             else if (!isxdigit ((int) InString[i]))
    609      1.1    jruoho             {
    610      1.1    jruoho                 Status = AE_BAD_PARAMETER;
    611      1.1    jruoho             }
    612      1.1    jruoho         }
    613      1.1    jruoho     }
    614      1.1    jruoho 
    615      1.1    jruoho     if (ACPI_FAILURE (Status))
    616      1.1    jruoho     {
    617      1.1    jruoho         AslError (ASL_ERROR, ASL_MSG_INVALID_EISAID, Op, Op->Asl.Value.String);
    618      1.1    jruoho     }
    619      1.1    jruoho     else
    620      1.1    jruoho     {
    621      1.1    jruoho         /* Create ID big-endian first (bits are contiguous) */
    622      1.1    jruoho 
    623      1.1    jruoho         BigEndianId =
    624  1.1.1.2    jruoho             (UINT32) ((UINT8) (InString[0] - 0x40)) << 26 |
    625  1.1.1.2    jruoho             (UINT32) ((UINT8) (InString[1] - 0x40)) << 21 |
    626  1.1.1.2    jruoho             (UINT32) ((UINT8) (InString[2] - 0x40)) << 16 |
    627      1.1    jruoho 
    628  1.1.1.4  christos             (AcpiUtAsciiCharToHex (InString[3])) << 12 |
    629  1.1.1.4  christos             (AcpiUtAsciiCharToHex (InString[4])) << 8  |
    630  1.1.1.4  christos             (AcpiUtAsciiCharToHex (InString[5])) << 4  |
    631  1.1.1.4  christos              AcpiUtAsciiCharToHex (InString[6]);
    632      1.1    jruoho 
    633      1.1    jruoho         /* Swap to little-endian to get final ID (see function header) */
    634      1.1    jruoho 
    635      1.1    jruoho         EisaId = AcpiUtDwordByteSwap (BigEndianId);
    636      1.1    jruoho     }
    637      1.1    jruoho 
    638      1.1    jruoho     /*
    639      1.1    jruoho      * Morph the Op into an integer, regardless of whether there
    640      1.1    jruoho      * was an error in the EISAID string
    641      1.1    jruoho      */
    642      1.1    jruoho     Op->Asl.Value.Integer = EisaId;
    643      1.1    jruoho 
    644      1.1    jruoho     Op->Asl.CompileFlags &= ~NODE_COMPILE_TIME_CONST;
    645      1.1    jruoho     Op->Asl.ParseOpcode = PARSEOP_INTEGER;
    646      1.1    jruoho     (void) OpcSetOptimalIntegerSize (Op);
    647      1.1    jruoho 
    648      1.1    jruoho     /* Op is now an integer */
    649      1.1    jruoho 
    650      1.1    jruoho     UtSetParseOpName (Op);
    651      1.1    jruoho }
    652      1.1    jruoho 
    653      1.1    jruoho 
    654      1.1    jruoho /*******************************************************************************
    655      1.1    jruoho  *
    656  1.1.1.3  christos  * FUNCTION:    OpcDoUuId
    657      1.1    jruoho  *
    658      1.1    jruoho  * PARAMETERS:  Op        - Parse node
    659      1.1    jruoho  *
    660      1.1    jruoho  * RETURN:      None
    661      1.1    jruoho  *
    662      1.1    jruoho  * DESCRIPTION: Convert UUID string to 16-byte buffer
    663      1.1    jruoho  *
    664      1.1    jruoho  ******************************************************************************/
    665      1.1    jruoho 
    666      1.1    jruoho static void
    667      1.1    jruoho OpcDoUuId (
    668      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    669      1.1    jruoho {
    670      1.1    jruoho     char                    *InString;
    671  1.1.1.4  christos     UINT8                   *Buffer;
    672      1.1    jruoho     ACPI_STATUS             Status = AE_OK;
    673      1.1    jruoho     ACPI_PARSE_OBJECT       *NewOp;
    674      1.1    jruoho 
    675      1.1    jruoho 
    676      1.1    jruoho     InString = (char *) Op->Asl.Value.String;
    677      1.1    jruoho     Buffer = UtLocalCalloc (16);
    678      1.1    jruoho 
    679  1.1.1.2    jruoho     Status = AuValidateUuid (InString);
    680      1.1    jruoho     if (ACPI_FAILURE (Status))
    681      1.1    jruoho     {
    682      1.1    jruoho         AslError (ASL_ERROR, ASL_MSG_INVALID_UUID, Op, Op->Asl.Value.String);
    683      1.1    jruoho     }
    684  1.1.1.2    jruoho     else
    685      1.1    jruoho     {
    686  1.1.1.4  christos         AcpiUtConvertStringToUuid (InString, Buffer);
    687      1.1    jruoho     }
    688      1.1    jruoho 
    689      1.1    jruoho     /* Change Op to a Buffer */
    690      1.1    jruoho 
    691      1.1    jruoho     Op->Asl.ParseOpcode = PARSEOP_BUFFER;
    692      1.1    jruoho     Op->Common.AmlOpcode = AML_BUFFER_OP;
    693      1.1    jruoho 
    694      1.1    jruoho     /* Disable further optimization */
    695      1.1    jruoho 
    696      1.1    jruoho     Op->Asl.CompileFlags &= ~NODE_COMPILE_TIME_CONST;
    697      1.1    jruoho     UtSetParseOpName (Op);
    698      1.1    jruoho 
    699      1.1    jruoho     /* Child node is the buffer length */
    700      1.1    jruoho 
    701      1.1    jruoho     NewOp = TrAllocateNode (PARSEOP_INTEGER);
    702      1.1    jruoho 
    703      1.1    jruoho     NewOp->Asl.AmlOpcode     = AML_BYTE_OP;
    704      1.1    jruoho     NewOp->Asl.Value.Integer = 16;
    705      1.1    jruoho     NewOp->Asl.Parent        = Op;
    706      1.1    jruoho 
    707      1.1    jruoho     Op->Asl.Child = NewOp;
    708      1.1    jruoho     Op = NewOp;
    709      1.1    jruoho 
    710      1.1    jruoho     /* Peer to the child is the raw buffer data */
    711      1.1    jruoho 
    712      1.1    jruoho     NewOp = TrAllocateNode (PARSEOP_RAW_DATA);
    713      1.1    jruoho     NewOp->Asl.AmlOpcode     = AML_RAW_DATA_BUFFER;
    714      1.1    jruoho     NewOp->Asl.AmlLength     = 16;
    715      1.1    jruoho     NewOp->Asl.Value.String  = (char *) Buffer;
    716      1.1    jruoho     NewOp->Asl.Parent        = Op->Asl.Parent;
    717      1.1    jruoho 
    718      1.1    jruoho     Op->Asl.Next = NewOp;
    719      1.1    jruoho }
    720      1.1    jruoho 
    721      1.1    jruoho 
    722      1.1    jruoho /*******************************************************************************
    723      1.1    jruoho  *
    724      1.1    jruoho  * FUNCTION:    OpcGenerateAmlOpcode
    725      1.1    jruoho  *
    726      1.1    jruoho  * PARAMETERS:  Op        - Parse node
    727      1.1    jruoho  *
    728      1.1    jruoho  * RETURN:      None
    729      1.1    jruoho  *
    730      1.1    jruoho  * DESCRIPTION: Generate the AML opcode associated with the node and its
    731  1.1.1.3  christos  *              parse (lex/flex) keyword opcode. Essentially implements
    732      1.1    jruoho  *              a mapping between the parse opcodes and the actual AML opcodes.
    733      1.1    jruoho  *
    734      1.1    jruoho  ******************************************************************************/
    735      1.1    jruoho 
    736      1.1    jruoho void
    737      1.1    jruoho OpcGenerateAmlOpcode (
    738      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    739      1.1    jruoho {
    740      1.1    jruoho 
    741      1.1    jruoho     UINT16                  Index;
    742      1.1    jruoho 
    743      1.1    jruoho 
    744      1.1    jruoho     Index = (UINT16) (Op->Asl.ParseOpcode - ASL_PARSE_OPCODE_BASE);
    745      1.1    jruoho 
    746      1.1    jruoho     Op->Asl.AmlOpcode     = AslKeywordMapping[Index].AmlOpcode;
    747      1.1    jruoho     Op->Asl.AcpiBtype     = AslKeywordMapping[Index].AcpiBtype;
    748      1.1    jruoho     Op->Asl.CompileFlags |= AslKeywordMapping[Index].Flags;
    749      1.1    jruoho 
    750      1.1    jruoho     if (!Op->Asl.Value.Integer)
    751      1.1    jruoho     {
    752      1.1    jruoho         Op->Asl.Value.Integer = AslKeywordMapping[Index].Value;
    753      1.1    jruoho     }
    754      1.1    jruoho 
    755      1.1    jruoho     /* Special handling for some opcodes */
    756      1.1    jruoho 
    757      1.1    jruoho     switch (Op->Asl.ParseOpcode)
    758      1.1    jruoho     {
    759      1.1    jruoho     case PARSEOP_INTEGER:
    760      1.1    jruoho         /*
    761      1.1    jruoho          * Set the opcode based on the size of the integer
    762      1.1    jruoho          */
    763      1.1    jruoho         (void) OpcSetOptimalIntegerSize (Op);
    764      1.1    jruoho         break;
    765      1.1    jruoho 
    766      1.1    jruoho     case PARSEOP_OFFSET:
    767      1.1    jruoho 
    768      1.1    jruoho         Op->Asl.AmlOpcodeLength = 1;
    769      1.1    jruoho         break;
    770      1.1    jruoho 
    771      1.1    jruoho     case PARSEOP_ACCESSAS:
    772      1.1    jruoho 
    773      1.1    jruoho         OpcDoAccessAs (Op);
    774      1.1    jruoho         break;
    775      1.1    jruoho 
    776  1.1.1.3  christos     case PARSEOP_CONNECTION:
    777  1.1.1.3  christos 
    778  1.1.1.3  christos         OpcDoConnection (Op);
    779  1.1.1.3  christos         break;
    780  1.1.1.3  christos 
    781      1.1    jruoho     case PARSEOP_EISAID:
    782      1.1    jruoho 
    783      1.1    jruoho         OpcDoEisaId (Op);
    784      1.1    jruoho         break;
    785      1.1    jruoho 
    786      1.1    jruoho     case PARSEOP_TOUUID:
    787      1.1    jruoho 
    788      1.1    jruoho         OpcDoUuId (Op);
    789      1.1    jruoho         break;
    790      1.1    jruoho 
    791      1.1    jruoho     case PARSEOP_UNICODE:
    792      1.1    jruoho 
    793      1.1    jruoho         OpcDoUnicode (Op);
    794      1.1    jruoho         break;
    795      1.1    jruoho 
    796      1.1    jruoho     case PARSEOP_INCLUDE:
    797      1.1    jruoho 
    798      1.1    jruoho         Op->Asl.Child->Asl.ParseOpcode = PARSEOP_DEFAULT_ARG;
    799      1.1    jruoho         Gbl_HasIncludeFiles = TRUE;
    800      1.1    jruoho         break;
    801      1.1    jruoho 
    802      1.1    jruoho     case PARSEOP_EXTERNAL:
    803      1.1    jruoho 
    804      1.1    jruoho         Op->Asl.Child->Asl.ParseOpcode = PARSEOP_DEFAULT_ARG;
    805      1.1    jruoho         Op->Asl.Child->Asl.Next->Asl.ParseOpcode = PARSEOP_DEFAULT_ARG;
    806      1.1    jruoho         break;
    807      1.1    jruoho 
    808  1.1.1.3  christos     case PARSEOP_TIMER:
    809  1.1.1.3  christos 
    810  1.1.1.3  christos         if (AcpiGbl_IntegerBitWidth == 32)
    811  1.1.1.3  christos         {
    812  1.1.1.3  christos             AslError (ASL_REMARK, ASL_MSG_TRUNCATION, Op, NULL);
    813  1.1.1.3  christos         }
    814  1.1.1.3  christos         break;
    815  1.1.1.3  christos 
    816      1.1    jruoho     default:
    817  1.1.1.3  christos 
    818      1.1    jruoho         /* Nothing to do for other opcodes */
    819  1.1.1.3  christos 
    820      1.1    jruoho         break;
    821      1.1    jruoho     }
    822      1.1    jruoho 
    823      1.1    jruoho     return;
    824      1.1    jruoho }
    825