xref: /dragonfly/sys/dev/acpica/acpi_powerres.c (revision 1ab20d67)
1 /*-
2  * Copyright (c) 2001 Michael Smith
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  *	$FreeBSD: src/sys/dev/acpica/acpi_powerres.c,v 1.14.6.1 2003/08/22 20:49:20 jhb Exp $
27  *      $DragonFly: src/sys/dev/acpica/Attic/acpi_powerres.c,v 1.2 2004/05/05 22:19:23 dillon Exp $
28  */
29 
30 #include "opt_acpi.h"		/* XXX trim includes */
31 #include <sys/param.h>
32 #include <sys/kernel.h>
33 #include <sys/proc.h>
34 #include <sys/malloc.h>
35 #include <sys/bus.h>
36 #include <sys/conf.h>
37 #include <sys/ioccom.h>
38 #include <sys/reboot.h>
39 #include <sys/sysctl.h>
40 #include <sys/systm.h>
41 #include <sys/ctype.h>
42 
43 #include <machine/clock.h>
44 
45 #include <machine/resource.h>
46 
47 #include "acpi.h"
48 
49 #include <dev/acpica/acpivar.h>
50 #include <dev/acpica/acpiio.h>
51 
52 /*
53  * ACPI power resource management.
54  *
55  * Power resource behaviour is slightly complicated by the fact that
56  * a single power resource may provide power for more than one device.
57  * Thus, we must track the device(s) being powered by a given power
58  * resource, and only deactivate it when there are no powered devices.
59  *
60  * Note that this only manages resources for known devices.  There is an
61  * ugly case where we may turn of power to a device which is in use because
62  * we don't know that it depends on a given resource.  We should perhaps
63  * try to be smarter about this, but a more complete solution would involve
64  * scanning all of the ACPI namespace to find devices we're not currently
65  * aware of, and this raises questions about whether they should be left
66  * on, turned off, etc.
67  *
68  * XXX locking
69  */
70 
71 MALLOC_DEFINE(M_ACPIPWR, "acpipwr", "ACPI power resources");
72 
73 /*
74  * Hooks for the ACPI CA debugging infrastructure
75  */
76 #define _COMPONENT	ACPI_POWER
77 ACPI_MODULE_NAME("POWERRES")
78 
79 /* return values from _STA on a power resource */
80 #define ACPI_PWR_OFF	0
81 #define ACPI_PWR_ON	1
82 
83 /*
84  * A relationship between a power resource and a consumer.
85  */
86 struct acpi_powerreference {
87     struct acpi_powerconsumer	*ar_consumer;
88     struct acpi_powerresource	*ar_resource;
89     TAILQ_ENTRY(acpi_powerreference) ar_rlink;	/* link on resource list */
90     TAILQ_ENTRY(acpi_powerreference) ar_clink;	/* link on consumer */
91 };
92 
93 /*
94  * A power-managed device.
95  */
96 struct acpi_powerconsumer {
97     ACPI_HANDLE		ac_consumer;		/* device which is powered */
98     int			ac_state;
99     TAILQ_ENTRY(acpi_powerconsumer) ac_link;
100     TAILQ_HEAD(,acpi_powerreference) ac_references;
101 };
102 
103 /*
104  * A power resource.
105  */
106 struct acpi_powerresource {
107     TAILQ_ENTRY(acpi_powerresource) ap_link;
108     TAILQ_HEAD(,acpi_powerreference) ap_references;
109     ACPI_HANDLE		ap_resource;		/* the resource's handle */
110     ACPI_INTEGER	ap_systemlevel;
111     ACPI_INTEGER	ap_order;
112 };
113 
114 static TAILQ_HEAD(acpi_powerresource_list, acpi_powerresource)	acpi_powerresources;
115 static TAILQ_HEAD(acpi_powerconsumer_list, acpi_powerconsumer)	acpi_powerconsumers;
116 
117 static ACPI_STATUS		acpi_pwr_register_consumer(ACPI_HANDLE consumer);
118 static ACPI_STATUS		acpi_pwr_deregister_consumer(ACPI_HANDLE consumer);
119 static ACPI_STATUS		acpi_pwr_register_resource(ACPI_HANDLE res);
120 static ACPI_STATUS		acpi_pwr_deregister_resource(ACPI_HANDLE res);
121 static void			acpi_pwr_reference_resource(ACPI_OBJECT *obj, void *arg);
122 static ACPI_STATUS		acpi_pwr_switch_power(void);
123 static struct acpi_powerresource *acpi_pwr_find_resource(ACPI_HANDLE res);
124 static struct acpi_powerconsumer *acpi_pwr_find_consumer(ACPI_HANDLE consumer);
125 
126 /*
127  * Initialise our lists.
128  */
129 static void
130 acpi_pwr_init(void *junk)
131 {
132     TAILQ_INIT(&acpi_powerresources);
133     TAILQ_INIT(&acpi_powerconsumers);
134 }
135 SYSINIT(acpi_powerresource, SI_SUB_TUNABLES, SI_ORDER_ANY, acpi_pwr_init, NULL);
136 
137 /*
138  * Register a power resource.
139  *
140  * It's OK to call this if we already know about the resource.
141  */
142 static ACPI_STATUS
143 acpi_pwr_register_resource(ACPI_HANDLE res)
144 {
145     ACPI_STATUS			status;
146     ACPI_BUFFER			buf;
147     ACPI_OBJECT			*obj;
148     struct acpi_powerresource	*rp, *srp;
149 
150     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
151 
152     rp = NULL;
153     buf.Pointer = NULL;
154 
155     /* look to see if we know about this resource */
156     if (acpi_pwr_find_resource(res) != NULL)
157 	return_ACPI_STATUS(AE_OK);		/* already know about it */
158 
159     /* allocate a new resource */
160     rp = malloc(sizeof(*rp), M_ACPIPWR, M_INTWAIT | M_ZERO);
161     TAILQ_INIT(&rp->ap_references);
162     rp->ap_resource = res;
163 
164     /* get the Power Resource object */
165     buf.Length = ACPI_ALLOCATE_BUFFER;
166     if (ACPI_FAILURE(status = AcpiEvaluateObject(res, NULL, NULL, &buf))) {
167 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "no power resource object\n"));
168 	goto out;
169     }
170     obj = buf.Pointer;
171     if (obj->Type != ACPI_TYPE_POWER) {
172 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "questionable power resource object %s\n", acpi_name(res)));
173 	status = AE_TYPE;
174 	goto out;
175     }
176     rp->ap_systemlevel = obj->PowerResource.SystemLevel;
177     rp->ap_order = obj->PowerResource.ResourceOrder;
178 
179     /* sort the resource into the list */
180     status = AE_OK;
181     srp = TAILQ_FIRST(&acpi_powerresources);
182     if ((srp == NULL) || (rp->ap_order < srp->ap_order)) {
183 	TAILQ_INSERT_HEAD(&acpi_powerresources, rp, ap_link);
184 	goto done;
185     }
186     TAILQ_FOREACH(srp, &acpi_powerresources, ap_link)
187 	if (rp->ap_order < srp->ap_order) {
188 	    TAILQ_INSERT_BEFORE(srp, rp, ap_link);
189 	    goto done;
190 	}
191     TAILQ_INSERT_TAIL(&acpi_powerresources, rp, ap_link);
192 
193  done:
194     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "registered power resource %s\n", acpi_name(res)));
195  out:
196     if (buf.Pointer != NULL)
197 	AcpiOsFree(buf.Pointer);
198     if (ACPI_FAILURE(status) && (rp != NULL))
199 	free(rp, M_ACPIPWR);
200     return_ACPI_STATUS(status);
201 }
202 
203 /*
204  * Deregister a power resource.
205  */
206 static ACPI_STATUS
207 acpi_pwr_deregister_resource(ACPI_HANDLE res)
208 {
209     struct acpi_powerresource	*rp;
210 
211     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
212 
213     rp = NULL;
214 
215     /* find the resource */
216     if ((rp = acpi_pwr_find_resource(res)) == NULL)
217 	return_ACPI_STATUS(AE_BAD_PARAMETER);
218 
219     /* check that there are no consumers referencing this resource */
220     if (TAILQ_FIRST(&rp->ap_references) != NULL)
221 	return_ACPI_STATUS(AE_BAD_PARAMETER);
222 
223     /* pull it off the list and free it */
224     TAILQ_REMOVE(&acpi_powerresources, rp, ap_link);
225     free(rp, M_ACPIPWR);
226 
227     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "deregistered power resource %s\n", acpi_name(res)));
228 
229     return_ACPI_STATUS(AE_OK);
230 }
231 
232 /*
233  * Register a power consumer.
234  *
235  * It's OK to call this if we already know about the consumer.
236  */
237 static ACPI_STATUS
238 acpi_pwr_register_consumer(ACPI_HANDLE consumer)
239 {
240     struct acpi_powerconsumer	*pc;
241 
242     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
243 
244     /* check to see whether we know about this consumer already */
245     if ((pc = acpi_pwr_find_consumer(consumer)) != NULL)
246 	return_ACPI_STATUS(AE_OK);
247 
248     /* allocate a new power consumer */
249     pc = malloc(sizeof(*pc), M_ACPIPWR, M_INTWAIT);
250     TAILQ_INSERT_HEAD(&acpi_powerconsumers, pc, ac_link);
251     TAILQ_INIT(&pc->ac_references);
252     pc->ac_consumer = consumer;
253 
254     pc->ac_state = ACPI_STATE_UNKNOWN;	/* XXX we should try to find its current state */
255 
256     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "registered power consumer %s\n", acpi_name(consumer)));
257 
258     return_ACPI_STATUS(AE_OK);
259 }
260 
261 /*
262  * Deregister a power consumer.
263  *
264  * This should only be done once the consumer has been powered off.
265  * (XXX is this correct?  Check once implemented)
266  */
267 static ACPI_STATUS
268 acpi_pwr_deregister_consumer(ACPI_HANDLE consumer)
269 {
270     struct acpi_powerconsumer	*pc;
271 
272     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
273 
274     /* find the consumer */
275     if ((pc = acpi_pwr_find_consumer(consumer)) == NULL)
276 	return_ACPI_STATUS(AE_BAD_PARAMETER);
277 
278     /* make sure the consumer's not referencing anything right now */
279     if (TAILQ_FIRST(&pc->ac_references) != NULL)
280 	return_ACPI_STATUS(AE_BAD_PARAMETER);
281 
282     /* pull the consumer off the list and free it */
283     TAILQ_REMOVE(&acpi_powerconsumers, pc, ac_link);
284 
285     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "deregistered power consumer %s\n", acpi_name(consumer)));
286 
287     return_ACPI_STATUS(AE_OK);
288 }
289 
290 /*
291  * Set a power consumer to a particular power state.
292  */
293 ACPI_STATUS
294 acpi_pwr_switch_consumer(ACPI_HANDLE consumer, int state)
295 {
296     struct acpi_powerconsumer	*pc;
297     struct acpi_powerreference	*pr;
298     ACPI_HANDLE			method_handle, reslist_handle, pr0_handle;
299     ACPI_BUFFER			reslist_buffer;
300     ACPI_OBJECT			*reslist_object;
301     ACPI_STATUS			status;
302     char			*method_name, *reslist_name;
303     int				res_changed;
304 
305     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
306 
307     /* find the consumer */
308     if ((pc = acpi_pwr_find_consumer(consumer)) == NULL) {
309 	if (ACPI_FAILURE(status = acpi_pwr_register_consumer(consumer)))
310 	    return_ACPI_STATUS(status);
311 	if ((pc = acpi_pwr_find_consumer(consumer)) == NULL) {
312 	    return_ACPI_STATUS(AE_ERROR);	/* something very wrong */
313 	}
314     }
315 
316     /* check for valid transitions */
317     if ((pc->ac_state == ACPI_STATE_D3) && (state != ACPI_STATE_D0))
318 	return_ACPI_STATUS(AE_BAD_PARAMETER);	/* can only go to D0 from D3 */
319 
320     /* find transition mechanism(s) */
321     switch(state) {
322     case ACPI_STATE_D0:
323 	method_name = "_PS0";
324 	reslist_name = "_PR0";
325 	break;
326     case ACPI_STATE_D1:
327 	method_name = "_PS1";
328 	reslist_name = "_PR1";
329 	break;
330     case ACPI_STATE_D2:
331 	method_name = "_PS2";
332 	reslist_name = "_PR2";
333 	break;
334     case ACPI_STATE_D3:
335 	method_name = "_PS3";
336 	reslist_name = "_PR3";
337 	break;
338     default:
339 	return_ACPI_STATUS(AE_BAD_PARAMETER);
340     }
341     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "setup to switch %s D%d -> D%d\n",
342 		      acpi_name(consumer), pc->ac_state, state));
343 
344     /*
345      * Verify that this state is supported, ie. one of method or
346      * reslist must be present.  We need to do this before we go
347      * dereferencing resources (since we might be trying to go to
348      * a state we don't support).
349      *
350      * Note that if any states are supported, the device has to
351      * support D0 and D3.  It's never an error to try to go to
352      * D0.
353      */
354     reslist_buffer.Pointer = NULL;
355     reslist_object = NULL;
356     if (ACPI_FAILURE(AcpiGetHandle(consumer, method_name, &method_handle)))
357 	method_handle = NULL;
358     if (ACPI_FAILURE(AcpiGetHandle(consumer, reslist_name, &reslist_handle)))
359 	reslist_handle = NULL;
360     if ((reslist_handle == NULL) && (method_handle == NULL)) {
361 	if (state == ACPI_STATE_D0) {
362 	    pc->ac_state = ACPI_STATE_D0;
363 	    return_ACPI_STATUS(AE_OK);
364 	}
365 	if (state != ACPI_STATE_D3) {
366 	    goto bad;
367 	}
368 
369 	/* turn off the resources listed in _PR0 to go to D3. */
370 	if (ACPI_FAILURE(AcpiGetHandle(consumer, "_PR0", &pr0_handle))) {
371 	    goto bad;
372 	}
373 	reslist_buffer.Length = ACPI_ALLOCATE_BUFFER;
374 	if (ACPI_FAILURE(status = AcpiEvaluateObject(pr0_handle, NULL, NULL, &reslist_buffer))) {
375 	    goto bad;
376 	}
377 	reslist_object = (ACPI_OBJECT *)reslist_buffer.Pointer;
378 	if ((reslist_object->Type != ACPI_TYPE_PACKAGE) ||
379 	    (reslist_object->Package.Count == 0)) {
380 	    goto bad;
381 	}
382 	AcpiOsFree(reslist_buffer.Pointer);
383 	reslist_buffer.Pointer = NULL;
384 	reslist_object = NULL;
385     }
386 
387     /*
388      * Check that we can actually fetch the list of power resources
389      */
390     if (reslist_handle != NULL) {
391 	reslist_buffer.Length = ACPI_ALLOCATE_BUFFER;
392 	if (ACPI_FAILURE(status = AcpiEvaluateObject(reslist_handle, NULL, NULL, &reslist_buffer))) {
393 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "can't evaluate resource list %s\n",
394 			      acpi_name(reslist_handle)));
395 	    goto out;
396 	}
397 	reslist_object = (ACPI_OBJECT *)reslist_buffer.Pointer;
398 	if (reslist_object->Type != ACPI_TYPE_PACKAGE) {
399 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "resource list is not ACPI_TYPE_PACKAGE (%d)\n",
400 			      reslist_object->Type));
401 	    status = AE_TYPE;
402 	    goto out;
403 	}
404     }
405 
406     /*
407      * Now we are ready to switch, so  kill off any current power resource references.
408      */
409     res_changed = 0;
410     while((pr = TAILQ_FIRST(&pc->ac_references)) != NULL) {
411 	res_changed = 1;
412 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "removing reference to %s\n", acpi_name(pr->ar_resource->ap_resource)));
413 	TAILQ_REMOVE(&pr->ar_resource->ap_references, pr, ar_rlink);
414 	TAILQ_REMOVE(&pc->ac_references, pr, ar_clink);
415 	free(pr, M_ACPIPWR);
416     }
417 
418     /*
419      * Add new power resource references, if we have any.  Traverse the
420      * package that we got from evaluating reslist_handle, and look up each
421      * of the resources that are referenced.
422      */
423     if (reslist_object != NULL) {
424 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "referencing %d new resources\n",
425 			  reslist_object->Package.Count));
426 	acpi_ForeachPackageObject(reslist_object, acpi_pwr_reference_resource, pc);
427 	res_changed = 1;
428     }
429 
430     /*
431      * If we changed anything in the resource list, we need to run a switch
432      * pass now.
433      */
434     if (ACPI_FAILURE(status = acpi_pwr_switch_power())) {
435 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "failed to correctly switch resources to move %s to D%d\n",
436 			  acpi_name(consumer), state));
437 	goto out;		/* XXX is this appropriate?  Should we return to previous state? */
438     }
439 
440     /* invoke power state switch method (if present) */
441     if (method_handle != NULL) {
442 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "invoking state transition method %s\n",
443 			  acpi_name(method_handle)));
444 	if (ACPI_FAILURE(status = AcpiEvaluateObject(method_handle, NULL, NULL, NULL))) {
445 		ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "failed to set state - %s\n",
446 				  AcpiFormatException(status)));
447 		pc->ac_state = ACPI_STATE_UNKNOWN;
448 		goto out;	/* XXX Should we return to previous state? */
449 	}
450     }
451 
452     /* transition was successful */
453     pc->ac_state = state;
454     return_ACPI_STATUS(AE_OK);
455 
456  bad:
457     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "attempt to set unsupported state D%d\n",
458 		      state));
459     status = AE_BAD_PARAMETER;
460 
461  out:
462     if (reslist_buffer.Pointer != NULL)
463 	AcpiOsFree(reslist_buffer.Pointer);
464     return_ACPI_STATUS(status);
465 }
466 
467 /*
468  * Called to create a reference between a power consumer and a power resource
469  * identified in the object.
470  */
471 static void
472 acpi_pwr_reference_resource(ACPI_OBJECT *obj, void *arg)
473 {
474     struct acpi_powerconsumer	*pc = (struct acpi_powerconsumer *)arg;
475     struct acpi_powerreference	*pr;
476     struct acpi_powerresource	*rp;
477     ACPI_HANDLE			res;
478     ACPI_STATUS			status;
479 
480     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
481 
482     /* check the object type */
483     switch (obj->Type) {
484     case ACPI_TYPE_ANY:
485 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "building reference from %s to %s\n",
486 			  acpi_name(pc->ac_consumer), acpi_name(obj->Reference.Handle)));
487 
488 	res = obj->Reference.Handle;
489 	break;
490 
491     case ACPI_TYPE_STRING:
492 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "building reference from %s to %s\n",
493 			  acpi_name(pc->ac_consumer), obj->String.Pointer));
494 
495 	/* get the handle of the resource */
496 	if (ACPI_FAILURE(status = AcpiGetHandle(NULL, obj->String.Pointer, &res))) {
497 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "couldn't find power resource %s\n",
498 			      obj->String.Pointer));
499 	    return_VOID;
500 	}
501 	break;
502 
503     default:
504 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "don't know how to create a power reference to object type %d\n",
505 			  obj->Type));
506 	return_VOID;
507     }
508 
509     /* create/look up the resource */
510     if (ACPI_FAILURE(status = acpi_pwr_register_resource(res))) {
511 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "couldn't register power resource %s - %s\n",
512 			  obj->String.Pointer, AcpiFormatException(status)));
513 	return_VOID;
514     }
515     if ((rp = acpi_pwr_find_resource(res)) == NULL) {
516 	ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "power resource list corrupted\n"));
517 	return_VOID;
518     }
519     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "found power resource %s\n", acpi_name(rp->ap_resource)));
520 
521     /* create a reference between the consumer and resource */
522     pr = malloc(sizeof(*pr), M_ACPIPWR, M_INTWAIT | M_ZERO);
523     pr->ar_consumer = pc;
524     pr->ar_resource = rp;
525     TAILQ_INSERT_TAIL(&pc->ac_references, pr, ar_clink);
526     TAILQ_INSERT_TAIL(&rp->ap_references, pr, ar_rlink);
527 
528     return_VOID;
529 }
530 
531 
532 /*
533  * Switch power resources to conform to the desired state.
534  *
535  * Consumers may have modified the power resource list in an arbitrary
536  * fashion; we sweep it in sequence order.
537  */
538 static ACPI_STATUS
539 acpi_pwr_switch_power(void)
540 {
541     struct acpi_powerresource	*rp;
542     ACPI_STATUS			status;
543     int				cur;
544 
545     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
546 
547     /*
548      * Sweep the list forwards turning things on.
549      */
550     TAILQ_FOREACH(rp, &acpi_powerresources, ap_link) {
551 	if (TAILQ_FIRST(&rp->ap_references) == NULL) {
552 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "%s has no references, not turning on\n",
553 			      acpi_name(rp->ap_resource)));
554 	    continue;
555 	}
556 
557 	/* we could cache this if we trusted it not to change under us */
558 	if (ACPI_FAILURE(status = acpi_EvaluateInteger(rp->ap_resource, "_STA", &cur))) {
559 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "can't get status of %s - %d\n",
560 			      acpi_name(rp->ap_resource), status));
561 	    continue;	/* XXX is this correct?  Always switch if in doubt? */
562 	}
563 
564 	/*
565 	 * Switch if required.  Note that we ignore the result of the switch
566 	 * effort; we don't know what to do if it fails, so checking wouldn't
567 	 * help much.
568 	 */
569 	if (cur != ACPI_PWR_ON) {
570 	    if (ACPI_FAILURE(status = AcpiEvaluateObject(rp->ap_resource, "_ON", NULL, NULL))) {
571 		ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "failed to switch %s on - %s\n",
572 				  acpi_name(rp->ap_resource), AcpiFormatException(status)));
573 	    } else {
574 		ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "switched %s on\n", acpi_name(rp->ap_resource)));
575 	    }
576 	} else {
577 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "%s is already on\n", acpi_name(rp->ap_resource)));
578 	}
579     }
580 
581     /*
582      * Sweep the list backwards turning things off.
583      */
584     TAILQ_FOREACH_REVERSE(rp, &acpi_powerresources, acpi_powerresource_list, ap_link) {
585 	if (TAILQ_FIRST(&rp->ap_references) != NULL) {
586 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "%s has references, not turning off\n",
587 			      acpi_name(rp->ap_resource)));
588 	    continue;
589 	}
590 
591 	/* we could cache this if we trusted it not to change under us */
592 	if (ACPI_FAILURE(status = acpi_EvaluateInteger(rp->ap_resource, "_STA", &cur))) {
593 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "can't get status of %s - %d\n",
594 			      acpi_name(rp->ap_resource), status));
595 	    continue;	/* XXX is this correct?  Always switch if in doubt? */
596 	}
597 
598 	/*
599 	 * Switch if required.  Note that we ignore the result of the switch
600 	 * effort; we don't know what to do if it fails, so checking wouldn't
601 	 * help much.
602 	 */
603 	if (cur != ACPI_PWR_OFF) {
604 	    if (ACPI_FAILURE(status = AcpiEvaluateObject(rp->ap_resource, "_OFF", NULL, NULL))) {
605 		ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "failed to switch %s off - %s\n",
606 				  acpi_name(rp->ap_resource), AcpiFormatException(status)));
607 	    } else {
608 		ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "switched %s off\n", acpi_name(rp->ap_resource)));
609 	    }
610 	} else {
611 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "%s is already off\n", acpi_name(rp->ap_resource)));
612 	}
613     }
614     return_ACPI_STATUS(AE_OK);
615 }
616 
617 /*
618  * Find a power resource's control structure.
619  */
620 static struct acpi_powerresource *
621 acpi_pwr_find_resource(ACPI_HANDLE res)
622 {
623     struct acpi_powerresource	*rp;
624 
625     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
626 
627     TAILQ_FOREACH(rp, &acpi_powerresources, ap_link)
628 	if (rp->ap_resource == res)
629 	    break;
630     return_PTR(rp);
631 }
632 
633 /*
634  * Find a power consumer's control structure.
635  */
636 static struct acpi_powerconsumer *
637 acpi_pwr_find_consumer(ACPI_HANDLE consumer)
638 {
639     struct acpi_powerconsumer	*pc;
640 
641     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
642 
643     TAILQ_FOREACH(pc, &acpi_powerconsumers, ac_link)
644 	if (pc->ac_consumer == consumer)
645 	    break;
646     return_PTR(pc);
647 }
648 
649