Loading...
1/*
2 * SMBus driver for ACPI Embedded Controller (v0.1)
3 *
4 * Copyright (c) 2007 Alexey Starikovskiy
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 as published by
8 * the Free Software Foundation version 2.
9 */
10
11#include <acpi/acpi_bus.h>
12#include <acpi/acpi_drivers.h>
13#include <linux/wait.h>
14#include <linux/slab.h>
15#include <linux/delay.h>
16#include <linux/interrupt.h>
17#include "sbshc.h"
18
19#define PREFIX "ACPI: "
20
21#define ACPI_SMB_HC_CLASS "smbus_host_ctl"
22#define ACPI_SMB_HC_DEVICE_NAME "ACPI SMBus HC"
23
24struct acpi_smb_hc {
25 struct acpi_ec *ec;
26 struct mutex lock;
27 wait_queue_head_t wait;
28 u8 offset;
29 u8 query_bit;
30 smbus_alarm_callback callback;
31 void *context;
32};
33
34static int acpi_smbus_hc_add(struct acpi_device *device);
35static int acpi_smbus_hc_remove(struct acpi_device *device, int type);
36
37static const struct acpi_device_id sbs_device_ids[] = {
38 {"ACPI0001", 0},
39 {"ACPI0005", 0},
40 {"", 0},
41};
42
43MODULE_DEVICE_TABLE(acpi, sbs_device_ids);
44
45static struct acpi_driver acpi_smb_hc_driver = {
46 .name = "smbus_hc",
47 .class = ACPI_SMB_HC_CLASS,
48 .ids = sbs_device_ids,
49 .ops = {
50 .add = acpi_smbus_hc_add,
51 .remove = acpi_smbus_hc_remove,
52 },
53};
54
55union acpi_smb_status {
56 u8 raw;
57 struct {
58 u8 status:5;
59 u8 reserved:1;
60 u8 alarm:1;
61 u8 done:1;
62 } fields;
63};
64
65enum acpi_smb_status_codes {
66 SMBUS_OK = 0,
67 SMBUS_UNKNOWN_FAILURE = 0x07,
68 SMBUS_DEVICE_ADDRESS_NACK = 0x10,
69 SMBUS_DEVICE_ERROR = 0x11,
70 SMBUS_DEVICE_COMMAND_ACCESS_DENIED = 0x12,
71 SMBUS_UNKNOWN_ERROR = 0x13,
72 SMBUS_DEVICE_ACCESS_DENIED = 0x17,
73 SMBUS_TIMEOUT = 0x18,
74 SMBUS_HOST_UNSUPPORTED_PROTOCOL = 0x19,
75 SMBUS_BUSY = 0x1a,
76 SMBUS_PEC_ERROR = 0x1f,
77};
78
79enum acpi_smb_offset {
80 ACPI_SMB_PROTOCOL = 0, /* protocol, PEC */
81 ACPI_SMB_STATUS = 1, /* status */
82 ACPI_SMB_ADDRESS = 2, /* address */
83 ACPI_SMB_COMMAND = 3, /* command */
84 ACPI_SMB_DATA = 4, /* 32 data registers */
85 ACPI_SMB_BLOCK_COUNT = 0x24, /* number of data bytes */
86 ACPI_SMB_ALARM_ADDRESS = 0x25, /* alarm address */
87 ACPI_SMB_ALARM_DATA = 0x26, /* 2 bytes alarm data */
88};
89
90static inline int smb_hc_read(struct acpi_smb_hc *hc, u8 address, u8 *data)
91{
92 return ec_read(hc->offset + address, data);
93}
94
95static inline int smb_hc_write(struct acpi_smb_hc *hc, u8 address, u8 data)
96{
97 return ec_write(hc->offset + address, data);
98}
99
100static inline int smb_check_done(struct acpi_smb_hc *hc)
101{
102 union acpi_smb_status status = {.raw = 0};
103 smb_hc_read(hc, ACPI_SMB_STATUS, &status.raw);
104 return status.fields.done && (status.fields.status == SMBUS_OK);
105}
106
107static int wait_transaction_complete(struct acpi_smb_hc *hc, int timeout)
108{
109 if (wait_event_timeout(hc->wait, smb_check_done(hc),
110 msecs_to_jiffies(timeout)))
111 return 0;
112 /*
113 * After the timeout happens, OS will try to check the status of SMbus.
114 * If the status is what OS expected, it will be regarded as the bogus
115 * timeout.
116 */
117 if (smb_check_done(hc))
118 return 0;
119 else
120 return -ETIME;
121}
122
123static int acpi_smbus_transaction(struct acpi_smb_hc *hc, u8 protocol,
124 u8 address, u8 command, u8 *data, u8 length)
125{
126 int ret = -EFAULT, i;
127 u8 temp, sz = 0;
128
129 if (!hc) {
130 printk(KERN_ERR PREFIX "host controller is not configured\n");
131 return ret;
132 }
133
134 mutex_lock(&hc->lock);
135 if (smb_hc_read(hc, ACPI_SMB_PROTOCOL, &temp))
136 goto end;
137 if (temp) {
138 ret = -EBUSY;
139 goto end;
140 }
141 smb_hc_write(hc, ACPI_SMB_COMMAND, command);
142 if (!(protocol & 0x01)) {
143 smb_hc_write(hc, ACPI_SMB_BLOCK_COUNT, length);
144 for (i = 0; i < length; ++i)
145 smb_hc_write(hc, ACPI_SMB_DATA + i, data[i]);
146 }
147 smb_hc_write(hc, ACPI_SMB_ADDRESS, address << 1);
148 smb_hc_write(hc, ACPI_SMB_PROTOCOL, protocol);
149 /*
150 * Wait for completion. Save the status code, data size,
151 * and data into the return package (if required by the protocol).
152 */
153 ret = wait_transaction_complete(hc, 1000);
154 if (ret || !(protocol & 0x01))
155 goto end;
156 switch (protocol) {
157 case SMBUS_RECEIVE_BYTE:
158 case SMBUS_READ_BYTE:
159 sz = 1;
160 break;
161 case SMBUS_READ_WORD:
162 sz = 2;
163 break;
164 case SMBUS_READ_BLOCK:
165 if (smb_hc_read(hc, ACPI_SMB_BLOCK_COUNT, &sz)) {
166 ret = -EFAULT;
167 goto end;
168 }
169 sz &= 0x1f;
170 break;
171 }
172 for (i = 0; i < sz; ++i)
173 smb_hc_read(hc, ACPI_SMB_DATA + i, &data[i]);
174 end:
175 mutex_unlock(&hc->lock);
176 return ret;
177}
178
179int acpi_smbus_read(struct acpi_smb_hc *hc, u8 protocol, u8 address,
180 u8 command, u8 *data)
181{
182 return acpi_smbus_transaction(hc, protocol, address, command, data, 0);
183}
184
185EXPORT_SYMBOL_GPL(acpi_smbus_read);
186
187int acpi_smbus_write(struct acpi_smb_hc *hc, u8 protocol, u8 address,
188 u8 command, u8 *data, u8 length)
189{
190 return acpi_smbus_transaction(hc, protocol, address, command, data, length);
191}
192
193EXPORT_SYMBOL_GPL(acpi_smbus_write);
194
195int acpi_smbus_register_callback(struct acpi_smb_hc *hc,
196 smbus_alarm_callback callback, void *context)
197{
198 mutex_lock(&hc->lock);
199 hc->callback = callback;
200 hc->context = context;
201 mutex_unlock(&hc->lock);
202 return 0;
203}
204
205EXPORT_SYMBOL_GPL(acpi_smbus_register_callback);
206
207int acpi_smbus_unregister_callback(struct acpi_smb_hc *hc)
208{
209 mutex_lock(&hc->lock);
210 hc->callback = NULL;
211 hc->context = NULL;
212 mutex_unlock(&hc->lock);
213 return 0;
214}
215
216EXPORT_SYMBOL_GPL(acpi_smbus_unregister_callback);
217
218static inline void acpi_smbus_callback(void *context)
219{
220 struct acpi_smb_hc *hc = context;
221 if (hc->callback)
222 hc->callback(hc->context);
223}
224
225static int smbus_alarm(void *context)
226{
227 struct acpi_smb_hc *hc = context;
228 union acpi_smb_status status;
229 u8 address;
230 if (smb_hc_read(hc, ACPI_SMB_STATUS, &status.raw))
231 return 0;
232 /* Check if it is only a completion notify */
233 if (status.fields.done)
234 wake_up(&hc->wait);
235 if (!status.fields.alarm)
236 return 0;
237 mutex_lock(&hc->lock);
238 smb_hc_read(hc, ACPI_SMB_ALARM_ADDRESS, &address);
239 status.fields.alarm = 0;
240 smb_hc_write(hc, ACPI_SMB_STATUS, status.raw);
241 /* We are only interested in events coming from known devices */
242 switch (address >> 1) {
243 case ACPI_SBS_CHARGER:
244 case ACPI_SBS_MANAGER:
245 case ACPI_SBS_BATTERY:
246 acpi_os_execute(OSL_NOTIFY_HANDLER,
247 acpi_smbus_callback, hc);
248 default:;
249 }
250 mutex_unlock(&hc->lock);
251 return 0;
252}
253
254typedef int (*acpi_ec_query_func) (void *data);
255
256extern int acpi_ec_add_query_handler(struct acpi_ec *ec, u8 query_bit,
257 acpi_handle handle, acpi_ec_query_func func,
258 void *data);
259
260static int acpi_smbus_hc_add(struct acpi_device *device)
261{
262 int status;
263 unsigned long long val;
264 struct acpi_smb_hc *hc;
265
266 if (!device)
267 return -EINVAL;
268
269 status = acpi_evaluate_integer(device->handle, "_EC", NULL, &val);
270 if (ACPI_FAILURE(status)) {
271 printk(KERN_ERR PREFIX "error obtaining _EC.\n");
272 return -EIO;
273 }
274
275 strcpy(acpi_device_name(device), ACPI_SMB_HC_DEVICE_NAME);
276 strcpy(acpi_device_class(device), ACPI_SMB_HC_CLASS);
277
278 hc = kzalloc(sizeof(struct acpi_smb_hc), GFP_KERNEL);
279 if (!hc)
280 return -ENOMEM;
281 mutex_init(&hc->lock);
282 init_waitqueue_head(&hc->wait);
283
284 hc->ec = acpi_driver_data(device->parent);
285 hc->offset = (val >> 8) & 0xff;
286 hc->query_bit = val & 0xff;
287 device->driver_data = hc;
288
289 acpi_ec_add_query_handler(hc->ec, hc->query_bit, NULL, smbus_alarm, hc);
290 printk(KERN_INFO PREFIX "SBS HC: EC = 0x%p, offset = 0x%0x, query_bit = 0x%0x\n",
291 hc->ec, hc->offset, hc->query_bit);
292
293 return 0;
294}
295
296extern void acpi_ec_remove_query_handler(struct acpi_ec *ec, u8 query_bit);
297
298static int acpi_smbus_hc_remove(struct acpi_device *device, int type)
299{
300 struct acpi_smb_hc *hc;
301
302 if (!device)
303 return -EINVAL;
304
305 hc = acpi_driver_data(device);
306 acpi_ec_remove_query_handler(hc->ec, hc->query_bit);
307 kfree(hc);
308 device->driver_data = NULL;
309 return 0;
310}
311
312static int __init acpi_smb_hc_init(void)
313{
314 int result;
315
316 result = acpi_bus_register_driver(&acpi_smb_hc_driver);
317 if (result < 0)
318 return -ENODEV;
319 return 0;
320}
321
322static void __exit acpi_smb_hc_exit(void)
323{
324 acpi_bus_unregister_driver(&acpi_smb_hc_driver);
325}
326
327module_init(acpi_smb_hc_init);
328module_exit(acpi_smb_hc_exit);
329
330MODULE_LICENSE("GPL");
331MODULE_AUTHOR("Alexey Starikovskiy");
332MODULE_DESCRIPTION("ACPI SMBus HC driver");
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * SMBus driver for ACPI Embedded Controller (v0.1)
4 *
5 * Copyright (c) 2007 Alexey Starikovskiy
6 */
7
8#define pr_fmt(fmt) "ACPI: " fmt
9
10#include <linux/acpi.h>
11#include <linux/wait.h>
12#include <linux/slab.h>
13#include <linux/delay.h>
14#include <linux/module.h>
15#include <linux/interrupt.h>
16#include "sbshc.h"
17#include "internal.h"
18
19#define ACPI_SMB_HC_CLASS "smbus_host_ctl"
20#define ACPI_SMB_HC_DEVICE_NAME "ACPI SMBus HC"
21
22struct acpi_smb_hc {
23 struct acpi_ec *ec;
24 struct mutex lock;
25 wait_queue_head_t wait;
26 u8 offset;
27 u8 query_bit;
28 smbus_alarm_callback callback;
29 void *context;
30 bool done;
31};
32
33static int acpi_smbus_hc_add(struct acpi_device *device);
34static void acpi_smbus_hc_remove(struct acpi_device *device);
35
36static const struct acpi_device_id sbs_device_ids[] = {
37 {"ACPI0001", 0},
38 {"ACPI0005", 0},
39 {"", 0},
40};
41
42MODULE_DEVICE_TABLE(acpi, sbs_device_ids);
43
44static struct acpi_driver acpi_smb_hc_driver = {
45 .name = "smbus_hc",
46 .class = ACPI_SMB_HC_CLASS,
47 .ids = sbs_device_ids,
48 .ops = {
49 .add = acpi_smbus_hc_add,
50 .remove = acpi_smbus_hc_remove,
51 },
52};
53
54union acpi_smb_status {
55 u8 raw;
56 struct {
57 u8 status:5;
58 u8 reserved:1;
59 u8 alarm:1;
60 u8 done:1;
61 } fields;
62};
63
64enum acpi_smb_status_codes {
65 SMBUS_OK = 0,
66 SMBUS_UNKNOWN_FAILURE = 0x07,
67 SMBUS_DEVICE_ADDRESS_NACK = 0x10,
68 SMBUS_DEVICE_ERROR = 0x11,
69 SMBUS_DEVICE_COMMAND_ACCESS_DENIED = 0x12,
70 SMBUS_UNKNOWN_ERROR = 0x13,
71 SMBUS_DEVICE_ACCESS_DENIED = 0x17,
72 SMBUS_TIMEOUT = 0x18,
73 SMBUS_HOST_UNSUPPORTED_PROTOCOL = 0x19,
74 SMBUS_BUSY = 0x1a,
75 SMBUS_PEC_ERROR = 0x1f,
76};
77
78enum acpi_smb_offset {
79 ACPI_SMB_PROTOCOL = 0, /* protocol, PEC */
80 ACPI_SMB_STATUS = 1, /* status */
81 ACPI_SMB_ADDRESS = 2, /* address */
82 ACPI_SMB_COMMAND = 3, /* command */
83 ACPI_SMB_DATA = 4, /* 32 data registers */
84 ACPI_SMB_BLOCK_COUNT = 0x24, /* number of data bytes */
85 ACPI_SMB_ALARM_ADDRESS = 0x25, /* alarm address */
86 ACPI_SMB_ALARM_DATA = 0x26, /* 2 bytes alarm data */
87};
88
89static inline int smb_hc_read(struct acpi_smb_hc *hc, u8 address, u8 *data)
90{
91 return ec_read(hc->offset + address, data);
92}
93
94static inline int smb_hc_write(struct acpi_smb_hc *hc, u8 address, u8 data)
95{
96 return ec_write(hc->offset + address, data);
97}
98
99static int wait_transaction_complete(struct acpi_smb_hc *hc, int timeout)
100{
101 if (wait_event_timeout(hc->wait, hc->done, msecs_to_jiffies(timeout)))
102 return 0;
103 return -ETIME;
104}
105
106static int acpi_smbus_transaction(struct acpi_smb_hc *hc, u8 protocol,
107 u8 address, u8 command, u8 *data, u8 length)
108{
109 int ret = -EFAULT, i;
110 u8 temp, sz = 0;
111
112 if (!hc) {
113 pr_err("host controller is not configured\n");
114 return ret;
115 }
116
117 mutex_lock(&hc->lock);
118 hc->done = false;
119 if (smb_hc_read(hc, ACPI_SMB_PROTOCOL, &temp))
120 goto end;
121 if (temp) {
122 ret = -EBUSY;
123 goto end;
124 }
125 smb_hc_write(hc, ACPI_SMB_COMMAND, command);
126 if (!(protocol & 0x01)) {
127 smb_hc_write(hc, ACPI_SMB_BLOCK_COUNT, length);
128 for (i = 0; i < length; ++i)
129 smb_hc_write(hc, ACPI_SMB_DATA + i, data[i]);
130 }
131 smb_hc_write(hc, ACPI_SMB_ADDRESS, address << 1);
132 smb_hc_write(hc, ACPI_SMB_PROTOCOL, protocol);
133 /*
134 * Wait for completion. Save the status code, data size,
135 * and data into the return package (if required by the protocol).
136 */
137 ret = wait_transaction_complete(hc, 1000);
138 if (ret || !(protocol & 0x01))
139 goto end;
140 switch (protocol) {
141 case SMBUS_RECEIVE_BYTE:
142 case SMBUS_READ_BYTE:
143 sz = 1;
144 break;
145 case SMBUS_READ_WORD:
146 sz = 2;
147 break;
148 case SMBUS_READ_BLOCK:
149 if (smb_hc_read(hc, ACPI_SMB_BLOCK_COUNT, &sz)) {
150 ret = -EFAULT;
151 goto end;
152 }
153 sz &= 0x1f;
154 break;
155 }
156 for (i = 0; i < sz; ++i)
157 smb_hc_read(hc, ACPI_SMB_DATA + i, &data[i]);
158 end:
159 mutex_unlock(&hc->lock);
160 return ret;
161}
162
163int acpi_smbus_read(struct acpi_smb_hc *hc, u8 protocol, u8 address,
164 u8 command, u8 *data)
165{
166 return acpi_smbus_transaction(hc, protocol, address, command, data, 0);
167}
168
169EXPORT_SYMBOL_GPL(acpi_smbus_read);
170
171int acpi_smbus_write(struct acpi_smb_hc *hc, u8 protocol, u8 address,
172 u8 command, u8 *data, u8 length)
173{
174 return acpi_smbus_transaction(hc, protocol, address, command, data, length);
175}
176
177EXPORT_SYMBOL_GPL(acpi_smbus_write);
178
179int acpi_smbus_register_callback(struct acpi_smb_hc *hc,
180 smbus_alarm_callback callback, void *context)
181{
182 mutex_lock(&hc->lock);
183 hc->callback = callback;
184 hc->context = context;
185 mutex_unlock(&hc->lock);
186 return 0;
187}
188
189EXPORT_SYMBOL_GPL(acpi_smbus_register_callback);
190
191int acpi_smbus_unregister_callback(struct acpi_smb_hc *hc)
192{
193 mutex_lock(&hc->lock);
194 hc->callback = NULL;
195 hc->context = NULL;
196 mutex_unlock(&hc->lock);
197 acpi_os_wait_events_complete();
198 return 0;
199}
200
201EXPORT_SYMBOL_GPL(acpi_smbus_unregister_callback);
202
203static inline void acpi_smbus_callback(void *context)
204{
205 struct acpi_smb_hc *hc = context;
206 if (hc->callback)
207 hc->callback(hc->context);
208}
209
210static int smbus_alarm(void *context)
211{
212 struct acpi_smb_hc *hc = context;
213 union acpi_smb_status status;
214 u8 address;
215 if (smb_hc_read(hc, ACPI_SMB_STATUS, &status.raw))
216 return 0;
217 /* Check if it is only a completion notify */
218 if (status.fields.done && status.fields.status == SMBUS_OK) {
219 hc->done = true;
220 wake_up(&hc->wait);
221 }
222 if (!status.fields.alarm)
223 return 0;
224 mutex_lock(&hc->lock);
225 smb_hc_read(hc, ACPI_SMB_ALARM_ADDRESS, &address);
226 status.fields.alarm = 0;
227 smb_hc_write(hc, ACPI_SMB_STATUS, status.raw);
228 /* We are only interested in events coming from known devices */
229 switch (address >> 1) {
230 case ACPI_SBS_CHARGER:
231 case ACPI_SBS_MANAGER:
232 case ACPI_SBS_BATTERY:
233 acpi_os_execute(OSL_NOTIFY_HANDLER,
234 acpi_smbus_callback, hc);
235 }
236 mutex_unlock(&hc->lock);
237 return 0;
238}
239
240static int acpi_smbus_hc_add(struct acpi_device *device)
241{
242 int status;
243 unsigned long long val;
244 struct acpi_smb_hc *hc;
245
246 if (!device)
247 return -EINVAL;
248
249 status = acpi_evaluate_integer(device->handle, "_EC", NULL, &val);
250 if (ACPI_FAILURE(status)) {
251 pr_err("error obtaining _EC.\n");
252 return -EIO;
253 }
254
255 strscpy(acpi_device_name(device), ACPI_SMB_HC_DEVICE_NAME);
256 strscpy(acpi_device_class(device), ACPI_SMB_HC_CLASS);
257
258 hc = kzalloc(sizeof(struct acpi_smb_hc), GFP_KERNEL);
259 if (!hc)
260 return -ENOMEM;
261 mutex_init(&hc->lock);
262 init_waitqueue_head(&hc->wait);
263
264 hc->ec = acpi_driver_data(acpi_dev_parent(device));
265 hc->offset = (val >> 8) & 0xff;
266 hc->query_bit = val & 0xff;
267 device->driver_data = hc;
268
269 acpi_ec_add_query_handler(hc->ec, hc->query_bit, NULL, smbus_alarm, hc);
270 dev_info(&device->dev, "SBS HC: offset = 0x%0x, query_bit = 0x%0x\n",
271 hc->offset, hc->query_bit);
272
273 return 0;
274}
275
276static void acpi_smbus_hc_remove(struct acpi_device *device)
277{
278 struct acpi_smb_hc *hc;
279
280 if (!device)
281 return;
282
283 hc = acpi_driver_data(device);
284 acpi_ec_remove_query_handler(hc->ec, hc->query_bit);
285 acpi_os_wait_events_complete();
286 kfree(hc);
287 device->driver_data = NULL;
288}
289
290module_acpi_driver(acpi_smb_hc_driver);
291
292MODULE_LICENSE("GPL");
293MODULE_AUTHOR("Alexey Starikovskiy");
294MODULE_DESCRIPTION("ACPI SMBus HC driver");