blob: ec503c8629616ba23d1834374e02bbbf4df717f0 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/******************************************************************************
2 *
Bob Moored9783482012-08-17 10:51:47 +08003 * Module Name: utxface - External interfaces, miscellaneous utility functions
Linus Torvalds1da177e2005-04-16 15:20:36 -07004 *
5 *****************************************************************************/
6
7/*
Bob Moorec8100dc2016-01-15 08:17:03 +08008 * Copyright (C) 2000 - 2016, Intel Corp.
Linus Torvalds1da177e2005-04-16 15:20:36 -07009 * 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
Lv Zheng839e9282013-10-29 09:29:51 +080044#define EXPORT_ACPI_INTERFACES
45
Linus Torvalds1da177e2005-04-16 15:20:36 -070046#include <acpi/acpi.h>
Len Browne2f7a772009-01-09 00:30:03 -050047#include "accommon.h"
Len Browne2f7a772009-01-09 00:30:03 -050048#include "acdebug.h"
Linus Torvalds1da177e2005-04-16 15:20:36 -070049
50#define _COMPONENT ACPI_UTILITIES
Len Brown4be44fc2005-08-05 00:44:28 -040051ACPI_MODULE_NAME("utxface")
Linus Torvalds1da177e2005-04-16 15:20:36 -070052
Linus Torvalds1da177e2005-04-16 15:20:36 -070053/*******************************************************************************
54 *
55 * FUNCTION: acpi_terminate
56 *
57 * PARAMETERS: None
58 *
59 * RETURN: Status
60 *
Bob Moore2f977b32009-07-24 11:25:16 +080061 * DESCRIPTION: Shutdown the ACPICA subsystem and release all resources.
Linus Torvalds1da177e2005-04-16 15:20:36 -070062 *
63 ******************************************************************************/
Lv Zheng2368b1a2016-08-04 16:43:19 +080064acpi_status ACPI_INIT_FUNCTION acpi_terminate(void)
Linus Torvalds1da177e2005-04-16 15:20:36 -070065{
Len Brown4be44fc2005-08-05 00:44:28 -040066 acpi_status status;
Linus Torvalds1da177e2005-04-16 15:20:36 -070067
Bob Mooreb229cf92006-04-21 17:15:00 -040068 ACPI_FUNCTION_TRACE(acpi_terminate);
Linus Torvalds1da177e2005-04-16 15:20:36 -070069
Linus Torvalds1da177e2005-04-16 15:20:36 -070070 /* Shutdown and free all resources */
71
Len Brown4be44fc2005-08-05 00:44:28 -040072 acpi_ut_subsystem_shutdown();
Linus Torvalds1da177e2005-04-16 15:20:36 -070073
74 /* Free the mutex objects */
75
Len Brown4be44fc2005-08-05 00:44:28 -040076 acpi_ut_mutex_terminate();
Linus Torvalds1da177e2005-04-16 15:20:36 -070077
Linus Torvalds1da177e2005-04-16 15:20:36 -070078 /* Now we can shutdown the OS-dependent layer */
79
Len Brown4be44fc2005-08-05 00:44:28 -040080 status = acpi_os_terminate();
81 return_ACPI_STATUS(status);
Linus Torvalds1da177e2005-04-16 15:20:36 -070082}
83
Lv Zhengd21f6002013-10-29 09:30:10 +080084ACPI_EXPORT_SYMBOL_INIT(acpi_terminate)
Bob Moore2f977b32009-07-24 11:25:16 +080085
Bob Mooree20a6792008-04-10 19:06:38 +040086#ifndef ACPI_ASL_COMPILER
Linus Torvalds1da177e2005-04-16 15:20:36 -070087#ifdef ACPI_FUTURE_USAGE
Robert Moore44f6c012005-04-18 22:49:35 -040088/*******************************************************************************
Linus Torvalds1da177e2005-04-16 15:20:36 -070089 *
90 * FUNCTION: acpi_subsystem_status
91 *
92 * PARAMETERS: None
93 *
94 * RETURN: Status of the ACPI subsystem
95 *
96 * DESCRIPTION: Other drivers that use the ACPI subsystem should call this
Robert Moore44f6c012005-04-18 22:49:35 -040097 * before making any other calls, to ensure the subsystem
98 * initialized successfully.
Linus Torvalds1da177e2005-04-16 15:20:36 -070099 *
Robert Moore44f6c012005-04-18 22:49:35 -0400100 ******************************************************************************/
Len Brown4be44fc2005-08-05 00:44:28 -0400101acpi_status acpi_subsystem_status(void)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102{
Robert Moore44f6c012005-04-18 22:49:35 -0400103
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104 if (acpi_gbl_startup_flags & ACPI_INITIALIZED_OK) {
105 return (AE_OK);
Len Brown4be44fc2005-08-05 00:44:28 -0400106 } else {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107 return (AE_ERROR);
108 }
109}
110
Bob Moore83135242006-10-03 00:00:00 -0400111ACPI_EXPORT_SYMBOL(acpi_subsystem_status)
112
Robert Moore44f6c012005-04-18 22:49:35 -0400113/*******************************************************************************
Linus Torvalds1da177e2005-04-16 15:20:36 -0700114 *
115 * FUNCTION: acpi_get_system_info
116 *
Robert Moore44f6c012005-04-18 22:49:35 -0400117 * PARAMETERS: out_buffer - A buffer to receive the resources for the
118 * device
Linus Torvalds1da177e2005-04-16 15:20:36 -0700119 *
Bob Mooreba494be2012-07-12 09:40:10 +0800120 * RETURN: status - the status of the call
Linus Torvalds1da177e2005-04-16 15:20:36 -0700121 *
122 * DESCRIPTION: This function is called to get information about the current
Bob Moore73a30902012-10-31 02:26:55 +0000123 * state of the ACPI subsystem. It will return system information
Linus Torvalds1da177e2005-04-16 15:20:36 -0700124 * in the out_buffer.
125 *
126 * If the function fails an appropriate status will be returned
127 * and the value of out_buffer is undefined.
128 *
129 ******************************************************************************/
Lv Zhengf5c1e1c2016-05-05 12:57:53 +0800130acpi_status acpi_get_system_info(struct acpi_buffer *out_buffer)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700131{
Len Brown4be44fc2005-08-05 00:44:28 -0400132 struct acpi_system_info *info_ptr;
133 acpi_status status;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700134
Bob Mooreb229cf92006-04-21 17:15:00 -0400135 ACPI_FUNCTION_TRACE(acpi_get_system_info);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700136
137 /* Parameter validation */
138
Len Brown4be44fc2005-08-05 00:44:28 -0400139 status = acpi_ut_validate_buffer(out_buffer);
140 if (ACPI_FAILURE(status)) {
141 return_ACPI_STATUS(status);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700142 }
143
144 /* Validate/Allocate/Clear caller buffer */
145
Len Brown4be44fc2005-08-05 00:44:28 -0400146 status =
147 acpi_ut_initialize_buffer(out_buffer,
148 sizeof(struct acpi_system_info));
149 if (ACPI_FAILURE(status)) {
150 return_ACPI_STATUS(status);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700151 }
152
153 /*
154 * Populate the return buffer
155 */
Len Brown4be44fc2005-08-05 00:44:28 -0400156 info_ptr = (struct acpi_system_info *)out_buffer->pointer;
Len Brown4be44fc2005-08-05 00:44:28 -0400157 info_ptr->acpi_ca_version = ACPI_CA_VERSION;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700158
159 /* System flags (ACPI capabilities) */
160
Len Brown4be44fc2005-08-05 00:44:28 -0400161 info_ptr->flags = ACPI_SYS_MODE_ACPI;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700162
163 /* Timer resolution - 24 or 32 bits */
164
Bob Mooref3d2e782007-02-02 19:48:18 +0300165 if (acpi_gbl_FADT.flags & ACPI_FADT_32BIT_TIMER) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166 info_ptr->timer_resolution = 24;
Len Brown4be44fc2005-08-05 00:44:28 -0400167 } else {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700168 info_ptr->timer_resolution = 32;
169 }
170
171 /* Clear the reserved fields */
172
Len Brown4be44fc2005-08-05 00:44:28 -0400173 info_ptr->reserved1 = 0;
174 info_ptr->reserved2 = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700175
176 /* Current debug levels */
177
Len Brown4be44fc2005-08-05 00:44:28 -0400178 info_ptr->debug_layer = acpi_dbg_layer;
179 info_ptr->debug_level = acpi_dbg_level;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700180
Len Brown4be44fc2005-08-05 00:44:28 -0400181 return_ACPI_STATUS(AE_OK);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700182}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700183
Bob Moore83135242006-10-03 00:00:00 -0400184ACPI_EXPORT_SYMBOL(acpi_get_system_info)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700185
Lv Zheng9187a412013-10-31 09:30:28 +0800186/*******************************************************************************
187 *
188 * FUNCTION: acpi_get_statistics
189 *
190 * PARAMETERS: stats - Where the statistics are returned
191 *
192 * RETURN: status - the status of the call
193 *
194 * DESCRIPTION: Get the contents of the various system counters
195 *
196 ******************************************************************************/
197acpi_status acpi_get_statistics(struct acpi_statistics *stats)
198{
199 ACPI_FUNCTION_TRACE(acpi_get_statistics);
200
201 /* Parameter validation */
202
203 if (!stats) {
204 return_ACPI_STATUS(AE_BAD_PARAMETER);
205 }
206
207 /* Various interrupt-based event counters */
208
209 stats->sci_count = acpi_sci_count;
210 stats->gpe_count = acpi_gpe_count;
211
Bob Moore4fa46162015-07-01 14:45:11 +0800212 memcpy(stats->fixed_event_count, acpi_fixed_event_count,
213 sizeof(acpi_fixed_event_count));
Lv Zheng9187a412013-10-31 09:30:28 +0800214
215 /* Other counters */
216
217 stats->method_count = acpi_method_count;
Lv Zheng9187a412013-10-31 09:30:28 +0800218 return_ACPI_STATUS(AE_OK);
219}
220
221ACPI_EXPORT_SYMBOL(acpi_get_statistics)
222
Linus Torvalds1da177e2005-04-16 15:20:36 -0700223/*****************************************************************************
224 *
225 * FUNCTION: acpi_install_initialization_handler
226 *
Bob Mooreba494be2012-07-12 09:40:10 +0800227 * PARAMETERS: handler - Callback procedure
228 * function - Not (currently) used, see below
Linus Torvalds1da177e2005-04-16 15:20:36 -0700229 *
230 * RETURN: Status
231 *
232 * DESCRIPTION: Install an initialization handler
233 *
234 * TBD: When a second function is added, must save the Function also.
235 *
236 ****************************************************************************/
Linus Torvalds1da177e2005-04-16 15:20:36 -0700237acpi_status
Len Brown4be44fc2005-08-05 00:44:28 -0400238acpi_install_initialization_handler(acpi_init_handler handler, u32 function)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700239{
240
241 if (!handler) {
242 return (AE_BAD_PARAMETER);
243 }
244
245 if (acpi_gbl_init_handler) {
246 return (AE_ALREADY_EXISTS);
247 }
248
249 acpi_gbl_init_handler = handler;
Bob Moore68aafc32012-10-31 02:26:01 +0000250 return (AE_OK);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700251}
252
Bob Moore83135242006-10-03 00:00:00 -0400253ACPI_EXPORT_SYMBOL(acpi_install_initialization_handler)
Lv Zheng4d946f72015-10-19 10:25:56 +0800254#endif
Lin Mingb0ed7a92010-08-06 09:35:51 +0800255
Linus Torvalds1da177e2005-04-16 15:20:36 -0700256/*****************************************************************************
257 *
258 * FUNCTION: acpi_purge_cached_objects
259 *
260 * PARAMETERS: None
261 *
262 * RETURN: Status
263 *
264 * DESCRIPTION: Empty all caches (delete the cached objects)
265 *
266 ****************************************************************************/
Len Brown4be44fc2005-08-05 00:44:28 -0400267acpi_status acpi_purge_cached_objects(void)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700268{
Bob Mooreb229cf92006-04-21 17:15:00 -0400269 ACPI_FUNCTION_TRACE(acpi_purge_cached_objects);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700270
Len Brown4be44fc2005-08-05 00:44:28 -0400271 (void)acpi_os_purge_cache(acpi_gbl_state_cache);
272 (void)acpi_os_purge_cache(acpi_gbl_operand_cache);
273 (void)acpi_os_purge_cache(acpi_gbl_ps_node_cache);
274 (void)acpi_os_purge_cache(acpi_gbl_ps_node_ext_cache);
Bob Moore68aafc32012-10-31 02:26:01 +0000275
Len Brown4be44fc2005-08-05 00:44:28 -0400276 return_ACPI_STATUS(AE_OK);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700277}
Bob Moore83135242006-10-03 00:00:00 -0400278
279ACPI_EXPORT_SYMBOL(acpi_purge_cached_objects)
Lin Mingb0ed7a92010-08-06 09:35:51 +0800280
281/*****************************************************************************
282 *
283 * FUNCTION: acpi_install_interface
284 *
285 * PARAMETERS: interface_name - The interface to install
286 *
287 * RETURN: Status
288 *
289 * DESCRIPTION: Install an _OSI interface to the global list
290 *
291 ****************************************************************************/
292acpi_status acpi_install_interface(acpi_string interface_name)
293{
294 acpi_status status;
295 struct acpi_interface_info *interface_info;
296
297 /* Parameter validation */
298
Bob Moore4fa46162015-07-01 14:45:11 +0800299 if (!interface_name || (strlen(interface_name) == 0)) {
Lin Mingb0ed7a92010-08-06 09:35:51 +0800300 return (AE_BAD_PARAMETER);
301 }
302
Jung-uk Kim388a9902013-04-12 00:24:34 +0000303 status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
304 if (ACPI_FAILURE(status)) {
305 return (status);
306 }
Lin Mingb0ed7a92010-08-06 09:35:51 +0800307
308 /* Check if the interface name is already in the global list */
309
310 interface_info = acpi_ut_get_interface(interface_name);
311 if (interface_info) {
312 /*
313 * The interface already exists in the list. This is OK if the
314 * interface has been marked invalid -- just clear the bit.
315 */
316 if (interface_info->flags & ACPI_OSI_INVALID) {
317 interface_info->flags &= ~ACPI_OSI_INVALID;
318 status = AE_OK;
319 } else {
320 status = AE_ALREADY_EXISTS;
321 }
322 } else {
323 /* New interface name, install into the global list */
324
325 status = acpi_ut_install_interface(interface_name);
326 }
327
328 acpi_os_release_mutex(acpi_gbl_osi_mutex);
329 return (status);
330}
331
332ACPI_EXPORT_SYMBOL(acpi_install_interface)
333
334/*****************************************************************************
335 *
336 * FUNCTION: acpi_remove_interface
337 *
338 * PARAMETERS: interface_name - The interface to remove
339 *
340 * RETURN: Status
341 *
342 * DESCRIPTION: Remove an _OSI interface from the global list
343 *
344 ****************************************************************************/
345acpi_status acpi_remove_interface(acpi_string interface_name)
346{
347 acpi_status status;
348
349 /* Parameter validation */
350
Bob Moore4fa46162015-07-01 14:45:11 +0800351 if (!interface_name || (strlen(interface_name) == 0)) {
Lin Mingb0ed7a92010-08-06 09:35:51 +0800352 return (AE_BAD_PARAMETER);
353 }
354
Jung-uk Kim388a9902013-04-12 00:24:34 +0000355 status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
356 if (ACPI_FAILURE(status)) {
357 return (status);
358 }
Lin Mingb0ed7a92010-08-06 09:35:51 +0800359
360 status = acpi_ut_remove_interface(interface_name);
361
362 acpi_os_release_mutex(acpi_gbl_osi_mutex);
363 return (status);
364}
365
366ACPI_EXPORT_SYMBOL(acpi_remove_interface)
367
368/*****************************************************************************
369 *
370 * FUNCTION: acpi_install_interface_handler
371 *
Bob Mooreba494be2012-07-12 09:40:10 +0800372 * PARAMETERS: handler - The _OSI interface handler to install
Lin Mingb0ed7a92010-08-06 09:35:51 +0800373 * NULL means "remove existing handler"
374 *
375 * RETURN: Status
376 *
377 * DESCRIPTION: Install a handler for the predefined _OSI ACPI method.
378 * invoked during execution of the internal implementation of
379 * _OSI. A NULL handler simply removes any existing handler.
380 *
381 ****************************************************************************/
382acpi_status acpi_install_interface_handler(acpi_interface_handler handler)
383{
Jung-uk Kim388a9902013-04-12 00:24:34 +0000384 acpi_status status;
Lin Mingb0ed7a92010-08-06 09:35:51 +0800385
Jung-uk Kim388a9902013-04-12 00:24:34 +0000386 status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
387 if (ACPI_FAILURE(status)) {
388 return (status);
389 }
Lin Mingb0ed7a92010-08-06 09:35:51 +0800390
391 if (handler && acpi_gbl_interface_handler) {
392 status = AE_ALREADY_EXISTS;
393 } else {
394 acpi_gbl_interface_handler = handler;
395 }
396
397 acpi_os_release_mutex(acpi_gbl_osi_mutex);
398 return (status);
399}
400
401ACPI_EXPORT_SYMBOL(acpi_install_interface_handler)
Lin Mingf654c0f2012-01-12 13:10:32 +0800402
403/*****************************************************************************
404 *
Lv Zheng2cf9f5b2013-07-22 16:08:16 +0800405 * FUNCTION: acpi_update_interfaces
406 *
407 * PARAMETERS: action - Actions to be performed during the
408 * update
409 *
410 * RETURN: Status
411 *
412 * DESCRIPTION: Update _OSI interface strings, disabling or enabling OS vendor
413 * string or/and feature group strings.
414 *
415 ****************************************************************************/
416acpi_status acpi_update_interfaces(u8 action)
417{
418 acpi_status status;
419
420 status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
421 if (ACPI_FAILURE(status)) {
422 return (status);
423 }
424
425 status = acpi_ut_update_interfaces(action);
426
427 acpi_os_release_mutex(acpi_gbl_osi_mutex);
428 return (status);
429}
430
431/*****************************************************************************
432 *
Lin Mingf654c0f2012-01-12 13:10:32 +0800433 * FUNCTION: acpi_check_address_range
434 *
435 * PARAMETERS: space_id - Address space ID
Bob Mooreba494be2012-07-12 09:40:10 +0800436 * address - Start address
437 * length - Length
438 * warn - TRUE if warning on overlap desired
Lin Mingf654c0f2012-01-12 13:10:32 +0800439 *
440 * RETURN: Count of the number of conflicts detected.
441 *
442 * DESCRIPTION: Check if the input address range overlaps any of the
443 * ASL operation region address ranges.
444 *
445 ****************************************************************************/
Lv Zheng2cf9f5b2013-07-22 16:08:16 +0800446
Lin Mingf654c0f2012-01-12 13:10:32 +0800447u32
448acpi_check_address_range(acpi_adr_space_type space_id,
449 acpi_physical_address address,
450 acpi_size length, u8 warn)
451{
452 u32 overlaps;
453 acpi_status status;
454
455 status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
456 if (ACPI_FAILURE(status)) {
457 return (0);
458 }
459
460 overlaps = acpi_ut_check_address_range(space_id, address,
461 (u32)length, warn);
462
463 (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
464 return (overlaps);
465}
466
467ACPI_EXPORT_SYMBOL(acpi_check_address_range)
Lin Mingb0ed7a92010-08-06 09:35:51 +0800468#endif /* !ACPI_ASL_COMPILER */
Bob Moorebe030a52012-08-17 13:07:54 +0800469/*******************************************************************************
470 *
471 * FUNCTION: acpi_decode_pld_buffer
472 *
473 * PARAMETERS: in_buffer - Buffer returned by _PLD method
474 * length - Length of the in_buffer
475 * return_buffer - Where the decode buffer is returned
476 *
477 * RETURN: Status and the decoded _PLD buffer. User must deallocate
478 * the buffer via ACPI_FREE.
479 *
480 * DESCRIPTION: Decode the bit-packed buffer returned by the _PLD method into
481 * a local struct that is much more useful to an ACPI driver.
482 *
483 ******************************************************************************/
484acpi_status
485acpi_decode_pld_buffer(u8 *in_buffer,
Lv Zhengf5c1e1c2016-05-05 12:57:53 +0800486 acpi_size length, struct acpi_pld_info **return_buffer)
Bob Moorebe030a52012-08-17 13:07:54 +0800487{
488 struct acpi_pld_info *pld_info;
489 u32 *buffer = ACPI_CAST_PTR(u32, in_buffer);
490 u32 dword;
491
492 /* Parameter validation */
493
Bob Moore35349692015-08-25 10:28:32 +0800494 if (!in_buffer || !return_buffer
495 || (length < ACPI_PLD_REV1_BUFFER_SIZE)) {
Bob Moorebe030a52012-08-17 13:07:54 +0800496 return (AE_BAD_PARAMETER);
497 }
498
499 pld_info = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_pld_info));
500 if (!pld_info) {
501 return (AE_NO_MEMORY);
502 }
503
504 /* First 32-bit DWord */
505
506 ACPI_MOVE_32_TO_32(&dword, &buffer[0]);
507 pld_info->revision = ACPI_PLD_GET_REVISION(&dword);
508 pld_info->ignore_color = ACPI_PLD_GET_IGNORE_COLOR(&dword);
Bob Moore4dcd78d2014-11-27 14:26:00 +0800509 pld_info->red = ACPI_PLD_GET_RED(&dword);
510 pld_info->green = ACPI_PLD_GET_GREEN(&dword);
511 pld_info->blue = ACPI_PLD_GET_BLUE(&dword);
Bob Moorebe030a52012-08-17 13:07:54 +0800512
513 /* Second 32-bit DWord */
514
515 ACPI_MOVE_32_TO_32(&dword, &buffer[1]);
516 pld_info->width = ACPI_PLD_GET_WIDTH(&dword);
517 pld_info->height = ACPI_PLD_GET_HEIGHT(&dword);
518
519 /* Third 32-bit DWord */
520
521 ACPI_MOVE_32_TO_32(&dword, &buffer[2]);
522 pld_info->user_visible = ACPI_PLD_GET_USER_VISIBLE(&dword);
523 pld_info->dock = ACPI_PLD_GET_DOCK(&dword);
524 pld_info->lid = ACPI_PLD_GET_LID(&dword);
525 pld_info->panel = ACPI_PLD_GET_PANEL(&dword);
526 pld_info->vertical_position = ACPI_PLD_GET_VERTICAL(&dword);
527 pld_info->horizontal_position = ACPI_PLD_GET_HORIZONTAL(&dword);
528 pld_info->shape = ACPI_PLD_GET_SHAPE(&dword);
529 pld_info->group_orientation = ACPI_PLD_GET_ORIENTATION(&dword);
530 pld_info->group_token = ACPI_PLD_GET_TOKEN(&dword);
531 pld_info->group_position = ACPI_PLD_GET_POSITION(&dword);
532 pld_info->bay = ACPI_PLD_GET_BAY(&dword);
533
534 /* Fourth 32-bit DWord */
535
536 ACPI_MOVE_32_TO_32(&dword, &buffer[3]);
537 pld_info->ejectable = ACPI_PLD_GET_EJECTABLE(&dword);
538 pld_info->ospm_eject_required = ACPI_PLD_GET_OSPM_EJECT(&dword);
539 pld_info->cabinet_number = ACPI_PLD_GET_CABINET(&dword);
540 pld_info->card_cage_number = ACPI_PLD_GET_CARD_CAGE(&dword);
541 pld_info->reference = ACPI_PLD_GET_REFERENCE(&dword);
542 pld_info->rotation = ACPI_PLD_GET_ROTATION(&dword);
543 pld_info->order = ACPI_PLD_GET_ORDER(&dword);
544
Bob Moore35349692015-08-25 10:28:32 +0800545 if (length >= ACPI_PLD_REV2_BUFFER_SIZE) {
Bob Moorebe030a52012-08-17 13:07:54 +0800546
547 /* Fifth 32-bit DWord (Revision 2 of _PLD) */
548
549 ACPI_MOVE_32_TO_32(&dword, &buffer[4]);
550 pld_info->vertical_offset = ACPI_PLD_GET_VERT_OFFSET(&dword);
551 pld_info->horizontal_offset = ACPI_PLD_GET_HORIZ_OFFSET(&dword);
552 }
553
554 *return_buffer = pld_info;
555 return (AE_OK);
556}
557
558ACPI_EXPORT_SYMBOL(acpi_decode_pld_buffer)