xref: /linux/drivers/acpi/evged.c (revision e58e871becec2d3b04ed91c0c16fe8deac9c9dfa)
1 /*
2  * Generic Event Device for ACPI.
3  *
4  * Copyright (c) 2016, The Linux Foundation. All rights reserved.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 and
8  * only version 2 as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * Generic Event Device allows platforms to handle interrupts in ACPI
16  * ASL statements. It follows very similar to  _EVT method approach
17  * from GPIO events. All interrupts are listed in _CRS and the handler
18  * is written in _EVT method. Here is an example.
19  *
20  * Device (GED0)
21  * {
22  *
23  *     Name (_HID, "ACPI0013")
24  *     Name (_UID, 0)
25  *     Method (_CRS, 0x0, Serialized)
26  *     {
27  *		Name (RBUF, ResourceTemplate ()
28  *		{
29  *		Interrupt(ResourceConsumer, Edge, ActiveHigh, Shared, , , )
30  *		{123}
31  *		}
32  *     })
33  *
34  *     Method (_EVT, 1) {
35  *             if (Lequal(123, Arg0))
36  *             {
37  *             }
38  *     }
39  * }
40  *
41  */
42 
43 #include <linux/err.h>
44 #include <linux/init.h>
45 #include <linux/interrupt.h>
46 #include <linux/list.h>
47 #include <linux/platform_device.h>
48 #include <linux/acpi.h>
49 
50 #define MODULE_NAME	"acpi-ged"
51 
52 struct acpi_ged_event {
53 	struct list_head node;
54 	struct device *dev;
55 	unsigned int gsi;
56 	unsigned int irq;
57 	acpi_handle handle;
58 };
59 
60 static irqreturn_t acpi_ged_irq_handler(int irq, void *data)
61 {
62 	struct acpi_ged_event *event = data;
63 	acpi_status acpi_ret;
64 
65 	acpi_ret = acpi_execute_simple_method(event->handle, NULL, event->gsi);
66 	if (ACPI_FAILURE(acpi_ret))
67 		dev_err_once(event->dev, "IRQ method execution failed\n");
68 
69 	return IRQ_HANDLED;
70 }
71 
72 static acpi_status acpi_ged_request_interrupt(struct acpi_resource *ares,
73 					      void *context)
74 {
75 	struct acpi_ged_event *event;
76 	unsigned int irq;
77 	unsigned int gsi;
78 	unsigned int irqflags = IRQF_ONESHOT;
79 	struct device *dev = context;
80 	acpi_handle handle = ACPI_HANDLE(dev);
81 	acpi_handle evt_handle;
82 	struct resource r;
83 	struct acpi_resource_irq *p = &ares->data.irq;
84 	struct acpi_resource_extended_irq *pext = &ares->data.extended_irq;
85 
86 	if (ares->type == ACPI_RESOURCE_TYPE_END_TAG)
87 		return AE_OK;
88 
89 	if (!acpi_dev_resource_interrupt(ares, 0, &r)) {
90 		dev_err(dev, "unable to parse IRQ resource\n");
91 		return AE_ERROR;
92 	}
93 	if (ares->type == ACPI_RESOURCE_TYPE_IRQ)
94 		gsi = p->interrupts[0];
95 	else
96 		gsi = pext->interrupts[0];
97 
98 	irq = r.start;
99 
100 	if (ACPI_FAILURE(acpi_get_handle(handle, "_EVT", &evt_handle))) {
101 		dev_err(dev, "cannot locate _EVT method\n");
102 		return AE_ERROR;
103 	}
104 
105 	dev_info(dev, "GED listening GSI %u @ IRQ %u\n", gsi, irq);
106 
107 	event = devm_kzalloc(dev, sizeof(*event), GFP_KERNEL);
108 	if (!event)
109 		return AE_ERROR;
110 
111 	event->gsi = gsi;
112 	event->dev = dev;
113 	event->irq = irq;
114 	event->handle = evt_handle;
115 
116 	if (r.flags & IORESOURCE_IRQ_SHAREABLE)
117 		irqflags |= IRQF_SHARED;
118 
119 	if (devm_request_threaded_irq(dev, irq, NULL, acpi_ged_irq_handler,
120 				      irqflags, "ACPI:Ged", event)) {
121 		dev_err(dev, "failed to setup event handler for irq %u\n", irq);
122 		return AE_ERROR;
123 	}
124 
125 	return AE_OK;
126 }
127 
128 static int ged_probe(struct platform_device *pdev)
129 {
130 	acpi_status acpi_ret;
131 
132 	acpi_ret = acpi_walk_resources(ACPI_HANDLE(&pdev->dev), "_CRS",
133 				       acpi_ged_request_interrupt, &pdev->dev);
134 	if (ACPI_FAILURE(acpi_ret)) {
135 		dev_err(&pdev->dev, "unable to parse the _CRS record\n");
136 		return -EINVAL;
137 	}
138 
139 	return 0;
140 }
141 
142 static const struct acpi_device_id ged_acpi_ids[] = {
143 	{"ACPI0013"},
144 	{},
145 };
146 
147 static struct platform_driver ged_driver = {
148 	.probe = ged_probe,
149 	.driver = {
150 		.name = MODULE_NAME,
151 		.acpi_match_table = ACPI_PTR(ged_acpi_ids),
152 	},
153 };
154 builtin_platform_driver(ged_driver);
155