blob: 8b64cf38beac2f1ada5b500fc2961e5a57459185 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/* 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
Wolfram Sangca1f8da2014-11-04 23:46:27 +010013 GNU General Public License for more details. */
Linus Torvalds1da177e2005-04-16 15:20:36 -070014/* ------------------------------------------------------------------------- */
15
Jan Engelhardt96de0e22007-10-19 23:21:04 +020016/* With some changes from Kyösti Mälkki <kmalkki@cc.hut.fi>.
Linus Torvalds1da177e2005-04-16 15:20:36 -070017 All SMBus-related things are written by Frodo Looijaard <frodol@dds.nl>
Jean Delvare421ef472005-10-26 21:28:55 +020018 SMBus 2.0 support by Mark Studebaker <mdsxyz123@yahoo.com> and
Jean Delvare7c81c602014-01-29 20:40:08 +010019 Jean Delvare <jdelvare@suse.de>
Michael Lawnick08263742010-08-11 18:21:02 +020020 Mux support by Rodolfo Giometti <giometti@enneenne.com> and
Wolfram Sang687b81d2013-07-11 12:56:15 +010021 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>
Wolfram Sang17f4a5c2014-09-22 19:41:00 +020025 I2C ACPI code Copyright (C) 2014 Intel Corp
26 Author: Lan Tianyu <tianyu.lan@intel.com>
Wolfram Sang4b1acc42014-11-18 17:04:53 +010027 I2C slave support (c) 2014 by Wolfram Sang <wsa@sang-engineering.com>
Wolfram Sang687b81d2013-07-11 12:56:15 +010028 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070029
Linus Torvalds1da177e2005-04-16 15:20:36 -070030#include <linux/module.h>
31#include <linux/kernel.h>
Viresh Kumar5f9296b2012-02-28 18:26:31 +053032#include <linux/delay.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070033#include <linux/errno.h>
Viresh Kumar5f9296b2012-02-28 18:26:31 +053034#include <linux/gpio.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070035#include <linux/slab.h>
36#include <linux/i2c.h>
37#include <linux/init.h>
38#include <linux/idr.h>
Arjan van de Venb3585e42006-01-11 10:50:26 +010039#include <linux/mutex.h>
Wolfram Sang687b81d2013-07-11 12:56:15 +010040#include <linux/of.h>
Grant Likely959e85f2010-06-08 07:48:19 -060041#include <linux/of_device.h>
Wolfram Sang687b81d2013-07-11 12:56:15 +010042#include <linux/of_irq.h>
Sylwester Nawrocki86be4082014-06-18 17:29:32 +020043#include <linux/clk/clk-conf.h>
Jean Delvareb8d6f452007-02-13 22:09:00 +010044#include <linux/completion.h>
Mike Rapoportcea443a2008-01-27 18:14:50 +010045#include <linux/hardirq.h>
46#include <linux/irqflags.h>
Rodolfo Giomettif18c41d2009-06-19 16:58:20 +020047#include <linux/rwsem.h>
Mark Brown6de468a2010-03-02 12:23:46 +010048#include <linux/pm_runtime.h>
Ulf Hanssonf48c7672014-09-29 13:58:47 +020049#include <linux/pm_domain.h>
Mika Westerberg907ddf82012-11-23 12:23:40 +010050#include <linux/acpi.h>
David Howellsd9a83d62014-03-06 13:35:59 +000051#include <linux/jump_label.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070052#include <asm/uaccess.h>
Pantelis Antonioua430a3452014-10-28 22:36:02 +020053#include <linux/err.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070054
David Brownell9c1600e2007-05-01 23:26:31 +020055#include "i2c-core.h"
56
David Howellsd9a83d62014-03-06 13:35:59 +000057#define CREATE_TRACE_POINTS
58#include <trace/events/i2c.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070059
Jean Delvare6629dcf2010-05-04 11:09:28 +020060/* core_lock protects i2c_adapter_idr, and guarantees
Jean Delvare35fc37f2009-06-19 16:58:19 +020061 that device detection, deletion of detected devices, and attach_adapter
Lars-Peter Clausen19baba42013-03-09 08:16:44 +000062 calls are serialized */
Jean Delvarecaada322008-01-27 18:14:49 +010063static DEFINE_MUTEX(core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -070064static DEFINE_IDR(i2c_adapter_idr);
65
Jean Delvare4f8cf822009-09-18 22:45:46 +020066static struct device_type i2c_client_type;
Jean Delvare4735c982008-07-14 22:38:36 +020067static int i2c_detect(struct i2c_adapter *adapter, struct i2c_driver *driver);
David Brownellf37dd802007-02-13 22:09:00 +010068
David Howellsd9a83d62014-03-06 13:35:59 +000069static 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
Wolfram Sang17f4a5c2014-09-22 19:41:00 +020081#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;
Mika Westerberg393cc1c2014-12-29 15:48:48 +0200105 if (!info->addr && sb->type == ACPI_RESOURCE_SERIAL_TYPE_I2C) {
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200106 info->addr = sb->slave_address;
107 if (sb->access_mode == ACPI_I2C_10BIT_MODE)
108 info->flags |= I2C_CLIENT_TEN;
109 }
Mika Westerbergdab472e2015-05-06 13:29:07 +0300110 } else if (!info->irq) {
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200111 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));
Rafael J. Wysockice793482015-03-16 23:49:03 +0100136 info.fwnode = acpi_fwnode_handle(adev);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200137
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;
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300260 struct i2c_client *client;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200261 struct acpi_resource *ares;
262 u32 accessor_type = function >> 16;
263 u8 action = function & ACPI_IO_MASK;
Wolfram Sang4470c722014-11-18 15:12:43 +0100264 acpi_status ret;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200265 int status;
266
267 ret = acpi_buffer_to_resource(info->connection, info->length, &ares);
268 if (ACPI_FAILURE(ret))
269 return ret;
270
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300271 client = kzalloc(sizeof(*client), GFP_KERNEL);
272 if (!client) {
273 ret = AE_NO_MEMORY;
274 goto err;
275 }
276
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200277 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
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300288 client->adapter = adapter;
289 client->addr = sb->slave_address;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200290
291 if (sb->access_mode == ACPI_I2C_10BIT_MODE)
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300292 client->flags |= I2C_CLIENT_TEN;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200293
294 switch (accessor_type) {
295 case ACPI_GSB_ACCESS_ATTRIB_SEND_RCV:
296 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300297 status = i2c_smbus_read_byte(client);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200298 if (status >= 0) {
299 gsb->bdata = status;
300 status = 0;
301 }
302 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300303 status = i2c_smbus_write_byte(client, gsb->bdata);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200304 }
305 break;
306
307 case ACPI_GSB_ACCESS_ATTRIB_BYTE:
308 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300309 status = i2c_smbus_read_byte_data(client, command);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200310 if (status >= 0) {
311 gsb->bdata = status;
312 status = 0;
313 }
314 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300315 status = i2c_smbus_write_byte_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200316 gsb->bdata);
317 }
318 break;
319
320 case ACPI_GSB_ACCESS_ATTRIB_WORD:
321 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300322 status = i2c_smbus_read_word_data(client, command);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200323 if (status >= 0) {
324 gsb->wdata = status;
325 status = 0;
326 }
327 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300328 status = i2c_smbus_write_word_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200329 gsb->wdata);
330 }
331 break;
332
333 case ACPI_GSB_ACCESS_ATTRIB_BLOCK:
334 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300335 status = i2c_smbus_read_block_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200336 gsb->data);
337 if (status >= 0) {
338 gsb->len = status;
339 status = 0;
340 }
341 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300342 status = i2c_smbus_write_block_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200343 gsb->len, gsb->data);
344 }
345 break;
346
347 case ACPI_GSB_ACCESS_ATTRIB_MULTIBYTE:
348 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300349 status = acpi_gsb_i2c_read_bytes(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200350 gsb->data, info->access_length);
351 if (status > 0)
352 status = 0;
353 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300354 status = acpi_gsb_i2c_write_bytes(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200355 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:
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300368 kfree(client);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200369 ACPI_FREE(ares);
370 return ret;
371}
372
373
374static int acpi_i2c_install_space_handler(struct i2c_adapter *adapter)
375{
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200376 acpi_handle handle;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200377 struct acpi_i2c_handler_data *data;
378 acpi_status status;
379
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200380 if (!adapter->dev.parent)
381 return -ENODEV;
382
383 handle = ACPI_HANDLE(adapter->dev.parent);
384
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200385 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
Lan Tianyu40e7fcb2014-11-23 21:22:54 +0800412 acpi_walk_dep_device_list(handle);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200413 return 0;
414}
415
416static void acpi_i2c_remove_space_handler(struct i2c_adapter *adapter)
417{
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200418 acpi_handle handle;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200419 struct acpi_i2c_handler_data *data;
420 acpi_status status;
421
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200422 if (!adapter->dev.parent)
423 return;
424
425 handle = ACPI_HANDLE(adapter->dev.parent);
426
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200427 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
David Brownellf37dd802007-02-13 22:09:00 +0100448/* ------------------------------------------------------------------------- */
449
Jean Delvared2653e92008-04-29 23:11:39 +0200450static 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
Linus Torvalds1da177e2005-04-16 15:20:36 -0700461static int i2c_device_match(struct device *dev, struct device_driver *drv)
462{
Jean Delvare51298d12009-09-18 22:45:45 +0200463 struct i2c_client *client = i2c_verify_client(dev);
464 struct i2c_driver *driver;
David Brownell7b4fbc52007-05-01 23:26:30 +0200465
Jean Delvare51298d12009-09-18 22:45:45 +0200466 if (!client)
467 return 0;
468
Grant Likely959e85f2010-06-08 07:48:19 -0600469 /* Attempt an OF style match */
470 if (of_driver_match_device(dev, drv))
471 return 1;
472
Mika Westerberg907ddf82012-11-23 12:23:40 +0100473 /* Then ACPI style match */
474 if (acpi_driver_match_device(dev, drv))
475 return 1;
476
Jean Delvare51298d12009-09-18 22:45:45 +0200477 driver = to_i2c_driver(drv);
Jean Delvared2653e92008-04-29 23:11:39 +0200478 /* 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
Jean Delvareeb8a7902008-05-18 20:49:41 +0200482 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700483}
484
David Brownell7b4fbc52007-05-01 23:26:30 +0200485
486/* uevent helps with hotplug: modprobe -q $(MODALIAS) */
Kay Sievers7eff2e72007-08-14 15:15:12 +0200487static int i2c_device_uevent(struct device *dev, struct kobj_uevent_env *env)
David Brownell7b4fbc52007-05-01 23:26:30 +0200488{
489 struct i2c_client *client = to_i2c_client(dev);
Zhang Rui8c4ff6d2014-01-14 16:46:37 +0800490 int rc;
491
492 rc = acpi_device_uevent_modalias(dev, env);
493 if (rc != -ENODEV)
494 return rc;
David Brownell7b4fbc52007-05-01 23:26:30 +0200495
Jean Delvareeb8a7902008-05-18 20:49:41 +0200496 if (add_uevent_var(env, "MODALIAS=%s%s",
497 I2C_MODULE_PREFIX, client->name))
498 return -ENOMEM;
David Brownell7b4fbc52007-05-01 23:26:30 +0200499 dev_dbg(dev, "uevent\n");
500 return 0;
501}
502
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530503/* 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)
Grygorii Strashko2b2190a2015-04-06 15:38:39 +0300568 bri->prepare_recovery(adap);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530569
Jan Luebbe8b062602015-07-08 16:35:06 +0200570 bri->set_scl(adap, val);
571 ndelay(RECOVERY_NDELAY);
572
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530573 /*
574 * By this time SCL is high, as we need to give 9 falling-rising edges
575 */
576 while (i++ < RECOVERY_CLK_CNT * 2) {
577 if (val) {
578 /* Break if SDA is high */
579 if (bri->get_sda && bri->get_sda(adap))
580 break;
581 /* SCL shouldn't be low here */
582 if (!bri->get_scl(adap)) {
583 dev_err(&adap->dev,
584 "SCL is stuck low, exit recovery\n");
585 ret = -EBUSY;
586 break;
587 }
588 }
589
590 val = !val;
591 bri->set_scl(adap, val);
592 ndelay(RECOVERY_NDELAY);
593 }
594
595 if (bri->unprepare_recovery)
Grygorii Strashko2b2190a2015-04-06 15:38:39 +0300596 bri->unprepare_recovery(adap);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530597
598 return ret;
599}
600
601int i2c_generic_scl_recovery(struct i2c_adapter *adap)
602{
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530603 return i2c_generic_recovery(adap);
604}
Mark Brownc1c21f42015-04-15 19:18:39 +0100605EXPORT_SYMBOL_GPL(i2c_generic_scl_recovery);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530606
607int i2c_generic_gpio_recovery(struct i2c_adapter *adap)
608{
609 int ret;
610
611 ret = i2c_get_gpios_for_recovery(adap);
612 if (ret)
613 return ret;
614
615 ret = i2c_generic_recovery(adap);
616 i2c_put_gpios_for_recovery(adap);
617
618 return ret;
619}
Mark Brownc1c21f42015-04-15 19:18:39 +0100620EXPORT_SYMBOL_GPL(i2c_generic_gpio_recovery);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530621
622int i2c_recover_bus(struct i2c_adapter *adap)
623{
624 if (!adap->bus_recovery_info)
625 return -EOPNOTSUPP;
626
627 dev_dbg(&adap->dev, "Trying i2c bus recovery\n");
628 return adap->bus_recovery_info->recover_bus(adap);
629}
Mark Brownc1c21f42015-04-15 19:18:39 +0100630EXPORT_SYMBOL_GPL(i2c_recover_bus);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530631
Linus Torvalds1da177e2005-04-16 15:20:36 -0700632static int i2c_device_probe(struct device *dev)
633{
Jean Delvare51298d12009-09-18 22:45:45 +0200634 struct i2c_client *client = i2c_verify_client(dev);
635 struct i2c_driver *driver;
Hans Verkuil50c33042008-03-12 14:15:00 +0100636 int status;
David Brownell7b4fbc52007-05-01 23:26:30 +0200637
Jean Delvare51298d12009-09-18 22:45:45 +0200638 if (!client)
639 return 0;
640
Mika Westerberg845c8772015-05-06 13:29:08 +0300641 if (!client->irq) {
642 int irq = -ENOENT;
643
644 if (dev->of_node)
645 irq = of_irq_get(dev->of_node, 0);
646 else if (ACPI_COMPANION(dev))
647 irq = acpi_dev_gpio_irq_get(ACPI_COMPANION(dev), 0);
Laurent Pinchart2fd36c552014-10-30 15:59:38 +0200648
Geert Uytterhoeven6f34be72014-11-17 12:43:00 +0100649 if (irq == -EPROBE_DEFER)
Laurent Pinchart2fd36c552014-10-30 15:59:38 +0200650 return irq;
Geert Uytterhoeven6f34be72014-11-17 12:43:00 +0100651 if (irq < 0)
652 irq = 0;
Laurent Pinchart2fd36c552014-10-30 15:59:38 +0200653
654 client->irq = irq;
655 }
656
Jean Delvare51298d12009-09-18 22:45:45 +0200657 driver = to_i2c_driver(dev->driver);
Jean Delvaree0457442008-07-14 22:38:30 +0200658 if (!driver->probe || !driver->id_table)
David Brownell7b4fbc52007-05-01 23:26:30 +0200659 return -ENODEV;
Lars-Peter Clausen0acc2b32013-09-29 10:51:06 +0200660
Marc Pignatee354252008-08-28 08:33:22 +0200661 if (!device_can_wakeup(&client->dev))
662 device_init_wakeup(&client->dev,
663 client->flags & I2C_CLIENT_WAKE);
David Brownell7b4fbc52007-05-01 23:26:30 +0200664 dev_dbg(dev, "probe\n");
Jean Delvared2653e92008-04-29 23:11:39 +0200665
Sylwester Nawrocki86be4082014-06-18 17:29:32 +0200666 status = of_clk_set_defaults(dev->of_node, false);
667 if (status < 0)
668 return status;
669
Ulf Hanssone09b0d42014-09-19 20:27:39 +0200670 status = dev_pm_domain_attach(&client->dev, true);
671 if (status != -EPROBE_DEFER) {
672 status = driver->probe(client, i2c_match_id(driver->id_table,
673 client));
674 if (status)
675 dev_pm_domain_detach(&client->dev, true);
676 }
Wolfram Sang72fa8182014-01-21 17:48:34 +0100677
Hans Verkuil50c33042008-03-12 14:15:00 +0100678 return status;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700679}
680
681static int i2c_device_remove(struct device *dev)
682{
Jean Delvare51298d12009-09-18 22:45:45 +0200683 struct i2c_client *client = i2c_verify_client(dev);
David Brownella1d9e6e2007-05-01 23:26:30 +0200684 struct i2c_driver *driver;
Wolfram Sang72fa8182014-01-21 17:48:34 +0100685 int status = 0;
David Brownella1d9e6e2007-05-01 23:26:30 +0200686
Jean Delvare51298d12009-09-18 22:45:45 +0200687 if (!client || !dev->driver)
David Brownella1d9e6e2007-05-01 23:26:30 +0200688 return 0;
689
690 driver = to_i2c_driver(dev->driver);
691 if (driver->remove) {
692 dev_dbg(dev, "remove\n");
693 status = driver->remove(client);
David Brownella1d9e6e2007-05-01 23:26:30 +0200694 }
Wolfram Sang72fa8182014-01-21 17:48:34 +0100695
Ulf Hanssone09b0d42014-09-19 20:27:39 +0200696 dev_pm_domain_detach(&client->dev, true);
David Brownella1d9e6e2007-05-01 23:26:30 +0200697 return status;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700698}
699
David Brownellf37dd802007-02-13 22:09:00 +0100700static void i2c_device_shutdown(struct device *dev)
701{
Jean Delvare51298d12009-09-18 22:45:45 +0200702 struct i2c_client *client = i2c_verify_client(dev);
David Brownellf37dd802007-02-13 22:09:00 +0100703 struct i2c_driver *driver;
704
Jean Delvare51298d12009-09-18 22:45:45 +0200705 if (!client || !dev->driver)
David Brownellf37dd802007-02-13 22:09:00 +0100706 return;
707 driver = to_i2c_driver(dev->driver);
708 if (driver->shutdown)
Jean Delvare51298d12009-09-18 22:45:45 +0200709 driver->shutdown(client);
David Brownellf37dd802007-02-13 22:09:00 +0100710}
711
David Brownell9c1600e2007-05-01 23:26:31 +0200712static void i2c_client_dev_release(struct device *dev)
713{
714 kfree(to_i2c_client(dev));
715}
716
Zhenwen Xu09b8ce02009-03-28 21:34:46 +0100717static ssize_t
Jean Delvare4f8cf822009-09-18 22:45:46 +0200718show_name(struct device *dev, struct device_attribute *attr, char *buf)
David Brownell7b4fbc52007-05-01 23:26:30 +0200719{
Jean Delvare4f8cf822009-09-18 22:45:46 +0200720 return sprintf(buf, "%s\n", dev->type == &i2c_client_type ?
721 to_i2c_client(dev)->name : to_i2c_adapter(dev)->name);
David Brownell7b4fbc52007-05-01 23:26:30 +0200722}
Wolfram Sanga5eb71b2015-01-19 20:12:24 +0100723static DEVICE_ATTR(name, S_IRUGO, show_name, NULL);
David Brownell7b4fbc52007-05-01 23:26:30 +0200724
Zhenwen Xu09b8ce02009-03-28 21:34:46 +0100725static ssize_t
726show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
David Brownell7b4fbc52007-05-01 23:26:30 +0200727{
728 struct i2c_client *client = to_i2c_client(dev);
Zhang Rui8c4ff6d2014-01-14 16:46:37 +0800729 int len;
730
731 len = acpi_device_modalias(dev, buf, PAGE_SIZE -1);
732 if (len != -ENODEV)
733 return len;
734
Jean Delvareeb8a7902008-05-18 20:49:41 +0200735 return sprintf(buf, "%s%s\n", I2C_MODULE_PREFIX, client->name);
David Brownell7b4fbc52007-05-01 23:26:30 +0200736}
Jean Delvare51298d12009-09-18 22:45:45 +0200737static DEVICE_ATTR(modalias, S_IRUGO, show_modalias, NULL);
738
739static struct attribute *i2c_dev_attrs[] = {
740 &dev_attr_name.attr,
David Brownell7b4fbc52007-05-01 23:26:30 +0200741 /* modalias helps coldplug: modprobe $(cat .../modalias) */
Jean Delvare51298d12009-09-18 22:45:45 +0200742 &dev_attr_modalias.attr,
743 NULL
744};
Wolfram Sanga5eb71b2015-01-19 20:12:24 +0100745ATTRIBUTE_GROUPS(i2c_dev);
sonic zhang54067ee2009-12-14 21:17:30 +0100746
Jon Smirle9ca9eb2008-07-14 22:38:35 +0200747struct bus_type i2c_bus_type = {
David Brownellf37dd802007-02-13 22:09:00 +0100748 .name = "i2c",
749 .match = i2c_device_match,
750 .probe = i2c_device_probe,
751 .remove = i2c_device_remove,
752 .shutdown = i2c_device_shutdown,
Russell Kingb864c7d2006-01-05 14:37:50 +0000753};
Jon Smirle9ca9eb2008-07-14 22:38:35 +0200754EXPORT_SYMBOL_GPL(i2c_bus_type);
Russell Kingb864c7d2006-01-05 14:37:50 +0000755
Jean Delvare51298d12009-09-18 22:45:45 +0200756static struct device_type i2c_client_type = {
Wolfram Sanga5eb71b2015-01-19 20:12:24 +0100757 .groups = i2c_dev_groups,
Jean Delvare51298d12009-09-18 22:45:45 +0200758 .uevent = i2c_device_uevent,
759 .release = i2c_client_dev_release,
760};
761
David Brownell9b766b82008-01-27 18:14:51 +0100762
763/**
764 * i2c_verify_client - return parameter as i2c_client, or NULL
765 * @dev: device, probably from some driver model iterator
766 *
767 * When traversing the driver model tree, perhaps using driver model
768 * iterators like @device_for_each_child(), you can't assume very much
769 * about the nodes you find. Use this function to avoid oopses caused
770 * by wrongly treating some non-I2C device as an i2c_client.
771 */
772struct i2c_client *i2c_verify_client(struct device *dev)
773{
Jean Delvare51298d12009-09-18 22:45:45 +0200774 return (dev->type == &i2c_client_type)
David Brownell9b766b82008-01-27 18:14:51 +0100775 ? to_i2c_client(dev)
776 : NULL;
777}
778EXPORT_SYMBOL(i2c_verify_client);
779
780
Jean Delvare3a89db52010-06-03 11:33:52 +0200781/* This is a permissive address validity check, I2C address map constraints
Lucas De Marchi25985ed2011-03-30 22:57:33 -0300782 * are purposely not enforced, except for the general call address. */
Jean Delvare3a89db52010-06-03 11:33:52 +0200783static int i2c_check_client_addr_validity(const struct i2c_client *client)
784{
785 if (client->flags & I2C_CLIENT_TEN) {
786 /* 10-bit address, all values are valid */
787 if (client->addr > 0x3ff)
788 return -EINVAL;
789 } else {
790 /* 7-bit address, reject the general call address */
791 if (client->addr == 0x00 || client->addr > 0x7f)
792 return -EINVAL;
793 }
794 return 0;
795}
796
Jean Delvare656b8762010-06-03 11:33:53 +0200797/* And this is a strict address validity check, used when probing. If a
798 * device uses a reserved address, then it shouldn't be probed. 7-bit
799 * addressing is assumed, 10-bit address devices are rare and should be
800 * explicitly enumerated. */
801static int i2c_check_addr_validity(unsigned short addr)
802{
803 /*
804 * Reserved addresses per I2C specification:
805 * 0x00 General call address / START byte
806 * 0x01 CBUS address
807 * 0x02 Reserved for different bus format
808 * 0x03 Reserved for future purposes
809 * 0x04-0x07 Hs-mode master code
810 * 0x78-0x7b 10-bit slave addressing
811 * 0x7c-0x7f Reserved for future purposes
812 */
813 if (addr < 0x08 || addr > 0x77)
814 return -EINVAL;
815 return 0;
816}
817
Jean Delvare3b5f7942010-06-03 11:33:55 +0200818static int __i2c_check_addr_busy(struct device *dev, void *addrp)
819{
820 struct i2c_client *client = i2c_verify_client(dev);
821 int addr = *(int *)addrp;
822
823 if (client && client->addr == addr)
824 return -EBUSY;
825 return 0;
826}
827
Michael Lawnick08263742010-08-11 18:21:02 +0200828/* walk up mux tree */
829static int i2c_check_mux_parents(struct i2c_adapter *adapter, int addr)
830{
Jean Delvare97cc4d42010-10-24 18:16:57 +0200831 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
Michael Lawnick08263742010-08-11 18:21:02 +0200832 int result;
833
834 result = device_for_each_child(&adapter->dev, &addr,
835 __i2c_check_addr_busy);
836
Jean Delvare97cc4d42010-10-24 18:16:57 +0200837 if (!result && parent)
838 result = i2c_check_mux_parents(parent, addr);
Michael Lawnick08263742010-08-11 18:21:02 +0200839
840 return result;
841}
842
843/* recurse down mux tree */
844static int i2c_check_mux_children(struct device *dev, void *addrp)
845{
846 int result;
847
848 if (dev->type == &i2c_adapter_type)
849 result = device_for_each_child(dev, addrp,
850 i2c_check_mux_children);
851 else
852 result = __i2c_check_addr_busy(dev, addrp);
853
854 return result;
855}
856
Jean Delvare3b5f7942010-06-03 11:33:55 +0200857static int i2c_check_addr_busy(struct i2c_adapter *adapter, int addr)
858{
Jean Delvare97cc4d42010-10-24 18:16:57 +0200859 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
Michael Lawnick08263742010-08-11 18:21:02 +0200860 int result = 0;
861
Jean Delvare97cc4d42010-10-24 18:16:57 +0200862 if (parent)
863 result = i2c_check_mux_parents(parent, addr);
Michael Lawnick08263742010-08-11 18:21:02 +0200864
865 if (!result)
866 result = device_for_each_child(&adapter->dev, &addr,
867 i2c_check_mux_children);
868
869 return result;
Jean Delvare3b5f7942010-06-03 11:33:55 +0200870}
871
David Brownell9c1600e2007-05-01 23:26:31 +0200872/**
Jean Delvarefe61e072010-08-11 18:20:58 +0200873 * i2c_lock_adapter - Get exclusive access to an I2C bus segment
874 * @adapter: Target I2C bus segment
875 */
876void i2c_lock_adapter(struct i2c_adapter *adapter)
877{
Jean Delvare97cc4d42010-10-24 18:16:57 +0200878 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
879
880 if (parent)
881 i2c_lock_adapter(parent);
Michael Lawnick08263742010-08-11 18:21:02 +0200882 else
883 rt_mutex_lock(&adapter->bus_lock);
Jean Delvarefe61e072010-08-11 18:20:58 +0200884}
885EXPORT_SYMBOL_GPL(i2c_lock_adapter);
886
887/**
888 * i2c_trylock_adapter - Try to get exclusive access to an I2C bus segment
889 * @adapter: Target I2C bus segment
890 */
891static int i2c_trylock_adapter(struct i2c_adapter *adapter)
892{
Jean Delvare97cc4d42010-10-24 18:16:57 +0200893 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
894
895 if (parent)
896 return i2c_trylock_adapter(parent);
Michael Lawnick08263742010-08-11 18:21:02 +0200897 else
898 return rt_mutex_trylock(&adapter->bus_lock);
Jean Delvarefe61e072010-08-11 18:20:58 +0200899}
900
901/**
902 * i2c_unlock_adapter - Release exclusive access to an I2C bus segment
903 * @adapter: Target I2C bus segment
904 */
905void i2c_unlock_adapter(struct i2c_adapter *adapter)
906{
Jean Delvare97cc4d42010-10-24 18:16:57 +0200907 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
908
909 if (parent)
910 i2c_unlock_adapter(parent);
Michael Lawnick08263742010-08-11 18:21:02 +0200911 else
912 rt_mutex_unlock(&adapter->bus_lock);
Jean Delvarefe61e072010-08-11 18:20:58 +0200913}
914EXPORT_SYMBOL_GPL(i2c_unlock_adapter);
915
Jarkko Nikula70762ab2013-11-14 14:03:52 +0200916static void i2c_dev_set_name(struct i2c_adapter *adap,
917 struct i2c_client *client)
918{
919 struct acpi_device *adev = ACPI_COMPANION(&client->dev);
920
921 if (adev) {
922 dev_set_name(&client->dev, "i2c-%s", acpi_dev_name(adev));
923 return;
924 }
925
926 /* For 10-bit clients, add an arbitrary offset to avoid collisions */
927 dev_set_name(&client->dev, "%d-%04x", i2c_adapter_id(adap),
928 client->addr | ((client->flags & I2C_CLIENT_TEN)
929 ? 0xa000 : 0));
930}
931
Jean Delvarefe61e072010-08-11 18:20:58 +0200932/**
Jean Delvaref8a227e2009-06-19 16:58:18 +0200933 * i2c_new_device - instantiate an i2c device
David Brownell9c1600e2007-05-01 23:26:31 +0200934 * @adap: the adapter managing the device
935 * @info: describes one I2C device; bus_num is ignored
David Brownelld64f73b2007-07-12 14:12:28 +0200936 * Context: can sleep
David Brownell9c1600e2007-05-01 23:26:31 +0200937 *
Jean Delvaref8a227e2009-06-19 16:58:18 +0200938 * Create an i2c device. Binding is handled through driver model
939 * probe()/remove() methods. A driver may be bound to this device when we
940 * return from this function, or any later moment (e.g. maybe hotplugging will
941 * load the driver module). This call is not appropriate for use by mainboard
942 * initialization logic, which usually runs during an arch_initcall() long
943 * before any i2c_adapter could exist.
David Brownell9c1600e2007-05-01 23:26:31 +0200944 *
945 * This returns the new i2c client, which may be saved for later use with
946 * i2c_unregister_device(); or NULL to indicate an error.
947 */
948struct i2c_client *
949i2c_new_device(struct i2c_adapter *adap, struct i2c_board_info const *info)
950{
951 struct i2c_client *client;
952 int status;
953
954 client = kzalloc(sizeof *client, GFP_KERNEL);
955 if (!client)
956 return NULL;
957
958 client->adapter = adap;
959
960 client->dev.platform_data = info->platform_data;
David Brownell3bbb8352007-10-13 23:56:29 +0200961
Anton Vorontsov11f1f2a2008-10-22 20:21:33 +0200962 if (info->archdata)
963 client->dev.archdata = *info->archdata;
964
Marc Pignatee354252008-08-28 08:33:22 +0200965 client->flags = info->flags;
David Brownell9c1600e2007-05-01 23:26:31 +0200966 client->addr = info->addr;
967 client->irq = info->irq;
968
David Brownell9c1600e2007-05-01 23:26:31 +0200969 strlcpy(client->name, info->type, sizeof(client->name));
970
Jean Delvare3a89db52010-06-03 11:33:52 +0200971 /* Check for address validity */
972 status = i2c_check_client_addr_validity(client);
973 if (status) {
974 dev_err(&adap->dev, "Invalid %d-bit I2C address 0x%02hx\n",
975 client->flags & I2C_CLIENT_TEN ? 10 : 7, client->addr);
976 goto out_err_silent;
977 }
978
Jean Delvaref8a227e2009-06-19 16:58:18 +0200979 /* Check for address business */
Jean Delvare3b5f7942010-06-03 11:33:55 +0200980 status = i2c_check_addr_busy(adap, client->addr);
Jean Delvaref8a227e2009-06-19 16:58:18 +0200981 if (status)
982 goto out_err;
983
984 client->dev.parent = &client->adapter->dev;
985 client->dev.bus = &i2c_bus_type;
Jean Delvare51298d12009-09-18 22:45:45 +0200986 client->dev.type = &i2c_client_type;
Grant Likelyd12d42f2010-04-13 16:12:28 -0700987 client->dev.of_node = info->of_node;
Rafael J. Wysockice793482015-03-16 23:49:03 +0100988 client->dev.fwnode = info->fwnode;
Jean Delvaref8a227e2009-06-19 16:58:18 +0200989
Jarkko Nikula70762ab2013-11-14 14:03:52 +0200990 i2c_dev_set_name(adap, client);
Jean Delvaref8a227e2009-06-19 16:58:18 +0200991 status = device_register(&client->dev);
992 if (status)
993 goto out_err;
994
Jean Delvaref8a227e2009-06-19 16:58:18 +0200995 dev_dbg(&adap->dev, "client [%s] registered with bus id %s\n",
996 client->name, dev_name(&client->dev));
997
David Brownell9c1600e2007-05-01 23:26:31 +0200998 return client;
Jean Delvaref8a227e2009-06-19 16:58:18 +0200999
1000out_err:
1001 dev_err(&adap->dev, "Failed to register i2c client %s at 0x%02x "
1002 "(%d)\n", client->name, client->addr, status);
Jean Delvare3a89db52010-06-03 11:33:52 +02001003out_err_silent:
Jean Delvaref8a227e2009-06-19 16:58:18 +02001004 kfree(client);
1005 return NULL;
David Brownell9c1600e2007-05-01 23:26:31 +02001006}
1007EXPORT_SYMBOL_GPL(i2c_new_device);
1008
1009
1010/**
1011 * i2c_unregister_device - reverse effect of i2c_new_device()
1012 * @client: value returned from i2c_new_device()
David Brownelld64f73b2007-07-12 14:12:28 +02001013 * Context: can sleep
David Brownell9c1600e2007-05-01 23:26:31 +02001014 */
1015void i2c_unregister_device(struct i2c_client *client)
David Brownella1d9e6e2007-05-01 23:26:30 +02001016{
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001017 if (client->dev.of_node)
1018 of_node_clear_flag(client->dev.of_node, OF_POPULATED);
David Brownella1d9e6e2007-05-01 23:26:30 +02001019 device_unregister(&client->dev);
1020}
David Brownell9c1600e2007-05-01 23:26:31 +02001021EXPORT_SYMBOL_GPL(i2c_unregister_device);
David Brownella1d9e6e2007-05-01 23:26:30 +02001022
1023
Jean Delvare60b129d2008-05-11 20:37:06 +02001024static const struct i2c_device_id dummy_id[] = {
1025 { "dummy", 0 },
1026 { },
1027};
1028
Jean Delvared2653e92008-04-29 23:11:39 +02001029static int dummy_probe(struct i2c_client *client,
1030 const struct i2c_device_id *id)
1031{
1032 return 0;
1033}
1034
1035static int dummy_remove(struct i2c_client *client)
David Brownelle9f13732008-01-27 18:14:52 +01001036{
1037 return 0;
1038}
1039
1040static struct i2c_driver dummy_driver = {
1041 .driver.name = "dummy",
Jean Delvared2653e92008-04-29 23:11:39 +02001042 .probe = dummy_probe,
1043 .remove = dummy_remove,
Jean Delvare60b129d2008-05-11 20:37:06 +02001044 .id_table = dummy_id,
David Brownelle9f13732008-01-27 18:14:52 +01001045};
1046
1047/**
1048 * i2c_new_dummy - return a new i2c device bound to a dummy driver
1049 * @adapter: the adapter managing the device
1050 * @address: seven bit address to be used
David Brownelle9f13732008-01-27 18:14:52 +01001051 * Context: can sleep
1052 *
1053 * This returns an I2C client bound to the "dummy" driver, intended for use
1054 * with devices that consume multiple addresses. Examples of such chips
1055 * include various EEPROMS (like 24c04 and 24c08 models).
1056 *
1057 * These dummy devices have two main uses. First, most I2C and SMBus calls
1058 * except i2c_transfer() need a client handle; the dummy will be that handle.
1059 * And second, this prevents the specified address from being bound to a
1060 * different driver.
1061 *
1062 * This returns the new i2c client, which should be saved for later use with
1063 * i2c_unregister_device(); or NULL to indicate an error.
1064 */
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01001065struct i2c_client *i2c_new_dummy(struct i2c_adapter *adapter, u16 address)
David Brownelle9f13732008-01-27 18:14:52 +01001066{
1067 struct i2c_board_info info = {
Jean Delvare60b129d2008-05-11 20:37:06 +02001068 I2C_BOARD_INFO("dummy", address),
David Brownelle9f13732008-01-27 18:14:52 +01001069 };
1070
David Brownelle9f13732008-01-27 18:14:52 +01001071 return i2c_new_device(adapter, &info);
1072}
1073EXPORT_SYMBOL_GPL(i2c_new_dummy);
1074
David Brownellf37dd802007-02-13 22:09:00 +01001075/* ------------------------------------------------------------------------- */
1076
David Brownell16ffadf2007-05-01 23:26:28 +02001077/* I2C bus adapters -- one roots each I2C or SMBUS segment */
1078
Adrian Bunk83eaaed2007-10-13 23:56:30 +02001079static void i2c_adapter_dev_release(struct device *dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001080{
David Brownellef2c83212007-05-01 23:26:28 +02001081 struct i2c_adapter *adap = to_i2c_adapter(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001082 complete(&adap->dev_released);
1083}
1084
Jean Delvare99cd8e22009-06-19 16:58:20 +02001085/*
Jean Delvare390946b2012-09-10 10:14:02 +02001086 * This function is only needed for mutex_lock_nested, so it is never
1087 * called unless locking correctness checking is enabled. Thus we
1088 * make it inline to avoid a compiler warning. That's what gcc ends up
1089 * doing anyway.
1090 */
1091static inline unsigned int i2c_adapter_depth(struct i2c_adapter *adapter)
1092{
1093 unsigned int depth = 0;
1094
1095 while ((adapter = i2c_parent_is_i2c_adapter(adapter)))
1096 depth++;
1097
1098 return depth;
1099}
1100
1101/*
Jean Delvare99cd8e22009-06-19 16:58:20 +02001102 * Let users instantiate I2C devices through sysfs. This can be used when
1103 * platform initialization code doesn't contain the proper data for
1104 * whatever reason. Also useful for drivers that do device detection and
1105 * detection fails, either because the device uses an unexpected address,
1106 * or this is a compatible device with different ID register values.
1107 *
1108 * Parameter checking may look overzealous, but we really don't want
1109 * the user to provide incorrect parameters.
1110 */
1111static ssize_t
1112i2c_sysfs_new_device(struct device *dev, struct device_attribute *attr,
1113 const char *buf, size_t count)
1114{
1115 struct i2c_adapter *adap = to_i2c_adapter(dev);
1116 struct i2c_board_info info;
1117 struct i2c_client *client;
1118 char *blank, end;
1119 int res;
1120
Jean Delvare99cd8e22009-06-19 16:58:20 +02001121 memset(&info, 0, sizeof(struct i2c_board_info));
1122
1123 blank = strchr(buf, ' ');
1124 if (!blank) {
1125 dev_err(dev, "%s: Missing parameters\n", "new_device");
1126 return -EINVAL;
1127 }
1128 if (blank - buf > I2C_NAME_SIZE - 1) {
1129 dev_err(dev, "%s: Invalid device name\n", "new_device");
1130 return -EINVAL;
1131 }
1132 memcpy(info.type, buf, blank - buf);
1133
1134 /* Parse remaining parameters, reject extra parameters */
1135 res = sscanf(++blank, "%hi%c", &info.addr, &end);
1136 if (res < 1) {
1137 dev_err(dev, "%s: Can't parse I2C address\n", "new_device");
1138 return -EINVAL;
1139 }
1140 if (res > 1 && end != '\n') {
1141 dev_err(dev, "%s: Extra parameters\n", "new_device");
1142 return -EINVAL;
1143 }
1144
Jean Delvare99cd8e22009-06-19 16:58:20 +02001145 client = i2c_new_device(adap, &info);
1146 if (!client)
Jean Delvare3a89db52010-06-03 11:33:52 +02001147 return -EINVAL;
Jean Delvare99cd8e22009-06-19 16:58:20 +02001148
1149 /* Keep track of the added device */
Jean Delvaredafc50d2010-08-11 18:21:01 +02001150 mutex_lock(&adap->userspace_clients_lock);
Jean Delvare6629dcf2010-05-04 11:09:28 +02001151 list_add_tail(&client->detected, &adap->userspace_clients);
Jean Delvaredafc50d2010-08-11 18:21:01 +02001152 mutex_unlock(&adap->userspace_clients_lock);
Jean Delvare99cd8e22009-06-19 16:58:20 +02001153 dev_info(dev, "%s: Instantiated device %s at 0x%02hx\n", "new_device",
1154 info.type, info.addr);
1155
1156 return count;
1157}
Wolfram Sanga5eb71b2015-01-19 20:12:24 +01001158static DEVICE_ATTR(new_device, S_IWUSR, NULL, i2c_sysfs_new_device);
Jean Delvare99cd8e22009-06-19 16:58:20 +02001159
1160/*
1161 * And of course let the users delete the devices they instantiated, if
1162 * they got it wrong. This interface can only be used to delete devices
1163 * instantiated by i2c_sysfs_new_device above. This guarantees that we
1164 * don't delete devices to which some kernel code still has references.
1165 *
1166 * Parameter checking may look overzealous, but we really don't want
1167 * the user to delete the wrong device.
1168 */
1169static ssize_t
1170i2c_sysfs_delete_device(struct device *dev, struct device_attribute *attr,
1171 const char *buf, size_t count)
1172{
1173 struct i2c_adapter *adap = to_i2c_adapter(dev);
1174 struct i2c_client *client, *next;
1175 unsigned short addr;
1176 char end;
1177 int res;
1178
1179 /* Parse parameters, reject extra parameters */
1180 res = sscanf(buf, "%hi%c", &addr, &end);
1181 if (res < 1) {
1182 dev_err(dev, "%s: Can't parse I2C address\n", "delete_device");
1183 return -EINVAL;
1184 }
1185 if (res > 1 && end != '\n') {
1186 dev_err(dev, "%s: Extra parameters\n", "delete_device");
1187 return -EINVAL;
1188 }
1189
1190 /* Make sure the device was added through sysfs */
1191 res = -ENOENT;
Jean Delvare390946b2012-09-10 10:14:02 +02001192 mutex_lock_nested(&adap->userspace_clients_lock,
1193 i2c_adapter_depth(adap));
Jean Delvare6629dcf2010-05-04 11:09:28 +02001194 list_for_each_entry_safe(client, next, &adap->userspace_clients,
1195 detected) {
1196 if (client->addr == addr) {
Jean Delvare99cd8e22009-06-19 16:58:20 +02001197 dev_info(dev, "%s: Deleting device %s at 0x%02hx\n",
1198 "delete_device", client->name, client->addr);
1199
1200 list_del(&client->detected);
1201 i2c_unregister_device(client);
1202 res = count;
1203 break;
1204 }
1205 }
Jean Delvaredafc50d2010-08-11 18:21:01 +02001206 mutex_unlock(&adap->userspace_clients_lock);
Jean Delvare99cd8e22009-06-19 16:58:20 +02001207
1208 if (res < 0)
1209 dev_err(dev, "%s: Can't find device in list\n",
1210 "delete_device");
1211 return res;
1212}
Alexander Sverdline9b526f2013-05-17 14:56:35 +02001213static DEVICE_ATTR_IGNORE_LOCKDEP(delete_device, S_IWUSR, NULL,
1214 i2c_sysfs_delete_device);
Jean Delvare4f8cf822009-09-18 22:45:46 +02001215
1216static struct attribute *i2c_adapter_attrs[] = {
1217 &dev_attr_name.attr,
1218 &dev_attr_new_device.attr,
1219 &dev_attr_delete_device.attr,
1220 NULL
David Brownell16ffadf2007-05-01 23:26:28 +02001221};
Wolfram Sanga5eb71b2015-01-19 20:12:24 +01001222ATTRIBUTE_GROUPS(i2c_adapter);
Jean Delvare4f8cf822009-09-18 22:45:46 +02001223
Michael Lawnick08263742010-08-11 18:21:02 +02001224struct device_type i2c_adapter_type = {
Wolfram Sanga5eb71b2015-01-19 20:12:24 +01001225 .groups = i2c_adapter_groups,
Jean Delvare4f8cf822009-09-18 22:45:46 +02001226 .release = i2c_adapter_dev_release,
David Brownell16ffadf2007-05-01 23:26:28 +02001227};
Michael Lawnick08263742010-08-11 18:21:02 +02001228EXPORT_SYMBOL_GPL(i2c_adapter_type);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001229
Stephen Warren643dd092012-04-17 12:43:33 -06001230/**
1231 * i2c_verify_adapter - return parameter as i2c_adapter or NULL
1232 * @dev: device, probably from some driver model iterator
1233 *
1234 * When traversing the driver model tree, perhaps using driver model
1235 * iterators like @device_for_each_child(), you can't assume very much
1236 * about the nodes you find. Use this function to avoid oopses caused
1237 * by wrongly treating some non-I2C device as an i2c_adapter.
1238 */
1239struct i2c_adapter *i2c_verify_adapter(struct device *dev)
1240{
1241 return (dev->type == &i2c_adapter_type)
1242 ? to_i2c_adapter(dev)
1243 : NULL;
1244}
1245EXPORT_SYMBOL(i2c_verify_adapter);
1246
Jean Delvare2bb50952009-09-18 22:45:46 +02001247#ifdef CONFIG_I2C_COMPAT
1248static struct class_compat *i2c_adapter_compat_class;
1249#endif
1250
David Brownell9c1600e2007-05-01 23:26:31 +02001251static void i2c_scan_static_board_info(struct i2c_adapter *adapter)
1252{
1253 struct i2c_devinfo *devinfo;
1254
Rodolfo Giomettif18c41d2009-06-19 16:58:20 +02001255 down_read(&__i2c_board_lock);
David Brownell9c1600e2007-05-01 23:26:31 +02001256 list_for_each_entry(devinfo, &__i2c_board_list, list) {
1257 if (devinfo->busnum == adapter->nr
1258 && !i2c_new_device(adapter,
1259 &devinfo->board_info))
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01001260 dev_err(&adapter->dev,
1261 "Can't create device at 0x%02x\n",
David Brownell9c1600e2007-05-01 23:26:31 +02001262 devinfo->board_info.addr);
1263 }
Rodolfo Giomettif18c41d2009-06-19 16:58:20 +02001264 up_read(&__i2c_board_lock);
David Brownell9c1600e2007-05-01 23:26:31 +02001265}
1266
Wolfram Sang687b81d2013-07-11 12:56:15 +01001267/* OF support code */
1268
1269#if IS_ENABLED(CONFIG_OF)
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001270static struct i2c_client *of_i2c_register_device(struct i2c_adapter *adap,
1271 struct device_node *node)
1272{
1273 struct i2c_client *result;
1274 struct i2c_board_info info = {};
1275 struct dev_archdata dev_ad = {};
1276 const __be32 *addr;
1277 int len;
1278
1279 dev_dbg(&adap->dev, "of_i2c: register %s\n", node->full_name);
1280
1281 if (of_modalias_node(node, info.type, sizeof(info.type)) < 0) {
1282 dev_err(&adap->dev, "of_i2c: modalias failure on %s\n",
1283 node->full_name);
1284 return ERR_PTR(-EINVAL);
1285 }
1286
1287 addr = of_get_property(node, "reg", &len);
Wolfram Sang4c1344f2015-05-19 18:29:48 +02001288 if (!addr || (len < sizeof(*addr))) {
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001289 dev_err(&adap->dev, "of_i2c: invalid reg on %s\n",
1290 node->full_name);
1291 return ERR_PTR(-EINVAL);
1292 }
1293
1294 info.addr = be32_to_cpup(addr);
1295 if (info.addr > (1 << 10) - 1) {
1296 dev_err(&adap->dev, "of_i2c: invalid addr=%x on %s\n",
1297 info.addr, node->full_name);
1298 return ERR_PTR(-EINVAL);
1299 }
1300
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001301 info.of_node = of_node_get(node);
1302 info.archdata = &dev_ad;
1303
1304 if (of_get_property(node, "wakeup-source", NULL))
1305 info.flags |= I2C_CLIENT_WAKE;
1306
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001307 result = i2c_new_device(adap, &info);
1308 if (result == NULL) {
1309 dev_err(&adap->dev, "of_i2c: Failure registering %s\n",
1310 node->full_name);
1311 of_node_put(node);
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001312 return ERR_PTR(-EINVAL);
1313 }
1314 return result;
1315}
1316
Wolfram Sang687b81d2013-07-11 12:56:15 +01001317static void of_i2c_register_devices(struct i2c_adapter *adap)
1318{
Wolfram Sang687b81d2013-07-11 12:56:15 +01001319 struct device_node *node;
1320
1321 /* Only register child devices if the adapter has a node pointer set */
1322 if (!adap->dev.of_node)
1323 return;
1324
1325 dev_dbg(&adap->dev, "of_i2c: walking child nodes\n");
1326
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001327 for_each_available_child_of_node(adap->dev.of_node, node) {
1328 if (of_node_test_and_set_flag(node, OF_POPULATED))
1329 continue;
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001330 of_i2c_register_device(adap, node);
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001331 }
Wolfram Sang687b81d2013-07-11 12:56:15 +01001332}
1333
1334static int of_dev_node_match(struct device *dev, void *data)
1335{
1336 return dev->of_node == data;
1337}
1338
1339/* must call put_device() when done with returned i2c_client device */
1340struct i2c_client *of_find_i2c_device_by_node(struct device_node *node)
1341{
1342 struct device *dev;
1343
1344 dev = bus_find_device(&i2c_bus_type, NULL, node,
1345 of_dev_node_match);
1346 if (!dev)
1347 return NULL;
1348
1349 return i2c_verify_client(dev);
1350}
1351EXPORT_SYMBOL(of_find_i2c_device_by_node);
1352
1353/* must call put_device() when done with returned i2c_adapter device */
1354struct i2c_adapter *of_find_i2c_adapter_by_node(struct device_node *node)
1355{
1356 struct device *dev;
1357
1358 dev = bus_find_device(&i2c_bus_type, NULL, node,
1359 of_dev_node_match);
1360 if (!dev)
1361 return NULL;
1362
1363 return i2c_verify_adapter(dev);
1364}
1365EXPORT_SYMBOL(of_find_i2c_adapter_by_node);
1366#else
1367static void of_i2c_register_devices(struct i2c_adapter *adap) { }
1368#endif /* CONFIG_OF */
1369
Jean Delvare69b00892009-12-06 17:06:27 +01001370static int i2c_do_add_adapter(struct i2c_driver *driver,
1371 struct i2c_adapter *adap)
Jean Delvare026526f2008-01-27 18:14:49 +01001372{
Jean Delvare4735c982008-07-14 22:38:36 +02001373 /* Detect supported devices on that bus, and instantiate them */
1374 i2c_detect(adap, driver);
1375
1376 /* Let legacy drivers scan this bus for matching devices */
Jean Delvare026526f2008-01-27 18:14:49 +01001377 if (driver->attach_adapter) {
Jean Delvarea920ff42011-04-17 10:20:19 +02001378 dev_warn(&adap->dev, "%s: attach_adapter method is deprecated\n",
1379 driver->driver.name);
Jean Delvarefe6fc252011-03-20 14:50:53 +01001380 dev_warn(&adap->dev, "Please use another way to instantiate "
1381 "your i2c_client\n");
Jean Delvare026526f2008-01-27 18:14:49 +01001382 /* We ignore the return code; if it fails, too bad */
1383 driver->attach_adapter(adap);
1384 }
1385 return 0;
1386}
1387
Jean Delvare69b00892009-12-06 17:06:27 +01001388static int __process_new_adapter(struct device_driver *d, void *data)
1389{
1390 return i2c_do_add_adapter(to_i2c_driver(d), data);
1391}
1392
David Brownell6e13e642007-05-01 23:26:31 +02001393static int i2c_register_adapter(struct i2c_adapter *adap)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001394{
Jean Delvared6703282010-08-11 18:20:59 +02001395 int res = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001396
David Brownell1d0b19c2008-10-14 17:30:05 +02001397 /* Can't register until after driver model init */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001398 if (unlikely(WARN_ON(!i2c_bus_type.p))) {
1399 res = -EAGAIN;
1400 goto out_list;
1401 }
David Brownell1d0b19c2008-10-14 17:30:05 +02001402
Jean Delvare2236baa2010-11-15 22:40:38 +01001403 /* Sanity checks */
1404 if (unlikely(adap->name[0] == '\0')) {
1405 pr_err("i2c-core: Attempt to register an adapter with "
1406 "no name!\n");
1407 return -EINVAL;
1408 }
1409 if (unlikely(!adap->algo)) {
1410 pr_err("i2c-core: Attempt to register adapter '%s' with "
1411 "no algo!\n", adap->name);
1412 return -EINVAL;
1413 }
1414
Mika Kuoppala194684e2009-12-06 17:06:22 +01001415 rt_mutex_init(&adap->bus_lock);
Jean Delvaredafc50d2010-08-11 18:21:01 +02001416 mutex_init(&adap->userspace_clients_lock);
Jean Delvare6629dcf2010-05-04 11:09:28 +02001417 INIT_LIST_HEAD(&adap->userspace_clients);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001418
Jean Delvare8fcfef62009-03-28 21:34:43 +01001419 /* Set default timeout to 1 second if not already set */
1420 if (adap->timeout == 0)
1421 adap->timeout = HZ;
1422
Kay Sievers27d9c182009-01-07 14:29:16 +01001423 dev_set_name(&adap->dev, "i2c-%d", adap->nr);
Jean Delvare4f8cf822009-09-18 22:45:46 +02001424 adap->dev.bus = &i2c_bus_type;
1425 adap->dev.type = &i2c_adapter_type;
Jean Delvareb119c6c2006-08-15 18:26:30 +02001426 res = device_register(&adap->dev);
1427 if (res)
1428 goto out_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001429
Jean Delvareb6d7b3d2005-07-31 19:02:53 +02001430 dev_dbg(&adap->dev, "adapter [%s] registered\n", adap->name);
1431
Charles Keepax6ada5c12015-04-16 13:05:19 +01001432 pm_runtime_no_callbacks(&adap->dev);
1433
Jean Delvare2bb50952009-09-18 22:45:46 +02001434#ifdef CONFIG_I2C_COMPAT
1435 res = class_compat_create_link(i2c_adapter_compat_class, &adap->dev,
1436 adap->dev.parent);
1437 if (res)
1438 dev_warn(&adap->dev,
1439 "Failed to create compatibility class link\n");
1440#endif
1441
Viresh Kumar5f9296b2012-02-28 18:26:31 +05301442 /* bus recovery specific initialization */
1443 if (adap->bus_recovery_info) {
1444 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
1445
1446 if (!bri->recover_bus) {
1447 dev_err(&adap->dev, "No recover_bus() found, not using recovery\n");
1448 adap->bus_recovery_info = NULL;
1449 goto exit_recovery;
1450 }
1451
1452 /* Generic GPIO recovery */
1453 if (bri->recover_bus == i2c_generic_gpio_recovery) {
1454 if (!gpio_is_valid(bri->scl_gpio)) {
1455 dev_err(&adap->dev, "Invalid SCL gpio, not using recovery\n");
1456 adap->bus_recovery_info = NULL;
1457 goto exit_recovery;
1458 }
1459
1460 if (gpio_is_valid(bri->sda_gpio))
1461 bri->get_sda = get_sda_gpio_value;
1462 else
1463 bri->get_sda = NULL;
1464
1465 bri->get_scl = get_scl_gpio_value;
1466 bri->set_scl = set_scl_gpio_value;
1467 } else if (!bri->set_scl || !bri->get_scl) {
1468 /* Generic SCL recovery */
1469 dev_err(&adap->dev, "No {get|set}_gpio() found, not using recovery\n");
1470 adap->bus_recovery_info = NULL;
1471 }
1472 }
1473
1474exit_recovery:
Jean Delvare729d6dd2009-06-19 16:58:18 +02001475 /* create pre-declared device nodes */
Wolfram Sang687b81d2013-07-11 12:56:15 +01001476 of_i2c_register_devices(adap);
Mika Westerberg55e71ed2013-08-21 17:28:23 +03001477 acpi_i2c_register_devices(adap);
Lan Tianyu5d98e612014-05-20 20:59:23 +08001478 acpi_i2c_install_space_handler(adap);
Wolfram Sang687b81d2013-07-11 12:56:15 +01001479
David Brownell6e13e642007-05-01 23:26:31 +02001480 if (adap->nr < __i2c_first_dynamic_bus_num)
1481 i2c_scan_static_board_info(adap);
1482
Jean Delvare4735c982008-07-14 22:38:36 +02001483 /* Notify drivers */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001484 mutex_lock(&core_lock);
Jean Delvared6703282010-08-11 18:20:59 +02001485 bus_for_each_drv(&i2c_bus_type, NULL, adap, __process_new_adapter);
Jean Delvarecaada322008-01-27 18:14:49 +01001486 mutex_unlock(&core_lock);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001487
1488 return 0;
Jean Delvareb119c6c2006-08-15 18:26:30 +02001489
Jean Delvareb119c6c2006-08-15 18:26:30 +02001490out_list:
Jean Delvare35fc37f2009-06-19 16:58:19 +02001491 mutex_lock(&core_lock);
Jean Delvareb119c6c2006-08-15 18:26:30 +02001492 idr_remove(&i2c_adapter_idr, adap->nr);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001493 mutex_unlock(&core_lock);
1494 return res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001495}
1496
David Brownell6e13e642007-05-01 23:26:31 +02001497/**
Doug Andersonee5c2742013-03-01 08:57:31 -08001498 * __i2c_add_numbered_adapter - i2c_add_numbered_adapter where nr is never -1
1499 * @adap: the adapter to register (with adap->nr initialized)
1500 * Context: can sleep
1501 *
1502 * See i2c_add_numbered_adapter() for details.
1503 */
1504static int __i2c_add_numbered_adapter(struct i2c_adapter *adap)
1505{
1506 int id;
1507
1508 mutex_lock(&core_lock);
1509 id = idr_alloc(&i2c_adapter_idr, adap, adap->nr, adap->nr + 1,
1510 GFP_KERNEL);
1511 mutex_unlock(&core_lock);
1512 if (id < 0)
1513 return id == -ENOSPC ? -EBUSY : id;
1514
1515 return i2c_register_adapter(adap);
1516}
1517
1518/**
David Brownell6e13e642007-05-01 23:26:31 +02001519 * i2c_add_adapter - declare i2c adapter, use dynamic bus number
1520 * @adapter: the adapter to add
David Brownelld64f73b2007-07-12 14:12:28 +02001521 * Context: can sleep
David Brownell6e13e642007-05-01 23:26:31 +02001522 *
1523 * This routine is used to declare an I2C adapter when its bus number
Doug Andersonee5c2742013-03-01 08:57:31 -08001524 * doesn't matter or when its bus number is specified by an dt alias.
1525 * Examples of bases when the bus number doesn't matter: I2C adapters
1526 * dynamically added by USB links or PCI plugin cards.
David Brownell6e13e642007-05-01 23:26:31 +02001527 *
1528 * When this returns zero, a new bus number was allocated and stored
1529 * in adap->nr, and the specified adapter became available for clients.
1530 * Otherwise, a negative errno value is returned.
1531 */
1532int i2c_add_adapter(struct i2c_adapter *adapter)
1533{
Doug Andersonee5c2742013-03-01 08:57:31 -08001534 struct device *dev = &adapter->dev;
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001535 int id;
David Brownell6e13e642007-05-01 23:26:31 +02001536
Doug Andersonee5c2742013-03-01 08:57:31 -08001537 if (dev->of_node) {
1538 id = of_alias_get_id(dev->of_node, "i2c");
1539 if (id >= 0) {
1540 adapter->nr = id;
1541 return __i2c_add_numbered_adapter(adapter);
1542 }
1543 }
1544
Jean Delvarecaada322008-01-27 18:14:49 +01001545 mutex_lock(&core_lock);
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001546 id = idr_alloc(&i2c_adapter_idr, adapter,
1547 __i2c_first_dynamic_bus_num, 0, GFP_KERNEL);
Jean Delvarecaada322008-01-27 18:14:49 +01001548 mutex_unlock(&core_lock);
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001549 if (id < 0)
1550 return id;
David Brownell6e13e642007-05-01 23:26:31 +02001551
1552 adapter->nr = id;
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001553
David Brownell6e13e642007-05-01 23:26:31 +02001554 return i2c_register_adapter(adapter);
1555}
1556EXPORT_SYMBOL(i2c_add_adapter);
1557
1558/**
1559 * i2c_add_numbered_adapter - declare i2c adapter, use static bus number
1560 * @adap: the adapter to register (with adap->nr initialized)
David Brownelld64f73b2007-07-12 14:12:28 +02001561 * Context: can sleep
David Brownell6e13e642007-05-01 23:26:31 +02001562 *
1563 * This routine is used to declare an I2C adapter when its bus number
Randy Dunlap8c07e462008-03-23 20:28:20 +01001564 * matters. For example, use it for I2C adapters from system-on-chip CPUs,
1565 * or otherwise built in to the system's mainboard, and where i2c_board_info
David Brownell6e13e642007-05-01 23:26:31 +02001566 * is used to properly configure I2C devices.
1567 *
Grant Likely488bf312011-07-25 17:49:43 +02001568 * If the requested bus number is set to -1, then this function will behave
1569 * identically to i2c_add_adapter, and will dynamically assign a bus number.
1570 *
David Brownell6e13e642007-05-01 23:26:31 +02001571 * If no devices have pre-been declared for this bus, then be sure to
1572 * register the adapter before any dynamically allocated ones. Otherwise
1573 * the required bus ID may not be available.
1574 *
1575 * When this returns zero, the specified adapter became available for
1576 * clients using the bus number provided in adap->nr. Also, the table
1577 * of I2C devices pre-declared using i2c_register_board_info() is scanned,
1578 * and the appropriate driver model device nodes are created. Otherwise, a
1579 * negative errno value is returned.
1580 */
1581int i2c_add_numbered_adapter(struct i2c_adapter *adap)
1582{
Grant Likely488bf312011-07-25 17:49:43 +02001583 if (adap->nr == -1) /* -1 means dynamically assign bus id */
1584 return i2c_add_adapter(adap);
David Brownell6e13e642007-05-01 23:26:31 +02001585
Doug Andersonee5c2742013-03-01 08:57:31 -08001586 return __i2c_add_numbered_adapter(adap);
David Brownell6e13e642007-05-01 23:26:31 +02001587}
1588EXPORT_SYMBOL_GPL(i2c_add_numbered_adapter);
1589
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001590static void i2c_do_del_adapter(struct i2c_driver *driver,
Jean Delvare69b00892009-12-06 17:06:27 +01001591 struct i2c_adapter *adapter)
Jean Delvare026526f2008-01-27 18:14:49 +01001592{
Jean Delvare4735c982008-07-14 22:38:36 +02001593 struct i2c_client *client, *_n;
Jean Delvare026526f2008-01-27 18:14:49 +01001594
Jean Delvareacec2112009-03-28 21:34:40 +01001595 /* Remove the devices we created ourselves as the result of hardware
1596 * probing (using a driver's detect method) */
Jean Delvare4735c982008-07-14 22:38:36 +02001597 list_for_each_entry_safe(client, _n, &driver->clients, detected) {
1598 if (client->adapter == adapter) {
1599 dev_dbg(&adapter->dev, "Removing %s at 0x%x\n",
1600 client->name, client->addr);
1601 list_del(&client->detected);
1602 i2c_unregister_device(client);
1603 }
1604 }
Jean Delvare026526f2008-01-27 18:14:49 +01001605}
1606
Jean Delvaree549c2b2009-06-19 16:58:19 +02001607static int __unregister_client(struct device *dev, void *dummy)
1608{
1609 struct i2c_client *client = i2c_verify_client(dev);
Jean Delvare5219bf82011-01-14 22:03:49 +01001610 if (client && strcmp(client->name, "dummy"))
1611 i2c_unregister_device(client);
1612 return 0;
1613}
1614
1615static int __unregister_dummy(struct device *dev, void *dummy)
1616{
1617 struct i2c_client *client = i2c_verify_client(dev);
Jean Delvaree549c2b2009-06-19 16:58:19 +02001618 if (client)
1619 i2c_unregister_device(client);
1620 return 0;
1621}
1622
Jean Delvare69b00892009-12-06 17:06:27 +01001623static int __process_removed_adapter(struct device_driver *d, void *data)
1624{
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001625 i2c_do_del_adapter(to_i2c_driver(d), data);
1626 return 0;
Jean Delvare69b00892009-12-06 17:06:27 +01001627}
1628
David Brownelld64f73b2007-07-12 14:12:28 +02001629/**
1630 * i2c_del_adapter - unregister I2C adapter
1631 * @adap: the adapter being unregistered
1632 * Context: can sleep
1633 *
1634 * This unregisters an I2C adapter which was previously registered
1635 * by @i2c_add_adapter or @i2c_add_numbered_adapter.
1636 */
Lars-Peter Clausen71546302013-03-09 08:16:47 +00001637void i2c_del_adapter(struct i2c_adapter *adap)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001638{
Jean Delvare35fc37f2009-06-19 16:58:19 +02001639 struct i2c_adapter *found;
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001640 struct i2c_client *client, *next;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001641
1642 /* First make sure that this adapter was ever added */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001643 mutex_lock(&core_lock);
1644 found = idr_find(&i2c_adapter_idr, adap->nr);
1645 mutex_unlock(&core_lock);
1646 if (found != adap) {
Jean Delvareb6d7b3d2005-07-31 19:02:53 +02001647 pr_debug("i2c-core: attempting to delete unregistered "
1648 "adapter [%s]\n", adap->name);
Lars-Peter Clausen71546302013-03-09 08:16:47 +00001649 return;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001650 }
1651
Lan Tianyu5d98e612014-05-20 20:59:23 +08001652 acpi_i2c_remove_space_handler(adap);
Jean Delvare026526f2008-01-27 18:14:49 +01001653 /* Tell drivers about this removal */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001654 mutex_lock(&core_lock);
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001655 bus_for_each_drv(&i2c_bus_type, NULL, adap,
Jean Delvare69b00892009-12-06 17:06:27 +01001656 __process_removed_adapter);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001657 mutex_unlock(&core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001658
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001659 /* Remove devices instantiated from sysfs */
Jean Delvare390946b2012-09-10 10:14:02 +02001660 mutex_lock_nested(&adap->userspace_clients_lock,
1661 i2c_adapter_depth(adap));
Jean Delvare6629dcf2010-05-04 11:09:28 +02001662 list_for_each_entry_safe(client, next, &adap->userspace_clients,
1663 detected) {
1664 dev_dbg(&adap->dev, "Removing %s at 0x%x\n", client->name,
1665 client->addr);
1666 list_del(&client->detected);
1667 i2c_unregister_device(client);
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001668 }
Jean Delvaredafc50d2010-08-11 18:21:01 +02001669 mutex_unlock(&adap->userspace_clients_lock);
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001670
Jean Delvaree549c2b2009-06-19 16:58:19 +02001671 /* Detach any active clients. This can't fail, thus we do not
Jean Delvare5219bf82011-01-14 22:03:49 +01001672 * check the returned value. This is a two-pass process, because
1673 * we can't remove the dummy devices during the first pass: they
1674 * could have been instantiated by real devices wishing to clean
1675 * them up properly, so we give them a chance to do that first. */
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001676 device_for_each_child(&adap->dev, NULL, __unregister_client);
1677 device_for_each_child(&adap->dev, NULL, __unregister_dummy);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001678
Jean Delvare2bb50952009-09-18 22:45:46 +02001679#ifdef CONFIG_I2C_COMPAT
1680 class_compat_remove_link(i2c_adapter_compat_class, &adap->dev,
1681 adap->dev.parent);
1682#endif
1683
Thadeu Lima de Souza Cascardoc5567522010-01-16 20:43:13 +01001684 /* device name is gone after device_unregister */
1685 dev_dbg(&adap->dev, "adapter [%s] unregistered\n", adap->name);
1686
Wolfram Sang26680ee2015-01-29 22:45:09 +01001687 /* wait until all references to the device are gone
1688 *
1689 * FIXME: This is old code and should ideally be replaced by an
1690 * alternative which results in decoupling the lifetime of the struct
1691 * device from the i2c_adapter, like spi or netdev do. Any solution
Shailendra Verma95cc1e32015-05-18 22:24:01 +05301692 * should be thoroughly tested with DEBUG_KOBJECT_RELEASE enabled!
Wolfram Sang26680ee2015-01-29 22:45:09 +01001693 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001694 init_completion(&adap->dev_released);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001695 device_unregister(&adap->dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001696 wait_for_completion(&adap->dev_released);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001697
David Brownell6e13e642007-05-01 23:26:31 +02001698 /* free bus id */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001699 mutex_lock(&core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001700 idr_remove(&i2c_adapter_idr, adap->nr);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001701 mutex_unlock(&core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001702
Jean Delvarebd4bc3db2008-07-16 19:30:05 +02001703 /* Clear the device structure in case this adapter is ever going to be
1704 added again */
1705 memset(&adap->dev, 0, sizeof(adap->dev));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001706}
David Brownellc0564602007-05-01 23:26:31 +02001707EXPORT_SYMBOL(i2c_del_adapter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001708
David Brownell7b4fbc52007-05-01 23:26:30 +02001709/* ------------------------------------------------------------------------- */
1710
Jean Delvare7ae31482011-03-20 14:50:52 +01001711int i2c_for_each_dev(void *data, int (*fn)(struct device *, void *))
1712{
1713 int res;
1714
1715 mutex_lock(&core_lock);
1716 res = bus_for_each_dev(&i2c_bus_type, NULL, data, fn);
1717 mutex_unlock(&core_lock);
1718
1719 return res;
1720}
1721EXPORT_SYMBOL_GPL(i2c_for_each_dev);
1722
Jean Delvare69b00892009-12-06 17:06:27 +01001723static int __process_new_driver(struct device *dev, void *data)
Dave Young7f101a92008-07-14 22:38:19 +02001724{
Jean Delvare4f8cf822009-09-18 22:45:46 +02001725 if (dev->type != &i2c_adapter_type)
1726 return 0;
Jean Delvare69b00892009-12-06 17:06:27 +01001727 return i2c_do_add_adapter(data, to_i2c_adapter(dev));
Dave Young7f101a92008-07-14 22:38:19 +02001728}
1729
David Brownell7b4fbc52007-05-01 23:26:30 +02001730/*
1731 * An i2c_driver is used with one or more i2c_client (device) nodes to access
Jean Delvare729d6dd2009-06-19 16:58:18 +02001732 * i2c slave chips, on a bus instance associated with some i2c_adapter.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001733 */
1734
Greg Kroah-Hartmande59cf92005-12-06 15:33:15 -08001735int i2c_register_driver(struct module *owner, struct i2c_driver *driver)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001736{
Jean Delvare7eebcb72006-02-05 23:28:21 +01001737 int res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001738
David Brownell1d0b19c2008-10-14 17:30:05 +02001739 /* Can't register until after driver model init */
1740 if (unlikely(WARN_ON(!i2c_bus_type.p)))
1741 return -EAGAIN;
1742
Linus Torvalds1da177e2005-04-16 15:20:36 -07001743 /* add the driver to the list of i2c drivers in the driver core */
Greg Kroah-Hartmande59cf92005-12-06 15:33:15 -08001744 driver->driver.owner = owner;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001745 driver->driver.bus = &i2c_bus_type;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001746
Jean Delvare729d6dd2009-06-19 16:58:18 +02001747 /* When registration returns, the driver core
David Brownell6e13e642007-05-01 23:26:31 +02001748 * will have called probe() for all matching-but-unbound devices.
1749 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001750 res = driver_register(&driver->driver);
1751 if (res)
Jean Delvare7eebcb72006-02-05 23:28:21 +01001752 return res;
David Brownell438d6c22006-12-10 21:21:31 +01001753
Laurent Riffard35d8b2e2005-11-26 20:34:05 +01001754 pr_debug("i2c-core: driver [%s] registered\n", driver->driver.name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001755
Jean Delvare4735c982008-07-14 22:38:36 +02001756 INIT_LIST_HEAD(&driver->clients);
1757 /* Walk the adapters that are already present */
Jean Delvare7ae31482011-03-20 14:50:52 +01001758 i2c_for_each_dev(driver, __process_new_driver);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001759
Jean Delvare7eebcb72006-02-05 23:28:21 +01001760 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001761}
Greg Kroah-Hartmande59cf92005-12-06 15:33:15 -08001762EXPORT_SYMBOL(i2c_register_driver);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001763
Jean Delvare69b00892009-12-06 17:06:27 +01001764static int __process_removed_driver(struct device *dev, void *data)
Dave Young7f101a92008-07-14 22:38:19 +02001765{
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001766 if (dev->type == &i2c_adapter_type)
1767 i2c_do_del_adapter(data, to_i2c_adapter(dev));
1768 return 0;
Dave Young7f101a92008-07-14 22:38:19 +02001769}
1770
David Brownella1d9e6e2007-05-01 23:26:30 +02001771/**
1772 * i2c_del_driver - unregister I2C driver
1773 * @driver: the driver being unregistered
David Brownelld64f73b2007-07-12 14:12:28 +02001774 * Context: can sleep
David Brownella1d9e6e2007-05-01 23:26:30 +02001775 */
Jean Delvareb3e82092007-05-01 23:26:32 +02001776void i2c_del_driver(struct i2c_driver *driver)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001777{
Jean Delvare7ae31482011-03-20 14:50:52 +01001778 i2c_for_each_dev(driver, __process_removed_driver);
David Brownella1d9e6e2007-05-01 23:26:30 +02001779
Linus Torvalds1da177e2005-04-16 15:20:36 -07001780 driver_unregister(&driver->driver);
Laurent Riffard35d8b2e2005-11-26 20:34:05 +01001781 pr_debug("i2c-core: driver [%s] unregistered\n", driver->driver.name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001782}
David Brownellc0564602007-05-01 23:26:31 +02001783EXPORT_SYMBOL(i2c_del_driver);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001784
David Brownell7b4fbc52007-05-01 23:26:30 +02001785/* ------------------------------------------------------------------------- */
1786
Jean Delvaree48d3312008-01-27 18:14:48 +01001787/**
1788 * i2c_use_client - increments the reference count of the i2c client structure
1789 * @client: the client being referenced
1790 *
1791 * Each live reference to a client should be refcounted. The driver model does
1792 * that automatically as part of driver binding, so that most drivers don't
1793 * need to do this explicitly: they hold a reference until they're unbound
1794 * from the device.
1795 *
1796 * A pointer to the client with the incremented reference counter is returned.
1797 */
1798struct i2c_client *i2c_use_client(struct i2c_client *client)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001799{
David Brownell6ea438e2008-07-14 22:38:24 +02001800 if (client && get_device(&client->dev))
1801 return client;
1802 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001803}
David Brownellc0564602007-05-01 23:26:31 +02001804EXPORT_SYMBOL(i2c_use_client);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001805
Jean Delvaree48d3312008-01-27 18:14:48 +01001806/**
1807 * i2c_release_client - release a use of the i2c client structure
1808 * @client: the client being no longer referenced
1809 *
1810 * Must be called when a user of a client is finished with it.
1811 */
1812void i2c_release_client(struct i2c_client *client)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001813{
David Brownell6ea438e2008-07-14 22:38:24 +02001814 if (client)
1815 put_device(&client->dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001816}
David Brownellc0564602007-05-01 23:26:31 +02001817EXPORT_SYMBOL(i2c_release_client);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001818
David Brownell9b766b82008-01-27 18:14:51 +01001819struct i2c_cmd_arg {
1820 unsigned cmd;
1821 void *arg;
1822};
1823
1824static int i2c_cmd(struct device *dev, void *_arg)
1825{
1826 struct i2c_client *client = i2c_verify_client(dev);
1827 struct i2c_cmd_arg *arg = _arg;
Lars-Peter Clausen0acc2b32013-09-29 10:51:06 +02001828 struct i2c_driver *driver;
David Brownell9b766b82008-01-27 18:14:51 +01001829
Lars-Peter Clausen0acc2b32013-09-29 10:51:06 +02001830 if (!client || !client->dev.driver)
1831 return 0;
1832
1833 driver = to_i2c_driver(client->dev.driver);
1834 if (driver->command)
1835 driver->command(client, arg->cmd, arg->arg);
David Brownell9b766b82008-01-27 18:14:51 +01001836 return 0;
1837}
1838
Linus Torvalds1da177e2005-04-16 15:20:36 -07001839void i2c_clients_command(struct i2c_adapter *adap, unsigned int cmd, void *arg)
1840{
David Brownell9b766b82008-01-27 18:14:51 +01001841 struct i2c_cmd_arg cmd_arg;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001842
David Brownell9b766b82008-01-27 18:14:51 +01001843 cmd_arg.cmd = cmd;
1844 cmd_arg.arg = arg;
1845 device_for_each_child(&adap->dev, &cmd_arg, i2c_cmd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001846}
David Brownellc0564602007-05-01 23:26:31 +02001847EXPORT_SYMBOL(i2c_clients_command);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001848
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02001849#if IS_ENABLED(CONFIG_OF_DYNAMIC)
1850static int of_i2c_notify(struct notifier_block *nb, unsigned long action,
1851 void *arg)
1852{
1853 struct of_reconfig_data *rd = arg;
1854 struct i2c_adapter *adap;
1855 struct i2c_client *client;
1856
1857 switch (of_reconfig_get_state_change(action, rd)) {
1858 case OF_RECONFIG_CHANGE_ADD:
1859 adap = of_find_i2c_adapter_by_node(rd->dn->parent);
1860 if (adap == NULL)
1861 return NOTIFY_OK; /* not for us */
1862
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001863 if (of_node_test_and_set_flag(rd->dn, OF_POPULATED)) {
1864 put_device(&adap->dev);
1865 return NOTIFY_OK;
1866 }
1867
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02001868 client = of_i2c_register_device(adap, rd->dn);
1869 put_device(&adap->dev);
1870
1871 if (IS_ERR(client)) {
1872 pr_err("%s: failed to create for '%s'\n",
1873 __func__, rd->dn->full_name);
1874 return notifier_from_errno(PTR_ERR(client));
1875 }
1876 break;
1877 case OF_RECONFIG_CHANGE_REMOVE:
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001878 /* already depopulated? */
1879 if (!of_node_check_flag(rd->dn, OF_POPULATED))
1880 return NOTIFY_OK;
1881
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02001882 /* find our device by node */
1883 client = of_find_i2c_device_by_node(rd->dn);
1884 if (client == NULL)
1885 return NOTIFY_OK; /* no? not meant for us */
1886
1887 /* unregister takes one ref away */
1888 i2c_unregister_device(client);
1889
1890 /* and put the reference of the find */
1891 put_device(&client->dev);
1892 break;
1893 }
1894
1895 return NOTIFY_OK;
1896}
1897static struct notifier_block i2c_of_notifier = {
1898 .notifier_call = of_i2c_notify,
1899};
1900#else
1901extern struct notifier_block i2c_of_notifier;
1902#endif /* CONFIG_OF_DYNAMIC */
1903
Linus Torvalds1da177e2005-04-16 15:20:36 -07001904static int __init i2c_init(void)
1905{
1906 int retval;
1907
Wolfram Sang03bde7c2015-03-12 17:17:59 +01001908 retval = of_alias_get_highest_id("i2c");
1909
1910 down_write(&__i2c_board_lock);
1911 if (retval >= __i2c_first_dynamic_bus_num)
1912 __i2c_first_dynamic_bus_num = retval + 1;
1913 up_write(&__i2c_board_lock);
1914
Linus Torvalds1da177e2005-04-16 15:20:36 -07001915 retval = bus_register(&i2c_bus_type);
1916 if (retval)
1917 return retval;
Jean Delvare2bb50952009-09-18 22:45:46 +02001918#ifdef CONFIG_I2C_COMPAT
1919 i2c_adapter_compat_class = class_compat_register("i2c-adapter");
1920 if (!i2c_adapter_compat_class) {
1921 retval = -ENOMEM;
1922 goto bus_err;
1923 }
1924#endif
David Brownelle9f13732008-01-27 18:14:52 +01001925 retval = i2c_add_driver(&dummy_driver);
1926 if (retval)
Jean Delvare2bb50952009-09-18 22:45:46 +02001927 goto class_err;
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02001928
1929 if (IS_ENABLED(CONFIG_OF_DYNAMIC))
1930 WARN_ON(of_reconfig_notifier_register(&i2c_of_notifier));
1931
David Brownelle9f13732008-01-27 18:14:52 +01001932 return 0;
1933
Jean Delvare2bb50952009-09-18 22:45:46 +02001934class_err:
1935#ifdef CONFIG_I2C_COMPAT
1936 class_compat_unregister(i2c_adapter_compat_class);
David Brownelle9f13732008-01-27 18:14:52 +01001937bus_err:
Jean Delvare2bb50952009-09-18 22:45:46 +02001938#endif
David Brownelle9f13732008-01-27 18:14:52 +01001939 bus_unregister(&i2c_bus_type);
1940 return retval;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001941}
1942
1943static void __exit i2c_exit(void)
1944{
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02001945 if (IS_ENABLED(CONFIG_OF_DYNAMIC))
1946 WARN_ON(of_reconfig_notifier_unregister(&i2c_of_notifier));
David Brownelle9f13732008-01-27 18:14:52 +01001947 i2c_del_driver(&dummy_driver);
Jean Delvare2bb50952009-09-18 22:45:46 +02001948#ifdef CONFIG_I2C_COMPAT
1949 class_compat_unregister(i2c_adapter_compat_class);
1950#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -07001951 bus_unregister(&i2c_bus_type);
David Howellsd9a83d62014-03-06 13:35:59 +00001952 tracepoint_synchronize_unregister();
Linus Torvalds1da177e2005-04-16 15:20:36 -07001953}
1954
David Brownella10f9e72008-10-14 17:30:06 +02001955/* We must initialize early, because some subsystems register i2c drivers
1956 * in subsys_initcall() code, but are linked (and initialized) before i2c.
1957 */
1958postcore_initcall(i2c_init);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001959module_exit(i2c_exit);
1960
1961/* ----------------------------------------------------
1962 * the functional interface to the i2c busses.
1963 * ----------------------------------------------------
1964 */
1965
Wolfram Sangb7f62582015-01-05 23:45:59 +01001966/* Check if val is exceeding the quirk IFF quirk is non 0 */
1967#define i2c_quirk_exceeded(val, quirk) ((quirk) && ((val) > (quirk)))
1968
1969static int i2c_quirk_error(struct i2c_adapter *adap, struct i2c_msg *msg, char *err_msg)
1970{
1971 dev_err_ratelimited(&adap->dev, "adapter quirk: %s (addr 0x%04x, size %u, %s)\n",
1972 err_msg, msg->addr, msg->len,
1973 msg->flags & I2C_M_RD ? "read" : "write");
1974 return -EOPNOTSUPP;
1975}
1976
1977static int i2c_check_for_quirks(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
1978{
1979 const struct i2c_adapter_quirks *q = adap->quirks;
1980 int max_num = q->max_num_msgs, i;
1981 bool do_len_check = true;
1982
1983 if (q->flags & I2C_AQ_COMB) {
1984 max_num = 2;
1985
1986 /* special checks for combined messages */
1987 if (num == 2) {
1988 if (q->flags & I2C_AQ_COMB_WRITE_FIRST && msgs[0].flags & I2C_M_RD)
1989 return i2c_quirk_error(adap, &msgs[0], "1st comb msg must be write");
1990
1991 if (q->flags & I2C_AQ_COMB_READ_SECOND && !(msgs[1].flags & I2C_M_RD))
1992 return i2c_quirk_error(adap, &msgs[1], "2nd comb msg must be read");
1993
1994 if (q->flags & I2C_AQ_COMB_SAME_ADDR && msgs[0].addr != msgs[1].addr)
1995 return i2c_quirk_error(adap, &msgs[0], "comb msg only to same addr");
1996
1997 if (i2c_quirk_exceeded(msgs[0].len, q->max_comb_1st_msg_len))
1998 return i2c_quirk_error(adap, &msgs[0], "msg too long");
1999
2000 if (i2c_quirk_exceeded(msgs[1].len, q->max_comb_2nd_msg_len))
2001 return i2c_quirk_error(adap, &msgs[1], "msg too long");
2002
2003 do_len_check = false;
2004 }
2005 }
2006
2007 if (i2c_quirk_exceeded(num, max_num))
2008 return i2c_quirk_error(adap, &msgs[0], "too many messages");
2009
2010 for (i = 0; i < num; i++) {
2011 u16 len = msgs[i].len;
2012
2013 if (msgs[i].flags & I2C_M_RD) {
2014 if (do_len_check && i2c_quirk_exceeded(len, q->max_read_len))
2015 return i2c_quirk_error(adap, &msgs[i], "msg too long");
2016 } else {
2017 if (do_len_check && i2c_quirk_exceeded(len, q->max_write_len))
2018 return i2c_quirk_error(adap, &msgs[i], "msg too long");
2019 }
2020 }
2021
2022 return 0;
2023}
2024
David Brownella1cdeda2008-07-14 22:38:24 +02002025/**
Jean Delvareb37d2a32012-06-29 07:47:19 -03002026 * __i2c_transfer - unlocked flavor of i2c_transfer
2027 * @adap: Handle to I2C bus
2028 * @msgs: One or more messages to execute before STOP is issued to
2029 * terminate the operation; each message begins with a START.
2030 * @num: Number of messages to be executed.
2031 *
2032 * Returns negative errno, else the number of messages executed.
2033 *
2034 * Adapter lock must be held when calling this function. No debug logging
2035 * takes place. adap->algo->master_xfer existence isn't checked.
2036 */
2037int __i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
2038{
2039 unsigned long orig_jiffies;
2040 int ret, try;
2041
Wolfram Sangb7f62582015-01-05 23:45:59 +01002042 if (adap->quirks && i2c_check_for_quirks(adap, msgs, num))
2043 return -EOPNOTSUPP;
2044
David Howellsd9a83d62014-03-06 13:35:59 +00002045 /* i2c_trace_msg gets enabled when tracepoint i2c_transfer gets
2046 * enabled. This is an efficient way of keeping the for-loop from
2047 * being executed when not needed.
2048 */
2049 if (static_key_false(&i2c_trace_msg)) {
2050 int i;
2051 for (i = 0; i < num; i++)
2052 if (msgs[i].flags & I2C_M_RD)
2053 trace_i2c_read(adap, &msgs[i], i);
2054 else
2055 trace_i2c_write(adap, &msgs[i], i);
2056 }
2057
Jean Delvareb37d2a32012-06-29 07:47:19 -03002058 /* Retry automatically on arbitration loss */
2059 orig_jiffies = jiffies;
2060 for (ret = 0, try = 0; try <= adap->retries; try++) {
2061 ret = adap->algo->master_xfer(adap, msgs, num);
2062 if (ret != -EAGAIN)
2063 break;
2064 if (time_after(jiffies, orig_jiffies + adap->timeout))
2065 break;
2066 }
2067
David Howellsd9a83d62014-03-06 13:35:59 +00002068 if (static_key_false(&i2c_trace_msg)) {
2069 int i;
2070 for (i = 0; i < ret; i++)
2071 if (msgs[i].flags & I2C_M_RD)
2072 trace_i2c_reply(adap, &msgs[i], i);
2073 trace_i2c_result(adap, i, ret);
2074 }
2075
Jean Delvareb37d2a32012-06-29 07:47:19 -03002076 return ret;
2077}
2078EXPORT_SYMBOL(__i2c_transfer);
2079
2080/**
David Brownella1cdeda2008-07-14 22:38:24 +02002081 * i2c_transfer - execute a single or combined I2C message
2082 * @adap: Handle to I2C bus
2083 * @msgs: One or more messages to execute before STOP is issued to
2084 * terminate the operation; each message begins with a START.
2085 * @num: Number of messages to be executed.
2086 *
2087 * Returns negative errno, else the number of messages executed.
2088 *
2089 * Note that there is no requirement that each message be sent to
2090 * the same slave address, although that is the most common model.
2091 */
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01002092int i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002093{
Jean Delvareb37d2a32012-06-29 07:47:19 -03002094 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002095
David Brownella1cdeda2008-07-14 22:38:24 +02002096 /* REVISIT the fault reporting model here is weak:
2097 *
2098 * - When we get an error after receiving N bytes from a slave,
2099 * there is no way to report "N".
2100 *
2101 * - When we get a NAK after transmitting N bytes to a slave,
2102 * there is no way to report "N" ... or to let the master
2103 * continue executing the rest of this combined message, if
2104 * that's the appropriate response.
2105 *
2106 * - When for example "num" is two and we successfully complete
2107 * the first message but get an error part way through the
2108 * second, it's unclear whether that should be reported as
2109 * one (discarding status on the second message) or errno
2110 * (discarding status on the first one).
2111 */
2112
Linus Torvalds1da177e2005-04-16 15:20:36 -07002113 if (adap->algo->master_xfer) {
2114#ifdef DEBUG
2115 for (ret = 0; ret < num; ret++) {
2116 dev_dbg(&adap->dev, "master_xfer[%d] %c, addr=0x%02x, "
Jean Delvare209d27c2007-05-01 23:26:29 +02002117 "len=%d%s\n", ret, (msgs[ret].flags & I2C_M_RD)
2118 ? 'R' : 'W', msgs[ret].addr, msgs[ret].len,
2119 (msgs[ret].flags & I2C_M_RECV_LEN) ? "+" : "");
Linus Torvalds1da177e2005-04-16 15:20:36 -07002120 }
2121#endif
2122
Mike Rapoportcea443a2008-01-27 18:14:50 +01002123 if (in_atomic() || irqs_disabled()) {
Jean Delvarefe61e072010-08-11 18:20:58 +02002124 ret = i2c_trylock_adapter(adap);
Mike Rapoportcea443a2008-01-27 18:14:50 +01002125 if (!ret)
2126 /* I2C activity is ongoing. */
2127 return -EAGAIN;
2128 } else {
Jean Delvarefe61e072010-08-11 18:20:58 +02002129 i2c_lock_adapter(adap);
Mike Rapoportcea443a2008-01-27 18:14:50 +01002130 }
2131
Jean Delvareb37d2a32012-06-29 07:47:19 -03002132 ret = __i2c_transfer(adap, msgs, num);
Jean Delvarefe61e072010-08-11 18:20:58 +02002133 i2c_unlock_adapter(adap);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002134
2135 return ret;
2136 } else {
2137 dev_dbg(&adap->dev, "I2C level transfers not supported\n");
David Brownell24a5bb72008-07-14 22:38:23 +02002138 return -EOPNOTSUPP;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002139 }
2140}
David Brownellc0564602007-05-01 23:26:31 +02002141EXPORT_SYMBOL(i2c_transfer);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002142
David Brownella1cdeda2008-07-14 22:38:24 +02002143/**
2144 * i2c_master_send - issue a single I2C message in master transmit mode
2145 * @client: Handle to slave device
2146 * @buf: Data that will be written to the slave
Zhangfei Gao0c43ea52010-03-02 12:23:49 +01002147 * @count: How many bytes to write, must be less than 64k since msg.len is u16
David Brownella1cdeda2008-07-14 22:38:24 +02002148 *
2149 * Returns negative errno, or else the number of bytes written.
2150 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002151int i2c_master_send(const struct i2c_client *client, const char *buf, int count)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002152{
2153 int ret;
Farid Hammane7225acf2010-05-21 18:40:58 +02002154 struct i2c_adapter *adap = client->adapter;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002155 struct i2c_msg msg;
2156
Jean Delvare815f55f2005-05-07 22:58:46 +02002157 msg.addr = client->addr;
2158 msg.flags = client->flags & I2C_M_TEN;
2159 msg.len = count;
2160 msg.buf = (char *)buf;
David Brownell438d6c22006-12-10 21:21:31 +01002161
Jean Delvare815f55f2005-05-07 22:58:46 +02002162 ret = i2c_transfer(adap, &msg, 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002163
Wolfram Sang834aa6f2012-03-15 18:11:05 +01002164 /*
2165 * If everything went ok (i.e. 1 msg transmitted), return #bytes
2166 * transmitted, else error code.
2167 */
Jean Delvare815f55f2005-05-07 22:58:46 +02002168 return (ret == 1) ? count : ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002169}
David Brownellc0564602007-05-01 23:26:31 +02002170EXPORT_SYMBOL(i2c_master_send);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002171
David Brownella1cdeda2008-07-14 22:38:24 +02002172/**
2173 * i2c_master_recv - issue a single I2C message in master receive mode
2174 * @client: Handle to slave device
2175 * @buf: Where to store data read from slave
Zhangfei Gao0c43ea52010-03-02 12:23:49 +01002176 * @count: How many bytes to read, must be less than 64k since msg.len is u16
David Brownella1cdeda2008-07-14 22:38:24 +02002177 *
2178 * Returns negative errno, or else the number of bytes read.
2179 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002180int i2c_master_recv(const struct i2c_client *client, char *buf, int count)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002181{
Farid Hammane7225acf2010-05-21 18:40:58 +02002182 struct i2c_adapter *adap = client->adapter;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002183 struct i2c_msg msg;
2184 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002185
Jean Delvare815f55f2005-05-07 22:58:46 +02002186 msg.addr = client->addr;
2187 msg.flags = client->flags & I2C_M_TEN;
2188 msg.flags |= I2C_M_RD;
2189 msg.len = count;
2190 msg.buf = buf;
2191
2192 ret = i2c_transfer(adap, &msg, 1);
2193
Wolfram Sang834aa6f2012-03-15 18:11:05 +01002194 /*
2195 * If everything went ok (i.e. 1 msg received), return #bytes received,
2196 * else error code.
2197 */
Jean Delvare815f55f2005-05-07 22:58:46 +02002198 return (ret == 1) ? count : ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002199}
David Brownellc0564602007-05-01 23:26:31 +02002200EXPORT_SYMBOL(i2c_master_recv);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002201
Linus Torvalds1da177e2005-04-16 15:20:36 -07002202/* ----------------------------------------------------
2203 * the i2c address scanning function
2204 * Will not work for 10-bit addresses!
2205 * ----------------------------------------------------
2206 */
Jean Delvare9fc6adf2005-07-31 21:20:43 +02002207
Jean Delvare63e4e802010-06-03 11:33:51 +02002208/*
2209 * Legacy default probe function, mostly relevant for SMBus. The default
2210 * probe method is a quick write, but it is known to corrupt the 24RF08
2211 * EEPROMs due to a state machine bug, and could also irreversibly
2212 * write-protect some EEPROMs, so for address ranges 0x30-0x37 and 0x50-0x5f,
2213 * we use a short byte read instead. Also, some bus drivers don't implement
2214 * quick write, so we fallback to a byte read in that case too.
2215 * On x86, there is another special case for FSC hardware monitoring chips,
2216 * which want regular byte reads (address 0x73.) Fortunately, these are the
2217 * only known chips using this I2C address on PC hardware.
2218 * Returns 1 if probe succeeded, 0 if not.
2219 */
2220static int i2c_default_probe(struct i2c_adapter *adap, unsigned short addr)
2221{
2222 int err;
2223 union i2c_smbus_data dummy;
2224
2225#ifdef CONFIG_X86
2226 if (addr == 0x73 && (adap->class & I2C_CLASS_HWMON)
2227 && i2c_check_functionality(adap, I2C_FUNC_SMBUS_READ_BYTE_DATA))
2228 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2229 I2C_SMBUS_BYTE_DATA, &dummy);
2230 else
2231#endif
Jean Delvare8031d792010-08-11 18:21:00 +02002232 if (!((addr & ~0x07) == 0x30 || (addr & ~0x0f) == 0x50)
2233 && i2c_check_functionality(adap, I2C_FUNC_SMBUS_QUICK))
Jean Delvare63e4e802010-06-03 11:33:51 +02002234 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_WRITE, 0,
2235 I2C_SMBUS_QUICK, NULL);
Jean Delvare8031d792010-08-11 18:21:00 +02002236 else if (i2c_check_functionality(adap, I2C_FUNC_SMBUS_READ_BYTE))
2237 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2238 I2C_SMBUS_BYTE, &dummy);
2239 else {
Andy Lutomirskid63a9e82013-07-17 13:27:59 -07002240 dev_warn(&adap->dev, "No suitable probing method supported for address 0x%02X\n",
2241 addr);
Jean Delvare8031d792010-08-11 18:21:00 +02002242 err = -EOPNOTSUPP;
2243 }
Jean Delvare63e4e802010-06-03 11:33:51 +02002244
2245 return err >= 0;
2246}
2247
Jean Delvareccfbbd02009-12-06 17:06:25 +01002248static int i2c_detect_address(struct i2c_client *temp_client,
Jean Delvare4735c982008-07-14 22:38:36 +02002249 struct i2c_driver *driver)
2250{
2251 struct i2c_board_info info;
2252 struct i2c_adapter *adapter = temp_client->adapter;
2253 int addr = temp_client->addr;
2254 int err;
2255
2256 /* Make sure the address is valid */
Jean Delvare656b8762010-06-03 11:33:53 +02002257 err = i2c_check_addr_validity(addr);
2258 if (err) {
Jean Delvare4735c982008-07-14 22:38:36 +02002259 dev_warn(&adapter->dev, "Invalid probe address 0x%02x\n",
2260 addr);
Jean Delvare656b8762010-06-03 11:33:53 +02002261 return err;
Jean Delvare4735c982008-07-14 22:38:36 +02002262 }
2263
2264 /* Skip if already in use */
Jean Delvare3b5f7942010-06-03 11:33:55 +02002265 if (i2c_check_addr_busy(adapter, addr))
Jean Delvare4735c982008-07-14 22:38:36 +02002266 return 0;
2267
Jean Delvareccfbbd02009-12-06 17:06:25 +01002268 /* Make sure there is something at this address */
Jean Delvare63e4e802010-06-03 11:33:51 +02002269 if (!i2c_default_probe(adapter, addr))
2270 return 0;
Jean Delvare4735c982008-07-14 22:38:36 +02002271
2272 /* Finally call the custom detection function */
2273 memset(&info, 0, sizeof(struct i2c_board_info));
2274 info.addr = addr;
Jean Delvare310ec792009-12-14 21:17:23 +01002275 err = driver->detect(temp_client, &info);
Jean Delvare4735c982008-07-14 22:38:36 +02002276 if (err) {
2277 /* -ENODEV is returned if the detection fails. We catch it
2278 here as this isn't an error. */
2279 return err == -ENODEV ? 0 : err;
2280 }
2281
2282 /* Consistency check */
2283 if (info.type[0] == '\0') {
2284 dev_err(&adapter->dev, "%s detection function provided "
2285 "no name for 0x%x\n", driver->driver.name,
2286 addr);
2287 } else {
2288 struct i2c_client *client;
2289
2290 /* Detection succeeded, instantiate the device */
Wolfram Sang0c176172014-02-10 11:03:56 +01002291 if (adapter->class & I2C_CLASS_DEPRECATED)
2292 dev_warn(&adapter->dev,
2293 "This adapter will soon drop class based instantiation of devices. "
2294 "Please make sure client 0x%02x gets instantiated by other means. "
2295 "Check 'Documentation/i2c/instantiating-devices' for details.\n",
2296 info.addr);
2297
Jean Delvare4735c982008-07-14 22:38:36 +02002298 dev_dbg(&adapter->dev, "Creating %s at 0x%02x\n",
2299 info.type, info.addr);
2300 client = i2c_new_device(adapter, &info);
2301 if (client)
2302 list_add_tail(&client->detected, &driver->clients);
2303 else
2304 dev_err(&adapter->dev, "Failed creating %s at 0x%02x\n",
2305 info.type, info.addr);
2306 }
2307 return 0;
2308}
2309
2310static int i2c_detect(struct i2c_adapter *adapter, struct i2c_driver *driver)
2311{
Jean Delvarec3813d62009-12-14 21:17:25 +01002312 const unsigned short *address_list;
Jean Delvare4735c982008-07-14 22:38:36 +02002313 struct i2c_client *temp_client;
2314 int i, err = 0;
2315 int adap_id = i2c_adapter_id(adapter);
2316
Jean Delvarec3813d62009-12-14 21:17:25 +01002317 address_list = driver->address_list;
2318 if (!driver->detect || !address_list)
Jean Delvare4735c982008-07-14 22:38:36 +02002319 return 0;
2320
Wolfram Sang45552272014-07-10 13:46:21 +02002321 /* Warn that the adapter lost class based instantiation */
2322 if (adapter->class == I2C_CLASS_DEPRECATED) {
2323 dev_dbg(&adapter->dev,
2324 "This adapter dropped support for I2C classes and "
2325 "won't auto-detect %s devices anymore. If you need it, check "
2326 "'Documentation/i2c/instantiating-devices' for alternatives.\n",
2327 driver->driver.name);
2328 return 0;
2329 }
2330
Jean Delvare51b54ba2010-10-24 18:16:58 +02002331 /* Stop here if the classes do not match */
2332 if (!(adapter->class & driver->class))
2333 return 0;
2334
Jean Delvare4735c982008-07-14 22:38:36 +02002335 /* Set up a temporary client to help detect callback */
2336 temp_client = kzalloc(sizeof(struct i2c_client), GFP_KERNEL);
2337 if (!temp_client)
2338 return -ENOMEM;
2339 temp_client->adapter = adapter;
2340
Jean Delvarec3813d62009-12-14 21:17:25 +01002341 for (i = 0; address_list[i] != I2C_CLIENT_END; i += 1) {
Jean Delvare4735c982008-07-14 22:38:36 +02002342 dev_dbg(&adapter->dev, "found normal entry for adapter %d, "
Jean Delvarec3813d62009-12-14 21:17:25 +01002343 "addr 0x%02x\n", adap_id, address_list[i]);
2344 temp_client->addr = address_list[i];
Jean Delvareccfbbd02009-12-06 17:06:25 +01002345 err = i2c_detect_address(temp_client, driver);
Jean Delvare51b54ba2010-10-24 18:16:58 +02002346 if (unlikely(err))
2347 break;
Jean Delvare4735c982008-07-14 22:38:36 +02002348 }
2349
Jean Delvare4735c982008-07-14 22:38:36 +02002350 kfree(temp_client);
2351 return err;
2352}
2353
Jean Delvared44f19d2010-08-11 18:20:57 +02002354int i2c_probe_func_quick_read(struct i2c_adapter *adap, unsigned short addr)
2355{
2356 return i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2357 I2C_SMBUS_QUICK, NULL) >= 0;
2358}
2359EXPORT_SYMBOL_GPL(i2c_probe_func_quick_read);
2360
Jean Delvare12b5053a2007-05-01 23:26:31 +02002361struct i2c_client *
2362i2c_new_probed_device(struct i2c_adapter *adap,
2363 struct i2c_board_info *info,
Jean Delvare9a942412010-08-11 18:20:56 +02002364 unsigned short const *addr_list,
2365 int (*probe)(struct i2c_adapter *, unsigned short addr))
Jean Delvare12b5053a2007-05-01 23:26:31 +02002366{
2367 int i;
2368
Jean Delvare8031d792010-08-11 18:21:00 +02002369 if (!probe)
Jean Delvare9a942412010-08-11 18:20:56 +02002370 probe = i2c_default_probe;
Jean Delvare12b5053a2007-05-01 23:26:31 +02002371
Jean Delvare12b5053a2007-05-01 23:26:31 +02002372 for (i = 0; addr_list[i] != I2C_CLIENT_END; i++) {
2373 /* Check address validity */
Jean Delvare656b8762010-06-03 11:33:53 +02002374 if (i2c_check_addr_validity(addr_list[i]) < 0) {
Jean Delvare12b5053a2007-05-01 23:26:31 +02002375 dev_warn(&adap->dev, "Invalid 7-bit address "
2376 "0x%02x\n", addr_list[i]);
2377 continue;
2378 }
2379
2380 /* Check address availability */
Jean Delvare3b5f7942010-06-03 11:33:55 +02002381 if (i2c_check_addr_busy(adap, addr_list[i])) {
Jean Delvare12b5053a2007-05-01 23:26:31 +02002382 dev_dbg(&adap->dev, "Address 0x%02x already in "
2383 "use, not probing\n", addr_list[i]);
2384 continue;
2385 }
2386
Jean Delvare63e4e802010-06-03 11:33:51 +02002387 /* Test address responsiveness */
Jean Delvare9a942412010-08-11 18:20:56 +02002388 if (probe(adap, addr_list[i]))
Jean Delvare63e4e802010-06-03 11:33:51 +02002389 break;
Jean Delvare12b5053a2007-05-01 23:26:31 +02002390 }
Jean Delvare12b5053a2007-05-01 23:26:31 +02002391
2392 if (addr_list[i] == I2C_CLIENT_END) {
2393 dev_dbg(&adap->dev, "Probing failed, no device found\n");
2394 return NULL;
2395 }
2396
2397 info->addr = addr_list[i];
2398 return i2c_new_device(adap, info);
2399}
2400EXPORT_SYMBOL_GPL(i2c_new_probed_device);
2401
Jean Delvared735b342011-03-20 14:50:52 +01002402struct i2c_adapter *i2c_get_adapter(int nr)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002403{
Linus Torvalds1da177e2005-04-16 15:20:36 -07002404 struct i2c_adapter *adapter;
David Brownell438d6c22006-12-10 21:21:31 +01002405
Jean Delvarecaada322008-01-27 18:14:49 +01002406 mutex_lock(&core_lock);
Jean Delvared735b342011-03-20 14:50:52 +01002407 adapter = idr_find(&i2c_adapter_idr, nr);
Mark M. Hoffmana0920e12005-06-28 00:21:30 -04002408 if (adapter && !try_module_get(adapter->owner))
2409 adapter = NULL;
2410
Jean Delvarecaada322008-01-27 18:14:49 +01002411 mutex_unlock(&core_lock);
Mark M. Hoffmana0920e12005-06-28 00:21:30 -04002412 return adapter;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002413}
David Brownellc0564602007-05-01 23:26:31 +02002414EXPORT_SYMBOL(i2c_get_adapter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002415
2416void i2c_put_adapter(struct i2c_adapter *adap)
2417{
Sebastian Hesselbarthc66c4cc2013-08-01 14:10:46 +02002418 if (adap)
2419 module_put(adap->owner);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002420}
David Brownellc0564602007-05-01 23:26:31 +02002421EXPORT_SYMBOL(i2c_put_adapter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002422
2423/* The SMBus parts */
2424
David Brownell438d6c22006-12-10 21:21:31 +01002425#define POLY (0x1070U << 3)
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01002426static u8 crc8(u16 data)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002427{
2428 int i;
David Brownell438d6c22006-12-10 21:21:31 +01002429
Farid Hammane7225acf2010-05-21 18:40:58 +02002430 for (i = 0; i < 8; i++) {
David Brownell438d6c22006-12-10 21:21:31 +01002431 if (data & 0x8000)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002432 data = data ^ POLY;
2433 data = data << 1;
2434 }
2435 return (u8)(data >> 8);
2436}
2437
Jean Delvare421ef472005-10-26 21:28:55 +02002438/* Incremental CRC8 over count bytes in the array pointed to by p */
2439static u8 i2c_smbus_pec(u8 crc, u8 *p, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002440{
2441 int i;
2442
Farid Hammane7225acf2010-05-21 18:40:58 +02002443 for (i = 0; i < count; i++)
Jean Delvare421ef472005-10-26 21:28:55 +02002444 crc = crc8((crc ^ p[i]) << 8);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002445 return crc;
2446}
2447
Jean Delvare421ef472005-10-26 21:28:55 +02002448/* Assume a 7-bit address, which is reasonable for SMBus */
2449static u8 i2c_smbus_msg_pec(u8 pec, struct i2c_msg *msg)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002450{
Jean Delvare421ef472005-10-26 21:28:55 +02002451 /* The address will be sent first */
2452 u8 addr = (msg->addr << 1) | !!(msg->flags & I2C_M_RD);
2453 pec = i2c_smbus_pec(pec, &addr, 1);
2454
2455 /* The data buffer follows */
2456 return i2c_smbus_pec(pec, msg->buf, msg->len);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002457}
2458
Jean Delvare421ef472005-10-26 21:28:55 +02002459/* Used for write only transactions */
2460static inline void i2c_smbus_add_pec(struct i2c_msg *msg)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002461{
Jean Delvare421ef472005-10-26 21:28:55 +02002462 msg->buf[msg->len] = i2c_smbus_msg_pec(0, msg);
2463 msg->len++;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002464}
2465
Jean Delvare421ef472005-10-26 21:28:55 +02002466/* Return <0 on CRC error
2467 If there was a write before this read (most cases) we need to take the
2468 partial CRC from the write part into account.
2469 Note that this function does modify the message (we need to decrease the
2470 message length to hide the CRC byte from the caller). */
2471static int i2c_smbus_check_pec(u8 cpec, struct i2c_msg *msg)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002472{
Jean Delvare421ef472005-10-26 21:28:55 +02002473 u8 rpec = msg->buf[--msg->len];
2474 cpec = i2c_smbus_msg_pec(cpec, msg);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002475
Linus Torvalds1da177e2005-04-16 15:20:36 -07002476 if (rpec != cpec) {
2477 pr_debug("i2c-core: Bad PEC 0x%02x vs. 0x%02x\n",
2478 rpec, cpec);
David Brownell24a5bb72008-07-14 22:38:23 +02002479 return -EBADMSG;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002480 }
David Brownell438d6c22006-12-10 21:21:31 +01002481 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002482}
2483
David Brownella1cdeda2008-07-14 22:38:24 +02002484/**
2485 * i2c_smbus_read_byte - SMBus "receive byte" protocol
2486 * @client: Handle to slave device
2487 *
2488 * This executes the SMBus "receive byte" protocol, returning negative errno
2489 * else the byte received from the device.
2490 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002491s32 i2c_smbus_read_byte(const struct i2c_client *client)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002492{
2493 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002494 int status;
2495
2496 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2497 I2C_SMBUS_READ, 0,
2498 I2C_SMBUS_BYTE, &data);
2499 return (status < 0) ? status : data.byte;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002500}
David Brownellc0564602007-05-01 23:26:31 +02002501EXPORT_SYMBOL(i2c_smbus_read_byte);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002502
David Brownella1cdeda2008-07-14 22:38:24 +02002503/**
2504 * i2c_smbus_write_byte - SMBus "send byte" protocol
2505 * @client: Handle to slave device
2506 * @value: Byte to be sent
2507 *
2508 * This executes the SMBus "send byte" protocol, returning negative errno
2509 * else zero on success.
2510 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002511s32 i2c_smbus_write_byte(const struct i2c_client *client, u8 value)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002512{
Farid Hammane7225acf2010-05-21 18:40:58 +02002513 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
Jean Delvare421ef472005-10-26 21:28:55 +02002514 I2C_SMBUS_WRITE, value, I2C_SMBUS_BYTE, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002515}
David Brownellc0564602007-05-01 23:26:31 +02002516EXPORT_SYMBOL(i2c_smbus_write_byte);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002517
David Brownella1cdeda2008-07-14 22:38:24 +02002518/**
2519 * i2c_smbus_read_byte_data - SMBus "read byte" protocol
2520 * @client: Handle to slave device
2521 * @command: Byte interpreted by slave
2522 *
2523 * This executes the SMBus "read byte" protocol, returning negative errno
2524 * else a data byte received from the device.
2525 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002526s32 i2c_smbus_read_byte_data(const struct i2c_client *client, u8 command)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002527{
2528 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002529 int status;
2530
2531 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2532 I2C_SMBUS_READ, command,
2533 I2C_SMBUS_BYTE_DATA, &data);
2534 return (status < 0) ? status : data.byte;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002535}
David Brownellc0564602007-05-01 23:26:31 +02002536EXPORT_SYMBOL(i2c_smbus_read_byte_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002537
David Brownella1cdeda2008-07-14 22:38:24 +02002538/**
2539 * i2c_smbus_write_byte_data - SMBus "write byte" protocol
2540 * @client: Handle to slave device
2541 * @command: Byte interpreted by slave
2542 * @value: Byte being written
2543 *
2544 * This executes the SMBus "write byte" protocol, returning negative errno
2545 * else zero on success.
2546 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002547s32 i2c_smbus_write_byte_data(const struct i2c_client *client, u8 command,
2548 u8 value)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002549{
2550 union i2c_smbus_data data;
2551 data.byte = value;
Farid Hammane7225acf2010-05-21 18:40:58 +02002552 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2553 I2C_SMBUS_WRITE, command,
2554 I2C_SMBUS_BYTE_DATA, &data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002555}
David Brownellc0564602007-05-01 23:26:31 +02002556EXPORT_SYMBOL(i2c_smbus_write_byte_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002557
David Brownella1cdeda2008-07-14 22:38:24 +02002558/**
2559 * i2c_smbus_read_word_data - SMBus "read word" protocol
2560 * @client: Handle to slave device
2561 * @command: Byte interpreted by slave
2562 *
2563 * This executes the SMBus "read word" protocol, returning negative errno
2564 * else a 16-bit unsigned "word" received from the device.
2565 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002566s32 i2c_smbus_read_word_data(const struct i2c_client *client, u8 command)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002567{
2568 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002569 int status;
2570
2571 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2572 I2C_SMBUS_READ, command,
2573 I2C_SMBUS_WORD_DATA, &data);
2574 return (status < 0) ? status : data.word;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002575}
David Brownellc0564602007-05-01 23:26:31 +02002576EXPORT_SYMBOL(i2c_smbus_read_word_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002577
David Brownella1cdeda2008-07-14 22:38:24 +02002578/**
2579 * i2c_smbus_write_word_data - SMBus "write word" protocol
2580 * @client: Handle to slave device
2581 * @command: Byte interpreted by slave
2582 * @value: 16-bit "word" being written
2583 *
2584 * This executes the SMBus "write word" protocol, returning negative errno
2585 * else zero on success.
2586 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002587s32 i2c_smbus_write_word_data(const struct i2c_client *client, u8 command,
2588 u16 value)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002589{
2590 union i2c_smbus_data data;
2591 data.word = value;
Farid Hammane7225acf2010-05-21 18:40:58 +02002592 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2593 I2C_SMBUS_WRITE, command,
2594 I2C_SMBUS_WORD_DATA, &data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002595}
David Brownellc0564602007-05-01 23:26:31 +02002596EXPORT_SYMBOL(i2c_smbus_write_word_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002597
David Brownella64ec072007-10-13 23:56:31 +02002598/**
David Brownella1cdeda2008-07-14 22:38:24 +02002599 * i2c_smbus_read_block_data - SMBus "block read" protocol
David Brownella64ec072007-10-13 23:56:31 +02002600 * @client: Handle to slave device
David Brownella1cdeda2008-07-14 22:38:24 +02002601 * @command: Byte interpreted by slave
David Brownella64ec072007-10-13 23:56:31 +02002602 * @values: Byte array into which data will be read; big enough to hold
2603 * the data returned by the slave. SMBus allows at most 32 bytes.
2604 *
David Brownella1cdeda2008-07-14 22:38:24 +02002605 * This executes the SMBus "block read" protocol, returning negative errno
2606 * else the number of data bytes in the slave's response.
David Brownella64ec072007-10-13 23:56:31 +02002607 *
2608 * Note that using this function requires that the client's adapter support
2609 * the I2C_FUNC_SMBUS_READ_BLOCK_DATA functionality. Not all adapter drivers
2610 * support this; its emulation through I2C messaging relies on a specific
2611 * mechanism (I2C_M_RECV_LEN) which may not be implemented.
2612 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002613s32 i2c_smbus_read_block_data(const struct i2c_client *client, u8 command,
Jean Delvareb86a1bc2007-05-01 23:26:34 +02002614 u8 *values)
2615{
2616 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002617 int status;
Jean Delvareb86a1bc2007-05-01 23:26:34 +02002618
David Brownell24a5bb72008-07-14 22:38:23 +02002619 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2620 I2C_SMBUS_READ, command,
2621 I2C_SMBUS_BLOCK_DATA, &data);
2622 if (status)
2623 return status;
Jean Delvareb86a1bc2007-05-01 23:26:34 +02002624
2625 memcpy(values, &data.block[1], data.block[0]);
2626 return data.block[0];
2627}
2628EXPORT_SYMBOL(i2c_smbus_read_block_data);
2629
David Brownella1cdeda2008-07-14 22:38:24 +02002630/**
2631 * i2c_smbus_write_block_data - SMBus "block write" protocol
2632 * @client: Handle to slave device
2633 * @command: Byte interpreted by slave
2634 * @length: Size of data block; SMBus allows at most 32 bytes
2635 * @values: Byte array which will be written.
2636 *
2637 * This executes the SMBus "block write" protocol, returning negative errno
2638 * else zero on success.
2639 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002640s32 i2c_smbus_write_block_data(const struct i2c_client *client, u8 command,
Krzysztof Halasa46f5ed72006-06-12 21:42:20 +02002641 u8 length, const u8 *values)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002642{
2643 union i2c_smbus_data data;
Jean Delvare76560322006-01-18 23:14:55 +01002644
Linus Torvalds1da177e2005-04-16 15:20:36 -07002645 if (length > I2C_SMBUS_BLOCK_MAX)
2646 length = I2C_SMBUS_BLOCK_MAX;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002647 data.block[0] = length;
Jean Delvare76560322006-01-18 23:14:55 +01002648 memcpy(&data.block[1], values, length);
Farid Hammane7225acf2010-05-21 18:40:58 +02002649 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2650 I2C_SMBUS_WRITE, command,
2651 I2C_SMBUS_BLOCK_DATA, &data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002652}
David Brownellc0564602007-05-01 23:26:31 +02002653EXPORT_SYMBOL(i2c_smbus_write_block_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002654
2655/* Returns the number of read bytes */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002656s32 i2c_smbus_read_i2c_block_data(const struct i2c_client *client, u8 command,
Jean Delvare4b2643d2007-07-12 14:12:29 +02002657 u8 length, u8 *values)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002658{
2659 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002660 int status;
Jean Delvare76560322006-01-18 23:14:55 +01002661
Jean Delvare4b2643d2007-07-12 14:12:29 +02002662 if (length > I2C_SMBUS_BLOCK_MAX)
2663 length = I2C_SMBUS_BLOCK_MAX;
2664 data.block[0] = length;
David Brownell24a5bb72008-07-14 22:38:23 +02002665 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2666 I2C_SMBUS_READ, command,
2667 I2C_SMBUS_I2C_BLOCK_DATA, &data);
2668 if (status < 0)
2669 return status;
Jean Delvare76560322006-01-18 23:14:55 +01002670
2671 memcpy(values, &data.block[1], data.block[0]);
2672 return data.block[0];
Linus Torvalds1da177e2005-04-16 15:20:36 -07002673}
David Brownellc0564602007-05-01 23:26:31 +02002674EXPORT_SYMBOL(i2c_smbus_read_i2c_block_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002675
Jean Delvare0cc43a12011-01-10 22:11:23 +01002676s32 i2c_smbus_write_i2c_block_data(const struct i2c_client *client, u8 command,
Krzysztof Halasa46f5ed72006-06-12 21:42:20 +02002677 u8 length, const u8 *values)
Jean Delvare21bbd692006-01-09 15:19:18 +11002678{
2679 union i2c_smbus_data data;
2680
2681 if (length > I2C_SMBUS_BLOCK_MAX)
2682 length = I2C_SMBUS_BLOCK_MAX;
2683 data.block[0] = length;
2684 memcpy(data.block + 1, values, length);
2685 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2686 I2C_SMBUS_WRITE, command,
2687 I2C_SMBUS_I2C_BLOCK_DATA, &data);
2688}
David Brownellc0564602007-05-01 23:26:31 +02002689EXPORT_SYMBOL(i2c_smbus_write_i2c_block_data);
Jean Delvare21bbd692006-01-09 15:19:18 +11002690
David Brownell438d6c22006-12-10 21:21:31 +01002691/* Simulate a SMBus command using the i2c protocol
Linus Torvalds1da177e2005-04-16 15:20:36 -07002692 No checking of parameters is done! */
Farid Hammane7225acf2010-05-21 18:40:58 +02002693static s32 i2c_smbus_xfer_emulated(struct i2c_adapter *adapter, u16 addr,
2694 unsigned short flags,
2695 char read_write, u8 command, int size,
2696 union i2c_smbus_data *data)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002697{
2698 /* So we need to generate a series of msgs. In the case of writing, we
2699 need to use only one message; when reading, we need two. We initialize
2700 most things with sane defaults, to keep the code below somewhat
2701 simpler. */
Hideki Iwamoto5c50d182005-09-25 17:01:11 +02002702 unsigned char msgbuf0[I2C_SMBUS_BLOCK_MAX+3];
2703 unsigned char msgbuf1[I2C_SMBUS_BLOCK_MAX+2];
Farid Hammane7225acf2010-05-21 18:40:58 +02002704 int num = read_write == I2C_SMBUS_READ ? 2 : 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002705 int i;
Jean Delvare421ef472005-10-26 21:28:55 +02002706 u8 partial_pec = 0;
David Brownell24a5bb72008-07-14 22:38:23 +02002707 int status;
Shubhrajyoti D230da092012-10-05 22:23:52 +02002708 struct i2c_msg msg[2] = {
2709 {
2710 .addr = addr,
2711 .flags = flags,
2712 .len = 1,
2713 .buf = msgbuf0,
2714 }, {
2715 .addr = addr,
2716 .flags = flags | I2C_M_RD,
2717 .len = 0,
2718 .buf = msgbuf1,
2719 },
2720 };
Linus Torvalds1da177e2005-04-16 15:20:36 -07002721
2722 msgbuf0[0] = command;
Farid Hammane7225acf2010-05-21 18:40:58 +02002723 switch (size) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002724 case I2C_SMBUS_QUICK:
2725 msg[0].len = 0;
2726 /* Special case: The read/write field is used as data */
Roel Kluinf29d2e02009-02-24 19:19:48 +01002727 msg[0].flags = flags | (read_write == I2C_SMBUS_READ ?
2728 I2C_M_RD : 0);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002729 num = 1;
2730 break;
2731 case I2C_SMBUS_BYTE:
2732 if (read_write == I2C_SMBUS_READ) {
2733 /* Special case: only a read! */
2734 msg[0].flags = I2C_M_RD | flags;
2735 num = 1;
2736 }
2737 break;
2738 case I2C_SMBUS_BYTE_DATA:
2739 if (read_write == I2C_SMBUS_READ)
2740 msg[1].len = 1;
2741 else {
2742 msg[0].len = 2;
2743 msgbuf0[1] = data->byte;
2744 }
2745 break;
2746 case I2C_SMBUS_WORD_DATA:
2747 if (read_write == I2C_SMBUS_READ)
2748 msg[1].len = 2;
2749 else {
Farid Hammane7225acf2010-05-21 18:40:58 +02002750 msg[0].len = 3;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002751 msgbuf0[1] = data->word & 0xff;
Jean Delvare7eff82c2006-09-03 22:24:00 +02002752 msgbuf0[2] = data->word >> 8;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002753 }
2754 break;
2755 case I2C_SMBUS_PROC_CALL:
2756 num = 2; /* Special case */
2757 read_write = I2C_SMBUS_READ;
2758 msg[0].len = 3;
2759 msg[1].len = 2;
2760 msgbuf0[1] = data->word & 0xff;
Jean Delvare7eff82c2006-09-03 22:24:00 +02002761 msgbuf0[2] = data->word >> 8;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002762 break;
2763 case I2C_SMBUS_BLOCK_DATA:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002764 if (read_write == I2C_SMBUS_READ) {
Jean Delvare209d27c2007-05-01 23:26:29 +02002765 msg[1].flags |= I2C_M_RECV_LEN;
2766 msg[1].len = 1; /* block length will be added by
2767 the underlying bus driver */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002768 } else {
2769 msg[0].len = data->block[0] + 2;
2770 if (msg[0].len > I2C_SMBUS_BLOCK_MAX + 2) {
David Brownell24a5bb72008-07-14 22:38:23 +02002771 dev_err(&adapter->dev,
2772 "Invalid block write size %d\n",
2773 data->block[0]);
2774 return -EINVAL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002775 }
Hideki Iwamoto5c50d182005-09-25 17:01:11 +02002776 for (i = 1; i < msg[0].len; i++)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002777 msgbuf0[i] = data->block[i-1];
2778 }
2779 break;
2780 case I2C_SMBUS_BLOCK_PROC_CALL:
Jean Delvare209d27c2007-05-01 23:26:29 +02002781 num = 2; /* Another special case */
2782 read_write = I2C_SMBUS_READ;
2783 if (data->block[0] > I2C_SMBUS_BLOCK_MAX) {
David Brownell24a5bb72008-07-14 22:38:23 +02002784 dev_err(&adapter->dev,
2785 "Invalid block write size %d\n",
Jean Delvare209d27c2007-05-01 23:26:29 +02002786 data->block[0]);
David Brownell24a5bb72008-07-14 22:38:23 +02002787 return -EINVAL;
Jean Delvare209d27c2007-05-01 23:26:29 +02002788 }
2789 msg[0].len = data->block[0] + 2;
2790 for (i = 1; i < msg[0].len; i++)
2791 msgbuf0[i] = data->block[i-1];
2792 msg[1].flags |= I2C_M_RECV_LEN;
2793 msg[1].len = 1; /* block length will be added by
2794 the underlying bus driver */
2795 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002796 case I2C_SMBUS_I2C_BLOCK_DATA:
2797 if (read_write == I2C_SMBUS_READ) {
Jean Delvare4b2643d2007-07-12 14:12:29 +02002798 msg[1].len = data->block[0];
Linus Torvalds1da177e2005-04-16 15:20:36 -07002799 } else {
2800 msg[0].len = data->block[0] + 1;
Jean Delvare30dac742005-10-08 00:15:59 +02002801 if (msg[0].len > I2C_SMBUS_BLOCK_MAX + 1) {
David Brownell24a5bb72008-07-14 22:38:23 +02002802 dev_err(&adapter->dev,
2803 "Invalid block write size %d\n",
2804 data->block[0]);
2805 return -EINVAL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002806 }
2807 for (i = 1; i <= data->block[0]; i++)
2808 msgbuf0[i] = data->block[i];
2809 }
2810 break;
2811 default:
David Brownell24a5bb72008-07-14 22:38:23 +02002812 dev_err(&adapter->dev, "Unsupported transaction %d\n", size);
2813 return -EOPNOTSUPP;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002814 }
2815
Jean Delvare421ef472005-10-26 21:28:55 +02002816 i = ((flags & I2C_CLIENT_PEC) && size != I2C_SMBUS_QUICK
2817 && size != I2C_SMBUS_I2C_BLOCK_DATA);
2818 if (i) {
2819 /* Compute PEC if first message is a write */
2820 if (!(msg[0].flags & I2C_M_RD)) {
David Brownell438d6c22006-12-10 21:21:31 +01002821 if (num == 1) /* Write only */
Jean Delvare421ef472005-10-26 21:28:55 +02002822 i2c_smbus_add_pec(&msg[0]);
2823 else /* Write followed by read */
2824 partial_pec = i2c_smbus_msg_pec(0, &msg[0]);
2825 }
2826 /* Ask for PEC if last message is a read */
2827 if (msg[num-1].flags & I2C_M_RD)
David Brownell438d6c22006-12-10 21:21:31 +01002828 msg[num-1].len++;
Jean Delvare421ef472005-10-26 21:28:55 +02002829 }
2830
David Brownell24a5bb72008-07-14 22:38:23 +02002831 status = i2c_transfer(adapter, msg, num);
2832 if (status < 0)
2833 return status;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002834
Jean Delvare421ef472005-10-26 21:28:55 +02002835 /* Check PEC if last message is a read */
2836 if (i && (msg[num-1].flags & I2C_M_RD)) {
David Brownell24a5bb72008-07-14 22:38:23 +02002837 status = i2c_smbus_check_pec(partial_pec, &msg[num-1]);
2838 if (status < 0)
2839 return status;
Jean Delvare421ef472005-10-26 21:28:55 +02002840 }
2841
Linus Torvalds1da177e2005-04-16 15:20:36 -07002842 if (read_write == I2C_SMBUS_READ)
Farid Hammane7225acf2010-05-21 18:40:58 +02002843 switch (size) {
2844 case I2C_SMBUS_BYTE:
2845 data->byte = msgbuf0[0];
2846 break;
2847 case I2C_SMBUS_BYTE_DATA:
2848 data->byte = msgbuf1[0];
2849 break;
2850 case I2C_SMBUS_WORD_DATA:
2851 case I2C_SMBUS_PROC_CALL:
2852 data->word = msgbuf1[0] | (msgbuf1[1] << 8);
2853 break;
2854 case I2C_SMBUS_I2C_BLOCK_DATA:
2855 for (i = 0; i < data->block[0]; i++)
2856 data->block[i+1] = msgbuf1[i];
2857 break;
2858 case I2C_SMBUS_BLOCK_DATA:
2859 case I2C_SMBUS_BLOCK_PROC_CALL:
2860 for (i = 0; i < msgbuf1[0] + 1; i++)
2861 data->block[i] = msgbuf1[i];
2862 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002863 }
2864 return 0;
2865}
2866
David Brownella1cdeda2008-07-14 22:38:24 +02002867/**
2868 * i2c_smbus_xfer - execute SMBus protocol operations
2869 * @adapter: Handle to I2C bus
2870 * @addr: Address of SMBus slave on that bus
2871 * @flags: I2C_CLIENT_* flags (usually zero or I2C_CLIENT_PEC)
2872 * @read_write: I2C_SMBUS_READ or I2C_SMBUS_WRITE
2873 * @command: Byte interpreted by slave, for protocols which use such bytes
2874 * @protocol: SMBus protocol operation to execute, such as I2C_SMBUS_PROC_CALL
2875 * @data: Data to be read or written
2876 *
2877 * This executes an SMBus protocol operation, and returns a negative
2878 * errno code else zero on success.
2879 */
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01002880s32 i2c_smbus_xfer(struct i2c_adapter *adapter, u16 addr, unsigned short flags,
David Brownella1cdeda2008-07-14 22:38:24 +02002881 char read_write, u8 command, int protocol,
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01002882 union i2c_smbus_data *data)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002883{
Clifford Wolf66b650f2009-06-15 18:01:46 +02002884 unsigned long orig_jiffies;
2885 int try;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002886 s32 res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002887
David Howells8a325992014-03-06 13:36:06 +00002888 /* If enabled, the following two tracepoints are conditional on
2889 * read_write and protocol.
2890 */
2891 trace_smbus_write(adapter, addr, flags, read_write,
2892 command, protocol, data);
2893 trace_smbus_read(adapter, addr, flags, read_write,
2894 command, protocol);
2895
Laurent Pinchartd47726c2012-07-24 14:13:59 +02002896 flags &= I2C_M_TEN | I2C_CLIENT_PEC | I2C_CLIENT_SCCB;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002897
2898 if (adapter->algo->smbus_xfer) {
Jean Delvarefe61e072010-08-11 18:20:58 +02002899 i2c_lock_adapter(adapter);
Clifford Wolf66b650f2009-06-15 18:01:46 +02002900
2901 /* Retry automatically on arbitration loss */
2902 orig_jiffies = jiffies;
2903 for (res = 0, try = 0; try <= adapter->retries; try++) {
2904 res = adapter->algo->smbus_xfer(adapter, addr, flags,
2905 read_write, command,
2906 protocol, data);
2907 if (res != -EAGAIN)
2908 break;
2909 if (time_after(jiffies,
2910 orig_jiffies + adapter->timeout))
2911 break;
2912 }
Jean Delvarefe61e072010-08-11 18:20:58 +02002913 i2c_unlock_adapter(adapter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002914
Laurent Pinchart72fc2c72012-07-24 14:13:59 +02002915 if (res != -EOPNOTSUPP || !adapter->algo->master_xfer)
David Howells8a325992014-03-06 13:36:06 +00002916 goto trace;
Laurent Pinchart72fc2c72012-07-24 14:13:59 +02002917 /*
2918 * Fall back to i2c_smbus_xfer_emulated if the adapter doesn't
2919 * implement native support for the SMBus operation.
2920 */
2921 }
2922
David Howells8a325992014-03-06 13:36:06 +00002923 res = i2c_smbus_xfer_emulated(adapter, addr, flags, read_write,
2924 command, protocol, data);
2925
2926trace:
2927 /* If enabled, the reply tracepoint is conditional on read_write. */
2928 trace_smbus_reply(adapter, addr, flags, read_write,
2929 command, protocol, data);
2930 trace_smbus_result(adapter, addr, flags, read_write,
2931 command, protocol, res);
2932
2933 return res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002934}
Linus Torvalds1da177e2005-04-16 15:20:36 -07002935EXPORT_SYMBOL(i2c_smbus_xfer);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002936
Jean Delvared5fd1202015-01-26 20:59:31 +01002937#if IS_ENABLED(CONFIG_I2C_SLAVE)
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002938int i2c_slave_register(struct i2c_client *client, i2c_slave_cb_t slave_cb)
2939{
2940 int ret;
2941
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002942 if (!client || !slave_cb) {
2943 WARN(1, "insufficent data\n");
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002944 return -EINVAL;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002945 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002946
2947 if (!(client->flags & I2C_CLIENT_TEN)) {
2948 /* Enforce stricter address checking */
2949 ret = i2c_check_addr_validity(client->addr);
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002950 if (ret) {
2951 dev_err(&client->dev, "%s: invalid address\n", __func__);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002952 return ret;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002953 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002954 }
2955
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002956 if (!client->adapter->algo->reg_slave) {
2957 dev_err(&client->dev, "%s: not supported by adapter\n", __func__);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002958 return -EOPNOTSUPP;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002959 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002960
2961 client->slave_cb = slave_cb;
2962
2963 i2c_lock_adapter(client->adapter);
2964 ret = client->adapter->algo->reg_slave(client);
2965 i2c_unlock_adapter(client->adapter);
2966
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002967 if (ret) {
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002968 client->slave_cb = NULL;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002969 dev_err(&client->dev, "%s: adapter returned error %d\n", __func__, ret);
2970 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002971
2972 return ret;
2973}
2974EXPORT_SYMBOL_GPL(i2c_slave_register);
2975
2976int i2c_slave_unregister(struct i2c_client *client)
2977{
2978 int ret;
2979
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002980 if (!client->adapter->algo->unreg_slave) {
2981 dev_err(&client->dev, "%s: not supported by adapter\n", __func__);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002982 return -EOPNOTSUPP;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002983 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002984
2985 i2c_lock_adapter(client->adapter);
2986 ret = client->adapter->algo->unreg_slave(client);
2987 i2c_unlock_adapter(client->adapter);
2988
2989 if (ret == 0)
2990 client->slave_cb = NULL;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02002991 else
2992 dev_err(&client->dev, "%s: adapter returned error %d\n", __func__, ret);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002993
2994 return ret;
2995}
2996EXPORT_SYMBOL_GPL(i2c_slave_unregister);
Jean Delvared5fd1202015-01-26 20:59:31 +01002997#endif
Wolfram Sang4b1acc42014-11-18 17:04:53 +01002998
Linus Torvalds1da177e2005-04-16 15:20:36 -07002999MODULE_AUTHOR("Simon G. Vogl <simon@tk.uni-linz.ac.at>");
3000MODULE_DESCRIPTION("I2C-Bus main module");
3001MODULE_LICENSE("GPL");