hid-ft260.c 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * hid-ft260.c - FTDI FT260 USB HID to I2C host bridge
  4. *
  5. * Copyright (c) 2021, Michael Zaidman <[email protected]>
  6. *
  7. * Data Sheet:
  8. * https://www.ftdichip.com/Support/Documents/DataSheets/ICs/DS_FT260.pdf
  9. */
  10. #include "hid-ids.h"
  11. #include <linux/hidraw.h>
  12. #include <linux/i2c.h>
  13. #include <linux/module.h>
  14. #include <linux/usb.h>
  15. #ifdef DEBUG
  16. static int ft260_debug = 1;
  17. #else
  18. static int ft260_debug;
  19. #endif
  20. module_param_named(debug, ft260_debug, int, 0600);
  21. MODULE_PARM_DESC(debug, "Toggle FT260 debugging messages");
  22. #define ft260_dbg(format, arg...) \
  23. do { \
  24. if (ft260_debug) \
  25. pr_info("%s: " format, __func__, ##arg); \
  26. } while (0)
  27. #define FT260_REPORT_MAX_LENGTH (64)
  28. #define FT260_I2C_DATA_REPORT_ID(len) (FT260_I2C_REPORT_MIN + (len - 1) / 4)
  29. /*
  30. * The input report format assigns 62 bytes for the data payload, but ft260
  31. * returns 60 and 2 in two separate transactions. To minimize transfer time
  32. * in reading chunks mode, set the maximum read payload length to 60 bytes.
  33. */
  34. #define FT260_RD_DATA_MAX (60)
  35. #define FT260_WR_DATA_MAX (60)
  36. /*
  37. * Device interface configuration.
  38. * The FT260 has 2 interfaces that are controlled by DCNF0 and DCNF1 pins.
  39. * First implementes USB HID to I2C bridge function and
  40. * second - USB HID to UART bridge function.
  41. */
  42. enum {
  43. FT260_MODE_ALL = 0x00,
  44. FT260_MODE_I2C = 0x01,
  45. FT260_MODE_UART = 0x02,
  46. FT260_MODE_BOTH = 0x03,
  47. };
  48. /* Control pipe */
  49. enum {
  50. FT260_GET_RQST_TYPE = 0xA1,
  51. FT260_GET_REPORT = 0x01,
  52. FT260_SET_RQST_TYPE = 0x21,
  53. FT260_SET_REPORT = 0x09,
  54. FT260_FEATURE = 0x03,
  55. };
  56. /* Report IDs / Feature In */
  57. enum {
  58. FT260_CHIP_VERSION = 0xA0,
  59. FT260_SYSTEM_SETTINGS = 0xA1,
  60. FT260_I2C_STATUS = 0xC0,
  61. FT260_I2C_READ_REQ = 0xC2,
  62. FT260_I2C_REPORT_MIN = 0xD0,
  63. FT260_I2C_REPORT_MAX = 0xDE,
  64. FT260_GPIO = 0xB0,
  65. FT260_UART_INTERRUPT_STATUS = 0xB1,
  66. FT260_UART_STATUS = 0xE0,
  67. FT260_UART_RI_DCD_STATUS = 0xE1,
  68. FT260_UART_REPORT = 0xF0,
  69. };
  70. /* Feature Out */
  71. enum {
  72. FT260_SET_CLOCK = 0x01,
  73. FT260_SET_I2C_MODE = 0x02,
  74. FT260_SET_UART_MODE = 0x03,
  75. FT260_ENABLE_INTERRUPT = 0x05,
  76. FT260_SELECT_GPIO2_FUNC = 0x06,
  77. FT260_ENABLE_UART_DCD_RI = 0x07,
  78. FT260_SELECT_GPIOA_FUNC = 0x08,
  79. FT260_SELECT_GPIOG_FUNC = 0x09,
  80. FT260_SET_INTERRUPT_TRIGGER = 0x0A,
  81. FT260_SET_SUSPEND_OUT_POLAR = 0x0B,
  82. FT260_ENABLE_UART_RI_WAKEUP = 0x0C,
  83. FT260_SET_UART_RI_WAKEUP_CFG = 0x0D,
  84. FT260_SET_I2C_RESET = 0x20,
  85. FT260_SET_I2C_CLOCK_SPEED = 0x22,
  86. FT260_SET_UART_RESET = 0x40,
  87. FT260_SET_UART_CONFIG = 0x41,
  88. FT260_SET_UART_BAUD_RATE = 0x42,
  89. FT260_SET_UART_DATA_BIT = 0x43,
  90. FT260_SET_UART_PARITY = 0x44,
  91. FT260_SET_UART_STOP_BIT = 0x45,
  92. FT260_SET_UART_BREAKING = 0x46,
  93. FT260_SET_UART_XON_XOFF = 0x49,
  94. };
  95. /* Response codes in I2C status report */
  96. enum {
  97. FT260_I2C_STATUS_SUCCESS = 0x00,
  98. FT260_I2C_STATUS_CTRL_BUSY = 0x01,
  99. FT260_I2C_STATUS_ERROR = 0x02,
  100. FT260_I2C_STATUS_ADDR_NO_ACK = 0x04,
  101. FT260_I2C_STATUS_DATA_NO_ACK = 0x08,
  102. FT260_I2C_STATUS_ARBITR_LOST = 0x10,
  103. FT260_I2C_STATUS_CTRL_IDLE = 0x20,
  104. FT260_I2C_STATUS_BUS_BUSY = 0x40,
  105. };
  106. /* I2C Conditions flags */
  107. enum {
  108. FT260_FLAG_NONE = 0x00,
  109. FT260_FLAG_START = 0x02,
  110. FT260_FLAG_START_REPEATED = 0x03,
  111. FT260_FLAG_STOP = 0x04,
  112. FT260_FLAG_START_STOP = 0x06,
  113. FT260_FLAG_START_STOP_REPEATED = 0x07,
  114. };
  115. #define FT260_SET_REQUEST_VALUE(report_id) ((FT260_FEATURE << 8) | report_id)
  116. /* Feature In reports */
  117. struct ft260_get_chip_version_report {
  118. u8 report; /* FT260_CHIP_VERSION */
  119. u8 chip_code[4]; /* FTDI chip identification code */
  120. u8 reserved[8];
  121. } __packed;
  122. struct ft260_get_system_status_report {
  123. u8 report; /* FT260_SYSTEM_SETTINGS */
  124. u8 chip_mode; /* DCNF0 and DCNF1 status, bits 0-1 */
  125. u8 clock_ctl; /* 0 - 12MHz, 1 - 24MHz, 2 - 48MHz */
  126. u8 suspend_status; /* 0 - not suspended, 1 - suspended */
  127. u8 pwren_status; /* 0 - FT260 is not ready, 1 - ready */
  128. u8 i2c_enable; /* 0 - disabled, 1 - enabled */
  129. u8 uart_mode; /* 0 - OFF; 1 - RTS_CTS, 2 - DTR_DSR, */
  130. /* 3 - XON_XOFF, 4 - No flow control */
  131. u8 hid_over_i2c_en; /* 0 - disabled, 1 - enabled */
  132. u8 gpio2_function; /* 0 - GPIO, 1 - SUSPOUT, */
  133. /* 2 - PWREN, 4 - TX_LED */
  134. u8 gpioA_function; /* 0 - GPIO, 3 - TX_ACTIVE, 4 - TX_LED */
  135. u8 gpioG_function; /* 0 - GPIO, 2 - PWREN, */
  136. /* 5 - RX_LED, 6 - BCD_DET */
  137. u8 suspend_out_pol; /* 0 - active-high, 1 - active-low */
  138. u8 enable_wakeup_int; /* 0 - disabled, 1 - enabled */
  139. u8 intr_cond; /* Interrupt trigger conditions */
  140. u8 power_saving_en; /* 0 - disabled, 1 - enabled */
  141. u8 reserved[10];
  142. } __packed;
  143. struct ft260_get_i2c_status_report {
  144. u8 report; /* FT260_I2C_STATUS */
  145. u8 bus_status; /* I2C bus status */
  146. __le16 clock; /* I2C bus clock in range 60-3400 KHz */
  147. u8 reserved;
  148. } __packed;
  149. /* Feature Out reports */
  150. struct ft260_set_system_clock_report {
  151. u8 report; /* FT260_SYSTEM_SETTINGS */
  152. u8 request; /* FT260_SET_CLOCK */
  153. u8 clock_ctl; /* 0 - 12MHz, 1 - 24MHz, 2 - 48MHz */
  154. } __packed;
  155. struct ft260_set_i2c_mode_report {
  156. u8 report; /* FT260_SYSTEM_SETTINGS */
  157. u8 request; /* FT260_SET_I2C_MODE */
  158. u8 i2c_enable; /* 0 - disabled, 1 - enabled */
  159. } __packed;
  160. struct ft260_set_uart_mode_report {
  161. u8 report; /* FT260_SYSTEM_SETTINGS */
  162. u8 request; /* FT260_SET_UART_MODE */
  163. u8 uart_mode; /* 0 - OFF; 1 - RTS_CTS, 2 - DTR_DSR, */
  164. /* 3 - XON_XOFF, 4 - No flow control */
  165. } __packed;
  166. struct ft260_set_i2c_reset_report {
  167. u8 report; /* FT260_SYSTEM_SETTINGS */
  168. u8 request; /* FT260_SET_I2C_RESET */
  169. } __packed;
  170. struct ft260_set_i2c_speed_report {
  171. u8 report; /* FT260_SYSTEM_SETTINGS */
  172. u8 request; /* FT260_SET_I2C_CLOCK_SPEED */
  173. __le16 clock; /* I2C bus clock in range 60-3400 KHz */
  174. } __packed;
  175. /* Data transfer reports */
  176. struct ft260_i2c_write_request_report {
  177. u8 report; /* FT260_I2C_REPORT */
  178. u8 address; /* 7-bit I2C address */
  179. u8 flag; /* I2C transaction condition */
  180. u8 length; /* data payload length */
  181. u8 data[FT260_WR_DATA_MAX]; /* data payload */
  182. } __packed;
  183. struct ft260_i2c_read_request_report {
  184. u8 report; /* FT260_I2C_READ_REQ */
  185. u8 address; /* 7-bit I2C address */
  186. u8 flag; /* I2C transaction condition */
  187. __le16 length; /* data payload length */
  188. } __packed;
  189. struct ft260_i2c_input_report {
  190. u8 report; /* FT260_I2C_REPORT */
  191. u8 length; /* data payload length */
  192. u8 data[2]; /* data payload */
  193. } __packed;
  194. static const struct hid_device_id ft260_devices[] = {
  195. { HID_USB_DEVICE(USB_VENDOR_ID_FUTURE_TECHNOLOGY,
  196. USB_DEVICE_ID_FT260) },
  197. { /* END OF LIST */ }
  198. };
  199. MODULE_DEVICE_TABLE(hid, ft260_devices);
  200. struct ft260_device {
  201. struct i2c_adapter adap;
  202. struct hid_device *hdev;
  203. struct completion wait;
  204. struct mutex lock;
  205. u8 write_buf[FT260_REPORT_MAX_LENGTH];
  206. u8 *read_buf;
  207. u16 read_idx;
  208. u16 read_len;
  209. u16 clock;
  210. };
  211. static int ft260_hid_feature_report_get(struct hid_device *hdev,
  212. unsigned char report_id, u8 *data,
  213. size_t len)
  214. {
  215. u8 *buf;
  216. int ret;
  217. buf = kmalloc(len, GFP_KERNEL);
  218. if (!buf)
  219. return -ENOMEM;
  220. ret = hid_hw_raw_request(hdev, report_id, buf, len, HID_FEATURE_REPORT,
  221. HID_REQ_GET_REPORT);
  222. if (likely(ret == len))
  223. memcpy(data, buf, len);
  224. else if (ret >= 0)
  225. ret = -EIO;
  226. kfree(buf);
  227. return ret;
  228. }
  229. static int ft260_hid_feature_report_set(struct hid_device *hdev, u8 *data,
  230. size_t len)
  231. {
  232. u8 *buf;
  233. int ret;
  234. buf = kmemdup(data, len, GFP_KERNEL);
  235. if (!buf)
  236. return -ENOMEM;
  237. buf[0] = FT260_SYSTEM_SETTINGS;
  238. ret = hid_hw_raw_request(hdev, buf[0], buf, len, HID_FEATURE_REPORT,
  239. HID_REQ_SET_REPORT);
  240. kfree(buf);
  241. return ret;
  242. }
  243. static int ft260_i2c_reset(struct hid_device *hdev)
  244. {
  245. struct ft260_set_i2c_reset_report report;
  246. int ret;
  247. report.request = FT260_SET_I2C_RESET;
  248. ret = ft260_hid_feature_report_set(hdev, (u8 *)&report, sizeof(report));
  249. if (ret < 0) {
  250. hid_err(hdev, "failed to reset I2C controller: %d\n", ret);
  251. return ret;
  252. }
  253. ft260_dbg("done\n");
  254. return ret;
  255. }
  256. static int ft260_xfer_status(struct ft260_device *dev)
  257. {
  258. struct hid_device *hdev = dev->hdev;
  259. struct ft260_get_i2c_status_report report;
  260. int ret;
  261. ret = ft260_hid_feature_report_get(hdev, FT260_I2C_STATUS,
  262. (u8 *)&report, sizeof(report));
  263. if (unlikely(ret < 0)) {
  264. hid_err(hdev, "failed to retrieve status: %d\n", ret);
  265. return ret;
  266. }
  267. dev->clock = le16_to_cpu(report.clock);
  268. ft260_dbg("bus_status %#02x, clock %u\n", report.bus_status,
  269. dev->clock);
  270. if (report.bus_status & FT260_I2C_STATUS_CTRL_BUSY)
  271. return -EAGAIN;
  272. if (report.bus_status & FT260_I2C_STATUS_BUS_BUSY)
  273. return -EBUSY;
  274. if (report.bus_status & FT260_I2C_STATUS_ERROR)
  275. return -EIO;
  276. ret = -EIO;
  277. if (report.bus_status & FT260_I2C_STATUS_ADDR_NO_ACK)
  278. ft260_dbg("unacknowledged address\n");
  279. if (report.bus_status & FT260_I2C_STATUS_DATA_NO_ACK)
  280. ft260_dbg("unacknowledged data\n");
  281. if (report.bus_status & FT260_I2C_STATUS_ARBITR_LOST)
  282. ft260_dbg("arbitration loss\n");
  283. if (report.bus_status & FT260_I2C_STATUS_CTRL_IDLE)
  284. ret = 0;
  285. return ret;
  286. }
  287. static int ft260_hid_output_report(struct hid_device *hdev, u8 *data,
  288. size_t len)
  289. {
  290. u8 *buf;
  291. int ret;
  292. buf = kmemdup(data, len, GFP_KERNEL);
  293. if (!buf)
  294. return -ENOMEM;
  295. ret = hid_hw_output_report(hdev, buf, len);
  296. kfree(buf);
  297. return ret;
  298. }
  299. static int ft260_hid_output_report_check_status(struct ft260_device *dev,
  300. u8 *data, int len)
  301. {
  302. int ret, usec, try = 3;
  303. struct hid_device *hdev = dev->hdev;
  304. ret = ft260_hid_output_report(hdev, data, len);
  305. if (ret < 0) {
  306. hid_err(hdev, "%s: failed to start transfer, ret %d\n",
  307. __func__, ret);
  308. ft260_i2c_reset(hdev);
  309. return ret;
  310. }
  311. /* transfer time = 1 / clock(KHz) * 10 bits * bytes */
  312. usec = 10000 / dev->clock * len;
  313. usleep_range(usec, usec + 100);
  314. ft260_dbg("wait %d usec, len %d\n", usec, len);
  315. do {
  316. ret = ft260_xfer_status(dev);
  317. if (ret != -EAGAIN)
  318. break;
  319. } while (--try);
  320. if (ret == 0 || ret == -EBUSY)
  321. return 0;
  322. ft260_i2c_reset(hdev);
  323. return -EIO;
  324. }
  325. static int ft260_i2c_write(struct ft260_device *dev, u8 addr, u8 *data,
  326. int data_len, u8 flag)
  327. {
  328. int len, ret, idx = 0;
  329. struct hid_device *hdev = dev->hdev;
  330. struct ft260_i2c_write_request_report *rep =
  331. (struct ft260_i2c_write_request_report *)dev->write_buf;
  332. do {
  333. if (data_len <= FT260_WR_DATA_MAX)
  334. len = data_len;
  335. else
  336. len = FT260_WR_DATA_MAX;
  337. rep->report = FT260_I2C_DATA_REPORT_ID(len);
  338. rep->address = addr;
  339. rep->length = len;
  340. rep->flag = flag;
  341. memcpy(rep->data, &data[idx], len);
  342. ft260_dbg("rep %#02x addr %#02x off %d len %d d[0] %#02x\n",
  343. rep->report, addr, idx, len, data[0]);
  344. ret = ft260_hid_output_report_check_status(dev, (u8 *)rep,
  345. len + 4);
  346. if (ret < 0) {
  347. hid_err(hdev, "%s: failed to start transfer, ret %d\n",
  348. __func__, ret);
  349. return ret;
  350. }
  351. data_len -= len;
  352. idx += len;
  353. } while (data_len > 0);
  354. return 0;
  355. }
  356. static int ft260_smbus_write(struct ft260_device *dev, u8 addr, u8 cmd,
  357. u8 *data, u8 data_len, u8 flag)
  358. {
  359. int ret = 0;
  360. int len = 4;
  361. struct ft260_i2c_write_request_report *rep =
  362. (struct ft260_i2c_write_request_report *)dev->write_buf;
  363. if (data_len >= sizeof(rep->data))
  364. return -EINVAL;
  365. rep->address = addr;
  366. rep->data[0] = cmd;
  367. rep->length = data_len + 1;
  368. rep->flag = flag;
  369. len += rep->length;
  370. rep->report = FT260_I2C_DATA_REPORT_ID(len);
  371. if (data_len > 0)
  372. memcpy(&rep->data[1], data, data_len);
  373. ft260_dbg("rep %#02x addr %#02x cmd %#02x datlen %d replen %d\n",
  374. rep->report, addr, cmd, rep->length, len);
  375. ret = ft260_hid_output_report_check_status(dev, (u8 *)rep, len);
  376. return ret;
  377. }
  378. static int ft260_i2c_read(struct ft260_device *dev, u8 addr, u8 *data,
  379. u16 len, u8 flag)
  380. {
  381. struct ft260_i2c_read_request_report rep;
  382. struct hid_device *hdev = dev->hdev;
  383. int timeout;
  384. int ret;
  385. if (len > FT260_RD_DATA_MAX) {
  386. hid_err(hdev, "%s: unsupported rd len: %d\n", __func__, len);
  387. return -EINVAL;
  388. }
  389. dev->read_idx = 0;
  390. dev->read_buf = data;
  391. dev->read_len = len;
  392. rep.report = FT260_I2C_READ_REQ;
  393. rep.length = cpu_to_le16(len);
  394. rep.address = addr;
  395. rep.flag = flag;
  396. ft260_dbg("rep %#02x addr %#02x len %d\n", rep.report, rep.address,
  397. rep.length);
  398. reinit_completion(&dev->wait);
  399. ret = ft260_hid_output_report(hdev, (u8 *)&rep, sizeof(rep));
  400. if (ret < 0) {
  401. hid_err(hdev, "%s: failed to start transaction, ret %d\n",
  402. __func__, ret);
  403. return ret;
  404. }
  405. timeout = msecs_to_jiffies(5000);
  406. if (!wait_for_completion_timeout(&dev->wait, timeout)) {
  407. ft260_i2c_reset(hdev);
  408. return -ETIMEDOUT;
  409. }
  410. ret = ft260_xfer_status(dev);
  411. if (ret == 0)
  412. return 0;
  413. ft260_i2c_reset(hdev);
  414. return -EIO;
  415. }
  416. /*
  417. * A random read operation is implemented as a dummy write operation, followed
  418. * by a current address read operation. The dummy write operation is used to
  419. * load the target byte address into the current byte address counter, from
  420. * which the subsequent current address read operation then reads.
  421. */
  422. static int ft260_i2c_write_read(struct ft260_device *dev, struct i2c_msg *msgs)
  423. {
  424. int len, ret;
  425. u16 left_len = msgs[1].len;
  426. u8 *read_buf = msgs[1].buf;
  427. u8 addr = msgs[0].addr;
  428. u16 read_off = 0;
  429. struct hid_device *hdev = dev->hdev;
  430. if (msgs[0].len > 2) {
  431. hid_err(hdev, "%s: unsupported wr len: %d\n", __func__,
  432. msgs[0].len);
  433. return -EOPNOTSUPP;
  434. }
  435. memcpy(&read_off, msgs[0].buf, msgs[0].len);
  436. do {
  437. if (left_len <= FT260_RD_DATA_MAX)
  438. len = left_len;
  439. else
  440. len = FT260_RD_DATA_MAX;
  441. ft260_dbg("read_off %#x left_len %d len %d\n", read_off,
  442. left_len, len);
  443. ret = ft260_i2c_write(dev, addr, (u8 *)&read_off, msgs[0].len,
  444. FT260_FLAG_START);
  445. if (ret < 0)
  446. return ret;
  447. ret = ft260_i2c_read(dev, addr, read_buf, len,
  448. FT260_FLAG_START_STOP);
  449. if (ret < 0)
  450. return ret;
  451. left_len -= len;
  452. read_buf += len;
  453. read_off += len;
  454. } while (left_len > 0);
  455. return 0;
  456. }
  457. static int ft260_i2c_xfer(struct i2c_adapter *adapter, struct i2c_msg *msgs,
  458. int num)
  459. {
  460. int ret;
  461. struct ft260_device *dev = i2c_get_adapdata(adapter);
  462. struct hid_device *hdev = dev->hdev;
  463. mutex_lock(&dev->lock);
  464. ret = hid_hw_power(hdev, PM_HINT_FULLON);
  465. if (ret < 0) {
  466. hid_err(hdev, "failed to enter FULLON power mode: %d\n", ret);
  467. mutex_unlock(&dev->lock);
  468. return ret;
  469. }
  470. if (num == 1) {
  471. if (msgs->flags & I2C_M_RD)
  472. ret = ft260_i2c_read(dev, msgs->addr, msgs->buf,
  473. msgs->len, FT260_FLAG_START_STOP);
  474. else
  475. ret = ft260_i2c_write(dev, msgs->addr, msgs->buf,
  476. msgs->len, FT260_FLAG_START_STOP);
  477. if (ret < 0)
  478. goto i2c_exit;
  479. } else {
  480. /* Combined write then read message */
  481. ret = ft260_i2c_write_read(dev, msgs);
  482. if (ret < 0)
  483. goto i2c_exit;
  484. }
  485. ret = num;
  486. i2c_exit:
  487. hid_hw_power(hdev, PM_HINT_NORMAL);
  488. mutex_unlock(&dev->lock);
  489. return ret;
  490. }
  491. static int ft260_smbus_xfer(struct i2c_adapter *adapter, u16 addr, u16 flags,
  492. char read_write, u8 cmd, int size,
  493. union i2c_smbus_data *data)
  494. {
  495. int ret;
  496. struct ft260_device *dev = i2c_get_adapdata(adapter);
  497. struct hid_device *hdev = dev->hdev;
  498. ft260_dbg("smbus size %d\n", size);
  499. mutex_lock(&dev->lock);
  500. ret = hid_hw_power(hdev, PM_HINT_FULLON);
  501. if (ret < 0) {
  502. hid_err(hdev, "power management error: %d\n", ret);
  503. mutex_unlock(&dev->lock);
  504. return ret;
  505. }
  506. switch (size) {
  507. case I2C_SMBUS_QUICK:
  508. if (read_write == I2C_SMBUS_READ)
  509. ret = ft260_i2c_read(dev, addr, &data->byte, 0,
  510. FT260_FLAG_START_STOP);
  511. else
  512. ret = ft260_smbus_write(dev, addr, cmd, NULL, 0,
  513. FT260_FLAG_START_STOP);
  514. break;
  515. case I2C_SMBUS_BYTE:
  516. if (read_write == I2C_SMBUS_READ)
  517. ret = ft260_i2c_read(dev, addr, &data->byte, 1,
  518. FT260_FLAG_START_STOP);
  519. else
  520. ret = ft260_smbus_write(dev, addr, cmd, NULL, 0,
  521. FT260_FLAG_START_STOP);
  522. break;
  523. case I2C_SMBUS_BYTE_DATA:
  524. if (read_write == I2C_SMBUS_READ) {
  525. ret = ft260_smbus_write(dev, addr, cmd, NULL, 0,
  526. FT260_FLAG_START);
  527. if (ret)
  528. goto smbus_exit;
  529. ret = ft260_i2c_read(dev, addr, &data->byte, 1,
  530. FT260_FLAG_START_STOP_REPEATED);
  531. } else {
  532. ret = ft260_smbus_write(dev, addr, cmd, &data->byte, 1,
  533. FT260_FLAG_START_STOP);
  534. }
  535. break;
  536. case I2C_SMBUS_WORD_DATA:
  537. if (read_write == I2C_SMBUS_READ) {
  538. ret = ft260_smbus_write(dev, addr, cmd, NULL, 0,
  539. FT260_FLAG_START);
  540. if (ret)
  541. goto smbus_exit;
  542. ret = ft260_i2c_read(dev, addr, (u8 *)&data->word, 2,
  543. FT260_FLAG_START_STOP_REPEATED);
  544. } else {
  545. ret = ft260_smbus_write(dev, addr, cmd,
  546. (u8 *)&data->word, 2,
  547. FT260_FLAG_START_STOP);
  548. }
  549. break;
  550. case I2C_SMBUS_BLOCK_DATA:
  551. if (read_write == I2C_SMBUS_READ) {
  552. ret = ft260_smbus_write(dev, addr, cmd, NULL, 0,
  553. FT260_FLAG_START);
  554. if (ret)
  555. goto smbus_exit;
  556. ret = ft260_i2c_read(dev, addr, data->block,
  557. data->block[0] + 1,
  558. FT260_FLAG_START_STOP_REPEATED);
  559. } else {
  560. ret = ft260_smbus_write(dev, addr, cmd, data->block,
  561. data->block[0] + 1,
  562. FT260_FLAG_START_STOP);
  563. }
  564. break;
  565. case I2C_SMBUS_I2C_BLOCK_DATA:
  566. if (read_write == I2C_SMBUS_READ) {
  567. ret = ft260_smbus_write(dev, addr, cmd, NULL, 0,
  568. FT260_FLAG_START);
  569. if (ret)
  570. goto smbus_exit;
  571. ret = ft260_i2c_read(dev, addr, data->block + 1,
  572. data->block[0],
  573. FT260_FLAG_START_STOP_REPEATED);
  574. } else {
  575. ret = ft260_smbus_write(dev, addr, cmd, data->block + 1,
  576. data->block[0],
  577. FT260_FLAG_START_STOP);
  578. }
  579. break;
  580. default:
  581. hid_err(hdev, "unsupported smbus transaction size %d\n", size);
  582. ret = -EOPNOTSUPP;
  583. }
  584. smbus_exit:
  585. hid_hw_power(hdev, PM_HINT_NORMAL);
  586. mutex_unlock(&dev->lock);
  587. return ret;
  588. }
  589. static u32 ft260_functionality(struct i2c_adapter *adap)
  590. {
  591. return I2C_FUNC_I2C | I2C_FUNC_SMBUS_BYTE | I2C_FUNC_SMBUS_QUICK |
  592. I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA |
  593. I2C_FUNC_SMBUS_BLOCK_DATA | I2C_FUNC_SMBUS_I2C_BLOCK;
  594. }
  595. static const struct i2c_adapter_quirks ft260_i2c_quirks = {
  596. .flags = I2C_AQ_COMB_WRITE_THEN_READ,
  597. .max_comb_1st_msg_len = 2,
  598. };
  599. static const struct i2c_algorithm ft260_i2c_algo = {
  600. .master_xfer = ft260_i2c_xfer,
  601. .smbus_xfer = ft260_smbus_xfer,
  602. .functionality = ft260_functionality,
  603. };
  604. static int ft260_get_system_config(struct hid_device *hdev,
  605. struct ft260_get_system_status_report *cfg)
  606. {
  607. int ret;
  608. int len = sizeof(struct ft260_get_system_status_report);
  609. ret = ft260_hid_feature_report_get(hdev, FT260_SYSTEM_SETTINGS,
  610. (u8 *)cfg, len);
  611. if (ret < 0) {
  612. hid_err(hdev, "failed to retrieve system status\n");
  613. return ret;
  614. }
  615. return 0;
  616. }
  617. static int ft260_is_interface_enabled(struct hid_device *hdev)
  618. {
  619. struct ft260_get_system_status_report cfg;
  620. struct usb_interface *usbif = to_usb_interface(hdev->dev.parent);
  621. int interface = usbif->cur_altsetting->desc.bInterfaceNumber;
  622. int ret;
  623. ret = ft260_get_system_config(hdev, &cfg);
  624. if (ret < 0)
  625. return ret;
  626. ft260_dbg("interface: 0x%02x\n", interface);
  627. ft260_dbg("chip mode: 0x%02x\n", cfg.chip_mode);
  628. ft260_dbg("clock_ctl: 0x%02x\n", cfg.clock_ctl);
  629. ft260_dbg("i2c_enable: 0x%02x\n", cfg.i2c_enable);
  630. ft260_dbg("uart_mode: 0x%02x\n", cfg.uart_mode);
  631. switch (cfg.chip_mode) {
  632. case FT260_MODE_ALL:
  633. case FT260_MODE_BOTH:
  634. if (interface == 1)
  635. hid_info(hdev, "uart interface is not supported\n");
  636. else
  637. ret = 1;
  638. break;
  639. case FT260_MODE_UART:
  640. hid_info(hdev, "uart interface is not supported\n");
  641. break;
  642. case FT260_MODE_I2C:
  643. ret = 1;
  644. break;
  645. }
  646. return ret;
  647. }
  648. static int ft260_byte_show(struct hid_device *hdev, int id, u8 *cfg, int len,
  649. u8 *field, u8 *buf)
  650. {
  651. int ret;
  652. ret = ft260_hid_feature_report_get(hdev, id, cfg, len);
  653. if (ret < 0)
  654. return ret;
  655. return scnprintf(buf, PAGE_SIZE, "%d\n", *field);
  656. }
  657. static int ft260_word_show(struct hid_device *hdev, int id, u8 *cfg, int len,
  658. u16 *field, u8 *buf)
  659. {
  660. int ret;
  661. ret = ft260_hid_feature_report_get(hdev, id, cfg, len);
  662. if (ret < 0)
  663. return ret;
  664. return scnprintf(buf, PAGE_SIZE, "%d\n", le16_to_cpu(*field));
  665. }
  666. #define FT260_ATTR_SHOW(name, reptype, id, type, func) \
  667. static ssize_t name##_show(struct device *kdev, \
  668. struct device_attribute *attr, char *buf) \
  669. { \
  670. struct reptype rep; \
  671. struct hid_device *hdev = to_hid_device(kdev); \
  672. type *field = &rep.name; \
  673. int len = sizeof(rep); \
  674. \
  675. return func(hdev, id, (u8 *)&rep, len, field, buf); \
  676. }
  677. #define FT260_SSTAT_ATTR_SHOW(name) \
  678. FT260_ATTR_SHOW(name, ft260_get_system_status_report, \
  679. FT260_SYSTEM_SETTINGS, u8, ft260_byte_show)
  680. #define FT260_I2CST_ATTR_SHOW(name) \
  681. FT260_ATTR_SHOW(name, ft260_get_i2c_status_report, \
  682. FT260_I2C_STATUS, u16, ft260_word_show)
  683. #define FT260_ATTR_STORE(name, reptype, id, req, type, func) \
  684. static ssize_t name##_store(struct device *kdev, \
  685. struct device_attribute *attr, \
  686. const char *buf, size_t count) \
  687. { \
  688. struct reptype rep; \
  689. struct hid_device *hdev = to_hid_device(kdev); \
  690. type name; \
  691. int ret; \
  692. \
  693. if (!func(buf, 10, &name)) { \
  694. rep.name = name; \
  695. rep.report = id; \
  696. rep.request = req; \
  697. ret = ft260_hid_feature_report_set(hdev, (u8 *)&rep, \
  698. sizeof(rep)); \
  699. if (!ret) \
  700. ret = count; \
  701. } else { \
  702. ret = -EINVAL; \
  703. } \
  704. return ret; \
  705. }
  706. #define FT260_BYTE_ATTR_STORE(name, reptype, req) \
  707. FT260_ATTR_STORE(name, reptype, FT260_SYSTEM_SETTINGS, req, \
  708. u8, kstrtou8)
  709. #define FT260_WORD_ATTR_STORE(name, reptype, req) \
  710. FT260_ATTR_STORE(name, reptype, FT260_SYSTEM_SETTINGS, req, \
  711. u16, kstrtou16)
  712. FT260_SSTAT_ATTR_SHOW(chip_mode);
  713. static DEVICE_ATTR_RO(chip_mode);
  714. FT260_SSTAT_ATTR_SHOW(pwren_status);
  715. static DEVICE_ATTR_RO(pwren_status);
  716. FT260_SSTAT_ATTR_SHOW(suspend_status);
  717. static DEVICE_ATTR_RO(suspend_status);
  718. FT260_SSTAT_ATTR_SHOW(hid_over_i2c_en);
  719. static DEVICE_ATTR_RO(hid_over_i2c_en);
  720. FT260_SSTAT_ATTR_SHOW(power_saving_en);
  721. static DEVICE_ATTR_RO(power_saving_en);
  722. FT260_SSTAT_ATTR_SHOW(i2c_enable);
  723. FT260_BYTE_ATTR_STORE(i2c_enable, ft260_set_i2c_mode_report,
  724. FT260_SET_I2C_MODE);
  725. static DEVICE_ATTR_RW(i2c_enable);
  726. FT260_SSTAT_ATTR_SHOW(uart_mode);
  727. FT260_BYTE_ATTR_STORE(uart_mode, ft260_set_uart_mode_report,
  728. FT260_SET_UART_MODE);
  729. static DEVICE_ATTR_RW(uart_mode);
  730. FT260_SSTAT_ATTR_SHOW(clock_ctl);
  731. FT260_BYTE_ATTR_STORE(clock_ctl, ft260_set_system_clock_report,
  732. FT260_SET_CLOCK);
  733. static DEVICE_ATTR_RW(clock_ctl);
  734. FT260_I2CST_ATTR_SHOW(clock);
  735. FT260_WORD_ATTR_STORE(clock, ft260_set_i2c_speed_report,
  736. FT260_SET_I2C_CLOCK_SPEED);
  737. static DEVICE_ATTR_RW(clock);
  738. static ssize_t i2c_reset_store(struct device *kdev,
  739. struct device_attribute *attr, const char *buf,
  740. size_t count)
  741. {
  742. struct hid_device *hdev = to_hid_device(kdev);
  743. int ret = ft260_i2c_reset(hdev);
  744. if (ret)
  745. return ret;
  746. return count;
  747. }
  748. static DEVICE_ATTR_WO(i2c_reset);
  749. static const struct attribute_group ft260_attr_group = {
  750. .attrs = (struct attribute *[]) {
  751. &dev_attr_chip_mode.attr,
  752. &dev_attr_pwren_status.attr,
  753. &dev_attr_suspend_status.attr,
  754. &dev_attr_hid_over_i2c_en.attr,
  755. &dev_attr_power_saving_en.attr,
  756. &dev_attr_i2c_enable.attr,
  757. &dev_attr_uart_mode.attr,
  758. &dev_attr_clock_ctl.attr,
  759. &dev_attr_i2c_reset.attr,
  760. &dev_attr_clock.attr,
  761. NULL
  762. }
  763. };
  764. static int ft260_probe(struct hid_device *hdev, const struct hid_device_id *id)
  765. {
  766. struct ft260_device *dev;
  767. struct ft260_get_chip_version_report version;
  768. int ret;
  769. if (!hid_is_usb(hdev))
  770. return -EINVAL;
  771. dev = devm_kzalloc(&hdev->dev, sizeof(*dev), GFP_KERNEL);
  772. if (!dev)
  773. return -ENOMEM;
  774. ret = hid_parse(hdev);
  775. if (ret) {
  776. hid_err(hdev, "failed to parse HID\n");
  777. return ret;
  778. }
  779. ret = hid_hw_start(hdev, HID_CONNECT_HIDRAW);
  780. if (ret) {
  781. hid_err(hdev, "failed to start HID HW\n");
  782. return ret;
  783. }
  784. ret = hid_hw_open(hdev);
  785. if (ret) {
  786. hid_err(hdev, "failed to open HID HW\n");
  787. goto err_hid_stop;
  788. }
  789. ret = ft260_hid_feature_report_get(hdev, FT260_CHIP_VERSION,
  790. (u8 *)&version, sizeof(version));
  791. if (ret < 0) {
  792. hid_err(hdev, "failed to retrieve chip version\n");
  793. goto err_hid_close;
  794. }
  795. hid_info(hdev, "chip code: %02x%02x %02x%02x\n",
  796. version.chip_code[0], version.chip_code[1],
  797. version.chip_code[2], version.chip_code[3]);
  798. ret = ft260_is_interface_enabled(hdev);
  799. if (ret <= 0)
  800. goto err_hid_close;
  801. hid_set_drvdata(hdev, dev);
  802. dev->hdev = hdev;
  803. dev->adap.owner = THIS_MODULE;
  804. dev->adap.class = I2C_CLASS_HWMON;
  805. dev->adap.algo = &ft260_i2c_algo;
  806. dev->adap.quirks = &ft260_i2c_quirks;
  807. dev->adap.dev.parent = &hdev->dev;
  808. snprintf(dev->adap.name, sizeof(dev->adap.name),
  809. "FT260 usb-i2c bridge on hidraw%d",
  810. ((struct hidraw *)hdev->hidraw)->minor);
  811. mutex_init(&dev->lock);
  812. init_completion(&dev->wait);
  813. ret = ft260_xfer_status(dev);
  814. if (ret)
  815. ft260_i2c_reset(hdev);
  816. i2c_set_adapdata(&dev->adap, dev);
  817. ret = i2c_add_adapter(&dev->adap);
  818. if (ret) {
  819. hid_err(hdev, "failed to add i2c adapter\n");
  820. goto err_hid_close;
  821. }
  822. ret = sysfs_create_group(&hdev->dev.kobj, &ft260_attr_group);
  823. if (ret < 0) {
  824. hid_err(hdev, "failed to create sysfs attrs\n");
  825. goto err_i2c_free;
  826. }
  827. return 0;
  828. err_i2c_free:
  829. i2c_del_adapter(&dev->adap);
  830. err_hid_close:
  831. hid_hw_close(hdev);
  832. err_hid_stop:
  833. hid_hw_stop(hdev);
  834. return ret;
  835. }
  836. static void ft260_remove(struct hid_device *hdev)
  837. {
  838. struct ft260_device *dev = hid_get_drvdata(hdev);
  839. if (!dev)
  840. return;
  841. sysfs_remove_group(&hdev->dev.kobj, &ft260_attr_group);
  842. i2c_del_adapter(&dev->adap);
  843. hid_hw_close(hdev);
  844. hid_hw_stop(hdev);
  845. }
  846. static int ft260_raw_event(struct hid_device *hdev, struct hid_report *report,
  847. u8 *data, int size)
  848. {
  849. struct ft260_device *dev = hid_get_drvdata(hdev);
  850. struct ft260_i2c_input_report *xfer = (void *)data;
  851. if (xfer->report >= FT260_I2C_REPORT_MIN &&
  852. xfer->report <= FT260_I2C_REPORT_MAX) {
  853. ft260_dbg("i2c resp: rep %#02x len %d\n", xfer->report,
  854. xfer->length);
  855. memcpy(&dev->read_buf[dev->read_idx], &xfer->data,
  856. xfer->length);
  857. dev->read_idx += xfer->length;
  858. if (dev->read_idx == dev->read_len)
  859. complete(&dev->wait);
  860. } else {
  861. hid_err(hdev, "unknown report: %#02x\n", xfer->report);
  862. return 0;
  863. }
  864. return 1;
  865. }
  866. static struct hid_driver ft260_driver = {
  867. .name = "ft260",
  868. .id_table = ft260_devices,
  869. .probe = ft260_probe,
  870. .remove = ft260_remove,
  871. .raw_event = ft260_raw_event,
  872. };
  873. module_hid_driver(ft260_driver);
  874. MODULE_DESCRIPTION("FTDI FT260 USB HID to I2C host bridge");
  875. MODULE_AUTHOR("Michael Zaidman <[email protected]>");
  876. MODULE_LICENSE("GPL v2");