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