1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /******************************************************************************
4 * Module Name: exsystem - Interface to OS services
6 * Copyright (C) 2000 - 2023, Intel Corp.
8 *****************************************************************************/
10 #include <acpi/acpi.h>
14 #define _COMPONENT ACPI_EXECUTER
15 ACPI_MODULE_NAME("exsystem")
17 /*******************************************************************************
19 * FUNCTION: acpi_ex_system_wait_semaphore
21 * PARAMETERS: semaphore - Semaphore to wait on
22 * timeout - Max time to wait
26 * DESCRIPTION: Implements a semaphore wait with a check to see if the
27 * semaphore is available immediately. If it is not, the
28 * interpreter is released before waiting.
30 ******************************************************************************/
31 acpi_status acpi_ex_system_wait_semaphore(acpi_semaphore semaphore, u16 timeout)
35 ACPI_FUNCTION_TRACE(ex_system_wait_semaphore);
37 status = acpi_os_wait_semaphore(semaphore, 1, ACPI_DO_NOT_WAIT);
38 if (ACPI_SUCCESS(status)) {
39 return_ACPI_STATUS(status);
42 if (status == AE_TIME) {
44 /* We must wait, so unlock the interpreter */
46 acpi_ex_exit_interpreter();
47 status = acpi_os_wait_semaphore(semaphore, 1, timeout);
49 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
50 "*** Thread awake after blocking, %s\n",
51 acpi_format_exception(status)));
53 /* Reacquire the interpreter */
55 acpi_ex_enter_interpreter();
58 return_ACPI_STATUS(status);
61 /*******************************************************************************
63 * FUNCTION: acpi_ex_system_wait_mutex
65 * PARAMETERS: mutex - Mutex to wait on
66 * timeout - Max time to wait
70 * DESCRIPTION: Implements a mutex wait with a check to see if the
71 * mutex is available immediately. If it is not, the
72 * interpreter is released before waiting.
74 ******************************************************************************/
76 acpi_status acpi_ex_system_wait_mutex(acpi_mutex mutex, u16 timeout)
80 ACPI_FUNCTION_TRACE(ex_system_wait_mutex);
82 status = acpi_os_acquire_mutex(mutex, ACPI_DO_NOT_WAIT);
83 if (ACPI_SUCCESS(status)) {
84 return_ACPI_STATUS(status);
87 if (status == AE_TIME) {
89 /* We must wait, so unlock the interpreter */
91 acpi_ex_exit_interpreter();
92 status = acpi_os_acquire_mutex(mutex, timeout);
94 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
95 "*** Thread awake after blocking, %s\n",
96 acpi_format_exception(status)));
98 /* Reacquire the interpreter */
100 acpi_ex_enter_interpreter();
103 return_ACPI_STATUS(status);
106 /*******************************************************************************
108 * FUNCTION: acpi_ex_system_do_stall
110 * PARAMETERS: how_long_us - The amount of time to stall,
115 * DESCRIPTION: Suspend running thread for specified amount of time.
116 * Note: ACPI specification requires that Stall() does not
117 * relinquish the processor, and delays longer than 100 usec
118 * should use Sleep() instead. We allow stalls up to 255 usec
119 * for compatibility with other interpreters and existing BIOSs.
121 ******************************************************************************/
123 acpi_status acpi_ex_system_do_stall(u32 how_long_us)
125 acpi_status status = AE_OK;
127 ACPI_FUNCTION_ENTRY();
129 if (how_long_us > 255) {
131 * Longer than 255 microseconds, this is an error
133 * (ACPI specifies 100 usec as max, but this gives some slack in
134 * order to support existing BIOSs)
137 "Time parameter is too large (%u)", how_long_us));
138 status = AE_AML_OPERAND_VALUE;
140 if (how_long_us > 100) {
141 ACPI_WARNING((AE_INFO,
142 "Time parameter %u us > 100 us violating ACPI spec, please fix the firmware.",
145 acpi_os_stall(how_long_us);
151 /*******************************************************************************
153 * FUNCTION: acpi_ex_system_do_sleep
155 * PARAMETERS: how_long_ms - The amount of time to sleep,
160 * DESCRIPTION: Sleep the running thread for specified amount of time.
162 ******************************************************************************/
164 acpi_status acpi_ex_system_do_sleep(u64 how_long_ms)
166 ACPI_FUNCTION_ENTRY();
168 /* Since this thread will sleep, we must release the interpreter */
170 acpi_ex_exit_interpreter();
173 * For compatibility with other ACPI implementations and to prevent
174 * accidental deep sleeps, limit the sleep time to something reasonable.
176 if (how_long_ms > ACPI_MAX_SLEEP) {
177 how_long_ms = ACPI_MAX_SLEEP;
180 acpi_os_sleep(how_long_ms);
182 /* And now we must get the interpreter again */
184 acpi_ex_enter_interpreter();
188 /*******************************************************************************
190 * FUNCTION: acpi_ex_system_signal_event
192 * PARAMETERS: obj_desc - The object descriptor for this op
196 * DESCRIPTION: Provides an access point to perform synchronization operations
199 ******************************************************************************/
201 acpi_status acpi_ex_system_signal_event(union acpi_operand_object * obj_desc)
203 acpi_status status = AE_OK;
205 ACPI_FUNCTION_TRACE(ex_system_signal_event);
209 acpi_os_signal_semaphore(obj_desc->event.os_semaphore, 1);
212 return_ACPI_STATUS(status);
215 /*******************************************************************************
217 * FUNCTION: acpi_ex_system_wait_event
219 * PARAMETERS: time_desc - The 'time to delay' object descriptor
220 * obj_desc - The object descriptor for this op
224 * DESCRIPTION: Provides an access point to perform synchronization operations
225 * within the AML. This operation is a request to wait for an
228 ******************************************************************************/
231 acpi_ex_system_wait_event(union acpi_operand_object *time_desc,
232 union acpi_operand_object *obj_desc)
234 acpi_status status = AE_OK;
236 ACPI_FUNCTION_TRACE(ex_system_wait_event);
240 acpi_ex_system_wait_semaphore(obj_desc->event.os_semaphore,
241 (u16) time_desc->integer.
245 return_ACPI_STATUS(status);
248 /*******************************************************************************
250 * FUNCTION: acpi_ex_system_reset_event
252 * PARAMETERS: obj_desc - The object descriptor for this op
256 * DESCRIPTION: Reset an event to a known state.
258 ******************************************************************************/
260 acpi_status acpi_ex_system_reset_event(union acpi_operand_object *obj_desc)
262 acpi_status status = AE_OK;
263 acpi_semaphore temp_semaphore;
265 ACPI_FUNCTION_ENTRY();
268 * We are going to simply delete the existing semaphore and
272 acpi_os_create_semaphore(ACPI_NO_UNIT_LIMIT, 0, &temp_semaphore);
273 if (ACPI_SUCCESS(status)) {
274 (void)acpi_os_delete_semaphore(obj_desc->event.os_semaphore);
275 obj_desc->event.os_semaphore = temp_semaphore;