acpi_ec.c revision 1.25 1 /* $NetBSD: acpi_ec.c,v 1.25 2004/04/11 06:48:25 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.25 2004/04/11 06:48:25 kochi Exp $");
176
177 #include <sys/param.h>
178 #include <sys/systm.h>
179 #include <sys/device.h>
180 #include <sys/malloc.h>
181 #include <sys/proc.h>
182 #include <sys/kernel.h>
183
184 #include <machine/bus.h>
185
186 #include <dev/acpi/acpica.h>
187 #include <dev/acpi/acpireg.h>
188 #include <dev/acpi/acpivar.h>
189 #include <dev/acpi/acpi_ecreg.h>
190
191 MALLOC_DECLARE(M_ACPI);
192
193 #define _COMPONENT ACPI_EC_COMPONENT
194 ACPI_MODULE_NAME("EC")
195
196 struct acpi_ec_softc {
197 struct device sc_dev; /* base device glue */
198 ACPI_HANDLE sc_handle; /* ACPI handle */
199
200 struct acpi_resources sc_res; /* our bus resources */
201
202 UINT32 sc_gpebit; /* our GPE interrupt bit */
203
204 bus_space_tag_t sc_data_st; /* space tag for data register */
205 bus_space_handle_t sc_data_sh; /* space handle for data register */
206
207 bus_space_tag_t sc_csr_st; /* space tag for control register */
208 bus_space_handle_t sc_csr_sh; /* space handle for control register */
209
210 int sc_flags; /* see below */
211
212 uint32_t sc_csrvalue; /* saved control register */
213 uint32_t sc_uid; /* _UID in namespace (ECDT only) */
214
215 struct lock sc_lock; /* serialize operations to this EC */
216 struct simplelock sc_slock; /* protect against interrupts */
217 UINT32 sc_glkhandle; /* global lock handle */
218 UINT32 sc_glk; /* need global lock? */
219 };
220
221 static const char * const ec_hid[] = {
222 "PNP0C09",
223 NULL
224 };
225
226 #define EC_F_TRANSACTION 0x01 /* doing transaction */
227 #define EC_F_PENDQUERY 0x02 /* query is pending */
228
229 /*
230 * how long to wait to acquire global lock.
231 * the value is taken from FreeBSD driver.
232 */
233 #define EC_LOCK_TIMEOUT 1000
234
235 #define EC_DATA_READ(sc) \
236 bus_space_read_1((sc)->sc_data_st, (sc)->sc_data_sh, 0)
237 #define EC_DATA_WRITE(sc, v) \
238 bus_space_write_1((sc)->sc_data_st, (sc)->sc_data_sh, 0, (v))
239
240 #define EC_CSR_READ(sc) \
241 bus_space_read_1((sc)->sc_csr_st, (sc)->sc_csr_sh, 0)
242 #define EC_CSR_WRITE(sc, v) \
243 bus_space_write_1((sc)->sc_csr_st, (sc)->sc_csr_sh, 0, (v))
244
245 typedef struct {
246 EC_COMMAND Command;
247 UINT8 Address;
248 UINT8 Data;
249 } EC_REQUEST;
250
251 static void EcGpeHandler(void *Context);
252 static ACPI_STATUS EcSpaceSetup(ACPI_HANDLE Region, UINT32 Function,
253 void *Context, void **return_Context);
254 static ACPI_STATUS EcSpaceHandler(UINT32 Function,
255 ACPI_PHYSICAL_ADDRESS Address, UINT32 width,
256 ACPI_INTEGER *Value, void *Context,
257 void *RegionContext);
258
259 static ACPI_STATUS EcWaitEvent(struct acpi_ec_softc *sc, EC_EVENT Event);
260 static ACPI_STATUS EcQuery(struct acpi_ec_softc *sc, UINT8 *Data);
261 static ACPI_STATUS EcTransaction(struct acpi_ec_softc *sc,
262 EC_REQUEST *EcRequest);
263 static ACPI_STATUS EcRead(struct acpi_ec_softc *sc, UINT8 Address,
264 UINT8 *Data);
265 static ACPI_STATUS EcWrite(struct acpi_ec_softc *sc, UINT8 Address,
266 UINT8 *Data);
267 static void EcGpeQueryHandler(void *);
268 static __inline int EcIsLocked(struct acpi_ec_softc *);
269 static __inline void EcLock(struct acpi_ec_softc *);
270 static __inline void EcUnlock(struct acpi_ec_softc *);
271
272
273 int acpiec_match(struct device *, struct cfdata *, void *);
274 void acpiec_attach(struct device *, struct device *, void *);
275
276 CFATTACH_DECL(acpiec, sizeof(struct acpi_ec_softc),
277 acpiec_match, acpiec_attach, NULL, NULL);
278
279 static struct acpi_ec_softc *ecdt_sc;
280
281 static __inline int
282 EcIsLocked(struct acpi_ec_softc *sc)
283 {
284
285 return (lockstatus(&sc->sc_lock) == LK_EXCLUSIVE);
286 }
287
288 static __inline void
289 EcLock(struct acpi_ec_softc *sc)
290 {
291 ACPI_STATUS rv;
292 int s;
293
294 lockmgr(&sc->sc_lock, LK_EXCLUSIVE, NULL);
295 if (sc->sc_glk) {
296 rv = AcpiAcquireGlobalLock(EC_LOCK_TIMEOUT,
297 &sc->sc_glkhandle);
298 if (ACPI_FAILURE(rv)) {
299 printf("%s: failed to acquire global lock\n",
300 sc->sc_dev.dv_xname);
301 lockmgr(&sc->sc_lock, LK_RELEASE, NULL);
302 return;
303 }
304 }
305
306 s = splvm(); /* XXX */
307 simple_lock(&sc->sc_slock);
308 sc->sc_flags |= EC_F_TRANSACTION;
309 simple_unlock(&sc->sc_slock);
310 splx(s);
311 }
312
313 static __inline void
314 EcUnlock(struct acpi_ec_softc *sc)
315 {
316 ACPI_STATUS rv;
317 int s;
318
319 /*
320 * Clear & Re-Enable the EC GPE:
321 * -----------------------------
322 * 'Consume' any EC GPE events that we generated while performing
323 * the transaction (e.g. IBF/OBF). Clearing the GPE here shouldn't
324 * have an adverse affect on outstanding EC-SCI's, as the source
325 * (EC-SCI) will still be high and thus should trigger the GPE
326 * immediately after we re-enabling it.
327 */
328 s = splvm(); /* XXX */
329 simple_lock(&sc->sc_slock);
330 if (sc->sc_flags & EC_F_PENDQUERY) {
331 ACPI_STATUS rv2;
332
333 rv2 = AcpiOsQueueForExecution(OSD_PRIORITY_HIGH,
334 EcGpeQueryHandler, sc);
335 if (ACPI_FAILURE(rv2))
336 printf("%s: unable to queue pending query: %s\n",
337 sc->sc_dev.dv_xname, AcpiFormatException(rv2));
338 sc->sc_flags &= ~EC_F_PENDQUERY;
339 }
340 sc->sc_flags &= ~EC_F_TRANSACTION;
341 simple_unlock(&sc->sc_slock);
342 splx(s);
343
344 if (sc->sc_glk) {
345 rv = AcpiReleaseGlobalLock(sc->sc_glkhandle);
346 if (ACPI_FAILURE(rv))
347 printf("%s: failed to release global lock\n",
348 sc->sc_dev.dv_xname);
349 }
350 lockmgr(&sc->sc_lock, LK_RELEASE, NULL);
351 }
352
353 /*
354 * acpiec_match:
355 *
356 * Autoconfiguration `match' routine.
357 */
358 int
359 acpiec_match(struct device *parent, struct cfdata *match, void *aux)
360 {
361 struct acpi_attach_args *aa = aux;
362
363 if (aa->aa_node->ad_type != ACPI_TYPE_DEVICE)
364 return 0;
365
366 return acpi_match_hid(aa->aa_node->ad_devinfo, ec_hid);
367 }
368
369 void
370 acpiec_early_attach(struct device *parent)
371 {
372 struct acpi_softc *sc = (struct acpi_softc *)parent;
373 EC_BOOT_RESOURCES *ep;
374 ACPI_HANDLE handle;
375 ACPI_STATUS rv;
376 ACPI_INTEGER tmp;
377
378 rv = AcpiGetFirmwareTable("ECDT", 1, ACPI_LOGICAL_ADDRESSING,
379 (void *)&ep);
380 if (ACPI_FAILURE(rv))
381 return;
382
383 if (ep->EcControl.RegisterBitWidth != 8 ||
384 ep->EcData.RegisterBitWidth != 8) {
385 printf("%s: ECDT data is invalid, RegisterBitWidth=%d/%d\n",
386 parent->dv_xname,
387 ep->EcControl.RegisterBitWidth,
388 ep->EcData.RegisterBitWidth);
389 return;
390 }
391
392 rv = AcpiGetHandle(ACPI_ROOT_OBJECT, ep->EcId, &handle);
393 if (ACPI_FAILURE(rv)) {
394 printf("%s: failed to look up EC object %s: %s\n",
395 parent->dv_xname,
396 ep->EcId, AcpiFormatException(rv));
397 return;
398 }
399
400 ecdt_sc = malloc(sizeof(*ecdt_sc), M_ACPI, M_ZERO);
401
402 strcpy(ecdt_sc->sc_dev.dv_xname, "acpiecdt0"); /* XXX */
403 ecdt_sc->sc_handle = handle;
404
405 ecdt_sc->sc_gpebit = ep->GpeBit;
406 ecdt_sc->sc_uid = ep->Uid;
407
408 ecdt_sc->sc_data_st = sc->sc_iot;
409 if (bus_space_map(ecdt_sc->sc_data_st,
410 (bus_addr_t)(ep->EcData.Address), 1, 0,
411 &ecdt_sc->sc_data_sh) != 0) {
412 printf("%s: bus_space_map failed for EC data.\n",
413 parent->dv_xname);
414 goto out1;
415 }
416
417 ecdt_sc->sc_csr_st = sc->sc_iot;
418 if (bus_space_map(ecdt_sc->sc_csr_st,
419 (bus_addr_t)(ep->EcControl.Address), 1, 0,
420 &ecdt_sc->sc_csr_sh) != 0) {
421 printf("%s: bus_space_map failed for EC control.\n",
422 parent->dv_xname);
423 goto out2;
424 }
425
426 rv = acpi_eval_integer(handle, "_GLK", &tmp);
427 if (ACPI_SUCCESS(rv) && tmp == 1)
428 ecdt_sc->sc_glk = 1;
429
430 rv = AcpiInstallGpeHandler(NULL, ecdt_sc->sc_gpebit,
431 ACPI_EVENT_EDGE_TRIGGERED, EcGpeHandler, ecdt_sc);
432 if (ACPI_FAILURE(rv)) {
433 printf("%s: unable to install GPE handler: %s\n",
434 parent->dv_xname,
435 AcpiFormatException(rv));
436 goto out3;
437 }
438
439 rv = AcpiInstallAddressSpaceHandler(ACPI_ROOT_OBJECT,
440 ACPI_ADR_SPACE_EC, EcSpaceHandler, EcSpaceSetup, ecdt_sc);
441 if (ACPI_FAILURE(rv)) {
442 printf("%s: unable to install address space handler: %s\n",
443 parent->dv_xname,
444 AcpiFormatException(rv));
445 goto out4;
446 }
447
448 printf("%s: found ECDT, GPE %d\n", parent->dv_xname,
449 ecdt_sc->sc_gpebit);
450
451 lockinit(&ecdt_sc->sc_lock, PWAIT, "eclock", 0, 0);
452 simple_lock_init(&ecdt_sc->sc_slock);
453
454 AcpiOsUnmapMemory(ep, ep->Length);
455 return;
456
457 out4:
458 AcpiRemoveGpeHandler(NULL, ecdt_sc->sc_gpebit, EcGpeHandler);
459 out3:
460 bus_space_unmap(ecdt_sc->sc_csr_st, ecdt_sc->sc_csr_sh, 1);
461 out2:
462 bus_space_unmap(ecdt_sc->sc_data_st, ecdt_sc->sc_data_sh, 1);
463 out1:
464 free(ecdt_sc, M_ACPI);
465 ecdt_sc = NULL;
466
467 AcpiOsUnmapMemory(ep, ep->Length);
468
469 return;
470 }
471
472 /*
473 * acpiec_attach:
474 *
475 * Autoconfiguration `attach' routine.
476 */
477 void
478 acpiec_attach(struct device *parent, struct device *self, void *aux)
479 {
480 struct acpi_ec_softc *sc = (void *) self;
481 struct acpi_attach_args *aa = aux;
482 struct acpi_io *io0, *io1;
483 ACPI_STATUS rv;
484 ACPI_INTEGER v;
485
486 ACPI_FUNCTION_TRACE(__FUNCTION__);
487
488 printf(": ACPI Embedded Controller\n");
489
490 lockinit(&sc->sc_lock, PWAIT, "eclock", 0, 0);
491 simple_lock_init(&sc->sc_slock);
492
493 sc->sc_handle = aa->aa_node->ad_handle;
494
495 /* Parse our resources. */
496 ACPI_DEBUG_PRINT((ACPI_DB_RESOURCES, "parsing EC resources\n"));
497 rv = acpi_resource_parse(&sc->sc_dev, aa->aa_node, &sc->sc_res,
498 &acpi_resource_parse_ops_default);
499 if (ACPI_FAILURE(rv))
500 return;
501
502 rv = acpi_eval_integer(aa->aa_node->ad_handle, "_UID", &v);
503
504 /* check if we already attached EC via ECDT */
505 if (ACPI_SUCCESS(rv) && ecdt_sc && ecdt_sc->sc_uid == v) {
506
507 /* detach all ECDT handles */
508 rv = AcpiRemoveAddressSpaceHandler(ACPI_ROOT_OBJECT,
509 ACPI_ADR_SPACE_EC, EcSpaceHandler);
510 if (ACPI_FAILURE(rv))
511 printf("ERROR: RemoveAddressSpaceHandler: %s\n",
512 AcpiFormatException(rv));
513 rv = AcpiRemoveGpeHandler(NULL, ecdt_sc->sc_gpebit,
514 EcGpeHandler);
515 if (ACPI_FAILURE(rv))
516 printf("ERROR: RemoveAddressSpaceHandler: %s\n",
517 AcpiFormatException(rv));
518
519 bus_space_unmap(ecdt_sc->sc_csr_st,
520 ecdt_sc->sc_csr_sh, 1);
521 bus_space_unmap(ecdt_sc->sc_data_st,
522 ecdt_sc->sc_data_sh, 1);
523
524 free(ecdt_sc, M_ACPI);
525 ecdt_sc = NULL;
526 }
527
528 sc->sc_data_st = aa->aa_iot;
529 io0 = acpi_res_io(&sc->sc_res, 0);
530 if (io0 == NULL) {
531 printf("%s: unable to find data register resource\n",
532 sc->sc_dev.dv_xname);
533 return;
534 }
535 if (bus_space_map(sc->sc_data_st, io0->ar_base, io0->ar_length,
536 0, &sc->sc_data_sh) != 0) {
537 printf("%s: unable to map data register\n",
538 sc->sc_dev.dv_xname);
539 return;
540 }
541
542 sc->sc_csr_st = aa->aa_iot;
543 io1 = acpi_res_io(&sc->sc_res, 1);
544 if (io1 == NULL) {
545 printf("%s: unable to find csr register resource\n",
546 sc->sc_dev.dv_xname);
547 return;
548 }
549 if (bus_space_map(sc->sc_csr_st, io1->ar_base, io1->ar_length,
550 0, &sc->sc_csr_sh) != 0) {
551 printf("%s: unable to map csr register\n",
552 sc->sc_dev.dv_xname);
553 return;
554 }
555
556 /*
557 * evaluate _GLK to see if we should acquire global lock
558 * when accessing the EC.
559 */
560 rv = acpi_eval_integer(sc->sc_handle, "_GLK", &v);
561 if (ACPI_FAILURE(rv)) {
562 if (rv != AE_NOT_FOUND)
563 printf("%s: unable to evaluate _GLK: %s\n",
564 sc->sc_dev.dv_xname,
565 AcpiFormatException(rv));
566 sc->sc_glk = 0;
567 } else
568 sc->sc_glk = v;
569
570 /*
571 * Install GPE handler.
572 *
573 * We evaluate the _GPE method to find the GPE bit used by the
574 * Embedded Controller to signal status (SCI).
575 */
576 rv = acpi_eval_integer(sc->sc_handle, "_GPE", &v);
577 if (ACPI_FAILURE(rv)) {
578 printf("%s: unable to evaluate _GPE: %s\n",
579 sc->sc_dev.dv_xname, AcpiFormatException(rv));
580 return;
581 }
582 sc->sc_gpebit = v;
583
584 /*
585 * Install a handler for this EC's GPE bit. Note that EC SCIs are
586 * treated as both edge- and level-triggered interrupts; in other words
587 * we clear the status bit immediately after getting an EC-SCI, then
588 * again after we're done processing the event. This guarantees that
589 * events we cause while performing a transaction (e.g. IBE/OBF) get
590 * cleared before re-enabling the GPE.
591 */
592 rv = AcpiInstallGpeHandler(NULL, sc->sc_gpebit,
593 ACPI_EVENT_EDGE_TRIGGERED, EcGpeHandler, sc);
594 if (ACPI_FAILURE(rv)) {
595 printf("%s: unable to install GPE handler: %s\n",
596 sc->sc_dev.dv_xname, AcpiFormatException(rv));
597 return;
598 }
599
600 /* Install address space handler. */
601 rv = AcpiInstallAddressSpaceHandler(sc->sc_handle,
602 ACPI_ADR_SPACE_EC, EcSpaceHandler, EcSpaceSetup, sc);
603 if (ACPI_FAILURE(rv)) {
604 printf("%s: unable to install address space handler: %s\n",
605 sc->sc_dev.dv_xname, AcpiFormatException(rv));
606 (void)AcpiRemoveGpeHandler(NULL, sc->sc_gpebit,
607 EcGpeHandler);
608 return;
609 }
610
611 return_VOID;
612 }
613
614 static void
615 EcGpeQueryHandler(void *Context)
616 {
617 struct acpi_ec_softc *sc = Context;
618 UINT8 Data;
619 ACPI_STATUS rv;
620 char qxx[5];
621
622 ACPI_FUNCTION_TRACE(__FUNCTION__);
623
624 for (;;) {
625 /*
626 * Check EC_SCI.
627 *
628 * Bail out if the EC_SCI bit of the status register is not
629 * set. Note that this function should only be called when
630 * this bit is set (polling is used to detect IBE/OBF events).
631 *
632 * It is safe to do this without locking the controller, as
633 * it's OK to call EcQuery when there's no data ready; in the
634 * worst case we should just find nothing waiting for us and
635 * bail.
636 */
637 if ((EC_CSR_READ(sc) & EC_EVENT_SCI) == 0)
638 break;
639
640 EcLock(sc);
641
642 /*
643 * Find out why the EC is signalling us
644 */
645 rv = EcQuery(sc, &Data);
646
647 EcUnlock(sc);
648
649 /*
650 * If we failed to get anything from the EC, give up.
651 */
652 if (ACPI_FAILURE(rv)) {
653 printf("%s: GPE query failed: %s\n",
654 sc->sc_dev.dv_xname, AcpiFormatException(rv));
655 break;
656 }
657
658 /*
659 * Evaluate _Qxx to respond to the controller.
660 */
661 sprintf(qxx, "_Q%02X", Data);
662 rv = AcpiEvaluateObject(sc->sc_handle, qxx,
663 NULL, NULL);
664
665 /*
666 * Ignore spurious query requests.
667 */
668 if (ACPI_FAILURE(rv) &&
669 (Data != 0 || rv != AE_NOT_FOUND)) {
670 printf("%s: evaluation of GPE query method %s "
671 "failed: %s\n", sc->sc_dev.dv_xname, qxx,
672 AcpiFormatException(rv));
673 }
674 }
675
676 /* I know I request Level trigger cleanup */
677 rv = AcpiClearGpe(NULL, sc->sc_gpebit, ACPI_NOT_ISR);
678 if (ACPI_FAILURE(rv))
679 printf("%s: AcpiClearGpe failed: %s\n", sc->sc_dev.dv_xname,
680 AcpiFormatException(rv));
681
682 return_VOID;
683 }
684
685 static void
686 EcGpeHandler(void *Context)
687 {
688 struct acpi_ec_softc *sc = Context;
689 uint32_t csrvalue;
690 ACPI_STATUS rv;
691
692 /*
693 * If EC is locked, the intr must process EcRead/Write wait only.
694 * Query request must be pending.
695 */
696 simple_lock(&sc->sc_slock);
697 if (sc->sc_flags & EC_F_TRANSACTION) {
698 csrvalue = EC_CSR_READ(sc);
699 if (csrvalue & EC_EVENT_SCI)
700 sc->sc_flags |= EC_F_PENDQUERY;
701
702 if ((csrvalue & EC_FLAG_OUTPUT_BUFFER) != 0 ||
703 (csrvalue & EC_FLAG_INPUT_BUFFER) == 0) {
704 sc->sc_csrvalue = csrvalue;
705 wakeup(&sc->sc_csrvalue);
706 }
707 simple_unlock(&sc->sc_slock);
708 } else {
709 simple_unlock(&sc->sc_slock);
710 /* Enqueue GpeQuery handler. */
711 rv = AcpiOsQueueForExecution(OSD_PRIORITY_HIGH,
712 EcGpeQueryHandler, Context);
713 if (ACPI_FAILURE(rv))
714 printf("%s: failed to enqueue query handler: %s\n",
715 sc->sc_dev.dv_xname, AcpiFormatException(rv));
716 }
717 }
718
719 static ACPI_STATUS
720 EcSpaceSetup(ACPI_HANDLE Region, UINT32 Function, void *Context,
721 void **RegionContext)
722 {
723
724 ACPI_FUNCTION_TRACE(__FUNCTION__);
725
726 /*
727 * Just pass the context through, there's nothing to do here.
728 */
729 if (Function == ACPI_REGION_DEACTIVATE)
730 *RegionContext = NULL;
731 else
732 *RegionContext = Context;
733
734 return_ACPI_STATUS(AE_OK);
735 }
736
737 static ACPI_STATUS
738 EcSpaceHandler(UINT32 Function, ACPI_PHYSICAL_ADDRESS Address, UINT32 width,
739 ACPI_INTEGER *Value, void *Context, void *RegionContext)
740 {
741 struct acpi_ec_softc *sc = Context;
742 ACPI_STATUS rv = AE_OK;
743 EC_REQUEST EcRequest;
744 int i;
745
746 ACPI_FUNCTION_TRACE_U32(__FUNCTION__, (UINT32)Address);
747
748 if ((Address > 0xFF) || (width % 8 != 0) || (Value == NULL) ||
749 (Context == NULL))
750 return_ACPI_STATUS(AE_BAD_PARAMETER);
751
752 switch (Function) {
753 case ACPI_READ:
754 EcRequest.Command = EC_COMMAND_READ;
755 EcRequest.Address = Address;
756 (*Value) = 0;
757 break;
758
759 case ACPI_WRITE:
760 EcRequest.Command = EC_COMMAND_WRITE;
761 EcRequest.Address = Address;
762 break;
763
764 default:
765 printf("%s: invalid Address Space function: %d\n",
766 sc->sc_dev.dv_xname, Function);
767 return_ACPI_STATUS(AE_BAD_PARAMETER);
768 }
769
770 /*
771 * Perform the transaction.
772 */
773 for (i = 0; i < width; i += 8) {
774 if (Function == ACPI_READ)
775 EcRequest.Data = 0;
776 else
777 EcRequest.Data = (UINT8)((*Value) >> i);
778
779 rv = EcTransaction(sc, &EcRequest);
780 if (ACPI_FAILURE(rv))
781 break;
782
783 (*Value) |= (UINT32)EcRequest.Data << i;
784 if (++EcRequest.Address == 0)
785 return_ACPI_STATUS(AE_BAD_PARAMETER);
786 }
787
788 return_ACPI_STATUS(rv);
789 }
790
791 static ACPI_STATUS
792 EcWaitEventIntr(struct acpi_ec_softc *sc, EC_EVENT Event)
793 {
794 EC_STATUS EcStatus;
795 int i;
796
797 ACPI_FUNCTION_TRACE_U32(__FUNCTION__, (UINT32)Event);
798
799 /* XXX Need better test for "yes, you have interrupts". */
800 if (cold)
801 return_ACPI_STATUS(EcWaitEvent(sc, Event));
802
803 if (EcIsLocked(sc) == 0)
804 printf("%s: EcWaitEventIntr called without EC lock!\n",
805 sc->sc_dev.dv_xname);
806
807 EcStatus = EC_CSR_READ(sc);
808
809 /* Too long? */
810 for (i = 0; i < 10; i++) {
811 /* Check EC status against the desired event. */
812 if ((Event == EC_EVENT_OUTPUT_BUFFER_FULL) &&
813 (EcStatus & EC_FLAG_OUTPUT_BUFFER) != 0)
814 return_ACPI_STATUS(AE_OK);
815
816 if ((Event == EC_EVENT_INPUT_BUFFER_EMPTY) &&
817 (EcStatus & EC_FLAG_INPUT_BUFFER) == 0)
818 return_ACPI_STATUS(AE_OK);
819
820 sc->sc_csrvalue = 0;
821 /* XXXJRT Sleeping with a lock held? */
822 if (tsleep(&sc->sc_csrvalue, 0, "EcWait", 1) != EWOULDBLOCK)
823 EcStatus = sc->sc_csrvalue;
824 else
825 EcStatus = EC_CSR_READ(sc);
826 }
827 return_ACPI_STATUS(AE_ERROR);
828 }
829
830 static ACPI_STATUS
831 EcWaitEvent(struct acpi_ec_softc *sc, EC_EVENT Event)
832 {
833 EC_STATUS EcStatus;
834 UINT32 i = 0;
835
836 if (EcIsLocked(sc) == 0)
837 printf("%s: EcWaitEvent called without EC lock!\n",
838 sc->sc_dev.dv_xname);
839
840 /*
841 * Stall 1us:
842 * ----------
843 * Stall for 1 microsecond before reading the status register
844 * for the first time. This allows the EC to set the IBF/OBF
845 * bit to its proper state.
846 *
847 * XXX it is not clear why we read the CSR twice.
848 */
849 AcpiOsStall(1);
850 EcStatus = EC_CSR_READ(sc);
851
852 /*
853 * Wait For Event:
854 * ---------------
855 * Poll the EC status register to detect completion of the last
856 * command. Wait up to 10ms (in 100us chunks) for this to occur.
857 */
858 for (i = 0; i < 100; i++) {
859 EcStatus = EC_CSR_READ(sc);
860
861 if ((Event == EC_EVENT_OUTPUT_BUFFER_FULL) &&
862 (EcStatus & EC_FLAG_OUTPUT_BUFFER) != 0)
863 return AE_OK;
864
865 if ((Event == EC_EVENT_INPUT_BUFFER_EMPTY) &&
866 (EcStatus & EC_FLAG_INPUT_BUFFER) == 0)
867 return AE_OK;
868
869 AcpiOsStall(10);
870 }
871
872 return AE_ERROR;
873 }
874
875 static ACPI_STATUS
876 EcQuery(struct acpi_ec_softc *sc, UINT8 *Data)
877 {
878 ACPI_STATUS rv;
879
880 if (EcIsLocked(sc) == 0)
881 printf("%s: EcQuery called without EC lock!\n",
882 sc->sc_dev.dv_xname);
883
884 EC_CSR_WRITE(sc, EC_COMMAND_QUERY);
885 rv = EcWaitEventIntr(sc, EC_EVENT_OUTPUT_BUFFER_FULL);
886 if (ACPI_SUCCESS(rv))
887 *Data = EC_DATA_READ(sc);
888
889 if (ACPI_FAILURE(rv))
890 printf("%s: timed out waiting for EC to respond to "
891 "EC_COMMAND_QUERY\n", sc->sc_dev.dv_xname);
892
893 return rv;
894 }
895
896 static ACPI_STATUS
897 EcTransaction(struct acpi_ec_softc *sc, EC_REQUEST *EcRequest)
898 {
899 ACPI_STATUS rv;
900
901 EcLock(sc);
902
903 /*
904 * Perform the transaction.
905 */
906 switch (EcRequest->Command) {
907 case EC_COMMAND_READ:
908 rv = EcRead(sc, EcRequest->Address, &(EcRequest->Data));
909 break;
910
911 case EC_COMMAND_WRITE:
912 rv = EcWrite(sc, EcRequest->Address, &(EcRequest->Data));
913 break;
914
915 default:
916 rv = AE_SUPPORT;
917 break;
918 }
919
920 EcUnlock(sc);
921
922 return rv;
923 }
924
925 static ACPI_STATUS
926 EcRead(struct acpi_ec_softc *sc, UINT8 Address, UINT8 *Data)
927 {
928 ACPI_STATUS rv;
929
930 if (EcIsLocked(sc) == 0)
931 printf("%s: EcRead called without EC lock!\n",
932 sc->sc_dev.dv_xname);
933
934 /* EcBurstEnable(EmbeddedController); */
935
936 EC_CSR_WRITE(sc, EC_COMMAND_READ);
937 if ((rv = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
938 AE_OK) {
939 printf("%s: EcRead: timeout waiting for EC to process "
940 "read command\n", sc->sc_dev.dv_xname);
941 return rv;
942 }
943
944 EC_DATA_WRITE(sc, Address);
945 if ((rv = EcWaitEventIntr(sc, EC_EVENT_OUTPUT_BUFFER_FULL)) !=
946 AE_OK) {
947 printf("%s: EcRead: timeout waiting for EC to send data\n",
948 sc->sc_dev.dv_xname);
949 return rv;
950 }
951
952 (*Data) = EC_DATA_READ(sc);
953
954 /* EcBurstDisable(EmbeddedController); */
955
956 return AE_OK;
957 }
958
959 static ACPI_STATUS
960 EcWrite(struct acpi_ec_softc *sc, UINT8 Address, UINT8 *Data)
961 {
962 ACPI_STATUS rv;
963
964 if (EcIsLocked(sc) == 0)
965 printf("%s: EcWrite called without EC lock!\n",
966 sc->sc_dev.dv_xname);
967
968 /* EcBurstEnable(EmbeddedController); */
969
970 EC_CSR_WRITE(sc, EC_COMMAND_WRITE);
971 if ((rv = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
972 AE_OK) {
973 printf("%s: EcWrite: timeout waiting for EC to process "
974 "write command\n", sc->sc_dev.dv_xname);
975 return rv;
976 }
977
978 EC_DATA_WRITE(sc, Address);
979 if ((rv = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
980 AE_OK) {
981 printf("%s: EcWrite: timeout waiting for EC to process "
982 "address\n", sc->sc_dev.dv_xname);
983 return rv;
984 }
985
986 EC_DATA_WRITE(sc, *Data);
987 if ((rv = EcWaitEventIntr(sc, EC_EVENT_INPUT_BUFFER_EMPTY)) !=
988 AE_OK) {
989 printf("%s: EcWrite: timeout waiting for EC to process "
990 "data\n", sc->sc_dev.dv_xname);
991 return rv;
992 }
993
994 /* EcBurstDisable(EmbeddedController); */
995
996 return AE_OK;
997 }
998