1 /*******************************************************************************
3 * Module Name: rsutils - Utilities for the resource manager
5 ******************************************************************************/
8 * Copyright (C) 2000 - 2005, R. Byron Moore
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
45 #include <acpi/acpi.h>
46 #include <acpi/acnamesp.h>
47 #include <acpi/acresrc.h>
50 #define _COMPONENT ACPI_RESOURCES
51 ACPI_MODULE_NAME ("rsutils")
54 /*******************************************************************************
56 * FUNCTION: acpi_rs_get_prt_method_data
58 * PARAMETERS: Handle - a handle to the containing object
59 * ret_buffer - a pointer to a buffer structure for the
64 * DESCRIPTION: This function is called to get the _PRT value of an object
65 * contained in an object specified by the handle passed in
67 * If the function fails an appropriate status will be returned
68 * and the contents of the callers buffer is undefined.
70 ******************************************************************************/
73 acpi_rs_get_prt_method_data (
75 struct acpi_buffer *ret_buffer)
77 union acpi_operand_object *obj_desc;
81 ACPI_FUNCTION_TRACE ("rs_get_prt_method_data");
84 /* Parameters guaranteed valid by caller */
86 /* Execute the method, no parameters */
88 status = acpi_ut_evaluate_object (handle, METHOD_NAME__PRT,
89 ACPI_BTYPE_PACKAGE, &obj_desc);
90 if (ACPI_FAILURE (status)) {
91 return_ACPI_STATUS (status);
95 * Create a resource linked list from the byte stream buffer that comes
96 * back from the _CRS method execution.
98 status = acpi_rs_create_pci_routing_table (obj_desc, ret_buffer);
100 /* On exit, we must delete the object returned by evaluate_object */
102 acpi_ut_remove_reference (obj_desc);
103 return_ACPI_STATUS (status);
107 /*******************************************************************************
109 * FUNCTION: acpi_rs_get_crs_method_data
111 * PARAMETERS: Handle - a handle to the containing object
112 * ret_buffer - a pointer to a buffer structure for the
117 * DESCRIPTION: This function is called to get the _CRS value of an object
118 * contained in an object specified by the handle passed in
120 * If the function fails an appropriate status will be returned
121 * and the contents of the callers buffer is undefined.
123 ******************************************************************************/
126 acpi_rs_get_crs_method_data (
128 struct acpi_buffer *ret_buffer)
130 union acpi_operand_object *obj_desc;
134 ACPI_FUNCTION_TRACE ("rs_get_crs_method_data");
137 /* Parameters guaranteed valid by caller */
139 /* Execute the method, no parameters */
141 status = acpi_ut_evaluate_object (handle, METHOD_NAME__CRS,
142 ACPI_BTYPE_BUFFER, &obj_desc);
143 if (ACPI_FAILURE (status)) {
144 return_ACPI_STATUS (status);
148 * Make the call to create a resource linked list from the
149 * byte stream buffer that comes back from the _CRS method
152 status = acpi_rs_create_resource_list (obj_desc, ret_buffer);
154 /* on exit, we must delete the object returned by evaluate_object */
156 acpi_ut_remove_reference (obj_desc);
157 return_ACPI_STATUS (status);
161 /*******************************************************************************
163 * FUNCTION: acpi_rs_get_prs_method_data
165 * PARAMETERS: Handle - a handle to the containing object
166 * ret_buffer - a pointer to a buffer structure for the
171 * DESCRIPTION: This function is called to get the _PRS value of an object
172 * contained in an object specified by the handle passed in
174 * If the function fails an appropriate status will be returned
175 * and the contents of the callers buffer is undefined.
177 ******************************************************************************/
179 #ifdef ACPI_FUTURE_USAGE
181 acpi_rs_get_prs_method_data (
183 struct acpi_buffer *ret_buffer)
185 union acpi_operand_object *obj_desc;
189 ACPI_FUNCTION_TRACE ("rs_get_prs_method_data");
192 /* Parameters guaranteed valid by caller */
194 /* Execute the method, no parameters */
196 status = acpi_ut_evaluate_object (handle, METHOD_NAME__PRS,
197 ACPI_BTYPE_BUFFER, &obj_desc);
198 if (ACPI_FAILURE (status)) {
199 return_ACPI_STATUS (status);
203 * Make the call to create a resource linked list from the
204 * byte stream buffer that comes back from the _CRS method
207 status = acpi_rs_create_resource_list (obj_desc, ret_buffer);
209 /* on exit, we must delete the object returned by evaluate_object */
211 acpi_ut_remove_reference (obj_desc);
212 return_ACPI_STATUS (status);
214 #endif /* ACPI_FUTURE_USAGE */
217 /*******************************************************************************
219 * FUNCTION: acpi_rs_get_method_data
221 * PARAMETERS: Handle - a handle to the containing object
222 * Path - Path to method, relative to Handle
223 * ret_buffer - a pointer to a buffer structure for the
228 * DESCRIPTION: This function is called to get the _CRS or _PRS value of an
229 * object contained in an object specified by the handle passed in
231 * If the function fails an appropriate status will be returned
232 * and the contents of the callers buffer is undefined.
234 ******************************************************************************/
237 acpi_rs_get_method_data (
240 struct acpi_buffer *ret_buffer)
242 union acpi_operand_object *obj_desc;
246 ACPI_FUNCTION_TRACE ("rs_get_method_data");
249 /* Parameters guaranteed valid by caller */
251 /* Execute the method, no parameters */
253 status = acpi_ut_evaluate_object (handle, path, ACPI_BTYPE_BUFFER, &obj_desc);
254 if (ACPI_FAILURE (status)) {
255 return_ACPI_STATUS (status);
259 * Make the call to create a resource linked list from the
260 * byte stream buffer that comes back from the method
263 status = acpi_rs_create_resource_list (obj_desc, ret_buffer);
265 /* On exit, we must delete the object returned by evaluate_object */
267 acpi_ut_remove_reference (obj_desc);
268 return_ACPI_STATUS (status);
271 /*******************************************************************************
273 * FUNCTION: acpi_rs_set_srs_method_data
275 * PARAMETERS: Handle - a handle to the containing object
276 * in_buffer - a pointer to a buffer structure of the
281 * DESCRIPTION: This function is called to set the _SRS of an object contained
282 * in an object specified by the handle passed in
284 * If the function fails an appropriate status will be returned
285 * and the contents of the callers buffer is undefined.
287 ******************************************************************************/
290 acpi_rs_set_srs_method_data (
292 struct acpi_buffer *in_buffer)
294 struct acpi_parameter_info info;
295 union acpi_operand_object *params[2];
297 struct acpi_buffer buffer;
300 ACPI_FUNCTION_TRACE ("rs_set_srs_method_data");
303 /* Parameters guaranteed valid by caller */
306 * The in_buffer parameter will point to a linked list of
307 * resource parameters. It needs to be formatted into a
308 * byte stream to be sent in as an input parameter to _SRS
310 * Convert the linked list into a byte stream
312 buffer.length = ACPI_ALLOCATE_LOCAL_BUFFER;
313 status = acpi_rs_create_byte_stream (in_buffer->pointer, &buffer);
314 if (ACPI_FAILURE (status)) {
315 return_ACPI_STATUS (status);
318 /* Init the param object */
320 params[0] = acpi_ut_create_internal_object (ACPI_TYPE_BUFFER);
322 acpi_os_free (buffer.pointer);
323 return_ACPI_STATUS (AE_NO_MEMORY);
326 /* Set up the parameter object */
328 params[0]->buffer.length = (u32) buffer.length;
329 params[0]->buffer.pointer = buffer.pointer;
330 params[0]->common.flags = AOPOBJ_DATA_VALID;
334 info.parameters = params;
335 info.parameter_type = ACPI_PARAM_ARGS;
337 /* Execute the method, no return value */
339 status = acpi_ns_evaluate_relative (METHOD_NAME__SRS, &info);
340 if (ACPI_SUCCESS (status)) {
341 /* Delete any return object (especially if implicit_return is enabled) */
343 if (info.return_object) {
344 acpi_ut_remove_reference (info.return_object);
348 /* Clean up and return the status from acpi_ns_evaluate_relative */
350 acpi_ut_remove_reference (params[0]);
351 return_ACPI_STATUS (status);