195857638SErik Schmauss // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
295b482a8SLen Brown /******************************************************************************
395b482a8SLen Brown *
4d978348bSBob Moore * Module Name: utxface - External interfaces, miscellaneous utility functions
595b482a8SLen Brown *
6*612c2932SBob Moore * Copyright (C) 2000 - 2023, Intel Corp.
795b482a8SLen Brown *
895857638SErik Schmauss *****************************************************************************/
995b482a8SLen Brown
10839e928fSLv Zheng #define EXPORT_ACPI_INTERFACES
11839e928fSLv Zheng
1295b482a8SLen Brown #include <acpi/acpi.h>
13e2f7a777SLen Brown #include "accommon.h"
14e2f7a777SLen Brown #include "acdebug.h"
1595b482a8SLen Brown
1695b482a8SLen Brown #define _COMPONENT ACPI_UTILITIES
1795b482a8SLen Brown ACPI_MODULE_NAME("utxface")
1895b482a8SLen Brown
1995b482a8SLen Brown /*******************************************************************************
2095b482a8SLen Brown *
2195b482a8SLen Brown * FUNCTION: acpi_terminate
2295b482a8SLen Brown *
2395b482a8SLen Brown * PARAMETERS: None
2495b482a8SLen Brown *
2595b482a8SLen Brown * RETURN: Status
2695b482a8SLen Brown *
272f977b36SBob Moore * DESCRIPTION: Shutdown the ACPICA subsystem and release all resources.
2895b482a8SLen Brown *
2995b482a8SLen Brown ******************************************************************************/
acpi_terminate(void)302368b1a1SLv Zheng acpi_status ACPI_INIT_FUNCTION acpi_terminate(void)
3195b482a8SLen Brown {
3295b482a8SLen Brown acpi_status status;
3395b482a8SLen Brown
3495b482a8SLen Brown ACPI_FUNCTION_TRACE(acpi_terminate);
3595b482a8SLen Brown
3695b482a8SLen Brown /* Shutdown and free all resources */
3795b482a8SLen Brown
3895b482a8SLen Brown acpi_ut_subsystem_shutdown();
3995b482a8SLen Brown
4095b482a8SLen Brown /* Free the mutex objects */
4195b482a8SLen Brown
4295b482a8SLen Brown acpi_ut_mutex_terminate();
4395b482a8SLen Brown
4495b482a8SLen Brown /* Now we can shutdown the OS-dependent layer */
4595b482a8SLen Brown
4695b482a8SLen Brown status = acpi_os_terminate();
4795b482a8SLen Brown return_ACPI_STATUS(status);
4895b482a8SLen Brown }
4995b482a8SLen Brown
ACPI_EXPORT_SYMBOL_INIT(acpi_terminate)50d21f600bSLv Zheng ACPI_EXPORT_SYMBOL_INIT(acpi_terminate)
512f977b36SBob Moore
5295b482a8SLen Brown #ifndef ACPI_ASL_COMPILER
5395b482a8SLen Brown #ifdef ACPI_FUTURE_USAGE
5495b482a8SLen Brown /*******************************************************************************
5595b482a8SLen Brown *
5695b482a8SLen Brown * FUNCTION: acpi_subsystem_status
5795b482a8SLen Brown *
5895b482a8SLen Brown * PARAMETERS: None
5995b482a8SLen Brown *
6095b482a8SLen Brown * RETURN: Status of the ACPI subsystem
6195b482a8SLen Brown *
6295b482a8SLen Brown * DESCRIPTION: Other drivers that use the ACPI subsystem should call this
6395b482a8SLen Brown * before making any other calls, to ensure the subsystem
6495b482a8SLen Brown * initialized successfully.
6595b482a8SLen Brown *
6695b482a8SLen Brown ******************************************************************************/
6795b482a8SLen Brown acpi_status acpi_subsystem_status(void)
6895b482a8SLen Brown {
6995b482a8SLen Brown
7095b482a8SLen Brown if (acpi_gbl_startup_flags & ACPI_INITIALIZED_OK) {
7195b482a8SLen Brown return (AE_OK);
7295b482a8SLen Brown } else {
7395b482a8SLen Brown return (AE_ERROR);
7495b482a8SLen Brown }
7595b482a8SLen Brown }
7695b482a8SLen Brown
ACPI_EXPORT_SYMBOL(acpi_subsystem_status)7795b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_subsystem_status)
7895b482a8SLen Brown
7995b482a8SLen Brown /*******************************************************************************
8095b482a8SLen Brown *
8195b482a8SLen Brown * FUNCTION: acpi_get_system_info
8295b482a8SLen Brown *
8395b482a8SLen Brown * PARAMETERS: out_buffer - A buffer to receive the resources for the
8495b482a8SLen Brown * device
8595b482a8SLen Brown *
86ba494beeSBob Moore * RETURN: status - the status of the call
8795b482a8SLen Brown *
8895b482a8SLen Brown * DESCRIPTION: This function is called to get information about the current
8995b482a8SLen Brown * state of the ACPI subsystem. It will return system information
9095b482a8SLen Brown * in the out_buffer.
9195b482a8SLen Brown *
9295b482a8SLen Brown * If the function fails an appropriate status will be returned
9395b482a8SLen Brown * and the value of out_buffer is undefined.
9495b482a8SLen Brown *
9595b482a8SLen Brown ******************************************************************************/
9695b482a8SLen Brown acpi_status acpi_get_system_info(struct acpi_buffer *out_buffer)
9795b482a8SLen Brown {
9895b482a8SLen Brown struct acpi_system_info *info_ptr;
9995b482a8SLen Brown acpi_status status;
10095b482a8SLen Brown
10195b482a8SLen Brown ACPI_FUNCTION_TRACE(acpi_get_system_info);
10295b482a8SLen Brown
10395b482a8SLen Brown /* Parameter validation */
10495b482a8SLen Brown
10595b482a8SLen Brown status = acpi_ut_validate_buffer(out_buffer);
10695b482a8SLen Brown if (ACPI_FAILURE(status)) {
10795b482a8SLen Brown return_ACPI_STATUS(status);
10895b482a8SLen Brown }
10995b482a8SLen Brown
11095b482a8SLen Brown /* Validate/Allocate/Clear caller buffer */
11195b482a8SLen Brown
11295b482a8SLen Brown status =
11395b482a8SLen Brown acpi_ut_initialize_buffer(out_buffer,
11495b482a8SLen Brown sizeof(struct acpi_system_info));
11595b482a8SLen Brown if (ACPI_FAILURE(status)) {
11695b482a8SLen Brown return_ACPI_STATUS(status);
11795b482a8SLen Brown }
11895b482a8SLen Brown
11995b482a8SLen Brown /*
12095b482a8SLen Brown * Populate the return buffer
12195b482a8SLen Brown */
12295b482a8SLen Brown info_ptr = (struct acpi_system_info *)out_buffer->pointer;
12395b482a8SLen Brown info_ptr->acpi_ca_version = ACPI_CA_VERSION;
12495b482a8SLen Brown
12595b482a8SLen Brown /* System flags (ACPI capabilities) */
12695b482a8SLen Brown
12795b482a8SLen Brown info_ptr->flags = ACPI_SYS_MODE_ACPI;
12895b482a8SLen Brown
12995b482a8SLen Brown /* Timer resolution - 24 or 32 bits */
13095b482a8SLen Brown
13195b482a8SLen Brown if (acpi_gbl_FADT.flags & ACPI_FADT_32BIT_TIMER) {
13295b482a8SLen Brown info_ptr->timer_resolution = 24;
13395b482a8SLen Brown } else {
13495b482a8SLen Brown info_ptr->timer_resolution = 32;
13595b482a8SLen Brown }
13695b482a8SLen Brown
13795b482a8SLen Brown /* Clear the reserved fields */
13895b482a8SLen Brown
13995b482a8SLen Brown info_ptr->reserved1 = 0;
14095b482a8SLen Brown info_ptr->reserved2 = 0;
14195b482a8SLen Brown
14295b482a8SLen Brown /* Current debug levels */
14395b482a8SLen Brown
14495b482a8SLen Brown info_ptr->debug_layer = acpi_dbg_layer;
14595b482a8SLen Brown info_ptr->debug_level = acpi_dbg_level;
14695b482a8SLen Brown
14795b482a8SLen Brown return_ACPI_STATUS(AE_OK);
14895b482a8SLen Brown }
14995b482a8SLen Brown
ACPI_EXPORT_SYMBOL(acpi_get_system_info)15095b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_get_system_info)
15195b482a8SLen Brown
1529187a415SLv Zheng /*******************************************************************************
1539187a415SLv Zheng *
1549187a415SLv Zheng * FUNCTION: acpi_get_statistics
1559187a415SLv Zheng *
1569187a415SLv Zheng * PARAMETERS: stats - Where the statistics are returned
1579187a415SLv Zheng *
1589187a415SLv Zheng * RETURN: status - the status of the call
1599187a415SLv Zheng *
1609187a415SLv Zheng * DESCRIPTION: Get the contents of the various system counters
1619187a415SLv Zheng *
1629187a415SLv Zheng ******************************************************************************/
1639187a415SLv Zheng acpi_status acpi_get_statistics(struct acpi_statistics *stats)
1649187a415SLv Zheng {
1659187a415SLv Zheng ACPI_FUNCTION_TRACE(acpi_get_statistics);
1669187a415SLv Zheng
1679187a415SLv Zheng /* Parameter validation */
1689187a415SLv Zheng
1699187a415SLv Zheng if (!stats) {
1709187a415SLv Zheng return_ACPI_STATUS(AE_BAD_PARAMETER);
1719187a415SLv Zheng }
1729187a415SLv Zheng
1739187a415SLv Zheng /* Various interrupt-based event counters */
1749187a415SLv Zheng
1759187a415SLv Zheng stats->sci_count = acpi_sci_count;
1769187a415SLv Zheng stats->gpe_count = acpi_gpe_count;
1779187a415SLv Zheng
1784fa4616eSBob Moore memcpy(stats->fixed_event_count, acpi_fixed_event_count,
1799187a415SLv Zheng sizeof(acpi_fixed_event_count));
1809187a415SLv Zheng
1819187a415SLv Zheng /* Other counters */
1829187a415SLv Zheng
1839187a415SLv Zheng stats->method_count = acpi_method_count;
1849187a415SLv Zheng return_ACPI_STATUS(AE_OK);
1859187a415SLv Zheng }
1869187a415SLv Zheng
ACPI_EXPORT_SYMBOL(acpi_get_statistics)1879187a415SLv Zheng ACPI_EXPORT_SYMBOL(acpi_get_statistics)
1889187a415SLv Zheng
18995b482a8SLen Brown /*****************************************************************************
19095b482a8SLen Brown *
19195b482a8SLen Brown * FUNCTION: acpi_install_initialization_handler
19295b482a8SLen Brown *
193ba494beeSBob Moore * PARAMETERS: handler - Callback procedure
194ba494beeSBob Moore * function - Not (currently) used, see below
19595b482a8SLen Brown *
19695b482a8SLen Brown * RETURN: Status
19795b482a8SLen Brown *
19895b482a8SLen Brown * DESCRIPTION: Install an initialization handler
19995b482a8SLen Brown *
20095b482a8SLen Brown * TBD: When a second function is added, must save the Function also.
20195b482a8SLen Brown *
20295b482a8SLen Brown ****************************************************************************/
20395b482a8SLen Brown acpi_status
20495b482a8SLen Brown acpi_install_initialization_handler(acpi_init_handler handler, u32 function)
20595b482a8SLen Brown {
20695b482a8SLen Brown
20795b482a8SLen Brown if (!handler) {
20895b482a8SLen Brown return (AE_BAD_PARAMETER);
20995b482a8SLen Brown }
21095b482a8SLen Brown
21195b482a8SLen Brown if (acpi_gbl_init_handler) {
21295b482a8SLen Brown return (AE_ALREADY_EXISTS);
21395b482a8SLen Brown }
21495b482a8SLen Brown
21595b482a8SLen Brown acpi_gbl_init_handler = handler;
21668aafc35SBob Moore return (AE_OK);
21795b482a8SLen Brown }
21895b482a8SLen Brown
ACPI_EXPORT_SYMBOL(acpi_install_initialization_handler)21995b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_install_initialization_handler)
2204d946f79SLv Zheng #endif
221b0ed7a91SLin Ming
22295b482a8SLen Brown /*****************************************************************************
22395b482a8SLen Brown *
22495b482a8SLen Brown * FUNCTION: acpi_purge_cached_objects
22595b482a8SLen Brown *
22695b482a8SLen Brown * PARAMETERS: None
22795b482a8SLen Brown *
22895b482a8SLen Brown * RETURN: Status
22995b482a8SLen Brown *
23095b482a8SLen Brown * DESCRIPTION: Empty all caches (delete the cached objects)
23195b482a8SLen Brown *
23295b482a8SLen Brown ****************************************************************************/
23395b482a8SLen Brown acpi_status acpi_purge_cached_objects(void)
23495b482a8SLen Brown {
23595b482a8SLen Brown ACPI_FUNCTION_TRACE(acpi_purge_cached_objects);
23695b482a8SLen Brown
23795b482a8SLen Brown (void)acpi_os_purge_cache(acpi_gbl_state_cache);
23895b482a8SLen Brown (void)acpi_os_purge_cache(acpi_gbl_operand_cache);
23995b482a8SLen Brown (void)acpi_os_purge_cache(acpi_gbl_ps_node_cache);
24095b482a8SLen Brown (void)acpi_os_purge_cache(acpi_gbl_ps_node_ext_cache);
24168aafc35SBob Moore
24295b482a8SLen Brown return_ACPI_STATUS(AE_OK);
24395b482a8SLen Brown }
24495b482a8SLen Brown
ACPI_EXPORT_SYMBOL(acpi_purge_cached_objects)24595b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_purge_cached_objects)
246b0ed7a91SLin Ming
247b0ed7a91SLin Ming /*****************************************************************************
248b0ed7a91SLin Ming *
249b0ed7a91SLin Ming * FUNCTION: acpi_install_interface
250b0ed7a91SLin Ming *
251b0ed7a91SLin Ming * PARAMETERS: interface_name - The interface to install
252b0ed7a91SLin Ming *
253b0ed7a91SLin Ming * RETURN: Status
254b0ed7a91SLin Ming *
255b0ed7a91SLin Ming * DESCRIPTION: Install an _OSI interface to the global list
256b0ed7a91SLin Ming *
257b0ed7a91SLin Ming ****************************************************************************/
258b0ed7a91SLin Ming acpi_status acpi_install_interface(acpi_string interface_name)
259b0ed7a91SLin Ming {
260b0ed7a91SLin Ming acpi_status status;
261b0ed7a91SLin Ming struct acpi_interface_info *interface_info;
262b0ed7a91SLin Ming
263b0ed7a91SLin Ming /* Parameter validation */
264b0ed7a91SLin Ming
2654fa4616eSBob Moore if (!interface_name || (strlen(interface_name) == 0)) {
266b0ed7a91SLin Ming return (AE_BAD_PARAMETER);
267b0ed7a91SLin Ming }
268b0ed7a91SLin Ming
269388a9902SJung-uk Kim status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
270388a9902SJung-uk Kim if (ACPI_FAILURE(status)) {
271388a9902SJung-uk Kim return (status);
272388a9902SJung-uk Kim }
273b0ed7a91SLin Ming
274b0ed7a91SLin Ming /* Check if the interface name is already in the global list */
275b0ed7a91SLin Ming
276b0ed7a91SLin Ming interface_info = acpi_ut_get_interface(interface_name);
277b0ed7a91SLin Ming if (interface_info) {
278b0ed7a91SLin Ming /*
279b0ed7a91SLin Ming * The interface already exists in the list. This is OK if the
280b0ed7a91SLin Ming * interface has been marked invalid -- just clear the bit.
281b0ed7a91SLin Ming */
282b0ed7a91SLin Ming if (interface_info->flags & ACPI_OSI_INVALID) {
283b0ed7a91SLin Ming interface_info->flags &= ~ACPI_OSI_INVALID;
284b0ed7a91SLin Ming status = AE_OK;
285b0ed7a91SLin Ming } else {
286b0ed7a91SLin Ming status = AE_ALREADY_EXISTS;
287b0ed7a91SLin Ming }
288b0ed7a91SLin Ming } else {
289b0ed7a91SLin Ming /* New interface name, install into the global list */
290b0ed7a91SLin Ming
291b0ed7a91SLin Ming status = acpi_ut_install_interface(interface_name);
292b0ed7a91SLin Ming }
293b0ed7a91SLin Ming
294b0ed7a91SLin Ming acpi_os_release_mutex(acpi_gbl_osi_mutex);
295b0ed7a91SLin Ming return (status);
296b0ed7a91SLin Ming }
297b0ed7a91SLin Ming
ACPI_EXPORT_SYMBOL(acpi_install_interface)298b0ed7a91SLin Ming ACPI_EXPORT_SYMBOL(acpi_install_interface)
299b0ed7a91SLin Ming
300b0ed7a91SLin Ming /*****************************************************************************
301b0ed7a91SLin Ming *
302b0ed7a91SLin Ming * FUNCTION: acpi_remove_interface
303b0ed7a91SLin Ming *
304b0ed7a91SLin Ming * PARAMETERS: interface_name - The interface to remove
305b0ed7a91SLin Ming *
306b0ed7a91SLin Ming * RETURN: Status
307b0ed7a91SLin Ming *
308b0ed7a91SLin Ming * DESCRIPTION: Remove an _OSI interface from the global list
309b0ed7a91SLin Ming *
310b0ed7a91SLin Ming ****************************************************************************/
311b0ed7a91SLin Ming acpi_status acpi_remove_interface(acpi_string interface_name)
312b0ed7a91SLin Ming {
313b0ed7a91SLin Ming acpi_status status;
314b0ed7a91SLin Ming
315b0ed7a91SLin Ming /* Parameter validation */
316b0ed7a91SLin Ming
3174fa4616eSBob Moore if (!interface_name || (strlen(interface_name) == 0)) {
318b0ed7a91SLin Ming return (AE_BAD_PARAMETER);
319b0ed7a91SLin Ming }
320b0ed7a91SLin Ming
321388a9902SJung-uk Kim status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
322388a9902SJung-uk Kim if (ACPI_FAILURE(status)) {
323388a9902SJung-uk Kim return (status);
324388a9902SJung-uk Kim }
325b0ed7a91SLin Ming
326b0ed7a91SLin Ming status = acpi_ut_remove_interface(interface_name);
327b0ed7a91SLin Ming
328b0ed7a91SLin Ming acpi_os_release_mutex(acpi_gbl_osi_mutex);
329b0ed7a91SLin Ming return (status);
330b0ed7a91SLin Ming }
331b0ed7a91SLin Ming
ACPI_EXPORT_SYMBOL(acpi_remove_interface)332b0ed7a91SLin Ming ACPI_EXPORT_SYMBOL(acpi_remove_interface)
333b0ed7a91SLin Ming
334b0ed7a91SLin Ming /*****************************************************************************
335b0ed7a91SLin Ming *
336b0ed7a91SLin Ming * FUNCTION: acpi_install_interface_handler
337b0ed7a91SLin Ming *
338ba494beeSBob Moore * PARAMETERS: handler - The _OSI interface handler to install
339b0ed7a91SLin Ming * NULL means "remove existing handler"
340b0ed7a91SLin Ming *
341b0ed7a91SLin Ming * RETURN: Status
342b0ed7a91SLin Ming *
343b0ed7a91SLin Ming * DESCRIPTION: Install a handler for the predefined _OSI ACPI method.
344b0ed7a91SLin Ming * invoked during execution of the internal implementation of
345b0ed7a91SLin Ming * _OSI. A NULL handler simply removes any existing handler.
346b0ed7a91SLin Ming *
347b0ed7a91SLin Ming ****************************************************************************/
348b0ed7a91SLin Ming acpi_status acpi_install_interface_handler(acpi_interface_handler handler)
349b0ed7a91SLin Ming {
350388a9902SJung-uk Kim acpi_status status;
351b0ed7a91SLin Ming
352388a9902SJung-uk Kim status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
353388a9902SJung-uk Kim if (ACPI_FAILURE(status)) {
354388a9902SJung-uk Kim return (status);
355388a9902SJung-uk Kim }
356b0ed7a91SLin Ming
357b0ed7a91SLin Ming if (handler && acpi_gbl_interface_handler) {
358b0ed7a91SLin Ming status = AE_ALREADY_EXISTS;
359b0ed7a91SLin Ming } else {
360b0ed7a91SLin Ming acpi_gbl_interface_handler = handler;
361b0ed7a91SLin Ming }
362b0ed7a91SLin Ming
363b0ed7a91SLin Ming acpi_os_release_mutex(acpi_gbl_osi_mutex);
364b0ed7a91SLin Ming return (status);
365b0ed7a91SLin Ming }
366b0ed7a91SLin Ming
ACPI_EXPORT_SYMBOL(acpi_install_interface_handler)367b0ed7a91SLin Ming ACPI_EXPORT_SYMBOL(acpi_install_interface_handler)
368f654c0feSLin Ming
369f654c0feSLin Ming /*****************************************************************************
370f654c0feSLin Ming *
3712cf9f5bcSLv Zheng * FUNCTION: acpi_update_interfaces
3722cf9f5bcSLv Zheng *
3732cf9f5bcSLv Zheng * PARAMETERS: action - Actions to be performed during the
3742cf9f5bcSLv Zheng * update
3752cf9f5bcSLv Zheng *
3762cf9f5bcSLv Zheng * RETURN: Status
3772cf9f5bcSLv Zheng *
3782cf9f5bcSLv Zheng * DESCRIPTION: Update _OSI interface strings, disabling or enabling OS vendor
3792cf9f5bcSLv Zheng * string or/and feature group strings.
3802cf9f5bcSLv Zheng *
3812cf9f5bcSLv Zheng ****************************************************************************/
3822cf9f5bcSLv Zheng acpi_status acpi_update_interfaces(u8 action)
3832cf9f5bcSLv Zheng {
3842cf9f5bcSLv Zheng acpi_status status;
3852cf9f5bcSLv Zheng
3862cf9f5bcSLv Zheng status = acpi_os_acquire_mutex(acpi_gbl_osi_mutex, ACPI_WAIT_FOREVER);
3872cf9f5bcSLv Zheng if (ACPI_FAILURE(status)) {
3882cf9f5bcSLv Zheng return (status);
3892cf9f5bcSLv Zheng }
3902cf9f5bcSLv Zheng
3912cf9f5bcSLv Zheng status = acpi_ut_update_interfaces(action);
3922cf9f5bcSLv Zheng
3932cf9f5bcSLv Zheng acpi_os_release_mutex(acpi_gbl_osi_mutex);
3942cf9f5bcSLv Zheng return (status);
3952cf9f5bcSLv Zheng }
3962cf9f5bcSLv Zheng
3972cf9f5bcSLv Zheng /*****************************************************************************
3982cf9f5bcSLv Zheng *
399f654c0feSLin Ming * FUNCTION: acpi_check_address_range
400f654c0feSLin Ming *
401f654c0feSLin Ming * PARAMETERS: space_id - Address space ID
402ba494beeSBob Moore * address - Start address
403ba494beeSBob Moore * length - Length
404ba494beeSBob Moore * warn - TRUE if warning on overlap desired
405f654c0feSLin Ming *
406f654c0feSLin Ming * RETURN: Count of the number of conflicts detected.
407f654c0feSLin Ming *
408f654c0feSLin Ming * DESCRIPTION: Check if the input address range overlaps any of the
409f654c0feSLin Ming * ASL operation region address ranges.
410f654c0feSLin Ming *
411f654c0feSLin Ming ****************************************************************************/
4122cf9f5bcSLv Zheng
413f654c0feSLin Ming u32
acpi_check_address_range(acpi_adr_space_type space_id,acpi_physical_address address,acpi_size length,u8 warn)414f654c0feSLin Ming acpi_check_address_range(acpi_adr_space_type space_id,
415f654c0feSLin Ming acpi_physical_address address,
416f654c0feSLin Ming acpi_size length, u8 warn)
417f654c0feSLin Ming {
418f654c0feSLin Ming u32 overlaps;
419f654c0feSLin Ming acpi_status status;
420f654c0feSLin Ming
421f654c0feSLin Ming status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
422f654c0feSLin Ming if (ACPI_FAILURE(status)) {
423f654c0feSLin Ming return (0);
424f654c0feSLin Ming }
425f654c0feSLin Ming
426f654c0feSLin Ming overlaps = acpi_ut_check_address_range(space_id, address,
427f654c0feSLin Ming (u32)length, warn);
428f654c0feSLin Ming
429f654c0feSLin Ming (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
430f654c0feSLin Ming return (overlaps);
431f654c0feSLin Ming }
432f654c0feSLin Ming
ACPI_EXPORT_SYMBOL(acpi_check_address_range)433f654c0feSLin Ming ACPI_EXPORT_SYMBOL(acpi_check_address_range)
434b0ed7a91SLin Ming #endif /* !ACPI_ASL_COMPILER */
435be030a57SBob Moore /*******************************************************************************
436be030a57SBob Moore *
437be030a57SBob Moore * FUNCTION: acpi_decode_pld_buffer
438be030a57SBob Moore *
439be030a57SBob Moore * PARAMETERS: in_buffer - Buffer returned by _PLD method
440be030a57SBob Moore * length - Length of the in_buffer
441be030a57SBob Moore * return_buffer - Where the decode buffer is returned
442be030a57SBob Moore *
443be030a57SBob Moore * RETURN: Status and the decoded _PLD buffer. User must deallocate
444be030a57SBob Moore * the buffer via ACPI_FREE.
445be030a57SBob Moore *
446be030a57SBob Moore * DESCRIPTION: Decode the bit-packed buffer returned by the _PLD method into
447be030a57SBob Moore * a local struct that is much more useful to an ACPI driver.
448be030a57SBob Moore *
449be030a57SBob Moore ******************************************************************************/
450be030a57SBob Moore acpi_status
451be030a57SBob Moore acpi_decode_pld_buffer(u8 *in_buffer,
452be030a57SBob Moore acpi_size length, struct acpi_pld_info **return_buffer)
453be030a57SBob Moore {
454be030a57SBob Moore struct acpi_pld_info *pld_info;
455be030a57SBob Moore u32 *buffer = ACPI_CAST_PTR(u32, in_buffer);
456be030a57SBob Moore u32 dword;
457be030a57SBob Moore
458be030a57SBob Moore /* Parameter validation */
459be030a57SBob Moore
46035349697SBob Moore if (!in_buffer || !return_buffer
46135349697SBob Moore || (length < ACPI_PLD_REV1_BUFFER_SIZE)) {
462be030a57SBob Moore return (AE_BAD_PARAMETER);
463be030a57SBob Moore }
464be030a57SBob Moore
465be030a57SBob Moore pld_info = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_pld_info));
466be030a57SBob Moore if (!pld_info) {
467be030a57SBob Moore return (AE_NO_MEMORY);
468be030a57SBob Moore }
469be030a57SBob Moore
470be030a57SBob Moore /* First 32-bit DWord */
471be030a57SBob Moore
472be030a57SBob Moore ACPI_MOVE_32_TO_32(&dword, &buffer[0]);
473be030a57SBob Moore pld_info->revision = ACPI_PLD_GET_REVISION(&dword);
474be030a57SBob Moore pld_info->ignore_color = ACPI_PLD_GET_IGNORE_COLOR(&dword);
4754dcd78d8SBob Moore pld_info->red = ACPI_PLD_GET_RED(&dword);
4764dcd78d8SBob Moore pld_info->green = ACPI_PLD_GET_GREEN(&dword);
4774dcd78d8SBob Moore pld_info->blue = ACPI_PLD_GET_BLUE(&dword);
478be030a57SBob Moore
479be030a57SBob Moore /* Second 32-bit DWord */
480be030a57SBob Moore
481be030a57SBob Moore ACPI_MOVE_32_TO_32(&dword, &buffer[1]);
482be030a57SBob Moore pld_info->width = ACPI_PLD_GET_WIDTH(&dword);
483be030a57SBob Moore pld_info->height = ACPI_PLD_GET_HEIGHT(&dword);
484be030a57SBob Moore
485be030a57SBob Moore /* Third 32-bit DWord */
486be030a57SBob Moore
487be030a57SBob Moore ACPI_MOVE_32_TO_32(&dword, &buffer[2]);
488be030a57SBob Moore pld_info->user_visible = ACPI_PLD_GET_USER_VISIBLE(&dword);
489be030a57SBob Moore pld_info->dock = ACPI_PLD_GET_DOCK(&dword);
490be030a57SBob Moore pld_info->lid = ACPI_PLD_GET_LID(&dword);
491be030a57SBob Moore pld_info->panel = ACPI_PLD_GET_PANEL(&dword);
492be030a57SBob Moore pld_info->vertical_position = ACPI_PLD_GET_VERTICAL(&dword);
493be030a57SBob Moore pld_info->horizontal_position = ACPI_PLD_GET_HORIZONTAL(&dword);
494be030a57SBob Moore pld_info->shape = ACPI_PLD_GET_SHAPE(&dword);
495be030a57SBob Moore pld_info->group_orientation = ACPI_PLD_GET_ORIENTATION(&dword);
496be030a57SBob Moore pld_info->group_token = ACPI_PLD_GET_TOKEN(&dword);
497be030a57SBob Moore pld_info->group_position = ACPI_PLD_GET_POSITION(&dword);
498be030a57SBob Moore pld_info->bay = ACPI_PLD_GET_BAY(&dword);
499be030a57SBob Moore
500be030a57SBob Moore /* Fourth 32-bit DWord */
501be030a57SBob Moore
502be030a57SBob Moore ACPI_MOVE_32_TO_32(&dword, &buffer[3]);
503be030a57SBob Moore pld_info->ejectable = ACPI_PLD_GET_EJECTABLE(&dword);
504be030a57SBob Moore pld_info->ospm_eject_required = ACPI_PLD_GET_OSPM_EJECT(&dword);
505be030a57SBob Moore pld_info->cabinet_number = ACPI_PLD_GET_CABINET(&dword);
506be030a57SBob Moore pld_info->card_cage_number = ACPI_PLD_GET_CARD_CAGE(&dword);
507be030a57SBob Moore pld_info->reference = ACPI_PLD_GET_REFERENCE(&dword);
508be030a57SBob Moore pld_info->rotation = ACPI_PLD_GET_ROTATION(&dword);
509be030a57SBob Moore pld_info->order = ACPI_PLD_GET_ORDER(&dword);
510be030a57SBob Moore
51135349697SBob Moore if (length >= ACPI_PLD_REV2_BUFFER_SIZE) {
512be030a57SBob Moore
513be030a57SBob Moore /* Fifth 32-bit DWord (Revision 2 of _PLD) */
514be030a57SBob Moore
515be030a57SBob Moore ACPI_MOVE_32_TO_32(&dword, &buffer[4]);
516be030a57SBob Moore pld_info->vertical_offset = ACPI_PLD_GET_VERT_OFFSET(&dword);
517be030a57SBob Moore pld_info->horizontal_offset = ACPI_PLD_GET_HORIZ_OFFSET(&dword);
518be030a57SBob Moore }
519be030a57SBob Moore
520be030a57SBob Moore *return_buffer = pld_info;
521be030a57SBob Moore return (AE_OK);
522be030a57SBob Moore }
523be030a57SBob Moore
524be030a57SBob Moore ACPI_EXPORT_SYMBOL(acpi_decode_pld_buffer)
525