blob: ed7002dd9401f24e1286cf8c6581c2a9fe56974c [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
Wolfram Sangb4e2f6a2015-05-19 21:04:40 +020030#include <dt-bindings/i2c/i2c.h>
Wolfram Sang53feedf2016-02-20 23:33:38 +010031#include <asm/uaccess.h>
32#include <linux/acpi.h>
Sylwester Nawrocki86be4082014-06-18 17:29:32 +020033#include <linux/clk/clk-conf.h>
Jean Delvareb8d6f452007-02-13 22:09:00 +010034#include <linux/completion.h>
Wolfram Sang53feedf2016-02-20 23:33:38 +010035#include <linux/delay.h>
Pantelis Antonioua430a3452014-10-28 22:36:02 +020036#include <linux/err.h>
Wolfram Sang53feedf2016-02-20 23:33:38 +010037#include <linux/errno.h>
38#include <linux/gpio.h>
39#include <linux/hardirq.h>
40#include <linux/i2c.h>
41#include <linux/idr.h>
42#include <linux/init.h>
43#include <linux/irqflags.h>
44#include <linux/jump_label.h>
45#include <linux/kernel.h>
46#include <linux/module.h>
47#include <linux/mutex.h>
48#include <linux/of_device.h>
49#include <linux/of.h>
50#include <linux/of_irq.h>
51#include <linux/pm_domain.h>
52#include <linux/pm_runtime.h>
53#include <linux/pm_wakeirq.h>
Wolfram Sange1dba012015-12-08 10:37:46 +010054#include <linux/property.h>
Wolfram Sang53feedf2016-02-20 23:33:38 +010055#include <linux/rwsem.h>
56#include <linux/slab.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070057
David Brownell9c1600e2007-05-01 23:26:31 +020058#include "i2c-core.h"
59
David Howellsd9a83d62014-03-06 13:35:59 +000060#define CREATE_TRACE_POINTS
61#include <trace/events/i2c.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070062
Wolfram Sangda899f52015-05-18 21:09:12 +020063#define I2C_ADDR_OFFSET_TEN_BIT 0xa000
64#define I2C_ADDR_OFFSET_SLAVE 0x1000
65
Jean Delvare6629dcf2010-05-04 11:09:28 +020066/* core_lock protects i2c_adapter_idr, and guarantees
Jean Delvare35fc37f2009-06-19 16:58:19 +020067 that device detection, deletion of detected devices, and attach_adapter
Lars-Peter Clausen19baba42013-03-09 08:16:44 +000068 calls are serialized */
Jean Delvarecaada322008-01-27 18:14:49 +010069static DEFINE_MUTEX(core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -070070static DEFINE_IDR(i2c_adapter_idr);
71
Jean Delvare4f8cf822009-09-18 22:45:46 +020072static struct device_type i2c_client_type;
Jean Delvare4735c982008-07-14 22:38:36 +020073static int i2c_detect(struct i2c_adapter *adapter, struct i2c_driver *driver);
David Brownellf37dd802007-02-13 22:09:00 +010074
David Howellsd9a83d62014-03-06 13:35:59 +000075static struct static_key i2c_trace_msg = STATIC_KEY_INIT_FALSE;
Sudip Mukherjee95026652016-03-07 17:19:17 +053076static bool is_registered;
David Howellsd9a83d62014-03-06 13:35:59 +000077
78void i2c_transfer_trace_reg(void)
79{
80 static_key_slow_inc(&i2c_trace_msg);
81}
82
83void i2c_transfer_trace_unreg(void)
84{
85 static_key_slow_dec(&i2c_trace_msg);
86}
87
Wolfram Sang17f4a5c2014-09-22 19:41:00 +020088#if defined(CONFIG_ACPI)
89struct acpi_i2c_handler_data {
90 struct acpi_connection_info info;
91 struct i2c_adapter *adapter;
92};
93
94struct gsb_buffer {
95 u8 status;
96 u8 len;
97 union {
98 u16 wdata;
99 u8 bdata;
100 u8 data[0];
101 };
102} __packed;
103
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300104struct acpi_i2c_lookup {
105 struct i2c_board_info *info;
106 acpi_handle adapter_handle;
107 acpi_handle device_handle;
108};
109
110static int acpi_i2c_find_address(struct acpi_resource *ares, void *data)
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200111{
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300112 struct acpi_i2c_lookup *lookup = data;
113 struct i2c_board_info *info = lookup->info;
114 struct acpi_resource_i2c_serialbus *sb;
115 acpi_handle adapter_handle;
116 acpi_status status;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200117
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300118 if (info->addr || ares->type != ACPI_RESOURCE_TYPE_SERIAL_BUS)
119 return 1;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200120
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300121 sb = &ares->data.i2c_serial_bus;
122 if (sb->type != ACPI_RESOURCE_SERIAL_TYPE_I2C)
123 return 1;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200124
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300125 /*
126 * Extract the ResourceSource and make sure that the handle matches
127 * with the I2C adapter handle.
128 */
129 status = acpi_get_handle(lookup->device_handle,
130 sb->resource_source.string_ptr,
131 &adapter_handle);
132 if (ACPI_SUCCESS(status) && adapter_handle == lookup->adapter_handle) {
133 info->addr = sb->slave_address;
134 if (sb->access_mode == ACPI_I2C_10BIT_MODE)
135 info->flags |= I2C_CLIENT_TEN;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200136 }
137
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200138 return 1;
139}
140
141static acpi_status acpi_i2c_add_device(acpi_handle handle, u32 level,
142 void *data, void **return_value)
143{
144 struct i2c_adapter *adapter = data;
145 struct list_head resource_list;
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300146 struct acpi_i2c_lookup lookup;
147 struct resource_entry *entry;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200148 struct i2c_board_info info;
149 struct acpi_device *adev;
150 int ret;
151
152 if (acpi_bus_get_device(handle, &adev))
153 return AE_OK;
154 if (acpi_bus_get_status(adev) || !adev->status.present)
155 return AE_OK;
156
157 memset(&info, 0, sizeof(info));
Rafael J. Wysockice793482015-03-16 23:49:03 +0100158 info.fwnode = acpi_fwnode_handle(adev);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200159
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300160 memset(&lookup, 0, sizeof(lookup));
Dustin Byford8eb5c872015-10-23 12:27:07 -0700161 lookup.adapter_handle = ACPI_HANDLE(&adapter->dev);
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300162 lookup.device_handle = handle;
163 lookup.info = &info;
164
165 /*
166 * Look up for I2cSerialBus resource with ResourceSource that
167 * matches with this adapter.
168 */
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200169 INIT_LIST_HEAD(&resource_list);
170 ret = acpi_dev_get_resources(adev, &resource_list,
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300171 acpi_i2c_find_address, &lookup);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200172 acpi_dev_free_resource_list(&resource_list);
173
174 if (ret < 0 || !info.addr)
175 return AE_OK;
176
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300177 /* Then fill IRQ number if any */
178 ret = acpi_dev_get_resources(adev, &resource_list, NULL, NULL);
179 if (ret < 0)
180 return AE_OK;
181
182 resource_list_for_each_entry(entry, &resource_list) {
183 if (resource_type(entry->res) == IORESOURCE_IRQ) {
184 info.irq = entry->res->start;
185 break;
186 }
187 }
188
189 acpi_dev_free_resource_list(&resource_list);
190
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200191 adev->power.flags.ignore_parent = true;
192 strlcpy(info.type, dev_name(&adev->dev), sizeof(info.type));
193 if (!i2c_new_device(adapter, &info)) {
194 adev->power.flags.ignore_parent = false;
195 dev_err(&adapter->dev,
196 "failed to add I2C device %s from ACPI\n",
197 dev_name(&adev->dev));
198 }
199
200 return AE_OK;
201}
202
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300203#define ACPI_I2C_MAX_SCAN_DEPTH 32
204
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200205/**
206 * acpi_i2c_register_devices - enumerate I2C slave devices behind adapter
207 * @adap: pointer to adapter
208 *
209 * Enumerate all I2C slave devices behind this adapter by walking the ACPI
210 * namespace. When a device is found it will be added to the Linux device
211 * model and bound to the corresponding ACPI handle.
212 */
213static void acpi_i2c_register_devices(struct i2c_adapter *adap)
214{
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200215 acpi_status status;
216
Dustin Byford8eb5c872015-10-23 12:27:07 -0700217 if (!has_acpi_companion(&adap->dev))
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200218 return;
219
Mika Westerberg166c2ba2015-10-07 13:18:44 +0300220 status = acpi_walk_namespace(ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT,
221 ACPI_I2C_MAX_SCAN_DEPTH,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200222 acpi_i2c_add_device, NULL,
223 adap, NULL);
224 if (ACPI_FAILURE(status))
225 dev_warn(&adap->dev, "failed to enumerate I2C slaves\n");
226}
227
228#else /* CONFIG_ACPI */
229static inline void acpi_i2c_register_devices(struct i2c_adapter *adap) { }
230#endif /* CONFIG_ACPI */
231
232#ifdef CONFIG_ACPI_I2C_OPREGION
233static int acpi_gsb_i2c_read_bytes(struct i2c_client *client,
234 u8 cmd, u8 *data, u8 data_len)
235{
236
237 struct i2c_msg msgs[2];
238 int ret;
239 u8 *buffer;
240
241 buffer = kzalloc(data_len, GFP_KERNEL);
242 if (!buffer)
243 return AE_NO_MEMORY;
244
245 msgs[0].addr = client->addr;
246 msgs[0].flags = client->flags;
247 msgs[0].len = 1;
248 msgs[0].buf = &cmd;
249
250 msgs[1].addr = client->addr;
251 msgs[1].flags = client->flags | I2C_M_RD;
252 msgs[1].len = data_len;
253 msgs[1].buf = buffer;
254
255 ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
256 if (ret < 0)
257 dev_err(&client->adapter->dev, "i2c read failed\n");
258 else
259 memcpy(data, buffer, data_len);
260
261 kfree(buffer);
262 return ret;
263}
264
265static int acpi_gsb_i2c_write_bytes(struct i2c_client *client,
266 u8 cmd, u8 *data, u8 data_len)
267{
268
269 struct i2c_msg msgs[1];
270 u8 *buffer;
271 int ret = AE_OK;
272
273 buffer = kzalloc(data_len + 1, GFP_KERNEL);
274 if (!buffer)
275 return AE_NO_MEMORY;
276
277 buffer[0] = cmd;
278 memcpy(buffer + 1, data, data_len);
279
280 msgs[0].addr = client->addr;
281 msgs[0].flags = client->flags;
282 msgs[0].len = data_len + 1;
283 msgs[0].buf = buffer;
284
285 ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
286 if (ret < 0)
287 dev_err(&client->adapter->dev, "i2c write failed\n");
288
289 kfree(buffer);
290 return ret;
291}
292
293static acpi_status
294acpi_i2c_space_handler(u32 function, acpi_physical_address command,
295 u32 bits, u64 *value64,
296 void *handler_context, void *region_context)
297{
298 struct gsb_buffer *gsb = (struct gsb_buffer *)value64;
299 struct acpi_i2c_handler_data *data = handler_context;
300 struct acpi_connection_info *info = &data->info;
301 struct acpi_resource_i2c_serialbus *sb;
302 struct i2c_adapter *adapter = data->adapter;
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300303 struct i2c_client *client;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200304 struct acpi_resource *ares;
305 u32 accessor_type = function >> 16;
306 u8 action = function & ACPI_IO_MASK;
Wolfram Sang4470c722014-11-18 15:12:43 +0100307 acpi_status ret;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200308 int status;
309
310 ret = acpi_buffer_to_resource(info->connection, info->length, &ares);
311 if (ACPI_FAILURE(ret))
312 return ret;
313
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300314 client = kzalloc(sizeof(*client), GFP_KERNEL);
315 if (!client) {
316 ret = AE_NO_MEMORY;
317 goto err;
318 }
319
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200320 if (!value64 || ares->type != ACPI_RESOURCE_TYPE_SERIAL_BUS) {
321 ret = AE_BAD_PARAMETER;
322 goto err;
323 }
324
325 sb = &ares->data.i2c_serial_bus;
326 if (sb->type != ACPI_RESOURCE_SERIAL_TYPE_I2C) {
327 ret = AE_BAD_PARAMETER;
328 goto err;
329 }
330
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300331 client->adapter = adapter;
332 client->addr = sb->slave_address;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200333
334 if (sb->access_mode == ACPI_I2C_10BIT_MODE)
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300335 client->flags |= I2C_CLIENT_TEN;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200336
337 switch (accessor_type) {
338 case ACPI_GSB_ACCESS_ATTRIB_SEND_RCV:
339 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300340 status = i2c_smbus_read_byte(client);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200341 if (status >= 0) {
342 gsb->bdata = status;
343 status = 0;
344 }
345 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300346 status = i2c_smbus_write_byte(client, gsb->bdata);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200347 }
348 break;
349
350 case ACPI_GSB_ACCESS_ATTRIB_BYTE:
351 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300352 status = i2c_smbus_read_byte_data(client, command);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200353 if (status >= 0) {
354 gsb->bdata = status;
355 status = 0;
356 }
357 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300358 status = i2c_smbus_write_byte_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200359 gsb->bdata);
360 }
361 break;
362
363 case ACPI_GSB_ACCESS_ATTRIB_WORD:
364 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300365 status = i2c_smbus_read_word_data(client, command);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200366 if (status >= 0) {
367 gsb->wdata = status;
368 status = 0;
369 }
370 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300371 status = i2c_smbus_write_word_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200372 gsb->wdata);
373 }
374 break;
375
376 case ACPI_GSB_ACCESS_ATTRIB_BLOCK:
377 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300378 status = i2c_smbus_read_block_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200379 gsb->data);
380 if (status >= 0) {
381 gsb->len = status;
382 status = 0;
383 }
384 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300385 status = i2c_smbus_write_block_data(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200386 gsb->len, gsb->data);
387 }
388 break;
389
390 case ACPI_GSB_ACCESS_ATTRIB_MULTIBYTE:
391 if (action == ACPI_READ) {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300392 status = acpi_gsb_i2c_read_bytes(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200393 gsb->data, info->access_length);
394 if (status > 0)
395 status = 0;
396 } else {
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300397 status = acpi_gsb_i2c_write_bytes(client, command,
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200398 gsb->data, info->access_length);
399 }
400 break;
401
402 default:
403 pr_info("protocol(0x%02x) is not supported.\n", accessor_type);
404 ret = AE_BAD_PARAMETER;
405 goto err;
406 }
407
408 gsb->status = status;
409
410 err:
Jarkko Nikula7ef85f52015-05-20 16:36:52 +0300411 kfree(client);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200412 ACPI_FREE(ares);
413 return ret;
414}
415
416
417static int acpi_i2c_install_space_handler(struct i2c_adapter *adapter)
418{
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200419 acpi_handle handle;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200420 struct acpi_i2c_handler_data *data;
421 acpi_status status;
422
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200423 if (!adapter->dev.parent)
424 return -ENODEV;
425
426 handle = ACPI_HANDLE(adapter->dev.parent);
427
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200428 if (!handle)
429 return -ENODEV;
430
431 data = kzalloc(sizeof(struct acpi_i2c_handler_data),
432 GFP_KERNEL);
433 if (!data)
434 return -ENOMEM;
435
436 data->adapter = adapter;
437 status = acpi_bus_attach_private_data(handle, (void *)data);
438 if (ACPI_FAILURE(status)) {
439 kfree(data);
440 return -ENOMEM;
441 }
442
443 status = acpi_install_address_space_handler(handle,
444 ACPI_ADR_SPACE_GSBUS,
445 &acpi_i2c_space_handler,
446 NULL,
447 data);
448 if (ACPI_FAILURE(status)) {
449 dev_err(&adapter->dev, "Error installing i2c space handler\n");
450 acpi_bus_detach_private_data(handle);
451 kfree(data);
452 return -ENOMEM;
453 }
454
Lan Tianyu40e7fcb2014-11-23 21:22:54 +0800455 acpi_walk_dep_device_list(handle);
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200456 return 0;
457}
458
459static void acpi_i2c_remove_space_handler(struct i2c_adapter *adapter)
460{
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200461 acpi_handle handle;
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200462 struct acpi_i2c_handler_data *data;
463 acpi_status status;
464
Peter Hüwe0aef44e2014-09-12 21:09:47 +0200465 if (!adapter->dev.parent)
466 return;
467
468 handle = ACPI_HANDLE(adapter->dev.parent);
469
Wolfram Sang17f4a5c2014-09-22 19:41:00 +0200470 if (!handle)
471 return;
472
473 acpi_remove_address_space_handler(handle,
474 ACPI_ADR_SPACE_GSBUS,
475 &acpi_i2c_space_handler);
476
477 status = acpi_bus_get_private_data(handle, (void **)&data);
478 if (ACPI_SUCCESS(status))
479 kfree(data);
480
481 acpi_bus_detach_private_data(handle);
482}
483#else /* CONFIG_ACPI_I2C_OPREGION */
484static inline void acpi_i2c_remove_space_handler(struct i2c_adapter *adapter)
485{ }
486
487static inline int acpi_i2c_install_space_handler(struct i2c_adapter *adapter)
488{ return 0; }
489#endif /* CONFIG_ACPI_I2C_OPREGION */
490
David Brownellf37dd802007-02-13 22:09:00 +0100491/* ------------------------------------------------------------------------- */
492
Jean Delvared2653e92008-04-29 23:11:39 +0200493static const struct i2c_device_id *i2c_match_id(const struct i2c_device_id *id,
494 const struct i2c_client *client)
495{
496 while (id->name[0]) {
497 if (strcmp(client->name, id->name) == 0)
498 return id;
499 id++;
500 }
501 return NULL;
502}
503
Linus Torvalds1da177e2005-04-16 15:20:36 -0700504static int i2c_device_match(struct device *dev, struct device_driver *drv)
505{
Jean Delvare51298d12009-09-18 22:45:45 +0200506 struct i2c_client *client = i2c_verify_client(dev);
507 struct i2c_driver *driver;
David Brownell7b4fbc52007-05-01 23:26:30 +0200508
Jean Delvare51298d12009-09-18 22:45:45 +0200509 if (!client)
510 return 0;
511
Grant Likely959e85f2010-06-08 07:48:19 -0600512 /* Attempt an OF style match */
513 if (of_driver_match_device(dev, drv))
514 return 1;
515
Mika Westerberg907ddf82012-11-23 12:23:40 +0100516 /* Then ACPI style match */
517 if (acpi_driver_match_device(dev, drv))
518 return 1;
519
Jean Delvare51298d12009-09-18 22:45:45 +0200520 driver = to_i2c_driver(drv);
Jean Delvared2653e92008-04-29 23:11:39 +0200521 /* match on an id table if there is one */
522 if (driver->id_table)
523 return i2c_match_id(driver->id_table, client) != NULL;
524
Jean Delvareeb8a7902008-05-18 20:49:41 +0200525 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700526}
527
Kay Sievers7eff2e72007-08-14 15:15:12 +0200528static int i2c_device_uevent(struct device *dev, struct kobj_uevent_env *env)
David Brownell7b4fbc52007-05-01 23:26:30 +0200529{
Wolfram Sang8dcf3212016-03-23 20:47:02 +0100530 struct i2c_client *client = to_i2c_client(dev);
Zhang Rui8c4ff6d2014-01-14 16:46:37 +0800531 int rc;
532
533 rc = acpi_device_uevent_modalias(dev, env);
534 if (rc != -ENODEV)
535 return rc;
David Brownell7b4fbc52007-05-01 23:26:30 +0200536
Wolfram Sang8dcf3212016-03-23 20:47:02 +0100537 return add_uevent_var(env, "MODALIAS=%s%s", I2C_MODULE_PREFIX, client->name);
David Brownell7b4fbc52007-05-01 23:26:30 +0200538}
539
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530540/* i2c bus recovery routines */
541static int get_scl_gpio_value(struct i2c_adapter *adap)
542{
543 return gpio_get_value(adap->bus_recovery_info->scl_gpio);
544}
545
546static void set_scl_gpio_value(struct i2c_adapter *adap, int val)
547{
548 gpio_set_value(adap->bus_recovery_info->scl_gpio, val);
549}
550
551static int get_sda_gpio_value(struct i2c_adapter *adap)
552{
553 return gpio_get_value(adap->bus_recovery_info->sda_gpio);
554}
555
556static int i2c_get_gpios_for_recovery(struct i2c_adapter *adap)
557{
558 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
559 struct device *dev = &adap->dev;
560 int ret = 0;
561
562 ret = gpio_request_one(bri->scl_gpio, GPIOF_OPEN_DRAIN |
563 GPIOF_OUT_INIT_HIGH, "i2c-scl");
564 if (ret) {
565 dev_warn(dev, "Can't get SCL gpio: %d\n", bri->scl_gpio);
566 return ret;
567 }
568
569 if (bri->get_sda) {
570 if (gpio_request_one(bri->sda_gpio, GPIOF_IN, "i2c-sda")) {
571 /* work without SDA polling */
572 dev_warn(dev, "Can't get SDA gpio: %d. Not using SDA polling\n",
573 bri->sda_gpio);
574 bri->get_sda = NULL;
575 }
576 }
577
578 return ret;
579}
580
581static void i2c_put_gpios_for_recovery(struct i2c_adapter *adap)
582{
583 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
584
585 if (bri->get_sda)
586 gpio_free(bri->sda_gpio);
587
588 gpio_free(bri->scl_gpio);
589}
590
591/*
592 * We are generating clock pulses. ndelay() determines durating of clk pulses.
593 * We will generate clock with rate 100 KHz and so duration of both clock levels
594 * is: delay in ns = (10^6 / 100) / 2
595 */
596#define RECOVERY_NDELAY 5000
597#define RECOVERY_CLK_CNT 9
598
599static int i2c_generic_recovery(struct i2c_adapter *adap)
600{
601 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
602 int i = 0, val = 1, ret = 0;
603
604 if (bri->prepare_recovery)
Grygorii Strashko2b2190a2015-04-06 15:38:39 +0300605 bri->prepare_recovery(adap);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530606
Jan Luebbe8b062602015-07-08 16:35:06 +0200607 bri->set_scl(adap, val);
608 ndelay(RECOVERY_NDELAY);
609
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530610 /*
611 * By this time SCL is high, as we need to give 9 falling-rising edges
612 */
613 while (i++ < RECOVERY_CLK_CNT * 2) {
614 if (val) {
615 /* Break if SDA is high */
616 if (bri->get_sda && bri->get_sda(adap))
617 break;
618 /* SCL shouldn't be low here */
619 if (!bri->get_scl(adap)) {
620 dev_err(&adap->dev,
621 "SCL is stuck low, exit recovery\n");
622 ret = -EBUSY;
623 break;
624 }
625 }
626
627 val = !val;
628 bri->set_scl(adap, val);
629 ndelay(RECOVERY_NDELAY);
630 }
631
632 if (bri->unprepare_recovery)
Grygorii Strashko2b2190a2015-04-06 15:38:39 +0300633 bri->unprepare_recovery(adap);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530634
635 return ret;
636}
637
638int i2c_generic_scl_recovery(struct i2c_adapter *adap)
639{
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530640 return i2c_generic_recovery(adap);
641}
Mark Brownc1c21f42015-04-15 19:18:39 +0100642EXPORT_SYMBOL_GPL(i2c_generic_scl_recovery);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530643
644int i2c_generic_gpio_recovery(struct i2c_adapter *adap)
645{
646 int ret;
647
648 ret = i2c_get_gpios_for_recovery(adap);
649 if (ret)
650 return ret;
651
652 ret = i2c_generic_recovery(adap);
653 i2c_put_gpios_for_recovery(adap);
654
655 return ret;
656}
Mark Brownc1c21f42015-04-15 19:18:39 +0100657EXPORT_SYMBOL_GPL(i2c_generic_gpio_recovery);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530658
659int i2c_recover_bus(struct i2c_adapter *adap)
660{
661 if (!adap->bus_recovery_info)
662 return -EOPNOTSUPP;
663
664 dev_dbg(&adap->dev, "Trying i2c bus recovery\n");
665 return adap->bus_recovery_info->recover_bus(adap);
666}
Mark Brownc1c21f42015-04-15 19:18:39 +0100667EXPORT_SYMBOL_GPL(i2c_recover_bus);
Viresh Kumar5f9296b2012-02-28 18:26:31 +0530668
Linus Torvalds1da177e2005-04-16 15:20:36 -0700669static int i2c_device_probe(struct device *dev)
670{
Jean Delvare51298d12009-09-18 22:45:45 +0200671 struct i2c_client *client = i2c_verify_client(dev);
672 struct i2c_driver *driver;
Hans Verkuil50c33042008-03-12 14:15:00 +0100673 int status;
David Brownell7b4fbc52007-05-01 23:26:30 +0200674
Jean Delvare51298d12009-09-18 22:45:45 +0200675 if (!client)
676 return 0;
677
Mika Westerberg845c8772015-05-06 13:29:08 +0300678 if (!client->irq) {
679 int irq = -ENOENT;
680
Dmitry Torokhov3fffd122015-08-17 23:52:51 -0700681 if (dev->of_node) {
682 irq = of_irq_get_byname(dev->of_node, "irq");
683 if (irq == -EINVAL || irq == -ENODATA)
684 irq = of_irq_get(dev->of_node, 0);
685 } else if (ACPI_COMPANION(dev)) {
Mika Westerberg845c8772015-05-06 13:29:08 +0300686 irq = acpi_dev_gpio_irq_get(ACPI_COMPANION(dev), 0);
Dmitry Torokhov3fffd122015-08-17 23:52:51 -0700687 }
Geert Uytterhoeven6f34be72014-11-17 12:43:00 +0100688 if (irq == -EPROBE_DEFER)
Laurent Pinchart2fd36c552014-10-30 15:59:38 +0200689 return irq;
Geert Uytterhoeven6f34be72014-11-17 12:43:00 +0100690 if (irq < 0)
691 irq = 0;
Laurent Pinchart2fd36c552014-10-30 15:59:38 +0200692
693 client->irq = irq;
694 }
695
Jean Delvare51298d12009-09-18 22:45:45 +0200696 driver = to_i2c_driver(dev->driver);
Jean Delvaree0457442008-07-14 22:38:30 +0200697 if (!driver->probe || !driver->id_table)
David Brownell7b4fbc52007-05-01 23:26:30 +0200698 return -ENODEV;
Lars-Peter Clausen0acc2b32013-09-29 10:51:06 +0200699
Dmitry Torokhov3fffd122015-08-17 23:52:51 -0700700 if (client->flags & I2C_CLIENT_WAKE) {
701 int wakeirq = -ENOENT;
702
703 if (dev->of_node) {
704 wakeirq = of_irq_get_byname(dev->of_node, "wakeup");
705 if (wakeirq == -EPROBE_DEFER)
706 return wakeirq;
707 }
708
709 device_init_wakeup(&client->dev, true);
710
711 if (wakeirq > 0 && wakeirq != client->irq)
712 status = dev_pm_set_dedicated_wake_irq(dev, wakeirq);
713 else if (client->irq > 0)
Grygorii Strashkoc18fba22015-11-12 15:42:26 +0200714 status = dev_pm_set_wake_irq(dev, client->irq);
Dmitry Torokhov3fffd122015-08-17 23:52:51 -0700715 else
716 status = 0;
717
718 if (status)
719 dev_warn(&client->dev, "failed to set up wakeup irq");
720 }
721
David Brownell7b4fbc52007-05-01 23:26:30 +0200722 dev_dbg(dev, "probe\n");
Jean Delvared2653e92008-04-29 23:11:39 +0200723
Sylwester Nawrocki86be4082014-06-18 17:29:32 +0200724 status = of_clk_set_defaults(dev->of_node, false);
725 if (status < 0)
Dmitry Torokhov3fffd122015-08-17 23:52:51 -0700726 goto err_clear_wakeup_irq;
Sylwester Nawrocki86be4082014-06-18 17:29:32 +0200727
Ulf Hanssone09b0d42014-09-19 20:27:39 +0200728 status = dev_pm_domain_attach(&client->dev, true);
Kieran Bingham74cedd32015-10-12 21:54:43 +0100729 if (status == -EPROBE_DEFER)
730 goto err_clear_wakeup_irq;
731
732 status = driver->probe(client, i2c_match_id(driver->id_table, client));
733 if (status)
734 goto err_detach_pm_domain;
Wolfram Sang72fa8182014-01-21 17:48:34 +0100735
Dmitry Torokhov3fffd122015-08-17 23:52:51 -0700736 return 0;
737
738err_detach_pm_domain:
739 dev_pm_domain_detach(&client->dev, true);
740err_clear_wakeup_irq:
741 dev_pm_clear_wake_irq(&client->dev);
742 device_init_wakeup(&client->dev, false);
Hans Verkuil50c33042008-03-12 14:15:00 +0100743 return status;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700744}
745
746static int i2c_device_remove(struct device *dev)
747{
Jean Delvare51298d12009-09-18 22:45:45 +0200748 struct i2c_client *client = i2c_verify_client(dev);
David Brownella1d9e6e2007-05-01 23:26:30 +0200749 struct i2c_driver *driver;
Wolfram Sang72fa8182014-01-21 17:48:34 +0100750 int status = 0;
David Brownella1d9e6e2007-05-01 23:26:30 +0200751
Jean Delvare51298d12009-09-18 22:45:45 +0200752 if (!client || !dev->driver)
David Brownella1d9e6e2007-05-01 23:26:30 +0200753 return 0;
754
755 driver = to_i2c_driver(dev->driver);
756 if (driver->remove) {
757 dev_dbg(dev, "remove\n");
758 status = driver->remove(client);
David Brownella1d9e6e2007-05-01 23:26:30 +0200759 }
Wolfram Sang72fa8182014-01-21 17:48:34 +0100760
Ulf Hanssone09b0d42014-09-19 20:27:39 +0200761 dev_pm_domain_detach(&client->dev, true);
Dmitry Torokhov3fffd122015-08-17 23:52:51 -0700762
763 dev_pm_clear_wake_irq(&client->dev);
764 device_init_wakeup(&client->dev, false);
765
David Brownella1d9e6e2007-05-01 23:26:30 +0200766 return status;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700767}
768
David Brownellf37dd802007-02-13 22:09:00 +0100769static void i2c_device_shutdown(struct device *dev)
770{
Jean Delvare51298d12009-09-18 22:45:45 +0200771 struct i2c_client *client = i2c_verify_client(dev);
David Brownellf37dd802007-02-13 22:09:00 +0100772 struct i2c_driver *driver;
773
Jean Delvare51298d12009-09-18 22:45:45 +0200774 if (!client || !dev->driver)
David Brownellf37dd802007-02-13 22:09:00 +0100775 return;
776 driver = to_i2c_driver(dev->driver);
777 if (driver->shutdown)
Jean Delvare51298d12009-09-18 22:45:45 +0200778 driver->shutdown(client);
David Brownellf37dd802007-02-13 22:09:00 +0100779}
780
David Brownell9c1600e2007-05-01 23:26:31 +0200781static void i2c_client_dev_release(struct device *dev)
782{
783 kfree(to_i2c_client(dev));
784}
785
Zhenwen Xu09b8ce02009-03-28 21:34:46 +0100786static ssize_t
Jean Delvare4f8cf822009-09-18 22:45:46 +0200787show_name(struct device *dev, struct device_attribute *attr, char *buf)
David Brownell7b4fbc52007-05-01 23:26:30 +0200788{
Jean Delvare4f8cf822009-09-18 22:45:46 +0200789 return sprintf(buf, "%s\n", dev->type == &i2c_client_type ?
790 to_i2c_client(dev)->name : to_i2c_adapter(dev)->name);
David Brownell7b4fbc52007-05-01 23:26:30 +0200791}
Wolfram Sanga5eb71b2015-01-19 20:12:24 +0100792static DEVICE_ATTR(name, S_IRUGO, show_name, NULL);
David Brownell7b4fbc52007-05-01 23:26:30 +0200793
Zhenwen Xu09b8ce02009-03-28 21:34:46 +0100794static ssize_t
795show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
David Brownell7b4fbc52007-05-01 23:26:30 +0200796{
797 struct i2c_client *client = to_i2c_client(dev);
Zhang Rui8c4ff6d2014-01-14 16:46:37 +0800798 int len;
799
800 len = acpi_device_modalias(dev, buf, PAGE_SIZE -1);
801 if (len != -ENODEV)
802 return len;
803
Jean Delvareeb8a7902008-05-18 20:49:41 +0200804 return sprintf(buf, "%s%s\n", I2C_MODULE_PREFIX, client->name);
David Brownell7b4fbc52007-05-01 23:26:30 +0200805}
Jean Delvare51298d12009-09-18 22:45:45 +0200806static DEVICE_ATTR(modalias, S_IRUGO, show_modalias, NULL);
807
808static struct attribute *i2c_dev_attrs[] = {
809 &dev_attr_name.attr,
David Brownell7b4fbc52007-05-01 23:26:30 +0200810 /* modalias helps coldplug: modprobe $(cat .../modalias) */
Jean Delvare51298d12009-09-18 22:45:45 +0200811 &dev_attr_modalias.attr,
812 NULL
813};
Wolfram Sanga5eb71b2015-01-19 20:12:24 +0100814ATTRIBUTE_GROUPS(i2c_dev);
sonic zhang54067ee2009-12-14 21:17:30 +0100815
Jon Smirle9ca9eb2008-07-14 22:38:35 +0200816struct bus_type i2c_bus_type = {
David Brownellf37dd802007-02-13 22:09:00 +0100817 .name = "i2c",
818 .match = i2c_device_match,
819 .probe = i2c_device_probe,
820 .remove = i2c_device_remove,
821 .shutdown = i2c_device_shutdown,
Russell Kingb864c7d2006-01-05 14:37:50 +0000822};
Jon Smirle9ca9eb2008-07-14 22:38:35 +0200823EXPORT_SYMBOL_GPL(i2c_bus_type);
Russell Kingb864c7d2006-01-05 14:37:50 +0000824
Jean Delvare51298d12009-09-18 22:45:45 +0200825static struct device_type i2c_client_type = {
Wolfram Sanga5eb71b2015-01-19 20:12:24 +0100826 .groups = i2c_dev_groups,
Jean Delvare51298d12009-09-18 22:45:45 +0200827 .uevent = i2c_device_uevent,
828 .release = i2c_client_dev_release,
829};
830
David Brownell9b766b82008-01-27 18:14:51 +0100831
832/**
833 * i2c_verify_client - return parameter as i2c_client, or NULL
834 * @dev: device, probably from some driver model iterator
835 *
836 * When traversing the driver model tree, perhaps using driver model
837 * iterators like @device_for_each_child(), you can't assume very much
838 * about the nodes you find. Use this function to avoid oopses caused
839 * by wrongly treating some non-I2C device as an i2c_client.
840 */
841struct i2c_client *i2c_verify_client(struct device *dev)
842{
Jean Delvare51298d12009-09-18 22:45:45 +0200843 return (dev->type == &i2c_client_type)
David Brownell9b766b82008-01-27 18:14:51 +0100844 ? to_i2c_client(dev)
845 : NULL;
846}
847EXPORT_SYMBOL(i2c_verify_client);
848
849
Wolfram Sangda899f52015-05-18 21:09:12 +0200850/* Return a unique address which takes the flags of the client into account */
851static unsigned short i2c_encode_flags_to_addr(struct i2c_client *client)
852{
853 unsigned short addr = client->addr;
854
855 /* For some client flags, add an arbitrary offset to avoid collisions */
856 if (client->flags & I2C_CLIENT_TEN)
857 addr |= I2C_ADDR_OFFSET_TEN_BIT;
858
859 if (client->flags & I2C_CLIENT_SLAVE)
860 addr |= I2C_ADDR_OFFSET_SLAVE;
861
862 return addr;
863}
864
Jean Delvare3a89db52010-06-03 11:33:52 +0200865/* This is a permissive address validity check, I2C address map constraints
Lucas De Marchi25985ed2011-03-30 22:57:33 -0300866 * are purposely not enforced, except for the general call address. */
Wolfram Sangc4019b72015-07-17 12:50:06 +0200867static int i2c_check_addr_validity(unsigned addr, unsigned short flags)
Jean Delvare3a89db52010-06-03 11:33:52 +0200868{
Wolfram Sangc4019b72015-07-17 12:50:06 +0200869 if (flags & I2C_CLIENT_TEN) {
Jean Delvare3a89db52010-06-03 11:33:52 +0200870 /* 10-bit address, all values are valid */
Wolfram Sangc4019b72015-07-17 12:50:06 +0200871 if (addr > 0x3ff)
Jean Delvare3a89db52010-06-03 11:33:52 +0200872 return -EINVAL;
873 } else {
874 /* 7-bit address, reject the general call address */
Wolfram Sangc4019b72015-07-17 12:50:06 +0200875 if (addr == 0x00 || addr > 0x7f)
Jean Delvare3a89db52010-06-03 11:33:52 +0200876 return -EINVAL;
877 }
878 return 0;
879}
880
Jean Delvare656b8762010-06-03 11:33:53 +0200881/* And this is a strict address validity check, used when probing. If a
882 * device uses a reserved address, then it shouldn't be probed. 7-bit
883 * addressing is assumed, 10-bit address devices are rare and should be
884 * explicitly enumerated. */
Wolfram Sang66be60562015-07-17 12:43:22 +0200885static int i2c_check_7bit_addr_validity_strict(unsigned short addr)
Jean Delvare656b8762010-06-03 11:33:53 +0200886{
887 /*
888 * Reserved addresses per I2C specification:
889 * 0x00 General call address / START byte
890 * 0x01 CBUS address
891 * 0x02 Reserved for different bus format
892 * 0x03 Reserved for future purposes
893 * 0x04-0x07 Hs-mode master code
894 * 0x78-0x7b 10-bit slave addressing
895 * 0x7c-0x7f Reserved for future purposes
896 */
897 if (addr < 0x08 || addr > 0x77)
898 return -EINVAL;
899 return 0;
900}
901
Jean Delvare3b5f7942010-06-03 11:33:55 +0200902static int __i2c_check_addr_busy(struct device *dev, void *addrp)
903{
904 struct i2c_client *client = i2c_verify_client(dev);
905 int addr = *(int *)addrp;
906
Wolfram Sang9bccc702015-07-17 14:48:56 +0200907 if (client && i2c_encode_flags_to_addr(client) == addr)
Jean Delvare3b5f7942010-06-03 11:33:55 +0200908 return -EBUSY;
909 return 0;
910}
911
Michael Lawnick08263742010-08-11 18:21:02 +0200912/* walk up mux tree */
913static int i2c_check_mux_parents(struct i2c_adapter *adapter, int addr)
914{
Jean Delvare97cc4d42010-10-24 18:16:57 +0200915 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
Michael Lawnick08263742010-08-11 18:21:02 +0200916 int result;
917
918 result = device_for_each_child(&adapter->dev, &addr,
919 __i2c_check_addr_busy);
920
Jean Delvare97cc4d42010-10-24 18:16:57 +0200921 if (!result && parent)
922 result = i2c_check_mux_parents(parent, addr);
Michael Lawnick08263742010-08-11 18:21:02 +0200923
924 return result;
925}
926
927/* recurse down mux tree */
928static int i2c_check_mux_children(struct device *dev, void *addrp)
929{
930 int result;
931
932 if (dev->type == &i2c_adapter_type)
933 result = device_for_each_child(dev, addrp,
934 i2c_check_mux_children);
935 else
936 result = __i2c_check_addr_busy(dev, addrp);
937
938 return result;
939}
940
Jean Delvare3b5f7942010-06-03 11:33:55 +0200941static int i2c_check_addr_busy(struct i2c_adapter *adapter, int addr)
942{
Jean Delvare97cc4d42010-10-24 18:16:57 +0200943 struct i2c_adapter *parent = i2c_parent_is_i2c_adapter(adapter);
Michael Lawnick08263742010-08-11 18:21:02 +0200944 int result = 0;
945
Jean Delvare97cc4d42010-10-24 18:16:57 +0200946 if (parent)
947 result = i2c_check_mux_parents(parent, addr);
Michael Lawnick08263742010-08-11 18:21:02 +0200948
949 if (!result)
950 result = device_for_each_child(&adapter->dev, &addr,
951 i2c_check_mux_children);
952
953 return result;
Jean Delvare3b5f7942010-06-03 11:33:55 +0200954}
955
David Brownell9c1600e2007-05-01 23:26:31 +0200956/**
Peter Rosin8320f492016-05-04 22:15:27 +0200957 * i2c_adapter_lock_bus - Get exclusive access to an I2C bus segment
Jean Delvarefe61e072010-08-11 18:20:58 +0200958 * @adapter: Target I2C bus segment
Peter Rosin8320f492016-05-04 22:15:27 +0200959 * @flags: I2C_LOCK_ROOT_ADAPTER locks the root i2c adapter, I2C_LOCK_SEGMENT
960 * locks only this branch in the adapter tree
Jean Delvarefe61e072010-08-11 18:20:58 +0200961 */
Peter Rosin8320f492016-05-04 22:15:27 +0200962static void i2c_adapter_lock_bus(struct i2c_adapter *adapter,
963 unsigned int flags)
Jean Delvarefe61e072010-08-11 18:20:58 +0200964{
Peter Rosinfa96f0c2016-05-04 22:15:28 +0200965 rt_mutex_lock(&adapter->bus_lock);
Jean Delvarefe61e072010-08-11 18:20:58 +0200966}
Jean Delvarefe61e072010-08-11 18:20:58 +0200967
968/**
Peter Rosin8320f492016-05-04 22:15:27 +0200969 * i2c_adapter_trylock_bus - Try to get exclusive access to an I2C bus segment
Jean Delvarefe61e072010-08-11 18:20:58 +0200970 * @adapter: Target I2C bus segment
Peter Rosin8320f492016-05-04 22:15:27 +0200971 * @flags: I2C_LOCK_ROOT_ADAPTER trylocks the root i2c adapter, I2C_LOCK_SEGMENT
972 * trylocks only this branch in the adapter tree
Jean Delvarefe61e072010-08-11 18:20:58 +0200973 */
Peter Rosin8320f492016-05-04 22:15:27 +0200974static int i2c_adapter_trylock_bus(struct i2c_adapter *adapter,
975 unsigned int flags)
Jean Delvarefe61e072010-08-11 18:20:58 +0200976{
Peter Rosinfa96f0c2016-05-04 22:15:28 +0200977 return rt_mutex_trylock(&adapter->bus_lock);
Jean Delvarefe61e072010-08-11 18:20:58 +0200978}
979
980/**
Peter Rosin8320f492016-05-04 22:15:27 +0200981 * i2c_adapter_unlock_bus - Release exclusive access to an I2C bus segment
Jean Delvarefe61e072010-08-11 18:20:58 +0200982 * @adapter: Target I2C bus segment
Peter Rosin8320f492016-05-04 22:15:27 +0200983 * @flags: I2C_LOCK_ROOT_ADAPTER unlocks the root i2c adapter, I2C_LOCK_SEGMENT
984 * unlocks only this branch in the adapter tree
Jean Delvarefe61e072010-08-11 18:20:58 +0200985 */
Peter Rosin8320f492016-05-04 22:15:27 +0200986static void i2c_adapter_unlock_bus(struct i2c_adapter *adapter,
987 unsigned int flags)
Jean Delvarefe61e072010-08-11 18:20:58 +0200988{
Peter Rosinfa96f0c2016-05-04 22:15:28 +0200989 rt_mutex_unlock(&adapter->bus_lock);
Jean Delvarefe61e072010-08-11 18:20:58 +0200990}
Jean Delvarefe61e072010-08-11 18:20:58 +0200991
Jarkko Nikula70762ab2013-11-14 14:03:52 +0200992static void i2c_dev_set_name(struct i2c_adapter *adap,
993 struct i2c_client *client)
994{
995 struct acpi_device *adev = ACPI_COMPANION(&client->dev);
996
997 if (adev) {
998 dev_set_name(&client->dev, "i2c-%s", acpi_dev_name(adev));
999 return;
1000 }
1001
Jarkko Nikula70762ab2013-11-14 14:03:52 +02001002 dev_set_name(&client->dev, "%d-%04x", i2c_adapter_id(adap),
Wolfram Sangda899f52015-05-18 21:09:12 +02001003 i2c_encode_flags_to_addr(client));
Jarkko Nikula70762ab2013-11-14 14:03:52 +02001004}
1005
Jean Delvarefe61e072010-08-11 18:20:58 +02001006/**
Jean Delvaref8a227e2009-06-19 16:58:18 +02001007 * i2c_new_device - instantiate an i2c device
David Brownell9c1600e2007-05-01 23:26:31 +02001008 * @adap: the adapter managing the device
1009 * @info: describes one I2C device; bus_num is ignored
David Brownelld64f73b2007-07-12 14:12:28 +02001010 * Context: can sleep
David Brownell9c1600e2007-05-01 23:26:31 +02001011 *
Jean Delvaref8a227e2009-06-19 16:58:18 +02001012 * Create an i2c device. Binding is handled through driver model
1013 * probe()/remove() methods. A driver may be bound to this device when we
1014 * return from this function, or any later moment (e.g. maybe hotplugging will
1015 * load the driver module). This call is not appropriate for use by mainboard
1016 * initialization logic, which usually runs during an arch_initcall() long
1017 * before any i2c_adapter could exist.
David Brownell9c1600e2007-05-01 23:26:31 +02001018 *
1019 * This returns the new i2c client, which may be saved for later use with
1020 * i2c_unregister_device(); or NULL to indicate an error.
1021 */
1022struct i2c_client *
1023i2c_new_device(struct i2c_adapter *adap, struct i2c_board_info const *info)
1024{
1025 struct i2c_client *client;
1026 int status;
1027
1028 client = kzalloc(sizeof *client, GFP_KERNEL);
1029 if (!client)
1030 return NULL;
1031
1032 client->adapter = adap;
1033
1034 client->dev.platform_data = info->platform_data;
David Brownell3bbb8352007-10-13 23:56:29 +02001035
Anton Vorontsov11f1f2a2008-10-22 20:21:33 +02001036 if (info->archdata)
1037 client->dev.archdata = *info->archdata;
1038
Marc Pignatee354252008-08-28 08:33:22 +02001039 client->flags = info->flags;
David Brownell9c1600e2007-05-01 23:26:31 +02001040 client->addr = info->addr;
1041 client->irq = info->irq;
1042
David Brownell9c1600e2007-05-01 23:26:31 +02001043 strlcpy(client->name, info->type, sizeof(client->name));
1044
Wolfram Sangc4019b72015-07-17 12:50:06 +02001045 status = i2c_check_addr_validity(client->addr, client->flags);
Jean Delvare3a89db52010-06-03 11:33:52 +02001046 if (status) {
1047 dev_err(&adap->dev, "Invalid %d-bit I2C address 0x%02hx\n",
1048 client->flags & I2C_CLIENT_TEN ? 10 : 7, client->addr);
1049 goto out_err_silent;
1050 }
1051
Jean Delvaref8a227e2009-06-19 16:58:18 +02001052 /* Check for address business */
Wolfram Sang9bccc702015-07-17 14:48:56 +02001053 status = i2c_check_addr_busy(adap, i2c_encode_flags_to_addr(client));
Jean Delvaref8a227e2009-06-19 16:58:18 +02001054 if (status)
1055 goto out_err;
1056
1057 client->dev.parent = &client->adapter->dev;
1058 client->dev.bus = &i2c_bus_type;
Jean Delvare51298d12009-09-18 22:45:45 +02001059 client->dev.type = &i2c_client_type;
Grant Likelyd12d42f2010-04-13 16:12:28 -07001060 client->dev.of_node = info->of_node;
Rafael J. Wysockice793482015-03-16 23:49:03 +01001061 client->dev.fwnode = info->fwnode;
Jean Delvaref8a227e2009-06-19 16:58:18 +02001062
Jarkko Nikula70762ab2013-11-14 14:03:52 +02001063 i2c_dev_set_name(adap, client);
Jean Delvaref8a227e2009-06-19 16:58:18 +02001064 status = device_register(&client->dev);
1065 if (status)
1066 goto out_err;
1067
Jean Delvaref8a227e2009-06-19 16:58:18 +02001068 dev_dbg(&adap->dev, "client [%s] registered with bus id %s\n",
1069 client->name, dev_name(&client->dev));
1070
David Brownell9c1600e2007-05-01 23:26:31 +02001071 return client;
Jean Delvaref8a227e2009-06-19 16:58:18 +02001072
1073out_err:
1074 dev_err(&adap->dev, "Failed to register i2c client %s at 0x%02x "
1075 "(%d)\n", client->name, client->addr, status);
Jean Delvare3a89db52010-06-03 11:33:52 +02001076out_err_silent:
Jean Delvaref8a227e2009-06-19 16:58:18 +02001077 kfree(client);
1078 return NULL;
David Brownell9c1600e2007-05-01 23:26:31 +02001079}
1080EXPORT_SYMBOL_GPL(i2c_new_device);
1081
1082
1083/**
1084 * i2c_unregister_device - reverse effect of i2c_new_device()
1085 * @client: value returned from i2c_new_device()
David Brownelld64f73b2007-07-12 14:12:28 +02001086 * Context: can sleep
David Brownell9c1600e2007-05-01 23:26:31 +02001087 */
1088void i2c_unregister_device(struct i2c_client *client)
David Brownella1d9e6e2007-05-01 23:26:30 +02001089{
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001090 if (client->dev.of_node)
1091 of_node_clear_flag(client->dev.of_node, OF_POPULATED);
David Brownella1d9e6e2007-05-01 23:26:30 +02001092 device_unregister(&client->dev);
1093}
David Brownell9c1600e2007-05-01 23:26:31 +02001094EXPORT_SYMBOL_GPL(i2c_unregister_device);
David Brownella1d9e6e2007-05-01 23:26:30 +02001095
1096
Jean Delvare60b129d2008-05-11 20:37:06 +02001097static const struct i2c_device_id dummy_id[] = {
1098 { "dummy", 0 },
1099 { },
1100};
1101
Jean Delvared2653e92008-04-29 23:11:39 +02001102static int dummy_probe(struct i2c_client *client,
1103 const struct i2c_device_id *id)
1104{
1105 return 0;
1106}
1107
1108static int dummy_remove(struct i2c_client *client)
David Brownelle9f13732008-01-27 18:14:52 +01001109{
1110 return 0;
1111}
1112
1113static struct i2c_driver dummy_driver = {
1114 .driver.name = "dummy",
Jean Delvared2653e92008-04-29 23:11:39 +02001115 .probe = dummy_probe,
1116 .remove = dummy_remove,
Jean Delvare60b129d2008-05-11 20:37:06 +02001117 .id_table = dummy_id,
David Brownelle9f13732008-01-27 18:14:52 +01001118};
1119
1120/**
1121 * i2c_new_dummy - return a new i2c device bound to a dummy driver
1122 * @adapter: the adapter managing the device
1123 * @address: seven bit address to be used
David Brownelle9f13732008-01-27 18:14:52 +01001124 * Context: can sleep
1125 *
1126 * This returns an I2C client bound to the "dummy" driver, intended for use
1127 * with devices that consume multiple addresses. Examples of such chips
1128 * include various EEPROMS (like 24c04 and 24c08 models).
1129 *
1130 * These dummy devices have two main uses. First, most I2C and SMBus calls
1131 * except i2c_transfer() need a client handle; the dummy will be that handle.
1132 * And second, this prevents the specified address from being bound to a
1133 * different driver.
1134 *
1135 * This returns the new i2c client, which should be saved for later use with
1136 * i2c_unregister_device(); or NULL to indicate an error.
1137 */
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01001138struct i2c_client *i2c_new_dummy(struct i2c_adapter *adapter, u16 address)
David Brownelle9f13732008-01-27 18:14:52 +01001139{
1140 struct i2c_board_info info = {
Jean Delvare60b129d2008-05-11 20:37:06 +02001141 I2C_BOARD_INFO("dummy", address),
David Brownelle9f13732008-01-27 18:14:52 +01001142 };
1143
David Brownelle9f13732008-01-27 18:14:52 +01001144 return i2c_new_device(adapter, &info);
1145}
1146EXPORT_SYMBOL_GPL(i2c_new_dummy);
1147
David Brownellf37dd802007-02-13 22:09:00 +01001148/* ------------------------------------------------------------------------- */
1149
David Brownell16ffadf2007-05-01 23:26:28 +02001150/* I2C bus adapters -- one roots each I2C or SMBUS segment */
1151
Adrian Bunk83eaaed2007-10-13 23:56:30 +02001152static void i2c_adapter_dev_release(struct device *dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001153{
David Brownellef2c83212007-05-01 23:26:28 +02001154 struct i2c_adapter *adap = to_i2c_adapter(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001155 complete(&adap->dev_released);
1156}
1157
Jean Delvare99cd8e22009-06-19 16:58:20 +02001158/*
Jean Delvare390946b2012-09-10 10:14:02 +02001159 * This function is only needed for mutex_lock_nested, so it is never
1160 * called unless locking correctness checking is enabled. Thus we
1161 * make it inline to avoid a compiler warning. That's what gcc ends up
1162 * doing anyway.
1163 */
1164static inline unsigned int i2c_adapter_depth(struct i2c_adapter *adapter)
1165{
1166 unsigned int depth = 0;
1167
1168 while ((adapter = i2c_parent_is_i2c_adapter(adapter)))
1169 depth++;
1170
1171 return depth;
1172}
1173
1174/*
Jean Delvare99cd8e22009-06-19 16:58:20 +02001175 * Let users instantiate I2C devices through sysfs. This can be used when
1176 * platform initialization code doesn't contain the proper data for
1177 * whatever reason. Also useful for drivers that do device detection and
1178 * detection fails, either because the device uses an unexpected address,
1179 * or this is a compatible device with different ID register values.
1180 *
1181 * Parameter checking may look overzealous, but we really don't want
1182 * the user to provide incorrect parameters.
1183 */
1184static ssize_t
1185i2c_sysfs_new_device(struct device *dev, struct device_attribute *attr,
1186 const char *buf, size_t count)
1187{
1188 struct i2c_adapter *adap = to_i2c_adapter(dev);
1189 struct i2c_board_info info;
1190 struct i2c_client *client;
1191 char *blank, end;
1192 int res;
1193
Jean Delvare99cd8e22009-06-19 16:58:20 +02001194 memset(&info, 0, sizeof(struct i2c_board_info));
1195
1196 blank = strchr(buf, ' ');
1197 if (!blank) {
1198 dev_err(dev, "%s: Missing parameters\n", "new_device");
1199 return -EINVAL;
1200 }
1201 if (blank - buf > I2C_NAME_SIZE - 1) {
1202 dev_err(dev, "%s: Invalid device name\n", "new_device");
1203 return -EINVAL;
1204 }
1205 memcpy(info.type, buf, blank - buf);
1206
1207 /* Parse remaining parameters, reject extra parameters */
1208 res = sscanf(++blank, "%hi%c", &info.addr, &end);
1209 if (res < 1) {
1210 dev_err(dev, "%s: Can't parse I2C address\n", "new_device");
1211 return -EINVAL;
1212 }
1213 if (res > 1 && end != '\n') {
1214 dev_err(dev, "%s: Extra parameters\n", "new_device");
1215 return -EINVAL;
1216 }
1217
Wolfram Sangcfa03272015-07-27 14:03:38 +02001218 if ((info.addr & I2C_ADDR_OFFSET_TEN_BIT) == I2C_ADDR_OFFSET_TEN_BIT) {
1219 info.addr &= ~I2C_ADDR_OFFSET_TEN_BIT;
1220 info.flags |= I2C_CLIENT_TEN;
1221 }
1222
1223 if (info.addr & I2C_ADDR_OFFSET_SLAVE) {
1224 info.addr &= ~I2C_ADDR_OFFSET_SLAVE;
1225 info.flags |= I2C_CLIENT_SLAVE;
1226 }
1227
Jean Delvare99cd8e22009-06-19 16:58:20 +02001228 client = i2c_new_device(adap, &info);
1229 if (!client)
Jean Delvare3a89db52010-06-03 11:33:52 +02001230 return -EINVAL;
Jean Delvare99cd8e22009-06-19 16:58:20 +02001231
1232 /* Keep track of the added device */
Jean Delvaredafc50d2010-08-11 18:21:01 +02001233 mutex_lock(&adap->userspace_clients_lock);
Jean Delvare6629dcf2010-05-04 11:09:28 +02001234 list_add_tail(&client->detected, &adap->userspace_clients);
Jean Delvaredafc50d2010-08-11 18:21:01 +02001235 mutex_unlock(&adap->userspace_clients_lock);
Jean Delvare99cd8e22009-06-19 16:58:20 +02001236 dev_info(dev, "%s: Instantiated device %s at 0x%02hx\n", "new_device",
1237 info.type, info.addr);
1238
1239 return count;
1240}
Wolfram Sanga5eb71b2015-01-19 20:12:24 +01001241static DEVICE_ATTR(new_device, S_IWUSR, NULL, i2c_sysfs_new_device);
Jean Delvare99cd8e22009-06-19 16:58:20 +02001242
1243/*
1244 * And of course let the users delete the devices they instantiated, if
1245 * they got it wrong. This interface can only be used to delete devices
1246 * instantiated by i2c_sysfs_new_device above. This guarantees that we
1247 * don't delete devices to which some kernel code still has references.
1248 *
1249 * Parameter checking may look overzealous, but we really don't want
1250 * the user to delete the wrong device.
1251 */
1252static ssize_t
1253i2c_sysfs_delete_device(struct device *dev, struct device_attribute *attr,
1254 const char *buf, size_t count)
1255{
1256 struct i2c_adapter *adap = to_i2c_adapter(dev);
1257 struct i2c_client *client, *next;
1258 unsigned short addr;
1259 char end;
1260 int res;
1261
1262 /* Parse parameters, reject extra parameters */
1263 res = sscanf(buf, "%hi%c", &addr, &end);
1264 if (res < 1) {
1265 dev_err(dev, "%s: Can't parse I2C address\n", "delete_device");
1266 return -EINVAL;
1267 }
1268 if (res > 1 && end != '\n') {
1269 dev_err(dev, "%s: Extra parameters\n", "delete_device");
1270 return -EINVAL;
1271 }
1272
1273 /* Make sure the device was added through sysfs */
1274 res = -ENOENT;
Jean Delvare390946b2012-09-10 10:14:02 +02001275 mutex_lock_nested(&adap->userspace_clients_lock,
1276 i2c_adapter_depth(adap));
Jean Delvare6629dcf2010-05-04 11:09:28 +02001277 list_for_each_entry_safe(client, next, &adap->userspace_clients,
1278 detected) {
Wolfram Sangcfa03272015-07-27 14:03:38 +02001279 if (i2c_encode_flags_to_addr(client) == addr) {
Jean Delvare99cd8e22009-06-19 16:58:20 +02001280 dev_info(dev, "%s: Deleting device %s at 0x%02hx\n",
1281 "delete_device", client->name, client->addr);
1282
1283 list_del(&client->detected);
1284 i2c_unregister_device(client);
1285 res = count;
1286 break;
1287 }
1288 }
Jean Delvaredafc50d2010-08-11 18:21:01 +02001289 mutex_unlock(&adap->userspace_clients_lock);
Jean Delvare99cd8e22009-06-19 16:58:20 +02001290
1291 if (res < 0)
1292 dev_err(dev, "%s: Can't find device in list\n",
1293 "delete_device");
1294 return res;
1295}
Alexander Sverdline9b526f2013-05-17 14:56:35 +02001296static DEVICE_ATTR_IGNORE_LOCKDEP(delete_device, S_IWUSR, NULL,
1297 i2c_sysfs_delete_device);
Jean Delvare4f8cf822009-09-18 22:45:46 +02001298
1299static struct attribute *i2c_adapter_attrs[] = {
1300 &dev_attr_name.attr,
1301 &dev_attr_new_device.attr,
1302 &dev_attr_delete_device.attr,
1303 NULL
David Brownell16ffadf2007-05-01 23:26:28 +02001304};
Wolfram Sanga5eb71b2015-01-19 20:12:24 +01001305ATTRIBUTE_GROUPS(i2c_adapter);
Jean Delvare4f8cf822009-09-18 22:45:46 +02001306
Michael Lawnick08263742010-08-11 18:21:02 +02001307struct device_type i2c_adapter_type = {
Wolfram Sanga5eb71b2015-01-19 20:12:24 +01001308 .groups = i2c_adapter_groups,
Jean Delvare4f8cf822009-09-18 22:45:46 +02001309 .release = i2c_adapter_dev_release,
David Brownell16ffadf2007-05-01 23:26:28 +02001310};
Michael Lawnick08263742010-08-11 18:21:02 +02001311EXPORT_SYMBOL_GPL(i2c_adapter_type);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001312
Stephen Warren643dd092012-04-17 12:43:33 -06001313/**
1314 * i2c_verify_adapter - return parameter as i2c_adapter or NULL
1315 * @dev: device, probably from some driver model iterator
1316 *
1317 * When traversing the driver model tree, perhaps using driver model
1318 * iterators like @device_for_each_child(), you can't assume very much
1319 * about the nodes you find. Use this function to avoid oopses caused
1320 * by wrongly treating some non-I2C device as an i2c_adapter.
1321 */
1322struct i2c_adapter *i2c_verify_adapter(struct device *dev)
1323{
1324 return (dev->type == &i2c_adapter_type)
1325 ? to_i2c_adapter(dev)
1326 : NULL;
1327}
1328EXPORT_SYMBOL(i2c_verify_adapter);
1329
Jean Delvare2bb50952009-09-18 22:45:46 +02001330#ifdef CONFIG_I2C_COMPAT
1331static struct class_compat *i2c_adapter_compat_class;
1332#endif
1333
David Brownell9c1600e2007-05-01 23:26:31 +02001334static void i2c_scan_static_board_info(struct i2c_adapter *adapter)
1335{
1336 struct i2c_devinfo *devinfo;
1337
Rodolfo Giomettif18c41d2009-06-19 16:58:20 +02001338 down_read(&__i2c_board_lock);
David Brownell9c1600e2007-05-01 23:26:31 +02001339 list_for_each_entry(devinfo, &__i2c_board_list, list) {
1340 if (devinfo->busnum == adapter->nr
1341 && !i2c_new_device(adapter,
1342 &devinfo->board_info))
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01001343 dev_err(&adapter->dev,
1344 "Can't create device at 0x%02x\n",
David Brownell9c1600e2007-05-01 23:26:31 +02001345 devinfo->board_info.addr);
1346 }
Rodolfo Giomettif18c41d2009-06-19 16:58:20 +02001347 up_read(&__i2c_board_lock);
David Brownell9c1600e2007-05-01 23:26:31 +02001348}
1349
Wolfram Sang687b81d2013-07-11 12:56:15 +01001350/* OF support code */
1351
1352#if IS_ENABLED(CONFIG_OF)
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001353static struct i2c_client *of_i2c_register_device(struct i2c_adapter *adap,
1354 struct device_node *node)
1355{
1356 struct i2c_client *result;
1357 struct i2c_board_info info = {};
1358 struct dev_archdata dev_ad = {};
Wolfram Sangb4e2f6a2015-05-19 21:04:40 +02001359 const __be32 *addr_be;
1360 u32 addr;
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001361 int len;
1362
1363 dev_dbg(&adap->dev, "of_i2c: register %s\n", node->full_name);
1364
1365 if (of_modalias_node(node, info.type, sizeof(info.type)) < 0) {
1366 dev_err(&adap->dev, "of_i2c: modalias failure on %s\n",
1367 node->full_name);
1368 return ERR_PTR(-EINVAL);
1369 }
1370
Wolfram Sangb4e2f6a2015-05-19 21:04:40 +02001371 addr_be = of_get_property(node, "reg", &len);
1372 if (!addr_be || (len < sizeof(*addr_be))) {
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001373 dev_err(&adap->dev, "of_i2c: invalid reg on %s\n",
1374 node->full_name);
1375 return ERR_PTR(-EINVAL);
1376 }
1377
Wolfram Sangb4e2f6a2015-05-19 21:04:40 +02001378 addr = be32_to_cpup(addr_be);
1379 if (addr & I2C_TEN_BIT_ADDRESS) {
1380 addr &= ~I2C_TEN_BIT_ADDRESS;
1381 info.flags |= I2C_CLIENT_TEN;
1382 }
1383
1384 if (addr & I2C_OWN_SLAVE_ADDRESS) {
1385 addr &= ~I2C_OWN_SLAVE_ADDRESS;
1386 info.flags |= I2C_CLIENT_SLAVE;
1387 }
1388
1389 if (i2c_check_addr_validity(addr, info.flags)) {
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001390 dev_err(&adap->dev, "of_i2c: invalid addr=%x on %s\n",
1391 info.addr, node->full_name);
1392 return ERR_PTR(-EINVAL);
1393 }
1394
Wolfram Sangb4e2f6a2015-05-19 21:04:40 +02001395 info.addr = addr;
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001396 info.of_node = of_node_get(node);
1397 info.archdata = &dev_ad;
1398
1399 if (of_get_property(node, "wakeup-source", NULL))
1400 info.flags |= I2C_CLIENT_WAKE;
1401
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001402 result = i2c_new_device(adap, &info);
1403 if (result == NULL) {
1404 dev_err(&adap->dev, "of_i2c: Failure registering %s\n",
1405 node->full_name);
1406 of_node_put(node);
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001407 return ERR_PTR(-EINVAL);
1408 }
1409 return result;
1410}
1411
Wolfram Sang687b81d2013-07-11 12:56:15 +01001412static void of_i2c_register_devices(struct i2c_adapter *adap)
1413{
Jon Hunter7e4c2242016-06-29 10:17:53 +01001414 struct device_node *bus, *node;
Wolfram Sang687b81d2013-07-11 12:56:15 +01001415
1416 /* Only register child devices if the adapter has a node pointer set */
1417 if (!adap->dev.of_node)
1418 return;
1419
1420 dev_dbg(&adap->dev, "of_i2c: walking child nodes\n");
1421
Jon Hunter7e4c2242016-06-29 10:17:53 +01001422 bus = of_get_child_by_name(adap->dev.of_node, "i2c-bus");
1423 if (!bus)
1424 bus = of_node_get(adap->dev.of_node);
1425
1426 for_each_available_child_of_node(bus, node) {
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001427 if (of_node_test_and_set_flag(node, OF_POPULATED))
1428 continue;
Pantelis Antonioua430a3452014-10-28 22:36:02 +02001429 of_i2c_register_device(adap, node);
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02001430 }
Jon Hunter7e4c2242016-06-29 10:17:53 +01001431
1432 of_node_put(bus);
Wolfram Sang687b81d2013-07-11 12:56:15 +01001433}
1434
1435static int of_dev_node_match(struct device *dev, void *data)
1436{
1437 return dev->of_node == data;
1438}
1439
1440/* must call put_device() when done with returned i2c_client device */
1441struct i2c_client *of_find_i2c_device_by_node(struct device_node *node)
1442{
1443 struct device *dev;
Vladimir Zapolskiye3311462015-07-27 17:30:48 +03001444 struct i2c_client *client;
Wolfram Sang687b81d2013-07-11 12:56:15 +01001445
Vladimir Zapolskiye3311462015-07-27 17:30:48 +03001446 dev = bus_find_device(&i2c_bus_type, NULL, node, of_dev_node_match);
Wolfram Sang687b81d2013-07-11 12:56:15 +01001447 if (!dev)
1448 return NULL;
1449
Vladimir Zapolskiye3311462015-07-27 17:30:48 +03001450 client = i2c_verify_client(dev);
1451 if (!client)
1452 put_device(dev);
1453
1454 return client;
Wolfram Sang687b81d2013-07-11 12:56:15 +01001455}
1456EXPORT_SYMBOL(of_find_i2c_device_by_node);
1457
1458/* must call put_device() when done with returned i2c_adapter device */
1459struct i2c_adapter *of_find_i2c_adapter_by_node(struct device_node *node)
1460{
1461 struct device *dev;
Vladimir Zapolskiye3311462015-07-27 17:30:48 +03001462 struct i2c_adapter *adapter;
Wolfram Sang687b81d2013-07-11 12:56:15 +01001463
Vladimir Zapolskiye3311462015-07-27 17:30:48 +03001464 dev = bus_find_device(&i2c_bus_type, NULL, node, of_dev_node_match);
Wolfram Sang687b81d2013-07-11 12:56:15 +01001465 if (!dev)
1466 return NULL;
1467
Vladimir Zapolskiye3311462015-07-27 17:30:48 +03001468 adapter = i2c_verify_adapter(dev);
1469 if (!adapter)
1470 put_device(dev);
1471
1472 return adapter;
Wolfram Sang687b81d2013-07-11 12:56:15 +01001473}
1474EXPORT_SYMBOL(of_find_i2c_adapter_by_node);
Vladimir Zapolskiy48e97432015-07-27 17:30:50 +03001475
1476/* must call i2c_put_adapter() when done with returned i2c_adapter device */
1477struct i2c_adapter *of_get_i2c_adapter_by_node(struct device_node *node)
1478{
1479 struct i2c_adapter *adapter;
1480
1481 adapter = of_find_i2c_adapter_by_node(node);
1482 if (!adapter)
1483 return NULL;
1484
1485 if (!try_module_get(adapter->owner)) {
1486 put_device(&adapter->dev);
1487 adapter = NULL;
1488 }
1489
1490 return adapter;
1491}
1492EXPORT_SYMBOL(of_get_i2c_adapter_by_node);
Wolfram Sang687b81d2013-07-11 12:56:15 +01001493#else
1494static void of_i2c_register_devices(struct i2c_adapter *adap) { }
1495#endif /* CONFIG_OF */
1496
Jean Delvare69b00892009-12-06 17:06:27 +01001497static int i2c_do_add_adapter(struct i2c_driver *driver,
1498 struct i2c_adapter *adap)
Jean Delvare026526f2008-01-27 18:14:49 +01001499{
Jean Delvare4735c982008-07-14 22:38:36 +02001500 /* Detect supported devices on that bus, and instantiate them */
1501 i2c_detect(adap, driver);
1502
1503 /* Let legacy drivers scan this bus for matching devices */
Jean Delvare026526f2008-01-27 18:14:49 +01001504 if (driver->attach_adapter) {
Jean Delvarea920ff42011-04-17 10:20:19 +02001505 dev_warn(&adap->dev, "%s: attach_adapter method is deprecated\n",
1506 driver->driver.name);
Jean Delvarefe6fc252011-03-20 14:50:53 +01001507 dev_warn(&adap->dev, "Please use another way to instantiate "
1508 "your i2c_client\n");
Jean Delvare026526f2008-01-27 18:14:49 +01001509 /* We ignore the return code; if it fails, too bad */
1510 driver->attach_adapter(adap);
1511 }
1512 return 0;
1513}
1514
Jean Delvare69b00892009-12-06 17:06:27 +01001515static int __process_new_adapter(struct device_driver *d, void *data)
1516{
1517 return i2c_do_add_adapter(to_i2c_driver(d), data);
1518}
1519
David Brownell6e13e642007-05-01 23:26:31 +02001520static int i2c_register_adapter(struct i2c_adapter *adap)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001521{
Jean Delvared6703282010-08-11 18:20:59 +02001522 int res = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001523
David Brownell1d0b19c2008-10-14 17:30:05 +02001524 /* Can't register until after driver model init */
Sudip Mukherjee95026652016-03-07 17:19:17 +05301525 if (WARN_ON(!is_registered)) {
Jean Delvare35fc37f2009-06-19 16:58:19 +02001526 res = -EAGAIN;
1527 goto out_list;
1528 }
David Brownell1d0b19c2008-10-14 17:30:05 +02001529
Jean Delvare2236baa2010-11-15 22:40:38 +01001530 /* Sanity checks */
1531 if (unlikely(adap->name[0] == '\0')) {
1532 pr_err("i2c-core: Attempt to register an adapter with "
1533 "no name!\n");
1534 return -EINVAL;
1535 }
1536 if (unlikely(!adap->algo)) {
1537 pr_err("i2c-core: Attempt to register adapter '%s' with "
1538 "no algo!\n", adap->name);
1539 return -EINVAL;
1540 }
1541
Peter Rosin8320f492016-05-04 22:15:27 +02001542 if (!adap->lock_bus) {
1543 adap->lock_bus = i2c_adapter_lock_bus;
1544 adap->trylock_bus = i2c_adapter_trylock_bus;
1545 adap->unlock_bus = i2c_adapter_unlock_bus;
1546 }
1547
Mika Kuoppala194684e2009-12-06 17:06:22 +01001548 rt_mutex_init(&adap->bus_lock);
Peter Rosin6ef91fc2016-05-04 22:15:29 +02001549 rt_mutex_init(&adap->mux_lock);
Jean Delvaredafc50d2010-08-11 18:21:01 +02001550 mutex_init(&adap->userspace_clients_lock);
Jean Delvare6629dcf2010-05-04 11:09:28 +02001551 INIT_LIST_HEAD(&adap->userspace_clients);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001552
Jean Delvare8fcfef62009-03-28 21:34:43 +01001553 /* Set default timeout to 1 second if not already set */
1554 if (adap->timeout == 0)
1555 adap->timeout = HZ;
1556
Kay Sievers27d9c182009-01-07 14:29:16 +01001557 dev_set_name(&adap->dev, "i2c-%d", adap->nr);
Jean Delvare4f8cf822009-09-18 22:45:46 +02001558 adap->dev.bus = &i2c_bus_type;
1559 adap->dev.type = &i2c_adapter_type;
Jean Delvareb119c6c2006-08-15 18:26:30 +02001560 res = device_register(&adap->dev);
1561 if (res)
1562 goto out_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001563
Jean Delvareb6d7b3d2005-07-31 19:02:53 +02001564 dev_dbg(&adap->dev, "adapter [%s] registered\n", adap->name);
1565
Charles Keepax6ada5c12015-04-16 13:05:19 +01001566 pm_runtime_no_callbacks(&adap->dev);
Linus Walleij04f59142016-04-12 09:57:35 +02001567 pm_suspend_ignore_children(&adap->dev, true);
Wolfram Sang9f924162015-12-23 18:19:28 +01001568 pm_runtime_enable(&adap->dev);
Charles Keepax6ada5c12015-04-16 13:05:19 +01001569
Jean Delvare2bb50952009-09-18 22:45:46 +02001570#ifdef CONFIG_I2C_COMPAT
1571 res = class_compat_create_link(i2c_adapter_compat_class, &adap->dev,
1572 adap->dev.parent);
1573 if (res)
1574 dev_warn(&adap->dev,
1575 "Failed to create compatibility class link\n");
1576#endif
1577
Viresh Kumar5f9296b2012-02-28 18:26:31 +05301578 /* bus recovery specific initialization */
1579 if (adap->bus_recovery_info) {
1580 struct i2c_bus_recovery_info *bri = adap->bus_recovery_info;
1581
1582 if (!bri->recover_bus) {
1583 dev_err(&adap->dev, "No recover_bus() found, not using recovery\n");
1584 adap->bus_recovery_info = NULL;
1585 goto exit_recovery;
1586 }
1587
1588 /* Generic GPIO recovery */
1589 if (bri->recover_bus == i2c_generic_gpio_recovery) {
1590 if (!gpio_is_valid(bri->scl_gpio)) {
1591 dev_err(&adap->dev, "Invalid SCL gpio, not using recovery\n");
1592 adap->bus_recovery_info = NULL;
1593 goto exit_recovery;
1594 }
1595
1596 if (gpio_is_valid(bri->sda_gpio))
1597 bri->get_sda = get_sda_gpio_value;
1598 else
1599 bri->get_sda = NULL;
1600
1601 bri->get_scl = get_scl_gpio_value;
1602 bri->set_scl = set_scl_gpio_value;
Wolfram Sang3a9ddaf2016-05-12 11:25:19 +02001603 } else if (bri->recover_bus == i2c_generic_scl_recovery) {
Viresh Kumar5f9296b2012-02-28 18:26:31 +05301604 /* Generic SCL recovery */
Wolfram Sang3a9ddaf2016-05-12 11:25:19 +02001605 if (!bri->set_scl || !bri->get_scl) {
1606 dev_err(&adap->dev, "No {get|set}_scl() found, not using recovery\n");
1607 adap->bus_recovery_info = NULL;
1608 }
Viresh Kumar5f9296b2012-02-28 18:26:31 +05301609 }
1610 }
1611
1612exit_recovery:
Jean Delvare729d6dd2009-06-19 16:58:18 +02001613 /* create pre-declared device nodes */
Wolfram Sang687b81d2013-07-11 12:56:15 +01001614 of_i2c_register_devices(adap);
Mika Westerberg55e71ed2013-08-21 17:28:23 +03001615 acpi_i2c_register_devices(adap);
Lan Tianyu5d98e612014-05-20 20:59:23 +08001616 acpi_i2c_install_space_handler(adap);
Wolfram Sang687b81d2013-07-11 12:56:15 +01001617
David Brownell6e13e642007-05-01 23:26:31 +02001618 if (adap->nr < __i2c_first_dynamic_bus_num)
1619 i2c_scan_static_board_info(adap);
1620
Jean Delvare4735c982008-07-14 22:38:36 +02001621 /* Notify drivers */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001622 mutex_lock(&core_lock);
Jean Delvared6703282010-08-11 18:20:59 +02001623 bus_for_each_drv(&i2c_bus_type, NULL, adap, __process_new_adapter);
Jean Delvarecaada322008-01-27 18:14:49 +01001624 mutex_unlock(&core_lock);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001625
1626 return 0;
Jean Delvareb119c6c2006-08-15 18:26:30 +02001627
Jean Delvareb119c6c2006-08-15 18:26:30 +02001628out_list:
Jean Delvare35fc37f2009-06-19 16:58:19 +02001629 mutex_lock(&core_lock);
Jean Delvareb119c6c2006-08-15 18:26:30 +02001630 idr_remove(&i2c_adapter_idr, adap->nr);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001631 mutex_unlock(&core_lock);
1632 return res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001633}
1634
David Brownell6e13e642007-05-01 23:26:31 +02001635/**
Doug Andersonee5c2742013-03-01 08:57:31 -08001636 * __i2c_add_numbered_adapter - i2c_add_numbered_adapter where nr is never -1
1637 * @adap: the adapter to register (with adap->nr initialized)
1638 * Context: can sleep
1639 *
1640 * See i2c_add_numbered_adapter() for details.
1641 */
1642static int __i2c_add_numbered_adapter(struct i2c_adapter *adap)
1643{
1644 int id;
1645
1646 mutex_lock(&core_lock);
1647 id = idr_alloc(&i2c_adapter_idr, adap, adap->nr, adap->nr + 1,
1648 GFP_KERNEL);
1649 mutex_unlock(&core_lock);
1650 if (id < 0)
1651 return id == -ENOSPC ? -EBUSY : id;
1652
1653 return i2c_register_adapter(adap);
1654}
1655
1656/**
David Brownell6e13e642007-05-01 23:26:31 +02001657 * i2c_add_adapter - declare i2c adapter, use dynamic bus number
1658 * @adapter: the adapter to add
David Brownelld64f73b2007-07-12 14:12:28 +02001659 * Context: can sleep
David Brownell6e13e642007-05-01 23:26:31 +02001660 *
1661 * This routine is used to declare an I2C adapter when its bus number
Doug Andersonee5c2742013-03-01 08:57:31 -08001662 * doesn't matter or when its bus number is specified by an dt alias.
1663 * Examples of bases when the bus number doesn't matter: I2C adapters
1664 * dynamically added by USB links or PCI plugin cards.
David Brownell6e13e642007-05-01 23:26:31 +02001665 *
1666 * When this returns zero, a new bus number was allocated and stored
1667 * in adap->nr, and the specified adapter became available for clients.
1668 * Otherwise, a negative errno value is returned.
1669 */
1670int i2c_add_adapter(struct i2c_adapter *adapter)
1671{
Doug Andersonee5c2742013-03-01 08:57:31 -08001672 struct device *dev = &adapter->dev;
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001673 int id;
David Brownell6e13e642007-05-01 23:26:31 +02001674
Doug Andersonee5c2742013-03-01 08:57:31 -08001675 if (dev->of_node) {
1676 id = of_alias_get_id(dev->of_node, "i2c");
1677 if (id >= 0) {
1678 adapter->nr = id;
1679 return __i2c_add_numbered_adapter(adapter);
1680 }
1681 }
1682
Jean Delvarecaada322008-01-27 18:14:49 +01001683 mutex_lock(&core_lock);
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001684 id = idr_alloc(&i2c_adapter_idr, adapter,
1685 __i2c_first_dynamic_bus_num, 0, GFP_KERNEL);
Jean Delvarecaada322008-01-27 18:14:49 +01001686 mutex_unlock(&core_lock);
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001687 if (id < 0)
1688 return id;
David Brownell6e13e642007-05-01 23:26:31 +02001689
1690 adapter->nr = id;
Tejun Heo4ae42b0f2013-02-27 17:04:15 -08001691
David Brownell6e13e642007-05-01 23:26:31 +02001692 return i2c_register_adapter(adapter);
1693}
1694EXPORT_SYMBOL(i2c_add_adapter);
1695
1696/**
1697 * i2c_add_numbered_adapter - declare i2c adapter, use static bus number
1698 * @adap: the adapter to register (with adap->nr initialized)
David Brownelld64f73b2007-07-12 14:12:28 +02001699 * Context: can sleep
David Brownell6e13e642007-05-01 23:26:31 +02001700 *
1701 * This routine is used to declare an I2C adapter when its bus number
Randy Dunlap8c07e462008-03-23 20:28:20 +01001702 * matters. For example, use it for I2C adapters from system-on-chip CPUs,
1703 * or otherwise built in to the system's mainboard, and where i2c_board_info
David Brownell6e13e642007-05-01 23:26:31 +02001704 * is used to properly configure I2C devices.
1705 *
Grant Likely488bf312011-07-25 17:49:43 +02001706 * If the requested bus number is set to -1, then this function will behave
1707 * identically to i2c_add_adapter, and will dynamically assign a bus number.
1708 *
David Brownell6e13e642007-05-01 23:26:31 +02001709 * If no devices have pre-been declared for this bus, then be sure to
1710 * register the adapter before any dynamically allocated ones. Otherwise
1711 * the required bus ID may not be available.
1712 *
1713 * When this returns zero, the specified adapter became available for
1714 * clients using the bus number provided in adap->nr. Also, the table
1715 * of I2C devices pre-declared using i2c_register_board_info() is scanned,
1716 * and the appropriate driver model device nodes are created. Otherwise, a
1717 * negative errno value is returned.
1718 */
1719int i2c_add_numbered_adapter(struct i2c_adapter *adap)
1720{
Grant Likely488bf312011-07-25 17:49:43 +02001721 if (adap->nr == -1) /* -1 means dynamically assign bus id */
1722 return i2c_add_adapter(adap);
David Brownell6e13e642007-05-01 23:26:31 +02001723
Doug Andersonee5c2742013-03-01 08:57:31 -08001724 return __i2c_add_numbered_adapter(adap);
David Brownell6e13e642007-05-01 23:26:31 +02001725}
1726EXPORT_SYMBOL_GPL(i2c_add_numbered_adapter);
1727
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001728static void i2c_do_del_adapter(struct i2c_driver *driver,
Jean Delvare69b00892009-12-06 17:06:27 +01001729 struct i2c_adapter *adapter)
Jean Delvare026526f2008-01-27 18:14:49 +01001730{
Jean Delvare4735c982008-07-14 22:38:36 +02001731 struct i2c_client *client, *_n;
Jean Delvare026526f2008-01-27 18:14:49 +01001732
Jean Delvareacec2112009-03-28 21:34:40 +01001733 /* Remove the devices we created ourselves as the result of hardware
1734 * probing (using a driver's detect method) */
Jean Delvare4735c982008-07-14 22:38:36 +02001735 list_for_each_entry_safe(client, _n, &driver->clients, detected) {
1736 if (client->adapter == adapter) {
1737 dev_dbg(&adapter->dev, "Removing %s at 0x%x\n",
1738 client->name, client->addr);
1739 list_del(&client->detected);
1740 i2c_unregister_device(client);
1741 }
1742 }
Jean Delvare026526f2008-01-27 18:14:49 +01001743}
1744
Jean Delvaree549c2b2009-06-19 16:58:19 +02001745static int __unregister_client(struct device *dev, void *dummy)
1746{
1747 struct i2c_client *client = i2c_verify_client(dev);
Jean Delvare5219bf82011-01-14 22:03:49 +01001748 if (client && strcmp(client->name, "dummy"))
1749 i2c_unregister_device(client);
1750 return 0;
1751}
1752
1753static int __unregister_dummy(struct device *dev, void *dummy)
1754{
1755 struct i2c_client *client = i2c_verify_client(dev);
Jean Delvaree549c2b2009-06-19 16:58:19 +02001756 if (client)
1757 i2c_unregister_device(client);
1758 return 0;
1759}
1760
Jean Delvare69b00892009-12-06 17:06:27 +01001761static int __process_removed_adapter(struct device_driver *d, void *data)
1762{
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001763 i2c_do_del_adapter(to_i2c_driver(d), data);
1764 return 0;
Jean Delvare69b00892009-12-06 17:06:27 +01001765}
1766
David Brownelld64f73b2007-07-12 14:12:28 +02001767/**
1768 * i2c_del_adapter - unregister I2C adapter
1769 * @adap: the adapter being unregistered
1770 * Context: can sleep
1771 *
1772 * This unregisters an I2C adapter which was previously registered
1773 * by @i2c_add_adapter or @i2c_add_numbered_adapter.
1774 */
Lars-Peter Clausen71546302013-03-09 08:16:47 +00001775void i2c_del_adapter(struct i2c_adapter *adap)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001776{
Jean Delvare35fc37f2009-06-19 16:58:19 +02001777 struct i2c_adapter *found;
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001778 struct i2c_client *client, *next;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001779
1780 /* First make sure that this adapter was ever added */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001781 mutex_lock(&core_lock);
1782 found = idr_find(&i2c_adapter_idr, adap->nr);
1783 mutex_unlock(&core_lock);
1784 if (found != adap) {
Jean Delvareb6d7b3d2005-07-31 19:02:53 +02001785 pr_debug("i2c-core: attempting to delete unregistered "
1786 "adapter [%s]\n", adap->name);
Lars-Peter Clausen71546302013-03-09 08:16:47 +00001787 return;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001788 }
1789
Lan Tianyu5d98e612014-05-20 20:59:23 +08001790 acpi_i2c_remove_space_handler(adap);
Jean Delvare026526f2008-01-27 18:14:49 +01001791 /* Tell drivers about this removal */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001792 mutex_lock(&core_lock);
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001793 bus_for_each_drv(&i2c_bus_type, NULL, adap,
Jean Delvare69b00892009-12-06 17:06:27 +01001794 __process_removed_adapter);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001795 mutex_unlock(&core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001796
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001797 /* Remove devices instantiated from sysfs */
Jean Delvare390946b2012-09-10 10:14:02 +02001798 mutex_lock_nested(&adap->userspace_clients_lock,
1799 i2c_adapter_depth(adap));
Jean Delvare6629dcf2010-05-04 11:09:28 +02001800 list_for_each_entry_safe(client, next, &adap->userspace_clients,
1801 detected) {
1802 dev_dbg(&adap->dev, "Removing %s at 0x%x\n", client->name,
1803 client->addr);
1804 list_del(&client->detected);
1805 i2c_unregister_device(client);
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001806 }
Jean Delvaredafc50d2010-08-11 18:21:01 +02001807 mutex_unlock(&adap->userspace_clients_lock);
Jean Delvarebbd2d9c2009-11-26 09:22:33 +01001808
Jean Delvaree549c2b2009-06-19 16:58:19 +02001809 /* Detach any active clients. This can't fail, thus we do not
Jean Delvare5219bf82011-01-14 22:03:49 +01001810 * check the returned value. This is a two-pass process, because
1811 * we can't remove the dummy devices during the first pass: they
1812 * could have been instantiated by real devices wishing to clean
1813 * them up properly, so we give them a chance to do that first. */
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001814 device_for_each_child(&adap->dev, NULL, __unregister_client);
1815 device_for_each_child(&adap->dev, NULL, __unregister_dummy);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001816
Jean Delvare2bb50952009-09-18 22:45:46 +02001817#ifdef CONFIG_I2C_COMPAT
1818 class_compat_remove_link(i2c_adapter_compat_class, &adap->dev,
1819 adap->dev.parent);
1820#endif
1821
Thadeu Lima de Souza Cascardoc5567522010-01-16 20:43:13 +01001822 /* device name is gone after device_unregister */
1823 dev_dbg(&adap->dev, "adapter [%s] unregistered\n", adap->name);
1824
Wolfram Sang9f924162015-12-23 18:19:28 +01001825 pm_runtime_disable(&adap->dev);
1826
Wolfram Sang26680ee2015-01-29 22:45:09 +01001827 /* wait until all references to the device are gone
1828 *
1829 * FIXME: This is old code and should ideally be replaced by an
1830 * alternative which results in decoupling the lifetime of the struct
1831 * device from the i2c_adapter, like spi or netdev do. Any solution
Shailendra Verma95cc1e32015-05-18 22:24:01 +05301832 * should be thoroughly tested with DEBUG_KOBJECT_RELEASE enabled!
Wolfram Sang26680ee2015-01-29 22:45:09 +01001833 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001834 init_completion(&adap->dev_released);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001835 device_unregister(&adap->dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001836 wait_for_completion(&adap->dev_released);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001837
David Brownell6e13e642007-05-01 23:26:31 +02001838 /* free bus id */
Jean Delvare35fc37f2009-06-19 16:58:19 +02001839 mutex_lock(&core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001840 idr_remove(&i2c_adapter_idr, adap->nr);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001841 mutex_unlock(&core_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001842
Jean Delvarebd4bc3db2008-07-16 19:30:05 +02001843 /* Clear the device structure in case this adapter is ever going to be
1844 added again */
1845 memset(&adap->dev, 0, sizeof(adap->dev));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001846}
David Brownellc0564602007-05-01 23:26:31 +02001847EXPORT_SYMBOL(i2c_del_adapter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001848
Wolfram Sang54177cc2015-12-17 13:32:36 +01001849/**
1850 * i2c_parse_fw_timings - get I2C related timing parameters from firmware
1851 * @dev: The device to scan for I2C timing properties
1852 * @t: the i2c_timings struct to be filled with values
1853 * @use_defaults: bool to use sane defaults derived from the I2C specification
1854 * when properties are not found, otherwise use 0
1855 *
1856 * Scan the device for the generic I2C properties describing timing parameters
1857 * for the signal and fill the given struct with the results. If a property was
1858 * not found and use_defaults was true, then maximum timings are assumed which
1859 * are derived from the I2C specification. If use_defaults is not used, the
1860 * results will be 0, so drivers can apply their own defaults later. The latter
1861 * is mainly intended for avoiding regressions of existing drivers which want
1862 * to switch to this function. New drivers almost always should use the defaults.
1863 */
1864
1865void i2c_parse_fw_timings(struct device *dev, struct i2c_timings *t, bool use_defaults)
1866{
1867 int ret;
1868
1869 memset(t, 0, sizeof(*t));
1870
1871 ret = device_property_read_u32(dev, "clock-frequency", &t->bus_freq_hz);
1872 if (ret && use_defaults)
1873 t->bus_freq_hz = 100000;
1874
1875 ret = device_property_read_u32(dev, "i2c-scl-rising-time-ns", &t->scl_rise_ns);
1876 if (ret && use_defaults) {
1877 if (t->bus_freq_hz <= 100000)
1878 t->scl_rise_ns = 1000;
1879 else if (t->bus_freq_hz <= 400000)
1880 t->scl_rise_ns = 300;
1881 else
1882 t->scl_rise_ns = 120;
1883 }
1884
1885 ret = device_property_read_u32(dev, "i2c-scl-falling-time-ns", &t->scl_fall_ns);
1886 if (ret && use_defaults) {
1887 if (t->bus_freq_hz <= 400000)
1888 t->scl_fall_ns = 300;
1889 else
1890 t->scl_fall_ns = 120;
1891 }
1892
1893 device_property_read_u32(dev, "i2c-scl-internal-delay-ns", &t->scl_int_delay_ns);
1894
1895 ret = device_property_read_u32(dev, "i2c-sda-falling-time-ns", &t->sda_fall_ns);
1896 if (ret && use_defaults)
1897 t->sda_fall_ns = t->scl_fall_ns;
1898}
1899EXPORT_SYMBOL_GPL(i2c_parse_fw_timings);
1900
David Brownell7b4fbc52007-05-01 23:26:30 +02001901/* ------------------------------------------------------------------------- */
1902
Jean Delvare7ae31482011-03-20 14:50:52 +01001903int i2c_for_each_dev(void *data, int (*fn)(struct device *, void *))
1904{
1905 int res;
1906
1907 mutex_lock(&core_lock);
1908 res = bus_for_each_dev(&i2c_bus_type, NULL, data, fn);
1909 mutex_unlock(&core_lock);
1910
1911 return res;
1912}
1913EXPORT_SYMBOL_GPL(i2c_for_each_dev);
1914
Jean Delvare69b00892009-12-06 17:06:27 +01001915static int __process_new_driver(struct device *dev, void *data)
Dave Young7f101a92008-07-14 22:38:19 +02001916{
Jean Delvare4f8cf822009-09-18 22:45:46 +02001917 if (dev->type != &i2c_adapter_type)
1918 return 0;
Jean Delvare69b00892009-12-06 17:06:27 +01001919 return i2c_do_add_adapter(data, to_i2c_adapter(dev));
Dave Young7f101a92008-07-14 22:38:19 +02001920}
1921
David Brownell7b4fbc52007-05-01 23:26:30 +02001922/*
1923 * An i2c_driver is used with one or more i2c_client (device) nodes to access
Jean Delvare729d6dd2009-06-19 16:58:18 +02001924 * i2c slave chips, on a bus instance associated with some i2c_adapter.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001925 */
1926
Greg Kroah-Hartmande59cf92005-12-06 15:33:15 -08001927int i2c_register_driver(struct module *owner, struct i2c_driver *driver)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001928{
Jean Delvare7eebcb72006-02-05 23:28:21 +01001929 int res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001930
David Brownell1d0b19c2008-10-14 17:30:05 +02001931 /* Can't register until after driver model init */
Sudip Mukherjee95026652016-03-07 17:19:17 +05301932 if (WARN_ON(!is_registered))
David Brownell1d0b19c2008-10-14 17:30:05 +02001933 return -EAGAIN;
1934
Linus Torvalds1da177e2005-04-16 15:20:36 -07001935 /* add the driver to the list of i2c drivers in the driver core */
Greg Kroah-Hartmande59cf92005-12-06 15:33:15 -08001936 driver->driver.owner = owner;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001937 driver->driver.bus = &i2c_bus_type;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001938
Jean Delvare729d6dd2009-06-19 16:58:18 +02001939 /* When registration returns, the driver core
David Brownell6e13e642007-05-01 23:26:31 +02001940 * will have called probe() for all matching-but-unbound devices.
1941 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001942 res = driver_register(&driver->driver);
1943 if (res)
Jean Delvare7eebcb72006-02-05 23:28:21 +01001944 return res;
David Brownell438d6c22006-12-10 21:21:31 +01001945
Laurent Riffard35d8b2e2005-11-26 20:34:05 +01001946 pr_debug("i2c-core: driver [%s] registered\n", driver->driver.name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001947
Jean Delvare4735c982008-07-14 22:38:36 +02001948 INIT_LIST_HEAD(&driver->clients);
1949 /* Walk the adapters that are already present */
Jean Delvare7ae31482011-03-20 14:50:52 +01001950 i2c_for_each_dev(driver, __process_new_driver);
Jean Delvare35fc37f2009-06-19 16:58:19 +02001951
Jean Delvare7eebcb72006-02-05 23:28:21 +01001952 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001953}
Greg Kroah-Hartmande59cf92005-12-06 15:33:15 -08001954EXPORT_SYMBOL(i2c_register_driver);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001955
Jean Delvare69b00892009-12-06 17:06:27 +01001956static int __process_removed_driver(struct device *dev, void *data)
Dave Young7f101a92008-07-14 22:38:19 +02001957{
Lars-Peter Clausen19baba42013-03-09 08:16:44 +00001958 if (dev->type == &i2c_adapter_type)
1959 i2c_do_del_adapter(data, to_i2c_adapter(dev));
1960 return 0;
Dave Young7f101a92008-07-14 22:38:19 +02001961}
1962
David Brownella1d9e6e2007-05-01 23:26:30 +02001963/**
1964 * i2c_del_driver - unregister I2C driver
1965 * @driver: the driver being unregistered
David Brownelld64f73b2007-07-12 14:12:28 +02001966 * Context: can sleep
David Brownella1d9e6e2007-05-01 23:26:30 +02001967 */
Jean Delvareb3e82092007-05-01 23:26:32 +02001968void i2c_del_driver(struct i2c_driver *driver)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001969{
Jean Delvare7ae31482011-03-20 14:50:52 +01001970 i2c_for_each_dev(driver, __process_removed_driver);
David Brownella1d9e6e2007-05-01 23:26:30 +02001971
Linus Torvalds1da177e2005-04-16 15:20:36 -07001972 driver_unregister(&driver->driver);
Laurent Riffard35d8b2e2005-11-26 20:34:05 +01001973 pr_debug("i2c-core: driver [%s] unregistered\n", driver->driver.name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001974}
David Brownellc0564602007-05-01 23:26:31 +02001975EXPORT_SYMBOL(i2c_del_driver);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001976
David Brownell7b4fbc52007-05-01 23:26:30 +02001977/* ------------------------------------------------------------------------- */
1978
Jean Delvaree48d3312008-01-27 18:14:48 +01001979/**
1980 * i2c_use_client - increments the reference count of the i2c client structure
1981 * @client: the client being referenced
1982 *
1983 * Each live reference to a client should be refcounted. The driver model does
1984 * that automatically as part of driver binding, so that most drivers don't
1985 * need to do this explicitly: they hold a reference until they're unbound
1986 * from the device.
1987 *
1988 * A pointer to the client with the incremented reference counter is returned.
1989 */
1990struct i2c_client *i2c_use_client(struct i2c_client *client)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001991{
David Brownell6ea438e2008-07-14 22:38:24 +02001992 if (client && get_device(&client->dev))
1993 return client;
1994 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001995}
David Brownellc0564602007-05-01 23:26:31 +02001996EXPORT_SYMBOL(i2c_use_client);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001997
Jean Delvaree48d3312008-01-27 18:14:48 +01001998/**
1999 * i2c_release_client - release a use of the i2c client structure
2000 * @client: the client being no longer referenced
2001 *
2002 * Must be called when a user of a client is finished with it.
2003 */
2004void i2c_release_client(struct i2c_client *client)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002005{
David Brownell6ea438e2008-07-14 22:38:24 +02002006 if (client)
2007 put_device(&client->dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002008}
David Brownellc0564602007-05-01 23:26:31 +02002009EXPORT_SYMBOL(i2c_release_client);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002010
David Brownell9b766b82008-01-27 18:14:51 +01002011struct i2c_cmd_arg {
2012 unsigned cmd;
2013 void *arg;
2014};
2015
2016static int i2c_cmd(struct device *dev, void *_arg)
2017{
2018 struct i2c_client *client = i2c_verify_client(dev);
2019 struct i2c_cmd_arg *arg = _arg;
Lars-Peter Clausen0acc2b32013-09-29 10:51:06 +02002020 struct i2c_driver *driver;
David Brownell9b766b82008-01-27 18:14:51 +01002021
Lars-Peter Clausen0acc2b32013-09-29 10:51:06 +02002022 if (!client || !client->dev.driver)
2023 return 0;
2024
2025 driver = to_i2c_driver(client->dev.driver);
2026 if (driver->command)
2027 driver->command(client, arg->cmd, arg->arg);
David Brownell9b766b82008-01-27 18:14:51 +01002028 return 0;
2029}
2030
Linus Torvalds1da177e2005-04-16 15:20:36 -07002031void i2c_clients_command(struct i2c_adapter *adap, unsigned int cmd, void *arg)
2032{
David Brownell9b766b82008-01-27 18:14:51 +01002033 struct i2c_cmd_arg cmd_arg;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002034
David Brownell9b766b82008-01-27 18:14:51 +01002035 cmd_arg.cmd = cmd;
2036 cmd_arg.arg = arg;
2037 device_for_each_child(&adap->dev, &cmd_arg, i2c_cmd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002038}
David Brownellc0564602007-05-01 23:26:31 +02002039EXPORT_SYMBOL(i2c_clients_command);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002040
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02002041#if IS_ENABLED(CONFIG_OF_DYNAMIC)
2042static int of_i2c_notify(struct notifier_block *nb, unsigned long action,
2043 void *arg)
2044{
2045 struct of_reconfig_data *rd = arg;
2046 struct i2c_adapter *adap;
2047 struct i2c_client *client;
2048
2049 switch (of_reconfig_get_state_change(action, rd)) {
2050 case OF_RECONFIG_CHANGE_ADD:
2051 adap = of_find_i2c_adapter_by_node(rd->dn->parent);
2052 if (adap == NULL)
2053 return NOTIFY_OK; /* not for us */
2054
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02002055 if (of_node_test_and_set_flag(rd->dn, OF_POPULATED)) {
2056 put_device(&adap->dev);
2057 return NOTIFY_OK;
2058 }
2059
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02002060 client = of_i2c_register_device(adap, rd->dn);
2061 put_device(&adap->dev);
2062
2063 if (IS_ERR(client)) {
2064 pr_err("%s: failed to create for '%s'\n",
2065 __func__, rd->dn->full_name);
2066 return notifier_from_errno(PTR_ERR(client));
2067 }
2068 break;
2069 case OF_RECONFIG_CHANGE_REMOVE:
Pantelis Antoniou4f001fd2015-01-24 09:16:29 +02002070 /* already depopulated? */
2071 if (!of_node_check_flag(rd->dn, OF_POPULATED))
2072 return NOTIFY_OK;
2073
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02002074 /* find our device by node */
2075 client = of_find_i2c_device_by_node(rd->dn);
2076 if (client == NULL)
2077 return NOTIFY_OK; /* no? not meant for us */
2078
2079 /* unregister takes one ref away */
2080 i2c_unregister_device(client);
2081
2082 /* and put the reference of the find */
2083 put_device(&client->dev);
2084 break;
2085 }
2086
2087 return NOTIFY_OK;
2088}
2089static struct notifier_block i2c_of_notifier = {
2090 .notifier_call = of_i2c_notify,
2091};
2092#else
2093extern struct notifier_block i2c_of_notifier;
2094#endif /* CONFIG_OF_DYNAMIC */
2095
Linus Torvalds1da177e2005-04-16 15:20:36 -07002096static int __init i2c_init(void)
2097{
2098 int retval;
2099
Wolfram Sang03bde7c2015-03-12 17:17:59 +01002100 retval = of_alias_get_highest_id("i2c");
2101
2102 down_write(&__i2c_board_lock);
2103 if (retval >= __i2c_first_dynamic_bus_num)
2104 __i2c_first_dynamic_bus_num = retval + 1;
2105 up_write(&__i2c_board_lock);
2106
Linus Torvalds1da177e2005-04-16 15:20:36 -07002107 retval = bus_register(&i2c_bus_type);
2108 if (retval)
2109 return retval;
Wolfram Sangb980a262016-03-14 10:41:52 +01002110
2111 is_registered = true;
2112
Jean Delvare2bb50952009-09-18 22:45:46 +02002113#ifdef CONFIG_I2C_COMPAT
2114 i2c_adapter_compat_class = class_compat_register("i2c-adapter");
2115 if (!i2c_adapter_compat_class) {
2116 retval = -ENOMEM;
2117 goto bus_err;
2118 }
2119#endif
David Brownelle9f13732008-01-27 18:14:52 +01002120 retval = i2c_add_driver(&dummy_driver);
2121 if (retval)
Jean Delvare2bb50952009-09-18 22:45:46 +02002122 goto class_err;
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02002123
2124 if (IS_ENABLED(CONFIG_OF_DYNAMIC))
2125 WARN_ON(of_reconfig_notifier_register(&i2c_of_notifier));
2126
David Brownelle9f13732008-01-27 18:14:52 +01002127 return 0;
2128
Jean Delvare2bb50952009-09-18 22:45:46 +02002129class_err:
2130#ifdef CONFIG_I2C_COMPAT
2131 class_compat_unregister(i2c_adapter_compat_class);
David Brownelle9f13732008-01-27 18:14:52 +01002132bus_err:
Jean Delvare2bb50952009-09-18 22:45:46 +02002133#endif
Wolfram Sangb980a262016-03-14 10:41:52 +01002134 is_registered = false;
David Brownelle9f13732008-01-27 18:14:52 +01002135 bus_unregister(&i2c_bus_type);
2136 return retval;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002137}
2138
2139static void __exit i2c_exit(void)
2140{
Pantelis Antoniouea7513b2014-10-28 22:36:03 +02002141 if (IS_ENABLED(CONFIG_OF_DYNAMIC))
2142 WARN_ON(of_reconfig_notifier_unregister(&i2c_of_notifier));
David Brownelle9f13732008-01-27 18:14:52 +01002143 i2c_del_driver(&dummy_driver);
Jean Delvare2bb50952009-09-18 22:45:46 +02002144#ifdef CONFIG_I2C_COMPAT
2145 class_compat_unregister(i2c_adapter_compat_class);
2146#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -07002147 bus_unregister(&i2c_bus_type);
David Howellsd9a83d62014-03-06 13:35:59 +00002148 tracepoint_synchronize_unregister();
Linus Torvalds1da177e2005-04-16 15:20:36 -07002149}
2150
David Brownella10f9e72008-10-14 17:30:06 +02002151/* We must initialize early, because some subsystems register i2c drivers
2152 * in subsys_initcall() code, but are linked (and initialized) before i2c.
2153 */
2154postcore_initcall(i2c_init);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002155module_exit(i2c_exit);
2156
2157/* ----------------------------------------------------
2158 * the functional interface to the i2c busses.
2159 * ----------------------------------------------------
2160 */
2161
Wolfram Sangb7f62582015-01-05 23:45:59 +01002162/* Check if val is exceeding the quirk IFF quirk is non 0 */
2163#define i2c_quirk_exceeded(val, quirk) ((quirk) && ((val) > (quirk)))
2164
2165static int i2c_quirk_error(struct i2c_adapter *adap, struct i2c_msg *msg, char *err_msg)
2166{
2167 dev_err_ratelimited(&adap->dev, "adapter quirk: %s (addr 0x%04x, size %u, %s)\n",
2168 err_msg, msg->addr, msg->len,
2169 msg->flags & I2C_M_RD ? "read" : "write");
2170 return -EOPNOTSUPP;
2171}
2172
2173static int i2c_check_for_quirks(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
2174{
2175 const struct i2c_adapter_quirks *q = adap->quirks;
2176 int max_num = q->max_num_msgs, i;
2177 bool do_len_check = true;
2178
2179 if (q->flags & I2C_AQ_COMB) {
2180 max_num = 2;
2181
2182 /* special checks for combined messages */
2183 if (num == 2) {
2184 if (q->flags & I2C_AQ_COMB_WRITE_FIRST && msgs[0].flags & I2C_M_RD)
2185 return i2c_quirk_error(adap, &msgs[0], "1st comb msg must be write");
2186
2187 if (q->flags & I2C_AQ_COMB_READ_SECOND && !(msgs[1].flags & I2C_M_RD))
2188 return i2c_quirk_error(adap, &msgs[1], "2nd comb msg must be read");
2189
2190 if (q->flags & I2C_AQ_COMB_SAME_ADDR && msgs[0].addr != msgs[1].addr)
2191 return i2c_quirk_error(adap, &msgs[0], "comb msg only to same addr");
2192
2193 if (i2c_quirk_exceeded(msgs[0].len, q->max_comb_1st_msg_len))
2194 return i2c_quirk_error(adap, &msgs[0], "msg too long");
2195
2196 if (i2c_quirk_exceeded(msgs[1].len, q->max_comb_2nd_msg_len))
2197 return i2c_quirk_error(adap, &msgs[1], "msg too long");
2198
2199 do_len_check = false;
2200 }
2201 }
2202
2203 if (i2c_quirk_exceeded(num, max_num))
2204 return i2c_quirk_error(adap, &msgs[0], "too many messages");
2205
2206 for (i = 0; i < num; i++) {
2207 u16 len = msgs[i].len;
2208
2209 if (msgs[i].flags & I2C_M_RD) {
2210 if (do_len_check && i2c_quirk_exceeded(len, q->max_read_len))
2211 return i2c_quirk_error(adap, &msgs[i], "msg too long");
2212 } else {
2213 if (do_len_check && i2c_quirk_exceeded(len, q->max_write_len))
2214 return i2c_quirk_error(adap, &msgs[i], "msg too long");
2215 }
2216 }
2217
2218 return 0;
2219}
2220
David Brownella1cdeda2008-07-14 22:38:24 +02002221/**
Jean Delvareb37d2a32012-06-29 07:47:19 -03002222 * __i2c_transfer - unlocked flavor of i2c_transfer
2223 * @adap: Handle to I2C bus
2224 * @msgs: One or more messages to execute before STOP is issued to
2225 * terminate the operation; each message begins with a START.
2226 * @num: Number of messages to be executed.
2227 *
2228 * Returns negative errno, else the number of messages executed.
2229 *
2230 * Adapter lock must be held when calling this function. No debug logging
2231 * takes place. adap->algo->master_xfer existence isn't checked.
2232 */
2233int __i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
2234{
2235 unsigned long orig_jiffies;
2236 int ret, try;
2237
Wolfram Sangb7f62582015-01-05 23:45:59 +01002238 if (adap->quirks && i2c_check_for_quirks(adap, msgs, num))
2239 return -EOPNOTSUPP;
2240
David Howellsd9a83d62014-03-06 13:35:59 +00002241 /* i2c_trace_msg gets enabled when tracepoint i2c_transfer gets
2242 * enabled. This is an efficient way of keeping the for-loop from
2243 * being executed when not needed.
2244 */
2245 if (static_key_false(&i2c_trace_msg)) {
2246 int i;
2247 for (i = 0; i < num; i++)
2248 if (msgs[i].flags & I2C_M_RD)
2249 trace_i2c_read(adap, &msgs[i], i);
2250 else
2251 trace_i2c_write(adap, &msgs[i], i);
2252 }
2253
Jean Delvareb37d2a32012-06-29 07:47:19 -03002254 /* Retry automatically on arbitration loss */
2255 orig_jiffies = jiffies;
2256 for (ret = 0, try = 0; try <= adap->retries; try++) {
2257 ret = adap->algo->master_xfer(adap, msgs, num);
2258 if (ret != -EAGAIN)
2259 break;
2260 if (time_after(jiffies, orig_jiffies + adap->timeout))
2261 break;
2262 }
2263
David Howellsd9a83d62014-03-06 13:35:59 +00002264 if (static_key_false(&i2c_trace_msg)) {
2265 int i;
2266 for (i = 0; i < ret; i++)
2267 if (msgs[i].flags & I2C_M_RD)
2268 trace_i2c_reply(adap, &msgs[i], i);
2269 trace_i2c_result(adap, i, ret);
2270 }
2271
Jean Delvareb37d2a32012-06-29 07:47:19 -03002272 return ret;
2273}
2274EXPORT_SYMBOL(__i2c_transfer);
2275
2276/**
David Brownella1cdeda2008-07-14 22:38:24 +02002277 * i2c_transfer - execute a single or combined I2C message
2278 * @adap: Handle to I2C bus
2279 * @msgs: One or more messages to execute before STOP is issued to
2280 * terminate the operation; each message begins with a START.
2281 * @num: Number of messages to be executed.
2282 *
2283 * Returns negative errno, else the number of messages executed.
2284 *
2285 * Note that there is no requirement that each message be sent to
2286 * the same slave address, although that is the most common model.
2287 */
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01002288int i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002289{
Jean Delvareb37d2a32012-06-29 07:47:19 -03002290 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002291
David Brownella1cdeda2008-07-14 22:38:24 +02002292 /* REVISIT the fault reporting model here is weak:
2293 *
2294 * - When we get an error after receiving N bytes from a slave,
2295 * there is no way to report "N".
2296 *
2297 * - When we get a NAK after transmitting N bytes to a slave,
2298 * there is no way to report "N" ... or to let the master
2299 * continue executing the rest of this combined message, if
2300 * that's the appropriate response.
2301 *
2302 * - When for example "num" is two and we successfully complete
2303 * the first message but get an error part way through the
2304 * second, it's unclear whether that should be reported as
2305 * one (discarding status on the second message) or errno
2306 * (discarding status on the first one).
2307 */
2308
Linus Torvalds1da177e2005-04-16 15:20:36 -07002309 if (adap->algo->master_xfer) {
2310#ifdef DEBUG
2311 for (ret = 0; ret < num; ret++) {
2312 dev_dbg(&adap->dev, "master_xfer[%d] %c, addr=0x%02x, "
Jean Delvare209d27c2007-05-01 23:26:29 +02002313 "len=%d%s\n", ret, (msgs[ret].flags & I2C_M_RD)
2314 ? 'R' : 'W', msgs[ret].addr, msgs[ret].len,
2315 (msgs[ret].flags & I2C_M_RECV_LEN) ? "+" : "");
Linus Torvalds1da177e2005-04-16 15:20:36 -07002316 }
2317#endif
2318
Mike Rapoportcea443a2008-01-27 18:14:50 +01002319 if (in_atomic() || irqs_disabled()) {
Peter Rosin8320f492016-05-04 22:15:27 +02002320 ret = adap->trylock_bus(adap, I2C_LOCK_SEGMENT);
Mike Rapoportcea443a2008-01-27 18:14:50 +01002321 if (!ret)
2322 /* I2C activity is ongoing. */
2323 return -EAGAIN;
2324 } else {
Peter Rosin8320f492016-05-04 22:15:27 +02002325 i2c_lock_bus(adap, I2C_LOCK_SEGMENT);
Mike Rapoportcea443a2008-01-27 18:14:50 +01002326 }
2327
Jean Delvareb37d2a32012-06-29 07:47:19 -03002328 ret = __i2c_transfer(adap, msgs, num);
Peter Rosin8320f492016-05-04 22:15:27 +02002329 i2c_unlock_bus(adap, I2C_LOCK_SEGMENT);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002330
2331 return ret;
2332 } else {
2333 dev_dbg(&adap->dev, "I2C level transfers not supported\n");
David Brownell24a5bb72008-07-14 22:38:23 +02002334 return -EOPNOTSUPP;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002335 }
2336}
David Brownellc0564602007-05-01 23:26:31 +02002337EXPORT_SYMBOL(i2c_transfer);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002338
David Brownella1cdeda2008-07-14 22:38:24 +02002339/**
2340 * i2c_master_send - issue a single I2C message in master transmit mode
2341 * @client: Handle to slave device
2342 * @buf: Data that will be written to the slave
Zhangfei Gao0c43ea52010-03-02 12:23:49 +01002343 * @count: How many bytes to write, must be less than 64k since msg.len is u16
David Brownella1cdeda2008-07-14 22:38:24 +02002344 *
2345 * Returns negative errno, or else the number of bytes written.
2346 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002347int i2c_master_send(const struct i2c_client *client, const char *buf, int count)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002348{
2349 int ret;
Farid Hammane7225acf2010-05-21 18:40:58 +02002350 struct i2c_adapter *adap = client->adapter;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002351 struct i2c_msg msg;
2352
Jean Delvare815f55f2005-05-07 22:58:46 +02002353 msg.addr = client->addr;
2354 msg.flags = client->flags & I2C_M_TEN;
2355 msg.len = count;
2356 msg.buf = (char *)buf;
David Brownell438d6c22006-12-10 21:21:31 +01002357
Jean Delvare815f55f2005-05-07 22:58:46 +02002358 ret = i2c_transfer(adap, &msg, 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002359
Wolfram Sang834aa6f2012-03-15 18:11:05 +01002360 /*
2361 * If everything went ok (i.e. 1 msg transmitted), return #bytes
2362 * transmitted, else error code.
2363 */
Jean Delvare815f55f2005-05-07 22:58:46 +02002364 return (ret == 1) ? count : ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002365}
David Brownellc0564602007-05-01 23:26:31 +02002366EXPORT_SYMBOL(i2c_master_send);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002367
David Brownella1cdeda2008-07-14 22:38:24 +02002368/**
2369 * i2c_master_recv - issue a single I2C message in master receive mode
2370 * @client: Handle to slave device
2371 * @buf: Where to store data read from slave
Zhangfei Gao0c43ea52010-03-02 12:23:49 +01002372 * @count: How many bytes to read, must be less than 64k since msg.len is u16
David Brownella1cdeda2008-07-14 22:38:24 +02002373 *
2374 * Returns negative errno, or else the number of bytes read.
2375 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002376int i2c_master_recv(const struct i2c_client *client, char *buf, int count)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002377{
Farid Hammane7225acf2010-05-21 18:40:58 +02002378 struct i2c_adapter *adap = client->adapter;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002379 struct i2c_msg msg;
2380 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002381
Jean Delvare815f55f2005-05-07 22:58:46 +02002382 msg.addr = client->addr;
2383 msg.flags = client->flags & I2C_M_TEN;
2384 msg.flags |= I2C_M_RD;
2385 msg.len = count;
2386 msg.buf = buf;
2387
2388 ret = i2c_transfer(adap, &msg, 1);
2389
Wolfram Sang834aa6f2012-03-15 18:11:05 +01002390 /*
2391 * If everything went ok (i.e. 1 msg received), return #bytes received,
2392 * else error code.
2393 */
Jean Delvare815f55f2005-05-07 22:58:46 +02002394 return (ret == 1) ? count : ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002395}
David Brownellc0564602007-05-01 23:26:31 +02002396EXPORT_SYMBOL(i2c_master_recv);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002397
Linus Torvalds1da177e2005-04-16 15:20:36 -07002398/* ----------------------------------------------------
2399 * the i2c address scanning function
2400 * Will not work for 10-bit addresses!
2401 * ----------------------------------------------------
2402 */
Jean Delvare9fc6adf2005-07-31 21:20:43 +02002403
Jean Delvare63e4e802010-06-03 11:33:51 +02002404/*
2405 * Legacy default probe function, mostly relevant for SMBus. The default
2406 * probe method is a quick write, but it is known to corrupt the 24RF08
2407 * EEPROMs due to a state machine bug, and could also irreversibly
2408 * write-protect some EEPROMs, so for address ranges 0x30-0x37 and 0x50-0x5f,
2409 * we use a short byte read instead. Also, some bus drivers don't implement
2410 * quick write, so we fallback to a byte read in that case too.
2411 * On x86, there is another special case for FSC hardware monitoring chips,
2412 * which want regular byte reads (address 0x73.) Fortunately, these are the
2413 * only known chips using this I2C address on PC hardware.
2414 * Returns 1 if probe succeeded, 0 if not.
2415 */
2416static int i2c_default_probe(struct i2c_adapter *adap, unsigned short addr)
2417{
2418 int err;
2419 union i2c_smbus_data dummy;
2420
2421#ifdef CONFIG_X86
2422 if (addr == 0x73 && (adap->class & I2C_CLASS_HWMON)
2423 && i2c_check_functionality(adap, I2C_FUNC_SMBUS_READ_BYTE_DATA))
2424 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2425 I2C_SMBUS_BYTE_DATA, &dummy);
2426 else
2427#endif
Jean Delvare8031d792010-08-11 18:21:00 +02002428 if (!((addr & ~0x07) == 0x30 || (addr & ~0x0f) == 0x50)
2429 && i2c_check_functionality(adap, I2C_FUNC_SMBUS_QUICK))
Jean Delvare63e4e802010-06-03 11:33:51 +02002430 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_WRITE, 0,
2431 I2C_SMBUS_QUICK, NULL);
Jean Delvare8031d792010-08-11 18:21:00 +02002432 else if (i2c_check_functionality(adap, I2C_FUNC_SMBUS_READ_BYTE))
2433 err = i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2434 I2C_SMBUS_BYTE, &dummy);
2435 else {
Andy Lutomirskid63a9e82013-07-17 13:27:59 -07002436 dev_warn(&adap->dev, "No suitable probing method supported for address 0x%02X\n",
2437 addr);
Jean Delvare8031d792010-08-11 18:21:00 +02002438 err = -EOPNOTSUPP;
2439 }
Jean Delvare63e4e802010-06-03 11:33:51 +02002440
2441 return err >= 0;
2442}
2443
Jean Delvareccfbbd02009-12-06 17:06:25 +01002444static int i2c_detect_address(struct i2c_client *temp_client,
Jean Delvare4735c982008-07-14 22:38:36 +02002445 struct i2c_driver *driver)
2446{
2447 struct i2c_board_info info;
2448 struct i2c_adapter *adapter = temp_client->adapter;
2449 int addr = temp_client->addr;
2450 int err;
2451
2452 /* Make sure the address is valid */
Wolfram Sang66be60562015-07-17 12:43:22 +02002453 err = i2c_check_7bit_addr_validity_strict(addr);
Jean Delvare656b8762010-06-03 11:33:53 +02002454 if (err) {
Jean Delvare4735c982008-07-14 22:38:36 +02002455 dev_warn(&adapter->dev, "Invalid probe address 0x%02x\n",
2456 addr);
Jean Delvare656b8762010-06-03 11:33:53 +02002457 return err;
Jean Delvare4735c982008-07-14 22:38:36 +02002458 }
2459
Wolfram Sang9bccc702015-07-17 14:48:56 +02002460 /* Skip if already in use (7 bit, no need to encode flags) */
Jean Delvare3b5f7942010-06-03 11:33:55 +02002461 if (i2c_check_addr_busy(adapter, addr))
Jean Delvare4735c982008-07-14 22:38:36 +02002462 return 0;
2463
Jean Delvareccfbbd02009-12-06 17:06:25 +01002464 /* Make sure there is something at this address */
Jean Delvare63e4e802010-06-03 11:33:51 +02002465 if (!i2c_default_probe(adapter, addr))
2466 return 0;
Jean Delvare4735c982008-07-14 22:38:36 +02002467
2468 /* Finally call the custom detection function */
2469 memset(&info, 0, sizeof(struct i2c_board_info));
2470 info.addr = addr;
Jean Delvare310ec792009-12-14 21:17:23 +01002471 err = driver->detect(temp_client, &info);
Jean Delvare4735c982008-07-14 22:38:36 +02002472 if (err) {
2473 /* -ENODEV is returned if the detection fails. We catch it
2474 here as this isn't an error. */
2475 return err == -ENODEV ? 0 : err;
2476 }
2477
2478 /* Consistency check */
2479 if (info.type[0] == '\0') {
2480 dev_err(&adapter->dev, "%s detection function provided "
2481 "no name for 0x%x\n", driver->driver.name,
2482 addr);
2483 } else {
2484 struct i2c_client *client;
2485
2486 /* Detection succeeded, instantiate the device */
Wolfram Sang0c176172014-02-10 11:03:56 +01002487 if (adapter->class & I2C_CLASS_DEPRECATED)
2488 dev_warn(&adapter->dev,
2489 "This adapter will soon drop class based instantiation of devices. "
2490 "Please make sure client 0x%02x gets instantiated by other means. "
2491 "Check 'Documentation/i2c/instantiating-devices' for details.\n",
2492 info.addr);
2493
Jean Delvare4735c982008-07-14 22:38:36 +02002494 dev_dbg(&adapter->dev, "Creating %s at 0x%02x\n",
2495 info.type, info.addr);
2496 client = i2c_new_device(adapter, &info);
2497 if (client)
2498 list_add_tail(&client->detected, &driver->clients);
2499 else
2500 dev_err(&adapter->dev, "Failed creating %s at 0x%02x\n",
2501 info.type, info.addr);
2502 }
2503 return 0;
2504}
2505
2506static int i2c_detect(struct i2c_adapter *adapter, struct i2c_driver *driver)
2507{
Jean Delvarec3813d62009-12-14 21:17:25 +01002508 const unsigned short *address_list;
Jean Delvare4735c982008-07-14 22:38:36 +02002509 struct i2c_client *temp_client;
2510 int i, err = 0;
2511 int adap_id = i2c_adapter_id(adapter);
2512
Jean Delvarec3813d62009-12-14 21:17:25 +01002513 address_list = driver->address_list;
2514 if (!driver->detect || !address_list)
Jean Delvare4735c982008-07-14 22:38:36 +02002515 return 0;
2516
Wolfram Sang45552272014-07-10 13:46:21 +02002517 /* Warn that the adapter lost class based instantiation */
2518 if (adapter->class == I2C_CLASS_DEPRECATED) {
2519 dev_dbg(&adapter->dev,
2520 "This adapter dropped support for I2C classes and "
2521 "won't auto-detect %s devices anymore. If you need it, check "
2522 "'Documentation/i2c/instantiating-devices' for alternatives.\n",
2523 driver->driver.name);
2524 return 0;
2525 }
2526
Jean Delvare51b54ba2010-10-24 18:16:58 +02002527 /* Stop here if the classes do not match */
2528 if (!(adapter->class & driver->class))
2529 return 0;
2530
Jean Delvare4735c982008-07-14 22:38:36 +02002531 /* Set up a temporary client to help detect callback */
2532 temp_client = kzalloc(sizeof(struct i2c_client), GFP_KERNEL);
2533 if (!temp_client)
2534 return -ENOMEM;
2535 temp_client->adapter = adapter;
2536
Jean Delvarec3813d62009-12-14 21:17:25 +01002537 for (i = 0; address_list[i] != I2C_CLIENT_END; i += 1) {
Jean Delvare4735c982008-07-14 22:38:36 +02002538 dev_dbg(&adapter->dev, "found normal entry for adapter %d, "
Jean Delvarec3813d62009-12-14 21:17:25 +01002539 "addr 0x%02x\n", adap_id, address_list[i]);
2540 temp_client->addr = address_list[i];
Jean Delvareccfbbd02009-12-06 17:06:25 +01002541 err = i2c_detect_address(temp_client, driver);
Jean Delvare51b54ba2010-10-24 18:16:58 +02002542 if (unlikely(err))
2543 break;
Jean Delvare4735c982008-07-14 22:38:36 +02002544 }
2545
Jean Delvare4735c982008-07-14 22:38:36 +02002546 kfree(temp_client);
2547 return err;
2548}
2549
Jean Delvared44f19d2010-08-11 18:20:57 +02002550int i2c_probe_func_quick_read(struct i2c_adapter *adap, unsigned short addr)
2551{
2552 return i2c_smbus_xfer(adap, addr, 0, I2C_SMBUS_READ, 0,
2553 I2C_SMBUS_QUICK, NULL) >= 0;
2554}
2555EXPORT_SYMBOL_GPL(i2c_probe_func_quick_read);
2556
Jean Delvare12b5053a2007-05-01 23:26:31 +02002557struct i2c_client *
2558i2c_new_probed_device(struct i2c_adapter *adap,
2559 struct i2c_board_info *info,
Jean Delvare9a942412010-08-11 18:20:56 +02002560 unsigned short const *addr_list,
2561 int (*probe)(struct i2c_adapter *, unsigned short addr))
Jean Delvare12b5053a2007-05-01 23:26:31 +02002562{
2563 int i;
2564
Jean Delvare8031d792010-08-11 18:21:00 +02002565 if (!probe)
Jean Delvare9a942412010-08-11 18:20:56 +02002566 probe = i2c_default_probe;
Jean Delvare12b5053a2007-05-01 23:26:31 +02002567
Jean Delvare12b5053a2007-05-01 23:26:31 +02002568 for (i = 0; addr_list[i] != I2C_CLIENT_END; i++) {
2569 /* Check address validity */
Wolfram Sang66be60562015-07-17 12:43:22 +02002570 if (i2c_check_7bit_addr_validity_strict(addr_list[i]) < 0) {
Jean Delvare12b5053a2007-05-01 23:26:31 +02002571 dev_warn(&adap->dev, "Invalid 7-bit address "
2572 "0x%02x\n", addr_list[i]);
2573 continue;
2574 }
2575
Wolfram Sang9bccc702015-07-17 14:48:56 +02002576 /* Check address availability (7 bit, no need to encode flags) */
Jean Delvare3b5f7942010-06-03 11:33:55 +02002577 if (i2c_check_addr_busy(adap, addr_list[i])) {
Jean Delvare12b5053a2007-05-01 23:26:31 +02002578 dev_dbg(&adap->dev, "Address 0x%02x already in "
2579 "use, not probing\n", addr_list[i]);
2580 continue;
2581 }
2582
Jean Delvare63e4e802010-06-03 11:33:51 +02002583 /* Test address responsiveness */
Jean Delvare9a942412010-08-11 18:20:56 +02002584 if (probe(adap, addr_list[i]))
Jean Delvare63e4e802010-06-03 11:33:51 +02002585 break;
Jean Delvare12b5053a2007-05-01 23:26:31 +02002586 }
Jean Delvare12b5053a2007-05-01 23:26:31 +02002587
2588 if (addr_list[i] == I2C_CLIENT_END) {
2589 dev_dbg(&adap->dev, "Probing failed, no device found\n");
2590 return NULL;
2591 }
2592
2593 info->addr = addr_list[i];
2594 return i2c_new_device(adap, info);
2595}
2596EXPORT_SYMBOL_GPL(i2c_new_probed_device);
2597
Jean Delvared735b342011-03-20 14:50:52 +01002598struct i2c_adapter *i2c_get_adapter(int nr)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002599{
Linus Torvalds1da177e2005-04-16 15:20:36 -07002600 struct i2c_adapter *adapter;
David Brownell438d6c22006-12-10 21:21:31 +01002601
Jean Delvarecaada322008-01-27 18:14:49 +01002602 mutex_lock(&core_lock);
Jean Delvared735b342011-03-20 14:50:52 +01002603 adapter = idr_find(&i2c_adapter_idr, nr);
Vladimir Zapolskiy611e12e2015-07-27 17:30:49 +03002604 if (!adapter)
2605 goto exit;
2606
2607 if (try_module_get(adapter->owner))
2608 get_device(&adapter->dev);
2609 else
Mark M. Hoffmana0920e12005-06-28 00:21:30 -04002610 adapter = NULL;
2611
Vladimir Zapolskiy611e12e2015-07-27 17:30:49 +03002612 exit:
Jean Delvarecaada322008-01-27 18:14:49 +01002613 mutex_unlock(&core_lock);
Mark M. Hoffmana0920e12005-06-28 00:21:30 -04002614 return adapter;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002615}
David Brownellc0564602007-05-01 23:26:31 +02002616EXPORT_SYMBOL(i2c_get_adapter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002617
2618void i2c_put_adapter(struct i2c_adapter *adap)
2619{
Vladimir Zapolskiy611e12e2015-07-27 17:30:49 +03002620 if (!adap)
2621 return;
2622
2623 put_device(&adap->dev);
2624 module_put(adap->owner);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002625}
David Brownellc0564602007-05-01 23:26:31 +02002626EXPORT_SYMBOL(i2c_put_adapter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002627
2628/* The SMBus parts */
2629
David Brownell438d6c22006-12-10 21:21:31 +01002630#define POLY (0x1070U << 3)
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01002631static u8 crc8(u16 data)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002632{
2633 int i;
David Brownell438d6c22006-12-10 21:21:31 +01002634
Farid Hammane7225acf2010-05-21 18:40:58 +02002635 for (i = 0; i < 8; i++) {
David Brownell438d6c22006-12-10 21:21:31 +01002636 if (data & 0x8000)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002637 data = data ^ POLY;
2638 data = data << 1;
2639 }
2640 return (u8)(data >> 8);
2641}
2642
Jean Delvare421ef472005-10-26 21:28:55 +02002643/* Incremental CRC8 over count bytes in the array pointed to by p */
2644static u8 i2c_smbus_pec(u8 crc, u8 *p, size_t count)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002645{
2646 int i;
2647
Farid Hammane7225acf2010-05-21 18:40:58 +02002648 for (i = 0; i < count; i++)
Jean Delvare421ef472005-10-26 21:28:55 +02002649 crc = crc8((crc ^ p[i]) << 8);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002650 return crc;
2651}
2652
Jean Delvare421ef472005-10-26 21:28:55 +02002653/* Assume a 7-bit address, which is reasonable for SMBus */
2654static u8 i2c_smbus_msg_pec(u8 pec, struct i2c_msg *msg)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002655{
Jean Delvare421ef472005-10-26 21:28:55 +02002656 /* The address will be sent first */
Wolfram Sang041edda2016-04-03 20:44:46 +02002657 u8 addr = i2c_8bit_addr_from_msg(msg);
Jean Delvare421ef472005-10-26 21:28:55 +02002658 pec = i2c_smbus_pec(pec, &addr, 1);
2659
2660 /* The data buffer follows */
2661 return i2c_smbus_pec(pec, msg->buf, msg->len);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002662}
2663
Jean Delvare421ef472005-10-26 21:28:55 +02002664/* Used for write only transactions */
2665static inline void i2c_smbus_add_pec(struct i2c_msg *msg)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002666{
Jean Delvare421ef472005-10-26 21:28:55 +02002667 msg->buf[msg->len] = i2c_smbus_msg_pec(0, msg);
2668 msg->len++;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002669}
2670
Jean Delvare421ef472005-10-26 21:28:55 +02002671/* Return <0 on CRC error
2672 If there was a write before this read (most cases) we need to take the
2673 partial CRC from the write part into account.
2674 Note that this function does modify the message (we need to decrease the
2675 message length to hide the CRC byte from the caller). */
2676static int i2c_smbus_check_pec(u8 cpec, struct i2c_msg *msg)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002677{
Jean Delvare421ef472005-10-26 21:28:55 +02002678 u8 rpec = msg->buf[--msg->len];
2679 cpec = i2c_smbus_msg_pec(cpec, msg);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002680
Linus Torvalds1da177e2005-04-16 15:20:36 -07002681 if (rpec != cpec) {
2682 pr_debug("i2c-core: Bad PEC 0x%02x vs. 0x%02x\n",
2683 rpec, cpec);
David Brownell24a5bb72008-07-14 22:38:23 +02002684 return -EBADMSG;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002685 }
David Brownell438d6c22006-12-10 21:21:31 +01002686 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002687}
2688
David Brownella1cdeda2008-07-14 22:38:24 +02002689/**
2690 * i2c_smbus_read_byte - SMBus "receive byte" protocol
2691 * @client: Handle to slave device
2692 *
2693 * This executes the SMBus "receive byte" protocol, returning negative errno
2694 * else the byte received from the device.
2695 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002696s32 i2c_smbus_read_byte(const struct i2c_client *client)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002697{
2698 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002699 int status;
2700
2701 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2702 I2C_SMBUS_READ, 0,
2703 I2C_SMBUS_BYTE, &data);
2704 return (status < 0) ? status : data.byte;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002705}
David Brownellc0564602007-05-01 23:26:31 +02002706EXPORT_SYMBOL(i2c_smbus_read_byte);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002707
David Brownella1cdeda2008-07-14 22:38:24 +02002708/**
2709 * i2c_smbus_write_byte - SMBus "send byte" protocol
2710 * @client: Handle to slave device
2711 * @value: Byte to be sent
2712 *
2713 * This executes the SMBus "send byte" protocol, returning negative errno
2714 * else zero on success.
2715 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002716s32 i2c_smbus_write_byte(const struct i2c_client *client, u8 value)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002717{
Farid Hammane7225acf2010-05-21 18:40:58 +02002718 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
Jean Delvare421ef472005-10-26 21:28:55 +02002719 I2C_SMBUS_WRITE, value, I2C_SMBUS_BYTE, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002720}
David Brownellc0564602007-05-01 23:26:31 +02002721EXPORT_SYMBOL(i2c_smbus_write_byte);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002722
David Brownella1cdeda2008-07-14 22:38:24 +02002723/**
2724 * i2c_smbus_read_byte_data - SMBus "read byte" protocol
2725 * @client: Handle to slave device
2726 * @command: Byte interpreted by slave
2727 *
2728 * This executes the SMBus "read byte" protocol, returning negative errno
2729 * else a data byte received from the device.
2730 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002731s32 i2c_smbus_read_byte_data(const struct i2c_client *client, u8 command)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002732{
2733 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002734 int status;
2735
2736 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2737 I2C_SMBUS_READ, command,
2738 I2C_SMBUS_BYTE_DATA, &data);
2739 return (status < 0) ? status : data.byte;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002740}
David Brownellc0564602007-05-01 23:26:31 +02002741EXPORT_SYMBOL(i2c_smbus_read_byte_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002742
David Brownella1cdeda2008-07-14 22:38:24 +02002743/**
2744 * i2c_smbus_write_byte_data - SMBus "write byte" protocol
2745 * @client: Handle to slave device
2746 * @command: Byte interpreted by slave
2747 * @value: Byte being written
2748 *
2749 * This executes the SMBus "write byte" protocol, returning negative errno
2750 * else zero on success.
2751 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002752s32 i2c_smbus_write_byte_data(const struct i2c_client *client, u8 command,
2753 u8 value)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002754{
2755 union i2c_smbus_data data;
2756 data.byte = value;
Farid Hammane7225acf2010-05-21 18:40:58 +02002757 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2758 I2C_SMBUS_WRITE, command,
2759 I2C_SMBUS_BYTE_DATA, &data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002760}
David Brownellc0564602007-05-01 23:26:31 +02002761EXPORT_SYMBOL(i2c_smbus_write_byte_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002762
David Brownella1cdeda2008-07-14 22:38:24 +02002763/**
2764 * i2c_smbus_read_word_data - SMBus "read word" protocol
2765 * @client: Handle to slave device
2766 * @command: Byte interpreted by slave
2767 *
2768 * This executes the SMBus "read word" protocol, returning negative errno
2769 * else a 16-bit unsigned "word" received from the device.
2770 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002771s32 i2c_smbus_read_word_data(const struct i2c_client *client, u8 command)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002772{
2773 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002774 int status;
2775
2776 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2777 I2C_SMBUS_READ, command,
2778 I2C_SMBUS_WORD_DATA, &data);
2779 return (status < 0) ? status : data.word;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002780}
David Brownellc0564602007-05-01 23:26:31 +02002781EXPORT_SYMBOL(i2c_smbus_read_word_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002782
David Brownella1cdeda2008-07-14 22:38:24 +02002783/**
2784 * i2c_smbus_write_word_data - SMBus "write word" protocol
2785 * @client: Handle to slave device
2786 * @command: Byte interpreted by slave
2787 * @value: 16-bit "word" being written
2788 *
2789 * This executes the SMBus "write word" protocol, returning negative errno
2790 * else zero on success.
2791 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002792s32 i2c_smbus_write_word_data(const struct i2c_client *client, u8 command,
2793 u16 value)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002794{
2795 union i2c_smbus_data data;
2796 data.word = value;
Farid Hammane7225acf2010-05-21 18:40:58 +02002797 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2798 I2C_SMBUS_WRITE, command,
2799 I2C_SMBUS_WORD_DATA, &data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002800}
David Brownellc0564602007-05-01 23:26:31 +02002801EXPORT_SYMBOL(i2c_smbus_write_word_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002802
David Brownella64ec072007-10-13 23:56:31 +02002803/**
David Brownella1cdeda2008-07-14 22:38:24 +02002804 * i2c_smbus_read_block_data - SMBus "block read" protocol
David Brownella64ec072007-10-13 23:56:31 +02002805 * @client: Handle to slave device
David Brownella1cdeda2008-07-14 22:38:24 +02002806 * @command: Byte interpreted by slave
David Brownella64ec072007-10-13 23:56:31 +02002807 * @values: Byte array into which data will be read; big enough to hold
2808 * the data returned by the slave. SMBus allows at most 32 bytes.
2809 *
David Brownella1cdeda2008-07-14 22:38:24 +02002810 * This executes the SMBus "block read" protocol, returning negative errno
2811 * else the number of data bytes in the slave's response.
David Brownella64ec072007-10-13 23:56:31 +02002812 *
2813 * Note that using this function requires that the client's adapter support
2814 * the I2C_FUNC_SMBUS_READ_BLOCK_DATA functionality. Not all adapter drivers
2815 * support this; its emulation through I2C messaging relies on a specific
2816 * mechanism (I2C_M_RECV_LEN) which may not be implemented.
2817 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002818s32 i2c_smbus_read_block_data(const struct i2c_client *client, u8 command,
Jean Delvareb86a1bc2007-05-01 23:26:34 +02002819 u8 *values)
2820{
2821 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002822 int status;
Jean Delvareb86a1bc2007-05-01 23:26:34 +02002823
David Brownell24a5bb72008-07-14 22:38:23 +02002824 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2825 I2C_SMBUS_READ, command,
2826 I2C_SMBUS_BLOCK_DATA, &data);
2827 if (status)
2828 return status;
Jean Delvareb86a1bc2007-05-01 23:26:34 +02002829
2830 memcpy(values, &data.block[1], data.block[0]);
2831 return data.block[0];
2832}
2833EXPORT_SYMBOL(i2c_smbus_read_block_data);
2834
David Brownella1cdeda2008-07-14 22:38:24 +02002835/**
2836 * i2c_smbus_write_block_data - SMBus "block write" protocol
2837 * @client: Handle to slave device
2838 * @command: Byte interpreted by slave
2839 * @length: Size of data block; SMBus allows at most 32 bytes
2840 * @values: Byte array which will be written.
2841 *
2842 * This executes the SMBus "block write" protocol, returning negative errno
2843 * else zero on success.
2844 */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002845s32 i2c_smbus_write_block_data(const struct i2c_client *client, u8 command,
Krzysztof Halasa46f5ed72006-06-12 21:42:20 +02002846 u8 length, const u8 *values)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002847{
2848 union i2c_smbus_data data;
Jean Delvare76560322006-01-18 23:14:55 +01002849
Linus Torvalds1da177e2005-04-16 15:20:36 -07002850 if (length > I2C_SMBUS_BLOCK_MAX)
2851 length = I2C_SMBUS_BLOCK_MAX;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002852 data.block[0] = length;
Jean Delvare76560322006-01-18 23:14:55 +01002853 memcpy(&data.block[1], values, length);
Farid Hammane7225acf2010-05-21 18:40:58 +02002854 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2855 I2C_SMBUS_WRITE, command,
2856 I2C_SMBUS_BLOCK_DATA, &data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002857}
David Brownellc0564602007-05-01 23:26:31 +02002858EXPORT_SYMBOL(i2c_smbus_write_block_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002859
2860/* Returns the number of read bytes */
Jean Delvare0cc43a12011-01-10 22:11:23 +01002861s32 i2c_smbus_read_i2c_block_data(const struct i2c_client *client, u8 command,
Jean Delvare4b2643d2007-07-12 14:12:29 +02002862 u8 length, u8 *values)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002863{
2864 union i2c_smbus_data data;
David Brownell24a5bb72008-07-14 22:38:23 +02002865 int status;
Jean Delvare76560322006-01-18 23:14:55 +01002866
Jean Delvare4b2643d2007-07-12 14:12:29 +02002867 if (length > I2C_SMBUS_BLOCK_MAX)
2868 length = I2C_SMBUS_BLOCK_MAX;
2869 data.block[0] = length;
David Brownell24a5bb72008-07-14 22:38:23 +02002870 status = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2871 I2C_SMBUS_READ, command,
2872 I2C_SMBUS_I2C_BLOCK_DATA, &data);
2873 if (status < 0)
2874 return status;
Jean Delvare76560322006-01-18 23:14:55 +01002875
2876 memcpy(values, &data.block[1], data.block[0]);
2877 return data.block[0];
Linus Torvalds1da177e2005-04-16 15:20:36 -07002878}
David Brownellc0564602007-05-01 23:26:31 +02002879EXPORT_SYMBOL(i2c_smbus_read_i2c_block_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002880
Jean Delvare0cc43a12011-01-10 22:11:23 +01002881s32 i2c_smbus_write_i2c_block_data(const struct i2c_client *client, u8 command,
Krzysztof Halasa46f5ed72006-06-12 21:42:20 +02002882 u8 length, const u8 *values)
Jean Delvare21bbd692006-01-09 15:19:18 +11002883{
2884 union i2c_smbus_data data;
2885
2886 if (length > I2C_SMBUS_BLOCK_MAX)
2887 length = I2C_SMBUS_BLOCK_MAX;
2888 data.block[0] = length;
2889 memcpy(data.block + 1, values, length);
2890 return i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2891 I2C_SMBUS_WRITE, command,
2892 I2C_SMBUS_I2C_BLOCK_DATA, &data);
2893}
David Brownellc0564602007-05-01 23:26:31 +02002894EXPORT_SYMBOL(i2c_smbus_write_i2c_block_data);
Jean Delvare21bbd692006-01-09 15:19:18 +11002895
David Brownell438d6c22006-12-10 21:21:31 +01002896/* Simulate a SMBus command using the i2c protocol
Linus Torvalds1da177e2005-04-16 15:20:36 -07002897 No checking of parameters is done! */
Farid Hammane7225acf2010-05-21 18:40:58 +02002898static s32 i2c_smbus_xfer_emulated(struct i2c_adapter *adapter, u16 addr,
2899 unsigned short flags,
2900 char read_write, u8 command, int size,
2901 union i2c_smbus_data *data)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002902{
2903 /* So we need to generate a series of msgs. In the case of writing, we
2904 need to use only one message; when reading, we need two. We initialize
2905 most things with sane defaults, to keep the code below somewhat
2906 simpler. */
Hideki Iwamoto5c50d182005-09-25 17:01:11 +02002907 unsigned char msgbuf0[I2C_SMBUS_BLOCK_MAX+3];
2908 unsigned char msgbuf1[I2C_SMBUS_BLOCK_MAX+2];
Farid Hammane7225acf2010-05-21 18:40:58 +02002909 int num = read_write == I2C_SMBUS_READ ? 2 : 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002910 int i;
Jean Delvare421ef472005-10-26 21:28:55 +02002911 u8 partial_pec = 0;
David Brownell24a5bb72008-07-14 22:38:23 +02002912 int status;
Shubhrajyoti D230da092012-10-05 22:23:52 +02002913 struct i2c_msg msg[2] = {
2914 {
2915 .addr = addr,
2916 .flags = flags,
2917 .len = 1,
2918 .buf = msgbuf0,
2919 }, {
2920 .addr = addr,
2921 .flags = flags | I2C_M_RD,
2922 .len = 0,
2923 .buf = msgbuf1,
2924 },
2925 };
Linus Torvalds1da177e2005-04-16 15:20:36 -07002926
2927 msgbuf0[0] = command;
Farid Hammane7225acf2010-05-21 18:40:58 +02002928 switch (size) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002929 case I2C_SMBUS_QUICK:
2930 msg[0].len = 0;
2931 /* Special case: The read/write field is used as data */
Roel Kluinf29d2e02009-02-24 19:19:48 +01002932 msg[0].flags = flags | (read_write == I2C_SMBUS_READ ?
2933 I2C_M_RD : 0);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002934 num = 1;
2935 break;
2936 case I2C_SMBUS_BYTE:
2937 if (read_write == I2C_SMBUS_READ) {
2938 /* Special case: only a read! */
2939 msg[0].flags = I2C_M_RD | flags;
2940 num = 1;
2941 }
2942 break;
2943 case I2C_SMBUS_BYTE_DATA:
2944 if (read_write == I2C_SMBUS_READ)
2945 msg[1].len = 1;
2946 else {
2947 msg[0].len = 2;
2948 msgbuf0[1] = data->byte;
2949 }
2950 break;
2951 case I2C_SMBUS_WORD_DATA:
2952 if (read_write == I2C_SMBUS_READ)
2953 msg[1].len = 2;
2954 else {
Farid Hammane7225acf2010-05-21 18:40:58 +02002955 msg[0].len = 3;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002956 msgbuf0[1] = data->word & 0xff;
Jean Delvare7eff82c2006-09-03 22:24:00 +02002957 msgbuf0[2] = data->word >> 8;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002958 }
2959 break;
2960 case I2C_SMBUS_PROC_CALL:
2961 num = 2; /* Special case */
2962 read_write = I2C_SMBUS_READ;
2963 msg[0].len = 3;
2964 msg[1].len = 2;
2965 msgbuf0[1] = data->word & 0xff;
Jean Delvare7eff82c2006-09-03 22:24:00 +02002966 msgbuf0[2] = data->word >> 8;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002967 break;
2968 case I2C_SMBUS_BLOCK_DATA:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002969 if (read_write == I2C_SMBUS_READ) {
Jean Delvare209d27c2007-05-01 23:26:29 +02002970 msg[1].flags |= I2C_M_RECV_LEN;
2971 msg[1].len = 1; /* block length will be added by
2972 the underlying bus driver */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002973 } else {
2974 msg[0].len = data->block[0] + 2;
2975 if (msg[0].len > I2C_SMBUS_BLOCK_MAX + 2) {
David Brownell24a5bb72008-07-14 22:38:23 +02002976 dev_err(&adapter->dev,
2977 "Invalid block write size %d\n",
2978 data->block[0]);
2979 return -EINVAL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002980 }
Hideki Iwamoto5c50d182005-09-25 17:01:11 +02002981 for (i = 1; i < msg[0].len; i++)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002982 msgbuf0[i] = data->block[i-1];
2983 }
2984 break;
2985 case I2C_SMBUS_BLOCK_PROC_CALL:
Jean Delvare209d27c2007-05-01 23:26:29 +02002986 num = 2; /* Another special case */
2987 read_write = I2C_SMBUS_READ;
2988 if (data->block[0] > I2C_SMBUS_BLOCK_MAX) {
David Brownell24a5bb72008-07-14 22:38:23 +02002989 dev_err(&adapter->dev,
2990 "Invalid block write size %d\n",
Jean Delvare209d27c2007-05-01 23:26:29 +02002991 data->block[0]);
David Brownell24a5bb72008-07-14 22:38:23 +02002992 return -EINVAL;
Jean Delvare209d27c2007-05-01 23:26:29 +02002993 }
2994 msg[0].len = data->block[0] + 2;
2995 for (i = 1; i < msg[0].len; i++)
2996 msgbuf0[i] = data->block[i-1];
2997 msg[1].flags |= I2C_M_RECV_LEN;
2998 msg[1].len = 1; /* block length will be added by
2999 the underlying bus driver */
3000 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003001 case I2C_SMBUS_I2C_BLOCK_DATA:
3002 if (read_write == I2C_SMBUS_READ) {
Jean Delvare4b2643d2007-07-12 14:12:29 +02003003 msg[1].len = data->block[0];
Linus Torvalds1da177e2005-04-16 15:20:36 -07003004 } else {
3005 msg[0].len = data->block[0] + 1;
Jean Delvare30dac742005-10-08 00:15:59 +02003006 if (msg[0].len > I2C_SMBUS_BLOCK_MAX + 1) {
David Brownell24a5bb72008-07-14 22:38:23 +02003007 dev_err(&adapter->dev,
3008 "Invalid block write size %d\n",
3009 data->block[0]);
3010 return -EINVAL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003011 }
3012 for (i = 1; i <= data->block[0]; i++)
3013 msgbuf0[i] = data->block[i];
3014 }
3015 break;
3016 default:
David Brownell24a5bb72008-07-14 22:38:23 +02003017 dev_err(&adapter->dev, "Unsupported transaction %d\n", size);
3018 return -EOPNOTSUPP;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003019 }
3020
Jean Delvare421ef472005-10-26 21:28:55 +02003021 i = ((flags & I2C_CLIENT_PEC) && size != I2C_SMBUS_QUICK
3022 && size != I2C_SMBUS_I2C_BLOCK_DATA);
3023 if (i) {
3024 /* Compute PEC if first message is a write */
3025 if (!(msg[0].flags & I2C_M_RD)) {
David Brownell438d6c22006-12-10 21:21:31 +01003026 if (num == 1) /* Write only */
Jean Delvare421ef472005-10-26 21:28:55 +02003027 i2c_smbus_add_pec(&msg[0]);
3028 else /* Write followed by read */
3029 partial_pec = i2c_smbus_msg_pec(0, &msg[0]);
3030 }
3031 /* Ask for PEC if last message is a read */
3032 if (msg[num-1].flags & I2C_M_RD)
David Brownell438d6c22006-12-10 21:21:31 +01003033 msg[num-1].len++;
Jean Delvare421ef472005-10-26 21:28:55 +02003034 }
3035
David Brownell24a5bb72008-07-14 22:38:23 +02003036 status = i2c_transfer(adapter, msg, num);
3037 if (status < 0)
3038 return status;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003039
Jean Delvare421ef472005-10-26 21:28:55 +02003040 /* Check PEC if last message is a read */
3041 if (i && (msg[num-1].flags & I2C_M_RD)) {
David Brownell24a5bb72008-07-14 22:38:23 +02003042 status = i2c_smbus_check_pec(partial_pec, &msg[num-1]);
3043 if (status < 0)
3044 return status;
Jean Delvare421ef472005-10-26 21:28:55 +02003045 }
3046
Linus Torvalds1da177e2005-04-16 15:20:36 -07003047 if (read_write == I2C_SMBUS_READ)
Farid Hammane7225acf2010-05-21 18:40:58 +02003048 switch (size) {
3049 case I2C_SMBUS_BYTE:
3050 data->byte = msgbuf0[0];
3051 break;
3052 case I2C_SMBUS_BYTE_DATA:
3053 data->byte = msgbuf1[0];
3054 break;
3055 case I2C_SMBUS_WORD_DATA:
3056 case I2C_SMBUS_PROC_CALL:
3057 data->word = msgbuf1[0] | (msgbuf1[1] << 8);
3058 break;
3059 case I2C_SMBUS_I2C_BLOCK_DATA:
3060 for (i = 0; i < data->block[0]; i++)
3061 data->block[i+1] = msgbuf1[i];
3062 break;
3063 case I2C_SMBUS_BLOCK_DATA:
3064 case I2C_SMBUS_BLOCK_PROC_CALL:
3065 for (i = 0; i < msgbuf1[0] + 1; i++)
3066 data->block[i] = msgbuf1[i];
3067 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003068 }
3069 return 0;
3070}
3071
David Brownella1cdeda2008-07-14 22:38:24 +02003072/**
3073 * i2c_smbus_xfer - execute SMBus protocol operations
3074 * @adapter: Handle to I2C bus
3075 * @addr: Address of SMBus slave on that bus
3076 * @flags: I2C_CLIENT_* flags (usually zero or I2C_CLIENT_PEC)
3077 * @read_write: I2C_SMBUS_READ or I2C_SMBUS_WRITE
3078 * @command: Byte interpreted by slave, for protocols which use such bytes
3079 * @protocol: SMBus protocol operation to execute, such as I2C_SMBUS_PROC_CALL
3080 * @data: Data to be read or written
3081 *
3082 * This executes an SMBus protocol operation, and returns a negative
3083 * errno code else zero on success.
3084 */
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01003085s32 i2c_smbus_xfer(struct i2c_adapter *adapter, u16 addr, unsigned short flags,
David Brownella1cdeda2008-07-14 22:38:24 +02003086 char read_write, u8 command, int protocol,
Zhenwen Xu09b8ce02009-03-28 21:34:46 +01003087 union i2c_smbus_data *data)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003088{
Clifford Wolf66b650f2009-06-15 18:01:46 +02003089 unsigned long orig_jiffies;
3090 int try;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003091 s32 res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003092
David Howells8a325992014-03-06 13:36:06 +00003093 /* If enabled, the following two tracepoints are conditional on
3094 * read_write and protocol.
3095 */
3096 trace_smbus_write(adapter, addr, flags, read_write,
3097 command, protocol, data);
3098 trace_smbus_read(adapter, addr, flags, read_write,
3099 command, protocol);
3100
Laurent Pinchartd47726c2012-07-24 14:13:59 +02003101 flags &= I2C_M_TEN | I2C_CLIENT_PEC | I2C_CLIENT_SCCB;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003102
3103 if (adapter->algo->smbus_xfer) {
Peter Rosin8320f492016-05-04 22:15:27 +02003104 i2c_lock_bus(adapter, I2C_LOCK_SEGMENT);
Clifford Wolf66b650f2009-06-15 18:01:46 +02003105
3106 /* Retry automatically on arbitration loss */
3107 orig_jiffies = jiffies;
3108 for (res = 0, try = 0; try <= adapter->retries; try++) {
3109 res = adapter->algo->smbus_xfer(adapter, addr, flags,
3110 read_write, command,
3111 protocol, data);
3112 if (res != -EAGAIN)
3113 break;
3114 if (time_after(jiffies,
3115 orig_jiffies + adapter->timeout))
3116 break;
3117 }
Peter Rosin8320f492016-05-04 22:15:27 +02003118 i2c_unlock_bus(adapter, I2C_LOCK_SEGMENT);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003119
Laurent Pinchart72fc2c72012-07-24 14:13:59 +02003120 if (res != -EOPNOTSUPP || !adapter->algo->master_xfer)
David Howells8a325992014-03-06 13:36:06 +00003121 goto trace;
Laurent Pinchart72fc2c72012-07-24 14:13:59 +02003122 /*
3123 * Fall back to i2c_smbus_xfer_emulated if the adapter doesn't
3124 * implement native support for the SMBus operation.
3125 */
3126 }
3127
David Howells8a325992014-03-06 13:36:06 +00003128 res = i2c_smbus_xfer_emulated(adapter, addr, flags, read_write,
3129 command, protocol, data);
3130
3131trace:
3132 /* If enabled, the reply tracepoint is conditional on read_write. */
3133 trace_smbus_reply(adapter, addr, flags, read_write,
3134 command, protocol, data);
3135 trace_smbus_result(adapter, addr, flags, read_write,
3136 command, protocol, res);
3137
3138 return res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003139}
Linus Torvalds1da177e2005-04-16 15:20:36 -07003140EXPORT_SYMBOL(i2c_smbus_xfer);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003141
Irina Tirdea01eef962015-08-12 17:31:33 +03003142/**
3143 * i2c_smbus_read_i2c_block_data_or_emulated - read block or emulate
3144 * @client: Handle to slave device
3145 * @command: Byte interpreted by slave
3146 * @length: Size of data block; SMBus allows at most I2C_SMBUS_BLOCK_MAX bytes
3147 * @values: Byte array into which data will be read; big enough to hold
3148 * the data returned by the slave. SMBus allows at most
3149 * I2C_SMBUS_BLOCK_MAX bytes.
3150 *
3151 * This executes the SMBus "block read" protocol if supported by the adapter.
3152 * If block read is not supported, it emulates it using either word or byte
3153 * read protocols depending on availability.
3154 *
3155 * The addresses of the I2C slave device that are accessed with this function
3156 * must be mapped to a linear region, so that a block read will have the same
3157 * effect as a byte read. Before using this function you must double-check
3158 * if the I2C slave does support exchanging a block transfer with a byte
3159 * transfer.
3160 */
3161s32 i2c_smbus_read_i2c_block_data_or_emulated(const struct i2c_client *client,
3162 u8 command, u8 length, u8 *values)
3163{
3164 u8 i = 0;
3165 int status;
3166
3167 if (length > I2C_SMBUS_BLOCK_MAX)
3168 length = I2C_SMBUS_BLOCK_MAX;
3169
3170 if (i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_READ_I2C_BLOCK))
3171 return i2c_smbus_read_i2c_block_data(client, command, length, values);
3172
3173 if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_READ_BYTE_DATA))
3174 return -EOPNOTSUPP;
3175
3176 if (i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_READ_WORD_DATA)) {
3177 while ((i + 2) <= length) {
3178 status = i2c_smbus_read_word_data(client, command + i);
3179 if (status < 0)
3180 return status;
3181 values[i] = status & 0xff;
3182 values[i + 1] = status >> 8;
3183 i += 2;
3184 }
3185 }
3186
3187 while (i < length) {
3188 status = i2c_smbus_read_byte_data(client, command + i);
3189 if (status < 0)
3190 return status;
3191 values[i] = status;
3192 i++;
3193 }
3194
3195 return i;
3196}
3197EXPORT_SYMBOL(i2c_smbus_read_i2c_block_data_or_emulated);
3198
Jean Delvared5fd1202015-01-26 20:59:31 +01003199#if IS_ENABLED(CONFIG_I2C_SLAVE)
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003200int i2c_slave_register(struct i2c_client *client, i2c_slave_cb_t slave_cb)
3201{
3202 int ret;
3203
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003204 if (!client || !slave_cb) {
3205 WARN(1, "insufficent data\n");
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003206 return -EINVAL;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003207 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003208
Wolfram Sangc6909d62015-08-05 21:12:54 +02003209 if (!(client->flags & I2C_CLIENT_SLAVE))
3210 dev_warn(&client->dev, "%s: client slave flag not set. You might see address collisions\n",
3211 __func__);
3212
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003213 if (!(client->flags & I2C_CLIENT_TEN)) {
3214 /* Enforce stricter address checking */
Wolfram Sang66be60562015-07-17 12:43:22 +02003215 ret = i2c_check_7bit_addr_validity_strict(client->addr);
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003216 if (ret) {
3217 dev_err(&client->dev, "%s: invalid address\n", __func__);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003218 return ret;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003219 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003220 }
3221
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003222 if (!client->adapter->algo->reg_slave) {
3223 dev_err(&client->dev, "%s: not supported by adapter\n", __func__);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003224 return -EOPNOTSUPP;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003225 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003226
3227 client->slave_cb = slave_cb;
3228
3229 i2c_lock_adapter(client->adapter);
3230 ret = client->adapter->algo->reg_slave(client);
3231 i2c_unlock_adapter(client->adapter);
3232
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003233 if (ret) {
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003234 client->slave_cb = NULL;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003235 dev_err(&client->dev, "%s: adapter returned error %d\n", __func__, ret);
3236 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003237
3238 return ret;
3239}
3240EXPORT_SYMBOL_GPL(i2c_slave_register);
3241
3242int i2c_slave_unregister(struct i2c_client *client)
3243{
3244 int ret;
3245
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003246 if (!client->adapter->algo->unreg_slave) {
3247 dev_err(&client->dev, "%s: not supported by adapter\n", __func__);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003248 return -EOPNOTSUPP;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003249 }
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003250
3251 i2c_lock_adapter(client->adapter);
3252 ret = client->adapter->algo->unreg_slave(client);
3253 i2c_unlock_adapter(client->adapter);
3254
3255 if (ret == 0)
3256 client->slave_cb = NULL;
Wolfram Sang0c7cab92015-05-14 14:40:05 +02003257 else
3258 dev_err(&client->dev, "%s: adapter returned error %d\n", __func__, ret);
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003259
3260 return ret;
3261}
3262EXPORT_SYMBOL_GPL(i2c_slave_unregister);
Jean Delvared5fd1202015-01-26 20:59:31 +01003263#endif
Wolfram Sang4b1acc42014-11-18 17:04:53 +01003264
Linus Torvalds1da177e2005-04-16 15:20:36 -07003265MODULE_AUTHOR("Simon G. Vogl <simon@tk.uni-linz.ac.at>");
3266MODULE_DESCRIPTION("I2C-Bus main module");
3267MODULE_LICENSE("GPL");