2 * acpi_ec.c - ACPI Embedded Controller Driver ($Revision: 38 $)
4 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
5 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or (at
12 * your option) any later version.
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
23 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26 #include <linux/kernel.h>
27 #include <linux/module.h>
28 #include <linux/init.h>
29 #include <linux/types.h>
30 #include <linux/delay.h>
31 #include <linux/proc_fs.h>
33 #include <acpi/acpi_bus.h>
34 #include <acpi/acpi_drivers.h>
35 #include <acpi/actypes.h>
37 #define _COMPONENT ACPI_EC_COMPONENT
38 ACPI_MODULE_NAME ("acpi_ec")
40 #define ACPI_EC_COMPONENT 0x00100000
41 #define ACPI_EC_CLASS "embedded_controller"
42 #define ACPI_EC_HID "PNP0C09"
43 #define ACPI_EC_DRIVER_NAME "ACPI Embedded Controller Driver"
44 #define ACPI_EC_DEVICE_NAME "Embedded Controller"
45 #define ACPI_EC_FILE_INFO "info"
48 #define ACPI_EC_FLAG_OBF 0x01 /* Output buffer full */
49 #define ACPI_EC_FLAG_IBF 0x02 /* Input buffer full */
50 #define ACPI_EC_FLAG_SCI 0x20 /* EC-SCI occurred */
52 #define ACPI_EC_EVENT_OBF 0x01 /* Output buffer full */
53 #define ACPI_EC_EVENT_IBE 0x02 /* Input buffer empty */
55 #define ACPI_EC_UDELAY 100 /* Poll @ 100us increments */
56 #define ACPI_EC_UDELAY_COUNT 1000 /* Wait 10ms max. during EC ops */
57 #define ACPI_EC_UDELAY_GLK 1000 /* Wait 1ms max. to get global lock */
59 #define ACPI_EC_COMMAND_READ 0x80
60 #define ACPI_EC_COMMAND_WRITE 0x81
61 #define ACPI_EC_COMMAND_QUERY 0x84
63 static int acpi_ec_add (struct acpi_device
*device
);
64 static int acpi_ec_remove (struct acpi_device
*device
, int type
);
65 static int acpi_ec_start (struct acpi_device
*device
);
66 static int acpi_ec_stop (struct acpi_device
*device
, int type
);
68 static struct acpi_driver acpi_ec_driver
= {
69 .name
= ACPI_EC_DRIVER_NAME
,
70 .class = ACPI_EC_CLASS
,
74 .remove
= acpi_ec_remove
,
75 .start
= acpi_ec_start
,
83 unsigned long gpe_bit
;
84 struct acpi_generic_address status_addr
;
85 struct acpi_generic_address command_addr
;
86 struct acpi_generic_address data_addr
;
87 unsigned long global_lock
;
91 /* If we find an EC via the ECDT, we need to keep a ptr to its context */
92 static struct acpi_ec
*ec_ecdt
;
94 /* External interfaces use first EC only, so remember */
95 static struct acpi_device
*first_ec
;
97 /* --------------------------------------------------------------------------
98 Transaction Management
99 -------------------------------------------------------------------------- */
106 u32 acpi_ec_status
= 0;
107 u32 i
= ACPI_EC_UDELAY_COUNT
;
112 /* Poll the EC status register waiting for the event to occur. */
114 case ACPI_EC_EVENT_OBF
:
116 acpi_hw_low_level_read(8, &acpi_ec_status
, &ec
->status_addr
);
117 if (acpi_ec_status
& ACPI_EC_FLAG_OBF
)
119 udelay(ACPI_EC_UDELAY
);
122 case ACPI_EC_EVENT_IBE
:
124 acpi_hw_low_level_read(8, &acpi_ec_status
, &ec
->status_addr
);
125 if (!(acpi_ec_status
& ACPI_EC_FLAG_IBF
))
127 udelay(ACPI_EC_UDELAY
);
144 acpi_status status
= AE_OK
;
146 unsigned long flags
= 0;
149 ACPI_FUNCTION_TRACE("acpi_ec_read");
152 return_VALUE(-EINVAL
);
156 if (ec
->global_lock
) {
157 status
= acpi_acquire_global_lock(ACPI_EC_UDELAY_GLK
, &glk
);
158 if (ACPI_FAILURE(status
))
159 return_VALUE(-ENODEV
);
162 spin_lock_irqsave(&ec
->lock
, flags
);
164 acpi_hw_low_level_write(8, ACPI_EC_COMMAND_READ
, &ec
->command_addr
);
165 result
= acpi_ec_wait(ec
, ACPI_EC_EVENT_IBE
);
169 acpi_hw_low_level_write(8, address
, &ec
->data_addr
);
170 result
= acpi_ec_wait(ec
, ACPI_EC_EVENT_OBF
);
175 acpi_hw_low_level_read(8, data
, &ec
->data_addr
);
177 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Read [%02x] from address [%02x]\n",
181 spin_unlock_irqrestore(&ec
->lock
, flags
);
184 acpi_release_global_lock(glk
);
186 return_VALUE(result
);
197 acpi_status status
= AE_OK
;
198 unsigned long flags
= 0;
201 ACPI_FUNCTION_TRACE("acpi_ec_write");
204 return_VALUE(-EINVAL
);
206 if (ec
->global_lock
) {
207 status
= acpi_acquire_global_lock(ACPI_EC_UDELAY_GLK
, &glk
);
208 if (ACPI_FAILURE(status
))
209 return_VALUE(-ENODEV
);
212 spin_lock_irqsave(&ec
->lock
, flags
);
214 acpi_hw_low_level_write(8, ACPI_EC_COMMAND_WRITE
, &ec
->command_addr
);
215 result
= acpi_ec_wait(ec
, ACPI_EC_EVENT_IBE
);
219 acpi_hw_low_level_write(8, address
, &ec
->data_addr
);
220 result
= acpi_ec_wait(ec
, ACPI_EC_EVENT_IBE
);
224 acpi_hw_low_level_write(8, data
, &ec
->data_addr
);
225 result
= acpi_ec_wait(ec
, ACPI_EC_EVENT_IBE
);
229 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Wrote [%02x] to address [%02x]\n",
233 spin_unlock_irqrestore(&ec
->lock
, flags
);
236 acpi_release_global_lock(glk
);
238 return_VALUE(result
);
242 * Externally callable EC access functions. For now, assume 1 EC only
245 ec_read(u8 addr
, u8
*val
)
254 ec
= acpi_driver_data(first_ec
);
256 err
= acpi_ec_read(ec
, addr
, &temp_data
);
267 ec_write(u8 addr
, u8 val
)
275 ec
= acpi_driver_data(first_ec
);
277 err
= acpi_ec_write(ec
, addr
, val
);
289 acpi_status status
= AE_OK
;
290 unsigned long flags
= 0;
293 ACPI_FUNCTION_TRACE("acpi_ec_query");
296 return_VALUE(-EINVAL
);
300 if (ec
->global_lock
) {
301 status
= acpi_acquire_global_lock(ACPI_EC_UDELAY_GLK
, &glk
);
302 if (ACPI_FAILURE(status
))
303 return_VALUE(-ENODEV
);
307 * Query the EC to find out which _Qxx method we need to evaluate.
308 * Note that successful completion of the query causes the ACPI_EC_SCI
309 * bit to be cleared (and thus clearing the interrupt source).
311 spin_lock_irqsave(&ec
->lock
, flags
);
313 acpi_hw_low_level_write(8, ACPI_EC_COMMAND_QUERY
, &ec
->command_addr
);
314 result
= acpi_ec_wait(ec
, ACPI_EC_EVENT_OBF
);
318 acpi_hw_low_level_read(8, data
, &ec
->data_addr
);
323 spin_unlock_irqrestore(&ec
->lock
, flags
);
326 acpi_release_global_lock(glk
);
328 return_VALUE(result
);
332 /* --------------------------------------------------------------------------
334 -------------------------------------------------------------------------- */
336 struct acpi_ec_query_data
{
345 struct acpi_ec
*ec
= (struct acpi_ec
*) ec_cxt
;
347 unsigned long flags
= 0;
348 static char object_name
[5] = {'_','Q','0','0','\0'};
349 const char hex
[] = {'0','1','2','3','4','5','6','7',
350 '8','9','A','B','C','D','E','F'};
352 ACPI_FUNCTION_TRACE("acpi_ec_gpe_query");
357 spin_lock_irqsave(&ec
->lock
, flags
);
358 acpi_hw_low_level_read(8, &value
, &ec
->command_addr
);
359 spin_unlock_irqrestore(&ec
->lock
, flags
);
361 /* TBD: Implement asynch events!
362 * NOTE: All we care about are EC-SCI's. Other EC events are
363 * handled via polling (yuck!). This is because some systems
364 * treat EC-SCIs as level (versus EDGE!) triggered, preventing
365 * a purely interrupt-driven approach (grumble, grumble).
367 if (!(value
& ACPI_EC_FLAG_SCI
))
370 if (acpi_ec_query(ec
, &value
))
373 object_name
[2] = hex
[((value
>> 4) & 0x0F)];
374 object_name
[3] = hex
[(value
& 0x0F)];
376 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Evaluating %s\n", object_name
));
378 acpi_evaluate_object(ec
->handle
, object_name
, NULL
, NULL
);
381 acpi_enable_gpe(NULL
, ec
->gpe_bit
, ACPI_NOT_ISR
);
385 acpi_ec_gpe_handler (
388 acpi_status status
= AE_OK
;
389 struct acpi_ec
*ec
= (struct acpi_ec
*) data
;
394 acpi_disable_gpe(NULL
, ec
->gpe_bit
, ACPI_ISR
);
396 status
= acpi_os_queue_for_execution(OSD_PRIORITY_GPE
,
397 acpi_ec_gpe_query
, ec
);
400 /* --------------------------------------------------------------------------
401 Address Space Management
402 -------------------------------------------------------------------------- */
405 acpi_ec_space_setup (
406 acpi_handle region_handle
,
408 void *handler_context
,
409 void **return_context
)
412 * The EC object is in the handler context and is needed
413 * when calling the acpi_ec_space_handler.
415 if(function
== ACPI_REGION_DEACTIVATE
)
416 *return_context
= NULL
;
418 *return_context
= handler_context
;
425 acpi_ec_space_handler (
427 acpi_physical_address address
,
430 void *handler_context
,
431 void *region_context
)
434 struct acpi_ec
*ec
= NULL
;
437 ACPI_FUNCTION_TRACE("acpi_ec_space_handler");
439 if ((address
> 0xFF) || (bit_width
!= 8) || !value
|| !handler_context
)
440 return_VALUE(AE_BAD_PARAMETER
);
442 ec
= (struct acpi_ec
*) handler_context
;
446 result
= acpi_ec_read(ec
, (u8
) address
, &temp
);
447 *value
= (acpi_integer
) temp
;
450 result
= acpi_ec_write(ec
, (u8
) address
, (u8
) *value
);
459 return_VALUE(AE_BAD_PARAMETER
);
462 return_VALUE(AE_NOT_FOUND
);
465 return_VALUE(AE_TIME
);
474 /* --------------------------------------------------------------------------
476 -------------------------------------------------------------------------- */
478 struct proc_dir_entry
*acpi_ec_dir
= NULL
;
490 struct acpi_ec
*ec
= (struct acpi_ec
*) data
;
494 ACPI_FUNCTION_TRACE("acpi_ec_read_info");
496 if (!ec
|| (off
!= 0))
499 p
+= sprintf(p
, "gpe bit: 0x%02x\n",
501 p
+= sprintf(p
, "ports: 0x%02x, 0x%02x\n",
502 (u32
) ec
->status_addr
.address
, (u32
) ec
->data_addr
.address
);
503 p
+= sprintf(p
, "use global lock: %s\n",
504 ec
->global_lock
?"yes":"no");
508 if (len
<= off
+count
) *eof
= 1;
511 if (len
>count
) len
= count
;
520 struct acpi_device
*device
)
522 struct proc_dir_entry
*entry
= NULL
;
524 ACPI_FUNCTION_TRACE("acpi_ec_add_fs");
526 if (!acpi_device_dir(device
)) {
527 acpi_device_dir(device
) = proc_mkdir(acpi_device_bid(device
),
529 if (!acpi_device_dir(device
))
530 return_VALUE(-ENODEV
);
533 entry
= create_proc_read_entry(ACPI_EC_FILE_INFO
, S_IRUGO
,
534 acpi_device_dir(device
), acpi_ec_read_info
,
535 acpi_driver_data(device
));
537 ACPI_DEBUG_PRINT((ACPI_DB_WARN
,
538 "Unable to create '%s' fs entry\n",
547 struct acpi_device
*device
)
549 ACPI_FUNCTION_TRACE("acpi_ec_remove_fs");
555 /* --------------------------------------------------------------------------
557 -------------------------------------------------------------------------- */
561 struct acpi_device
*device
)
564 acpi_status status
= AE_OK
;
565 struct acpi_ec
*ec
= NULL
;
568 ACPI_FUNCTION_TRACE("acpi_ec_add");
571 return_VALUE(-EINVAL
);
573 ec
= kmalloc(sizeof(struct acpi_ec
), GFP_KERNEL
);
575 return_VALUE(-ENOMEM
);
576 memset(ec
, 0, sizeof(struct acpi_ec
));
578 ec
->handle
= device
->handle
;
580 ec
->lock
= SPIN_LOCK_UNLOCKED
;
581 sprintf(acpi_device_name(device
), "%s", ACPI_EC_DEVICE_NAME
);
582 sprintf(acpi_device_class(device
), "%s", ACPI_EC_CLASS
);
583 acpi_driver_data(device
) = ec
;
585 /* Use the global lock for all EC transactions? */
586 acpi_evaluate_integer(ec
->handle
, "_GLK", NULL
, &ec
->global_lock
);
588 /* If our UID matches the UID for the ECDT-enumerated EC,
589 we now have the *real* EC info, so kill the makeshift one.*/
590 acpi_evaluate_integer(ec
->handle
, "_UID", NULL
, &uid
);
591 if (ec_ecdt
&& ec_ecdt
->uid
== uid
) {
592 acpi_remove_address_space_handler(ACPI_ROOT_OBJECT
,
593 ACPI_ADR_SPACE_EC
, &acpi_ec_space_handler
);
595 acpi_remove_gpe_handler(NULL
, ec_ecdt
->gpe_bit
, &acpi_ec_gpe_handler
);
600 /* Get GPE bit assignment (EC events). */
601 /* TODO: Add support for _GPE returning a package */
602 status
= acpi_evaluate_integer(ec
->handle
, "_GPE", NULL
, &ec
->gpe_bit
);
603 if (ACPI_FAILURE(status
)) {
604 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
605 "Error obtaining GPE bit assignment\n"));
610 result
= acpi_ec_add_fs(device
);
614 printk(KERN_INFO PREFIX
"%s [%s] (gpe %d)\n",
615 acpi_device_name(device
), acpi_device_bid(device
),
625 return_VALUE(result
);
631 struct acpi_device
*device
,
634 struct acpi_ec
*ec
= NULL
;
636 ACPI_FUNCTION_TRACE("acpi_ec_remove");
639 return_VALUE(-EINVAL
);
641 ec
= acpi_driver_data(device
);
643 acpi_ec_remove_fs(device
);
653 struct acpi_resource
*resource
,
656 struct acpi_ec
*ec
= (struct acpi_ec
*) context
;
657 struct acpi_generic_address
*addr
;
659 if (resource
->id
!= ACPI_RSTYPE_IO
) {
664 * The first address region returned is the data port, and
665 * the second address region returned is the status/command
668 if (ec
->data_addr
.register_bit_width
== 0) {
669 addr
= &ec
->data_addr
;
670 } else if (ec
->command_addr
.register_bit_width
== 0) {
671 addr
= &ec
->command_addr
;
673 return AE_CTRL_TERMINATE
;
676 addr
->address_space_id
= ACPI_ADR_SPACE_SYSTEM_IO
;
677 addr
->register_bit_width
= 8;
678 addr
->register_bit_offset
= 0;
679 addr
->address
= resource
->data
.io
.min_base_address
;
687 struct acpi_device
*device
)
689 acpi_status status
= AE_OK
;
690 struct acpi_ec
*ec
= NULL
;
692 ACPI_FUNCTION_TRACE("acpi_ec_start");
695 return_VALUE(-EINVAL
);
697 ec
= acpi_driver_data(device
);
700 return_VALUE(-EINVAL
);
703 * Get I/O port addresses. Convert to GAS format.
705 status
= acpi_walk_resources(ec
->handle
, METHOD_NAME__CRS
,
706 acpi_ec_io_ports
, ec
);
707 if (ACPI_FAILURE(status
) || ec
->command_addr
.register_bit_width
== 0) {
708 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
, "Error getting I/O port addresses"));
709 return_VALUE(-ENODEV
);
712 ec
->status_addr
= ec
->command_addr
;
714 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "gpe=0x%02x, ports=0x%2x,0x%2x\n",
715 (u32
) ec
->gpe_bit
, (u32
) ec
->command_addr
.address
,
716 (u32
) ec
->data_addr
.address
));
719 * Install GPE handler
721 status
= acpi_install_gpe_handler(NULL
, ec
->gpe_bit
,
722 ACPI_EVENT_EDGE_TRIGGERED
, &acpi_ec_gpe_handler
, ec
);
723 if (ACPI_FAILURE(status
)) {
724 return_VALUE(-ENODEV
);
727 status
= acpi_install_address_space_handler (ec
->handle
,
728 ACPI_ADR_SPACE_EC
, &acpi_ec_space_handler
,
729 &acpi_ec_space_setup
, ec
);
730 if (ACPI_FAILURE(status
)) {
731 acpi_remove_gpe_handler(NULL
, ec
->gpe_bit
, &acpi_ec_gpe_handler
);
732 return_VALUE(-ENODEV
);
741 struct acpi_device
*device
,
744 acpi_status status
= AE_OK
;
745 struct acpi_ec
*ec
= NULL
;
747 ACPI_FUNCTION_TRACE("acpi_ec_stop");
750 return_VALUE(-EINVAL
);
752 ec
= acpi_driver_data(device
);
754 status
= acpi_remove_address_space_handler(ec
->handle
,
755 ACPI_ADR_SPACE_EC
, &acpi_ec_space_handler
);
756 if (ACPI_FAILURE(status
))
757 return_VALUE(-ENODEV
);
759 status
= acpi_remove_gpe_handler(NULL
, ec
->gpe_bit
, &acpi_ec_gpe_handler
);
760 if (ACPI_FAILURE(status
))
761 return_VALUE(-ENODEV
);
768 acpi_ec_ecdt_probe (void)
771 struct acpi_table_ecdt
*ecdt_ptr
;
773 status
= acpi_get_firmware_table("ECDT", 1, ACPI_LOGICAL_ADDRESSING
,
774 (struct acpi_table_header
**) &ecdt_ptr
);
775 if (ACPI_FAILURE(status
))
778 printk(KERN_INFO PREFIX
"Found ECDT\n");
781 * Generate a temporary ec context to use until the namespace is scanned
783 ec_ecdt
= kmalloc(sizeof(struct acpi_ec
), GFP_KERNEL
);
786 memset(ec_ecdt
, 0, sizeof(struct acpi_ec
));
788 ec_ecdt
->command_addr
= ecdt_ptr
->ec_control
;
789 ec_ecdt
->status_addr
= ecdt_ptr
->ec_control
;
790 ec_ecdt
->data_addr
= ecdt_ptr
->ec_data
;
791 ec_ecdt
->gpe_bit
= ecdt_ptr
->gpe_bit
;
792 ec_ecdt
->lock
= SPIN_LOCK_UNLOCKED
;
793 /* use the GL just to be safe */
794 ec_ecdt
->global_lock
= TRUE
;
795 ec_ecdt
->uid
= ecdt_ptr
->uid
;
797 status
= acpi_get_handle(NULL
, ecdt_ptr
->ec_id
, &ec_ecdt
->handle
);
798 if (ACPI_FAILURE(status
)) {
803 * Install GPE handler
805 status
= acpi_install_gpe_handler(NULL
, ec_ecdt
->gpe_bit
,
806 ACPI_EVENT_EDGE_TRIGGERED
, &acpi_ec_gpe_handler
,
808 if (ACPI_FAILURE(status
)) {
812 status
= acpi_install_address_space_handler (ACPI_ROOT_OBJECT
,
813 ACPI_ADR_SPACE_EC
, &acpi_ec_space_handler
,
814 &acpi_ec_space_setup
, ec_ecdt
);
815 if (ACPI_FAILURE(status
)) {
816 acpi_remove_gpe_handler(NULL
, ec_ecdt
->gpe_bit
,
817 &acpi_ec_gpe_handler
);
824 printk(KERN_ERR PREFIX
"Could not use ECDT\n");
832 static int __init
acpi_ec_init (void)
836 ACPI_FUNCTION_TRACE("acpi_ec_init");
841 acpi_ec_dir
= proc_mkdir(ACPI_EC_CLASS
, acpi_root_dir
);
843 return_VALUE(-ENODEV
);
845 /* Now register the driver for the EC */
846 result
= acpi_bus_register_driver(&acpi_ec_driver
);
848 remove_proc_entry(ACPI_EC_CLASS
, acpi_root_dir
);
849 return_VALUE(-ENODEV
);
852 return_VALUE(result
);
855 subsys_initcall(acpi_ec_init
);
857 /* EC driver currently not unloadable */
862 ACPI_FUNCTION_TRACE("acpi_ec_exit");
864 acpi_bus_unregister_driver(&acpi_ec_driver
);
866 remove_proc_entry(ACPI_EC_CLASS
, acpi_root_dir
);