drivers/acpi/acpica/dsfield.c

   1 /******************************************************************************
   2  *
   3  * Module Name: dsfield - Dispatcher field routines
   4  *
   5  *****************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2013, 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 <acpi/acpi.h>
  45 #include "accommon.h"
  46 #include "amlcode.h"
  47 #include "acdispat.h"
  48 #include "acinterp.h"
  49 #include "acnamesp.h"
  50 #include "acparser.h"
  51
  52 #define _COMPONENT          ACPI_DISPATCHER
  53 ACPI_MODULE_NAME("dsfield")
  54
  55 /* Local prototypes */
  56 #ifdef ACPI_ASL_COMPILER
  57 #include "acdisasm.h"
  58 static acpi_status
  59 acpi_ds_create_external_region(acpi_status lookup_status,
  60                                union acpi_parse_object *op,
  61                                char *path,
  62                                struct acpi_walk_state *walk_state,
  63                                struct acpi_namespace_node **node);
  64 #endif
  65
  66 static acpi_status
  67 acpi_ds_get_field_names(struct acpi_create_field_info *info,
  68                         struct acpi_walk_state *walk_state,
  69                         union acpi_parse_object *arg);
  70
  71 #ifdef ACPI_ASL_COMPILER
  72 /*******************************************************************************
  73  *
  74  * FUNCTION:    acpi_ds_create_external_region (iASL Disassembler only)
  75  *
  76  * PARAMETERS:  lookup_status   - Status from ns_lookup operation
  77  *              op              - Op containing the Field definition and args
  78  *              path            - Pathname of the region
  79  *  `           walk_state      - Current method state
  80  *              node            - Where the new region node is returned
  81  *
  82  * RETURN:      Status
  83  *
  84  * DESCRIPTION: Add region to the external list if NOT_FOUND. Create a new
  85  *              region node/object.
  86  *
  87  ******************************************************************************/
  88
  89 static acpi_status
  90 acpi_ds_create_external_region(acpi_status lookup_status,
  91                                union acpi_parse_object *op,
  92                                char *path,
  93                                struct acpi_walk_state *walk_state,
  94                                struct acpi_namespace_node **node)
  95 {
  96         acpi_status status;
  97         union acpi_operand_object *obj_desc;
  98
  99         if (lookup_status != AE_NOT_FOUND) {
 100                 return (lookup_status);
 101         }
 102
 103         /*
 104          * Table disassembly:
 105          * operation_region not found. Generate an External for it, and
 106          * insert the name into the namespace.
 107          */
 108         acpi_dm_add_to_external_list(op, path, ACPI_TYPE_REGION, 0);
 109         status = acpi_ns_lookup(walk_state->scope_info, path, ACPI_TYPE_REGION,
 110                                 ACPI_IMODE_LOAD_PASS1, ACPI_NS_SEARCH_PARENT,
 111                                 walk_state, node);
 112         if (ACPI_FAILURE(status)) {
 113                 return (status);
 114         }
 115
 116         /* Must create and install a region object for the new node */
 117
 118         obj_desc = acpi_ut_create_internal_object(ACPI_TYPE_REGION);
 119         if (!obj_desc) {
 120                 return (AE_NO_MEMORY);
 121         }
 122
 123         obj_desc->region.node = *node;
 124         status = acpi_ns_attach_object(*node, obj_desc, ACPI_TYPE_REGION);
 125         return (status);
 126 }
 127 #endif
 128
 129 /*******************************************************************************
 130  *
 131  * FUNCTION:    acpi_ds_create_buffer_field
 132  *
 133  * PARAMETERS:  op                  - Current parse op (create_XXField)
 134  *              walk_state          - Current state
 135  *
 136  * RETURN:      Status
 137  *
 138  * DESCRIPTION: Execute the create_field operators:
 139  *              create_bit_field_op,
 140  *              create_byte_field_op,
 141  *              create_word_field_op,
 142  *              create_dword_field_op,
 143  *              create_qword_field_op,
 144  *              create_field_op     (all of which define a field in a buffer)
 145  *
 146  ******************************************************************************/
 147
 148 acpi_status
 149 acpi_ds_create_buffer_field(union acpi_parse_object *op,
 150                             struct acpi_walk_state *walk_state)
 151 {
 152         union acpi_parse_object *arg;
 153         struct acpi_namespace_node *node;
 154         acpi_status status;
 155         union acpi_operand_object *obj_desc;
 156         union acpi_operand_object *second_desc = NULL;
 157         u32 flags;
 158
 159         ACPI_FUNCTION_TRACE(ds_create_buffer_field);
 160
 161         /*
 162          * Get the name_string argument (name of the new buffer_field)
 163          */
 164         if (op->common.aml_opcode == AML_CREATE_FIELD_OP) {
 165
 166                 /* For create_field, name is the 4th argument */
 167
 168                 arg = acpi_ps_get_arg(op, 3);
 169         } else {
 170                 /* For all other create_XXXField operators, name is the 3rd argument */
 171
 172                 arg = acpi_ps_get_arg(op, 2);
 173         }
 174
 175         if (!arg) {
 176                 return_ACPI_STATUS(AE_AML_NO_OPERAND);
 177         }
 178
 179         if (walk_state->deferred_node) {
 180                 node = walk_state->deferred_node;
 181                 status = AE_OK;
 182         } else {
 183                 /* Execute flag should always be set when this function is entered */
 184
 185                 if (!(walk_state->parse_flags & ACPI_PARSE_EXECUTE)) {
 186                         return_ACPI_STATUS(AE_AML_INTERNAL);
 187                 }
 188
 189                 /* Creating new namespace node, should not already exist */
 190
 191                 flags = ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE |
 192                     ACPI_NS_ERROR_IF_FOUND;
 193
 194                 /*
 195                  * Mark node temporary if we are executing a normal control
 196                  * method. (Don't mark if this is a module-level code method)
 197                  */
 198                 if (walk_state->method_node &&
 199                     !(walk_state->parse_flags & ACPI_PARSE_MODULE_LEVEL)) {
 200                         flags |= ACPI_NS_TEMPORARY;
 201                 }
 202
 203                 /* Enter the name_string into the namespace */
 204
 205                 status =
 206                     acpi_ns_lookup(walk_state->scope_info,
 207                                    arg->common.value.string, ACPI_TYPE_ANY,
 208                                    ACPI_IMODE_LOAD_PASS1, flags, walk_state,
 209                                    &node);
 210                 if (ACPI_FAILURE(status)) {
 211                         ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 212                         return_ACPI_STATUS(status);
 213                 }
 214         }
 215
 216         /*
 217          * We could put the returned object (Node) on the object stack for later,
 218          * but for now, we will put it in the "op" object that the parser uses,
 219          * so we can get it again at the end of this scope.
 220          */
 221         op->common.node = node;
 222
 223         /*
 224          * If there is no object attached to the node, this node was just created
 225          * and we need to create the field object. Otherwise, this was a lookup
 226          * of an existing node and we don't want to create the field object again.
 227          */
 228         obj_desc = acpi_ns_get_attached_object(node);
 229         if (obj_desc) {
 230                 return_ACPI_STATUS(AE_OK);
 231         }
 232
 233         /*
 234          * The Field definition is not fully parsed at this time.
 235          * (We must save the address of the AML for the buffer and index operands)
 236          */
 237
 238         /* Create the buffer field object */
 239
 240         obj_desc = acpi_ut_create_internal_object(ACPI_TYPE_BUFFER_FIELD);
 241         if (!obj_desc) {
 242                 status = AE_NO_MEMORY;
 243                 goto cleanup;
 244         }
 245
 246         /*
 247          * Remember location in AML stream of the field unit opcode and operands --
 248          * since the buffer and index operands must be evaluated.
 249          */
 250         second_desc = obj_desc->common.next_object;
 251         second_desc->extra.aml_start = op->named.data;
 252         second_desc->extra.aml_length = op->named.length;
 253         obj_desc->buffer_field.node = node;
 254
 255         /* Attach constructed field descriptors to parent node */
 256
 257         status = acpi_ns_attach_object(node, obj_desc, ACPI_TYPE_BUFFER_FIELD);
 258         if (ACPI_FAILURE(status)) {
 259                 goto cleanup;
 260         }
 261
 262       cleanup:
 263
 264         /* Remove local reference to the object */
 265
 266         acpi_ut_remove_reference(obj_desc);
 267         return_ACPI_STATUS(status);
 268 }
 269
 270 /*******************************************************************************
 271  *
 272  * FUNCTION:    acpi_ds_get_field_names
 273  *
 274  * PARAMETERS:  info            - create_field info structure
 275  *  `           walk_state      - Current method state
 276  *              arg             - First parser arg for the field name list
 277  *
 278  * RETURN:      Status
 279  *
 280  * DESCRIPTION: Process all named fields in a field declaration. Names are
 281  *              entered into the namespace.
 282  *
 283  ******************************************************************************/
 284
 285 static acpi_status
 286 acpi_ds_get_field_names(struct acpi_create_field_info *info,
 287                         struct acpi_walk_state *walk_state,
 288                         union acpi_parse_object *arg)
 289 {
 290         acpi_status status;
 291         u64 position;
 292         union acpi_parse_object *child;
 293
 294         ACPI_FUNCTION_TRACE_PTR(ds_get_field_names, info);
 295
 296         /* First field starts at bit zero */
 297
 298         info->field_bit_position = 0;
 299
 300         /* Process all elements in the field list (of parse nodes) */
 301
 302         while (arg) {
 303                 /*
 304                  * Four types of field elements are handled:
 305                  * 1) name - Enters a new named field into the namespace
 306                  * 2) offset - specifies a bit offset
 307                  * 3) access_as - changes the access mode/attributes
 308                  * 4) connection - Associate a resource template with the field
 309                  */
 310                 switch (arg->common.aml_opcode) {
 311                 case AML_INT_RESERVEDFIELD_OP:
 312
 313                         position = (u64) info->field_bit_position
 314                             + (u64) arg->common.value.size;
 315
 316                         if (position > ACPI_UINT32_MAX) {
 317                                 ACPI_ERROR((AE_INFO,
 318                                             "Bit offset within field too large (> 0xFFFFFFFF)"));
 319                                 return_ACPI_STATUS(AE_SUPPORT);
 320                         }
 321
 322                         info->field_bit_position = (u32) position;
 323                         break;
 324
 325                 case AML_INT_ACCESSFIELD_OP:
 326                 case AML_INT_EXTACCESSFIELD_OP:
 327                         /*
 328                          * Get new access_type, access_attribute, and access_length fields
 329                          * -- to be used for all field units that follow, until the
 330                          * end-of-field or another access_as keyword is encountered.
 331                          * NOTE. These three bytes are encoded in the integer value
 332                          * of the parseop for convenience.
 333                          *
 334                          * In field_flags, preserve the flag bits other than the
 335                          * ACCESS_TYPE bits.
 336                          */
 337
 338                         /* access_type (byte_acc, word_acc, etc.) */
 339
 340                         info->field_flags = (u8)
 341                             ((info->
 342                               field_flags & ~(AML_FIELD_ACCESS_TYPE_MASK)) |
 343                              ((u8)((u32)(arg->common.value.integer & 0x07))));
 344
 345                         /* access_attribute (attrib_quick, attrib_byte, etc.) */
 346
 347                         info->attribute =
 348                             (u8)((arg->common.value.integer >> 8) & 0xFF);
 349
 350                         /* access_length (for serial/buffer protocols) */
 351
 352                         info->access_length =
 353                             (u8)((arg->common.value.integer >> 16) & 0xFF);
 354                         break;
 355
 356                 case AML_INT_CONNECTION_OP:
 357                         /*
 358                          * Clear any previous connection. New connection is used for all
 359                          * fields that follow, similar to access_as
 360                          */
 361                         info->resource_buffer = NULL;
 362                         info->connection_node = NULL;
 363                         info->pin_number_index = 0;
 364
 365                         /*
 366                          * A Connection() is either an actual resource descriptor (buffer)
 367                          * or a named reference to a resource template
 368                          */
 369                         child = arg->common.value.arg;
 370                         if (child->common.aml_opcode == AML_INT_BYTELIST_OP) {
 371                                 info->resource_buffer = child->named.data;
 372                                 info->resource_length =
 373                                     (u16)child->named.value.integer;
 374                         } else {
 375                                 /* Lookup the Connection() namepath, it should already exist */
 376
 377                                 status = acpi_ns_lookup(walk_state->scope_info,
 378                                                         child->common.value.
 379                                                         name, ACPI_TYPE_ANY,
 380                                                         ACPI_IMODE_EXECUTE,
 381                                                         ACPI_NS_DONT_OPEN_SCOPE,
 382                                                         walk_state,
 383                                                         &info->connection_node);
 384                                 if (ACPI_FAILURE(status)) {
 385                                         ACPI_ERROR_NAMESPACE(child->common.
 386                                                              value.name,
 387                                                              status);
 388                                         return_ACPI_STATUS(status);
 389                                 }
 390                         }
 391                         break;
 392
 393                 case AML_INT_NAMEDFIELD_OP:
 394
 395                         /* Lookup the name, it should already exist */
 396
 397                         status = acpi_ns_lookup(walk_state->scope_info,
 398                                                 (char *)&arg->named.name,
 399                                                 info->field_type,
 400                                                 ACPI_IMODE_EXECUTE,
 401                                                 ACPI_NS_DONT_OPEN_SCOPE,
 402                                                 walk_state, &info->field_node);
 403                         if (ACPI_FAILURE(status)) {
 404                                 ACPI_ERROR_NAMESPACE((char *)&arg->named.name,
 405                                                      status);
 406                                 return_ACPI_STATUS(status);
 407                         } else {
 408                                 arg->common.node = info->field_node;
 409                                 info->field_bit_length = arg->common.value.size;
 410
 411                                 /*
 412                                  * If there is no object attached to the node, this node was
 413                                  * just created and we need to create the field object.
 414                                  * Otherwise, this was a lookup of an existing node and we
 415                                  * don't want to create the field object again.
 416                                  */
 417                                 if (!acpi_ns_get_attached_object
 418                                     (info->field_node)) {
 419                                         status = acpi_ex_prep_field_value(info);
 420                                         if (ACPI_FAILURE(status)) {
 421                                                 return_ACPI_STATUS(status);
 422                                         }
 423                                 }
 424                         }
 425
 426                         /* Keep track of bit position for the next field */
 427
 428                         position = (u64) info->field_bit_position
 429                             + (u64) arg->common.value.size;
 430
 431                         if (position > ACPI_UINT32_MAX) {
 432                                 ACPI_ERROR((AE_INFO,
 433                                             "Field [%4.4s] bit offset too large (> 0xFFFFFFFF)",
 434                                             ACPI_CAST_PTR(char,
 435                                                           &info->field_node->
 436                                                           name)));
 437                                 return_ACPI_STATUS(AE_SUPPORT);
 438                         }
 439
 440                         info->field_bit_position += info->field_bit_length;
 441                         info->pin_number_index++;       /* Index relative to previous Connection() */
 442                         break;
 443
 444                 default:
 445
 446                         ACPI_ERROR((AE_INFO,
 447                                     "Invalid opcode in field list: 0x%X",
 448                                     arg->common.aml_opcode));
 449                         return_ACPI_STATUS(AE_AML_BAD_OPCODE);
 450                 }
 451
 452                 arg = arg->common.next;
 453         }
 454
 455         return_ACPI_STATUS(AE_OK);
 456 }
 457
 458 /*******************************************************************************
 459  *
 460  * FUNCTION:    acpi_ds_create_field
 461  *
 462  * PARAMETERS:  op              - Op containing the Field definition and args
 463  *              region_node     - Object for the containing Operation Region
 464  *  `           walk_state      - Current method state
 465  *
 466  * RETURN:      Status
 467  *
 468  * DESCRIPTION: Create a new field in the specified operation region
 469  *
 470  ******************************************************************************/
 471
 472 acpi_status
 473 acpi_ds_create_field(union acpi_parse_object *op,
 474                      struct acpi_namespace_node *region_node,
 475                      struct acpi_walk_state *walk_state)
 476 {
 477         acpi_status status;
 478         union acpi_parse_object *arg;
 479         struct acpi_create_field_info info;
 480
 481         ACPI_FUNCTION_TRACE_PTR(ds_create_field, op);
 482
 483         /* First arg is the name of the parent op_region (must already exist) */
 484
 485         arg = op->common.value.arg;
 486
 487         if (!region_node) {
 488                 status =
 489                     acpi_ns_lookup(walk_state->scope_info,
 490                                    arg->common.value.name, ACPI_TYPE_REGION,
 491                                    ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
 492                                    walk_state, &region_node);
 493 #ifdef ACPI_ASL_COMPILER
 494                 status = acpi_ds_create_external_region(status, arg,
 495                                                         arg->common.value.name,
 496                                                         walk_state,
 497                                                         &region_node);
 498 #endif
 499                 if (ACPI_FAILURE(status)) {
 500                         ACPI_ERROR_NAMESPACE(arg->common.value.name, status);
 501                         return_ACPI_STATUS(status);
 502                 }
 503         }
 504
 505         ACPI_MEMSET(&info, 0, sizeof(struct acpi_create_field_info));
 506
 507         /* Second arg is the field flags */
 508
 509         arg = arg->common.next;
 510         info.field_flags = (u8) arg->common.value.integer;
 511         info.attribute = 0;
 512
 513         /* Each remaining arg is a Named Field */
 514
 515         info.field_type = ACPI_TYPE_LOCAL_REGION_FIELD;
 516         info.region_node = region_node;
 517
 518         status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
 519         return_ACPI_STATUS(status);
 520 }
 521
 522 /*******************************************************************************
 523  *
 524  * FUNCTION:    acpi_ds_init_field_objects
 525  *
 526  * PARAMETERS:  op              - Op containing the Field definition and args
 527  *  `           walk_state      - Current method state
 528  *
 529  * RETURN:      Status
 530  *
 531  * DESCRIPTION: For each "Field Unit" name in the argument list that is
 532  *              part of the field declaration, enter the name into the
 533  *              namespace.
 534  *
 535  ******************************************************************************/
 536
 537 acpi_status
 538 acpi_ds_init_field_objects(union acpi_parse_object *op,
 539                            struct acpi_walk_state *walk_state)
 540 {
 541         acpi_status status;
 542         union acpi_parse_object *arg = NULL;
 543         struct acpi_namespace_node *node;
 544         u8 type = 0;
 545         u32 flags;
 546
 547         ACPI_FUNCTION_TRACE_PTR(ds_init_field_objects, op);
 548
 549         /* Execute flag should always be set when this function is entered */
 550
 551         if (!(walk_state->parse_flags & ACPI_PARSE_EXECUTE)) {
 552                 if (walk_state->parse_flags & ACPI_PARSE_DEFERRED_OP) {
 553
 554                         /* bank_field Op is deferred, just return OK */
 555
 556                         return_ACPI_STATUS(AE_OK);
 557                 }
 558
 559                 return_ACPI_STATUS(AE_AML_INTERNAL);
 560         }
 561
 562         /*
 563          * Get the field_list argument for this opcode. This is the start of the
 564          * list of field elements.
 565          */
 566         switch (walk_state->opcode) {
 567         case AML_FIELD_OP:
 568                 arg = acpi_ps_get_arg(op, 2);
 569                 type = ACPI_TYPE_LOCAL_REGION_FIELD;
 570                 break;
 571
 572         case AML_BANK_FIELD_OP:
 573                 arg = acpi_ps_get_arg(op, 4);
 574                 type = ACPI_TYPE_LOCAL_BANK_FIELD;
 575                 break;
 576
 577         case AML_INDEX_FIELD_OP:
 578                 arg = acpi_ps_get_arg(op, 3);
 579                 type = ACPI_TYPE_LOCAL_INDEX_FIELD;
 580                 break;
 581
 582         default:
 583                 return_ACPI_STATUS(AE_BAD_PARAMETER);
 584         }
 585
 586         /* Creating new namespace node(s), should not already exist */
 587
 588         flags = ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE |
 589             ACPI_NS_ERROR_IF_FOUND;
 590
 591         /*
 592          * Mark node(s) temporary if we are executing a normal control
 593          * method. (Don't mark if this is a module-level code method)
 594          */
 595         if (walk_state->method_node &&
 596             !(walk_state->parse_flags & ACPI_PARSE_MODULE_LEVEL)) {
 597                 flags |= ACPI_NS_TEMPORARY;
 598         }
 599
 600         /*
 601          * Walk the list of entries in the field_list
 602          * Note: field_list can be of zero length. In this case, Arg will be NULL.
 603          */
 604         while (arg) {
 605                 /*
 606                  * Ignore OFFSET/ACCESSAS/CONNECTION terms here; we are only interested
 607                  * in the field names in order to enter them into the namespace.
 608                  */
 609                 if (arg->common.aml_opcode == AML_INT_NAMEDFIELD_OP) {
 610                         status = acpi_ns_lookup(walk_state->scope_info,
 611                                                 (char *)&arg->named.name, type,
 612                                                 ACPI_IMODE_LOAD_PASS1, flags,
 613                                                 walk_state, &node);
 614                         if (ACPI_FAILURE(status)) {
 615                                 ACPI_ERROR_NAMESPACE((char *)&arg->named.name,
 616                                                      status);
 617                                 if (status != AE_ALREADY_EXISTS) {
 618                                         return_ACPI_STATUS(status);
 619                                 }
 620
 621                                 /* Name already exists, just ignore this error */
 622
 623                                 status = AE_OK;
 624                         }
 625
 626                         arg->common.node = node;
 627                 }
 628
 629                 /* Get the next field element in the list */
 630
 631                 arg = arg->common.next;
 632         }
 633
 634         return_ACPI_STATUS(AE_OK);
 635 }
 636
 637 /*******************************************************************************
 638  *
 639  * FUNCTION:    acpi_ds_create_bank_field
 640  *
 641  * PARAMETERS:  op              - Op containing the Field definition and args
 642  *              region_node     - Object for the containing Operation Region
 643  *              walk_state      - Current method state
 644  *
 645  * RETURN:      Status
 646  *
 647  * DESCRIPTION: Create a new bank field in the specified operation region
 648  *
 649  ******************************************************************************/
 650
 651 acpi_status
 652 acpi_ds_create_bank_field(union acpi_parse_object *op,
 653                           struct acpi_namespace_node *region_node,
 654                           struct acpi_walk_state *walk_state)
 655 {
 656         acpi_status status;
 657         union acpi_parse_object *arg;
 658         struct acpi_create_field_info info;
 659
 660         ACPI_FUNCTION_TRACE_PTR(ds_create_bank_field, op);
 661
 662         /* First arg is the name of the parent op_region (must already exist) */
 663
 664         arg = op->common.value.arg;
 665         if (!region_node) {
 666                 status =
 667                     acpi_ns_lookup(walk_state->scope_info,
 668                                    arg->common.value.name, ACPI_TYPE_REGION,
 669                                    ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
 670                                    walk_state, &region_node);
 671 #ifdef ACPI_ASL_COMPILER
 672                 status = acpi_ds_create_external_region(status, arg,
 673                                                         arg->common.value.name,
 674                                                         walk_state,
 675                                                         &region_node);
 676 #endif
 677                 if (ACPI_FAILURE(status)) {
 678                         ACPI_ERROR_NAMESPACE(arg->common.value.name, status);
 679                         return_ACPI_STATUS(status);
 680                 }
 681         }
 682
 683         /* Second arg is the Bank Register (Field) (must already exist) */
 684
 685         arg = arg->common.next;
 686         status =
 687             acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
 688                            ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
 689                            ACPI_NS_SEARCH_PARENT, walk_state,
 690                            &info.register_node);
 691         if (ACPI_FAILURE(status)) {
 692                 ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 693                 return_ACPI_STATUS(status);
 694         }
 695
 696         /*
 697          * Third arg is the bank_value
 698          * This arg is a term_arg, not a constant
 699          * It will be evaluated later, by acpi_ds_eval_bank_field_operands
 700          */
 701         arg = arg->common.next;
 702
 703         /* Fourth arg is the field flags */
 704
 705         arg = arg->common.next;
 706         info.field_flags = (u8) arg->common.value.integer;
 707
 708         /* Each remaining arg is a Named Field */
 709
 710         info.field_type = ACPI_TYPE_LOCAL_BANK_FIELD;
 711         info.region_node = region_node;
 712
 713         /*
 714          * Use Info.data_register_node to store bank_field Op
 715          * It's safe because data_register_node will never be used when create bank field
 716          * We store aml_start and aml_length in the bank_field Op for late evaluation
 717          * Used in acpi_ex_prep_field_value(Info)
 718          *
 719          * TBD: Or, should we add a field in struct acpi_create_field_info, like "void *ParentOp"?
 720          */
 721         info.data_register_node = (struct acpi_namespace_node *)op;
 722
 723         status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
 724         return_ACPI_STATUS(status);
 725 }
 726
 727 /*******************************************************************************
 728  *
 729  * FUNCTION:    acpi_ds_create_index_field
 730  *
 731  * PARAMETERS:  op              - Op containing the Field definition and args
 732  *              region_node     - Object for the containing Operation Region
 733  *  `           walk_state      - Current method state
 734  *
 735  * RETURN:      Status
 736  *
 737  * DESCRIPTION: Create a new index field in the specified operation region
 738  *
 739  ******************************************************************************/
 740
 741 acpi_status
 742 acpi_ds_create_index_field(union acpi_parse_object *op,
 743                            struct acpi_namespace_node *region_node,
 744                            struct acpi_walk_state *walk_state)
 745 {
 746         acpi_status status;
 747         union acpi_parse_object *arg;
 748         struct acpi_create_field_info info;
 749
 750         ACPI_FUNCTION_TRACE_PTR(ds_create_index_field, op);
 751
 752         /* First arg is the name of the Index register (must already exist) */
 753
 754         arg = op->common.value.arg;
 755         status =
 756             acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
 757                            ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
 758                            ACPI_NS_SEARCH_PARENT, walk_state,
 759                            &info.register_node);
 760         if (ACPI_FAILURE(status)) {
 761                 ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 762                 return_ACPI_STATUS(status);
 763         }
 764
 765         /* Second arg is the data register (must already exist) */
 766
 767         arg = arg->common.next;
 768         status =
 769             acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
 770                            ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
 771                            ACPI_NS_SEARCH_PARENT, walk_state,
 772                            &info.data_register_node);
 773         if (ACPI_FAILURE(status)) {
 774                 ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 775                 return_ACPI_STATUS(status);
 776         }
 777
 778         /* Next arg is the field flags */
 779
 780         arg = arg->common.next;
 781         info.field_flags = (u8) arg->common.value.integer;
 782
 783         /* Each remaining arg is a Named Field */
 784
 785         info.field_type = ACPI_TYPE_LOCAL_INDEX_FIELD;
 786         info.region_node = region_node;
 787
 788         status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
 789         return_ACPI_STATUS(status);
 790 }