i2c-tiny-usb.c 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * driver for the i2c-tiny-usb adapter - 1.0
  4. * http://www.harbaum.org/till/i2c_tiny_usb
  5. *
  6. * Copyright (C) 2006-2007 Till Harbaum ([email protected])
  7. */
  8. #include <linux/kernel.h>
  9. #include <linux/errno.h>
  10. #include <linux/module.h>
  11. #include <linux/slab.h>
  12. #include <linux/types.h>
  13. /* include interfaces to usb layer */
  14. #include <linux/usb.h>
  15. /* include interface to i2c layer */
  16. #include <linux/i2c.h>
  17. /* commands via USB, must match command ids in the firmware */
  18. #define CMD_ECHO 0
  19. #define CMD_GET_FUNC 1
  20. #define CMD_SET_DELAY 2
  21. #define CMD_GET_STATUS 3
  22. #define CMD_I2C_IO 4
  23. #define CMD_I2C_IO_BEGIN (1<<0)
  24. #define CMD_I2C_IO_END (1<<1)
  25. /* i2c bit delay, default is 10us -> 100kHz max
  26. (in practice, due to additional delays in the i2c bitbanging
  27. code this results in a i2c clock of about 50kHz) */
  28. static unsigned short delay = 10;
  29. module_param(delay, ushort, 0);
  30. MODULE_PARM_DESC(delay, "bit delay in microseconds "
  31. "(default is 10us for 100kHz max)");
  32. static int usb_read(struct i2c_adapter *adapter, int cmd,
  33. int value, int index, void *data, int len);
  34. static int usb_write(struct i2c_adapter *adapter, int cmd,
  35. int value, int index, void *data, int len);
  36. /* ----- begin of i2c layer ---------------------------------------------- */
  37. #define STATUS_IDLE 0
  38. #define STATUS_ADDRESS_ACK 1
  39. #define STATUS_ADDRESS_NAK 2
  40. static int usb_xfer(struct i2c_adapter *adapter, struct i2c_msg *msgs, int num)
  41. {
  42. unsigned char *pstatus;
  43. struct i2c_msg *pmsg;
  44. int i, ret;
  45. dev_dbg(&adapter->dev, "master xfer %d messages:\n", num);
  46. pstatus = kmalloc(sizeof(*pstatus), GFP_KERNEL);
  47. if (!pstatus)
  48. return -ENOMEM;
  49. for (i = 0 ; i < num ; i++) {
  50. int cmd = CMD_I2C_IO;
  51. if (i == 0)
  52. cmd |= CMD_I2C_IO_BEGIN;
  53. if (i == num-1)
  54. cmd |= CMD_I2C_IO_END;
  55. pmsg = &msgs[i];
  56. dev_dbg(&adapter->dev,
  57. " %d: %s (flags %d) %d bytes to 0x%02x\n",
  58. i, pmsg->flags & I2C_M_RD ? "read" : "write",
  59. pmsg->flags, pmsg->len, pmsg->addr);
  60. /* and directly send the message */
  61. if (pmsg->flags & I2C_M_RD) {
  62. /* read data */
  63. if (usb_read(adapter, cmd,
  64. pmsg->flags, pmsg->addr,
  65. pmsg->buf, pmsg->len) != pmsg->len) {
  66. dev_err(&adapter->dev,
  67. "failure reading data\n");
  68. ret = -EIO;
  69. goto out;
  70. }
  71. } else {
  72. /* write data */
  73. if (usb_write(adapter, cmd,
  74. pmsg->flags, pmsg->addr,
  75. pmsg->buf, pmsg->len) != pmsg->len) {
  76. dev_err(&adapter->dev,
  77. "failure writing data\n");
  78. ret = -EIO;
  79. goto out;
  80. }
  81. }
  82. /* read status */
  83. if (usb_read(adapter, CMD_GET_STATUS, 0, 0, pstatus, 1) != 1) {
  84. dev_err(&adapter->dev, "failure reading status\n");
  85. ret = -EIO;
  86. goto out;
  87. }
  88. dev_dbg(&adapter->dev, " status = %d\n", *pstatus);
  89. if (*pstatus == STATUS_ADDRESS_NAK) {
  90. ret = -ENXIO;
  91. goto out;
  92. }
  93. }
  94. ret = i;
  95. out:
  96. kfree(pstatus);
  97. return ret;
  98. }
  99. static u32 usb_func(struct i2c_adapter *adapter)
  100. {
  101. __le32 *pfunc;
  102. u32 ret;
  103. pfunc = kmalloc(sizeof(*pfunc), GFP_KERNEL);
  104. /* get functionality from adapter */
  105. if (!pfunc || usb_read(adapter, CMD_GET_FUNC, 0, 0, pfunc,
  106. sizeof(*pfunc)) != sizeof(*pfunc)) {
  107. dev_err(&adapter->dev, "failure reading functionality\n");
  108. ret = 0;
  109. goto out;
  110. }
  111. ret = le32_to_cpup(pfunc);
  112. out:
  113. kfree(pfunc);
  114. return ret;
  115. }
  116. /* This is the actual algorithm we define */
  117. static const struct i2c_algorithm usb_algorithm = {
  118. .master_xfer = usb_xfer,
  119. .functionality = usb_func,
  120. };
  121. /* ----- end of i2c layer ------------------------------------------------ */
  122. /* ----- begin of usb layer ---------------------------------------------- */
  123. /*
  124. * Initially the usb i2c interface uses a vid/pid pair donated by
  125. * Future Technology Devices International Ltd., later a pair was
  126. * bought from EZPrototypes
  127. */
  128. static const struct usb_device_id i2c_tiny_usb_table[] = {
  129. { USB_DEVICE(0x0403, 0xc631) }, /* FTDI */
  130. { USB_DEVICE(0x1c40, 0x0534) }, /* EZPrototypes */
  131. { } /* Terminating entry */
  132. };
  133. MODULE_DEVICE_TABLE(usb, i2c_tiny_usb_table);
  134. /* Structure to hold all of our device specific stuff */
  135. struct i2c_tiny_usb {
  136. struct usb_device *usb_dev; /* the usb device for this device */
  137. struct usb_interface *interface; /* the interface for this device */
  138. struct i2c_adapter adapter; /* i2c related things */
  139. };
  140. static int usb_read(struct i2c_adapter *adapter, int cmd,
  141. int value, int index, void *data, int len)
  142. {
  143. struct i2c_tiny_usb *dev = (struct i2c_tiny_usb *)adapter->algo_data;
  144. void *dmadata = kmalloc(len, GFP_KERNEL);
  145. int ret;
  146. if (!dmadata)
  147. return -ENOMEM;
  148. /* do control transfer */
  149. ret = usb_control_msg(dev->usb_dev, usb_rcvctrlpipe(dev->usb_dev, 0),
  150. cmd, USB_TYPE_VENDOR | USB_RECIP_INTERFACE |
  151. USB_DIR_IN, value, index, dmadata, len, 2000);
  152. memcpy(data, dmadata, len);
  153. kfree(dmadata);
  154. return ret;
  155. }
  156. static int usb_write(struct i2c_adapter *adapter, int cmd,
  157. int value, int index, void *data, int len)
  158. {
  159. struct i2c_tiny_usb *dev = (struct i2c_tiny_usb *)adapter->algo_data;
  160. void *dmadata = kmemdup(data, len, GFP_KERNEL);
  161. int ret;
  162. if (!dmadata)
  163. return -ENOMEM;
  164. /* do control transfer */
  165. ret = usb_control_msg(dev->usb_dev, usb_sndctrlpipe(dev->usb_dev, 0),
  166. cmd, USB_TYPE_VENDOR | USB_RECIP_INTERFACE,
  167. value, index, dmadata, len, 2000);
  168. kfree(dmadata);
  169. return ret;
  170. }
  171. static void i2c_tiny_usb_free(struct i2c_tiny_usb *dev)
  172. {
  173. usb_put_dev(dev->usb_dev);
  174. kfree(dev);
  175. }
  176. static int i2c_tiny_usb_probe(struct usb_interface *interface,
  177. const struct usb_device_id *id)
  178. {
  179. struct i2c_tiny_usb *dev;
  180. int retval = -ENOMEM;
  181. u16 version;
  182. dev_dbg(&interface->dev, "probing usb device\n");
  183. /* allocate memory for our device state and initialize it */
  184. dev = kzalloc(sizeof(*dev), GFP_KERNEL);
  185. if (!dev)
  186. goto error;
  187. dev->usb_dev = usb_get_dev(interface_to_usbdev(interface));
  188. dev->interface = interface;
  189. /* save our data pointer in this interface device */
  190. usb_set_intfdata(interface, dev);
  191. version = le16_to_cpu(dev->usb_dev->descriptor.bcdDevice);
  192. dev_info(&interface->dev,
  193. "version %x.%02x found at bus %03d address %03d\n",
  194. version >> 8, version & 0xff,
  195. dev->usb_dev->bus->busnum, dev->usb_dev->devnum);
  196. /* setup i2c adapter description */
  197. dev->adapter.owner = THIS_MODULE;
  198. dev->adapter.class = I2C_CLASS_HWMON;
  199. dev->adapter.algo = &usb_algorithm;
  200. dev->adapter.algo_data = dev;
  201. snprintf(dev->adapter.name, sizeof(dev->adapter.name),
  202. "i2c-tiny-usb at bus %03d device %03d",
  203. dev->usb_dev->bus->busnum, dev->usb_dev->devnum);
  204. if (usb_write(&dev->adapter, CMD_SET_DELAY, delay, 0, NULL, 0) != 0) {
  205. dev_err(&dev->adapter.dev,
  206. "failure setting delay to %dus\n", delay);
  207. retval = -EIO;
  208. goto error;
  209. }
  210. dev->adapter.dev.parent = &dev->interface->dev;
  211. /* and finally attach to i2c layer */
  212. i2c_add_adapter(&dev->adapter);
  213. /* inform user about successful attachment to i2c layer */
  214. dev_info(&dev->adapter.dev, "connected i2c-tiny-usb device\n");
  215. return 0;
  216. error:
  217. if (dev)
  218. i2c_tiny_usb_free(dev);
  219. return retval;
  220. }
  221. static void i2c_tiny_usb_disconnect(struct usb_interface *interface)
  222. {
  223. struct i2c_tiny_usb *dev = usb_get_intfdata(interface);
  224. i2c_del_adapter(&dev->adapter);
  225. usb_set_intfdata(interface, NULL);
  226. i2c_tiny_usb_free(dev);
  227. dev_dbg(&interface->dev, "disconnected\n");
  228. }
  229. static struct usb_driver i2c_tiny_usb_driver = {
  230. .name = "i2c-tiny-usb",
  231. .probe = i2c_tiny_usb_probe,
  232. .disconnect = i2c_tiny_usb_disconnect,
  233. .id_table = i2c_tiny_usb_table,
  234. };
  235. module_usb_driver(i2c_tiny_usb_driver);
  236. /* ----- end of usb layer ------------------------------------------------ */
  237. MODULE_AUTHOR("Till Harbaum <[email protected]>");
  238. MODULE_DESCRIPTION("i2c-tiny-usb driver v1.0");
  239. MODULE_LICENSE("GPL");