PM / devfreq: exynos-ppmu: Add the support of PPMUv2 for Exynos5433
[deliverable/linux.git] / drivers / i2c / i2c-core.c
CommitLineData
1da177e4
LT
1/* i2c-core.c - a device driver for the iic-bus interface */
2/* ------------------------------------------------------------------------- */
3/* Copyright (C) 1995-99 Simon G. Vogl
4
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
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
ca1f8da9 13 GNU General Public License for more details. */
1da177e4
LT
14/* ------------------------------------------------------------------------- */
15
96de0e25 16/* With some changes from Kyösti Mälkki <kmalkki@cc.hut.fi>.
1da177e4 17 All SMBus-related things are written by Frodo Looijaard <frodol@dds.nl>
421ef47b 18 SMBus 2.0 support by Mark Studebaker <mdsxyz123@yahoo.com> and
7c81c60f 19 Jean Delvare <jdelvare@suse.de>
0826374b 20 Mux support by Rodolfo Giometti <giometti@enneenne.com> and
687b81d0
WS
21 Michael Lawnick <michael.lawnick.ext@nsn.com>
22 OF support is copyright (c) 2008 Jochen Friedrich <jochen@scram.de>
23 (based on a previous patch from Jon Smirl <jonsmirl@gmail.com>) and
24 (c) 2013 Wolfram Sang <wsa@the-dreams.de>
17f4a5c4
WS
25 I2C ACPI code Copyright (C) 2014 Intel Corp
26 Author: Lan Tianyu <tianyu.lan@intel.com>
4b1acc43 27 I2C slave support (c) 2014 by Wolfram Sang <wsa@sang-engineering.com>
687b81d0 28 */
1da177e4 29
1da177e4
LT
30#include <linux/module.h>
31#include <linux/kernel.h>
5f9296ba 32#include <linux/delay.h>
1da177e4 33#include <linux/errno.h>
5f9296ba 34#include <linux/gpio.h>
1da177e4
LT
35#include <linux/slab.h>
36#include <linux/i2c.h>
37#include <linux/init.h>
38#include <linux/idr.h>
b3585e4f 39#include <linux/mutex.h>
687b81d0 40#include <linux/of.h>
959e85f7 41#include <linux/of_device.h>
687b81d0 42#include <linux/of_irq.h>
86be408b 43#include <linux/clk/clk-conf.h>
b8d6f45b 44#include <linux/completion.h>
cea443a8
MR
45#include <linux/hardirq.h>
46#include <linux/irqflags.h>
f18c41da 47#include <linux/rwsem.h>
6de468ae 48#include <linux/pm_runtime.h>
f48c767c 49#include <linux/pm_domain.h>
907ddf89 50#include <linux/acpi.h>
d9a83d62 51#include <linux/jump_label.h>
1da177e4 52#include <asm/uaccess.h>
a430a345 53#include <linux/err.h>
1da177e4 54
9c1600ed
DB
55#include "i2c-core.h"
56
d9a83d62
DH
57#define CREATE_TRACE_POINTS
58#include <trace/events/i2c.h>
1da177e4 59
6629dcff 60/* core_lock protects i2c_adapter_idr, and guarantees
35fc37f8 61 that device detection, deletion of detected devices, and attach_adapter
19baba4c 62 calls are serialized */
caada32a 63static DEFINE_MUTEX(core_lock);
1da177e4
LT
64static DEFINE_IDR(i2c_adapter_idr);
65
4f8cf824 66static struct device_type i2c_client_type;
4735c98f 67static int i2c_detect(struct i2c_adapter *adapter, struct i2c_driver *driver);
f37dd80a 68
d9a83d62
DH
69static struct static_key i2c_trace_msg = STATIC_KEY_INIT_FALSE;
70
71void i2c_transfer_trace_reg(void)
72{
73 static_key_slow_inc(&i2c_trace_msg);
74}
75
76void i2c_transfer_trace_unreg(void)
77{
78 static_key_slow_dec(&i2c_trace_msg);
79}
80
17f4a5c4
WS
81#if defined(CONFIG_ACPI)
82struct acpi_i2c_handler_data {
83 struct acpi_connection_info info;
84 struct i2c_adapter *adapter;
85};
86
87struct gsb_buffer {
88 u8 status;
89 u8 len;
90 union {
91 u16 wdata;
92 u8 bdata;
93 u8 data[0];
94 };
95} __packed;
96
97static int acpi_i2c_add_resource(struct acpi_resource *ares, void *data)
98{
99 struct i2c_board_info *info = data;
100
101 if (ares->type == ACPI_RESOURCE_TYPE_SERIAL_BUS) {
102 struct acpi_resource_i2c_serialbus *sb;
103
104 sb = &ares->data.i2c_serial_bus;
393cc1ce 105 if (!info->addr && sb->type == ACPI_RESOURCE_SERIAL_TYPE_I2C) {
17f4a5c4
WS
106 info->addr = sb->slave_address;
107 if (sb->access_mode == ACPI_I2C_10BIT_MODE)
108 info->flags |= I2C_CLIENT_TEN;
109 }
dab472eb 110 } else if (!info->irq) {
17f4a5c4
WS
111 struct resource r;
112
113 if (acpi_dev_resource_interrupt(ares, 0, &r))
114 info->irq = r.start;
115 }
116
117 /* Tell the ACPI core to skip this resource */
118 return 1;
119}
120
121static acpi_status acpi_i2c_add_device(acpi_handle handle, u32 level,
122 void *data, void **return_value)
123{
124 struct i2c_adapter *adapter = data;
125 struct list_head resource_list;
126 struct i2c_board_info info;
127 struct acpi_device *adev;
128 int ret;
129
130 if (acpi_bus_get_device(handle, &adev))
131 return AE_OK;
132 if (acpi_bus_get_status(adev) || !adev->status.present)
133 return AE_OK;
134
135 memset(&info, 0, sizeof(info));
ce793486 136 info.fwnode = acpi_fwnode_handle(adev);
17f4a5c4
WS
137
138 INIT_LIST_HEAD(&resource_list);
139 ret = acpi_dev_get_resources(adev, &resource_list,
140 acpi_i2c_add_resource, &info);
141 acpi_dev_free_resource_list(&resource_list);
142
143 if (ret < 0 || !info.addr)
144 return AE_OK;
145
146 adev->power.flags.ignore_parent = true;
147 strlcpy(info.type, dev_name(&adev->dev), sizeof(info.type));
148 if (!i2c_new_device(adapter, &info)) {
149 adev->power.flags.ignore_parent = false;
150 dev_err(&adapter->dev,
151 "failed to add I2C device %s from ACPI\n",
152 dev_name(&adev->dev));
153 }
154
155 return AE_OK;
156}
157
158/**
159 * acpi_i2c_register_devices - enumerate I2C slave devices behind adapter
160 * @adap: pointer to adapter
161 *
162 * Enumerate all I2C slave devices behind this adapter by walking the ACPI
163 * namespace. When a device is found it will be added to the Linux device
164 * model and bound to the corresponding ACPI handle.
165 */
166static void acpi_i2c_register_devices(struct i2c_adapter *adap)
167{
168 acpi_handle handle;
169 acpi_status status;
170
171 if (!adap->dev.parent)
172 return;
173
174 handle = ACPI_HANDLE(adap->dev.parent);
175 if (!handle)
176 return;
177
178 status = acpi_walk_namespace(ACPI_TYPE_DEVICE, handle, 1,
179 acpi_i2c_add_device, NULL,
180 adap, NULL);
181 if (ACPI_FAILURE(status))
182 dev_warn(&adap->dev, "failed to enumerate I2C slaves\n");
183}
184
185#else /* CONFIG_ACPI */
186static inline void acpi_i2c_register_devices(struct i2c_adapter *adap) { }
187#endif /* CONFIG_ACPI */
188
189#ifdef CONFIG_ACPI_I2C_OPREGION
190static int acpi_gsb_i2c_read_bytes(struct i2c_client *client,
191 u8 cmd, u8 *data, u8 data_len)
192{
193
194 struct i2c_msg msgs[2];
195 int ret;
196 u8 *buffer;
197
198 buffer = kzalloc(data_len, GFP_KERNEL);
199 if (!buffer)
200 return AE_NO_MEMORY;
201
202 msgs[0].addr = client->addr;
203 msgs[0].flags = client->flags;
204 msgs[0].len = 1;
205 msgs[0].buf = &cmd;
206
207 msgs[1].addr = client->addr;
208 msgs[1].flags = client->flags | I2C_M_RD;
209 msgs[1].len = data_len;
210 msgs[1].buf = buffer;
211
212 ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
213 if (ret < 0)
214 dev_err(&client->adapter->dev, "i2c read failed\n");
215 else
216 memcpy(data, buffer, data_len);
217
218 kfree(buffer);
219 return ret;
220}
221
222static int acpi_gsb_i2c_write_bytes(struct i2c_client *client,
223 u8 cmd, u8 *data, u8 data_len)
224{
225
226 struct i2c_msg msgs[1];
227 u8 *buffer;
228 int ret = AE_OK;
229
230 buffer = kzalloc(data_len + 1, GFP_KERNEL);
231 if (!buffer)
232 return AE_NO_MEMORY;
233
234 buffer[0] = cmd;
235 memcpy(buffer + 1, data, data_len);
236
237 msgs[0].addr = client->addr;
238 msgs[0].flags = client->flags;
239 msgs[0].len = data_len + 1;
240 msgs[0].buf = buffer;
241
242 ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
243 if (ret < 0)
244 dev_err(&client->adapter->dev, "i2c write failed\n");
245
246 kfree(buffer);
247 return ret;
248}
249
250static acpi_status
251acpi_i2c_space_handler(u32 function, acpi_physical_address command,
252 u32 bits, u64 *value64,
253 void *handler_context, void *region_context)
254{
255 struct gsb_buffer *gsb = (struct gsb_buffer *)value64;
256 struct acpi_i2c_handler_data *data = handler_context;
257 struct acpi_connection_info *info = &data->info;
258 struct acpi_resource_i2c_serialbus *sb;
259 struct i2c_adapter *adapter = data->adapter;
7ef85f5f 260 struct i2c_client *client;
17f4a5c4
WS
261 struct acpi_resource *ares;
262 u32 accessor_type = function >> 16;
263 u8 action = function & ACPI_IO_MASK;
4470c725 264 acpi_status ret;
17f4a5c4
WS
265 int status;
266
267 ret = acpi_buffer_to_resource(info->connection, info->length, &ares);
268 if (ACPI_FAILURE(ret))
269 return ret;
270
7ef85f5f
JN
271 client = kzalloc(sizeof(*client), GFP_KERNEL);
272 if (!client) {
273 ret = AE_NO_MEMORY;
274 goto err;
275 }
276
17f4a5c4
WS
277 if (!value64 || ares->type != ACPI_RESOURCE_TYPE_SERIAL_BUS) {
278 ret = AE_BAD_PARAMETER;
279 goto err;
280 }
281
282 sb = &ares->data.i2c_serial_bus;
283 if (sb->type != ACPI_RESOURCE_SERIAL_TYPE_I2C) {
284 ret = AE_BAD_PARAMETER;
285 goto err;
286 }
287
7ef85f5f
JN
288 client->adapter = adapter;
289 client->addr = sb->slave_address;
17f4a5c4
WS
290
291 if (sb->access_mode == ACPI_I2C_10BIT_MODE)
7ef85f5f 292 client->flags |= I2C_CLIENT_TEN;
17f4a5c4
WS
293
294 switch (accessor_type) {
295 case ACPI_GSB_ACCESS_ATTRIB_SEND_RCV:
296 if (action == ACPI_READ) {
7ef85f5f 297 status = i2c_smbus_read_byte(client);
17f4a5c4
WS
298 if (status >= 0) {
299 gsb->bdata = status;
300 status = 0;
301 }
302 } else {
7ef85f5f 303 status = i2c_smbus_write_byte(client, gsb->bdata);
17f4a5c4
WS
304 }
305 break;
306
307 case ACPI_GSB_ACCESS_ATTRIB_BYTE:
308 if (action == ACPI_READ) {
7ef85f5f 309 status = i2c_smbus_read_byte_data(client, command);
17f4a5c4
WS
310 if (status >= 0) {
311 gsb->bdata = status;
312 status = 0;
313 }
314 } else {
7ef85f5f 315 status = i2c_smbus_write_byte_data(client, command,
17f4a5c4
WS
316 gsb->bdata);
317 }
318 break;
319
320 case ACPI_GSB_ACCESS_ATTRIB_WORD:
321 if (action == ACPI_READ) {
7ef85f5f 322 status = i2c_smbus_read_word_data(client, command);
17f4a5c4
WS
323 if (status >= 0) {
324 gsb->wdata = status;
325 status = 0;
326 }
327 } else {
7ef85f5f 328 status = i2c_smbus_write_word_data(client, command,
17f4a5c4
WS
329 gsb->wdata);
330 }
331 break;
332
333 case ACPI_GSB_ACCESS_ATTRIB_BLOCK:
334 if (action == ACPI_READ) {
7ef85f5f 335 status = i2c_smbus_read_block_data(client, command,
17f4a5c4
WS
336 gsb->data);
337 if (status >= 0) {
338 gsb->len = status;
339 status = 0;
340 }
341 } else {
7ef85f5f 342 status = i2c_smbus_write_block_data(client, command,
17f4a5c4
WS
343 gsb->len, gsb->data);
344 }
345 break;
346
347 case ACPI_GSB_ACCESS_ATTRIB_MULTIBYTE:
348 if (action == ACPI_READ) {
7ef85f5f 349 status = acpi_gsb_i2c_read_bytes(client, command,
17f4a5c4
WS
350 gsb->data, info->access_length);
351 if (status > 0)
352 status = 0;
353 } else {
7ef85f5f 354 status = acpi_gsb_i2c_write_bytes(client, command,
17f4a5c4
WS
355 gsb->data, info->access_length);
356 }
357 break;
358
359 default:
360 pr_info("protocol(0x%02x) is not supported.\n", accessor_type);
361 ret = AE_BAD_PARAMETER;
362 goto err;
363 }
364
365 gsb->status = status;
366
367 err:
7ef85f5f 368 kfree(client);
17f4a5c4
WS
369 ACPI_FREE(ares);
370 return ret;
371}
372
373
374static int acpi_i2c_install_space_handler(struct i2c_adapter *adapter)
375{
0aef44e8 376 acpi_handle handle;
17f4a5c4
WS
377 struct acpi_i2c_handler_data *data;
378 acpi_status status;
379
0aef44e8
PH
380 if (!adapter->dev.parent)
381 return -ENODEV;
382
383 handle = ACPI_HANDLE(adapter->dev.parent);
384
17f4a5c4
WS
385 if (!handle)
386 return -ENODEV;
387
388 data = kzalloc(sizeof(struct acpi_i2c_handler_data),
389 GFP_KERNEL);
390 if (!data)
391 return -ENOMEM;
392
393 data->adapter = adapter;
394 status = acpi_bus_attach_private_data(handle, (void *)data);
395 if (ACPI_FAILURE(status)) {
396 kfree(data);
397 return -ENOMEM;
398 }
399
400 status = acpi_install_address_space_handler(handle,
401 ACPI_ADR_SPACE_GSBUS,
402 &acpi_i2c_space_handler,
403 NULL,
404 data);
405 if (ACPI_FAILURE(status)) {
406 dev_err(&adapter->dev, "Error installing i2c space handler\n");
407 acpi_bus_detach_private_data(handle);
408 kfree(data);
409 return -ENOMEM;
410 }
411
40e7fcb1 412 acpi_walk_dep_device_list(handle);
17f4a5c4
WS
413 return 0;
414}
415
416static void acpi_i2c_remove_space_handler(struct i2c_adapter *adapter)
417{
0aef44e8 418 acpi_handle handle;
17f4a5c4
WS
419 struct acpi_i2c_handler_data *data;
420 acpi_status status;
421
0aef44e8
PH
422 if (!adapter->dev.parent)
423 return;
424
425 handle = ACPI_HANDLE(adapter->dev.parent);
426
17f4a5c4
WS
427 if (!handle)
428 return;
429
430 acpi_remove_address_space_handler(handle,
431 ACPI_ADR_SPACE_GSBUS,
432 &acpi_i2c_space_handler);
433
434 status = acpi_bus_get_private_data(handle, (void **)&data);
435 if (ACPI_SUCCESS(status))
436 kfree(data);
437
438 acpi_bus_detach_private_data(handle);
439}
440#else /* CONFIG_ACPI_I2C_OPREGION */
441static inline void acpi_i2c_remove_space_handler(struct i2c_adapter *adapter)
442{ }
443
444static inline int acpi_i2c_install_space_handler(struct i2c_adapter *adapter)
445{ return 0; }
446#endif /* CONFIG_ACPI_I2C_OPREGION */
447
f37dd80a
DB
448/* ------------------------------------------------------------------------- */
449
d2653e92
JD
450static const struct i2c_device_id *i2c_match_id(const struct i2c_device_id *id,
451 const struct i2c_client *client)
452{
453 while (id->name[0]) {
454 if (strcmp(client->name, id->name) == 0)
455 return id;
456 id++;
457 }
458 return NULL;
459}
460
1da177e4
LT
461static int i2c_device_match(struct device *dev, struct device_driver *drv)
462{
51298d12
JD
463 struct i2c_client *client = i2c_verify_client(dev);
464 struct i2c_driver *driver;
465
466 if (!client)
467 return 0;
7b4fbc50 468
959e85f7
GL
469 /* Attempt an OF style match */
470 if (of_driver_match_device(dev, drv))
471 return 1;
472
907ddf89
MW
473 /* Then ACPI style match */
474 if (acpi_driver_match_device(dev, drv))
475 return 1;
476
51298d12 477 driver = to_i2c_driver(drv);
d2653e92
JD
478 /* match on an id table if there is one */
479 if (driver->id_table)
480 return i2c_match_id(driver->id_table, client) != NULL;
481
eb8a7908 482 return 0;
1da177e4
LT
483}
484
7b4fbc50
DB
485
486/* uevent helps with hotplug: modprobe -q $(MODALIAS) */
7eff2e7a 487static int i2c_device_uevent(struct device *dev, struct kobj_uevent_env *env)
7b4fbc50
DB
488{
489 struct i2c_client *client = to_i2c_client(dev);
8c4ff6d0
ZR
490 int rc;
491
492 rc = acpi_device_uevent_modalias(dev, env);
493 if (rc != -ENODEV)
494 return rc;
7b4fbc50 495
eb8a7908
JD
496 if (add_uevent_var(env, "MODALIAS=%s%s",
497 I2C_MODULE_PREFIX, client->name))
498 return -ENOMEM;
7b4fbc50
DB
499 dev_dbg(dev, "uevent\n");
500 return 0;
501}
502
5f9296ba
VK
503/* i2c bus recovery routines */
504static int get_scl_gpio_value(struct i2c_adapter *adap)
505{
506 return gpio_get_value(adap->bus_recovery_info->scl_gpio);
507}
508
509static void set_scl_gpio_value(struct i2c_adapter *adap, int val)
510{
511 gpio_set_value(adap->bus_recovery_info->scl_gpio, val);
512}
513
514static int get_sda_gpio_value(struct i2c_adapter *adap)
515{
516 return gpio_get_value(adap->bus_recovery_info->sda_gpio);
517}
518
519static int i2c_get_gpios_for_recovery(struct i2c_adapter *adap)
520{
521 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
522 struct device *dev = &adap->dev;
523 int ret = 0;
524
525 ret = gpio_request_one(bri->scl_gpio, GPIOF_OPEN_DRAIN |
526 GPIOF_OUT_INIT_HIGH, "i2c-scl");
527 if (ret) {
528 dev_warn(dev, "Can't get SCL gpio: %d\n", bri->scl_gpio);
529 return ret;
530 }
531
532 if (bri->get_sda) {
533 if (gpio_request_one(bri->sda_gpio, GPIOF_IN, "i2c-sda")) {
534 /* work without SDA polling */
535 dev_warn(dev, "Can't get SDA gpio: %d. Not using SDA polling\n",
536 bri->sda_gpio);
537 bri->get_sda = NULL;
538 }
539 }
540
541 return ret;
542}
543
544static void i2c_put_gpios_for_recovery(struct i2c_adapter *adap)
545{
546 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
547
548 if (bri->get_sda)
549 gpio_free(bri->sda_gpio);
550
551 gpio_free(bri->scl_gpio);
552}
553
554/*
555 * We are generating clock pulses. ndelay() determines durating of clk pulses.
556 * We will generate clock with rate 100 KHz and so duration of both clock levels
557 * is: delay in ns = (10^6 / 100) / 2
558 */
559#define RECOVERY_NDELAY 5000
560#define RECOVERY_CLK_CNT 9
561
562static int i2c_generic_recovery(struct i2c_adapter *adap)
563{
564 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
565 int i = 0, val = 1, ret = 0;
566
567 if (bri->prepare_recovery)
2b2190a3 568 bri->prepare_recovery(adap);
5f9296ba
VK
569
570 /*
571 * By this time SCL is high, as we need to give 9 falling-rising edges
572 */
573 while (i++ < RECOVERY_CLK_CNT * 2) {
574 if (val) {
575 /* Break if SDA is high */
576 if (bri->get_sda && bri->get_sda(adap))
577 break;
578 /* SCL shouldn't be low here */
579 if (!bri->get_scl(adap)) {
580 dev_err(&adap->dev,
581 "SCL is stuck low, exit recovery\n");
582 ret = -EBUSY;
583 break;
584 }
585 }
586
587 val = !val;
588 bri->set_scl(adap, val);
589 ndelay(RECOVERY_NDELAY);
590 }
591
592 if (bri->unprepare_recovery)
2b2190a3 593 bri->unprepare_recovery(adap);
5f9296ba
VK
594
595 return ret;
596}
597
598int i2c_generic_scl_recovery(struct i2c_adapter *adap)
599{
600 adap->bus_recovery_info->set_scl(adap, 1);
601 return i2c_generic_recovery(adap);
602}
c1c21f4e 603EXPORT_SYMBOL_GPL(i2c_generic_scl_recovery);
5f9296ba
VK
604
605int i2c_generic_gpio_recovery(struct i2c_adapter *adap)
606{
607 int ret;
608
609 ret = i2c_get_gpios_for_recovery(adap);
610 if (ret)
611 return ret;
612
613 ret = i2c_generic_recovery(adap);
614 i2c_put_gpios_for_recovery(adap);
615
616 return ret;
617}
c1c21f4e 618EXPORT_SYMBOL_GPL(i2c_generic_gpio_recovery);
5f9296ba
VK
619
620int i2c_recover_bus(struct i2c_adapter *adap)
621{
622 if (!adap->bus_recovery_info)
623 return -EOPNOTSUPP;
624
625 dev_dbg(&adap->dev, "Trying i2c bus recovery\n");
626 return adap->bus_recovery_info->recover_bus(adap);
627}
c1c21f4e 628EXPORT_SYMBOL_GPL(i2c_recover_bus);
5f9296ba 629
f37dd80a 630static int i2c_device_probe(struct device *dev)
1da177e4 631{
51298d12
JD
632 struct i2c_client *client = i2c_verify_client(dev);
633 struct i2c_driver *driver;
50c3304a 634 int status;
7b4fbc50 635
51298d12
JD
636 if (!client)
637 return 0;
638
845c8770
MW
639 if (!client->irq) {
640 int irq = -ENOENT;
641
642 if (dev->of_node)
643 irq = of_irq_get(dev->of_node, 0);
644 else if (ACPI_COMPANION(dev))
645 irq = acpi_dev_gpio_irq_get(ACPI_COMPANION(dev), 0);
2fd36c55 646
6f34be74 647 if (irq == -EPROBE_DEFER)
2fd36c55 648 return irq;
6f34be74
GU
649 if (irq < 0)
650 irq = 0;
2fd36c55
LP
651
652 client->irq = irq;
653 }
654
51298d12 655 driver = to_i2c_driver(dev->driver);
e0457442 656 if (!driver->probe || !driver->id_table)
7b4fbc50 657 return -ENODEV;
0acc2b32 658
ee35425c
MP
659 if (!device_can_wakeup(&client->dev))
660 device_init_wakeup(&client->dev,
661 client->flags & I2C_CLIENT_WAKE);
7b4fbc50 662 dev_dbg(dev, "probe\n");
d2653e92 663
86be408b
SN
664 status = of_clk_set_defaults(dev->of_node, false);
665 if (status < 0)
666 return status;
667
e09b0d4e
UH
668 status = dev_pm_domain_attach(&client->dev, true);
669 if (status != -EPROBE_DEFER) {
670 status = driver->probe(client, i2c_match_id(driver->id_table,
671 client));
672 if (status)
673 dev_pm_domain_detach(&client->dev, true);
674 }
72fa818e 675
50c3304a 676 return status;
f37dd80a 677}
1da177e4 678
f37dd80a
DB
679static int i2c_device_remove(struct device *dev)
680{
51298d12 681 struct i2c_client *client = i2c_verify_client(dev);
a1d9e6e4 682 struct i2c_driver *driver;
72fa818e 683 int status = 0;
a1d9e6e4 684
51298d12 685 if (!client || !dev->driver)
a1d9e6e4
DB
686 return 0;
687
688 driver = to_i2c_driver(dev->driver);
689 if (driver->remove) {
690 dev_dbg(dev, "remove\n");
691 status = driver->remove(client);
a1d9e6e4 692 }
72fa818e 693
e09b0d4e 694 dev_pm_domain_detach(&client->dev, true);
a1d9e6e4 695 return status;
1da177e4
LT
696}
697
f37dd80a 698static void i2c_device_shutdown(struct device *dev)
1da177e4 699{
51298d12 700 struct i2c_client *client = i2c_verify_client(dev);
f37dd80a
DB
701 struct i2c_driver *driver;
702
51298d12 703 if (!client || !dev->driver)
f37dd80a
DB
704 return;
705 driver = to_i2c_driver(dev->driver);
706 if (driver->shutdown)
51298d12 707 driver->shutdown(client);
1da177e4
LT
708}
709
9c1600ed
DB
710static void i2c_client_dev_release(struct device *dev)
711{
712 kfree(to_i2c_client(dev));
713}
714
09b8ce0a 715static ssize_t
4f8cf824 716show_name(struct device *dev, struct device_attribute *attr, char *buf)
7b4fbc50 717{
4f8cf824
JD
718 return sprintf(buf, "%s\n", dev->type == &i2c_client_type ?
719 to_i2c_client(dev)->name : to_i2c_adapter(dev)->name);
7b4fbc50 720}
a5eb71b2 721static DEVICE_ATTR(name, S_IRUGO, show_name, NULL);
7b4fbc50 722
09b8ce0a
ZX
723static ssize_t
724show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
7b4fbc50
DB
725{
726 struct i2c_client *client = to_i2c_client(dev);
8c4ff6d0
ZR
727 int len;
728
729 len = acpi_device_modalias(dev, buf, PAGE_SIZE -1);
730 if (len != -ENODEV)
731 return len;
732
eb8a7908 733 return sprintf(buf, "%s%s\n", I2C_MODULE_PREFIX, client->name);
7b4fbc50 734}
51298d12
JD
735static DEVICE_ATTR(modalias, S_IRUGO, show_modalias, NULL);
736
737static struct attribute *i2c_dev_attrs[] = {
738 &dev_attr_name.attr,
7b4fbc50 739 /* modalias helps coldplug: modprobe $(cat .../modalias) */
51298d12
JD
740 &dev_attr_modalias.attr,
741 NULL
742};
a5eb71b2 743ATTRIBUTE_GROUPS(i2c_dev);
54067ee2 744
e9ca9eb9 745struct bus_type i2c_bus_type = {
f37dd80a
DB
746 .name = "i2c",
747 .match = i2c_device_match,
748 .probe = i2c_device_probe,
749 .remove = i2c_device_remove,
750 .shutdown = i2c_device_shutdown,
b864c7d5 751};
e9ca9eb9 752EXPORT_SYMBOL_GPL(i2c_bus_type);
b864c7d5 753
51298d12 754static struct device_type i2c_client_type = {
a5eb71b2 755 .groups = i2c_dev_groups,
51298d12
JD
756 .uevent = i2c_device_uevent,
757 .release = i2c_client_dev_release,
758};
759
9b766b81
DB
760
761/**
762 * i2c_verify_client - return parameter as i2c_client, or NULL
763 * @dev: device, probably from some driver model iterator
764 *
765 * When traversing the driver model tree, perhaps using driver model
766 * iterators like @device_for_each_child(), you can't assume very much
767 * about the nodes you find. Use this function to avoid oopses caused
768 * by wrongly treating some non-I2C device as an i2c_client.
769 */
770struct i2c_client *i2c_verify_client(struct device *dev)
771{
51298d12 772 return (dev->type == &i2c_client_type)
9b766b81
DB
773 ? to_i2c_client(dev)
774 : NULL;
775}
776EXPORT_SYMBOL(i2c_verify_client);
777
778
3a89db5f 779/* This is a permissive address validity check, I2C address map constraints
25985edc 780 * are purposely not enforced, except for the general call address. */
3a89db5f
JD
781static int i2c_check_client_addr_validity(const struct i2c_client *client)
782{
783 if (client->flags & I2C_CLIENT_TEN) {
784 /* 10-bit address, all values are valid */
785 if (client->addr > 0x3ff)
786 return -EINVAL;
787 } else {
788 /* 7-bit address, reject the general call address */
789 if (client->addr == 0x00 || client->addr > 0x7f)
790 return -EINVAL;
791 }
792 return 0;
793}
794
656b8761
JD
795/* And this is a strict address validity check, used when probing. If a
796 * device uses a reserved address, then it shouldn't be probed. 7-bit
797 * addressing is assumed, 10-bit address devices are rare and should be
798 * explicitly enumerated. */
799static int i2c_check_addr_validity(unsigned short addr)
800{
801 /*
802 * Reserved addresses per I2C specification:
803 * 0x00 General call address / START byte
804 * 0x01 CBUS address
805 * 0x02 Reserved for different bus format
806 * 0x03 Reserved for future purposes
807 * 0x04-0x07 Hs-mode master code
808 * 0x78-0x7b 10-bit slave addressing
809 * 0x7c-0x7f Reserved for future purposes
810 */
811 if (addr < 0x08 || addr > 0x77)
812 return -EINVAL;
813 return 0;
814}
815
3b5f794b
JD
816static int __i2c_check_addr_busy(struct device *dev, void *addrp)
817{
818 struct i2c_client *client = i2c_verify_client(dev);
819 int addr = *(int *)addrp;
820
821 if (client && client->addr == addr)
822 return -EBUSY;
823 return 0;
824}
825
0826374b
ML
826/* walk up mux tree */
827static int i2c_check_mux_parents(struct i2c_adapter *adapter, int addr)
828{
97cc4d49 829 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
0826374b
ML
830 int result;
831
832 result = device_for_each_child(&adapter->dev, &addr,
833 __i2c_check_addr_busy);
834
97cc4d49
JD
835 if (!result && parent)
836 result = i2c_check_mux_parents(parent, addr);
0826374b
ML
837
838 return result;
839}
840
841/* recurse down mux tree */
842static int i2c_check_mux_children(struct device *dev, void *addrp)
843{
844 int result;
845
846 if (dev->type == &i2c_adapter_type)
847 result = device_for_each_child(dev, addrp,
848 i2c_check_mux_children);
849 else
850 result = __i2c_check_addr_busy(dev, addrp);
851
852 return result;
853}
854
3b5f794b
JD
855static int i2c_check_addr_busy(struct i2c_adapter *adapter, int addr)
856{
97cc4d49 857 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
0826374b
ML
858 int result = 0;
859
97cc4d49
JD
860 if (parent)
861 result = i2c_check_mux_parents(parent, addr);
0826374b
ML
862
863 if (!result)
864 result = device_for_each_child(&adapter->dev, &addr,
865 i2c_check_mux_children);
866
867 return result;
3b5f794b
JD
868}
869
fe61e07e
JD
870/**
871 * i2c_lock_adapter - Get exclusive access to an I2C bus segment
872 * @adapter: Target I2C bus segment
873 */
874void i2c_lock_adapter(struct i2c_adapter *adapter)
875{
97cc4d49
JD
876 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
877
878 if (parent)
879 i2c_lock_adapter(parent);
0826374b
ML
880 else
881 rt_mutex_lock(&adapter->bus_lock);
fe61e07e
JD
882}
883EXPORT_SYMBOL_GPL(i2c_lock_adapter);
884
885/**
886 * i2c_trylock_adapter - Try to get exclusive access to an I2C bus segment
887 * @adapter: Target I2C bus segment
888 */
889static int i2c_trylock_adapter(struct i2c_adapter *adapter)
890{
97cc4d49
JD
891 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
892
893 if (parent)
894 return i2c_trylock_adapter(parent);
0826374b
ML
895 else
896 return rt_mutex_trylock(&adapter->bus_lock);
fe61e07e
JD
897}
898
899/**
900 * i2c_unlock_adapter - Release exclusive access to an I2C bus segment
901 * @adapter: Target I2C bus segment
902 */
903void i2c_unlock_adapter(struct i2c_adapter *adapter)
904{
97cc4d49
JD
905 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
906
907 if (parent)
908 i2c_unlock_adapter(parent);
0826374b
ML
909 else
910 rt_mutex_unlock(&adapter->bus_lock);
fe61e07e
JD
911}
912EXPORT_SYMBOL_GPL(i2c_unlock_adapter);
913
70762abb
JN
914static void i2c_dev_set_name(struct i2c_adapter *adap,
915 struct i2c_client *client)
916{
917 struct acpi_device *adev = ACPI_COMPANION(&client->dev);
918
919 if (adev) {
920 dev_set_name(&client->dev, "i2c-%s", acpi_dev_name(adev));
921 return;
922 }
923
924 /* For 10-bit clients, add an arbitrary offset to avoid collisions */
925 dev_set_name(&client->dev, "%d-%04x", i2c_adapter_id(adap),
926 client->addr | ((client->flags & I2C_CLIENT_TEN)
927 ? 0xa000 : 0));
928}
929
9c1600ed 930/**
f8a227e8 931 * i2c_new_device - instantiate an i2c device
9c1600ed
DB
932 * @adap: the adapter managing the device
933 * @info: describes one I2C device; bus_num is ignored
d64f73be 934 * Context: can sleep
9c1600ed 935 *
f8a227e8
JD
936 * Create an i2c device. Binding is handled through driver model
937 * probe()/remove() methods. A driver may be bound to this device when we
938 * return from this function, or any later moment (e.g. maybe hotplugging will
939 * load the driver module). This call is not appropriate for use by mainboard
940 * initialization logic, which usually runs during an arch_initcall() long
941 * before any i2c_adapter could exist.
9c1600ed
DB
942 *
943 * This returns the new i2c client, which may be saved for later use with
944 * i2c_unregister_device(); or NULL to indicate an error.
945 */
946struct i2c_client *
947i2c_new_device(struct i2c_adapter *adap, struct i2c_board_info const *info)
948{
949 struct i2c_client *client;
950 int status;
951
952 client = kzalloc(sizeof *client, GFP_KERNEL);
953 if (!client)
954 return NULL;
955
956 client->adapter = adap;
957
958 client->dev.platform_data = info->platform_data;
3bbb835d 959
11f1f2af
AV
960 if (info->archdata)
961 client->dev.archdata = *info->archdata;
962
ee35425c 963 client->flags = info->flags;
9c1600ed
DB
964 client->addr = info->addr;
965 client->irq = info->irq;
966
9c1600ed
DB
967 strlcpy(client->name, info->type, sizeof(client->name));
968
3a89db5f
JD
969 /* Check for address validity */
970 status = i2c_check_client_addr_validity(client);
971 if (status) {
972 dev_err(&adap->dev, "Invalid %d-bit I2C address 0x%02hx\n",
973 client->flags & I2C_CLIENT_TEN ? 10 : 7, client->addr);
974 goto out_err_silent;
975 }
976
f8a227e8 977 /* Check for address business */
3b5f794b 978 status = i2c_check_addr_busy(adap, client->addr);
f8a227e8
JD
979 if (status)
980 goto out_err;
981
982 client->dev.parent = &client->adapter->dev;
983 client->dev.bus = &i2c_bus_type;
51298d12 984 client->dev.type = &i2c_client_type;
d12d42f7 985 client->dev.of_node = info->of_node;
ce793486 986 client->dev.fwnode = info->fwnode;
f8a227e8 987
70762abb 988 i2c_dev_set_name(adap, client);
f8a227e8
JD
989 status = device_register(&client->dev);
990 if (status)
991 goto out_err;
992
f8a227e8
JD
993 dev_dbg(&adap->dev, "client [%s] registered with bus id %s\n",
994 client->name, dev_name(&client->dev));
995
9c1600ed 996 return client;
f8a227e8
JD
997
998out_err:
999 dev_err(&adap->dev, "Failed to register i2c client %s at 0x%02x "
1000 "(%d)\n", client->name, client->addr, status);
3a89db5f 1001out_err_silent:
f8a227e8
JD
1002 kfree(client);
1003 return NULL;
9c1600ed
DB
1004}
1005EXPORT_SYMBOL_GPL(i2c_new_device);
1006
1007
1008/**
1009 * i2c_unregister_device - reverse effect of i2c_new_device()
1010 * @client: value returned from i2c_new_device()
d64f73be 1011 * Context: can sleep
9c1600ed
DB
1012 */
1013void i2c_unregister_device(struct i2c_client *client)
a1d9e6e4 1014{
4f001fd3
PA
1015 if (client->dev.of_node)
1016 of_node_clear_flag(client->dev.of_node, OF_POPULATED);
a1d9e6e4
DB
1017 device_unregister(&client->dev);
1018}
9c1600ed 1019EXPORT_SYMBOL_GPL(i2c_unregister_device);
a1d9e6e4
DB
1020
1021
60b129d7
JD
1022static const struct i2c_device_id dummy_id[] = {
1023 { "dummy", 0 },
1024 { },
1025};
1026
d2653e92
JD
1027static int dummy_probe(struct i2c_client *client,
1028 const struct i2c_device_id *id)
1029{
1030 return 0;
1031}
1032
1033static int dummy_remove(struct i2c_client *client)
e9f1373b
DB
1034{
1035 return 0;
1036}
1037
1038static struct i2c_driver dummy_driver = {
1039 .driver.name = "dummy",
d2653e92
JD
1040 .probe = dummy_probe,
1041 .remove = dummy_remove,
60b129d7 1042 .id_table = dummy_id,
e9f1373b
DB
1043};
1044
1045/**
1046 * i2c_new_dummy - return a new i2c device bound to a dummy driver
1047 * @adapter: the adapter managing the device
1048 * @address: seven bit address to be used
e9f1373b
DB
1049 * Context: can sleep
1050 *
1051 * This returns an I2C client bound to the "dummy" driver, intended for use
1052 * with devices that consume multiple addresses. Examples of such chips
1053 * include various EEPROMS (like 24c04 and 24c08 models).
1054 *
1055 * These dummy devices have two main uses. First, most I2C and SMBus calls
1056 * except i2c_transfer() need a client handle; the dummy will be that handle.
1057 * And second, this prevents the specified address from being bound to a
1058 * different driver.
1059 *
1060 * This returns the new i2c client, which should be saved for later use with
1061 * i2c_unregister_device(); or NULL to indicate an error.
1062 */
09b8ce0a 1063struct i2c_client *i2c_new_dummy(struct i2c_adapter *adapter, u16 address)
e9f1373b
DB
1064{
1065 struct i2c_board_info info = {
60b129d7 1066 I2C_BOARD_INFO("dummy", address),
e9f1373b
DB
1067 };
1068
e9f1373b
DB
1069 return i2c_new_device(adapter, &info);
1070}
1071EXPORT_SYMBOL_GPL(i2c_new_dummy);
1072
f37dd80a
DB
1073/* ------------------------------------------------------------------------- */
1074
16ffadfc
DB
1075/* I2C bus adapters -- one roots each I2C or SMBUS segment */
1076
83eaaed0 1077static void i2c_adapter_dev_release(struct device *dev)
1da177e4 1078{
ef2c8321 1079 struct i2c_adapter *adap = to_i2c_adapter(dev);
1da177e4
LT
1080 complete(&adap->dev_released);
1081}
1082
390946b1
JD
1083/*
1084 * This function is only needed for mutex_lock_nested, so it is never
1085 * called unless locking correctness checking is enabled. Thus we
1086 * make it inline to avoid a compiler warning. That's what gcc ends up
1087 * doing anyway.
1088 */
1089static inline unsigned int i2c_adapter_depth(struct i2c_adapter *adapter)
1090{
1091 unsigned int depth = 0;
1092
1093 while ((adapter = i2c_parent_is_i2c_adapter(adapter)))
1094 depth++;
1095
1096 return depth;
1097}
1098
99cd8e25
JD
1099/*
1100 * Let users instantiate I2C devices through sysfs. This can be used when
1101 * platform initialization code doesn't contain the proper data for
1102 * whatever reason. Also useful for drivers that do device detection and
1103 * detection fails, either because the device uses an unexpected address,
1104 * or this is a compatible device with different ID register values.
1105 *
1106 * Parameter checking may look overzealous, but we really don't want
1107 * the user to provide incorrect parameters.
1108 */
1109static ssize_t
1110i2c_sysfs_new_device(struct device *dev, struct device_attribute *attr,
1111 const char *buf, size_t count)
1112{
1113 struct i2c_adapter *adap = to_i2c_adapter(dev);
1114 struct i2c_board_info info;
1115 struct i2c_client *client;
1116 char *blank, end;
1117 int res;
1118
99cd8e25
JD
1119 memset(&info, 0, sizeof(struct i2c_board_info));
1120
1121 blank = strchr(buf, ' ');
1122 if (!blank) {
1123 dev_err(dev, "%s: Missing parameters\n", "new_device");
1124 return -EINVAL;
1125 }
1126 if (blank - buf > I2C_NAME_SIZE - 1) {
1127 dev_err(dev, "%s: Invalid device name\n", "new_device");
1128 return -EINVAL;
1129 }
1130 memcpy(info.type, buf, blank - buf);
1131
1132 /* Parse remaining parameters, reject extra parameters */
1133 res = sscanf(++blank, "%hi%c", &info.addr, &end);
1134 if (res < 1) {
1135 dev_err(dev, "%s: Can't parse I2C address\n", "new_device");
1136 return -EINVAL;
1137 }
1138 if (res > 1 && end != '\n') {
1139 dev_err(dev, "%s: Extra parameters\n", "new_device");
1140 return -EINVAL;
1141 }
1142
99cd8e25
JD
1143 client = i2c_new_device(adap, &info);
1144 if (!client)
3a89db5f 1145 return -EINVAL;
99cd8e25
JD
1146
1147 /* Keep track of the added device */
dafc50d1 1148 mutex_lock(&adap->userspace_clients_lock);
6629dcff 1149 list_add_tail(&client->detected, &adap->userspace_clients);
dafc50d1 1150 mutex_unlock(&adap->userspace_clients_lock);
99cd8e25
JD
1151 dev_info(dev, "%s: Instantiated device %s at 0x%02hx\n", "new_device",
1152 info.type, info.addr);
1153
1154 return count;
1155}
a5eb71b2 1156static DEVICE_ATTR(new_device, S_IWUSR, NULL, i2c_sysfs_new_device);
99cd8e25
JD
1157
1158/*
1159 * And of course let the users delete the devices they instantiated, if
1160 * they got it wrong. This interface can only be used to delete devices
1161 * instantiated by i2c_sysfs_new_device above. This guarantees that we
1162 * don't delete devices to which some kernel code still has references.
1163 *
1164 * Parameter checking may look overzealous, but we really don't want
1165 * the user to delete the wrong device.
1166 */
1167static ssize_t
1168i2c_sysfs_delete_device(struct device *dev, struct device_attribute *attr,
1169 const char *buf, size_t count)
1170{
1171 struct i2c_adapter *adap = to_i2c_adapter(dev);
1172 struct i2c_client *client, *next;
1173 unsigned short addr;
1174 char end;
1175 int res;
1176
1177 /* Parse parameters, reject extra parameters */
1178 res = sscanf(buf, "%hi%c", &addr, &end);
1179 if (res < 1) {
1180 dev_err(dev, "%s: Can't parse I2C address\n", "delete_device");
1181 return -EINVAL;
1182 }
1183 if (res > 1 && end != '\n') {
1184 dev_err(dev, "%s: Extra parameters\n", "delete_device");
1185 return -EINVAL;
1186 }
1187
1188 /* Make sure the device was added through sysfs */
1189 res = -ENOENT;
390946b1
JD
1190 mutex_lock_nested(&adap->userspace_clients_lock,
1191 i2c_adapter_depth(adap));
6629dcff
JD
1192 list_for_each_entry_safe(client, next, &adap->userspace_clients,
1193 detected) {
1194 if (client->addr == addr) {
99cd8e25
JD
1195 dev_info(dev, "%s: Deleting device %s at 0x%02hx\n",
1196 "delete_device", client->name, client->addr);
1197
1198 list_del(&client->detected);
1199 i2c_unregister_device(client);
1200 res = count;
1201 break;
1202 }
1203 }
dafc50d1 1204 mutex_unlock(&adap->userspace_clients_lock);
99cd8e25
JD
1205
1206 if (res < 0)
1207 dev_err(dev, "%s: Can't find device in list\n",
1208 "delete_device");
1209 return res;
1210}
e9b526fe
AS
1211static DEVICE_ATTR_IGNORE_LOCKDEP(delete_device, S_IWUSR, NULL,
1212 i2c_sysfs_delete_device);
4f8cf824
JD
1213
1214static struct attribute *i2c_adapter_attrs[] = {
1215 &dev_attr_name.attr,
1216 &dev_attr_new_device.attr,
1217 &dev_attr_delete_device.attr,
1218 NULL
1219};
a5eb71b2 1220ATTRIBUTE_GROUPS(i2c_adapter);
b119dc3f 1221
0826374b 1222struct device_type i2c_adapter_type = {
a5eb71b2 1223 .groups = i2c_adapter_groups,
4f8cf824 1224 .release = i2c_adapter_dev_release,
1da177e4 1225};
0826374b 1226EXPORT_SYMBOL_GPL(i2c_adapter_type);
1da177e4 1227
643dd09e
SW
1228/**
1229 * i2c_verify_adapter - return parameter as i2c_adapter or NULL
1230 * @dev: device, probably from some driver model iterator
1231 *
1232 * When traversing the driver model tree, perhaps using driver model
1233 * iterators like @device_for_each_child(), you can't assume very much
1234 * about the nodes you find. Use this function to avoid oopses caused
1235 * by wrongly treating some non-I2C device as an i2c_adapter.
1236 */
1237struct i2c_adapter *i2c_verify_adapter(struct device *dev)
1238{
1239 return (dev->type == &i2c_adapter_type)
1240 ? to_i2c_adapter(dev)
1241 : NULL;
1242}
1243EXPORT_SYMBOL(i2c_verify_adapter);
1244
2bb5095a
JD
1245#ifdef CONFIG_I2C_COMPAT
1246static struct class_compat *i2c_adapter_compat_class;
1247#endif
1248
9c1600ed
DB
1249static void i2c_scan_static_board_info(struct i2c_adapter *adapter)
1250{
1251 struct i2c_devinfo *devinfo;
1252
f18c41da 1253 down_read(&__i2c_board_lock);
9c1600ed
DB
1254 list_for_each_entry(devinfo, &__i2c_board_list, list) {
1255 if (devinfo->busnum == adapter->nr
1256 && !i2c_new_device(adapter,
1257 &devinfo->board_info))
09b8ce0a
ZX
1258 dev_err(&adapter->dev,
1259 "Can't create device at 0x%02x\n",
9c1600ed
DB
1260 devinfo->board_info.addr);
1261 }
f18c41da 1262 up_read(&__i2c_board_lock);
9c1600ed
DB
1263}
1264
687b81d0
WS
1265/* OF support code */
1266
1267#if IS_ENABLED(CONFIG_OF)
a430a345
PA
1268static struct i2c_client *of_i2c_register_device(struct i2c_adapter *adap,
1269 struct device_node *node)
687b81d0 1270{
a430a345
PA
1271 struct i2c_client *result;
1272 struct i2c_board_info info = {};
1273 struct dev_archdata dev_ad = {};
1274 const __be32 *addr;
1275 int len;
687b81d0 1276
a430a345 1277 dev_dbg(&adap->dev, "of_i2c: register %s\n", node->full_name);
687b81d0 1278
a430a345
PA
1279 if (of_modalias_node(node, info.type, sizeof(info.type)) < 0) {
1280 dev_err(&adap->dev, "of_i2c: modalias failure on %s\n",
1281 node->full_name);
1282 return ERR_PTR(-EINVAL);
1283 }
687b81d0 1284
a430a345 1285 addr = of_get_property(node, "reg", &len);
4c1344f1 1286 if (!addr || (len < sizeof(*addr))) {
a430a345
PA
1287 dev_err(&adap->dev, "of_i2c: invalid reg on %s\n",
1288 node->full_name);
1289 return ERR_PTR(-EINVAL);
1290 }
687b81d0 1291
a430a345
PA
1292 info.addr = be32_to_cpup(addr);
1293 if (info.addr > (1 << 10) - 1) {
1294 dev_err(&adap->dev, "of_i2c: invalid addr=%x on %s\n",
1295 info.addr, node->full_name);
1296 return ERR_PTR(-EINVAL);
1297 }
687b81d0 1298
a430a345
PA
1299 info.of_node = of_node_get(node);
1300 info.archdata = &dev_ad;
687b81d0 1301
a430a345
PA
1302 if (of_get_property(node, "wakeup-source", NULL))
1303 info.flags |= I2C_CLIENT_WAKE;
687b81d0 1304
a430a345
PA
1305 result = i2c_new_device(adap, &info);
1306 if (result == NULL) {
1307 dev_err(&adap->dev, "of_i2c: Failure registering %s\n",
1308 node->full_name);
1309 of_node_put(node);
a430a345
PA
1310 return ERR_PTR(-EINVAL);
1311 }
1312 return result;
1313}
687b81d0 1314
a430a345
PA
1315static void of_i2c_register_devices(struct i2c_adapter *adap)
1316{
1317 struct device_node *node;
687b81d0 1318
a430a345
PA
1319 /* Only register child devices if the adapter has a node pointer set */
1320 if (!adap->dev.of_node)
1321 return;
687b81d0 1322
a430a345
PA
1323 dev_dbg(&adap->dev, "of_i2c: walking child nodes\n");
1324
4f001fd3
PA
1325 for_each_available_child_of_node(adap->dev.of_node, node) {
1326 if (of_node_test_and_set_flag(node, OF_POPULATED))
1327 continue;
a430a345 1328 of_i2c_register_device(adap, node);
4f001fd3 1329 }
687b81d0
WS
1330}
1331
1332static int of_dev_node_match(struct device *dev, void *data)
1333{
1334 return dev->of_node == data;
1335}
1336
1337/* must call put_device() when done with returned i2c_client device */
1338struct i2c_client *of_find_i2c_device_by_node(struct device_node *node)
1339{
1340 struct device *dev;
1341
1342 dev = bus_find_device(&i2c_bus_type, NULL, node,
1343 of_dev_node_match);
1344 if (!dev)
1345 return NULL;
1346
1347 return i2c_verify_client(dev);
1348}
1349EXPORT_SYMBOL(of_find_i2c_device_by_node);
1350
1351/* must call put_device() when done with returned i2c_adapter device */
1352struct i2c_adapter *of_find_i2c_adapter_by_node(struct device_node *node)
1353{
1354 struct device *dev;
1355
1356 dev = bus_find_device(&i2c_bus_type, NULL, node,
1357 of_dev_node_match);
1358 if (!dev)
1359 return NULL;
1360
1361 return i2c_verify_adapter(dev);
1362}
1363EXPORT_SYMBOL(of_find_i2c_adapter_by_node);
1364#else
1365static void of_i2c_register_devices(struct i2c_adapter *adap) { }
1366#endif /* CONFIG_OF */
1367
69b0089a
JD
1368static int i2c_do_add_adapter(struct i2c_driver *driver,
1369 struct i2c_adapter *adap)
026526f5 1370{
4735c98f
JD
1371 /* Detect supported devices on that bus, and instantiate them */
1372 i2c_detect(adap, driver);
1373
1374 /* Let legacy drivers scan this bus for matching devices */
026526f5 1375 if (driver->attach_adapter) {
a920ff41
JD
1376 dev_warn(&adap->dev, "%s: attach_adapter method is deprecated\n",
1377 driver->driver.name);
fe6fc258
JD
1378 dev_warn(&adap->dev, "Please use another way to instantiate "
1379 "your i2c_client\n");
026526f5
JD
1380 /* We ignore the return code; if it fails, too bad */
1381 driver->attach_adapter(adap);
1382 }
1383 return 0;
1384}
1385
69b0089a
JD
1386static int __process_new_adapter(struct device_driver *d, void *data)
1387{
1388 return i2c_do_add_adapter(to_i2c_driver(d), data);
1389}
1390
6e13e641 1391static int i2c_register_adapter(struct i2c_adapter *adap)
1da177e4 1392{
d6703281 1393 int res = 0;
1da177e4 1394
1d0b19c9 1395 /* Can't register until after driver model init */
35fc37f8
JD
1396 if (unlikely(WARN_ON(!i2c_bus_type.p))) {
1397 res = -EAGAIN;
1398 goto out_list;
1399 }
1d0b19c9 1400
2236baa7
JD
1401 /* Sanity checks */
1402 if (unlikely(adap->name[0] == '\0')) {
1403 pr_err("i2c-core: Attempt to register an adapter with "
1404 "no name!\n");
1405 return -EINVAL;
1406 }
1407 if (unlikely(!adap->algo)) {
1408 pr_err("i2c-core: Attempt to register adapter '%s' with "
1409 "no algo!\n", adap->name);
1410 return -EINVAL;
1411 }
1412
194684e5 1413 rt_mutex_init(&adap->bus_lock);
dafc50d1 1414 mutex_init(&adap->userspace_clients_lock);
6629dcff 1415 INIT_LIST_HEAD(&adap->userspace_clients);
1da177e4 1416
8fcfef6e
JD
1417 /* Set default timeout to 1 second if not already set */
1418 if (adap->timeout == 0)
1419 adap->timeout = HZ;
1420
27d9c183 1421 dev_set_name(&adap->dev, "i2c-%d", adap->nr);
4f8cf824
JD
1422 adap->dev.bus = &i2c_bus_type;
1423 adap->dev.type = &i2c_adapter_type;
b119c6c9
JD
1424 res = device_register(&adap->dev);
1425 if (res)
1426 goto out_list;
1da177e4 1427
b6d7b3d1
JD
1428 dev_dbg(&adap->dev, "adapter [%s] registered\n", adap->name);
1429
6ada5c1e
CK
1430 pm_runtime_no_callbacks(&adap->dev);
1431
2bb5095a
JD
1432#ifdef CONFIG_I2C_COMPAT
1433 res = class_compat_create_link(i2c_adapter_compat_class, &adap->dev,
1434 adap->dev.parent);
1435 if (res)
1436 dev_warn(&adap->dev,
1437 "Failed to create compatibility class link\n");
1438#endif
1439
5f9296ba
VK
1440 /* bus recovery specific initialization */
1441 if (adap->bus_recovery_info) {
1442 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
1443
1444 if (!bri->recover_bus) {
1445 dev_err(&adap->dev, "No recover_bus() found, not using recovery\n");
1446 adap->bus_recovery_info = NULL;
1447 goto exit_recovery;
1448 }
1449
1450 /* Generic GPIO recovery */
1451 if (bri->recover_bus == i2c_generic_gpio_recovery) {
1452 if (!gpio_is_valid(bri->scl_gpio)) {
1453 dev_err(&adap->dev, "Invalid SCL gpio, not using recovery\n");
1454 adap->bus_recovery_info = NULL;
1455 goto exit_recovery;
1456 }
1457
1458 if (gpio_is_valid(bri->sda_gpio))
1459 bri->get_sda = get_sda_gpio_value;
1460 else
1461 bri->get_sda = NULL;
1462
1463 bri->get_scl = get_scl_gpio_value;
1464 bri->set_scl = set_scl_gpio_value;
1465 } else if (!bri->set_scl || !bri->get_scl) {
1466 /* Generic SCL recovery */
1467 dev_err(&adap->dev, "No {get|set}_gpio() found, not using recovery\n");
1468 adap->bus_recovery_info = NULL;
1469 }
1470 }
1471
1472exit_recovery:
729d6dd5 1473 /* create pre-declared device nodes */
687b81d0 1474 of_i2c_register_devices(adap);
55e71edb 1475 acpi_i2c_register_devices(adap);
5d98e61d 1476 acpi_i2c_install_space_handler(adap);
687b81d0 1477
6e13e641
DB
1478 if (adap->nr < __i2c_first_dynamic_bus_num)
1479 i2c_scan_static_board_info(adap);
1480
4735c98f 1481 /* Notify drivers */
35fc37f8 1482 mutex_lock(&core_lock);
d6703281 1483 bus_for_each_drv(&i2c_bus_type, NULL, adap, __process_new_adapter);
caada32a 1484 mutex_unlock(&core_lock);
35fc37f8
JD
1485
1486 return 0;
b119c6c9 1487
b119c6c9 1488out_list:
35fc37f8 1489 mutex_lock(&core_lock);
b119c6c9 1490 idr_remove(&i2c_adapter_idr, adap->nr);
35fc37f8
JD
1491 mutex_unlock(&core_lock);
1492 return res;
1da177e4
LT
1493}
1494
ee5c2744
DA
1495/**
1496 * __i2c_add_numbered_adapter - i2c_add_numbered_adapter where nr is never -1
1497 * @adap: the adapter to register (with adap->nr initialized)
1498 * Context: can sleep
1499 *
1500 * See i2c_add_numbered_adapter() for details.
1501 */
1502static int __i2c_add_numbered_adapter(struct i2c_adapter *adap)
1503{
1504 int id;
1505
1506 mutex_lock(&core_lock);
1507 id = idr_alloc(&i2c_adapter_idr, adap, adap->nr, adap->nr + 1,
1508 GFP_KERNEL);
1509 mutex_unlock(&core_lock);
1510 if (id < 0)
1511 return id == -ENOSPC ? -EBUSY : id;
1512
1513 return i2c_register_adapter(adap);
1514}
1515
6e13e641
DB
1516/**
1517 * i2c_add_adapter - declare i2c adapter, use dynamic bus number
1518 * @adapter: the adapter to add
d64f73be 1519 * Context: can sleep
6e13e641
DB
1520 *
1521 * This routine is used to declare an I2C adapter when its bus number
ee5c2744
DA
1522 * doesn't matter or when its bus number is specified by an dt alias.
1523 * Examples of bases when the bus number doesn't matter: I2C adapters
1524 * dynamically added by USB links or PCI plugin cards.
6e13e641
DB
1525 *
1526 * When this returns zero, a new bus number was allocated and stored
1527 * in adap->nr, and the specified adapter became available for clients.
1528 * Otherwise, a negative errno value is returned.
1529 */
1530int i2c_add_adapter(struct i2c_adapter *adapter)
1531{
ee5c2744 1532 struct device *dev = &adapter->dev;
4ae42b0f 1533 int id;
6e13e641 1534
ee5c2744
DA
1535 if (dev->of_node) {
1536 id = of_alias_get_id(dev->of_node, "i2c");
1537 if (id >= 0) {
1538 adapter->nr = id;
1539 return __i2c_add_numbered_adapter(adapter);
1540 }
1541 }
1542
caada32a 1543 mutex_lock(&core_lock);
4ae42b0f
TH
1544 id = idr_alloc(&i2c_adapter_idr, adapter,
1545 __i2c_first_dynamic_bus_num, 0, GFP_KERNEL);
caada32a 1546 mutex_unlock(&core_lock);
4ae42b0f
TH
1547 if (id < 0)
1548 return id;
6e13e641
DB
1549
1550 adapter->nr = id;
4ae42b0f 1551
6e13e641
DB
1552 return i2c_register_adapter(adapter);
1553}
1554EXPORT_SYMBOL(i2c_add_adapter);
1555
1556/**
1557 * i2c_add_numbered_adapter - declare i2c adapter, use static bus number
1558 * @adap: the adapter to register (with adap->nr initialized)
d64f73be 1559 * Context: can sleep
6e13e641
DB
1560 *
1561 * This routine is used to declare an I2C adapter when its bus number
8c07e46f
RD
1562 * matters. For example, use it for I2C adapters from system-on-chip CPUs,
1563 * or otherwise built in to the system's mainboard, and where i2c_board_info
6e13e641
DB
1564 * is used to properly configure I2C devices.
1565 *
488bf314
GL
1566 * If the requested bus number is set to -1, then this function will behave
1567 * identically to i2c_add_adapter, and will dynamically assign a bus number.
1568 *
6e13e641
DB
1569 * If no devices have pre-been declared for this bus, then be sure to
1570 * register the adapter before any dynamically allocated ones. Otherwise
1571 * the required bus ID may not be available.
1572 *
1573 * When this returns zero, the specified adapter became available for
1574 * clients using the bus number provided in adap->nr. Also, the table
1575 * of I2C devices pre-declared using i2c_register_board_info() is scanned,
1576 * and the appropriate driver model device nodes are created. Otherwise, a
1577 * negative errno value is returned.
1578 */
1579int i2c_add_numbered_adapter(struct i2c_adapter *adap)
1580{
488bf314
GL
1581 if (adap->nr == -1) /* -1 means dynamically assign bus id */
1582 return i2c_add_adapter(adap);
6e13e641 1583
ee5c2744 1584 return __i2c_add_numbered_adapter(adap);
6e13e641
DB
1585}
1586EXPORT_SYMBOL_GPL(i2c_add_numbered_adapter);
1587
19baba4c 1588static void i2c_do_del_adapter(struct i2c_driver *driver,
69b0089a 1589 struct i2c_adapter *adapter)
026526f5 1590{
4735c98f 1591 struct i2c_client *client, *_n;
026526f5 1592
acec211c
JD
1593 /* Remove the devices we created ourselves as the result of hardware
1594 * probing (using a driver's detect method) */
4735c98f
JD
1595 list_for_each_entry_safe(client, _n, &driver->clients, detected) {
1596 if (client->adapter == adapter) {
1597 dev_dbg(&adapter->dev, "Removing %s at 0x%x\n",
1598 client->name, client->addr);
1599 list_del(&client->detected);
1600 i2c_unregister_device(client);
1601 }
1602 }
026526f5
JD
1603}
1604
e549c2b5 1605static int __unregister_client(struct device *dev, void *dummy)
5219bf88
JD
1606{
1607 struct i2c_client *client = i2c_verify_client(dev);
1608 if (client && strcmp(client->name, "dummy"))
1609 i2c_unregister_device(client);
1610 return 0;
1611}
1612
1613static int __unregister_dummy(struct device *dev, void *dummy)
e549c2b5
JD
1614{
1615 struct i2c_client *client = i2c_verify_client(dev);
1616 if (client)
1617 i2c_unregister_device(client);
1618 return 0;
1619}
1620
69b0089a
JD
1621static int __process_removed_adapter(struct device_driver *d, void *data)
1622{
19baba4c
LPC
1623 i2c_do_del_adapter(to_i2c_driver(d), data);
1624 return 0;
69b0089a
JD
1625}
1626
d64f73be
DB
1627/**
1628 * i2c_del_adapter - unregister I2C adapter
1629 * @adap: the adapter being unregistered
1630 * Context: can sleep
1631 *
1632 * This unregisters an I2C adapter which was previously registered
1633 * by @i2c_add_adapter or @i2c_add_numbered_adapter.
1634 */
71546300 1635void i2c_del_adapter(struct i2c_adapter *adap)
1da177e4 1636{
35fc37f8 1637 struct i2c_adapter *found;
bbd2d9c9 1638 struct i2c_client *client, *next;
1da177e4
LT
1639
1640 /* First make sure that this adapter was ever added */
35fc37f8
JD
1641 mutex_lock(&core_lock);
1642 found = idr_find(&i2c_adapter_idr, adap->nr);
1643 mutex_unlock(&core_lock);
1644 if (found != adap) {
b6d7b3d1
JD
1645 pr_debug("i2c-core: attempting to delete unregistered "
1646 "adapter [%s]\n", adap->name);
71546300 1647 return;
1da177e4
LT
1648 }
1649
5d98e61d 1650 acpi_i2c_remove_space_handler(adap);
026526f5 1651 /* Tell drivers about this removal */
35fc37f8 1652 mutex_lock(&core_lock);
19baba4c 1653 bus_for_each_drv(&i2c_bus_type, NULL, adap,
69b0089a 1654 __process_removed_adapter);
35fc37f8 1655 mutex_unlock(&core_lock);
1da177e4 1656
bbd2d9c9 1657 /* Remove devices instantiated from sysfs */
390946b1
JD
1658 mutex_lock_nested(&adap->userspace_clients_lock,
1659 i2c_adapter_depth(adap));
6629dcff
JD
1660 list_for_each_entry_safe(client, next, &adap->userspace_clients,
1661 detected) {
1662 dev_dbg(&adap->dev, "Removing %s at 0x%x\n", client->name,
1663 client->addr);
1664 list_del(&client->detected);
1665 i2c_unregister_device(client);
bbd2d9c9 1666 }
dafc50d1 1667 mutex_unlock(&adap->userspace_clients_lock);
bbd2d9c9 1668
e549c2b5 1669 /* Detach any active clients. This can't fail, thus we do not
5219bf88
JD
1670 * check the returned value. This is a two-pass process, because
1671 * we can't remove the dummy devices during the first pass: they
1672 * could have been instantiated by real devices wishing to clean
1673 * them up properly, so we give them a chance to do that first. */
19baba4c
LPC
1674 device_for_each_child(&adap->dev, NULL, __unregister_client);
1675 device_for_each_child(&adap->dev, NULL, __unregister_dummy);
1da177e4 1676
2bb5095a
JD
1677#ifdef CONFIG_I2C_COMPAT
1678 class_compat_remove_link(i2c_adapter_compat_class, &adap->dev,
1679 adap->dev.parent);
1680#endif
1681
c5567521
TLSC
1682 /* device name is gone after device_unregister */
1683 dev_dbg(&adap->dev, "adapter [%s] unregistered\n", adap->name);
1684
26680ee2
WS
1685 /* wait until all references to the device are gone
1686 *
1687 * FIXME: This is old code and should ideally be replaced by an
1688 * alternative which results in decoupling the lifetime of the struct
1689 * device from the i2c_adapter, like spi or netdev do. Any solution
95cc1e3d 1690 * should be thoroughly tested with DEBUG_KOBJECT_RELEASE enabled!
26680ee2 1691 */
1da177e4 1692 init_completion(&adap->dev_released);
1da177e4 1693 device_unregister(&adap->dev);
1da177e4 1694 wait_for_completion(&adap->dev_released);
1da177e4 1695
6e13e641 1696 /* free bus id */
35fc37f8 1697 mutex_lock(&core_lock);
1da177e4 1698 idr_remove(&i2c_adapter_idr, adap->nr);
35fc37f8 1699 mutex_unlock(&core_lock);
1da177e4 1700
bd4bc3db
JD
1701 /* Clear the device structure in case this adapter is ever going to be
1702 added again */
1703 memset(&adap->dev, 0, sizeof(adap->dev));
1da177e4 1704}
c0564606 1705EXPORT_SYMBOL(i2c_del_adapter);
1da177e4 1706
7b4fbc50
DB
1707/* ------------------------------------------------------------------------- */
1708
7ae31482
JD
1709int i2c_for_each_dev(void *data, int (*fn)(struct device *, void *))
1710{
1711 int res;
1712
1713 mutex_lock(&core_lock);
1714 res = bus_for_each_dev(&i2c_bus_type, NULL, data, fn);
1715 mutex_unlock(&core_lock);
1716
1717 return res;
1718}
1719EXPORT_SYMBOL_GPL(i2c_for_each_dev);
1720
69b0089a 1721static int __process_new_driver(struct device *dev, void *data)
7f101a97 1722{
4f8cf824
JD
1723 if (dev->type != &i2c_adapter_type)
1724 return 0;
69b0089a 1725 return i2c_do_add_adapter(data, to_i2c_adapter(dev));
7f101a97
DY
1726}
1727
7b4fbc50
DB
1728/*
1729 * An i2c_driver is used with one or more i2c_client (device) nodes to access
729d6dd5 1730 * i2c slave chips, on a bus instance associated with some i2c_adapter.
1da177e4
LT
1731 */
1732
de59cf9e 1733int i2c_register_driver(struct module *owner, struct i2c_driver *driver)
1da177e4 1734{
7eebcb7c 1735 int res;
1da177e4 1736
1d0b19c9
DB
1737 /* Can't register until after driver model init */
1738 if (unlikely(WARN_ON(!i2c_bus_type.p)))
1739 return -EAGAIN;
1740
1da177e4 1741 /* add the driver to the list of i2c drivers in the driver core */
de59cf9e 1742 driver->driver.owner = owner;
1da177e4 1743 driver->driver.bus = &i2c_bus_type;
1da177e4 1744
729d6dd5 1745 /* When registration returns, the driver core
6e13e641
DB
1746 * will have called probe() for all matching-but-unbound devices.
1747 */
1da177e4
LT
1748 res = driver_register(&driver->driver);
1749 if (res)
7eebcb7c 1750 return res;
438d6c2c 1751
35d8b2e6 1752 pr_debug("i2c-core: driver [%s] registered\n", driver->driver.name);
1da177e4 1753
4735c98f
JD
1754 INIT_LIST_HEAD(&driver->clients);
1755 /* Walk the adapters that are already present */
7ae31482 1756 i2c_for_each_dev(driver, __process_new_driver);
35fc37f8 1757
7f101a97
DY
1758 return 0;
1759}
1760EXPORT_SYMBOL(i2c_register_driver);
1761
69b0089a 1762static int __process_removed_driver(struct device *dev, void *data)
7f101a97 1763{
19baba4c
LPC
1764 if (dev->type == &i2c_adapter_type)
1765 i2c_do_del_adapter(data, to_i2c_adapter(dev));
1766 return 0;
1da177e4
LT
1767}
1768
a1d9e6e4
DB
1769/**
1770 * i2c_del_driver - unregister I2C driver
1771 * @driver: the driver being unregistered
d64f73be 1772 * Context: can sleep
a1d9e6e4 1773 */
b3e82096 1774void i2c_del_driver(struct i2c_driver *driver)
1da177e4 1775{
7ae31482 1776 i2c_for_each_dev(driver, __process_removed_driver);
1da177e4
LT
1777
1778 driver_unregister(&driver->driver);
35d8b2e6 1779 pr_debug("i2c-core: driver [%s] unregistered\n", driver->driver.name);
1da177e4 1780}
c0564606 1781EXPORT_SYMBOL(i2c_del_driver);
1da177e4 1782
7b4fbc50
DB
1783/* ------------------------------------------------------------------------- */
1784
e48d3319
JD
1785/**
1786 * i2c_use_client - increments the reference count of the i2c client structure
1787 * @client: the client being referenced
1788 *
1789 * Each live reference to a client should be refcounted. The driver model does
1790 * that automatically as part of driver binding, so that most drivers don't
1791 * need to do this explicitly: they hold a reference until they're unbound
1792 * from the device.
1793 *
1794 * A pointer to the client with the incremented reference counter is returned.
1795 */
1796struct i2c_client *i2c_use_client(struct i2c_client *client)
1da177e4 1797{
6ea438ec
DB
1798 if (client && get_device(&client->dev))
1799 return client;
1800 return NULL;
1da177e4 1801}
c0564606 1802EXPORT_SYMBOL(i2c_use_client);
1da177e4 1803
e48d3319
JD
1804/**
1805 * i2c_release_client - release a use of the i2c client structure
1806 * @client: the client being no longer referenced
1807 *
1808 * Must be called when a user of a client is finished with it.
1809 */
1810void i2c_release_client(struct i2c_client *client)
1da177e4 1811{
6ea438ec
DB
1812 if (client)
1813 put_device(&client->dev);
1da177e4 1814}
c0564606 1815EXPORT_SYMBOL(i2c_release_client);
1da177e4 1816
9b766b81
DB
1817struct i2c_cmd_arg {
1818 unsigned cmd;
1819 void *arg;
1820};
1821
1822static int i2c_cmd(struct device *dev, void *_arg)
1823{
1824 struct i2c_client *client = i2c_verify_client(dev);
1825 struct i2c_cmd_arg *arg = _arg;
0acc2b32
LPC
1826 struct i2c_driver *driver;
1827
1828 if (!client || !client->dev.driver)
1829 return 0;
9b766b81 1830
0acc2b32
LPC
1831 driver = to_i2c_driver(client->dev.driver);
1832 if (driver->command)
1833 driver->command(client, arg->cmd, arg->arg);
9b766b81
DB
1834 return 0;
1835}
1836
1da177e4
LT
1837void i2c_clients_command(struct i2c_adapter *adap, unsigned int cmd, void *arg)
1838{
9b766b81 1839 struct i2c_cmd_arg cmd_arg;
1da177e4 1840
9b766b81
DB
1841 cmd_arg.cmd = cmd;
1842 cmd_arg.arg = arg;
1843 device_for_each_child(&adap->dev, &cmd_arg, i2c_cmd);
1da177e4 1844}
c0564606 1845EXPORT_SYMBOL(i2c_clients_command);
1da177e4 1846
ea7513bb
PA
1847#if IS_ENABLED(CONFIG_OF_DYNAMIC)
1848static int of_i2c_notify(struct notifier_block *nb, unsigned long action,
1849 void *arg)
1850{
1851 struct of_reconfig_data *rd = arg;
1852 struct i2c_adapter *adap;
1853 struct i2c_client *client;
1854
1855 switch (of_reconfig_get_state_change(action, rd)) {
1856 case OF_RECONFIG_CHANGE_ADD:
1857 adap = of_find_i2c_adapter_by_node(rd->dn->parent);
1858 if (adap == NULL)
1859 return NOTIFY_OK; /* not for us */
1860
4f001fd3
PA
1861 if (of_node_test_and_set_flag(rd->dn, OF_POPULATED)) {
1862 put_device(&adap->dev);
1863 return NOTIFY_OK;
1864 }
1865
ea7513bb
PA
1866 client = of_i2c_register_device(adap, rd->dn);
1867 put_device(&adap->dev);
1868
1869 if (IS_ERR(client)) {
1870 pr_err("%s: failed to create for '%s'\n",
1871 __func__, rd->dn->full_name);
1872 return notifier_from_errno(PTR_ERR(client));
1873 }
1874 break;
1875 case OF_RECONFIG_CHANGE_REMOVE:
4f001fd3
PA
1876 /* already depopulated? */
1877 if (!of_node_check_flag(rd->dn, OF_POPULATED))
1878 return NOTIFY_OK;
1879
ea7513bb
PA
1880 /* find our device by node */
1881 client = of_find_i2c_device_by_node(rd->dn);
1882 if (client == NULL)
1883 return NOTIFY_OK; /* no? not meant for us */
1884
1885 /* unregister takes one ref away */
1886 i2c_unregister_device(client);
1887
1888 /* and put the reference of the find */
1889 put_device(&client->dev);
1890 break;
1891 }
1892
1893 return NOTIFY_OK;
1894}
1895static struct notifier_block i2c_of_notifier = {
1896 .notifier_call = of_i2c_notify,
1897};
1898#else
1899extern struct notifier_block i2c_of_notifier;
1900#endif /* CONFIG_OF_DYNAMIC */
1901
1da177e4
LT
1902static int __init i2c_init(void)
1903{
1904 int retval;
1905
03bde7c3
WS
1906 retval = of_alias_get_highest_id("i2c");
1907
1908 down_write(&__i2c_board_lock);
1909 if (retval >= __i2c_first_dynamic_bus_num)
1910 __i2c_first_dynamic_bus_num = retval + 1;
1911 up_write(&__i2c_board_lock);
1912
1da177e4 1913 retval = bus_register(&i2c_bus_type);
1da177e4
LT
1914 if (retval)
1915 return retval;
2bb5095a
JD
1916#ifdef CONFIG_I2C_COMPAT
1917 i2c_adapter_compat_class = class_compat_register("i2c-adapter");
1918 if (!i2c_adapter_compat_class) {
1919 retval = -ENOMEM;
1920 goto bus_err;
1921 }
1922#endif
e9f1373b
DB
1923 retval = i2c_add_driver(&dummy_driver);
1924 if (retval)
2bb5095a 1925 goto class_err;
ea7513bb
PA
1926
1927 if (IS_ENABLED(CONFIG_OF_DYNAMIC))
1928 WARN_ON(of_reconfig_notifier_register(&i2c_of_notifier));
1929
e9f1373b
DB
1930 return 0;
1931
2bb5095a
JD
1932class_err:
1933#ifdef CONFIG_I2C_COMPAT
1934 class_compat_unregister(i2c_adapter_compat_class);
e9f1373b 1935bus_err:
2bb5095a 1936#endif
e9f1373b
DB
1937 bus_unregister(&i2c_bus_type);
1938 return retval;
1da177e4
LT
1939}
1940
1941static void __exit i2c_exit(void)
1942{
ea7513bb
PA
1943 if (IS_ENABLED(CONFIG_OF_DYNAMIC))
1944 WARN_ON(of_reconfig_notifier_unregister(&i2c_of_notifier));
e9f1373b 1945 i2c_del_driver(&dummy_driver);
2bb5095a
JD
1946#ifdef CONFIG_I2C_COMPAT
1947 class_compat_unregister(i2c_adapter_compat_class);
1948#endif
1da177e4 1949 bus_unregister(&i2c_bus_type);
d9a83d62 1950 tracepoint_synchronize_unregister();
1da177e4
LT
1951}
1952
a10f9e7c
DB
1953/* We must initialize early, because some subsystems register i2c drivers
1954 * in subsys_initcall() code, but are linked (and initialized) before i2c.
1955 */
1956postcore_initcall(i2c_init);
1da177e4
LT
1957module_exit(i2c_exit);
1958
1959/* ----------------------------------------------------
1960 * the functional interface to the i2c busses.
1961 * ----------------------------------------------------
1962 */
1963
b7f62584
WS
1964/* Check if val is exceeding the quirk IFF quirk is non 0 */
1965#define i2c_quirk_exceeded(val, quirk) ((quirk) && ((val) > (quirk)))
1966
1967static int i2c_quirk_error(struct i2c_adapter *adap, struct i2c_msg *msg, char *err_msg)
1968{
1969 dev_err_ratelimited(&adap->dev, "adapter quirk: %s (addr 0x%04x, size %u, %s)\n",
1970 err_msg, msg->addr, msg->len,
1971 msg->flags & I2C_M_RD ? "read" : "write");
1972 return -EOPNOTSUPP;
1973}
1974
1975static int i2c_check_for_quirks(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
1976{
1977 const struct i2c_adapter_quirks *q = adap->quirks;
1978 int max_num = q->max_num_msgs, i;
1979 bool do_len_check = true;
1980
1981 if (q->flags & I2C_AQ_COMB) {
1982 max_num = 2;
1983
1984 /* special checks for combined messages */
1985 if (num == 2) {
1986 if (q->flags & I2C_AQ_COMB_WRITE_FIRST && msgs[0].flags & I2C_M_RD)
1987 return i2c_quirk_error(adap, &msgs[0], "1st comb msg must be write");
1988
1989 if (q->flags & I2C_AQ_COMB_READ_SECOND && !(msgs[1].flags & I2C_M_RD))
1990 return i2c_quirk_error(adap, &msgs[1], "2nd comb msg must be read");
1991
1992 if (q->flags & I2C_AQ_COMB_SAME_ADDR && msgs[0].addr != msgs[1].addr)
1993 return i2c_quirk_error(adap, &msgs[0], "comb msg only to same addr");
1994
1995 if (i2c_quirk_exceeded(msgs[0].len, q->max_comb_1st_msg_len))
1996 return i2c_quirk_error(adap, &msgs[0], "msg too long");
1997
1998 if (i2c_quirk_exceeded(msgs[1].len, q->max_comb_2nd_msg_len))
1999 return i2c_quirk_error(adap, &msgs[1], "msg too long");
2000
2001 do_len_check = false;
2002 }
2003 }
2004
2005 if (i2c_quirk_exceeded(num, max_num))
2006 return i2c_quirk_error(adap, &msgs[0], "too many messages");
2007
2008 for (i = 0; i < num; i++) {
2009 u16 len = msgs[i].len;
2010
2011 if (msgs[i].flags & I2C_M_RD) {
2012 if (do_len_check && i2c_quirk_exceeded(len, q->max_read_len))
2013 return i2c_quirk_error(adap, &msgs[i], "msg too long");
2014 } else {
2015 if (do_len_check && i2c_quirk_exceeded(len, q->max_write_len))
2016 return i2c_quirk_error(adap, &msgs[i], "msg too long");
2017 }
2018 }
2019
2020 return 0;
2021}
2022
b37d2a3a
JD
2023/**
2024 * __i2c_transfer - unlocked flavor of i2c_transfer
2025 * @adap: Handle to I2C bus
2026 * @msgs: One or more messages to execute before STOP is issued to
2027 * terminate the operation; each message begins with a START.
2028 * @num: Number of messages to be executed.
2029 *
2030 * Returns negative errno, else the number of messages executed.
2031 *
2032 * Adapter lock must be held when calling this function. No debug logging
2033 * takes place. adap->algo->master_xfer existence isn't checked.
2034 */
2035int __i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
2036{
2037 unsigned long orig_jiffies;
2038 int ret, try;
2039
b7f62584
WS
2040 if (adap->quirks && i2c_check_for_quirks(adap, msgs, num))
2041 return -EOPNOTSUPP;
2042
d9a83d62
DH
2043 /* i2c_trace_msg gets enabled when tracepoint i2c_transfer gets
2044 * enabled. This is an efficient way of keeping the for-loop from
2045 * being executed when not needed.
2046 */
2047 if (static_key_false(&i2c_trace_msg)) {
2048 int i;
2049 for (i = 0; i < num; i++)
2050 if (msgs[i].flags & I2C_M_RD)
2051 trace_i2c_read(adap, &msgs[i], i);
2052 else
2053 trace_i2c_write(adap, &msgs[i], i);
2054 }
2055
b37d2a3a
JD
2056 /* Retry automatically on arbitration loss */
2057 orig_jiffies = jiffies;
2058 for (ret = 0, try = 0; try <= adap->retries; try++) {
2059 ret = adap->algo->master_xfer(adap, msgs, num);
2060 if (ret != -EAGAIN)
2061 break;
2062 if (time_after(jiffies, orig_jiffies + adap->timeout))
2063 break;
2064 }
2065
d9a83d62
DH
2066 if (static_key_false(&i2c_trace_msg)) {
2067 int i;
2068 for (i = 0; i < ret; i++)
2069 if (msgs[i].flags & I2C_M_RD)
2070 trace_i2c_reply(adap, &msgs[i], i);
2071 trace_i2c_result(adap, i, ret);
2072 }
2073
b37d2a3a
JD
2074 return ret;
2075}
2076EXPORT_SYMBOL(__i2c_transfer);
2077
a1cdedac
DB
2078/**
2079 * i2c_transfer - execute a single or combined I2C message
2080 * @adap: Handle to I2C bus
2081 * @msgs: One or more messages to execute before STOP is issued to
2082 * terminate the operation; each message begins with a START.
2083 * @num: Number of messages to be executed.
2084 *
2085 * Returns negative errno, else the number of messages executed.
2086 *
2087 * Note that there is no requirement that each message be sent to
2088 * the same slave address, although that is the most common model.
2089 */
09b8ce0a 2090int i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
1da177e4 2091{
b37d2a3a 2092 int ret;
1da177e4 2093
a1cdedac
DB
2094 /* REVISIT the fault reporting model here is weak:
2095 *
2096 * - When we get an error after receiving N bytes from a slave,
2097 * there is no way to report "N".
2098 *
2099 * - When we get a NAK after transmitting N bytes to a slave,
2100 * there is no way to report "N" ... or to let the master
2101 * continue executing the rest of this combined message, if
2102 * that's the appropriate response.
2103 *
2104 * - When for example "num" is two and we successfully complete
2105 * the first message but get an error part way through the
2106 * second, it's unclear whether that should be reported as
2107 * one (discarding status on the second message) or errno
2108 * (discarding status on the first one).
2109 */
2110
1da177e4
LT
2111 if (adap->algo->master_xfer) {
2112#ifdef DEBUG
2113 for (ret = 0; ret < num; ret++) {
2114 dev_dbg(&adap->dev, "master_xfer[%d] %c, addr=0x%02x, "
209d27c3
JD
2115 "len=%d%s\n", ret, (msgs[ret].flags & I2C_M_RD)
2116 ? 'R' : 'W', msgs[ret].addr, msgs[ret].len,
2117 (msgs[ret].flags & I2C_M_RECV_LEN) ? "+" : "");
1da177e4
LT
2118 }
2119#endif
2120
cea443a8 2121 if (in_atomic() || irqs_disabled()) {
fe61e07e 2122 ret = i2c_trylock_adapter(adap);
cea443a8
MR
2123 if (!ret)
2124 /* I2C activity is ongoing. */
2125 return -EAGAIN;
2126 } else {
fe61e07e 2127 i2c_lock_adapter(adap);
cea443a8
MR
2128 }
2129
b37d2a3a 2130 ret = __i2c_transfer(adap, msgs, num);
fe61e07e 2131 i2c_unlock_adapter(adap);
1da177e4
LT
2132
2133 return ret;
2134 } else {
2135 dev_dbg(&adap->dev, "I2C level transfers not supported\n");
24a5bb7b 2136 return -EOPNOTSUPP;
1da177e4
LT
2137 }
2138}
c0564606 2139EXPORT_SYMBOL(i2c_transfer);
1da177e4 2140
a1cdedac
DB
2141/**
2142 * i2c_master_send - issue a single I2C message in master transmit mode
2143 * @client: Handle to slave device
2144 * @buf: Data that will be written to the slave
0c43ea54 2145 * @count: How many bytes to write, must be less than 64k since msg.len is u16
a1cdedac
DB
2146 *
2147 * Returns negative errno, or else the number of bytes written.
2148 */
0cc43a18 2149int i2c_master_send(const struct i2c_client *client, const char *buf, int count)
1da177e4
LT
2150{
2151 int ret;
7225acf4 2152 struct i2c_adapter *adap = client->adapter;
1da177e4
LT
2153 struct i2c_msg msg;
2154
815f55f2
JD
2155 msg.addr = client->addr;
2156 msg.flags = client->flags & I2C_M_TEN;
2157 msg.len = count;
2158 msg.buf = (char *)buf;
438d6c2c 2159
815f55f2 2160 ret = i2c_transfer(adap, &msg, 1);
1da177e4 2161
834aa6f3
WS
2162 /*
2163 * If everything went ok (i.e. 1 msg transmitted), return #bytes
2164 * transmitted, else error code.
2165 */
815f55f2 2166 return (ret == 1) ? count : ret;
1da177e4 2167}
c0564606 2168EXPORT_SYMBOL(i2c_master_send);
1da177e4 2169
a1cdedac
DB
2170/**
2171 * i2c_master_recv - issue a single I2C message in master receive mode
2172 * @client: Handle to slave device
2173 * @buf: Where to store data read from slave
0c43ea54 2174 * @count: How many bytes to read, must be less than 64k since msg.len is u16
a1cdedac
DB
2175 *
2176 * Returns negative errno, or else the number of bytes read.
2177 */
0cc43a18 2178int i2c_master_recv(const struct i2c_client *client, char *buf, int count)
1da177e4 2179{
7225acf4 2180 struct i2c_adapter *adap = client->adapter;
1da177e4
LT
2181 struct i2c_msg msg;
2182 int ret;
815f55f2
JD
2183
2184 msg.addr = client->addr;
2185 msg.flags = client->flags & I2C_M_TEN;
2186 msg.flags |= I2C_M_RD;
2187 msg.len = count;
2188 msg.buf = buf;
2189
2190 ret = i2c_transfer(adap, &msg, 1);
2191
834aa6f3
WS
2192 /*
2193 * If everything went ok (i.e. 1 msg received), return #bytes received,
2194 * else error code.
2195 */
815f55f2 2196 return (ret == 1) ? count : ret;
1da177e4 2197}
c0564606 2198EXPORT_SYMBOL(i2c_master_recv);
1da177e4 2199
1da177e4
LT
2200/* ----------------------------------------------------
2201 * the i2c address scanning function
2202 * Will not work for 10-bit addresses!
2203 * ----------------------------------------------------
2204 */
1da177e4 2205
63e4e802
JD
2206/*
2207 * Legacy default probe function, mostly relevant for SMBus. The default
2208 * probe method is a quick write, but it is known to corrupt the 24RF08
2209 * EEPROMs due to a state machine bug, and could also irreversibly
2210 * write-protect some EEPROMs, so for address ranges 0x30-0x37 and 0x50-0x5f,
2211 * we use a short byte read instead. Also, some bus drivers don't implement
2212 * quick write, so we fallback to a byte read in that case too.
2213 * On x86, there is another special case for FSC hardware monitoring chips,
2214 * which want regular byte reads (address 0x73.) Fortunately, these are the
2215 * only known chips using this I2C address on PC hardware.
2216 * Returns 1 if probe succeeded, 0 if not.
2217 */
2218static int i2c_default_probe(struct i2c_adapter *adap, unsigned short addr)
2219{
2220 int err;
2221 union i2c_smbus_data dummy;
2222
2223#ifdef CONFIG_X86
2224 if (addr == 0x73 && (adap->class & I2C_CLASS_HWMON)
2225 && i2c_check_functionality(adap, I2C_FUNC_SMBUS_READ_BYTE_DATA))
2226 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2227 I2C_SMBUS_BYTE_DATA, &dummy);
2228 else
2229#endif
8031d79b
JD
2230 if (!((addr & ~0x07) == 0x30 || (addr & ~0x0f) == 0x50)
2231 && i2c_check_functionality(adap, I2C_FUNC_SMBUS_QUICK))
63e4e802
JD
2232 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_WRITE, 0,
2233 I2C_SMBUS_QUICK, NULL);
8031d79b
JD
2234 else if (i2c_check_functionality(adap, I2C_FUNC_SMBUS_READ_BYTE))
2235 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2236 I2C_SMBUS_BYTE, &dummy);
2237 else {
d63a9e85
AL
2238 dev_warn(&adap->dev, "No suitable probing method supported for address 0x%02X\n",
2239 addr);
8031d79b
JD
2240 err = -EOPNOTSUPP;
2241 }
63e4e802
JD
2242
2243 return err >= 0;
2244}
2245
ccfbbd08 2246static int i2c_detect_address(struct i2c_client *temp_client,
4735c98f
JD
2247 struct i2c_driver *driver)
2248{
2249 struct i2c_board_info info;
2250 struct i2c_adapter *adapter = temp_client->adapter;
2251 int addr = temp_client->addr;
2252 int err;
2253
2254 /* Make sure the address is valid */
656b8761
JD
2255 err = i2c_check_addr_validity(addr);
2256 if (err) {
4735c98f
JD
2257 dev_warn(&adapter->dev, "Invalid probe address 0x%02x\n",
2258 addr);
656b8761 2259 return err;
4735c98f
JD
2260 }
2261
2262 /* Skip if already in use */
3b5f794b 2263 if (i2c_check_addr_busy(adapter, addr))
4735c98f
JD
2264 return 0;
2265
ccfbbd08 2266 /* Make sure there is something at this address */
63e4e802
JD
2267 if (!i2c_default_probe(adapter, addr))
2268 return 0;
4735c98f
JD
2269
2270 /* Finally call the custom detection function */
2271 memset(&info, 0, sizeof(struct i2c_board_info));
2272 info.addr = addr;
310ec792 2273 err = driver->detect(temp_client, &info);
4735c98f
JD
2274 if (err) {
2275 /* -ENODEV is returned if the detection fails. We catch it
2276 here as this isn't an error. */
2277 return err == -ENODEV ? 0 : err;
2278 }
2279
2280 /* Consistency check */
2281 if (info.type[0] == '\0') {
2282 dev_err(&adapter->dev, "%s detection function provided "
2283 "no name for 0x%x\n", driver->driver.name,
2284 addr);
2285 } else {
2286 struct i2c_client *client;
2287
2288 /* Detection succeeded, instantiate the device */
0c176170
WS
2289 if (adapter->class & I2C_CLASS_DEPRECATED)
2290 dev_warn(&adapter->dev,
2291 "This adapter will soon drop class based instantiation of devices. "
2292 "Please make sure client 0x%02x gets instantiated by other means. "
2293 "Check 'Documentation/i2c/instantiating-devices' for details.\n",
2294 info.addr);
2295
4735c98f
JD
2296 dev_dbg(&adapter->dev, "Creating %s at 0x%02x\n",
2297 info.type, info.addr);
2298 client = i2c_new_device(adapter, &info);
2299 if (client)
2300 list_add_tail(&client->detected, &driver->clients);
2301 else
2302 dev_err(&adapter->dev, "Failed creating %s at 0x%02x\n",
2303 info.type, info.addr);
2304 }
2305 return 0;
2306}
2307
2308static int i2c_detect(struct i2c_adapter *adapter, struct i2c_driver *driver)
2309{
c3813d6a 2310 const unsigned short *address_list;
4735c98f
JD
2311 struct i2c_client *temp_client;
2312 int i, err = 0;
2313 int adap_id = i2c_adapter_id(adapter);
2314
c3813d6a
JD
2315 address_list = driver->address_list;
2316 if (!driver->detect || !address_list)
4735c98f
JD
2317 return 0;
2318
45552272
WS
2319 /* Warn that the adapter lost class based instantiation */
2320 if (adapter->class == I2C_CLASS_DEPRECATED) {
2321 dev_dbg(&adapter->dev,
2322 "This adapter dropped support for I2C classes and "
2323 "won't auto-detect %s devices anymore. If you need it, check "
2324 "'Documentation/i2c/instantiating-devices' for alternatives.\n",
2325 driver->driver.name);
2326 return 0;
2327 }
2328
51b54ba9
JD
2329 /* Stop here if the classes do not match */
2330 if (!(adapter->class & driver->class))
2331 return 0;
2332
4735c98f
JD
2333 /* Set up a temporary client to help detect callback */
2334 temp_client = kzalloc(sizeof(struct i2c_client), GFP_KERNEL);
2335 if (!temp_client)
2336 return -ENOMEM;
2337 temp_client->adapter = adapter;
2338
c3813d6a 2339 for (i = 0; address_list[i] != I2C_CLIENT_END; i += 1) {
4735c98f 2340 dev_dbg(&adapter->dev, "found normal entry for adapter %d, "
c3813d6a
JD
2341 "addr 0x%02x\n", adap_id, address_list[i]);
2342 temp_client->addr = address_list[i];
ccfbbd08 2343 err = i2c_detect_address(temp_client, driver);
51b54ba9
JD
2344 if (unlikely(err))
2345 break;
4735c98f
JD
2346 }
2347
4735c98f
JD
2348 kfree(temp_client);
2349 return err;
2350}
2351
d44f19d5
JD
2352int i2c_probe_func_quick_read(struct i2c_adapter *adap, unsigned short addr)
2353{
2354 return i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2355 I2C_SMBUS_QUICK, NULL) >= 0;
2356}
2357EXPORT_SYMBOL_GPL(i2c_probe_func_quick_read);
2358
12b5053a
JD
2359struct i2c_client *
2360i2c_new_probed_device(struct i2c_adapter *adap,
2361 struct i2c_board_info *info,
9a94241a
JD
2362 unsigned short const *addr_list,
2363 int (*probe)(struct i2c_adapter *, unsigned short addr))
12b5053a
JD
2364{
2365 int i;
2366
8031d79b 2367 if (!probe)
9a94241a 2368 probe = i2c_default_probe;
12b5053a 2369
12b5053a
JD
2370 for (i = 0; addr_list[i] != I2C_CLIENT_END; i++) {
2371 /* Check address validity */
656b8761 2372 if (i2c_check_addr_validity(addr_list[i]) < 0) {
12b5053a
JD
2373 dev_warn(&adap->dev, "Invalid 7-bit address "
2374 "0x%02x\n", addr_list[i]);
2375 continue;
2376 }
2377
2378 /* Check address availability */
3b5f794b 2379 if (i2c_check_addr_busy(adap, addr_list[i])) {
12b5053a
JD
2380 dev_dbg(&adap->dev, "Address 0x%02x already in "
2381 "use, not probing\n", addr_list[i]);
2382 continue;
2383 }
2384
63e4e802 2385 /* Test address responsiveness */
9a94241a 2386 if (probe(adap, addr_list[i]))
63e4e802 2387 break;
12b5053a 2388 }
12b5053a
JD
2389
2390 if (addr_list[i] == I2C_CLIENT_END) {
2391 dev_dbg(&adap->dev, "Probing failed, no device found\n");
2392 return NULL;
2393 }
2394
2395 info->addr = addr_list[i];
2396 return i2c_new_device(adap, info);
2397}
2398EXPORT_SYMBOL_GPL(i2c_new_probed_device);
2399
d735b34d 2400struct i2c_adapter *i2c_get_adapter(int nr)
1da177e4 2401{
1da177e4 2402 struct i2c_adapter *adapter;
438d6c2c 2403
caada32a 2404 mutex_lock(&core_lock);
d735b34d 2405 adapter = idr_find(&i2c_adapter_idr, nr);
a0920e10
MH
2406 if (adapter && !try_module_get(adapter->owner))
2407 adapter = NULL;
2408
caada32a 2409 mutex_unlock(&core_lock);
a0920e10 2410 return adapter;
1da177e4 2411}
c0564606 2412EXPORT_SYMBOL(i2c_get_adapter);
1da177e4
LT
2413
2414void i2c_put_adapter(struct i2c_adapter *adap)
2415{
c66c4cc0
SH
2416 if (adap)
2417 module_put(adap->owner);
1da177e4 2418}
c0564606 2419EXPORT_SYMBOL(i2c_put_adapter);
1da177e4
LT
2420
2421/* The SMBus parts */
2422
438d6c2c 2423#define POLY (0x1070U << 3)
09b8ce0a 2424static u8 crc8(u16 data)
1da177e4
LT
2425{
2426 int i;
438d6c2c 2427
7225acf4 2428 for (i = 0; i < 8; i++) {
438d6c2c 2429 if (data & 0x8000)
1da177e4
LT
2430 data = data ^ POLY;
2431 data = data << 1;
2432 }
2433 return (u8)(data >> 8);
2434}
2435
421ef47b
JD
2436/* Incremental CRC8 over count bytes in the array pointed to by p */
2437static u8 i2c_smbus_pec(u8 crc, u8 *p, size_t count)
1da177e4
LT
2438{
2439 int i;
2440
7225acf4 2441 for (i = 0; i < count; i++)
421ef47b 2442 crc = crc8((crc ^ p[i]) << 8);
1da177e4
LT
2443 return crc;
2444}
2445
421ef47b
JD
2446/* Assume a 7-bit address, which is reasonable for SMBus */
2447static u8 i2c_smbus_msg_pec(u8 pec, struct i2c_msg *msg)
1da177e4 2448{
421ef47b
JD
2449 /* The address will be sent first */
2450 u8 addr = (msg->addr << 1) | !!(msg->flags & I2C_M_RD);
2451 pec = i2c_smbus_pec(pec, &addr, 1);
2452
2453 /* The data buffer follows */
2454 return i2c_smbus_pec(pec, msg->buf, msg->len);
1da177e4
LT
2455}
2456
421ef47b
JD
2457/* Used for write only transactions */
2458static inline void i2c_smbus_add_pec(struct i2c_msg *msg)
1da177e4 2459{
421ef47b
JD
2460 msg->buf[msg->len] = i2c_smbus_msg_pec(0, msg);
2461 msg->len++;
1da177e4
LT
2462}
2463
421ef47b
JD
2464/* Return <0 on CRC error
2465 If there was a write before this read (most cases) we need to take the
2466 partial CRC from the write part into account.
2467 Note that this function does modify the message (we need to decrease the
2468 message length to hide the CRC byte from the caller). */
2469static int i2c_smbus_check_pec(u8 cpec, struct i2c_msg *msg)
1da177e4 2470{
421ef47b
JD
2471 u8 rpec = msg->buf[--msg->len];
2472 cpec = i2c_smbus_msg_pec(cpec, msg);
1da177e4 2473
1da177e4
LT
2474 if (rpec != cpec) {
2475 pr_debug("i2c-core: Bad PEC 0x%02x vs. 0x%02x\n",
2476 rpec, cpec);
24a5bb7b 2477 return -EBADMSG;
1da177e4 2478 }
438d6c2c 2479 return 0;
1da177e4
LT
2480}
2481
a1cdedac
DB
2482/**
2483 * i2c_smbus_read_byte - SMBus "receive byte" protocol
2484 * @client: Handle to slave device
2485 *
2486 * This executes the SMBus "receive byte" protocol, returning negative errno
2487 * else the byte received from the device.
2488 */
0cc43a18 2489s32 i2c_smbus_read_byte(const struct i2c_client *client)
1da177e4
LT
2490{
2491 union i2c_smbus_data data;
24a5bb7b
DB
2492 int status;
2493
2494 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2495 I2C_SMBUS_READ, 0,
2496 I2C_SMBUS_BYTE, &data);
2497 return (status < 0) ? status : data.byte;
1da177e4 2498}
c0564606 2499EXPORT_SYMBOL(i2c_smbus_read_byte);
1da177e4 2500
a1cdedac
DB
2501/**
2502 * i2c_smbus_write_byte - SMBus "send byte" protocol
2503 * @client: Handle to slave device
2504 * @value: Byte to be sent
2505 *
2506 * This executes the SMBus "send byte" protocol, returning negative errno
2507 * else zero on success.
2508 */
0cc43a18 2509s32 i2c_smbus_write_byte(const struct i2c_client *client, u8 value)
1da177e4 2510{
7225acf4 2511 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
421ef47b 2512 I2C_SMBUS_WRITE, value, I2C_SMBUS_BYTE, NULL);
1da177e4 2513}
c0564606 2514EXPORT_SYMBOL(i2c_smbus_write_byte);
1da177e4 2515
a1cdedac
DB
2516/**
2517 * i2c_smbus_read_byte_data - SMBus "read byte" protocol
2518 * @client: Handle to slave device
2519 * @command: Byte interpreted by slave
2520 *
2521 * This executes the SMBus "read byte" protocol, returning negative errno
2522 * else a data byte received from the device.
2523 */
0cc43a18 2524s32 i2c_smbus_read_byte_data(const struct i2c_client *client, u8 command)
1da177e4
LT
2525{
2526 union i2c_smbus_data data;
24a5bb7b
DB
2527 int status;
2528
2529 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2530 I2C_SMBUS_READ, command,
2531 I2C_SMBUS_BYTE_DATA, &data);
2532 return (status < 0) ? status : data.byte;
1da177e4 2533}
c0564606 2534EXPORT_SYMBOL(i2c_smbus_read_byte_data);
1da177e4 2535
a1cdedac
DB
2536/**
2537 * i2c_smbus_write_byte_data - SMBus "write byte" protocol
2538 * @client: Handle to slave device
2539 * @command: Byte interpreted by slave
2540 * @value: Byte being written
2541 *
2542 * This executes the SMBus "write byte" protocol, returning negative errno
2543 * else zero on success.
2544 */
0cc43a18
JD
2545s32 i2c_smbus_write_byte_data(const struct i2c_client *client, u8 command,
2546 u8 value)
1da177e4
LT
2547{
2548 union i2c_smbus_data data;
2549 data.byte = value;
7225acf4
FH
2550 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2551 I2C_SMBUS_WRITE, command,
2552 I2C_SMBUS_BYTE_DATA, &data);
1da177e4 2553}
c0564606 2554EXPORT_SYMBOL(i2c_smbus_write_byte_data);
1da177e4 2555
a1cdedac
DB
2556/**
2557 * i2c_smbus_read_word_data - SMBus "read word" protocol
2558 * @client: Handle to slave device
2559 * @command: Byte interpreted by slave
2560 *
2561 * This executes the SMBus "read word" protocol, returning negative errno
2562 * else a 16-bit unsigned "word" received from the device.
2563 */
0cc43a18 2564s32 i2c_smbus_read_word_data(const struct i2c_client *client, u8 command)
1da177e4
LT
2565{
2566 union i2c_smbus_data data;
24a5bb7b
DB
2567 int status;
2568
2569 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2570 I2C_SMBUS_READ, command,
2571 I2C_SMBUS_WORD_DATA, &data);
2572 return (status < 0) ? status : data.word;
1da177e4 2573}
c0564606 2574EXPORT_SYMBOL(i2c_smbus_read_word_data);
1da177e4 2575
a1cdedac
DB
2576/**
2577 * i2c_smbus_write_word_data - SMBus "write word" protocol
2578 * @client: Handle to slave device
2579 * @command: Byte interpreted by slave
2580 * @value: 16-bit "word" being written
2581 *
2582 * This executes the SMBus "write word" protocol, returning negative errno
2583 * else zero on success.
2584 */
0cc43a18
JD
2585s32 i2c_smbus_write_word_data(const struct i2c_client *client, u8 command,
2586 u16 value)
1da177e4
LT
2587{
2588 union i2c_smbus_data data;
2589 data.word = value;
7225acf4
FH
2590 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2591 I2C_SMBUS_WRITE, command,
2592 I2C_SMBUS_WORD_DATA, &data);
1da177e4 2593}
c0564606 2594EXPORT_SYMBOL(i2c_smbus_write_word_data);
1da177e4 2595
a64ec07d 2596/**
a1cdedac 2597 * i2c_smbus_read_block_data - SMBus "block read" protocol
a64ec07d 2598 * @client: Handle to slave device
a1cdedac 2599 * @command: Byte interpreted by slave
a64ec07d
DB
2600 * @values: Byte array into which data will be read; big enough to hold
2601 * the data returned by the slave. SMBus allows at most 32 bytes.
2602 *
a1cdedac
DB
2603 * This executes the SMBus "block read" protocol, returning negative errno
2604 * else the number of data bytes in the slave's response.
a64ec07d
DB
2605 *
2606 * Note that using this function requires that the client's adapter support
2607 * the I2C_FUNC_SMBUS_READ_BLOCK_DATA functionality. Not all adapter drivers
2608 * support this; its emulation through I2C messaging relies on a specific
2609 * mechanism (I2C_M_RECV_LEN) which may not be implemented.
2610 */
0cc43a18 2611s32 i2c_smbus_read_block_data(const struct i2c_client *client, u8 command,
b86a1bc8
JD
2612 u8 *values)
2613{
2614 union i2c_smbus_data data;
24a5bb7b 2615 int status;
b86a1bc8 2616
24a5bb7b
DB
2617 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2618 I2C_SMBUS_READ, command,
2619 I2C_SMBUS_BLOCK_DATA, &data);
2620 if (status)
2621 return status;
b86a1bc8
JD
2622
2623 memcpy(values, &data.block[1], data.block[0]);
2624 return data.block[0];
2625}
2626EXPORT_SYMBOL(i2c_smbus_read_block_data);
2627
a1cdedac
DB
2628/**
2629 * i2c_smbus_write_block_data - SMBus "block write" protocol
2630 * @client: Handle to slave device
2631 * @command: Byte interpreted by slave
2632 * @length: Size of data block; SMBus allows at most 32 bytes
2633 * @values: Byte array which will be written.
2634 *
2635 * This executes the SMBus "block write" protocol, returning negative errno
2636 * else zero on success.
2637 */
0cc43a18 2638s32 i2c_smbus_write_block_data(const struct i2c_client *client, u8 command,
46f5ed75 2639 u8 length, const u8 *values)
1da177e4
LT
2640{
2641 union i2c_smbus_data data;
7656032b 2642
1da177e4
LT
2643 if (length > I2C_SMBUS_BLOCK_MAX)
2644 length = I2C_SMBUS_BLOCK_MAX;
1da177e4 2645 data.block[0] = length;
7656032b 2646 memcpy(&data.block[1], values, length);
7225acf4
FH
2647 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2648 I2C_SMBUS_WRITE, command,
2649 I2C_SMBUS_BLOCK_DATA, &data);
1da177e4 2650}
c0564606 2651EXPORT_SYMBOL(i2c_smbus_write_block_data);
1da177e4
LT
2652
2653/* Returns the number of read bytes */
0cc43a18 2654s32 i2c_smbus_read_i2c_block_data(const struct i2c_client *client, u8 command,
4b2643d7 2655 u8 length, u8 *values)
1da177e4
LT
2656{
2657 union i2c_smbus_data data;
24a5bb7b 2658 int status;
7656032b 2659
4b2643d7
JD
2660 if (length > I2C_SMBUS_BLOCK_MAX)
2661 length = I2C_SMBUS_BLOCK_MAX;
2662 data.block[0] = length;
24a5bb7b
DB
2663 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2664 I2C_SMBUS_READ, command,
2665 I2C_SMBUS_I2C_BLOCK_DATA, &data);
2666 if (status < 0)
2667 return status;
7656032b
JD
2668
2669 memcpy(values, &data.block[1], data.block[0]);
2670 return data.block[0];
1da177e4 2671}
c0564606 2672EXPORT_SYMBOL(i2c_smbus_read_i2c_block_data);
1da177e4 2673
0cc43a18 2674s32 i2c_smbus_write_i2c_block_data(const struct i2c_client *client, u8 command,
46f5ed75 2675 u8 length, const u8 *values)
21bbd691
JD
2676{
2677 union i2c_smbus_data data;
2678
2679 if (length > I2C_SMBUS_BLOCK_MAX)
2680 length = I2C_SMBUS_BLOCK_MAX;
2681 data.block[0] = length;
2682 memcpy(data.block + 1, values, length);
2683 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2684 I2C_SMBUS_WRITE, command,
2685 I2C_SMBUS_I2C_BLOCK_DATA, &data);
2686}
c0564606 2687EXPORT_SYMBOL(i2c_smbus_write_i2c_block_data);
21bbd691 2688
438d6c2c 2689/* Simulate a SMBus command using the i2c protocol
1da177e4 2690 No checking of parameters is done! */
7225acf4
FH
2691static s32 i2c_smbus_xfer_emulated(struct i2c_adapter *adapter, u16 addr,
2692 unsigned short flags,
2693 char read_write, u8 command, int size,
2694 union i2c_smbus_data *data)
1da177e4
LT
2695{
2696 /* So we need to generate a series of msgs. In the case of writing, we
2697 need to use only one message; when reading, we need two. We initialize
2698 most things with sane defaults, to keep the code below somewhat
2699 simpler. */
5c50d188
HI
2700 unsigned char msgbuf0[I2C_SMBUS_BLOCK_MAX+3];
2701 unsigned char msgbuf1[I2C_SMBUS_BLOCK_MAX+2];
7225acf4 2702 int num = read_write == I2C_SMBUS_READ ? 2 : 1;
1da177e4 2703 int i;
421ef47b 2704 u8 partial_pec = 0;
24a5bb7b 2705 int status;
230da094
S
2706 struct i2c_msg msg[2] = {
2707 {
2708 .addr = addr,
2709 .flags = flags,
2710 .len = 1,
2711 .buf = msgbuf0,
2712 }, {
2713 .addr = addr,
2714 .flags = flags | I2C_M_RD,
2715 .len = 0,
2716 .buf = msgbuf1,
2717 },
2718 };
1da177e4
LT
2719
2720 msgbuf0[0] = command;
7225acf4 2721 switch (size) {
1da177e4
LT
2722 case I2C_SMBUS_QUICK:
2723 msg[0].len = 0;
2724 /* Special case: The read/write field is used as data */
f29d2e02
RK
2725 msg[0].flags = flags | (read_write == I2C_SMBUS_READ ?
2726 I2C_M_RD : 0);
1da177e4
LT
2727 num = 1;
2728 break;
2729 case I2C_SMBUS_BYTE:
2730 if (read_write == I2C_SMBUS_READ) {
2731 /* Special case: only a read! */
2732 msg[0].flags = I2C_M_RD | flags;
2733 num = 1;
2734 }
2735 break;
2736 case I2C_SMBUS_BYTE_DATA:
2737 if (read_write == I2C_SMBUS_READ)
2738 msg[1].len = 1;
2739 else {
2740 msg[0].len = 2;
2741 msgbuf0[1] = data->byte;
2742 }
2743 break;
2744 case I2C_SMBUS_WORD_DATA:
2745 if (read_write == I2C_SMBUS_READ)
2746 msg[1].len = 2;
2747 else {
7225acf4 2748 msg[0].len = 3;
1da177e4 2749 msgbuf0[1] = data->word & 0xff;
7eff82c8 2750 msgbuf0[2] = data->word >> 8;
1da177e4
LT
2751 }
2752 break;
2753 case I2C_SMBUS_PROC_CALL:
2754 num = 2; /* Special case */
2755 read_write = I2C_SMBUS_READ;
2756 msg[0].len = 3;
2757 msg[1].len = 2;
2758 msgbuf0[1] = data->word & 0xff;
7eff82c8 2759 msgbuf0[2] = data->word >> 8;
1da177e4
LT
2760 break;
2761 case I2C_SMBUS_BLOCK_DATA:
1da177e4 2762 if (read_write == I2C_SMBUS_READ) {
209d27c3
JD
2763 msg[1].flags |= I2C_M_RECV_LEN;
2764 msg[1].len = 1; /* block length will be added by
2765 the underlying bus driver */
1da177e4
LT
2766 } else {
2767 msg[0].len = data->block[0] + 2;
2768 if (msg[0].len > I2C_SMBUS_BLOCK_MAX + 2) {
24a5bb7b
DB
2769 dev_err(&adapter->dev,
2770 "Invalid block write size %d\n",
2771 data->block[0]);
2772 return -EINVAL;
1da177e4 2773 }
5c50d188 2774 for (i = 1; i < msg[0].len; i++)
1da177e4
LT
2775 msgbuf0[i] = data->block[i-1];
2776 }
2777 break;
2778 case I2C_SMBUS_BLOCK_PROC_CALL:
209d27c3
JD
2779 num = 2; /* Another special case */
2780 read_write = I2C_SMBUS_READ;
2781 if (data->block[0] > I2C_SMBUS_BLOCK_MAX) {
24a5bb7b
DB
2782 dev_err(&adapter->dev,
2783 "Invalid block write size %d\n",
209d27c3 2784 data->block[0]);
24a5bb7b 2785 return -EINVAL;
209d27c3
JD
2786 }
2787 msg[0].len = data->block[0] + 2;
2788 for (i = 1; i < msg[0].len; i++)
2789 msgbuf0[i] = data->block[i-1];
2790 msg[1].flags |= I2C_M_RECV_LEN;
2791 msg[1].len = 1; /* block length will be added by
2792 the underlying bus driver */
2793 break;
1da177e4
LT
2794 case I2C_SMBUS_I2C_BLOCK_DATA:
2795 if (read_write == I2C_SMBUS_READ) {
4b2643d7 2796 msg[1].len = data->block[0];
1da177e4
LT
2797 } else {
2798 msg[0].len = data->block[0] + 1;
30dac746 2799 if (msg[0].len > I2C_SMBUS_BLOCK_MAX + 1) {
24a5bb7b
DB
2800 dev_err(&adapter->dev,
2801 "Invalid block write size %d\n",
2802 data->block[0]);
2803 return -EINVAL;
1da177e4
LT
2804 }
2805 for (i = 1; i <= data->block[0]; i++)
2806 msgbuf0[i] = data->block[i];
2807 }
2808 break;
2809 default:
24a5bb7b
DB
2810 dev_err(&adapter->dev, "Unsupported transaction %d\n", size);
2811 return -EOPNOTSUPP;
1da177e4
LT
2812 }
2813
421ef47b
JD
2814 i = ((flags & I2C_CLIENT_PEC) && size != I2C_SMBUS_QUICK
2815 && size != I2C_SMBUS_I2C_BLOCK_DATA);
2816 if (i) {
2817 /* Compute PEC if first message is a write */
2818 if (!(msg[0].flags & I2C_M_RD)) {
438d6c2c 2819 if (num == 1) /* Write only */
421ef47b
JD
2820 i2c_smbus_add_pec(&msg[0]);
2821 else /* Write followed by read */
2822 partial_pec = i2c_smbus_msg_pec(0, &msg[0]);
2823 }
2824 /* Ask for PEC if last message is a read */
2825 if (msg[num-1].flags & I2C_M_RD)
438d6c2c 2826 msg[num-1].len++;
421ef47b
JD
2827 }
2828
24a5bb7b
DB
2829 status = i2c_transfer(adapter, msg, num);
2830 if (status < 0)
2831 return status;
1da177e4 2832
421ef47b
JD
2833 /* Check PEC if last message is a read */
2834 if (i && (msg[num-1].flags & I2C_M_RD)) {
24a5bb7b
DB
2835 status = i2c_smbus_check_pec(partial_pec, &msg[num-1]);
2836 if (status < 0)
2837 return status;
421ef47b
JD
2838 }
2839
1da177e4 2840 if (read_write == I2C_SMBUS_READ)
7225acf4
FH
2841 switch (size) {
2842 case I2C_SMBUS_BYTE:
2843 data->byte = msgbuf0[0];
2844 break;
2845 case I2C_SMBUS_BYTE_DATA:
2846 data->byte = msgbuf1[0];
2847 break;
2848 case I2C_SMBUS_WORD_DATA:
2849 case I2C_SMBUS_PROC_CALL:
2850 data->word = msgbuf1[0] | (msgbuf1[1] << 8);
2851 break;
2852 case I2C_SMBUS_I2C_BLOCK_DATA:
2853 for (i = 0; i < data->block[0]; i++)
2854 data->block[i+1] = msgbuf1[i];
2855 break;
2856 case I2C_SMBUS_BLOCK_DATA:
2857 case I2C_SMBUS_BLOCK_PROC_CALL:
2858 for (i = 0; i < msgbuf1[0] + 1; i++)
2859 data->block[i] = msgbuf1[i];
2860 break;
1da177e4
LT
2861 }
2862 return 0;
2863}
2864
a1cdedac
DB
2865/**
2866 * i2c_smbus_xfer - execute SMBus protocol operations
2867 * @adapter: Handle to I2C bus
2868 * @addr: Address of SMBus slave on that bus
2869 * @flags: I2C_CLIENT_* flags (usually zero or I2C_CLIENT_PEC)
2870 * @read_write: I2C_SMBUS_READ or I2C_SMBUS_WRITE
2871 * @command: Byte interpreted by slave, for protocols which use such bytes
2872 * @protocol: SMBus protocol operation to execute, such as I2C_SMBUS_PROC_CALL
2873 * @data: Data to be read or written
2874 *
2875 * This executes an SMBus protocol operation, and returns a negative
2876 * errno code else zero on success.
2877 */
09b8ce0a 2878s32 i2c_smbus_xfer(struct i2c_adapter *adapter, u16 addr, unsigned short flags,
a1cdedac 2879 char read_write, u8 command, int protocol,
09b8ce0a 2880 union i2c_smbus_data *data)
1da177e4 2881{
66b650f0
CW
2882 unsigned long orig_jiffies;
2883 int try;
1da177e4 2884 s32 res;
1da177e4 2885
8a325997
DH
2886 /* If enabled, the following two tracepoints are conditional on
2887 * read_write and protocol.
2888 */
2889 trace_smbus_write(adapter, addr, flags, read_write,
2890 command, protocol, data);
2891 trace_smbus_read(adapter, addr, flags, read_write,
2892 command, protocol);
2893
d47726c5 2894 flags &= I2C_M_TEN | I2C_CLIENT_PEC | I2C_CLIENT_SCCB;
1da177e4
LT
2895
2896 if (adapter->algo->smbus_xfer) {
fe61e07e 2897 i2c_lock_adapter(adapter);
66b650f0
CW
2898
2899 /* Retry automatically on arbitration loss */
2900 orig_jiffies = jiffies;
2901 for (res = 0, try = 0; try <= adapter->retries; try++) {
2902 res = adapter->algo->smbus_xfer(adapter, addr, flags,
2903 read_write, command,
2904 protocol, data);
2905 if (res != -EAGAIN)
2906 break;
2907 if (time_after(jiffies,
2908 orig_jiffies + adapter->timeout))
2909 break;
2910 }
fe61e07e 2911 i2c_unlock_adapter(adapter);
1da177e4 2912
72fc2c7f 2913 if (res != -EOPNOTSUPP || !adapter->algo->master_xfer)
8a325997 2914 goto trace;
72fc2c7f
LP
2915 /*
2916 * Fall back to i2c_smbus_xfer_emulated if the adapter doesn't
2917 * implement native support for the SMBus operation.
2918 */
2919 }
2920
8a325997
DH
2921 res = i2c_smbus_xfer_emulated(adapter, addr, flags, read_write,
2922 command, protocol, data);
2923
2924trace:
2925 /* If enabled, the reply tracepoint is conditional on read_write. */
2926 trace_smbus_reply(adapter, addr, flags, read_write,
2927 command, protocol, data);
2928 trace_smbus_result(adapter, addr, flags, read_write,
2929 command, protocol, res);
2930
2931 return res;
1da177e4 2932}
1da177e4 2933EXPORT_SYMBOL(i2c_smbus_xfer);
1da177e4 2934
d5fd120e 2935#if IS_ENABLED(CONFIG_I2C_SLAVE)
4b1acc43
WS
2936int i2c_slave_register(struct i2c_client *client, i2c_slave_cb_t slave_cb)
2937{
2938 int ret;
2939
0c7cab96
WS
2940 if (!client || !slave_cb) {
2941 WARN(1, "insufficent data\n");
4b1acc43 2942 return -EINVAL;
0c7cab96 2943 }
4b1acc43
WS
2944
2945 if (!(client->flags & I2C_CLIENT_TEN)) {
2946 /* Enforce stricter address checking */
2947 ret = i2c_check_addr_validity(client->addr);
0c7cab96
WS
2948 if (ret) {
2949 dev_err(&client->dev, "%s: invalid address\n", __func__);
4b1acc43 2950 return ret;
0c7cab96 2951 }
4b1acc43
WS
2952 }
2953
0c7cab96
WS
2954 if (!client->adapter->algo->reg_slave) {
2955 dev_err(&client->dev, "%s: not supported by adapter\n", __func__);
4b1acc43 2956 return -EOPNOTSUPP;
0c7cab96 2957 }
4b1acc43
WS
2958
2959 client->slave_cb = slave_cb;
2960
2961 i2c_lock_adapter(client->adapter);
2962 ret = client->adapter->algo->reg_slave(client);
2963 i2c_unlock_adapter(client->adapter);
2964
0c7cab96 2965 if (ret) {
4b1acc43 2966 client->slave_cb = NULL;
0c7cab96
WS
2967 dev_err(&client->dev, "%s: adapter returned error %d\n", __func__, ret);
2968 }
4b1acc43
WS
2969
2970 return ret;
2971}
2972EXPORT_SYMBOL_GPL(i2c_slave_register);
2973
2974int i2c_slave_unregister(struct i2c_client *client)
2975{
2976 int ret;
2977
0c7cab96
WS
2978 if (!client->adapter->algo->unreg_slave) {
2979 dev_err(&client->dev, "%s: not supported by adapter\n", __func__);
4b1acc43 2980 return -EOPNOTSUPP;
0c7cab96 2981 }
4b1acc43
WS
2982
2983 i2c_lock_adapter(client->adapter);
2984 ret = client->adapter->algo->unreg_slave(client);
2985 i2c_unlock_adapter(client->adapter);
2986
2987 if (ret == 0)
2988 client->slave_cb = NULL;
0c7cab96
WS
2989 else
2990 dev_err(&client->dev, "%s: adapter returned error %d\n", __func__, ret);
4b1acc43
WS
2991
2992 return ret;
2993}
2994EXPORT_SYMBOL_GPL(i2c_slave_unregister);
d5fd120e 2995#endif
4b1acc43 2996
1da177e4
LT
2997MODULE_AUTHOR("Simon G. Vogl <simon@tk.uni-linz.ac.at>");
2998MODULE_DESCRIPTION("I2C-Bus main module");
2999MODULE_LICENSE("GPL");
This page took 1.001323 seconds and 5 git commands to generate.