asus-tf103c-dock.c 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943
  1. // SPDX-License-Identifier: GPL-2.0+
  2. /*
  3. * This is a driver for the keyboard, touchpad and USB port of the
  4. * keyboard dock for the Asus TF103C 2-in-1 tablet.
  5. *
  6. * This keyboard dock has its own I2C attached embedded controller
  7. * and the keyboard and touchpad are also connected over I2C,
  8. * instead of using the usual USB connection. This means that the
  9. * keyboard dock requires this special driver to function.
  10. *
  11. * Copyright (C) 2021 Hans de Goede <[email protected]>
  12. */
  13. #include <linux/acpi.h>
  14. #include <linux/delay.h>
  15. #include <linux/dmi.h>
  16. #include <linux/gpio/consumer.h>
  17. #include <linux/gpio/machine.h>
  18. #include <linux/hid.h>
  19. #include <linux/i2c.h>
  20. #include <linux/input.h>
  21. #include <linux/irq.h>
  22. #include <linux/irqdomain.h>
  23. #include <linux/mod_devicetable.h>
  24. #include <linux/moduleparam.h>
  25. #include <linux/module.h>
  26. #include <linux/pm.h>
  27. #include <linux/workqueue.h>
  28. #include <asm/unaligned.h>
  29. static bool fnlock;
  30. module_param(fnlock, bool, 0644);
  31. MODULE_PARM_DESC(fnlock,
  32. "By default the kbd toprow sends multimedia key presses. AltGr "
  33. "can be pressed to change this to F1-F12. Set this to 1 to "
  34. "change the default. Press AltGr + Esc to toggle at runtime.");
  35. #define TF103C_DOCK_DEV_NAME "NPCE69A:00"
  36. #define TF103C_DOCK_HPD_DEBOUNCE msecs_to_jiffies(20)
  37. /*** Touchpad I2C device defines ***/
  38. #define TF103C_DOCK_TP_ADDR 0x15
  39. /*** Keyboard I2C device defines **A*/
  40. #define TF103C_DOCK_KBD_ADDR 0x16
  41. #define TF103C_DOCK_KBD_DATA_REG 0x73
  42. #define TF103C_DOCK_KBD_DATA_MIN_LENGTH 4
  43. #define TF103C_DOCK_KBD_DATA_MAX_LENGTH 11
  44. #define TF103C_DOCK_KBD_DATA_MODIFIERS 3
  45. #define TF103C_DOCK_KBD_DATA_KEYS 5
  46. #define TF103C_DOCK_KBD_CMD_REG 0x75
  47. #define TF103C_DOCK_KBD_CMD_ENABLE 0x0800
  48. /*** EC innterrupt data I2C device defines ***/
  49. #define TF103C_DOCK_INTR_ADDR 0x19
  50. #define TF103C_DOCK_INTR_DATA_REG 0x6a
  51. #define TF103C_DOCK_INTR_DATA1_OBF_MASK 0x01
  52. #define TF103C_DOCK_INTR_DATA1_KEY_MASK 0x04
  53. #define TF103C_DOCK_INTR_DATA1_KBC_MASK 0x08
  54. #define TF103C_DOCK_INTR_DATA1_AUX_MASK 0x20
  55. #define TF103C_DOCK_INTR_DATA1_SCI_MASK 0x40
  56. #define TF103C_DOCK_INTR_DATA1_SMI_MASK 0x80
  57. /* Special values for the OOB data on kbd_client / tp_client */
  58. #define TF103C_DOCK_INTR_DATA1_OOB_VALUE 0xc1
  59. #define TF103C_DOCK_INTR_DATA2_OOB_VALUE 0x04
  60. #define TF103C_DOCK_SMI_AC_EVENT 0x31
  61. #define TF103C_DOCK_SMI_HANDSHAKING 0x50
  62. #define TF103C_DOCK_SMI_EC_WAKEUP 0x53
  63. #define TF103C_DOCK_SMI_BOOTBLOCK_RESET 0x5e
  64. #define TF103C_DOCK_SMI_WATCHDOG_RESET 0x5f
  65. #define TF103C_DOCK_SMI_ADAPTER_CHANGE 0x60
  66. #define TF103C_DOCK_SMI_DOCK_INSERT 0x61
  67. #define TF103C_DOCK_SMI_DOCK_REMOVE 0x62
  68. #define TF103C_DOCK_SMI_PAD_BL_CHANGE 0x63
  69. #define TF103C_DOCK_SMI_HID_STATUS_CHANGED 0x64
  70. #define TF103C_DOCK_SMI_HID_WAKEUP 0x65
  71. #define TF103C_DOCK_SMI_S3 0x83
  72. #define TF103C_DOCK_SMI_S5 0x85
  73. #define TF103C_DOCK_SMI_NOTIFY_SHUTDOWN 0x90
  74. #define TF103C_DOCK_SMI_RESUME 0x91
  75. /*** EC (dockram) I2C device defines ***/
  76. #define TF103C_DOCK_EC_ADDR 0x1b
  77. #define TF103C_DOCK_EC_CMD_REG 0x0a
  78. #define TF103C_DOCK_EC_CMD_LEN 9
  79. enum {
  80. TF103C_DOCK_FLAG_HID_OPEN,
  81. };
  82. struct tf103c_dock_data {
  83. struct delayed_work hpd_work;
  84. struct irq_chip tp_irqchip;
  85. struct irq_domain *tp_irq_domain;
  86. struct i2c_client *ec_client;
  87. struct i2c_client *intr_client;
  88. struct i2c_client *kbd_client;
  89. struct i2c_client *tp_client;
  90. struct gpio_desc *pwr_en;
  91. struct gpio_desc *irq_gpio;
  92. struct gpio_desc *hpd_gpio;
  93. struct input_dev *input;
  94. struct hid_device *hid;
  95. unsigned long flags;
  96. int board_rev;
  97. int irq;
  98. int hpd_irq;
  99. int tp_irq;
  100. int last_press_0x13;
  101. int last_press_0x14;
  102. bool enabled;
  103. bool tp_enabled;
  104. bool altgr_pressed;
  105. bool esc_pressed;
  106. bool filter_esc;
  107. u8 kbd_buf[TF103C_DOCK_KBD_DATA_MAX_LENGTH];
  108. };
  109. static struct gpiod_lookup_table tf103c_dock_gpios = {
  110. .dev_id = "i2c-" TF103C_DOCK_DEV_NAME,
  111. .table = {
  112. GPIO_LOOKUP("INT33FC:00", 55, "dock_pwr_en", GPIO_ACTIVE_HIGH),
  113. GPIO_LOOKUP("INT33FC:02", 1, "dock_irq", GPIO_ACTIVE_HIGH),
  114. GPIO_LOOKUP("INT33FC:02", 29, "dock_hpd", GPIO_ACTIVE_HIGH),
  115. GPIO_LOOKUP("gpio_crystalcove", 2, "board_rev", GPIO_ACTIVE_HIGH),
  116. {}
  117. },
  118. };
  119. /* Byte 0 is the length of the rest of the packet */
  120. static const u8 tf103c_dock_enable_cmd[9] = { 8, 0x20, 0, 0, 0, 0, 0x20, 0, 0 };
  121. static const u8 tf103c_dock_usb_enable_cmd[9] = { 8, 0, 0, 0, 0, 0, 0, 0x40, 0 };
  122. static const u8 tf103c_dock_suspend_cmd[9] = { 8, 0, 0x20, 0, 0, 0x22, 0, 0, 0 };
  123. /*** keyboard related code ***/
  124. static u8 tf103c_dock_kbd_hid_desc[] = {
  125. 0x05, 0x01, /* Usage Page (Desktop), */
  126. 0x09, 0x06, /* Usage (Keyboard), */
  127. 0xA1, 0x01, /* Collection (Application), */
  128. 0x85, 0x11, /* Report ID (17), */
  129. 0x95, 0x08, /* Report Count (8), */
  130. 0x75, 0x01, /* Report Size (1), */
  131. 0x15, 0x00, /* Logical Minimum (0), */
  132. 0x25, 0x01, /* Logical Maximum (1), */
  133. 0x05, 0x07, /* Usage Page (Keyboard), */
  134. 0x19, 0xE0, /* Usage Minimum (KB Leftcontrol), */
  135. 0x29, 0xE7, /* Usage Maximum (KB Right GUI), */
  136. 0x81, 0x02, /* Input (Variable), */
  137. 0x95, 0x01, /* Report Count (1), */
  138. 0x75, 0x08, /* Report Size (8), */
  139. 0x81, 0x01, /* Input (Constant), */
  140. 0x95, 0x06, /* Report Count (6), */
  141. 0x75, 0x08, /* Report Size (8), */
  142. 0x15, 0x00, /* Logical Minimum (0), */
  143. 0x26, 0xFF, 0x00, /* Logical Maximum (255), */
  144. 0x05, 0x07, /* Usage Page (Keyboard), */
  145. 0x19, 0x00, /* Usage Minimum (None), */
  146. 0x2A, 0xFF, 0x00, /* Usage Maximum (FFh), */
  147. 0x81, 0x00, /* Input, */
  148. 0xC0 /* End Collection */
  149. };
  150. static int tf103c_dock_kbd_read(struct tf103c_dock_data *dock)
  151. {
  152. struct i2c_client *client = dock->kbd_client;
  153. struct device *dev = &dock->ec_client->dev;
  154. struct i2c_msg msgs[2];
  155. u8 reg[2];
  156. int ret;
  157. reg[0] = TF103C_DOCK_KBD_DATA_REG & 0xff;
  158. reg[1] = TF103C_DOCK_KBD_DATA_REG >> 8;
  159. msgs[0].addr = client->addr;
  160. msgs[0].flags = 0;
  161. msgs[0].len = sizeof(reg);
  162. msgs[0].buf = reg;
  163. msgs[1].addr = client->addr;
  164. msgs[1].flags = I2C_M_RD;
  165. msgs[1].len = TF103C_DOCK_KBD_DATA_MAX_LENGTH;
  166. msgs[1].buf = dock->kbd_buf;
  167. ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
  168. if (ret != ARRAY_SIZE(msgs)) {
  169. dev_err(dev, "error %d reading kbd data\n", ret);
  170. return -EIO;
  171. }
  172. return 0;
  173. }
  174. static void tf103c_dock_kbd_write(struct tf103c_dock_data *dock, u16 cmd)
  175. {
  176. struct device *dev = &dock->ec_client->dev;
  177. u8 buf[4];
  178. int ret;
  179. put_unaligned_le16(TF103C_DOCK_KBD_CMD_REG, &buf[0]);
  180. put_unaligned_le16(cmd, &buf[2]);
  181. ret = i2c_master_send(dock->kbd_client, buf, sizeof(buf));
  182. if (ret != sizeof(buf))
  183. dev_err(dev, "error %d writing kbd cmd\n", ret);
  184. }
  185. /* HID ll_driver functions for forwarding input-reports from the kbd_client */
  186. static int tf103c_dock_hid_parse(struct hid_device *hid)
  187. {
  188. return hid_parse_report(hid, tf103c_dock_kbd_hid_desc,
  189. sizeof(tf103c_dock_kbd_hid_desc));
  190. }
  191. static int tf103c_dock_hid_start(struct hid_device *hid)
  192. {
  193. return 0;
  194. }
  195. static void tf103c_dock_hid_stop(struct hid_device *hid)
  196. {
  197. hid->claimed = 0;
  198. }
  199. static int tf103c_dock_hid_open(struct hid_device *hid)
  200. {
  201. struct tf103c_dock_data *dock = hid->driver_data;
  202. set_bit(TF103C_DOCK_FLAG_HID_OPEN, &dock->flags);
  203. return 0;
  204. }
  205. static void tf103c_dock_hid_close(struct hid_device *hid)
  206. {
  207. struct tf103c_dock_data *dock = hid->driver_data;
  208. clear_bit(TF103C_DOCK_FLAG_HID_OPEN, &dock->flags);
  209. }
  210. /* Mandatory, but not used */
  211. static int tf103c_dock_hid_raw_request(struct hid_device *hid, u8 reportnum,
  212. u8 *buf, size_t len, u8 rtype, int reqtype)
  213. {
  214. return 0;
  215. }
  216. static struct hid_ll_driver tf103c_dock_hid_ll_driver = {
  217. .parse = tf103c_dock_hid_parse,
  218. .start = tf103c_dock_hid_start,
  219. .stop = tf103c_dock_hid_stop,
  220. .open = tf103c_dock_hid_open,
  221. .close = tf103c_dock_hid_close,
  222. .raw_request = tf103c_dock_hid_raw_request,
  223. };
  224. static int tf103c_dock_toprow_codes[13][2] = {
  225. /* Normal, AltGr pressed */
  226. { KEY_POWER, KEY_F1 },
  227. { KEY_RFKILL, KEY_F2 },
  228. { KEY_F21, KEY_F3 }, /* Touchpad toggle, userspace expects F21 */
  229. { KEY_BRIGHTNESSDOWN, KEY_F4 },
  230. { KEY_BRIGHTNESSUP, KEY_F5 },
  231. { KEY_CAMERA, KEY_F6 },
  232. { KEY_CONFIG, KEY_F7 },
  233. { KEY_PREVIOUSSONG, KEY_F8 },
  234. { KEY_PLAYPAUSE, KEY_F9 },
  235. { KEY_NEXTSONG, KEY_F10 },
  236. { KEY_MUTE, KEY_F11 },
  237. { KEY_VOLUMEDOWN, KEY_F12 },
  238. { KEY_VOLUMEUP, KEY_SYSRQ },
  239. };
  240. static void tf103c_dock_report_toprow_kbd_hook(struct tf103c_dock_data *dock)
  241. {
  242. u8 *esc, *buf = dock->kbd_buf;
  243. int size;
  244. /*
  245. * Stop AltGr reports from getting reported on the "Asus TF103C Dock
  246. * Keyboard" input_dev, since this gets used as "Fn" key for the toprow
  247. * keys. Instead we report this on the "Asus TF103C Dock Top Row Keys"
  248. * input_dev, when not used to modify the toprow keys.
  249. */
  250. dock->altgr_pressed = buf[TF103C_DOCK_KBD_DATA_MODIFIERS] & 0x40;
  251. buf[TF103C_DOCK_KBD_DATA_MODIFIERS] &= ~0x40;
  252. input_report_key(dock->input, KEY_RIGHTALT, dock->altgr_pressed);
  253. input_sync(dock->input);
  254. /* Toggle fnlock on AltGr + Esc press */
  255. buf = buf + TF103C_DOCK_KBD_DATA_KEYS;
  256. size = TF103C_DOCK_KBD_DATA_MAX_LENGTH - TF103C_DOCK_KBD_DATA_KEYS;
  257. esc = memchr(buf, 0x29, size);
  258. if (!dock->esc_pressed && esc) {
  259. if (dock->altgr_pressed) {
  260. fnlock = !fnlock;
  261. dock->filter_esc = true;
  262. }
  263. }
  264. if (esc && dock->filter_esc)
  265. *esc = 0;
  266. else
  267. dock->filter_esc = false;
  268. dock->esc_pressed = esc != NULL;
  269. }
  270. static void tf103c_dock_toprow_press(struct tf103c_dock_data *dock, int key_code)
  271. {
  272. /*
  273. * Release AltGr before reporting the toprow key, so that userspace
  274. * sees e.g. just KEY_SUSPEND and not AltGr + KEY_SUSPEND.
  275. */
  276. if (dock->altgr_pressed) {
  277. input_report_key(dock->input, KEY_RIGHTALT, false);
  278. input_sync(dock->input);
  279. }
  280. input_report_key(dock->input, key_code, true);
  281. input_sync(dock->input);
  282. }
  283. static void tf103c_dock_toprow_release(struct tf103c_dock_data *dock, int key_code)
  284. {
  285. input_report_key(dock->input, key_code, false);
  286. input_sync(dock->input);
  287. if (dock->altgr_pressed) {
  288. input_report_key(dock->input, KEY_RIGHTALT, true);
  289. input_sync(dock->input);
  290. }
  291. }
  292. static void tf103c_dock_toprow_event(struct tf103c_dock_data *dock,
  293. int toprow_index, int *last_press)
  294. {
  295. int key_code, fn = dock->altgr_pressed ^ fnlock;
  296. if (last_press && *last_press) {
  297. tf103c_dock_toprow_release(dock, *last_press);
  298. *last_press = 0;
  299. }
  300. if (toprow_index < 0)
  301. return;
  302. key_code = tf103c_dock_toprow_codes[toprow_index][fn];
  303. tf103c_dock_toprow_press(dock, key_code);
  304. if (last_press)
  305. *last_press = key_code;
  306. else
  307. tf103c_dock_toprow_release(dock, key_code);
  308. }
  309. /*
  310. * The keyboard sends what appears to be standard I2C-HID input-reports,
  311. * except that a 16 bit register address of where the I2C-HID format
  312. * input-reports are stored must be send before reading it in a single
  313. * (I2C repeated-start) I2C transaction.
  314. *
  315. * Its unknown how to get the HID descriptors but they are easy to reconstruct:
  316. *
  317. * Input report id 0x11 is 8 bytes long and contain standard USB HID intf-class,
  318. * Boot Interface Subclass reports.
  319. * Input report id 0x13 is 2 bytes long and sends Consumer Control events
  320. * Input report id 0x14 is 1 byte long and sends System Control events
  321. *
  322. * However the top row keys (where a normal keyboard has F1-F12 + Print-Screen)
  323. * are a mess, using a mix of the 0x13 and 0x14 input reports as well as EC SCI
  324. * events; and these need special handling to allow actually sending F1-F12,
  325. * since the Fn key on the keyboard only works on the cursor keys and the top
  326. * row keys always send their special "Multimedia hotkey" codes.
  327. *
  328. * So only forward the 0x11 reports to HID and handle the top-row keys here.
  329. */
  330. static void tf103c_dock_kbd_interrupt(struct tf103c_dock_data *dock)
  331. {
  332. struct device *dev = &dock->ec_client->dev;
  333. u8 *buf = dock->kbd_buf;
  334. int size;
  335. if (tf103c_dock_kbd_read(dock))
  336. return;
  337. size = buf[0] | buf[1] << 8;
  338. if (size < TF103C_DOCK_KBD_DATA_MIN_LENGTH ||
  339. size > TF103C_DOCK_KBD_DATA_MAX_LENGTH) {
  340. dev_err(dev, "error reported kbd pkt size %d is out of range %d-%d\n", size,
  341. TF103C_DOCK_KBD_DATA_MIN_LENGTH,
  342. TF103C_DOCK_KBD_DATA_MAX_LENGTH);
  343. return;
  344. }
  345. switch (buf[2]) {
  346. case 0x11:
  347. if (size != 11)
  348. break;
  349. tf103c_dock_report_toprow_kbd_hook(dock);
  350. if (test_bit(TF103C_DOCK_FLAG_HID_OPEN, &dock->flags))
  351. hid_input_report(dock->hid, HID_INPUT_REPORT, buf + 2, size - 2, 1);
  352. return;
  353. case 0x13:
  354. if (size != 5)
  355. break;
  356. switch (buf[3] | buf[4] << 8) {
  357. case 0:
  358. tf103c_dock_toprow_event(dock, -1, &dock->last_press_0x13);
  359. return;
  360. case 0x70:
  361. tf103c_dock_toprow_event(dock, 3, &dock->last_press_0x13);
  362. return;
  363. case 0x6f:
  364. tf103c_dock_toprow_event(dock, 4, &dock->last_press_0x13);
  365. return;
  366. case 0xb6:
  367. tf103c_dock_toprow_event(dock, 7, &dock->last_press_0x13);
  368. return;
  369. case 0xcd:
  370. tf103c_dock_toprow_event(dock, 8, &dock->last_press_0x13);
  371. return;
  372. case 0xb5:
  373. tf103c_dock_toprow_event(dock, 9, &dock->last_press_0x13);
  374. return;
  375. case 0xe2:
  376. tf103c_dock_toprow_event(dock, 10, &dock->last_press_0x13);
  377. return;
  378. case 0xea:
  379. tf103c_dock_toprow_event(dock, 11, &dock->last_press_0x13);
  380. return;
  381. case 0xe9:
  382. tf103c_dock_toprow_event(dock, 12, &dock->last_press_0x13);
  383. return;
  384. }
  385. break;
  386. case 0x14:
  387. if (size != 4)
  388. break;
  389. switch (buf[3]) {
  390. case 0:
  391. tf103c_dock_toprow_event(dock, -1, &dock->last_press_0x14);
  392. return;
  393. case 1:
  394. tf103c_dock_toprow_event(dock, 0, &dock->last_press_0x14);
  395. return;
  396. }
  397. break;
  398. }
  399. dev_warn(dev, "warning unknown kbd data: %*ph\n", size, buf);
  400. }
  401. /*** touchpad related code ***/
  402. static const struct property_entry tf103c_dock_touchpad_props[] = {
  403. PROPERTY_ENTRY_BOOL("elan,clickpad"),
  404. { }
  405. };
  406. static const struct software_node tf103c_dock_touchpad_sw_node = {
  407. .properties = tf103c_dock_touchpad_props,
  408. };
  409. /*
  410. * tf103c_enable_touchpad() is only called from the threaded interrupt handler
  411. * and tf103c_disable_touchpad() is only called after the irq is disabled,
  412. * so no locking is necessary.
  413. */
  414. static void tf103c_dock_enable_touchpad(struct tf103c_dock_data *dock)
  415. {
  416. struct i2c_board_info board_info = { };
  417. struct device *dev = &dock->ec_client->dev;
  418. int ret;
  419. if (dock->tp_enabled) {
  420. /* Happens after resume, the tp needs to be reinitialized */
  421. ret = device_reprobe(&dock->tp_client->dev);
  422. if (ret)
  423. dev_err_probe(dev, ret, "reprobing tp-client\n");
  424. return;
  425. }
  426. strscpy(board_info.type, "elan_i2c", I2C_NAME_SIZE);
  427. board_info.addr = TF103C_DOCK_TP_ADDR;
  428. board_info.dev_name = TF103C_DOCK_DEV_NAME "-tp";
  429. board_info.irq = dock->tp_irq;
  430. board_info.swnode = &tf103c_dock_touchpad_sw_node;
  431. dock->tp_client = i2c_new_client_device(dock->ec_client->adapter, &board_info);
  432. if (IS_ERR(dock->tp_client)) {
  433. dev_err(dev, "error %ld creating tp client\n", PTR_ERR(dock->tp_client));
  434. return;
  435. }
  436. dock->tp_enabled = true;
  437. }
  438. static void tf103c_dock_disable_touchpad(struct tf103c_dock_data *dock)
  439. {
  440. if (!dock->tp_enabled)
  441. return;
  442. i2c_unregister_device(dock->tp_client);
  443. dock->tp_enabled = false;
  444. }
  445. /*** interrupt handling code ***/
  446. static void tf103c_dock_ec_cmd(struct tf103c_dock_data *dock, const u8 *cmd)
  447. {
  448. struct device *dev = &dock->ec_client->dev;
  449. int ret;
  450. ret = i2c_smbus_write_i2c_block_data(dock->ec_client, TF103C_DOCK_EC_CMD_REG,
  451. TF103C_DOCK_EC_CMD_LEN, cmd);
  452. if (ret)
  453. dev_err(dev, "error %d sending %*ph cmd\n", ret,
  454. TF103C_DOCK_EC_CMD_LEN, cmd);
  455. }
  456. static void tf103c_dock_sci(struct tf103c_dock_data *dock, u8 val)
  457. {
  458. struct device *dev = &dock->ec_client->dev;
  459. switch (val) {
  460. case 2:
  461. tf103c_dock_toprow_event(dock, 1, NULL);
  462. return;
  463. case 4:
  464. tf103c_dock_toprow_event(dock, 2, NULL);
  465. return;
  466. case 8:
  467. tf103c_dock_toprow_event(dock, 5, NULL);
  468. return;
  469. case 17:
  470. tf103c_dock_toprow_event(dock, 6, NULL);
  471. return;
  472. }
  473. dev_warn(dev, "warning unknown SCI value: 0x%02x\n", val);
  474. }
  475. static void tf103c_dock_smi(struct tf103c_dock_data *dock, u8 val)
  476. {
  477. struct device *dev = &dock->ec_client->dev;
  478. switch (val) {
  479. case TF103C_DOCK_SMI_EC_WAKEUP:
  480. tf103c_dock_ec_cmd(dock, tf103c_dock_enable_cmd);
  481. tf103c_dock_ec_cmd(dock, tf103c_dock_usb_enable_cmd);
  482. tf103c_dock_kbd_write(dock, TF103C_DOCK_KBD_CMD_ENABLE);
  483. break;
  484. case TF103C_DOCK_SMI_PAD_BL_CHANGE:
  485. /* There is no backlight, but the EC still sends this */
  486. break;
  487. case TF103C_DOCK_SMI_HID_STATUS_CHANGED:
  488. tf103c_dock_enable_touchpad(dock);
  489. break;
  490. default:
  491. dev_warn(dev, "warning unknown SMI value: 0x%02x\n", val);
  492. break;
  493. }
  494. }
  495. static irqreturn_t tf103c_dock_irq(int irq, void *data)
  496. {
  497. struct tf103c_dock_data *dock = data;
  498. struct device *dev = &dock->ec_client->dev;
  499. u8 intr_data[8];
  500. int ret;
  501. ret = i2c_smbus_read_i2c_block_data(dock->intr_client, TF103C_DOCK_INTR_DATA_REG,
  502. sizeof(intr_data), intr_data);
  503. if (ret != sizeof(intr_data)) {
  504. dev_err(dev, "error %d reading intr data\n", ret);
  505. return IRQ_NONE;
  506. }
  507. if (!(intr_data[1] & TF103C_DOCK_INTR_DATA1_OBF_MASK))
  508. return IRQ_NONE;
  509. /* intr_data[0] is the length of the rest of the packet */
  510. if (intr_data[0] == 3 && intr_data[1] == TF103C_DOCK_INTR_DATA1_OOB_VALUE &&
  511. intr_data[2] == TF103C_DOCK_INTR_DATA2_OOB_VALUE) {
  512. /* intr_data[3] seems to contain a HID input report id */
  513. switch (intr_data[3]) {
  514. case 0x01:
  515. handle_nested_irq(dock->tp_irq);
  516. break;
  517. case 0x11:
  518. case 0x13:
  519. case 0x14:
  520. tf103c_dock_kbd_interrupt(dock);
  521. break;
  522. default:
  523. dev_warn(dev, "warning unknown intr_data[3]: 0x%02x\n", intr_data[3]);
  524. break;
  525. }
  526. return IRQ_HANDLED;
  527. }
  528. if (intr_data[1] & TF103C_DOCK_INTR_DATA1_SCI_MASK) {
  529. tf103c_dock_sci(dock, intr_data[2]);
  530. return IRQ_HANDLED;
  531. }
  532. if (intr_data[1] & TF103C_DOCK_INTR_DATA1_SMI_MASK) {
  533. tf103c_dock_smi(dock, intr_data[2]);
  534. return IRQ_HANDLED;
  535. }
  536. dev_warn(dev, "warning unknown intr data: %*ph\n", 8, intr_data);
  537. return IRQ_NONE;
  538. }
  539. /*
  540. * tf103c_dock_[dis|en]able only run from hpd_work or at times when
  541. * hpd_work cannot run (hpd_irq disabled), so no locking is necessary.
  542. */
  543. static void tf103c_dock_enable(struct tf103c_dock_data *dock)
  544. {
  545. if (dock->enabled)
  546. return;
  547. if (dock->board_rev != 2)
  548. gpiod_set_value(dock->pwr_en, 1);
  549. msleep(500);
  550. enable_irq(dock->irq);
  551. dock->enabled = true;
  552. }
  553. static void tf103c_dock_disable(struct tf103c_dock_data *dock)
  554. {
  555. if (!dock->enabled)
  556. return;
  557. disable_irq(dock->irq);
  558. tf103c_dock_disable_touchpad(dock);
  559. if (dock->board_rev != 2)
  560. gpiod_set_value(dock->pwr_en, 0);
  561. dock->enabled = false;
  562. }
  563. static void tf103c_dock_hpd_work(struct work_struct *work)
  564. {
  565. struct tf103c_dock_data *dock =
  566. container_of(work, struct tf103c_dock_data, hpd_work.work);
  567. if (gpiod_get_value(dock->hpd_gpio))
  568. tf103c_dock_enable(dock);
  569. else
  570. tf103c_dock_disable(dock);
  571. }
  572. static irqreturn_t tf103c_dock_hpd_irq(int irq, void *data)
  573. {
  574. struct tf103c_dock_data *dock = data;
  575. mod_delayed_work(system_long_wq, &dock->hpd_work, TF103C_DOCK_HPD_DEBOUNCE);
  576. return IRQ_HANDLED;
  577. }
  578. static void tf103c_dock_start_hpd(struct tf103c_dock_data *dock)
  579. {
  580. enable_irq(dock->hpd_irq);
  581. /* Sync current HPD status */
  582. queue_delayed_work(system_long_wq, &dock->hpd_work, TF103C_DOCK_HPD_DEBOUNCE);
  583. }
  584. static void tf103c_dock_stop_hpd(struct tf103c_dock_data *dock)
  585. {
  586. disable_irq(dock->hpd_irq);
  587. cancel_delayed_work_sync(&dock->hpd_work);
  588. }
  589. /*** probe ***/
  590. static const struct dmi_system_id tf103c_dock_dmi_ids[] = {
  591. {
  592. .matches = {
  593. DMI_MATCH(DMI_SYS_VENDOR, "ASUSTeK COMPUTER INC."),
  594. DMI_MATCH(DMI_PRODUCT_NAME, "TF103C"),
  595. },
  596. },
  597. { }
  598. };
  599. static void tf103c_dock_non_devm_cleanup(void *data)
  600. {
  601. struct tf103c_dock_data *dock = data;
  602. if (dock->tp_irq_domain)
  603. irq_domain_remove(dock->tp_irq_domain);
  604. if (!IS_ERR_OR_NULL(dock->hid))
  605. hid_destroy_device(dock->hid);
  606. i2c_unregister_device(dock->kbd_client);
  607. i2c_unregister_device(dock->intr_client);
  608. gpiod_remove_lookup_table(&tf103c_dock_gpios);
  609. }
  610. static int tf103c_dock_probe(struct i2c_client *client)
  611. {
  612. struct i2c_board_info board_info = { };
  613. struct device *dev = &client->dev;
  614. struct gpio_desc *board_rev_gpio;
  615. struct tf103c_dock_data *dock;
  616. enum gpiod_flags flags;
  617. int i, ret;
  618. /* GPIOs are hardcoded for the Asus TF103C, don't bind on other devs */
  619. if (!dmi_check_system(tf103c_dock_dmi_ids))
  620. return -ENODEV;
  621. dock = devm_kzalloc(dev, sizeof(*dock), GFP_KERNEL);
  622. if (!dock)
  623. return -ENOMEM;
  624. INIT_DELAYED_WORK(&dock->hpd_work, tf103c_dock_hpd_work);
  625. /* 1. Get GPIOs and their IRQs */
  626. gpiod_add_lookup_table(&tf103c_dock_gpios);
  627. ret = devm_add_action_or_reset(dev, tf103c_dock_non_devm_cleanup, dock);
  628. if (ret)
  629. return ret;
  630. /*
  631. * The pin is configured as input by default, use ASIS because otherwise
  632. * the gpio-crystalcove.c switches off the internal pull-down replacing
  633. * it with a pull-up.
  634. */
  635. board_rev_gpio = gpiod_get(dev, "board_rev", GPIOD_ASIS);
  636. if (IS_ERR(board_rev_gpio))
  637. return dev_err_probe(dev, PTR_ERR(board_rev_gpio), "requesting board_rev GPIO\n");
  638. dock->board_rev = gpiod_get_value_cansleep(board_rev_gpio) + 1;
  639. gpiod_put(board_rev_gpio);
  640. /*
  641. * The Android driver drives the dock-pwr-en pin high at probe for
  642. * revision 2 boards and then never touches it again?
  643. * This code has only been tested on a revision 1 board, so for now
  644. * just mimick what Android does on revision 2 boards.
  645. */
  646. flags = (dock->board_rev == 2) ? GPIOD_OUT_HIGH : GPIOD_OUT_LOW;
  647. dock->pwr_en = devm_gpiod_get(dev, "dock_pwr_en", flags);
  648. if (IS_ERR(dock->pwr_en))
  649. return dev_err_probe(dev, PTR_ERR(dock->pwr_en), "requesting pwr_en GPIO\n");
  650. dock->irq_gpio = devm_gpiod_get(dev, "dock_irq", GPIOD_IN);
  651. if (IS_ERR(dock->irq_gpio))
  652. return dev_err_probe(dev, PTR_ERR(dock->irq_gpio), "requesting IRQ GPIO\n");
  653. dock->irq = gpiod_to_irq(dock->irq_gpio);
  654. if (dock->irq < 0)
  655. return dev_err_probe(dev, dock->irq, "getting dock IRQ");
  656. ret = devm_request_threaded_irq(dev, dock->irq, NULL, tf103c_dock_irq,
  657. IRQF_TRIGGER_LOW | IRQF_ONESHOT | IRQF_NO_AUTOEN,
  658. "dock_irq", dock);
  659. if (ret)
  660. return dev_err_probe(dev, ret, "requesting dock IRQ");
  661. dock->hpd_gpio = devm_gpiod_get(dev, "dock_hpd", GPIOD_IN);
  662. if (IS_ERR(dock->hpd_gpio))
  663. return dev_err_probe(dev, PTR_ERR(dock->hpd_gpio), "requesting HPD GPIO\n");
  664. dock->hpd_irq = gpiod_to_irq(dock->hpd_gpio);
  665. if (dock->hpd_irq < 0)
  666. return dev_err_probe(dev, dock->hpd_irq, "getting HPD IRQ");
  667. ret = devm_request_irq(dev, dock->hpd_irq, tf103c_dock_hpd_irq,
  668. IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING | IRQF_NO_AUTOEN,
  669. "dock_hpd", dock);
  670. if (ret)
  671. return ret;
  672. /*
  673. * 2. Create I2C clients. The dock uses 4 different i2c addresses,
  674. * the ACPI NPCE69A node being probed points to the EC address.
  675. */
  676. dock->ec_client = client;
  677. strscpy(board_info.type, "tf103c-dock-intr", I2C_NAME_SIZE);
  678. board_info.addr = TF103C_DOCK_INTR_ADDR;
  679. board_info.dev_name = TF103C_DOCK_DEV_NAME "-intr";
  680. dock->intr_client = i2c_new_client_device(client->adapter, &board_info);
  681. if (IS_ERR(dock->intr_client))
  682. return dev_err_probe(dev, PTR_ERR(dock->intr_client), "creating intr client\n");
  683. strscpy(board_info.type, "tf103c-dock-kbd", I2C_NAME_SIZE);
  684. board_info.addr = TF103C_DOCK_KBD_ADDR;
  685. board_info.dev_name = TF103C_DOCK_DEV_NAME "-kbd";
  686. dock->kbd_client = i2c_new_client_device(client->adapter, &board_info);
  687. if (IS_ERR(dock->kbd_client))
  688. return dev_err_probe(dev, PTR_ERR(dock->kbd_client), "creating kbd client\n");
  689. /* 3. Create input_dev for the top row of the keyboard */
  690. dock->input = devm_input_allocate_device(dev);
  691. if (!dock->input)
  692. return -ENOMEM;
  693. dock->input->name = "Asus TF103C Dock Top Row Keys";
  694. dock->input->phys = dev_name(dev);
  695. dock->input->dev.parent = dev;
  696. dock->input->id.bustype = BUS_I2C;
  697. dock->input->id.vendor = /* USB_VENDOR_ID_ASUSTEK */
  698. dock->input->id.product = /* From TF-103-C */
  699. dock->input->id.version = 0x0100; /* 1.0 */
  700. for (i = 0; i < ARRAY_SIZE(tf103c_dock_toprow_codes); i++) {
  701. input_set_capability(dock->input, EV_KEY, tf103c_dock_toprow_codes[i][0]);
  702. input_set_capability(dock->input, EV_KEY, tf103c_dock_toprow_codes[i][1]);
  703. }
  704. input_set_capability(dock->input, EV_KEY, KEY_RIGHTALT);
  705. ret = input_register_device(dock->input);
  706. if (ret)
  707. return ret;
  708. /* 4. Create HID device for the keyboard */
  709. dock->hid = hid_allocate_device();
  710. if (IS_ERR(dock->hid))
  711. return dev_err_probe(dev, PTR_ERR(dock->hid), "allocating hid dev\n");
  712. dock->hid->driver_data = dock;
  713. dock->hid->ll_driver = &tf103c_dock_hid_ll_driver;
  714. dock->hid->dev.parent = &client->dev;
  715. dock->hid->bus = BUS_I2C;
  716. dock->hid->vendor = 0x0b05; /* USB_VENDOR_ID_ASUSTEK */
  717. dock->hid->product = 0x0103; /* From TF-103-C */
  718. dock->hid->version = 0x0100; /* 1.0 */
  719. strscpy(dock->hid->name, "Asus TF103C Dock Keyboard", sizeof(dock->hid->name));
  720. strscpy(dock->hid->phys, dev_name(dev), sizeof(dock->hid->phys));
  721. ret = hid_add_device(dock->hid);
  722. if (ret)
  723. return dev_err_probe(dev, ret, "adding hid dev\n");
  724. /* 5. Setup irqchip for touchpad IRQ pass-through */
  725. dock->tp_irqchip.name = KBUILD_MODNAME;
  726. dock->tp_irq_domain = irq_domain_add_linear(NULL, 1, &irq_domain_simple_ops, NULL);
  727. if (!dock->tp_irq_domain)
  728. return -ENOMEM;
  729. dock->tp_irq = irq_create_mapping(dock->tp_irq_domain, 0);
  730. if (!dock->tp_irq)
  731. return -ENOMEM;
  732. irq_set_chip_data(dock->tp_irq, dock);
  733. irq_set_chip_and_handler(dock->tp_irq, &dock->tp_irqchip, handle_simple_irq);
  734. irq_set_nested_thread(dock->tp_irq, true);
  735. irq_set_noprobe(dock->tp_irq);
  736. dev_info(dev, "Asus TF103C board-revision: %d\n", dock->board_rev);
  737. tf103c_dock_start_hpd(dock);
  738. device_init_wakeup(dev, true);
  739. i2c_set_clientdata(client, dock);
  740. return 0;
  741. }
  742. static void tf103c_dock_remove(struct i2c_client *client)
  743. {
  744. struct tf103c_dock_data *dock = i2c_get_clientdata(client);
  745. tf103c_dock_stop_hpd(dock);
  746. tf103c_dock_disable(dock);
  747. }
  748. static int __maybe_unused tf103c_dock_suspend(struct device *dev)
  749. {
  750. struct tf103c_dock_data *dock = dev_get_drvdata(dev);
  751. tf103c_dock_stop_hpd(dock);
  752. if (dock->enabled) {
  753. tf103c_dock_ec_cmd(dock, tf103c_dock_suspend_cmd);
  754. if (device_may_wakeup(dev))
  755. enable_irq_wake(dock->irq);
  756. }
  757. return 0;
  758. }
  759. static int __maybe_unused tf103c_dock_resume(struct device *dev)
  760. {
  761. struct tf103c_dock_data *dock = dev_get_drvdata(dev);
  762. if (dock->enabled) {
  763. if (device_may_wakeup(dev))
  764. disable_irq_wake(dock->irq);
  765. /* Don't try to resume if the dock was unplugged during suspend */
  766. if (gpiod_get_value(dock->hpd_gpio))
  767. tf103c_dock_ec_cmd(dock, tf103c_dock_enable_cmd);
  768. }
  769. tf103c_dock_start_hpd(dock);
  770. return 0;
  771. }
  772. static SIMPLE_DEV_PM_OPS(tf103c_dock_pm_ops, tf103c_dock_suspend, tf103c_dock_resume);
  773. static const struct acpi_device_id tf103c_dock_acpi_match[] = {
  774. {"NPCE69A"},
  775. { }
  776. };
  777. MODULE_DEVICE_TABLE(acpi, tf103c_dock_acpi_match);
  778. static struct i2c_driver tf103c_dock_driver = {
  779. .driver = {
  780. .name = "asus-tf103c-dock",
  781. .pm = &tf103c_dock_pm_ops,
  782. .acpi_match_table = tf103c_dock_acpi_match,
  783. },
  784. .probe_new = tf103c_dock_probe,
  785. .remove = tf103c_dock_remove,
  786. };
  787. module_i2c_driver(tf103c_dock_driver);
  788. MODULE_AUTHOR("Hans de Goede <[email protected]");
  789. MODULE_DESCRIPTION("X86 Android tablets DSDT fixups driver");
  790. MODULE_LICENSE("GPL");