xref: /netbsd-src/sys/dev/acpi/wmi/wmi_acpi.c (revision 181254a7b1bdde6873432bffef2d2decc4b5c22f)
1 /*	$NetBSD: wmi_acpi.c,v 1.16 2017/12/03 17:34:50 bouyer Exp $	*/
2 
3 /*-
4  * Copyright (c) 2009, 2010 Jukka Ruohonen <jruohonen@iki.fi>
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 #include <sys/cdefs.h>
30 __KERNEL_RCSID(0, "$NetBSD: wmi_acpi.c,v 1.16 2017/12/03 17:34:50 bouyer Exp $");
31 
32 #include <sys/param.h>
33 #include <sys/device.h>
34 #include <sys/endian.h>
35 #include <sys/kmem.h>
36 #include <sys/systm.h>
37 #include <sys/module.h>
38 
39 #include <dev/acpi/acpireg.h>
40 #include <dev/acpi/acpivar.h>
41 #include <dev/acpi/acpi_ecvar.h>
42 #include <dev/acpi/wmi/wmi_acpivar.h>
43 
44 #define _COMPONENT          ACPI_RESOURCE_COMPONENT
45 ACPI_MODULE_NAME            ("wmi_acpi")
46 
47 /*
48  * This implements something called "Microsoft Windows Management
49  * Instrumentation" (WMI). This subset of ACPI is desribed in:
50  *
51  * http://www.microsoft.com/whdc/system/pnppwr/wmi/wmi-acpi.mspx
52  *
53  * (Obtained on Thu Feb 12 18:21:44 EET 2009.)
54  */
55 
56 static int		acpi_wmi_match(device_t, cfdata_t, void *);
57 static void		acpi_wmi_attach(device_t, device_t, void *);
58 static int		acpi_wmi_detach(device_t, int);
59 static int		acpi_wmi_rescan(device_t, const char *, const int *);
60 static void		acpi_wmi_childdet(device_t, device_t);
61 static int		acpi_wmi_print(void *, const char *);
62 static bool		acpi_wmi_init(struct acpi_wmi_softc *);
63 static void		acpi_wmi_init_ec(struct acpi_wmi_softc *);
64 static void		acpi_wmi_add(struct acpi_wmi_softc *, ACPI_OBJECT *);
65 static void		acpi_wmi_del(struct acpi_wmi_softc *);
66 static void		acpi_wmi_dump(struct acpi_wmi_softc *);
67 static ACPI_STATUS	acpi_wmi_guid_get(struct acpi_wmi_softc *,
68 				const char *, struct wmi_t **);
69 static void		acpi_wmi_event_add(struct acpi_wmi_softc *);
70 static void		acpi_wmi_event_del(struct acpi_wmi_softc *);
71 static void		acpi_wmi_event_handler(ACPI_HANDLE, uint32_t, void *);
72 static ACPI_STATUS	acpi_wmi_ec_handler(uint32_t, ACPI_PHYSICAL_ADDRESS,
73 				uint32_t, ACPI_INTEGER *, void *, void *);
74 static bool		acpi_wmi_suspend(device_t, const pmf_qual_t *);
75 static bool		acpi_wmi_resume(device_t, const pmf_qual_t *);
76 static ACPI_STATUS	acpi_wmi_enable_event(ACPI_HANDLE, uint8_t, bool);
77 static ACPI_STATUS	acpi_wmi_enable_collection(ACPI_HANDLE, const char *, bool);
78 static bool		acpi_wmi_input(struct wmi_t *, uint8_t, uint8_t);
79 
80 const char * const acpi_wmi_ids[] = {
81 	"PNP0C14",
82 	"pnp0c14",
83 	NULL
84 };
85 
86 CFATTACH_DECL2_NEW(acpiwmi, sizeof(struct acpi_wmi_softc),
87     acpi_wmi_match, acpi_wmi_attach, acpi_wmi_detach, NULL,
88     acpi_wmi_rescan, acpi_wmi_childdet);
89 
90 static int
91 acpi_wmi_match(device_t parent, cfdata_t match, void *aux)
92 {
93 	struct acpi_attach_args *aa = aux;
94 
95 	if (aa->aa_node->ad_type != ACPI_TYPE_DEVICE)
96 		return 0;
97 
98 	return acpi_match_hid(aa->aa_node->ad_devinfo, acpi_wmi_ids);
99 }
100 
101 static void
102 acpi_wmi_attach(device_t parent, device_t self, void *aux)
103 {
104 	struct acpi_wmi_softc *sc = device_private(self);
105 	struct acpi_attach_args *aa = aux;
106 
107 	sc->sc_dev = self;
108 	sc->sc_node = aa->aa_node;
109 
110 	sc->sc_child = NULL;
111 	sc->sc_ecdev = NULL;
112 	sc->sc_handler = NULL;
113 
114 	aprint_naive("\n");
115 	aprint_normal(": ACPI WMI Interface\n");
116 
117 	if (acpi_wmi_init(sc) != true)
118 		return;
119 
120 	acpi_wmi_dump(sc);
121 	acpi_wmi_init_ec(sc);
122 	acpi_wmi_event_add(sc);
123 	acpi_wmi_rescan(self, NULL, NULL);
124 
125 	(void)pmf_device_register(self, acpi_wmi_suspend, acpi_wmi_resume);
126 }
127 
128 static int
129 acpi_wmi_detach(device_t self, int flags)
130 {
131 	struct acpi_wmi_softc *sc = device_private(self);
132 
133 	acpi_wmi_event_del(sc);
134 
135 	if (sc->sc_ecdev != NULL) {
136 
137 		(void)AcpiRemoveAddressSpaceHandler(sc->sc_node->ad_handle,
138 		    ACPI_ADR_SPACE_EC, acpi_wmi_ec_handler);
139 	}
140 
141 	if (sc->sc_child != NULL)
142 		(void)config_detach(sc->sc_child, flags);
143 
144 	acpi_wmi_del(sc);
145 	pmf_device_deregister(self);
146 
147 	return 0;
148 }
149 
150 static int
151 acpi_wmi_rescan(device_t self, const char *ifattr, const int *locators)
152 {
153 	struct acpi_wmi_softc *sc = device_private(self);
154 
155 	if (ifattr_match(ifattr, "acpiwmibus") && sc->sc_child == NULL)
156 		sc->sc_child = config_found_ia(self, "acpiwmibus",
157 		    NULL, acpi_wmi_print);
158 
159 	return 0;
160 }
161 
162 static void
163 acpi_wmi_childdet(device_t self, device_t child)
164 {
165 	struct acpi_wmi_softc *sc = device_private(self);
166 
167 	if (sc->sc_child == child)
168 		sc->sc_child = NULL;
169 }
170 
171 static int
172 acpi_wmi_print(void *aux, const char *pnp)
173 {
174 
175 	if (pnp != NULL)
176 		aprint_normal("acpiwmibus at %s", pnp);
177 
178 	return UNCONF;
179 }
180 
181 static bool
182 acpi_wmi_init(struct acpi_wmi_softc *sc)
183 {
184 	ACPI_OBJECT *obj;
185 	ACPI_BUFFER buf;
186 	ACPI_STATUS rv;
187 	uint32_t len;
188 
189 	rv = acpi_eval_struct(sc->sc_node->ad_handle, "_WDG", &buf);
190 
191 	if (ACPI_FAILURE(rv))
192 		goto fail;
193 
194 	obj = buf.Pointer;
195 
196 	if (obj->Type != ACPI_TYPE_BUFFER) {
197 		rv = AE_TYPE;
198 		goto fail;
199 	}
200 
201 	len = obj->Buffer.Length;
202 
203 	if (len != obj->Package.Count) {
204 		rv = AE_BAD_VALUE;
205 		goto fail;
206 	}
207 
208 	CTASSERT(sizeof(struct guid_t) == 20);
209 
210 	if (len < sizeof(struct guid_t) ||
211 	    len % sizeof(struct guid_t) != 0) {
212 		rv = AE_BAD_DATA;
213 		goto fail;
214 	}
215 
216 	acpi_wmi_add(sc, obj);
217 	return true;
218 
219 fail:
220 	aprint_error_dev(sc->sc_dev, "failed to evaluate _WDG: %s\n",
221 	    AcpiFormatException(rv));
222 
223 	if (buf.Pointer != NULL)
224 		ACPI_FREE(buf.Pointer);
225 
226 	return false;
227 }
228 
229 static void
230 acpi_wmi_add(struct acpi_wmi_softc *sc, ACPI_OBJECT *obj)
231 {
232 	struct wmi_t *wmi;
233 	size_t i, n, offset, siz;
234 
235 	siz = sizeof(struct guid_t);
236 	n = obj->Buffer.Length / siz;
237 
238 	SIMPLEQ_INIT(&sc->wmi_head);
239 
240 	for (i = offset = 0; i < n; ++i) {
241 
242 		wmi = kmem_zalloc(sizeof(*wmi), KM_SLEEP);
243 		(void)memcpy(&wmi->guid, obj->Buffer.Pointer + offset, siz);
244 
245 		wmi->eevent = false;
246 		offset = offset + siz;
247 
248 		SIMPLEQ_INSERT_TAIL(&sc->wmi_head, wmi, wmi_link);
249 	}
250 
251 	ACPI_FREE(obj);
252 }
253 
254 static void
255 acpi_wmi_del(struct acpi_wmi_softc *sc)
256 {
257 	struct wmi_t *wmi;
258 
259 	while (SIMPLEQ_FIRST(&sc->wmi_head) != NULL) {
260 		wmi = SIMPLEQ_FIRST(&sc->wmi_head);
261 		SIMPLEQ_REMOVE_HEAD(&sc->wmi_head, wmi_link);
262 		kmem_free(wmi, sizeof(*wmi));
263 	}
264 }
265 
266 static void
267 acpi_wmi_dump(struct acpi_wmi_softc *sc)
268 {
269 	struct wmi_t *wmi;
270 
271 	KASSERT(SIMPLEQ_EMPTY(&sc->wmi_head) == 0);
272 
273 	SIMPLEQ_FOREACH(wmi, &sc->wmi_head, wmi_link) {
274 
275 		aprint_debug_dev(sc->sc_dev, "{%08X-%04X-%04X-",
276 		    wmi->guid.data1, wmi->guid.data2, wmi->guid.data3);
277 
278 		aprint_debug("%02X%02X-%02X%02X%02X%02X%02X%02X} ",
279 		    wmi->guid.data4[0], wmi->guid.data4[1],
280 		    wmi->guid.data4[2], wmi->guid.data4[3],
281 		    wmi->guid.data4[4], wmi->guid.data4[5],
282 		    wmi->guid.data4[6], wmi->guid.data4[7]);
283 
284 		aprint_debug("oid %04X count %02X flags %02X\n",
285 		    UGET16(wmi->guid.oid), wmi->guid.count, wmi->guid.flags);
286 	}
287 }
288 
289 static void
290 acpi_wmi_init_ec(struct acpi_wmi_softc *sc)
291 {
292 	ACPI_STATUS rv;
293 	deviter_t i;
294 	device_t d;
295 
296 	d = deviter_first(&i, DEVITER_F_ROOT_FIRST);
297 
298 	for (; d != NULL; d = deviter_next(&i)) {
299 
300 		if (device_is_a(d, "acpiec") != false ||
301 		    device_is_a(d, "acpiecdt") != false) {
302 			sc->sc_ecdev = d;
303 			break;
304 		}
305 	}
306 
307 	deviter_release(&i);
308 
309 	if (sc->sc_ecdev == NULL)
310 		return;
311 
312 	rv = AcpiInstallAddressSpaceHandler(sc->sc_node->ad_handle,
313 	    ACPI_ADR_SPACE_EC, acpi_wmi_ec_handler, NULL, sc);
314 
315 	if (ACPI_FAILURE(rv))
316 		sc->sc_ecdev = NULL;
317 }
318 
319 static ACPI_STATUS
320 acpi_wmi_guid_get(struct acpi_wmi_softc *sc,
321     const char *src, struct wmi_t **out)
322 {
323 	struct wmi_t *wmi;
324 	struct guid_t *guid;
325 	char bin[16];
326 	char hex[3];
327 	const char *ptr;
328 	uint8_t i;
329 
330 	if (sc == NULL || src == NULL || strlen(src) != 36)
331 		return AE_BAD_PARAMETER;
332 
333 	for (ptr = src, i = 0; i < 16; i++) {
334 
335 		if (*ptr == '-')
336 			ptr++;
337 
338 		(void)memcpy(hex, ptr, 2);
339 		hex[2] = '\0';
340 
341 		if (HEXCHAR(hex[0]) == 0 || HEXCHAR(hex[1]) == 0)
342 			return AE_BAD_HEX_CONSTANT;
343 
344 		bin[i] = strtoul(hex, NULL, 16) & 0xFF;
345 
346 		ptr++;
347 		ptr++;
348 	}
349 
350 	guid = (struct guid_t *)bin;
351 	guid->data1 = be32toh(guid->data1);
352 	guid->data2 = be16toh(guid->data2);
353 	guid->data3 = be16toh(guid->data3);
354 
355 	SIMPLEQ_FOREACH(wmi, &sc->wmi_head, wmi_link) {
356 
357 		if (GUIDCMP(guid, &wmi->guid) != 0) {
358 
359 			if (out != NULL)
360 				*out = wmi;
361 
362 			return AE_OK;
363 		}
364 	}
365 
366 	return AE_NOT_FOUND;
367 }
368 
369 /*
370  * Checks if a GUID is present. Child devices
371  * can use this in their autoconf(9) routines.
372  */
373 int
374 acpi_wmi_guid_match(device_t self, const char *guid)
375 {
376 	struct acpi_wmi_softc *sc = device_private(self);
377 	ACPI_STATUS rv;
378 
379 	rv = acpi_wmi_guid_get(sc, guid, NULL);
380 
381 	if (ACPI_SUCCESS(rv))
382 		return 1;
383 
384 	return 0;
385 }
386 
387 /*
388  * Adds internal event handler.
389  */
390 static void
391 acpi_wmi_event_add(struct acpi_wmi_softc *sc)
392 {
393 	struct wmi_t *wmi;
394 	ACPI_STATUS rv;
395 
396 	if (acpi_register_notify(sc->sc_node, acpi_wmi_event_handler) != true)
397 		return;
398 
399 	/*
400 	 * Enable possible events, expensive or otherwise.
401 	 */
402 	SIMPLEQ_FOREACH(wmi, &sc->wmi_head, wmi_link) {
403 
404 		if ((wmi->guid.flags & ACPI_WMI_FLAG_EVENT) != 0) {
405 
406 			rv = acpi_wmi_enable_event(sc->sc_node->ad_handle,
407 			    wmi->guid.nid, true);
408 
409 			if (ACPI_SUCCESS(rv)) {
410 				wmi->eevent = true;
411 				continue;
412 			}
413 
414 			aprint_debug_dev(sc->sc_dev, "failed to enable "
415 			    "expensive WExx: %s\n", AcpiFormatException(rv));
416 		}
417 	}
418 }
419 
420 /*
421  * Removes the internal event handler.
422  */
423 static void
424 acpi_wmi_event_del(struct acpi_wmi_softc *sc)
425 {
426 	struct wmi_t *wmi;
427 	ACPI_STATUS rv;
428 
429 	acpi_deregister_notify(sc->sc_node);
430 
431 	SIMPLEQ_FOREACH(wmi, &sc->wmi_head, wmi_link) {
432 
433 		if (wmi->eevent != true)
434 			continue;
435 
436 		KASSERT((wmi->guid.flags & ACPI_WMI_FLAG_EVENT) != 0);
437 
438 		rv = acpi_wmi_enable_event(sc->sc_node->ad_handle,
439 		    wmi->guid.nid, false);
440 
441 		if (ACPI_SUCCESS(rv)) {
442 			wmi->eevent = false;
443 			continue;
444 		}
445 
446 		aprint_debug_dev(sc->sc_dev, "failed to disable "
447 		    "expensive WExx: %s\n", AcpiFormatException(rv));
448 	}
449 }
450 
451 /*
452  * Returns extra information possibly associated with an event.
453  */
454 ACPI_STATUS
455 acpi_wmi_event_get(device_t self, uint32_t event, ACPI_BUFFER *obuf)
456 {
457 	struct acpi_wmi_softc *sc = device_private(self);
458 	struct wmi_t *wmi;
459 	ACPI_OBJECT_LIST arg;
460 	ACPI_OBJECT obj;
461 	ACPI_HANDLE hdl;
462 
463 	if (sc == NULL || obuf == NULL)
464 		return AE_BAD_PARAMETER;
465 
466 	if (sc->sc_handler == NULL)
467 		return AE_ABORT_METHOD;
468 
469 	hdl = sc->sc_node->ad_handle;
470 
471 	obj.Type = ACPI_TYPE_INTEGER;
472 	obj.Integer.Value = event;
473 
474 	arg.Count = 0x01;
475 	arg.Pointer = &obj;
476 
477 	obuf->Pointer = NULL;
478 	obuf->Length = ACPI_ALLOCATE_LOCAL_BUFFER;
479 
480 	SIMPLEQ_FOREACH(wmi, &sc->wmi_head, wmi_link) {
481 
482 		if ((wmi->guid.flags & ACPI_WMI_FLAG_EVENT) == 0)
483 			continue;
484 
485 		if (wmi->guid.nid != event)
486 			continue;
487 
488 		return AcpiEvaluateObject(hdl, "_WED", &arg, obuf);
489 	}
490 
491 	return AE_NOT_FOUND;
492 }
493 
494 /*
495  * Forwards events to the external handler through the internal one.
496  */
497 static void
498 acpi_wmi_event_handler(ACPI_HANDLE hdl, uint32_t evt, void *aux)
499 {
500 	struct acpi_wmi_softc *sc;
501 	device_t self = aux;
502 
503 	sc = device_private(self);
504 
505 	if (sc->sc_child == NULL)
506 		return;
507 
508 	if (sc->sc_handler == NULL)
509 		return;
510 
511 	(*sc->sc_handler)(NULL, evt, sc->sc_child);
512 }
513 
514 ACPI_STATUS
515 acpi_wmi_event_register(device_t self, ACPI_NOTIFY_HANDLER handler)
516 {
517 	struct acpi_wmi_softc *sc = device_private(self);
518 
519 	if (sc == NULL)
520 		return AE_BAD_PARAMETER;
521 
522 	if (handler != NULL && sc->sc_handler != NULL)
523 		return AE_ALREADY_EXISTS;
524 
525 	sc->sc_handler = handler;
526 
527 	return AE_OK;
528 }
529 
530 ACPI_STATUS
531 acpi_wmi_event_deregister(device_t self)
532 {
533 	return acpi_wmi_event_register(self, NULL);
534 }
535 
536 /*
537  * Handler for EC regions, which may be embedded in WMI.
538  */
539 static ACPI_STATUS
540 acpi_wmi_ec_handler(uint32_t func, ACPI_PHYSICAL_ADDRESS addr,
541     uint32_t width, ACPI_INTEGER *val, void *setup, void *aux)
542 {
543 	struct acpi_wmi_softc *sc = aux;
544 
545 	if (aux == NULL || val == NULL)
546 		return AE_BAD_PARAMETER;
547 
548 	if (addr > 0xFF || width % 8 != 0)
549 		return AE_BAD_ADDRESS;
550 
551 	switch (func) {
552 
553 	case ACPI_READ:
554 		(void)acpiec_bus_read(sc->sc_ecdev, addr, val, width);
555 		break;
556 
557 	case ACPI_WRITE:
558 		(void)acpiec_bus_write(sc->sc_ecdev, addr, *val, width);
559 		break;
560 
561 	default:
562 		return AE_BAD_PARAMETER;
563 	}
564 
565 	return AE_OK;
566 }
567 
568 /*
569  * As there is no prior knowledge about the expensive
570  * events that cause "significant overhead", try to
571  * disable (enable) these before suspending (resuming).
572  */
573 static bool
574 acpi_wmi_suspend(device_t self, const pmf_qual_t *qual)
575 {
576 	struct acpi_wmi_softc *sc = device_private(self);
577 
578 	acpi_wmi_event_del(sc);
579 
580 	return true;
581 }
582 
583 static bool
584 acpi_wmi_resume(device_t self, const pmf_qual_t *qual)
585 {
586 	struct acpi_wmi_softc *sc = device_private(self);
587 
588 	acpi_wmi_event_add(sc);
589 
590 	return true;
591 }
592 
593 static ACPI_STATUS
594 acpi_wmi_enable_event(ACPI_HANDLE hdl, uint8_t nid, bool flag)
595 {
596 	char path[5];
597 
598 	snprintf(path, sizeof(path), "WE%02X", nid);
599 
600 	return acpi_eval_set_integer(hdl, path, (flag != false) ? 0x01 : 0x00);
601 }
602 
603 static ACPI_STATUS
604 acpi_wmi_enable_collection(ACPI_HANDLE hdl, const char *oid, bool flag)
605 {
606 	char path[5];
607 
608 	strlcpy(path, "WC", sizeof(path));
609 	strlcat(path, oid, sizeof(path));
610 
611 	return acpi_eval_set_integer(hdl, path, (flag != false) ? 0x01 : 0x00);
612 }
613 
614 static bool
615 acpi_wmi_input(struct wmi_t *wmi, uint8_t flag, uint8_t idx)
616 {
617 	/* A data block may have no flags at all */
618 	if ((wmi->guid.flags & flag) == 0 &&
619 	    (flag == ACPI_WMI_FLAG_DATA  &&
620 	     (wmi->guid.flags & ~ACPI_WMI_FLAG_EXPENSIVE) != 0))
621 		return false;
622 
623 	if (wmi->guid.count == 0x00)
624 		return false;
625 
626 	if (wmi->guid.count < idx)
627 		return false;
628 
629 	return true;
630 }
631 
632 /*
633  * Makes a WMI data block query (WQxx). The corresponding control
634  * method for data collection will be invoked if it is available.
635  */
636 ACPI_STATUS
637 acpi_wmi_data_query(device_t self, const char *guid,
638     uint8_t idx, ACPI_BUFFER *obuf)
639 {
640 	struct acpi_wmi_softc *sc = device_private(self);
641 	struct wmi_t *wmi;
642 	char path[5] = "WQ";
643 	ACPI_OBJECT_LIST arg;
644 	ACPI_STATUS rv, rvxx;
645 	ACPI_OBJECT obj;
646 
647 	rvxx = AE_SUPPORT;
648 
649 	if (obuf == NULL)
650 		return AE_BAD_PARAMETER;
651 
652 	rv = acpi_wmi_guid_get(sc, guid, &wmi);
653 
654 	if (ACPI_FAILURE(rv))
655 		return rv;
656 
657 	if (acpi_wmi_input(wmi, ACPI_WMI_FLAG_DATA, idx) != true)
658 		return AE_BAD_DATA;
659 
660 	(void)strlcat(path, wmi->guid.oid, sizeof(path));
661 
662 	obj.Type = ACPI_TYPE_INTEGER;
663 	obj.Integer.Value = idx;
664 
665 	arg.Count = 0x01;
666 	arg.Pointer = &obj;
667 
668 	obuf->Pointer = NULL;
669 	obuf->Length = ACPI_ALLOCATE_LOCAL_BUFFER;
670 
671 	/*
672 	 * If the expensive flag is set, we should enable
673 	 * data collection before evaluating the WQxx buffer.
674 	 */
675 	if ((wmi->guid.flags & ACPI_WMI_FLAG_EXPENSIVE) != 0) {
676 
677 		rvxx = acpi_wmi_enable_collection(sc->sc_node->ad_handle,
678 		    wmi->guid.oid, true);
679 	}
680 
681 	rv = AcpiEvaluateObject(sc->sc_node->ad_handle, path, &arg, obuf);
682 
683 	/* No longer needed. */
684 	if (ACPI_SUCCESS(rvxx)) {
685 
686 		(void)acpi_wmi_enable_collection(sc->sc_node->ad_handle,
687 		    wmi->guid.oid, false);
688 	}
689 
690 #ifdef DIAGNOSTIC
691 	/*
692 	 * XXX: It appears that quite a few laptops have WQxx
693 	 * methods that are declared as expensive, but lack the
694 	 * corresponding WCxx control method.
695 	 *
696 	 * -- Acer Aspire One is one example <jruohonen@iki.fi>.
697 	 */
698 	if (ACPI_FAILURE(rvxx) && rvxx != AE_SUPPORT)
699 		aprint_error_dev(sc->sc_dev, "failed to evaluate WCxx "
700 		    "for %s: %s\n", path, AcpiFormatException(rvxx));
701 #endif
702 	return rv;
703 }
704 
705 /*
706  * Writes to a data block (WSxx).
707  */
708 ACPI_STATUS
709 acpi_wmi_data_write(device_t self, const char *guid,
710     uint8_t idx, ACPI_BUFFER *ibuf)
711 {
712 	struct acpi_wmi_softc *sc = device_private(self);
713 	struct wmi_t *wmi;
714 	ACPI_OBJECT_LIST arg;
715 	ACPI_OBJECT obj[2];
716 	char path[5] = "WS";
717 	ACPI_STATUS rv;
718 
719 	if (ibuf == NULL)
720 		return AE_BAD_PARAMETER;
721 
722 	rv = acpi_wmi_guid_get(sc, guid, &wmi);
723 
724 	if (ACPI_FAILURE(rv))
725 		return rv;
726 
727 	if (acpi_wmi_input(wmi, ACPI_WMI_FLAG_DATA, idx) != true)
728 		return AE_BAD_DATA;
729 
730 	(void)strlcat(path, wmi->guid.oid, sizeof(path));
731 
732 	obj[0].Integer.Value = idx;
733 	obj[0].Type = ACPI_TYPE_INTEGER;
734 
735 	obj[1].Buffer.Length = ibuf->Length;
736 	obj[1].Buffer.Pointer = ibuf->Pointer;
737 
738 	obj[1].Type = ((wmi->guid.flags & ACPI_WMI_FLAG_STRING) != 0) ?
739 	    ACPI_TYPE_STRING : ACPI_TYPE_BUFFER;
740 
741 	arg.Count = 0x02;
742 	arg.Pointer = obj;
743 
744 	return AcpiEvaluateObject(sc->sc_node->ad_handle, path, &arg, NULL);
745 }
746 
747 /*
748  * Executes a method (WMxx).
749  */
750 ACPI_STATUS
751 acpi_wmi_method(device_t self, const char *guid, uint8_t idx,
752     uint32_t mid, ACPI_BUFFER *ibuf, ACPI_BUFFER *obuf)
753 {
754 	struct acpi_wmi_softc *sc = device_private(self);
755 	struct wmi_t *wmi;
756 	ACPI_OBJECT_LIST arg;
757 	ACPI_OBJECT obj[3];
758 	char path[5] = "WM";
759 	ACPI_STATUS rv;
760 
761 	if (ibuf == NULL || obuf == NULL)
762 		return AE_BAD_PARAMETER;
763 
764 	rv = acpi_wmi_guid_get(sc, guid, &wmi);
765 
766 	if (ACPI_FAILURE(rv))
767 		return rv;
768 
769 	if (acpi_wmi_input(wmi, ACPI_WMI_FLAG_METHOD, idx) != true)
770 		return AE_BAD_DATA;
771 
772 	(void)strlcat(path, wmi->guid.oid, sizeof(path));
773 
774 	obj[0].Integer.Value = idx;
775 	obj[1].Integer.Value = mid;
776 	obj[0].Type = obj[1].Type = ACPI_TYPE_INTEGER;
777 
778 	obj[2].Buffer.Length = ibuf->Length;
779 	obj[2].Buffer.Pointer = ibuf->Pointer;
780 
781 	obj[2].Type = ((wmi->guid.flags & ACPI_WMI_FLAG_STRING) != 0) ?
782 	    ACPI_TYPE_STRING : ACPI_TYPE_BUFFER;
783 
784 	arg.Count = 0x03;
785 	arg.Pointer = obj;
786 
787 	obuf->Pointer = NULL;
788 	obuf->Length = ACPI_ALLOCATE_LOCAL_BUFFER;
789 
790 	return AcpiEvaluateObject(sc->sc_node->ad_handle, path, &arg, obuf);
791 }
792 
793 MODULE(MODULE_CLASS_DRIVER, acpiwmi, NULL);
794 
795 #ifdef _MODULE
796 #include "ioconf.c"
797 #endif
798 
799 static int
800 acpiwmi_modcmd(modcmd_t cmd, void *aux)
801 {
802 	int rv = 0;
803 
804 	switch (cmd) {
805 
806 	case MODULE_CMD_INIT:
807 
808 #ifdef _MODULE
809 		rv = config_init_component(cfdriver_ioconf_acpiwmi,
810 		    cfattach_ioconf_acpiwmi, cfdata_ioconf_acpiwmi);
811 #endif
812 		break;
813 
814 	case MODULE_CMD_FINI:
815 
816 #ifdef _MODULE
817 		rv = config_fini_component(cfdriver_ioconf_acpiwmi,
818 		    cfattach_ioconf_acpiwmi, cfdata_ioconf_acpiwmi);
819 #endif
820 		break;
821 
822 	default:
823 		rv = ENOTTY;
824 	}
825 
826 	return rv;
827 }
828