acpi_ec.c revision 1.10 1 /* $NetBSD: acpi_ec.c,v 1.10 2003/08/03 08:16:07 kochi Exp $ */
2
3 /*
4 * Copyright 2001 Wasabi Systems, Inc.
5 * All rights reserved.
6 *
7 * Written by Jason R. Thorpe for Wasabi Systems, Inc.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
17 * 3. All advertising materials mentioning features or use of this software
18 * must display the following acknowledgement:
19 * This product includes software developed for the NetBSD Project by
20 * Wasabi Systems, Inc.
21 * 4. The name of Wasabi Systems, Inc. may not be used to endorse
22 * or promote products derived from this software without specific prior
23 * written permission.
24 *
25 * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC
29 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 * POSSIBILITY OF SUCH DAMAGE.
36 */
37
38 /*-
39 * Copyright (c) 2000 Michael Smith
40 * Copyright (c) 2000 BSDi
41 * All rights reserved.
42 *
43 * Redistribution and use in source and binary forms, with or without
44 * modification, are permitted provided that the following conditions
45 * are met:
46 * 1. Redistributions of source code must retain the above copyright
47 * notice, this list of conditions and the following disclaimer.
48 * 2. Redistributions in binary form must reproduce the above copyright
49 * notice, this list of conditions and the following disclaimer in the
50 * documentation and/or other materials provided with the distribution.
51 *
52 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
53 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
54 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
55 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
56 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
57 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
58 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
59 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
60 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
61 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
62 * SUCH DAMAGE.
63 */
64
65 /******************************************************************************
66 *
67 * 1. Copyright Notice
68 *
69 * Some or all of this work - Copyright (c) 1999, Intel Corp. All rights
70 * reserved.
71 *
72 * 2. License
73 *
74 * 2.1. This is your license from Intel Corp. under its intellectual property
75 * rights. You may have additional license terms from the party that provided
76 * you this software, covering your right to use that party's intellectual
77 * property rights.
78 *
79 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
80 * copy of the source code appearing in this file ("Covered Code") an
81 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
82 * base code distributed originally by Intel ("Original Intel Code") to copy,
83 * make derivatives, distribute, use and display any portion of the Covered
84 * Code in any form, with the right to sublicense such rights; and
85 *
86 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
87 * license (with the right to sublicense), under only those claims of Intel
88 * patents that are infringed by the Original Intel Code, to make, use, sell,
89 * offer to sell, and import the Covered Code and derivative works thereof
90 * solely to the minimum extent necessary to exercise the above copyright
91 * license, and in no event shall the patent license extend to any additions
92 * to or modifications of the Original Intel Code. No other license or right
93 * is granted directly or by implication, estoppel or otherwise;
94 *
95 * The above copyright and patent license is granted only if the following
96 * conditions are met:
97 *
98 * 3. Conditions
99 *
100 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
101 * Redistribution of source code of any substantial portion of the Covered
102 * Code or modification with rights to further distribute source must include
103 * the above Copyright Notice, the above License, this list of Conditions,
104 * and the following Disclaimer and Export Compliance provision. In addition,
105 * Licensee must cause all Covered Code to which Licensee contributes to
106 * contain a file documenting the changes Licensee made to create that Covered
107 * Code and the date of any change. Licensee must include in that file the
108 * documentation of any changes made by any predecessor Licensee. Licensee
109 * must include a prominent statement that the modification is derived,
110 * directly or indirectly, from Original Intel Code.
111 *
112 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
113 * Redistribution of source code of any substantial portion of the Covered
114 * Code or modification without rights to further distribute source must
115 * include the following Disclaimer and Export Compliance provision in the
116 * documentation and/or other materials provided with distribution. In
117 * addition, Licensee may not authorize further sublicense of source of any
118 * portion of the Covered Code, and must include terms to the effect that the
119 * license from Licensee to its licensee is limited to the intellectual
120 * property embodied in the software Licensee provides to its licensee, and
121 * not to intellectual property embodied in modifications its licensee may
122 * make.
123 *
124 * 3.3. Redistribution of Executable. Redistribution in executable form of any
125 * substantial portion of the Covered Code or modification must reproduce the
126 * above Copyright Notice, and the following Disclaimer and Export Compliance
127 * provision in the documentation and/or other materials provided with the
128 * distribution.
129 *
130 * 3.4. Intel retains all right, title, and interest in and to the Original
131 * Intel Code.
132 *
133 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
134 * Intel shall be used in advertising or otherwise to promote the sale, use or
135 * other dealings in products derived from or relating to the Covered Code
136 * without prior written authorization from Intel.
137 *
138 * 4. Disclaimer and Export Compliance
139 *
140 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
141 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
142 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
143 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
144 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
145 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
146 * PARTICULAR PURPOSE.
147 *
148 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
149 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
150 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
151 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
152 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
153 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
154 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
155 * LIMITED REMEDY.
156 *
157 * 4.3. Licensee shall not export, either directly or indirectly, any of this
158 * software or system incorporating such software without first obtaining any
159 * required license or other approval from the U. S. Department of Commerce or
160 * any other agency or department of the United States Government. In the
161 * event Licensee exports any such software from the United States or
162 * re-exports any such software from a foreign destination, Licensee shall
163 * ensure that the distribution and export/re-export of the software is in
164 * compliance with all laws, regulations, orders, or other restrictions of the
165 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
166 * any of its subsidiaries will export/re-export any technical data, process,
167 * software, or service, directly or indirectly, to any country for which the
168 * United States government or any agency thereof requires an export license,
169 * other governmental approval, or letter of assurance, without first obtaining
170 * such license, approval or letter.
171 *
172 *****************************************************************************/
173
174 #include <sys/cdefs.h>
175 __KERNEL_RCSID(0, "$NetBSD: acpi_ec.c,v 1.10 2003/08/03 08:16:07 kochi Exp $");
176
177 #include <sys/param.h>
178 #include <sys/systm.h>
179 #include <sys/device.h>
180 #include <sys/proc.h>
181 #include <sys/kernel.h>
182
183 #include <machine/bus.h>
184
185 #include <dev/acpi/acpica.h>
186 #include <dev/acpi/acpireg.h>
187 #include <dev/acpi/acpivar.h>
188 #include <dev/acpi/acpi_ecreg.h>
189
190 #define _COMPONENT ACPI_EC_COMPONENT
191 ACPI_MODULE_NAME("EC")
192
193 struct acpi_ec_softc {
194 struct device sc_dev; /* base device glue */
195 struct acpi_devnode *sc_node; /* our ACPI devnode */
196
197 struct acpi_resources sc_res; /* our bus resources */
198
199 UINT32 sc_gpebit; /* our GPE interrupt bit */
200
201 bus_space_tag_t sc_data_st; /* space tag for data register */
202 bus_space_handle_t sc_data_sh; /* space handle for data register */
203
204 bus_space_tag_t sc_csr_st; /* space tag for control register */
205 bus_space_handle_t sc_csr_sh; /* space handle for control register */
206
207 int sc_flags; /* see below */
208
209 uint32_t sc_csrvalue; /* saved control register */
210 UINT32 sc_lockhandle;
211 };
212
213 #define EC_F_LOCKED 0x01 /* EC is locked */
214 #define EC_F_PENDQUERY 0x02 /* query is pending */
215
216 #define EC_DATA_READ(sc) \
217 bus_space_read_1((sc)->sc_data_st, (sc)->sc_data_sh, 0)
218 #define EC_DATA_WRITE(sc, v) \
219 bus_space_write_1((sc)->sc_data_st, (sc)->sc_data_sh, 0, (v))
220
221 #define EC_CSR_READ(sc) \
222 bus_space_read_1((sc)->sc_csr_st, (sc)->sc_csr_sh, 0)
223 #define EC_CSR_WRITE(sc, v) \
224 bus_space_write_1((sc)->sc_csr_st, (sc)->sc_csr_sh, 0, (v))
225
226 static __inline int
227 EcIsLocked(struct acpi_ec_softc *sc)
228 {
229
230 return (acpi_is_global_locked() && (sc->sc_flags & EC_F_LOCKED));
231 }
232
233 static __inline ACPI_STATUS
234 EcLock(struct acpi_ec_softc *sc)
235 {
236 ACPI_STATUS status;
237 UINT32 handle;
238
239 status = acpi_acquire_global_lock(&handle);
240 if (ACPI_SUCCESS(status)) {
241 sc->sc_flags |= EC_F_LOCKED;
242 sc->sc_lockhandle = handle;
243 }
244
245 return (status);
246 }
247
248 static __inline void
249 EcUnlock(struct acpi_ec_softc *sc)
250 {
251 if (!EcIsLocked(sc))
252 return;
253 sc->sc_flags &= ~EC_F_LOCKED;
254 acpi_release_global_lock(sc->sc_lockhandle);
255 }
256
257 typedef struct {
258 EC_COMMAND Command;
259 UINT8 Address;
260 UINT8 Data;
261 } EC_REQUEST;
262
263 static void EcGpeHandler(void *Context);
264 static ACPI_STATUS EcSpaceSetup(ACPI_HANDLE Region, UINT32 Function,
265 void *Context, void **return_Context);
266 static ACPI_STATUS EcSpaceHandler(UINT32 Function,
267 ACPI_PHYSICAL_ADDRESS Address, UINT32 width,
268 ACPI_INTEGER *Value, void *Context,
269 void *RegionContext);
270
271 static ACPI_STATUS EcWaitEvent(struct acpi_ec_softc *sc, EC_EVENT Event);
272 static ACPI_STATUS EcQuery(struct acpi_ec_softc *sc, UINT8 *Data);
273 static ACPI_STATUS EcTransaction(struct acpi_ec_softc *sc,
274 EC_REQUEST *EcRequest);
275 static ACPI_STATUS EcRead(struct acpi_ec_softc *sc, UINT8 Address,
276 UINT8 *Data);
277 static ACPI_STATUS EcWrite(struct acpi_ec_softc *sc, UINT8 Address,
278 UINT8 *Data);
279
280 int acpiec_match(struct device *, struct cfdata *, void *);
281 void acpiec_attach(struct device *, struct device *, void *);
282
283 CFATTACH_DECL(acpiec, sizeof(struct acpi_ec_softc),
284 acpiec_match, acpiec_attach, NULL, NULL);
285
286 /*
287 * acpiec_match:
288 *
289 * Autoconfiguration `match' routine.
290 */
291 int
292 acpiec_match(struct device *parent, struct cfdata *match, void *aux)
293 {
294 struct acpi_attach_args *aa = aux;
295
296 if (aa->aa_node->ad_type != ACPI_TYPE_DEVICE)
297 return (0);
298
299 if (strcmp(aa->aa_node->ad_devinfo.HardwareId, "PNP0C09") == 0)
300 return (1);
301
302 return (0);
303 }
304
305 /*
306 * acpiec_attach:
307 *
308 * Autoconfiguration `attach' routine.
309 */
310 void
311 acpiec_attach(struct device *parent, struct device *self, void *aux)
312 {
313 struct acpi_ec_softc *sc = (void *) self;
314 struct acpi_attach_args *aa = aux;
315 struct acpi_io *io0, *io1;
316 ACPI_STATUS rv;
317
318 ACPI_FUNCTION_TRACE(__FUNCTION__);
319
320 printf(": ACPI Embedded Controller\n");
321
322 sc->sc_node = aa->aa_node;
323
324 /* Parse our resources. */
325 ACPI_DEBUG_PRINT((ACPI_DB_RESOURCES, "parsing EC resources\n"));
326 rv = acpi_resource_parse(&sc->sc_dev, sc->sc_node, &sc->sc_res,
327 &acpi_resource_parse_ops_default);
328 if (rv != AE_OK) {
329 printf("%s: unable to parse resources: %d\n",
330 sc->sc_dev.dv_xname, rv);
331 return;
332 }
333
334 sc->sc_data_st = aa->aa_iot;
335 io0 = acpi_res_io(&sc->sc_res, 0);
336 if (io0 == NULL) {
337 printf("%s: unable to find data register resource\n",
338 sc->sc_dev.dv_xname);
339 return;
340 }
341 if (bus_space_map(sc->sc_data_st, io0->ar_base, io0->ar_length,
342 0, &sc->sc_data_sh) != 0) {
343 printf("%s: unable to map data register\n",
344 sc->sc_dev.dv_xname);
345 return;
346 }
347
348 sc->sc_csr_st = aa->aa_iot;
349 io1 = acpi_res_io(&sc->sc_res, 1);
350 if (io1 == NULL) {
351 printf("%s: unable to find csr register resource\n",
352 sc->sc_dev.dv_xname);
353 return;
354 }
355 if (bus_space_map(sc->sc_csr_st, io1->ar_base, io1->ar_length,
356 0, &sc->sc_csr_sh) != 0) {
357 printf("%s: unable to map csr register\n",
358 sc->sc_dev.dv_xname);
359 return;
360 }
361
362 /*
363 * Install GPE handler.
364 *
365 * We evaluate the _GPE method to find the GPE bit used by the
366 * Embedded Controller to signal status (SCI).
367 */
368 if ((rv = acpi_eval_integer(sc->sc_node->ad_handle, "_GPE",
369 &sc->sc_gpebit)) != AE_OK) {
370 printf("%s: unable to evaluate _GPE: %d\n",
371 sc->sc_dev.dv_xname, rv);
372 return;
373 }
374
375 /*
376 * Install a handler for this EC's GPE bit. Note that EC SCIs are
377 * treated as both edge- and level-triggered interrupts; in other words
378 * we clear the status bit immediately after getting an EC-SCI, then
379 * again after we're done processing the event. This guarantees that
380 * events we cause while performing a transaction (e.g. IBE/OBF) get
381 * cleared before re-enabling the GPE.
382 */
383 if ((rv = AcpiInstallGpeHandler(sc->sc_gpebit,
384 ACPI_EVENT_LEVEL_TRIGGERED | ACPI_EVENT_EDGE_TRIGGERED,
385 EcGpeHandler, sc)) != AE_OK) {
386 printf("%s: unable to install GPE handler: %d\n",
387 sc->sc_dev.dv_xname, rv);
388 return;
389 }
390
391 /* Install address space handler. */
392 if ((rv = AcpiInstallAddressSpaceHandler(sc->sc_node->ad_handle,
393 ACPI_ADR_SPACE_EC, EcSpaceHandler, EcSpaceSetup, sc)) != AE_OK) {
394 printf("%s: unable to install address space handler: %d\n",
395 sc->sc_dev.dv_xname, rv);
396 return;
397 }
398
399 return_VOID;
400 }
401
402 static void
403 EcGpeQueryHandler(void *Context)
404 {
405 struct acpi_ec_softc *sc = Context;
406 UINT8 Data;
407 ACPI_STATUS Status;
408 char qxx[5];
409
410 ACPI_FUNCTION_TRACE(__FUNCTION__);
411
412 for (;;) {
413 /*
414 * Check EC_SCI.
415 *
416 * Bail out if the EC_SCI bit of the status register is not
417 * set. Note that this function should only be called when
418 * this bit is set (polling is used to detect IBE/OBF events).
419 *
420 * It is safe to do this without locking the controller, as
421 * it's OK to call EcQuery when there's no data ready; in the
422 * worst case we should just find nothing waiting for us and
423 * bail.
424 */
425 if ((EC_CSR_READ(sc) & EC_EVENT_SCI) == 0)
426 break;
427
428 /*
429 * Find out why the EC is signalling us
430 */
431 Status = EcQuery(sc, &Data);
432
433 /*
434 * If we failed to get anything from the EC, give up.
435 */
436 if (Status != AE_OK) {
437 printf("%s: GPE query failed: %d\n",
438 sc->sc_dev.dv_xname, Status);
439 break;
440 }
441
442 /*
443 * Evaluate _Qxx to respond to the controller.
444 */
445 sprintf(qxx, "_Q%02x", Data);
446 strupr(qxx);
447 Status = AcpiEvaluateObject(sc->sc_node->ad_handle, qxx,
448 NULL, NULL);
449
450 /*
451 * Ignore spurious query requests.
452 */
453 if (Status != AE_OK &&
454 (Data != 0 || Status != AE_NOT_FOUND)) {
455 printf("%s: evaluation of GPE query method %s "
456 "failed: %d\n", sc->sc_dev.dv_xname, qxx, Status);
457 }
458 }
459
460 /* I know I request Level trigger cleanup */
461 if (AcpiClearEvent(sc->sc_gpebit, ACPI_EVENT_GPE) != AE_OK)
462 printf("%s: AcpiClearEvent failed\n", sc->sc_dev.dv_xname);
463 if (AcpiEnableEvent(sc->sc_gpebit, ACPI_EVENT_GPE, 0) != AE_OK)
464 printf("%s: AcpiEnableEvent failed\n", sc->sc_dev.dv_xname);
465
466 return_VOID;
467 }
468
469 static void
470 EcGpeHandler(void *Context)
471 {
472 struct acpi_ec_softc *sc = Context;
473 uint32_t csrvalue;
474
475 /*
476 * If EC is locked, the intr must process EcRead/Write wait only.
477 * Query request must be pending.
478 */
479 if (EcIsLocked(sc)) {
480 csrvalue = EC_CSR_READ(sc);
481 if (csrvalue & EC_EVENT_SCI)
482 sc->sc_flags |= EC_F_PENDQUERY;
483
484 if ((csrvalue & EC_FLAG_OUTPUT_BUFFER) != 0 ||
485 (csrvalue & EC_FLAG_INPUT_BUFFER) == 0) {
486 sc->sc_csrvalue = csrvalue;
487 wakeup(&sc->sc_csrvalue);
488 }
489 } else {
490 /* Enqueue GpeQuery handler. */
491 if (AcpiOsQueueForExecution(OSD_PRIORITY_HIGH,
492 EcGpeQueryHandler, Context) != AE_OK) {
493 printf("%s: failed to enqueue query handler\n",
494 sc->sc_dev.dv_xname);
495 }
496 }
497 }
498
499 static ACPI_STATUS
500 EcSpaceSetup(ACPI_HANDLE Region, UINT32 Function, void *Context,
501 void **RegionContext)
502 {
503
504 ACPI_FUNCTION_TRACE(__FUNCTION__);
505
506 /*
507 * Just pass the context through, there's nothing to do here.
508 */
509 *RegionContext = Context;
510
511 return_ACPI_STATUS(AE_OK);
512 }
513
514 static ACPI_STATUS
515 EcSpaceHandler(UINT32 Function, ACPI_PHYSICAL_ADDRESS Address, UINT32 width,
516 ACPI_INTEGER *Value, void *Context, void *RegionContext)
517 {
518 struct acpi_ec_softc *sc = Context;
519 ACPI_STATUS Status = AE_OK;
520 EC_REQUEST EcRequest;
521 int i;
522
523 ACPI_FUNCTION_TRACE_U32(__FUNCTION__, (UINT32)Address);
524
525 if ((Address > 0xFF) || (width % 8 != 0) || (Value == NULL) ||
526 (Context == NULL))
527 return_ACPI_STATUS(AE_BAD_PARAMETER);
528
529 switch (Function) {
530 case ACPI_READ:
531 EcRequest.Command = EC_COMMAND_READ;
532 EcRequest.Address = Address;
533 (*Value) = 0;
534 break;
535
536 case ACPI_WRITE:
537 EcRequest.Command = EC_COMMAND_WRITE;
538 EcRequest.Address = Address;
539 break;
540
541 default:
542 printf("%s: invalid Address Space function: %d\n",
543 sc->sc_dev.dv_xname, Function);
544 return_ACPI_STATUS(AE_BAD_PARAMETER);
545 }
546
547 /*
548 * Perform the transaction.
549 */
550 for (i = 0; i < width; i += 8) {
551 if (Function == ACPI_READ)
552 EcRequest.Data = 0;
553 else
554 EcRequest.Data = (UINT8)((*Value) >> i);
555
556 if ((Status = EcTransaction(sc, &EcRequest)) != AE_OK)
557 break;
558
559 (*Value) |= (UINT32)EcRequest.Data << i;
560 if (++EcRequest.Address == 0)
561 return_ACPI_STATUS(AE_BAD_PARAMETER);
562 }
563
564 return_ACPI_STATUS(Status);
565 }
566
567 static ACPI_STATUS
568 EcWaitEventIntr(struct acpi_ec_softc *sc, EC_EVENT Event)
569 {
570 EC_STATUS EcStatus;
571 int i;
572
573 ACPI_FUNCTION_TRACE_U32(__FUNCTION__, (UINT32)Event);
574
575 /* XXX Need better test for "yes, you have interrupts". */
576 if (cold)
577 return_ACPI_STATUS(EcWaitEvent(sc, Event));
578
579 if (EcIsLocked(sc) == 0)
580 printf("%s: EcWaitEventIntr called without EC lock!\n",
581 sc->sc_dev.dv_xname);
582
583 EcStatus = EC_CSR_READ(sc);
584
585 /* Too long? */
586 for (i = 0; i < 10; i++) {
587 /* Check EC status against the desired event. */
588 if ((Event == EC_EVENT_OUTPUT_BUFFER_FULL) &&
589 (EcStatus & EC_FLAG_OUTPUT_BUFFER) != 0)
590 return_ACPI_STATUS(AE_OK);
591
592 if ((Event == EC_EVENT_INPUT_BUFFER_EMPTY) &&
593 (EcStatus & EC_FLAG_INPUT_BUFFER) == 0)
594 return_ACPI_STATUS(AE_OK);
595
596 sc->sc_csrvalue = 0;
597 /* XXXJRT Sleeping with a lock held? */
598 if (tsleep(&sc->sc_csrvalue, 0, "EcWait", 1) != EWOULDBLOCK)
599 EcStatus = sc->sc_csrvalue;
600 else
601 EcStatus = EC_CSR_READ(sc);
602 }
603 return_ACPI_STATUS(AE_ERROR);
604 }
605
606 static ACPI_STATUS
607 EcWaitEvent(struct acpi_ec_softc *sc, EC_EVENT Event)
608 {
609 EC_STATUS EcStatus;
610 UINT32 i = 0;
611
612 if (EcIsLocked(sc) == 0)
613 printf("%s: EcWaitEvent called without EC lock!\n",
614 sc->sc_dev.dv_xname);
615
616 /*
617 * Stall 1us:
618 * ----------
619 * Stall for 1 microsecond before reading the status register
620 * for the first time. This allows the EC to set the IBF/OBF
621 * bit to its proper state.
622 *
623 * XXX it is not clear why we read the CSR twice.
624 */
625 AcpiOsStall(1);
626 EcStatus = EC_CSR_READ(sc);
627
628 /*
629 * Wait For Event:
630 * ---------------
631 * Poll the EC status register to detect completion of the last
632 * command. Wait up to 10ms (in 100us chunks) for this to occur.
633 */
634 for (i = 0; i < 100; i++) {
635 EcStatus = EC_CSR_READ(sc);
636
637 if ((Event == EC_EVENT_OUTPUT_BUFFER_FULL) &&
638 (EcStatus & EC_FLAG_OUTPUT_BUFFER) != 0)
639 return (AE_OK);
640
641 if ((Event == EC_EVENT_INPUT_BUFFER_EMPTY) &&
642 (EcStatus & EC_FLAG_INPUT_BUFFER) == 0)
643 return (AE_OK);
644
645 AcpiOsStall(10);
646 }
647
648 return (AE_ERROR);
649 }
650
651 static ACPI_STATUS
652 EcQuery(struct acpi_ec_softc *sc, UINT8 *Data)
653 {
654 ACPI_STATUS Status;
655
656 if ((Status = EcLock(sc)) != AE_OK)
657 return (Status);
658
659 EC_CSR_WRITE(sc, EC_COMMAND_QUERY);
660 Status = EcWaitEvent(sc, EC_EVENT_OUTPUT_BUFFER_FULL);
661 if (Status == AE_OK)
662 *Data = EC_DATA_READ(sc);
663
664 EcUnlock(sc);
665
666 if (Status != AE_OK)
667 printf("%s: timed out waiting for EC to respond to "
668 "EC_COMMAND_QUERY\n", sc->sc_dev.dv_xname);
669
670 return (Status);
671 }
672
673 static ACPI_STATUS
674 EcTransaction(struct acpi_ec_softc *sc, EC_REQUEST *EcRequest)
675 {
676 ACPI_STATUS Status;
677
678 if ((Status = EcLock(sc)) != AE_OK)
679 return (Status);
680
681 /*
682 * Perform the transaction.
683 */
684 switch (EcRequest->Command) {
685 case EC_COMMAND_READ:
686 Status = EcRead(sc, EcRequest->Address, &(EcRequest->Data));
687 break;
688
689 case EC_COMMAND_WRITE:
690 Status = EcWrite(sc, EcRequest->Address, &(EcRequest->Data));
691 break;
692
693 default:
694 Status = AE_SUPPORT;
695 break;
696 }
697
698 /*
699 * Clear & Re-Enable the EC GPE:
700 * -----------------------------
701 * 'Consume' any EC GPE events that we generated while performing
702 * the transaction (e.g. IBF/OBF). Clearing the GPE here shouldn't
703 * have an adverse affect on outstanding EC-SCI's, as the source
704 * (EC-SCI) will still be high and thus should trigger the GPE
705 * immediately after we re-enabling it.
706 */
707 if (sc->sc_flags & EC_F_PENDQUERY) {
708 if (AcpiOsQueueForExecution(OSD_PRIORITY_HIGH,
709 EcGpeQueryHandler, sc) != AE_OK)
710 printf("%s: unable to queue pending query\n",
711 sc->sc_dev.dv_xname);
712 sc->sc_flags &= ~EC_F_PENDQUERY;
713 }
714
715 if (AcpiClearEvent(sc->sc_gpebit, ACPI_EVENT_GPE) != AE_OK)
716 printf("%s: EcRequest: unable to clear EC GPE\n",
717 sc->sc_dev.dv_xname);
718 if (AcpiEnableEvent(sc->sc_gpebit, ACPI_EVENT_GPE, 0) != AE_OK)
719 printf("%s: EcRequest: unable to reenable EC GPE\n",
720 sc->sc_dev.dv_xname);
721
722 EcUnlock(sc);
723
724 return(Status);
725 }
726
727 static ACPI_STATUS
728 EcRead(struct acpi_ec_softc *sc, UINT8 Address, UINT8 *Data)
729 {
730 ACPI_STATUS Status;
731
732 if (EcIsLocked(sc) == 0)
733 printf("%s: EcRead called without EC lock!\n",
734 sc->sc_dev.dv_xname);
735
736 /* EcBurstEnable(EmbeddedController); */
737
738 EC_CSR_WRITE(sc, EC_COMMAND_READ);
739 if ((Status = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
740 AE_OK) {
741 printf("%s: EcRead: timeout waiting for EC to process "
742 "read command\n", sc->sc_dev.dv_xname);
743 return (Status);
744 }
745
746 EC_DATA_WRITE(sc, Address);
747 if ((Status = EcWaitEventIntr(sc, EC_EVENT_OUTPUT_BUFFER_FULL)) !=
748 AE_OK) {
749 printf("%s: EcRead: timeout waiting for EC to send data\n",
750 sc->sc_dev.dv_xname);
751 return (Status);
752 }
753
754 (*Data) = EC_DATA_READ(sc);
755
756 /* EcBurstDisable(EmbeddedController); */
757
758 return (AE_OK);
759 }
760
761 static ACPI_STATUS
762 EcWrite(struct acpi_ec_softc *sc, UINT8 Address, UINT8 *Data)
763 {
764 ACPI_STATUS Status;
765
766 if (EcIsLocked(sc) == 0)
767 printf("%s: EcWrite called without EC lock!\n",
768 sc->sc_dev.dv_xname);
769
770 /* EcBurstEnable(EmbeddedController); */
771
772 EC_CSR_WRITE(sc, EC_COMMAND_WRITE);
773 if ((Status = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
774 AE_OK) {
775 printf("%s: EcWrite: timeout waiting for EC to process "
776 "write command\n", sc->sc_dev.dv_xname);
777 return (Status);
778 }
779
780 EC_DATA_WRITE(sc, Address);
781 if ((Status = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
782 AE_OK) {
783 printf("%s: EcWrite: timeout waiting for EC to process "
784 "address\n", sc->sc_dev.dv_xname);
785 return (Status);
786 }
787
788 EC_DATA_WRITE(sc, *Data);
789 if ((Status = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
790 AE_OK) {
791 printf("%s: EcWrite: timeout waiting for EC to process "
792 "data\n", sc->sc_dev.dv_xname);
793 return (Status);
794 }
795
796 /* EcBurstDisable(EmbeddedController); */
797
798 return (AE_OK);
799 }
800