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
);