drivers/acpi/acpica/dsargs.c

   1 /******************************************************************************
   2  *
   3  * Module Name: dsargs - Support for execution of dynamic arguments for static
   4  *                       objects (regions, fields, buffer fields, etc.)
   5  *
   6  *****************************************************************************/
   7
   8 /*
   9  * Copyright (C) 2000 - 2012, Intel Corp.
  10  * All rights reserved.
  11  *
  12  * Redistribution and use in source and binary forms, with or without
  13  * modification, are permitted provided that the following conditions
  14  * are met:
  15  * 1. Redistributions of source code must retain the above copyright
  16  *    notice, this list of conditions, and the following disclaimer,
  17  *    without modification.
  18  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  19  *    substantially similar to the "NO WARRANTY" disclaimer below
  20  *    ("Disclaimer") and any redistribution must be conditioned upon
  21  *    including a substantially similar Disclaimer requirement for further
  22  *    binary redistribution.
  23  * 3. Neither the names of the above-listed copyright holders nor the names
  24  *    of any contributors may be used to endorse or promote products derived
  25  *    from this software without specific prior written permission.
  26  *
  27  * Alternatively, this software may be distributed under the terms of the
  28  * GNU General Public License ("GPL") version 2 as published by the Free
  29  * Software Foundation.
  30  *
  31  * NO WARRANTY
  32  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  33  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  34  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  35  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  36  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  37  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  38  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  39  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  40  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  41  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  42  * POSSIBILITY OF SUCH DAMAGES.
  43  */
  44
  45 #include <acpi/acpi.h>
  46 #include "accommon.h"
  47 #include "acparser.h"
  48 #include "amlcode.h"
  49 #include "acdispat.h"
  50 #include "acnamesp.h"
  51
  52 #define _COMPONENT          ACPI_DISPATCHER
  53 ACPI_MODULE_NAME("dsargs")
  54
  55 /* Local prototypes */
  56 static acpi_status
  57 acpi_ds_execute_arguments(struct acpi_namespace_node *node,
  58                           struct acpi_namespace_node *scope_node,
  59                           u32 aml_length, u8 *aml_start);
  60
  61 /*******************************************************************************
  62  *
  63  * FUNCTION:    acpi_ds_execute_arguments
  64  *
  65  * PARAMETERS:  Node                - Object NS node
  66  *              scope_node          - Parent NS node
  67  *              aml_length          - Length of executable AML
  68  *              aml_start           - Pointer to the AML
  69  *
  70  * RETURN:      Status.
  71  *
  72  * DESCRIPTION: Late (deferred) execution of region or field arguments
  73  *
  74  ******************************************************************************/
  75
  76 static acpi_status
  77 acpi_ds_execute_arguments(struct acpi_namespace_node *node,
  78                           struct acpi_namespace_node *scope_node,
  79                           u32 aml_length, u8 *aml_start)
  80 {
  81         acpi_status status;
  82         union acpi_parse_object *op;
  83         struct acpi_walk_state *walk_state;
  84
  85         ACPI_FUNCTION_TRACE(ds_execute_arguments);
  86
  87         /* Allocate a new parser op to be the root of the parsed tree */
  88
  89         op = acpi_ps_alloc_op(AML_INT_EVAL_SUBTREE_OP);
  90         if (!op) {
  91                 return_ACPI_STATUS(AE_NO_MEMORY);
  92         }
  93
  94         /* Save the Node for use in acpi_ps_parse_aml */
  95
  96         op->common.node = scope_node;
  97
  98         /* Create and initialize a new parser state */
  99
 100         walk_state = acpi_ds_create_walk_state(0, NULL, NULL, NULL);
 101         if (!walk_state) {
 102                 status = AE_NO_MEMORY;
 103                 goto cleanup;
 104         }
 105
 106         status = acpi_ds_init_aml_walk(walk_state, op, NULL, aml_start,
 107                                        aml_length, NULL, ACPI_IMODE_LOAD_PASS1);
 108         if (ACPI_FAILURE(status)) {
 109                 acpi_ds_delete_walk_state(walk_state);
 110                 goto cleanup;
 111         }
 112
 113         /* Mark this parse as a deferred opcode */
 114
 115         walk_state->parse_flags = ACPI_PARSE_DEFERRED_OP;
 116         walk_state->deferred_node = node;
 117
 118         /* Pass1: Parse the entire declaration */
 119
 120         status = acpi_ps_parse_aml(walk_state);
 121         if (ACPI_FAILURE(status)) {
 122                 goto cleanup;
 123         }
 124
 125         /* Get and init the Op created above */
 126
 127         op->common.node = node;
 128         acpi_ps_delete_parse_tree(op);
 129
 130         /* Evaluate the deferred arguments */
 131
 132         op = acpi_ps_alloc_op(AML_INT_EVAL_SUBTREE_OP);
 133         if (!op) {
 134                 return_ACPI_STATUS(AE_NO_MEMORY);
 135         }
 136
 137         op->common.node = scope_node;
 138
 139         /* Create and initialize a new parser state */
 140
 141         walk_state = acpi_ds_create_walk_state(0, NULL, NULL, NULL);
 142         if (!walk_state) {
 143                 status = AE_NO_MEMORY;
 144                 goto cleanup;
 145         }
 146
 147         /* Execute the opcode and arguments */
 148
 149         status = acpi_ds_init_aml_walk(walk_state, op, NULL, aml_start,
 150                                        aml_length, NULL, ACPI_IMODE_EXECUTE);
 151         if (ACPI_FAILURE(status)) {
 152                 acpi_ds_delete_walk_state(walk_state);
 153                 goto cleanup;
 154         }
 155
 156         /* Mark this execution as a deferred opcode */
 157
 158         walk_state->deferred_node = node;
 159         status = acpi_ps_parse_aml(walk_state);
 160
 161       cleanup:
 162         acpi_ps_delete_parse_tree(op);
 163         return_ACPI_STATUS(status);
 164 }
 165
 166 /*******************************************************************************
 167  *
 168  * FUNCTION:    acpi_ds_get_buffer_field_arguments
 169  *
 170  * PARAMETERS:  obj_desc        - A valid buffer_field object
 171  *
 172  * RETURN:      Status.
 173  *
 174  * DESCRIPTION: Get buffer_field Buffer and Index. This implements the late
 175  *              evaluation of these field attributes.
 176  *
 177  ******************************************************************************/
 178
 179 acpi_status
 180 acpi_ds_get_buffer_field_arguments(union acpi_operand_object *obj_desc)
 181 {
 182         union acpi_operand_object *extra_desc;
 183         struct acpi_namespace_node *node;
 184         acpi_status status;
 185
 186         ACPI_FUNCTION_TRACE_PTR(ds_get_buffer_field_arguments, obj_desc);
 187
 188         if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
 189                 return_ACPI_STATUS(AE_OK);
 190         }
 191
 192         /* Get the AML pointer (method object) and buffer_field node */
 193
 194         extra_desc = acpi_ns_get_secondary_object(obj_desc);
 195         node = obj_desc->buffer_field.node;
 196
 197         ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname(ACPI_TYPE_BUFFER_FIELD,
 198                                                       node, NULL));
 199
 200         ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] BufferField Arg Init\n",
 201                           acpi_ut_get_node_name(node)));
 202
 203         /* Execute the AML code for the term_arg arguments */
 204
 205         status = acpi_ds_execute_arguments(node, node->parent,
 206                                            extra_desc->extra.aml_length,
 207                                            extra_desc->extra.aml_start);
 208         return_ACPI_STATUS(status);
 209 }
 210
 211 /*******************************************************************************
 212  *
 213  * FUNCTION:    acpi_ds_get_bank_field_arguments
 214  *
 215  * PARAMETERS:  obj_desc        - A valid bank_field object
 216  *
 217  * RETURN:      Status.
 218  *
 219  * DESCRIPTION: Get bank_field bank_value. This implements the late
 220  *              evaluation of these field attributes.
 221  *
 222  ******************************************************************************/
 223
 224 acpi_status
 225 acpi_ds_get_bank_field_arguments(union acpi_operand_object *obj_desc)
 226 {
 227         union acpi_operand_object *extra_desc;
 228         struct acpi_namespace_node *node;
 229         acpi_status status;
 230
 231         ACPI_FUNCTION_TRACE_PTR(ds_get_bank_field_arguments, obj_desc);
 232
 233         if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
 234                 return_ACPI_STATUS(AE_OK);
 235         }
 236
 237         /* Get the AML pointer (method object) and bank_field node */
 238
 239         extra_desc = acpi_ns_get_secondary_object(obj_desc);
 240         node = obj_desc->bank_field.node;
 241
 242         ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname
 243                         (ACPI_TYPE_LOCAL_BANK_FIELD, node, NULL));
 244
 245         ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] BankField Arg Init\n",
 246                           acpi_ut_get_node_name(node)));
 247
 248         /* Execute the AML code for the term_arg arguments */
 249
 250         status = acpi_ds_execute_arguments(node, node->parent,
 251                                            extra_desc->extra.aml_length,
 252                                            extra_desc->extra.aml_start);
 253         if (ACPI_FAILURE(status)) {
 254                 return_ACPI_STATUS(status);
 255         }
 256
 257         status = acpi_ut_add_address_range(obj_desc->region.space_id,
 258                                            obj_desc->region.address,
 259                                            obj_desc->region.length, node);
 260         return_ACPI_STATUS(status);
 261 }
 262
 263 /*******************************************************************************
 264  *
 265  * FUNCTION:    acpi_ds_get_buffer_arguments
 266  *
 267  * PARAMETERS:  obj_desc        - A valid Buffer object
 268  *
 269  * RETURN:      Status.
 270  *
 271  * DESCRIPTION: Get Buffer length and initializer byte list. This implements
 272  *              the late evaluation of these attributes.
 273  *
 274  ******************************************************************************/
 275
 276 acpi_status acpi_ds_get_buffer_arguments(union acpi_operand_object *obj_desc)
 277 {
 278         struct acpi_namespace_node *node;
 279         acpi_status status;
 280
 281         ACPI_FUNCTION_TRACE_PTR(ds_get_buffer_arguments, obj_desc);
 282
 283         if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
 284                 return_ACPI_STATUS(AE_OK);
 285         }
 286
 287         /* Get the Buffer node */
 288
 289         node = obj_desc->buffer.node;
 290         if (!node) {
 291                 ACPI_ERROR((AE_INFO,
 292                             "No pointer back to namespace node in buffer object %p",
 293                             obj_desc));
 294                 return_ACPI_STATUS(AE_AML_INTERNAL);
 295         }
 296
 297         ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Buffer Arg Init\n"));
 298
 299         /* Execute the AML code for the term_arg arguments */
 300
 301         status = acpi_ds_execute_arguments(node, node,
 302                                            obj_desc->buffer.aml_length,
 303                                            obj_desc->buffer.aml_start);
 304         return_ACPI_STATUS(status);
 305 }
 306
 307 /*******************************************************************************
 308  *
 309  * FUNCTION:    acpi_ds_get_package_arguments
 310  *
 311  * PARAMETERS:  obj_desc        - A valid Package object
 312  *
 313  * RETURN:      Status.
 314  *
 315  * DESCRIPTION: Get Package length and initializer byte list. This implements
 316  *              the late evaluation of these attributes.
 317  *
 318  ******************************************************************************/
 319
 320 acpi_status acpi_ds_get_package_arguments(union acpi_operand_object *obj_desc)
 321 {
 322         struct acpi_namespace_node *node;
 323         acpi_status status;
 324
 325         ACPI_FUNCTION_TRACE_PTR(ds_get_package_arguments, obj_desc);
 326
 327         if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
 328                 return_ACPI_STATUS(AE_OK);
 329         }
 330
 331         /* Get the Package node */
 332
 333         node = obj_desc->package.node;
 334         if (!node) {
 335                 ACPI_ERROR((AE_INFO,
 336                             "No pointer back to namespace node in package %p",
 337                             obj_desc));
 338                 return_ACPI_STATUS(AE_AML_INTERNAL);
 339         }
 340
 341         ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Package Arg Init\n"));
 342
 343         /* Execute the AML code for the term_arg arguments */
 344
 345         status = acpi_ds_execute_arguments(node, node,
 346                                            obj_desc->package.aml_length,
 347                                            obj_desc->package.aml_start);
 348         return_ACPI_STATUS(status);
 349 }
 350
 351 /*******************************************************************************
 352  *
 353  * FUNCTION:    acpi_ds_get_region_arguments
 354  *
 355  * PARAMETERS:  obj_desc        - A valid region object
 356  *
 357  * RETURN:      Status.
 358  *
 359  * DESCRIPTION: Get region address and length. This implements the late
 360  *              evaluation of these region attributes.
 361  *
 362  ******************************************************************************/
 363
 364 acpi_status acpi_ds_get_region_arguments(union acpi_operand_object *obj_desc)
 365 {
 366         struct acpi_namespace_node *node;
 367         acpi_status status;
 368         union acpi_operand_object *extra_desc;
 369
 370         ACPI_FUNCTION_TRACE_PTR(ds_get_region_arguments, obj_desc);
 371
 372         if (obj_desc->region.flags & AOPOBJ_DATA_VALID) {
 373                 return_ACPI_STATUS(AE_OK);
 374         }
 375
 376         extra_desc = acpi_ns_get_secondary_object(obj_desc);
 377         if (!extra_desc) {
 378                 return_ACPI_STATUS(AE_NOT_EXIST);
 379         }
 380
 381         /* Get the Region node */
 382
 383         node = obj_desc->region.node;
 384
 385         ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname
 386                         (ACPI_TYPE_REGION, node, NULL));
 387
 388         ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] OpRegion Arg Init at AML %p\n",
 389                           acpi_ut_get_node_name(node),
 390                           extra_desc->extra.aml_start));
 391
 392         /* Execute the argument AML */
 393
 394         status = acpi_ds_execute_arguments(node, extra_desc->extra.scope_node,
 395                                            extra_desc->extra.aml_length,
 396                                            extra_desc->extra.aml_start);
 397         if (ACPI_FAILURE(status)) {
 398                 return_ACPI_STATUS(status);
 399         }
 400
 401         status = acpi_ut_add_address_range(obj_desc->region.space_id,
 402                                            obj_desc->region.address,
 403                                            obj_desc->region.length, node);
 404         return_ACPI_STATUS(status);
 405 }