]>
Commit | Line | Data |
---|---|---|
c942fddf | 1 | // SPDX-License-Identifier: GPL-2.0-or-later |
1da177e4 LT |
2 | /* |
3 | * acpi_utils.c - ACPI Utility Functions ($Revision: 10 $) | |
4 | * | |
5 | * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com> | |
6 | * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com> | |
1da177e4 LT |
7 | */ |
8 | ||
9 | #include <linux/kernel.h> | |
10 | #include <linux/module.h> | |
5a0e3ad6 | 11 | #include <linux/slab.h> |
1da177e4 LT |
12 | #include <linux/init.h> |
13 | #include <linux/types.h> | |
fbfddae6 TK |
14 | #include <linux/hardirq.h> |
15 | #include <linux/acpi.h> | |
45fef5b8 | 16 | #include <linux/dynamic_debug.h> |
1da177e4 | 17 | |
a192a958 | 18 | #include "internal.h" |
2d12b6b3 | 19 | #include "sleep.h" |
a192a958 | 20 | |
1da177e4 | 21 | #define _COMPONENT ACPI_BUS_COMPONENT |
f52fd66d | 22 | ACPI_MODULE_NAME("utils"); |
1da177e4 LT |
23 | |
24 | /* -------------------------------------------------------------------------- | |
25 | Object Evaluation Helpers | |
26 | -------------------------------------------------------------------------- */ | |
4fd7f518 HH |
27 | static void |
28 | acpi_util_eval_error(acpi_handle h, acpi_string p, acpi_status s) | |
29 | { | |
1da177e4 | 30 | #ifdef ACPI_DEBUG_OUTPUT |
4fd7f518 HH |
31 | char prefix[80] = {'\0'}; |
32 | struct acpi_buffer buffer = {sizeof(prefix), prefix}; | |
33 | acpi_get_name(h, ACPI_FULL_PATHNAME, &buffer); | |
34 | ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Evaluate [%s.%s]: %s\n", | |
35 | (char *) prefix, p, acpi_format_exception(s))); | |
1da177e4 | 36 | #else |
4fd7f518 | 37 | return; |
1da177e4 | 38 | #endif |
4fd7f518 HH |
39 | } |
40 | ||
1da177e4 | 41 | acpi_status |
4be44fcd LB |
42 | acpi_extract_package(union acpi_object *package, |
43 | struct acpi_buffer *format, struct acpi_buffer *buffer) | |
1da177e4 | 44 | { |
4be44fcd LB |
45 | u32 size_required = 0; |
46 | u32 tail_offset = 0; | |
47 | char *format_string = NULL; | |
48 | u32 format_count = 0; | |
49 | u32 i = 0; | |
50 | u8 *head = NULL; | |
51 | u8 *tail = NULL; | |
1da177e4 | 52 | |
1da177e4 | 53 | |
4be44fcd LB |
54 | if (!package || (package->type != ACPI_TYPE_PACKAGE) |
55 | || (package->package.count < 1)) { | |
cece9296 | 56 | printk(KERN_WARNING PREFIX "Invalid package argument\n"); |
d550d98d | 57 | return AE_BAD_PARAMETER; |
1da177e4 LT |
58 | } |
59 | ||
60 | if (!format || !format->pointer || (format->length < 1)) { | |
cece9296 | 61 | printk(KERN_WARNING PREFIX "Invalid format argument\n"); |
d550d98d | 62 | return AE_BAD_PARAMETER; |
1da177e4 LT |
63 | } |
64 | ||
65 | if (!buffer) { | |
cece9296 | 66 | printk(KERN_WARNING PREFIX "Invalid buffer argument\n"); |
d550d98d | 67 | return AE_BAD_PARAMETER; |
1da177e4 LT |
68 | } |
69 | ||
4be44fcd | 70 | format_count = (format->length / sizeof(char)) - 1; |
1da177e4 | 71 | if (format_count > package->package.count) { |
cece9296 LB |
72 | printk(KERN_WARNING PREFIX "Format specifies more objects [%d]" |
73 | " than exist in package [%d].\n", | |
74 | format_count, package->package.count); | |
d550d98d | 75 | return AE_BAD_DATA; |
1da177e4 LT |
76 | } |
77 | ||
50dd0969 | 78 | format_string = format->pointer; |
1da177e4 LT |
79 | |
80 | /* | |
81 | * Calculate size_required. | |
82 | */ | |
4be44fcd | 83 | for (i = 0; i < format_count; i++) { |
1da177e4 LT |
84 | |
85 | union acpi_object *element = &(package->package.elements[i]); | |
86 | ||
1da177e4 LT |
87 | switch (element->type) { |
88 | ||
89 | case ACPI_TYPE_INTEGER: | |
90 | switch (format_string[i]) { | |
91 | case 'N': | |
439913ff LM |
92 | size_required += sizeof(u64); |
93 | tail_offset += sizeof(u64); | |
1da177e4 LT |
94 | break; |
95 | case 'S': | |
4be44fcd | 96 | size_required += |
439913ff | 97 | sizeof(char *) + sizeof(u64) + |
4be44fcd LB |
98 | sizeof(char); |
99 | tail_offset += sizeof(char *); | |
1da177e4 LT |
100 | break; |
101 | default: | |
cece9296 | 102 | printk(KERN_WARNING PREFIX "Invalid package element" |
e7e92ec9 | 103 | " [%d]: got number, expecting" |
cece9296 LB |
104 | " [%c]\n", |
105 | i, format_string[i]); | |
d550d98d | 106 | return AE_BAD_DATA; |
1da177e4 LT |
107 | break; |
108 | } | |
109 | break; | |
110 | ||
111 | case ACPI_TYPE_STRING: | |
112 | case ACPI_TYPE_BUFFER: | |
113 | switch (format_string[i]) { | |
114 | case 'S': | |
4be44fcd LB |
115 | size_required += |
116 | sizeof(char *) + | |
117 | (element->string.length * sizeof(char)) + | |
118 | sizeof(char); | |
119 | tail_offset += sizeof(char *); | |
1da177e4 LT |
120 | break; |
121 | case 'B': | |
4be44fcd | 122 | size_required += |
d93de345 | 123 | sizeof(u8 *) + element->buffer.length; |
4be44fcd | 124 | tail_offset += sizeof(u8 *); |
1da177e4 LT |
125 | break; |
126 | default: | |
cece9296 | 127 | printk(KERN_WARNING PREFIX "Invalid package element" |
a6fc6720 | 128 | " [%d] got string/buffer," |
e7e92ec9 | 129 | " expecting [%c]\n", |
cece9296 | 130 | i, format_string[i]); |
d550d98d | 131 | return AE_BAD_DATA; |
1da177e4 LT |
132 | break; |
133 | } | |
134 | break; | |
e3ec483a ZR |
135 | case ACPI_TYPE_LOCAL_REFERENCE: |
136 | switch (format_string[i]) { | |
137 | case 'R': | |
138 | size_required += sizeof(void *); | |
139 | tail_offset += sizeof(void *); | |
140 | break; | |
141 | default: | |
142 | printk(KERN_WARNING PREFIX "Invalid package element" | |
143 | " [%d] got reference," | |
144 | " expecting [%c]\n", | |
145 | i, format_string[i]); | |
146 | return AE_BAD_DATA; | |
147 | break; | |
148 | } | |
149 | break; | |
1da177e4 LT |
150 | |
151 | case ACPI_TYPE_PACKAGE: | |
152 | default: | |
4be44fcd LB |
153 | ACPI_DEBUG_PRINT((ACPI_DB_INFO, |
154 | "Found unsupported element at index=%d\n", | |
155 | i)); | |
1da177e4 | 156 | /* TBD: handle nested packages... */ |
d550d98d | 157 | return AE_SUPPORT; |
1da177e4 LT |
158 | break; |
159 | } | |
160 | } | |
161 | ||
162 | /* | |
163 | * Validate output buffer. | |
164 | */ | |
e83dda06 | 165 | if (buffer->length == ACPI_ALLOCATE_BUFFER) { |
2d0acb4a | 166 | buffer->pointer = ACPI_ALLOCATE_ZEROED(size_required); |
e83dda06 AS |
167 | if (!buffer->pointer) |
168 | return AE_NO_MEMORY; | |
1da177e4 | 169 | buffer->length = size_required; |
e83dda06 AS |
170 | } else { |
171 | if (buffer->length < size_required) { | |
172 | buffer->length = size_required; | |
173 | return AE_BUFFER_OVERFLOW; | |
174 | } else if (buffer->length != size_required || | |
175 | !buffer->pointer) { | |
176 | return AE_BAD_PARAMETER; | |
177 | } | |
1da177e4 LT |
178 | } |
179 | ||
180 | head = buffer->pointer; | |
181 | tail = buffer->pointer + tail_offset; | |
182 | ||
183 | /* | |
184 | * Extract package data. | |
185 | */ | |
4be44fcd | 186 | for (i = 0; i < format_count; i++) { |
1da177e4 LT |
187 | |
188 | u8 **pointer = NULL; | |
189 | union acpi_object *element = &(package->package.elements[i]); | |
190 | ||
1da177e4 LT |
191 | switch (element->type) { |
192 | ||
193 | case ACPI_TYPE_INTEGER: | |
194 | switch (format_string[i]) { | |
195 | case 'N': | |
439913ff | 196 | *((u64 *) head) = |
4be44fcd | 197 | element->integer.value; |
439913ff | 198 | head += sizeof(u64); |
1da177e4 LT |
199 | break; |
200 | case 'S': | |
4be44fcd | 201 | pointer = (u8 **) head; |
1da177e4 | 202 | *pointer = tail; |
439913ff | 203 | *((u64 *) tail) = |
4be44fcd | 204 | element->integer.value; |
439913ff LM |
205 | head += sizeof(u64 *); |
206 | tail += sizeof(u64); | |
1da177e4 LT |
207 | /* NULL terminate string */ |
208 | *tail = (char)0; | |
209 | tail += sizeof(char); | |
210 | break; | |
211 | default: | |
212 | /* Should never get here */ | |
213 | break; | |
214 | } | |
215 | break; | |
216 | ||
217 | case ACPI_TYPE_STRING: | |
218 | case ACPI_TYPE_BUFFER: | |
219 | switch (format_string[i]) { | |
220 | case 'S': | |
4be44fcd | 221 | pointer = (u8 **) head; |
1da177e4 | 222 | *pointer = tail; |
4be44fcd LB |
223 | memcpy(tail, element->string.pointer, |
224 | element->string.length); | |
225 | head += sizeof(char *); | |
1da177e4 LT |
226 | tail += element->string.length * sizeof(char); |
227 | /* NULL terminate string */ | |
228 | *tail = (char)0; | |
229 | tail += sizeof(char); | |
230 | break; | |
231 | case 'B': | |
4be44fcd | 232 | pointer = (u8 **) head; |
1da177e4 | 233 | *pointer = tail; |
4be44fcd LB |
234 | memcpy(tail, element->buffer.pointer, |
235 | element->buffer.length); | |
236 | head += sizeof(u8 *); | |
d93de345 | 237 | tail += element->buffer.length; |
1da177e4 LT |
238 | break; |
239 | default: | |
240 | /* Should never get here */ | |
241 | break; | |
242 | } | |
243 | break; | |
e3ec483a ZR |
244 | case ACPI_TYPE_LOCAL_REFERENCE: |
245 | switch (format_string[i]) { | |
246 | case 'R': | |
247 | *(void **)head = | |
248 | (void *)element->reference.handle; | |
249 | head += sizeof(void *); | |
250 | break; | |
251 | default: | |
252 | /* Should never get here */ | |
253 | break; | |
254 | } | |
255 | break; | |
1da177e4 LT |
256 | case ACPI_TYPE_PACKAGE: |
257 | /* TBD: handle nested packages... */ | |
258 | default: | |
259 | /* Should never get here */ | |
260 | break; | |
261 | } | |
262 | } | |
263 | ||
d550d98d | 264 | return AE_OK; |
1da177e4 | 265 | } |
1da177e4 | 266 | |
4be44fcd | 267 | EXPORT_SYMBOL(acpi_extract_package); |
1da177e4 LT |
268 | |
269 | acpi_status | |
4be44fcd LB |
270 | acpi_evaluate_integer(acpi_handle handle, |
271 | acpi_string pathname, | |
27663c58 | 272 | struct acpi_object_list *arguments, unsigned long long *data) |
1da177e4 | 273 | { |
4be44fcd | 274 | acpi_status status = AE_OK; |
40599072 | 275 | union acpi_object element; |
4be44fcd | 276 | struct acpi_buffer buffer = { 0, NULL }; |
1da177e4 | 277 | |
1da177e4 | 278 | if (!data) |
d550d98d | 279 | return AE_BAD_PARAMETER; |
1da177e4 | 280 | |
1da177e4 | 281 | buffer.length = sizeof(union acpi_object); |
40599072 | 282 | buffer.pointer = &element; |
1da177e4 LT |
283 | status = acpi_evaluate_object(handle, pathname, arguments, &buffer); |
284 | if (ACPI_FAILURE(status)) { | |
285 | acpi_util_eval_error(handle, pathname, status); | |
d550d98d | 286 | return status; |
1da177e4 LT |
287 | } |
288 | ||
40599072 | 289 | if (element.type != ACPI_TYPE_INTEGER) { |
1da177e4 | 290 | acpi_util_eval_error(handle, pathname, AE_BAD_DATA); |
d550d98d | 291 | return AE_BAD_DATA; |
1da177e4 LT |
292 | } |
293 | ||
40599072 | 294 | *data = element.integer.value; |
1da177e4 | 295 | |
27663c58 | 296 | ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Return value [%llu]\n", *data)); |
1da177e4 | 297 | |
d550d98d | 298 | return AE_OK; |
1da177e4 | 299 | } |
1da177e4 | 300 | |
4be44fcd | 301 | EXPORT_SYMBOL(acpi_evaluate_integer); |
1da177e4 | 302 | |
1da177e4 | 303 | acpi_status |
4be44fcd LB |
304 | acpi_evaluate_reference(acpi_handle handle, |
305 | acpi_string pathname, | |
306 | struct acpi_object_list *arguments, | |
307 | struct acpi_handle_list *list) | |
1da177e4 | 308 | { |
4be44fcd LB |
309 | acpi_status status = AE_OK; |
310 | union acpi_object *package = NULL; | |
311 | union acpi_object *element = NULL; | |
312 | struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL }; | |
313 | u32 i = 0; | |
1da177e4 | 314 | |
1da177e4 LT |
315 | |
316 | if (!list) { | |
d550d98d | 317 | return AE_BAD_PARAMETER; |
1da177e4 LT |
318 | } |
319 | ||
320 | /* Evaluate object. */ | |
321 | ||
322 | status = acpi_evaluate_object(handle, pathname, arguments, &buffer); | |
323 | if (ACPI_FAILURE(status)) | |
324 | goto end; | |
325 | ||
50dd0969 | 326 | package = buffer.pointer; |
1da177e4 LT |
327 | |
328 | if ((buffer.length == 0) || !package) { | |
1da177e4 LT |
329 | status = AE_BAD_DATA; |
330 | acpi_util_eval_error(handle, pathname, status); | |
331 | goto end; | |
332 | } | |
333 | if (package->type != ACPI_TYPE_PACKAGE) { | |
1da177e4 LT |
334 | status = AE_BAD_DATA; |
335 | acpi_util_eval_error(handle, pathname, status); | |
336 | goto end; | |
337 | } | |
338 | if (!package->package.count) { | |
1da177e4 LT |
339 | status = AE_BAD_DATA; |
340 | acpi_util_eval_error(handle, pathname, status); | |
341 | goto end; | |
342 | } | |
343 | ||
344 | if (package->package.count > ACPI_MAX_HANDLES) { | |
09e15086 | 345 | kfree(package); |
d550d98d | 346 | return AE_NO_MEMORY; |
1da177e4 LT |
347 | } |
348 | list->count = package->package.count; | |
349 | ||
350 | /* Extract package data. */ | |
351 | ||
352 | for (i = 0; i < list->count; i++) { | |
353 | ||
354 | element = &(package->package.elements[i]); | |
355 | ||
cd0b2248 | 356 | if (element->type != ACPI_TYPE_LOCAL_REFERENCE) { |
1da177e4 | 357 | status = AE_BAD_DATA; |
1da177e4 LT |
358 | acpi_util_eval_error(handle, pathname, status); |
359 | break; | |
360 | } | |
361 | ||
b6a16387 | 362 | if (!element->reference.handle) { |
b6a16387 | 363 | status = AE_NULL_ENTRY; |
c48cf1b9 | 364 | acpi_util_eval_error(handle, pathname, status); |
b6a16387 TR |
365 | break; |
366 | } | |
1da177e4 LT |
367 | /* Get the acpi_handle. */ |
368 | ||
369 | list->handles[i] = element->reference.handle; | |
370 | ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Found reference [%p]\n", | |
4be44fcd | 371 | list->handles[i])); |
1da177e4 LT |
372 | } |
373 | ||
4be44fcd | 374 | end: |
1da177e4 LT |
375 | if (ACPI_FAILURE(status)) { |
376 | list->count = 0; | |
377 | //kfree(list->handles); | |
378 | } | |
379 | ||
02438d87 | 380 | kfree(buffer.pointer); |
1da177e4 | 381 | |
d550d98d | 382 | return status; |
1da177e4 | 383 | } |
1da177e4 | 384 | |
4be44fcd | 385 | EXPORT_SYMBOL(acpi_evaluate_reference); |
38ac0f1b MG |
386 | |
387 | acpi_status | |
8ede06ab | 388 | acpi_get_physical_device_location(acpi_handle handle, struct acpi_pld_info **pld) |
38ac0f1b MG |
389 | { |
390 | acpi_status status; | |
391 | struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL }; | |
392 | union acpi_object *output; | |
393 | ||
394 | status = acpi_evaluate_object(handle, "_PLD", NULL, &buffer); | |
395 | ||
396 | if (ACPI_FAILURE(status)) | |
397 | return status; | |
398 | ||
399 | output = buffer.pointer; | |
400 | ||
401 | if (!output || output->type != ACPI_TYPE_PACKAGE | |
402 | || !output->package.count | |
403 | || output->package.elements[0].type != ACPI_TYPE_BUFFER | |
8ede06ab | 404 | || output->package.elements[0].buffer.length < ACPI_PLD_REV1_BUFFER_SIZE) { |
38ac0f1b MG |
405 | status = AE_TYPE; |
406 | goto out; | |
407 | } | |
408 | ||
8ede06ab FT |
409 | status = acpi_decode_pld_buffer( |
410 | output->package.elements[0].buffer.pointer, | |
411 | output->package.elements[0].buffer.length, | |
412 | pld); | |
413 | ||
38ac0f1b MG |
414 | out: |
415 | kfree(buffer.pointer); | |
416 | return status; | |
417 | } | |
418 | EXPORT_SYMBOL(acpi_get_physical_device_location); | |
275c58d7 TK |
419 | |
420 | /** | |
700b8422 | 421 | * acpi_evaluate_ost: Evaluate _OST for hotplug operations |
275c58d7 TK |
422 | * @handle: ACPI device handle |
423 | * @source_event: source event code | |
424 | * @status_code: status code | |
425 | * @status_buf: optional detailed information (NULL if none) | |
426 | * | |
427 | * Evaluate _OST for hotplug operations. All ACPI hotplug handlers | |
428 | * must call this function when evaluating _OST for hotplug operations. | |
429 | * When the platform does not support _OST, this function has no effect. | |
430 | */ | |
431 | acpi_status | |
05730c19 JL |
432 | acpi_evaluate_ost(acpi_handle handle, u32 source_event, u32 status_code, |
433 | struct acpi_buffer *status_buf) | |
275c58d7 | 434 | { |
275c58d7 TK |
435 | union acpi_object params[3] = { |
436 | {.type = ACPI_TYPE_INTEGER,}, | |
437 | {.type = ACPI_TYPE_INTEGER,}, | |
438 | {.type = ACPI_TYPE_BUFFER,} | |
439 | }; | |
440 | struct acpi_object_list arg_list = {3, params}; | |
275c58d7 TK |
441 | |
442 | params[0].integer.value = source_event; | |
443 | params[1].integer.value = status_code; | |
444 | if (status_buf != NULL) { | |
445 | params[2].buffer.pointer = status_buf->pointer; | |
446 | params[2].buffer.length = status_buf->length; | |
447 | } else { | |
448 | params[2].buffer.pointer = NULL; | |
449 | params[2].buffer.length = 0; | |
450 | } | |
451 | ||
05730c19 | 452 | return acpi_evaluate_object(handle, "_OST", &arg_list, NULL); |
275c58d7 | 453 | } |
05730c19 | 454 | EXPORT_SYMBOL(acpi_evaluate_ost); |
fbfddae6 | 455 | |
45fef5b8 BM |
456 | /** |
457 | * acpi_handle_path: Return the object path of handle | |
458 | * | |
459 | * Caller must free the returned buffer | |
460 | */ | |
461 | static char *acpi_handle_path(acpi_handle handle) | |
462 | { | |
463 | struct acpi_buffer buffer = { | |
464 | .length = ACPI_ALLOCATE_BUFFER, | |
465 | .pointer = NULL | |
466 | }; | |
467 | ||
468 | if (in_interrupt() || | |
469 | acpi_get_name(handle, ACPI_FULL_PATHNAME, &buffer) != AE_OK) | |
470 | return NULL; | |
471 | return buffer.pointer; | |
472 | } | |
473 | ||
fbfddae6 TK |
474 | /** |
475 | * acpi_handle_printk: Print message with ACPI prefix and object path | |
476 | * | |
477 | * This function is called through acpi_handle_<level> macros and prints | |
478 | * a message with ACPI prefix and object path. This function acquires | |
479 | * the global namespace mutex to obtain an object path. In interrupt | |
480 | * context, it shows the object path as <n/a>. | |
481 | */ | |
482 | void | |
483 | acpi_handle_printk(const char *level, acpi_handle handle, const char *fmt, ...) | |
484 | { | |
485 | struct va_format vaf; | |
486 | va_list args; | |
fbfddae6 TK |
487 | const char *path; |
488 | ||
489 | va_start(args, fmt); | |
490 | vaf.fmt = fmt; | |
491 | vaf.va = &args; | |
492 | ||
45fef5b8 BM |
493 | path = acpi_handle_path(handle); |
494 | printk("%sACPI: %s: %pV", level, path ? path : "<n/a>" , &vaf); | |
fbfddae6 TK |
495 | |
496 | va_end(args); | |
45fef5b8 | 497 | kfree(path); |
fbfddae6 TK |
498 | } |
499 | EXPORT_SYMBOL(acpi_handle_printk); | |
952c63e9 | 500 | |
45fef5b8 BM |
501 | #if defined(CONFIG_DYNAMIC_DEBUG) |
502 | /** | |
503 | * __acpi_handle_debug: pr_debug with ACPI prefix and object path | |
504 | * | |
505 | * This function is called through acpi_handle_debug macro and debug | |
506 | * prints a message with ACPI prefix and object path. This function | |
507 | * acquires the global namespace mutex to obtain an object path. In | |
508 | * interrupt context, it shows the object path as <n/a>. | |
509 | */ | |
510 | void | |
511 | __acpi_handle_debug(struct _ddebug *descriptor, acpi_handle handle, | |
512 | const char *fmt, ...) | |
513 | { | |
514 | struct va_format vaf; | |
515 | va_list args; | |
516 | const char *path; | |
517 | ||
518 | va_start(args, fmt); | |
519 | vaf.fmt = fmt; | |
520 | vaf.va = &args; | |
521 | ||
522 | path = acpi_handle_path(handle); | |
523 | __dynamic_pr_debug(descriptor, "ACPI: %s: %pV", path ? path : "<n/a>", &vaf); | |
524 | ||
525 | va_end(args); | |
526 | kfree(path); | |
527 | } | |
528 | EXPORT_SYMBOL(__acpi_handle_debug); | |
529 | #endif | |
530 | ||
952c63e9 JL |
531 | /** |
532 | * acpi_has_method: Check whether @handle has a method named @name | |
533 | * @handle: ACPI device handle | |
534 | * @name: name of object or method | |
535 | * | |
536 | * Check whether @handle has a method named @name. | |
537 | */ | |
538 | bool acpi_has_method(acpi_handle handle, char *name) | |
539 | { | |
540 | acpi_handle tmp; | |
541 | ||
542 | return ACPI_SUCCESS(acpi_get_handle(handle, name, &tmp)); | |
543 | } | |
544 | EXPORT_SYMBOL(acpi_has_method); | |
0db98202 JL |
545 | |
546 | acpi_status acpi_execute_simple_method(acpi_handle handle, char *method, | |
547 | u64 arg) | |
548 | { | |
549 | union acpi_object obj = { .type = ACPI_TYPE_INTEGER }; | |
550 | struct acpi_object_list arg_list = { .count = 1, .pointer = &obj, }; | |
551 | ||
552 | obj.integer.value = arg; | |
553 | ||
554 | return acpi_evaluate_object(handle, method, &arg_list, NULL); | |
555 | } | |
556 | EXPORT_SYMBOL(acpi_execute_simple_method); | |
7d2421f8 JL |
557 | |
558 | /** | |
559 | * acpi_evaluate_ej0: Evaluate _EJ0 method for hotplug operations | |
560 | * @handle: ACPI device handle | |
561 | * | |
562 | * Evaluate device's _EJ0 method for hotplug operations. | |
563 | */ | |
564 | acpi_status acpi_evaluate_ej0(acpi_handle handle) | |
565 | { | |
566 | acpi_status status; | |
567 | ||
568 | status = acpi_execute_simple_method(handle, "_EJ0", 1); | |
569 | if (status == AE_NOT_FOUND) | |
570 | acpi_handle_warn(handle, "No _EJ0 support for device\n"); | |
571 | else if (ACPI_FAILURE(status)) | |
572 | acpi_handle_warn(handle, "Eject failed (0x%x)\n", status); | |
573 | ||
574 | return status; | |
575 | } | |
576 | ||
577 | /** | |
578 | * acpi_evaluate_lck: Evaluate _LCK method to lock/unlock device | |
579 | * @handle: ACPI device handle | |
580 | * @lock: lock device if non-zero, otherwise unlock device | |
581 | * | |
582 | * Evaluate device's _LCK method if present to lock/unlock device | |
583 | */ | |
584 | acpi_status acpi_evaluate_lck(acpi_handle handle, int lock) | |
585 | { | |
586 | acpi_status status; | |
587 | ||
588 | status = acpi_execute_simple_method(handle, "_LCK", !!lock); | |
589 | if (ACPI_FAILURE(status) && status != AE_NOT_FOUND) { | |
590 | if (lock) | |
591 | acpi_handle_warn(handle, | |
592 | "Locking device failed (0x%x)\n", status); | |
593 | else | |
594 | acpi_handle_warn(handle, | |
595 | "Unlocking device failed (0x%x)\n", status); | |
596 | } | |
597 | ||
598 | return status; | |
599 | } | |
a65ac520 JL |
600 | |
601 | /** | |
602 | * acpi_evaluate_dsm - evaluate device's _DSM method | |
603 | * @handle: ACPI device handle | |
94116f81 | 604 | * @guid: GUID of requested functions, should be 16 bytes |
a65ac520 JL |
605 | * @rev: revision number of requested function |
606 | * @func: requested function number | |
607 | * @argv4: the function specific parameter | |
608 | * | |
94116f81 | 609 | * Evaluate device's _DSM method with specified GUID, revision id and |
a65ac520 JL |
610 | * function number. Caller needs to free the returned object. |
611 | * | |
612 | * Though ACPI defines the fourth parameter for _DSM should be a package, | |
613 | * some old BIOSes do expect a buffer or an integer etc. | |
614 | */ | |
615 | union acpi_object * | |
94116f81 | 616 | acpi_evaluate_dsm(acpi_handle handle, const guid_t *guid, u64 rev, u64 func, |
a65ac520 JL |
617 | union acpi_object *argv4) |
618 | { | |
619 | acpi_status ret; | |
620 | struct acpi_buffer buf = {ACPI_ALLOCATE_BUFFER, NULL}; | |
621 | union acpi_object params[4]; | |
622 | struct acpi_object_list input = { | |
623 | .count = 4, | |
624 | .pointer = params, | |
625 | }; | |
626 | ||
627 | params[0].type = ACPI_TYPE_BUFFER; | |
628 | params[0].buffer.length = 16; | |
94116f81 | 629 | params[0].buffer.pointer = (u8 *)guid; |
a65ac520 JL |
630 | params[1].type = ACPI_TYPE_INTEGER; |
631 | params[1].integer.value = rev; | |
632 | params[2].type = ACPI_TYPE_INTEGER; | |
633 | params[2].integer.value = func; | |
634 | if (argv4) { | |
635 | params[3] = *argv4; | |
636 | } else { | |
637 | params[3].type = ACPI_TYPE_PACKAGE; | |
638 | params[3].package.count = 0; | |
639 | params[3].package.elements = NULL; | |
640 | } | |
641 | ||
642 | ret = acpi_evaluate_object(handle, "_DSM", &input, &buf); | |
643 | if (ACPI_SUCCESS(ret)) | |
644 | return (union acpi_object *)buf.pointer; | |
645 | ||
646 | if (ret != AE_NOT_FOUND) | |
647 | acpi_handle_warn(handle, | |
648 | "failed to evaluate _DSM (0x%x)\n", ret); | |
649 | ||
650 | return NULL; | |
651 | } | |
652 | EXPORT_SYMBOL(acpi_evaluate_dsm); | |
653 | ||
654 | /** | |
655 | * acpi_check_dsm - check if _DSM method supports requested functions. | |
656 | * @handle: ACPI device handle | |
94116f81 | 657 | * @guid: GUID of requested functions, should be 16 bytes at least |
a65ac520 JL |
658 | * @rev: revision number of requested functions |
659 | * @funcs: bitmap of requested functions | |
a65ac520 JL |
660 | * |
661 | * Evaluate device's _DSM method to check whether it supports requested | |
662 | * functions. Currently only support 64 functions at maximum, should be | |
663 | * enough for now. | |
664 | */ | |
94116f81 | 665 | bool acpi_check_dsm(acpi_handle handle, const guid_t *guid, u64 rev, u64 funcs) |
a65ac520 JL |
666 | { |
667 | int i; | |
668 | u64 mask = 0; | |
669 | union acpi_object *obj; | |
670 | ||
a7225598 DW |
671 | if (funcs == 0) |
672 | return false; | |
673 | ||
94116f81 | 674 | obj = acpi_evaluate_dsm(handle, guid, rev, 0, NULL); |
a65ac520 JL |
675 | if (!obj) |
676 | return false; | |
677 | ||
678 | /* For compatibility, old BIOSes may return an integer */ | |
679 | if (obj->type == ACPI_TYPE_INTEGER) | |
680 | mask = obj->integer.value; | |
681 | else if (obj->type == ACPI_TYPE_BUFFER) | |
682 | for (i = 0; i < obj->buffer.length && i < 8; i++) | |
4a798f50 | 683 | mask |= (((u64)obj->buffer.pointer[i]) << (i * 8)); |
a65ac520 JL |
684 | ACPI_FREE(obj); |
685 | ||
686 | /* | |
687 | * Bit 0 indicates whether there's support for any functions other than | |
94116f81 | 688 | * function 0 for the specified GUID and revision. |
a65ac520 JL |
689 | */ |
690 | if ((mask & 0x1) && (mask & funcs) == funcs) | |
691 | return true; | |
692 | ||
693 | return false; | |
694 | } | |
695 | EXPORT_SYMBOL(acpi_check_dsm); | |
14ca7a47 | 696 | |
2d12b6b3 | 697 | /** |
c68ae33e | 698 | * acpi_dev_found - Detect presence of a given ACPI device in the namespace. |
2d12b6b3 LW |
699 | * @hid: Hardware ID of the device. |
700 | * | |
701 | * Return %true if the device was present at the moment of invocation. | |
702 | * Note that if the device is pluggable, it may since have disappeared. | |
703 | * | |
704 | * For this function to work, acpi_bus_scan() must have been executed | |
705 | * which happens in the subsys_initcall() subsection. Hence, do not | |
706 | * call from a subsys_initcall() or earlier (use acpi_get_devices() | |
707 | * instead). Calling from module_init() is fine (which is synonymous | |
708 | * with device_initcall()). | |
709 | */ | |
c68ae33e | 710 | bool acpi_dev_found(const char *hid) |
2d12b6b3 LW |
711 | { |
712 | struct acpi_device_bus_id *acpi_device_bus_id; | |
713 | bool found = false; | |
714 | ||
715 | mutex_lock(&acpi_device_lock); | |
716 | list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node) | |
717 | if (!strcmp(acpi_device_bus_id->bus_id, hid)) { | |
718 | found = true; | |
719 | break; | |
720 | } | |
721 | mutex_unlock(&acpi_device_lock); | |
722 | ||
723 | return found; | |
724 | } | |
c68ae33e | 725 | EXPORT_SYMBOL(acpi_dev_found); |
2d12b6b3 | 726 | |
67dcf8a3 AS |
727 | struct acpi_dev_match_info { |
728 | const char *dev_name; | |
817b4d64 | 729 | struct acpi_device *adev; |
8661423e HG |
730 | struct acpi_device_id hid[2]; |
731 | const char *uid; | |
732 | s64 hrv; | |
733 | }; | |
734 | ||
67dcf8a3 | 735 | static int acpi_dev_match_cb(struct device *dev, void *data) |
8661423e HG |
736 | { |
737 | struct acpi_device *adev = to_acpi_device(dev); | |
67dcf8a3 | 738 | struct acpi_dev_match_info *match = data; |
8661423e HG |
739 | unsigned long long hrv; |
740 | acpi_status status; | |
741 | ||
742 | if (acpi_match_device_ids(adev, match->hid)) | |
743 | return 0; | |
744 | ||
745 | if (match->uid && (!adev->pnp.unique_id || | |
746 | strcmp(adev->pnp.unique_id, match->uid))) | |
747 | return 0; | |
748 | ||
67dcf8a3 | 749 | match->dev_name = acpi_dev_name(adev); |
817b4d64 | 750 | match->adev = adev; |
67dcf8a3 | 751 | |
8661423e HG |
752 | if (match->hrv == -1) |
753 | return 1; | |
754 | ||
755 | status = acpi_evaluate_integer(adev->handle, "_HRV", NULL, &hrv); | |
756 | if (ACPI_FAILURE(status)) | |
757 | return 0; | |
758 | ||
759 | return hrv == match->hrv; | |
760 | } | |
761 | ||
762 | /** | |
763 | * acpi_dev_present - Detect that a given ACPI device is present | |
764 | * @hid: Hardware ID of the device. | |
765 | * @uid: Unique ID of the device, pass NULL to not check _UID | |
766 | * @hrv: Hardware Revision of the device, pass -1 to not check _HRV | |
767 | * | |
768 | * Return %true if a matching device was present at the moment of invocation. | |
769 | * Note that if the device is pluggable, it may since have disappeared. | |
770 | * | |
771 | * Note that unlike acpi_dev_found() this function checks the status | |
772 | * of the device. So for devices which are present in the dsdt, but | |
773 | * which are disabled (their _STA callback returns 0) this function | |
774 | * will return false. | |
775 | * | |
776 | * For this function to work, acpi_bus_scan() must have been executed | |
777 | * which happens in the subsys_initcall() subsection. Hence, do not | |
778 | * call from a subsys_initcall() or earlier (use acpi_get_devices() | |
779 | * instead). Calling from module_init() is fine (which is synonymous | |
780 | * with device_initcall()). | |
781 | */ | |
782 | bool acpi_dev_present(const char *hid, const char *uid, s64 hrv) | |
783 | { | |
67dcf8a3 | 784 | struct acpi_dev_match_info match = {}; |
8661423e HG |
785 | struct device *dev; |
786 | ||
787 | strlcpy(match.hid[0].id, hid, sizeof(match.hid[0].id)); | |
788 | match.uid = uid; | |
789 | match.hrv = hrv; | |
790 | ||
67dcf8a3 | 791 | dev = bus_find_device(&acpi_bus_type, NULL, &match, acpi_dev_match_cb); |
54e3aca8 | 792 | put_device(dev); |
8661423e HG |
793 | return !!dev; |
794 | } | |
795 | EXPORT_SYMBOL(acpi_dev_present); | |
796 | ||
67dcf8a3 | 797 | /** |
817b4d64 | 798 | * acpi_dev_get_first_match_dev - Return the first match of ACPI device |
67dcf8a3 AS |
799 | * @hid: Hardware ID of the device. |
800 | * @uid: Unique ID of the device, pass NULL to not check _UID | |
801 | * @hrv: Hardware Revision of the device, pass -1 to not check _HRV | |
802 | * | |
817b4d64 | 803 | * Return the first match of ACPI device if a matching device was present |
67dcf8a3 AS |
804 | * at the moment of invocation, or NULL otherwise. |
805 | * | |
817b4d64 AS |
806 | * The caller is responsible to call put_device() on the returned device. |
807 | * | |
67dcf8a3 AS |
808 | * See additional information in acpi_dev_present() as well. |
809 | */ | |
817b4d64 AS |
810 | struct acpi_device * |
811 | acpi_dev_get_first_match_dev(const char *hid, const char *uid, s64 hrv) | |
812 | { | |
813 | struct acpi_dev_match_info match = {}; | |
814 | struct device *dev; | |
815 | ||
816 | strlcpy(match.hid[0].id, hid, sizeof(match.hid[0].id)); | |
817 | match.uid = uid; | |
818 | match.hrv = hrv; | |
819 | ||
820 | dev = bus_find_device(&acpi_bus_type, NULL, &match, acpi_dev_match_cb); | |
821 | return dev ? match.adev : NULL; | |
822 | } | |
823 | EXPORT_SYMBOL(acpi_dev_get_first_match_dev); | |
824 | ||
14ca7a47 HG |
825 | /* |
826 | * acpi_backlight= handling, this is done here rather then in video_detect.c | |
827 | * because __setup cannot be used in modules. | |
828 | */ | |
829 | char acpi_video_backlight_string[16]; | |
830 | EXPORT_SYMBOL(acpi_video_backlight_string); | |
831 | ||
832 | static int __init acpi_backlight(char *str) | |
833 | { | |
834 | strlcpy(acpi_video_backlight_string, str, | |
835 | sizeof(acpi_video_backlight_string)); | |
836 | return 1; | |
837 | } | |
838 | __setup("acpi_backlight=", acpi_backlight); | |
5aa5911a TK |
839 | |
840 | /** | |
841 | * acpi_match_platform_list - Check if the system matches with a given list | |
842 | * @plat: pointer to acpi_platform_list table terminated by a NULL entry | |
843 | * | |
844 | * Return the matched index if the system is found in the platform list. | |
845 | * Otherwise, return a negative error code. | |
846 | */ | |
847 | int acpi_match_platform_list(const struct acpi_platform_list *plat) | |
848 | { | |
849 | struct acpi_table_header hdr; | |
850 | int idx = 0; | |
851 | ||
852 | if (acpi_disabled) | |
853 | return -ENODEV; | |
854 | ||
855 | for (; plat->oem_id[0]; plat++, idx++) { | |
856 | if (ACPI_FAILURE(acpi_get_table_header(plat->table, 0, &hdr))) | |
857 | continue; | |
858 | ||
859 | if (strncmp(plat->oem_id, hdr.oem_id, ACPI_OEM_ID_SIZE)) | |
860 | continue; | |
861 | ||
862 | if (strncmp(plat->oem_table_id, hdr.oem_table_id, ACPI_OEM_TABLE_ID_SIZE)) | |
863 | continue; | |
864 | ||
865 | if ((plat->pred == all_versions) || | |
866 | (plat->pred == less_than_or_equal && hdr.oem_revision <= plat->oem_revision) || | |
867 | (plat->pred == greater_than_or_equal && hdr.oem_revision >= plat->oem_revision) || | |
868 | (plat->pred == equal && hdr.oem_revision == plat->oem_revision)) | |
869 | return idx; | |
870 | } | |
871 | ||
872 | return -ENODEV; | |
873 | } | |
874 | EXPORT_SYMBOL(acpi_match_platform_list); |