drivers/acpi/resources/rsutils.c

   1 /*******************************************************************************
   2  *
   3  * Module Name: rsutils - Utilities for the resource manager
   4  *
   5  ******************************************************************************/
   6
   7 /*
   8  *  Copyright (C) 2000 - 2003, R. Byron Moore
   9  *
  10  *  This program is free software; you can redistribute it and/or modify
  11  *  it under the terms of the GNU General Public License as published by
  12  *  the Free Software Foundation; either version 2 of the License, or
  13  *  (at your option) any later version.
  14  *
  15  *  This program is distributed in the hope that it will be useful,
  16  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  *  GNU General Public License for more details.
  19  *
  20  *  You should have received a copy of the GNU General Public License
  21  *  along with this program; if not, write to the Free Software
  22  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  23  */
  24
  25
  26 #include "acpi.h"
  27 #include "acnamesp.h"
  28 #include "acresrc.h"
  29
  30
  31 #define _COMPONENT          ACPI_RESOURCES
  32          ACPI_MODULE_NAME    ("rsutils")
  33
  34
  35 /*******************************************************************************
  36  *
  37  * FUNCTION:    acpi_rs_get_prt_method_data
  38  *
  39  * PARAMETERS:  Handle          - a handle to the containing object
  40  *              ret_buffer      - a pointer to a buffer structure for the
  41  *                                  results
  42  *
  43  * RETURN:      Status
  44  *
  45  * DESCRIPTION: This function is called to get the _PRT value of an object
  46  *              contained in an object specified by the handle passed in
  47  *
  48  *              If the function fails an appropriate status will be returned
  49  *              and the contents of the callers buffer is undefined.
  50  *
  51  ******************************************************************************/
  52
  53 acpi_status
  54 acpi_rs_get_prt_method_data (
  55         acpi_handle                     handle,
  56         struct acpi_buffer              *ret_buffer)
  57 {
  58         union acpi_operand_object       *obj_desc;
  59         acpi_status                     status;
  60
  61
  62         ACPI_FUNCTION_TRACE ("rs_get_prt_method_data");
  63
  64
  65         /* Parameters guaranteed valid by caller */
  66
  67         /*
  68          * Execute the method, no parameters
  69          */
  70         status = acpi_ut_evaluate_object (handle, "_PRT", ACPI_BTYPE_PACKAGE, &obj_desc);
  71         if (ACPI_FAILURE (status)) {
  72                 return_ACPI_STATUS (status);
  73         }
  74
  75         /*
  76          * Create a resource linked list from the byte stream buffer that comes
  77          * back from the _CRS method execution.
  78          */
  79         status = acpi_rs_create_pci_routing_table (obj_desc, ret_buffer);
  80
  81         /* On exit, we must delete the object returned by evaluate_object */
  82
  83         acpi_ut_remove_reference (obj_desc);
  84         return_ACPI_STATUS (status);
  85 }
  86
  87
  88 /*******************************************************************************
  89  *
  90  * FUNCTION:    acpi_rs_get_crs_method_data
  91  *
  92  * PARAMETERS:  Handle          - a handle to the containing object
  93  *              ret_buffer      - a pointer to a buffer structure for the
  94  *                                  results
  95  *
  96  * RETURN:      Status
  97  *
  98  * DESCRIPTION: This function is called to get the _CRS value of an object
  99  *              contained in an object specified by the handle passed in
 100  *
 101  *              If the function fails an appropriate status will be returned
 102  *              and the contents of the callers buffer is undefined.
 103  *
 104  ******************************************************************************/
 105
 106 acpi_status
 107 acpi_rs_get_crs_method_data (
 108         acpi_handle                     handle,
 109         struct acpi_buffer              *ret_buffer)
 110 {
 111         union acpi_operand_object       *obj_desc;
 112         acpi_status                     status;
 113
 114
 115         ACPI_FUNCTION_TRACE ("rs_get_crs_method_data");
 116
 117
 118         /* Parameters guaranteed valid by caller */
 119
 120         /*
 121          * Execute the method, no parameters
 122          */
 123         status = acpi_ut_evaluate_object (handle, "_CRS", ACPI_BTYPE_BUFFER, &obj_desc);
 124         if (ACPI_FAILURE (status)) {
 125                 return_ACPI_STATUS (status);
 126         }
 127
 128         /*
 129          * Make the call to create a resource linked list from the
 130          * byte stream buffer that comes back from the _CRS method
 131          * execution.
 132          */
 133         status = acpi_rs_create_resource_list (obj_desc, ret_buffer);
 134
 135         /* on exit, we must delete the object returned by evaluate_object */
 136
 137         acpi_ut_remove_reference (obj_desc);
 138         return_ACPI_STATUS (status);
 139 }
 140
 141
 142 /*******************************************************************************
 143  *
 144  * FUNCTION:    acpi_rs_get_prs_method_data
 145  *
 146  * PARAMETERS:  Handle          - a handle to the containing object
 147  *              ret_buffer      - a pointer to a buffer structure for the
 148  *                                  results
 149  *
 150  * RETURN:      Status
 151  *
 152  * DESCRIPTION: This function is called to get the _PRS value of an object
 153  *              contained in an object specified by the handle passed in
 154  *
 155  *              If the function fails an appropriate status will be returned
 156  *              and the contents of the callers buffer is undefined.
 157  *
 158  ******************************************************************************/
 159
 160 acpi_status
 161 acpi_rs_get_prs_method_data (
 162         acpi_handle                     handle,
 163         struct acpi_buffer              *ret_buffer)
 164 {
 165         union acpi_operand_object       *obj_desc;
 166         acpi_status                     status;
 167
 168
 169         ACPI_FUNCTION_TRACE ("rs_get_prs_method_data");
 170
 171
 172         /* Parameters guaranteed valid by caller */
 173
 174         /*
 175          * Execute the method, no parameters
 176          */
 177         status = acpi_ut_evaluate_object (handle, "_PRS", ACPI_BTYPE_BUFFER, &obj_desc);
 178         if (ACPI_FAILURE (status)) {
 179                 return_ACPI_STATUS (status);
 180         }
 181
 182         /*
 183          * Make the call to create a resource linked list from the
 184          * byte stream buffer that comes back from the _CRS method
 185          * execution.
 186          */
 187         status = acpi_rs_create_resource_list (obj_desc, ret_buffer);
 188
 189         /* on exit, we must delete the object returned by evaluate_object */
 190
 191         acpi_ut_remove_reference (obj_desc);
 192         return_ACPI_STATUS (status);
 193 }
 194
 195
 196 /*******************************************************************************
 197  *
 198  * FUNCTION:    acpi_rs_set_srs_method_data
 199  *
 200  * PARAMETERS:  Handle          - a handle to the containing object
 201  *              in_buffer       - a pointer to a buffer structure of the
 202  *                                  parameter
 203  *
 204  * RETURN:      Status
 205  *
 206  * DESCRIPTION: This function is called to set the _SRS of an object contained
 207  *              in an object specified by the handle passed in
 208  *
 209  *              If the function fails an appropriate status will be returned
 210  *              and the contents of the callers buffer is undefined.
 211  *
 212  ******************************************************************************/
 213
 214 acpi_status
 215 acpi_rs_set_srs_method_data (
 216         acpi_handle                     handle,
 217         struct acpi_buffer              *in_buffer)
 218 {
 219         union acpi_operand_object       *params[2];
 220         acpi_status                     status;
 221         struct acpi_buffer              buffer;
 222
 223
 224         ACPI_FUNCTION_TRACE ("rs_set_srs_method_data");
 225
 226
 227         /* Parameters guaranteed valid by caller */
 228
 229         /*
 230          * The in_buffer parameter will point to a linked list of
 231          * resource parameters.  It needs to be formatted into a
 232          * byte stream to be sent in as an input parameter to _SRS
 233          *
 234          * Convert the linked list into a byte stream
 235          */
 236         buffer.length = ACPI_ALLOCATE_LOCAL_BUFFER;
 237         status = acpi_rs_create_byte_stream (in_buffer->pointer, &buffer);
 238         if (ACPI_FAILURE (status)) {
 239                 return_ACPI_STATUS (status);
 240         }
 241
 242         /*
 243          * Init the param object
 244          */
 245         params[0] = acpi_ut_create_internal_object (ACPI_TYPE_BUFFER);
 246         if (!params[0]) {
 247                 acpi_os_free (buffer.pointer);
 248                 return_ACPI_STATUS (AE_NO_MEMORY);
 249         }
 250
 251         /*
 252          * Set up the parameter object
 253          */
 254         params[0]->buffer.length  = (u32) buffer.length;
 255         params[0]->buffer.pointer = buffer.pointer;
 256         params[0]->common.flags   = AOPOBJ_DATA_VALID;
 257         params[1] = NULL;
 258
 259         /*
 260          * Execute the method, no return value
 261          */
 262         status = acpi_ns_evaluate_relative (handle, "_SRS", params, NULL);
 263
 264         /*
 265          * Clean up and return the status from acpi_ns_evaluate_relative
 266          */
 267         acpi_ut_remove_reference (params[0]);
 268         return_ACPI_STATUS (status);
 269 }
 270