elants_i2c.c 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275
  1. /*
  2. * Elan Microelectronics touch panels with I2C interface
  3. *
  4. * Copyright (C) 2014 Elan Microelectronics Corporation.
  5. * Scott Liu <scott.liu@emc.com.tw>
  6. *
  7. * This code is partly based on hid-multitouch.c:
  8. *
  9. * Copyright (c) 2010-2012 Stephane Chatty <chatty@enac.fr>
  10. * Copyright (c) 2010-2012 Benjamin Tissoires <benjamin.tissoires@gmail.com>
  11. * Copyright (c) 2010-2012 Ecole Nationale de l'Aviation Civile, France
  12. *
  13. *
  14. * This code is partly based on i2c-hid.c:
  15. *
  16. * Copyright (c) 2012 Benjamin Tissoires <benjamin.tissoires@gmail.com>
  17. * Copyright (c) 2012 Ecole Nationale de l'Aviation Civile, France
  18. * Copyright (c) 2012 Red Hat, Inc
  19. */
  20. /*
  21. * This software is licensed under the terms of the GNU General Public
  22. * License version 2, as published by the Free Software Foundation, and
  23. * may be copied, distributed, and modified under those terms.
  24. */
  25. #include <linux/module.h>
  26. #include <linux/input.h>
  27. #include <linux/interrupt.h>
  28. #include <linux/platform_device.h>
  29. #include <linux/async.h>
  30. #include <linux/i2c.h>
  31. #include <linux/delay.h>
  32. #include <linux/uaccess.h>
  33. #include <linux/buffer_head.h>
  34. #include <linux/slab.h>
  35. #include <linux/firmware.h>
  36. #include <linux/input/mt.h>
  37. #include <linux/acpi.h>
  38. #include <linux/of.h>
  39. #include <asm/unaligned.h>
  40. /* Device, Driver information */
  41. #define DEVICE_NAME "elants_i2c"
  42. #define DRV_VERSION "1.0.9"
  43. /* Convert from rows or columns into resolution */
  44. #define ELAN_TS_RESOLUTION(n, m) (((n) - 1) * (m))
  45. /* FW header data */
  46. #define HEADER_SIZE 4
  47. #define FW_HDR_TYPE 0
  48. #define FW_HDR_COUNT 1
  49. #define FW_HDR_LENGTH 2
  50. /* Buffer mode Queue Header information */
  51. #define QUEUE_HEADER_SINGLE 0x62
  52. #define QUEUE_HEADER_NORMAL 0X63
  53. #define QUEUE_HEADER_WAIT 0x64
  54. /* Command header definition */
  55. #define CMD_HEADER_WRITE 0x54
  56. #define CMD_HEADER_READ 0x53
  57. #define CMD_HEADER_6B_READ 0x5B
  58. #define CMD_HEADER_RESP 0x52
  59. #define CMD_HEADER_6B_RESP 0x9B
  60. #define CMD_HEADER_HELLO 0x55
  61. #define CMD_HEADER_REK 0x66
  62. /* FW position data */
  63. #define PACKET_SIZE 55
  64. #define MAX_CONTACT_NUM 10
  65. #define FW_POS_HEADER 0
  66. #define FW_POS_STATE 1
  67. #define FW_POS_TOTAL 2
  68. #define FW_POS_XY 3
  69. #define FW_POS_CHECKSUM 34
  70. #define FW_POS_WIDTH 35
  71. #define FW_POS_PRESSURE 45
  72. #define HEADER_REPORT_10_FINGER 0x62
  73. /* Header (4 bytes) plus 3 fill 10-finger packets */
  74. #define MAX_PACKET_SIZE 169
  75. #define BOOT_TIME_DELAY_MS 50
  76. /* FW read command, 0x53 0x?? 0x0, 0x01 */
  77. #define E_ELAN_INFO_FW_VER 0x00
  78. #define E_ELAN_INFO_BC_VER 0x10
  79. #define E_ELAN_INFO_TEST_VER 0xE0
  80. #define E_ELAN_INFO_FW_ID 0xF0
  81. #define E_INFO_OSR 0xD6
  82. #define E_INFO_PHY_SCAN 0xD7
  83. #define E_INFO_PHY_DRIVER 0xD8
  84. #define MAX_RETRIES 3
  85. #define MAX_FW_UPDATE_RETRIES 30
  86. #define ELAN_FW_PAGESIZE 132
  87. /* calibration timeout definition */
  88. #define ELAN_CALI_TIMEOUT_MSEC 10000
  89. enum elants_state {
  90. ELAN_STATE_NORMAL,
  91. ELAN_WAIT_QUEUE_HEADER,
  92. ELAN_WAIT_RECALIBRATION,
  93. };
  94. enum elants_iap_mode {
  95. ELAN_IAP_OPERATIONAL,
  96. ELAN_IAP_RECOVERY,
  97. };
  98. /* struct elants_data - represents state of Elan touchscreen device */
  99. struct elants_data {
  100. struct i2c_client *client;
  101. struct input_dev *input;
  102. u16 fw_version;
  103. u8 test_version;
  104. u8 solution_version;
  105. u8 bc_version;
  106. u8 iap_version;
  107. u16 hw_version;
  108. unsigned int x_res; /* resolution in units/mm */
  109. unsigned int y_res;
  110. unsigned int x_max;
  111. unsigned int y_max;
  112. enum elants_state state;
  113. enum elants_iap_mode iap_mode;
  114. /* Guards against concurrent access to the device via sysfs */
  115. struct mutex sysfs_mutex;
  116. u8 cmd_resp[HEADER_SIZE];
  117. struct completion cmd_done;
  118. u8 buf[MAX_PACKET_SIZE];
  119. bool wake_irq_enabled;
  120. };
  121. static int elants_i2c_send(struct i2c_client *client,
  122. const void *data, size_t size)
  123. {
  124. int ret;
  125. ret = i2c_master_send(client, data, size);
  126. if (ret == size)
  127. return 0;
  128. if (ret >= 0)
  129. ret = -EIO;
  130. dev_err(&client->dev, "%s failed (%*ph): %d\n",
  131. __func__, (int)size, data, ret);
  132. return ret;
  133. }
  134. static int elants_i2c_read(struct i2c_client *client, void *data, size_t size)
  135. {
  136. int ret;
  137. ret = i2c_master_recv(client, data, size);
  138. if (ret == size)
  139. return 0;
  140. if (ret >= 0)
  141. ret = -EIO;
  142. dev_err(&client->dev, "%s failed: %d\n", __func__, ret);
  143. return ret;
  144. }
  145. static int elants_i2c_execute_command(struct i2c_client *client,
  146. const u8 *cmd, size_t cmd_size,
  147. u8 *resp, size_t resp_size)
  148. {
  149. struct i2c_msg msgs[2];
  150. int ret;
  151. u8 expected_response;
  152. switch (cmd[0]) {
  153. case CMD_HEADER_READ:
  154. expected_response = CMD_HEADER_RESP;
  155. break;
  156. case CMD_HEADER_6B_READ:
  157. expected_response = CMD_HEADER_6B_RESP;
  158. break;
  159. default:
  160. dev_err(&client->dev, "%s: invalid command %*ph\n",
  161. __func__, (int)cmd_size, cmd);
  162. return -EINVAL;
  163. }
  164. msgs[0].addr = client->addr;
  165. msgs[0].flags = client->flags & I2C_M_TEN;
  166. msgs[0].len = cmd_size;
  167. msgs[0].buf = (u8 *)cmd;
  168. msgs[1].addr = client->addr;
  169. msgs[1].flags = client->flags & I2C_M_TEN;
  170. msgs[1].flags |= I2C_M_RD;
  171. msgs[1].len = resp_size;
  172. msgs[1].buf = resp;
  173. ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
  174. if (ret < 0)
  175. return ret;
  176. if (ret != ARRAY_SIZE(msgs) || resp[FW_HDR_TYPE] != expected_response)
  177. return -EIO;
  178. return 0;
  179. }
  180. static int elants_i2c_calibrate(struct elants_data *ts)
  181. {
  182. struct i2c_client *client = ts->client;
  183. int ret, error;
  184. static const u8 w_flashkey[] = { 0x54, 0xC0, 0xE1, 0x5A };
  185. static const u8 rek[] = { 0x54, 0x29, 0x00, 0x01 };
  186. static const u8 rek_resp[] = { CMD_HEADER_REK, 0x66, 0x66, 0x66 };
  187. disable_irq(client->irq);
  188. ts->state = ELAN_WAIT_RECALIBRATION;
  189. reinit_completion(&ts->cmd_done);
  190. elants_i2c_send(client, w_flashkey, sizeof(w_flashkey));
  191. elants_i2c_send(client, rek, sizeof(rek));
  192. enable_irq(client->irq);
  193. ret = wait_for_completion_interruptible_timeout(&ts->cmd_done,
  194. msecs_to_jiffies(ELAN_CALI_TIMEOUT_MSEC));
  195. ts->state = ELAN_STATE_NORMAL;
  196. if (ret <= 0) {
  197. error = ret < 0 ? ret : -ETIMEDOUT;
  198. dev_err(&client->dev,
  199. "error while waiting for calibration to complete: %d\n",
  200. error);
  201. return error;
  202. }
  203. if (memcmp(rek_resp, ts->cmd_resp, sizeof(rek_resp))) {
  204. dev_err(&client->dev,
  205. "unexpected calibration response: %*ph\n",
  206. (int)sizeof(ts->cmd_resp), ts->cmd_resp);
  207. return -EINVAL;
  208. }
  209. return 0;
  210. }
  211. static int elants_i2c_sw_reset(struct i2c_client *client)
  212. {
  213. const u8 soft_rst_cmd[] = { 0x77, 0x77, 0x77, 0x77 };
  214. int error;
  215. error = elants_i2c_send(client, soft_rst_cmd,
  216. sizeof(soft_rst_cmd));
  217. if (error) {
  218. dev_err(&client->dev, "software reset failed: %d\n", error);
  219. return error;
  220. }
  221. /*
  222. * We should wait at least 10 msec (but no more than 40) before
  223. * sending fastboot or IAP command to the device.
  224. */
  225. msleep(30);
  226. return 0;
  227. }
  228. static u16 elants_i2c_parse_version(u8 *buf)
  229. {
  230. return get_unaligned_be32(buf) >> 4;
  231. }
  232. static int elants_i2c_query_fw_id(struct elants_data *ts)
  233. {
  234. struct i2c_client *client = ts->client;
  235. int error, retry_cnt;
  236. const u8 cmd[] = { CMD_HEADER_READ, E_ELAN_INFO_FW_ID, 0x00, 0x01 };
  237. u8 resp[HEADER_SIZE];
  238. for (retry_cnt = 0; retry_cnt < MAX_RETRIES; retry_cnt++) {
  239. error = elants_i2c_execute_command(client, cmd, sizeof(cmd),
  240. resp, sizeof(resp));
  241. if (!error) {
  242. ts->hw_version = elants_i2c_parse_version(resp);
  243. if (ts->hw_version != 0xffff)
  244. return 0;
  245. }
  246. dev_dbg(&client->dev, "read fw id error=%d, buf=%*phC\n",
  247. error, (int)sizeof(resp), resp);
  248. }
  249. dev_err(&client->dev,
  250. "Failed to read fw id or fw id is invalid\n");
  251. return -EINVAL;
  252. }
  253. static int elants_i2c_query_fw_version(struct elants_data *ts)
  254. {
  255. struct i2c_client *client = ts->client;
  256. int error, retry_cnt;
  257. const u8 cmd[] = { CMD_HEADER_READ, E_ELAN_INFO_FW_VER, 0x00, 0x01 };
  258. u8 resp[HEADER_SIZE];
  259. for (retry_cnt = 0; retry_cnt < MAX_RETRIES; retry_cnt++) {
  260. error = elants_i2c_execute_command(client, cmd, sizeof(cmd),
  261. resp, sizeof(resp));
  262. if (!error) {
  263. ts->fw_version = elants_i2c_parse_version(resp);
  264. if (ts->fw_version != 0x0000 &&
  265. ts->fw_version != 0xffff)
  266. return 0;
  267. }
  268. dev_dbg(&client->dev, "read fw version error=%d, buf=%*phC\n",
  269. error, (int)sizeof(resp), resp);
  270. }
  271. dev_err(&client->dev,
  272. "Failed to read fw version or fw version is invalid\n");
  273. return -EINVAL;
  274. }
  275. static int elants_i2c_query_test_version(struct elants_data *ts)
  276. {
  277. struct i2c_client *client = ts->client;
  278. int error, retry_cnt;
  279. u16 version;
  280. const u8 cmd[] = { CMD_HEADER_READ, E_ELAN_INFO_TEST_VER, 0x00, 0x01 };
  281. u8 resp[HEADER_SIZE];
  282. for (retry_cnt = 0; retry_cnt < MAX_RETRIES; retry_cnt++) {
  283. error = elants_i2c_execute_command(client, cmd, sizeof(cmd),
  284. resp, sizeof(resp));
  285. if (!error) {
  286. version = elants_i2c_parse_version(resp);
  287. ts->test_version = version >> 8;
  288. ts->solution_version = version & 0xff;
  289. return 0;
  290. }
  291. dev_dbg(&client->dev,
  292. "read test version error rc=%d, buf=%*phC\n",
  293. error, (int)sizeof(resp), resp);
  294. }
  295. dev_err(&client->dev, "Failed to read test version\n");
  296. return -EINVAL;
  297. }
  298. static int elants_i2c_query_bc_version(struct elants_data *ts)
  299. {
  300. struct i2c_client *client = ts->client;
  301. const u8 cmd[] = { CMD_HEADER_READ, E_ELAN_INFO_BC_VER, 0x00, 0x01 };
  302. u8 resp[HEADER_SIZE];
  303. u16 version;
  304. int error;
  305. error = elants_i2c_execute_command(client, cmd, sizeof(cmd),
  306. resp, sizeof(resp));
  307. if (error) {
  308. dev_err(&client->dev,
  309. "read BC version error=%d, buf=%*phC\n",
  310. error, (int)sizeof(resp), resp);
  311. return error;
  312. }
  313. version = elants_i2c_parse_version(resp);
  314. ts->bc_version = version >> 8;
  315. ts->iap_version = version & 0xff;
  316. return 0;
  317. }
  318. static int elants_i2c_query_ts_info(struct elants_data *ts)
  319. {
  320. struct i2c_client *client = ts->client;
  321. int error;
  322. u8 resp[17];
  323. u16 phy_x, phy_y, rows, cols, osr;
  324. const u8 get_resolution_cmd[] = {
  325. CMD_HEADER_6B_READ, 0x00, 0x00, 0x00, 0x00, 0x00
  326. };
  327. const u8 get_osr_cmd[] = {
  328. CMD_HEADER_READ, E_INFO_OSR, 0x00, 0x01
  329. };
  330. const u8 get_physical_scan_cmd[] = {
  331. CMD_HEADER_READ, E_INFO_PHY_SCAN, 0x00, 0x01
  332. };
  333. const u8 get_physical_drive_cmd[] = {
  334. CMD_HEADER_READ, E_INFO_PHY_DRIVER, 0x00, 0x01
  335. };
  336. /* Get trace number */
  337. error = elants_i2c_execute_command(client,
  338. get_resolution_cmd,
  339. sizeof(get_resolution_cmd),
  340. resp, sizeof(resp));
  341. if (error) {
  342. dev_err(&client->dev, "get resolution command failed: %d\n",
  343. error);
  344. return error;
  345. }
  346. rows = resp[2] + resp[6] + resp[10];
  347. cols = resp[3] + resp[7] + resp[11];
  348. /* Process mm_to_pixel information */
  349. error = elants_i2c_execute_command(client,
  350. get_osr_cmd, sizeof(get_osr_cmd),
  351. resp, sizeof(resp));
  352. if (error) {
  353. dev_err(&client->dev, "get osr command failed: %d\n",
  354. error);
  355. return error;
  356. }
  357. osr = resp[3];
  358. error = elants_i2c_execute_command(client,
  359. get_physical_scan_cmd,
  360. sizeof(get_physical_scan_cmd),
  361. resp, sizeof(resp));
  362. if (error) {
  363. dev_err(&client->dev, "get physical scan command failed: %d\n",
  364. error);
  365. return error;
  366. }
  367. phy_x = get_unaligned_be16(&resp[2]);
  368. error = elants_i2c_execute_command(client,
  369. get_physical_drive_cmd,
  370. sizeof(get_physical_drive_cmd),
  371. resp, sizeof(resp));
  372. if (error) {
  373. dev_err(&client->dev, "get physical drive command failed: %d\n",
  374. error);
  375. return error;
  376. }
  377. phy_y = get_unaligned_be16(&resp[2]);
  378. dev_dbg(&client->dev, "phy_x=%d, phy_y=%d\n", phy_x, phy_y);
  379. if (rows == 0 || cols == 0 || osr == 0) {
  380. dev_warn(&client->dev,
  381. "invalid trace number data: %d, %d, %d\n",
  382. rows, cols, osr);
  383. } else {
  384. /* translate trace number to TS resolution */
  385. ts->x_max = ELAN_TS_RESOLUTION(rows, osr);
  386. ts->x_res = DIV_ROUND_CLOSEST(ts->x_max, phy_x);
  387. ts->y_max = ELAN_TS_RESOLUTION(cols, osr);
  388. ts->y_res = DIV_ROUND_CLOSEST(ts->y_max, phy_y);
  389. }
  390. return 0;
  391. }
  392. static int elants_i2c_fastboot(struct i2c_client *client)
  393. {
  394. const u8 boot_cmd[] = { 0x4D, 0x61, 0x69, 0x6E };
  395. int error;
  396. error = elants_i2c_send(client, boot_cmd, sizeof(boot_cmd));
  397. if (error) {
  398. dev_err(&client->dev, "boot failed: %d\n", error);
  399. return error;
  400. }
  401. dev_dbg(&client->dev, "boot success -- 0x%x\n", client->addr);
  402. return 0;
  403. }
  404. static int elants_i2c_initialize(struct elants_data *ts)
  405. {
  406. struct i2c_client *client = ts->client;
  407. int error, retry_cnt;
  408. const u8 hello_packet[] = { 0x55, 0x55, 0x55, 0x55 };
  409. const u8 recov_packet[] = { 0x55, 0x55, 0x80, 0x80 };
  410. u8 buf[HEADER_SIZE];
  411. for (retry_cnt = 0; retry_cnt < MAX_RETRIES; retry_cnt++) {
  412. error = elants_i2c_sw_reset(client);
  413. if (error) {
  414. /* Continue initializing if it's the last try */
  415. if (retry_cnt < MAX_RETRIES - 1)
  416. continue;
  417. }
  418. error = elants_i2c_fastboot(client);
  419. if (error) {
  420. /* Continue initializing if it's the last try */
  421. if (retry_cnt < MAX_RETRIES - 1)
  422. continue;
  423. }
  424. /* Wait for Hello packet */
  425. msleep(BOOT_TIME_DELAY_MS);
  426. error = elants_i2c_read(client, buf, sizeof(buf));
  427. if (error) {
  428. dev_err(&client->dev,
  429. "failed to read 'hello' packet: %d\n", error);
  430. } else if (!memcmp(buf, hello_packet, sizeof(hello_packet))) {
  431. ts->iap_mode = ELAN_IAP_OPERATIONAL;
  432. break;
  433. } else if (!memcmp(buf, recov_packet, sizeof(recov_packet))) {
  434. /*
  435. * Setting error code will mark device
  436. * in recovery mode below.
  437. */
  438. error = -EIO;
  439. break;
  440. } else {
  441. error = -EINVAL;
  442. dev_err(&client->dev,
  443. "invalid 'hello' packet: %*ph\n",
  444. (int)sizeof(buf), buf);
  445. }
  446. }
  447. if (!error)
  448. error = elants_i2c_query_fw_id(ts);
  449. if (!error)
  450. error = elants_i2c_query_fw_version(ts);
  451. if (error) {
  452. ts->iap_mode = ELAN_IAP_RECOVERY;
  453. } else {
  454. elants_i2c_query_test_version(ts);
  455. elants_i2c_query_bc_version(ts);
  456. elants_i2c_query_ts_info(ts);
  457. }
  458. return 0;
  459. }
  460. /*
  461. * Firmware update interface.
  462. */
  463. static int elants_i2c_fw_write_page(struct i2c_client *client,
  464. const void *page)
  465. {
  466. const u8 ack_ok[] = { 0xaa, 0xaa };
  467. u8 buf[2];
  468. int retry;
  469. int error;
  470. for (retry = 0; retry < MAX_FW_UPDATE_RETRIES; retry++) {
  471. error = elants_i2c_send(client, page, ELAN_FW_PAGESIZE);
  472. if (error) {
  473. dev_err(&client->dev,
  474. "IAP Write Page failed: %d\n", error);
  475. continue;
  476. }
  477. error = elants_i2c_read(client, buf, 2);
  478. if (error) {
  479. dev_err(&client->dev,
  480. "IAP Ack read failed: %d\n", error);
  481. return error;
  482. }
  483. if (!memcmp(buf, ack_ok, sizeof(ack_ok)))
  484. return 0;
  485. error = -EIO;
  486. dev_err(&client->dev,
  487. "IAP Get Ack Error [%02x:%02x]\n",
  488. buf[0], buf[1]);
  489. }
  490. return error;
  491. }
  492. static int elants_i2c_do_update_firmware(struct i2c_client *client,
  493. const struct firmware *fw,
  494. bool force)
  495. {
  496. const u8 enter_iap[] = { 0x45, 0x49, 0x41, 0x50 };
  497. const u8 enter_iap2[] = { 0x54, 0x00, 0x12, 0x34 };
  498. const u8 iap_ack[] = { 0x55, 0xaa, 0x33, 0xcc };
  499. u8 buf[HEADER_SIZE];
  500. u16 send_id;
  501. int page, n_fw_pages;
  502. int error;
  503. /* Recovery mode detection! */
  504. if (force) {
  505. dev_dbg(&client->dev, "Recovery mode procedure\n");
  506. error = elants_i2c_send(client, enter_iap2, sizeof(enter_iap2));
  507. } else {
  508. /* Start IAP Procedure */
  509. dev_dbg(&client->dev, "Normal IAP procedure\n");
  510. elants_i2c_sw_reset(client);
  511. error = elants_i2c_send(client, enter_iap, sizeof(enter_iap));
  512. }
  513. if (error) {
  514. dev_err(&client->dev, "failed to enter IAP mode: %d\n", error);
  515. return error;
  516. }
  517. msleep(20);
  518. /* check IAP state */
  519. error = elants_i2c_read(client, buf, 4);
  520. if (error) {
  521. dev_err(&client->dev,
  522. "failed to read IAP acknowledgement: %d\n",
  523. error);
  524. return error;
  525. }
  526. if (memcmp(buf, iap_ack, sizeof(iap_ack))) {
  527. dev_err(&client->dev,
  528. "failed to enter IAP: %*ph (expected %*ph)\n",
  529. (int)sizeof(buf), buf, (int)sizeof(iap_ack), iap_ack);
  530. return -EIO;
  531. }
  532. dev_info(&client->dev, "successfully entered IAP mode");
  533. send_id = client->addr;
  534. error = elants_i2c_send(client, &send_id, 1);
  535. if (error) {
  536. dev_err(&client->dev, "sending dummy byte failed: %d\n",
  537. error);
  538. return error;
  539. }
  540. /* Clear the last page of Master */
  541. error = elants_i2c_send(client, fw->data, ELAN_FW_PAGESIZE);
  542. if (error) {
  543. dev_err(&client->dev, "clearing of the last page failed: %d\n",
  544. error);
  545. return error;
  546. }
  547. error = elants_i2c_read(client, buf, 2);
  548. if (error) {
  549. dev_err(&client->dev,
  550. "failed to read ACK for clearing the last page: %d\n",
  551. error);
  552. return error;
  553. }
  554. n_fw_pages = fw->size / ELAN_FW_PAGESIZE;
  555. dev_dbg(&client->dev, "IAP Pages = %d\n", n_fw_pages);
  556. for (page = 0; page < n_fw_pages; page++) {
  557. error = elants_i2c_fw_write_page(client,
  558. fw->data + page * ELAN_FW_PAGESIZE);
  559. if (error) {
  560. dev_err(&client->dev,
  561. "failed to write FW page %d: %d\n",
  562. page, error);
  563. return error;
  564. }
  565. }
  566. /* Old iap needs to wait 200ms for WDT and rest is for hello packets */
  567. msleep(300);
  568. dev_info(&client->dev, "firmware update completed\n");
  569. return 0;
  570. }
  571. static int elants_i2c_fw_update(struct elants_data *ts)
  572. {
  573. struct i2c_client *client = ts->client;
  574. const struct firmware *fw;
  575. char *fw_name;
  576. int error;
  577. fw_name = kasprintf(GFP_KERNEL, "elants_i2c_%04x.bin", ts->hw_version);
  578. if (!fw_name)
  579. return -ENOMEM;
  580. dev_info(&client->dev, "requesting fw name = %s\n", fw_name);
  581. error = request_firmware(&fw, fw_name, &client->dev);
  582. kfree(fw_name);
  583. if (error) {
  584. dev_err(&client->dev, "failed to request firmware: %d\n",
  585. error);
  586. return error;
  587. }
  588. if (fw->size % ELAN_FW_PAGESIZE) {
  589. dev_err(&client->dev, "invalid firmware length: %zu\n",
  590. fw->size);
  591. error = -EINVAL;
  592. goto out;
  593. }
  594. disable_irq(client->irq);
  595. error = elants_i2c_do_update_firmware(client, fw,
  596. ts->iap_mode == ELAN_IAP_RECOVERY);
  597. if (error) {
  598. dev_err(&client->dev, "firmware update failed: %d\n", error);
  599. ts->iap_mode = ELAN_IAP_RECOVERY;
  600. goto out_enable_irq;
  601. }
  602. error = elants_i2c_initialize(ts);
  603. if (error) {
  604. dev_err(&client->dev,
  605. "failed to initialize device after firmware update: %d\n",
  606. error);
  607. ts->iap_mode = ELAN_IAP_RECOVERY;
  608. goto out_enable_irq;
  609. }
  610. ts->iap_mode = ELAN_IAP_OPERATIONAL;
  611. out_enable_irq:
  612. ts->state = ELAN_STATE_NORMAL;
  613. enable_irq(client->irq);
  614. msleep(100);
  615. if (!error)
  616. elants_i2c_calibrate(ts);
  617. out:
  618. release_firmware(fw);
  619. return error;
  620. }
  621. /*
  622. * Event reporting.
  623. */
  624. static void elants_i2c_mt_event(struct elants_data *ts, u8 *buf)
  625. {
  626. struct input_dev *input = ts->input;
  627. unsigned int n_fingers;
  628. u16 finger_state;
  629. int i;
  630. n_fingers = buf[FW_POS_STATE + 1] & 0x0f;
  631. finger_state = ((buf[FW_POS_STATE + 1] & 0x30) << 4) |
  632. buf[FW_POS_STATE];
  633. dev_dbg(&ts->client->dev,
  634. "n_fingers: %u, state: %04x\n", n_fingers, finger_state);
  635. for (i = 0; i < MAX_CONTACT_NUM && n_fingers; i++) {
  636. if (finger_state & 1) {
  637. unsigned int x, y, p, w;
  638. u8 *pos;
  639. pos = &buf[FW_POS_XY + i * 3];
  640. x = (((u16)pos[0] & 0xf0) << 4) | pos[1];
  641. y = (((u16)pos[0] & 0x0f) << 8) | pos[2];
  642. p = buf[FW_POS_PRESSURE + i];
  643. w = buf[FW_POS_WIDTH + i];
  644. dev_dbg(&ts->client->dev, "i=%d x=%d y=%d p=%d w=%d\n",
  645. i, x, y, p, w);
  646. input_mt_slot(input, i);
  647. input_mt_report_slot_state(input, MT_TOOL_FINGER, true);
  648. input_event(input, EV_ABS, ABS_MT_POSITION_X, x);
  649. input_event(input, EV_ABS, ABS_MT_POSITION_Y, y);
  650. input_event(input, EV_ABS, ABS_MT_PRESSURE, p);
  651. input_event(input, EV_ABS, ABS_MT_TOUCH_MAJOR, w);
  652. n_fingers--;
  653. }
  654. finger_state >>= 1;
  655. }
  656. input_mt_sync_frame(input);
  657. input_sync(input);
  658. }
  659. static u8 elants_i2c_calculate_checksum(u8 *buf)
  660. {
  661. u8 checksum = 0;
  662. u8 i;
  663. for (i = 0; i < FW_POS_CHECKSUM; i++)
  664. checksum += buf[i];
  665. return checksum;
  666. }
  667. static void elants_i2c_event(struct elants_data *ts, u8 *buf)
  668. {
  669. u8 checksum = elants_i2c_calculate_checksum(buf);
  670. if (unlikely(buf[FW_POS_CHECKSUM] != checksum))
  671. dev_warn(&ts->client->dev,
  672. "%s: invalid checksum for packet %02x: %02x vs. %02x\n",
  673. __func__, buf[FW_POS_HEADER],
  674. checksum, buf[FW_POS_CHECKSUM]);
  675. else if (unlikely(buf[FW_POS_HEADER] != HEADER_REPORT_10_FINGER))
  676. dev_warn(&ts->client->dev,
  677. "%s: unknown packet type: %02x\n",
  678. __func__, buf[FW_POS_HEADER]);
  679. else
  680. elants_i2c_mt_event(ts, buf);
  681. }
  682. static irqreturn_t elants_i2c_irq(int irq, void *_dev)
  683. {
  684. const u8 wait_packet[] = { 0x64, 0x64, 0x64, 0x64 };
  685. struct elants_data *ts = _dev;
  686. struct i2c_client *client = ts->client;
  687. int report_count, report_len;
  688. int i;
  689. int len;
  690. len = i2c_master_recv(client, ts->buf, sizeof(ts->buf));
  691. if (len < 0) {
  692. dev_err(&client->dev, "%s: failed to read data: %d\n",
  693. __func__, len);
  694. goto out;
  695. }
  696. dev_dbg(&client->dev, "%s: packet %*ph\n",
  697. __func__, HEADER_SIZE, ts->buf);
  698. switch (ts->state) {
  699. case ELAN_WAIT_RECALIBRATION:
  700. if (ts->buf[FW_HDR_TYPE] == CMD_HEADER_REK) {
  701. memcpy(ts->cmd_resp, ts->buf, sizeof(ts->cmd_resp));
  702. complete(&ts->cmd_done);
  703. ts->state = ELAN_STATE_NORMAL;
  704. }
  705. break;
  706. case ELAN_WAIT_QUEUE_HEADER:
  707. if (ts->buf[FW_HDR_TYPE] != QUEUE_HEADER_NORMAL)
  708. break;
  709. ts->state = ELAN_STATE_NORMAL;
  710. /* fall through */
  711. case ELAN_STATE_NORMAL:
  712. switch (ts->buf[FW_HDR_TYPE]) {
  713. case CMD_HEADER_HELLO:
  714. case CMD_HEADER_RESP:
  715. case CMD_HEADER_REK:
  716. break;
  717. case QUEUE_HEADER_WAIT:
  718. if (memcmp(ts->buf, wait_packet, sizeof(wait_packet))) {
  719. dev_err(&client->dev,
  720. "invalid wait packet %*ph\n",
  721. HEADER_SIZE, ts->buf);
  722. } else {
  723. ts->state = ELAN_WAIT_QUEUE_HEADER;
  724. udelay(30);
  725. }
  726. break;
  727. case QUEUE_HEADER_SINGLE:
  728. elants_i2c_event(ts, &ts->buf[HEADER_SIZE]);
  729. break;
  730. case QUEUE_HEADER_NORMAL:
  731. report_count = ts->buf[FW_HDR_COUNT];
  732. if (report_count > 3) {
  733. dev_err(&client->dev,
  734. "too large report count: %*ph\n",
  735. HEADER_SIZE, ts->buf);
  736. break;
  737. }
  738. report_len = ts->buf[FW_HDR_LENGTH] / report_count;
  739. if (report_len != PACKET_SIZE) {
  740. dev_err(&client->dev,
  741. "mismatching report length: %*ph\n",
  742. HEADER_SIZE, ts->buf);
  743. break;
  744. }
  745. for (i = 0; i < report_count; i++) {
  746. u8 *buf = ts->buf + HEADER_SIZE +
  747. i * PACKET_SIZE;
  748. elants_i2c_event(ts, buf);
  749. }
  750. break;
  751. default:
  752. dev_err(&client->dev, "unknown packet %*ph\n",
  753. HEADER_SIZE, ts->buf);
  754. break;
  755. }
  756. break;
  757. }
  758. out:
  759. return IRQ_HANDLED;
  760. }
  761. /*
  762. * sysfs interface
  763. */
  764. static ssize_t calibrate_store(struct device *dev,
  765. struct device_attribute *attr,
  766. const char *buf, size_t count)
  767. {
  768. struct i2c_client *client = to_i2c_client(dev);
  769. struct elants_data *ts = i2c_get_clientdata(client);
  770. int error;
  771. error = mutex_lock_interruptible(&ts->sysfs_mutex);
  772. if (error)
  773. return error;
  774. error = elants_i2c_calibrate(ts);
  775. mutex_unlock(&ts->sysfs_mutex);
  776. return error ?: count;
  777. }
  778. static ssize_t write_update_fw(struct device *dev,
  779. struct device_attribute *attr,
  780. const char *buf, size_t count)
  781. {
  782. struct i2c_client *client = to_i2c_client(dev);
  783. struct elants_data *ts = i2c_get_clientdata(client);
  784. int error;
  785. error = mutex_lock_interruptible(&ts->sysfs_mutex);
  786. if (error)
  787. return error;
  788. error = elants_i2c_fw_update(ts);
  789. dev_dbg(dev, "firmware update result: %d\n", error);
  790. mutex_unlock(&ts->sysfs_mutex);
  791. return error ?: count;
  792. }
  793. static ssize_t show_iap_mode(struct device *dev,
  794. struct device_attribute *attr, char *buf)
  795. {
  796. struct i2c_client *client = to_i2c_client(dev);
  797. struct elants_data *ts = i2c_get_clientdata(client);
  798. return sprintf(buf, "%s\n",
  799. ts->iap_mode == ELAN_IAP_OPERATIONAL ?
  800. "Normal" : "Recovery");
  801. }
  802. static DEVICE_ATTR(calibrate, S_IWUSR, NULL, calibrate_store);
  803. static DEVICE_ATTR(iap_mode, S_IRUGO, show_iap_mode, NULL);
  804. static DEVICE_ATTR(update_fw, S_IWUSR, NULL, write_update_fw);
  805. struct elants_version_attribute {
  806. struct device_attribute dattr;
  807. size_t field_offset;
  808. size_t field_size;
  809. };
  810. #define __ELANTS_FIELD_SIZE(_field) \
  811. sizeof(((struct elants_data *)NULL)->_field)
  812. #define __ELANTS_VERIFY_SIZE(_field) \
  813. (BUILD_BUG_ON_ZERO(__ELANTS_FIELD_SIZE(_field) > 2) + \
  814. __ELANTS_FIELD_SIZE(_field))
  815. #define ELANTS_VERSION_ATTR(_field) \
  816. struct elants_version_attribute elants_ver_attr_##_field = { \
  817. .dattr = __ATTR(_field, S_IRUGO, \
  818. elants_version_attribute_show, NULL), \
  819. .field_offset = offsetof(struct elants_data, _field), \
  820. .field_size = __ELANTS_VERIFY_SIZE(_field), \
  821. }
  822. static ssize_t elants_version_attribute_show(struct device *dev,
  823. struct device_attribute *dattr,
  824. char *buf)
  825. {
  826. struct i2c_client *client = to_i2c_client(dev);
  827. struct elants_data *ts = i2c_get_clientdata(client);
  828. struct elants_version_attribute *attr =
  829. container_of(dattr, struct elants_version_attribute, dattr);
  830. u8 *field = (u8 *)((char *)ts + attr->field_offset);
  831. unsigned int fmt_size;
  832. unsigned int val;
  833. if (attr->field_size == 1) {
  834. val = *field;
  835. fmt_size = 2; /* 2 HEX digits */
  836. } else {
  837. val = *(u16 *)field;
  838. fmt_size = 4; /* 4 HEX digits */
  839. }
  840. return sprintf(buf, "%0*x\n", fmt_size, val);
  841. }
  842. static ELANTS_VERSION_ATTR(fw_version);
  843. static ELANTS_VERSION_ATTR(hw_version);
  844. static ELANTS_VERSION_ATTR(test_version);
  845. static ELANTS_VERSION_ATTR(solution_version);
  846. static ELANTS_VERSION_ATTR(bc_version);
  847. static ELANTS_VERSION_ATTR(iap_version);
  848. static struct attribute *elants_attributes[] = {
  849. &dev_attr_calibrate.attr,
  850. &dev_attr_update_fw.attr,
  851. &dev_attr_iap_mode.attr,
  852. &elants_ver_attr_fw_version.dattr.attr,
  853. &elants_ver_attr_hw_version.dattr.attr,
  854. &elants_ver_attr_test_version.dattr.attr,
  855. &elants_ver_attr_solution_version.dattr.attr,
  856. &elants_ver_attr_bc_version.dattr.attr,
  857. &elants_ver_attr_iap_version.dattr.attr,
  858. NULL
  859. };
  860. static struct attribute_group elants_attribute_group = {
  861. .attrs = elants_attributes,
  862. };
  863. static void elants_i2c_remove_sysfs_group(void *_data)
  864. {
  865. struct elants_data *ts = _data;
  866. sysfs_remove_group(&ts->client->dev.kobj, &elants_attribute_group);
  867. }
  868. static int elants_i2c_probe(struct i2c_client *client,
  869. const struct i2c_device_id *id)
  870. {
  871. union i2c_smbus_data dummy;
  872. struct elants_data *ts;
  873. unsigned long irqflags;
  874. int error;
  875. if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
  876. dev_err(&client->dev,
  877. "%s: i2c check functionality error\n", DEVICE_NAME);
  878. return -ENXIO;
  879. }
  880. /* Make sure there is something at this address */
  881. if (i2c_smbus_xfer(client->adapter, client->addr, 0,
  882. I2C_SMBUS_READ, 0, I2C_SMBUS_BYTE, &dummy) < 0) {
  883. dev_err(&client->dev, "nothing at this address\n");
  884. return -ENXIO;
  885. }
  886. ts = devm_kzalloc(&client->dev, sizeof(struct elants_data), GFP_KERNEL);
  887. if (!ts)
  888. return -ENOMEM;
  889. mutex_init(&ts->sysfs_mutex);
  890. init_completion(&ts->cmd_done);
  891. ts->client = client;
  892. i2c_set_clientdata(client, ts);
  893. error = elants_i2c_initialize(ts);
  894. if (error) {
  895. dev_err(&client->dev, "failed to initialize: %d\n", error);
  896. return error;
  897. }
  898. ts->input = devm_input_allocate_device(&client->dev);
  899. if (!ts->input) {
  900. dev_err(&client->dev, "Failed to allocate input device\n");
  901. return -ENOMEM;
  902. }
  903. ts->input->name = "Elan Touchscreen";
  904. ts->input->id.bustype = BUS_I2C;
  905. __set_bit(BTN_TOUCH, ts->input->keybit);
  906. __set_bit(EV_ABS, ts->input->evbit);
  907. __set_bit(EV_KEY, ts->input->evbit);
  908. /* Single touch input params setup */
  909. input_set_abs_params(ts->input, ABS_X, 0, ts->x_max, 0, 0);
  910. input_set_abs_params(ts->input, ABS_Y, 0, ts->y_max, 0, 0);
  911. input_set_abs_params(ts->input, ABS_PRESSURE, 0, 255, 0, 0);
  912. input_abs_set_res(ts->input, ABS_X, ts->x_res);
  913. input_abs_set_res(ts->input, ABS_Y, ts->y_res);
  914. /* Multitouch input params setup */
  915. error = input_mt_init_slots(ts->input, MAX_CONTACT_NUM,
  916. INPUT_MT_DIRECT | INPUT_MT_DROP_UNUSED);
  917. if (error) {
  918. dev_err(&client->dev,
  919. "failed to initialize MT slots: %d\n", error);
  920. return error;
  921. }
  922. input_set_abs_params(ts->input, ABS_MT_POSITION_X, 0, ts->x_max, 0, 0);
  923. input_set_abs_params(ts->input, ABS_MT_POSITION_Y, 0, ts->y_max, 0, 0);
  924. input_set_abs_params(ts->input, ABS_MT_TOUCH_MAJOR, 0, 255, 0, 0);
  925. input_set_abs_params(ts->input, ABS_MT_PRESSURE, 0, 255, 0, 0);
  926. input_abs_set_res(ts->input, ABS_MT_POSITION_X, ts->x_res);
  927. input_abs_set_res(ts->input, ABS_MT_POSITION_Y, ts->y_res);
  928. input_set_drvdata(ts->input, ts);
  929. error = input_register_device(ts->input);
  930. if (error) {
  931. dev_err(&client->dev,
  932. "unable to register input device: %d\n", error);
  933. return error;
  934. }
  935. /*
  936. * Systems using device tree should set up interrupt via DTS,
  937. * the rest will use the default falling edge interrupts.
  938. */
  939. irqflags = client->dev.of_node ? 0 : IRQF_TRIGGER_FALLING;
  940. error = devm_request_threaded_irq(&client->dev, client->irq,
  941. NULL, elants_i2c_irq,
  942. irqflags | IRQF_ONESHOT,
  943. client->name, ts);
  944. if (error) {
  945. dev_err(&client->dev, "Failed to register interrupt\n");
  946. return error;
  947. }
  948. /*
  949. * Systems using device tree should set up wakeup via DTS,
  950. * the rest will configure device as wakeup source by default.
  951. */
  952. if (!client->dev.of_node)
  953. device_init_wakeup(&client->dev, true);
  954. error = sysfs_create_group(&client->dev.kobj, &elants_attribute_group);
  955. if (error) {
  956. dev_err(&client->dev, "failed to create sysfs attributes: %d\n",
  957. error);
  958. return error;
  959. }
  960. error = devm_add_action(&client->dev,
  961. elants_i2c_remove_sysfs_group, ts);
  962. if (error) {
  963. elants_i2c_remove_sysfs_group(ts);
  964. dev_err(&client->dev,
  965. "Failed to add sysfs cleanup action: %d\n",
  966. error);
  967. return error;
  968. }
  969. return 0;
  970. }
  971. static int __maybe_unused elants_i2c_suspend(struct device *dev)
  972. {
  973. struct i2c_client *client = to_i2c_client(dev);
  974. struct elants_data *ts = i2c_get_clientdata(client);
  975. const u8 set_sleep_cmd[] = { 0x54, 0x50, 0x00, 0x01 };
  976. int retry_cnt;
  977. int error;
  978. /* Command not support in IAP recovery mode */
  979. if (ts->iap_mode != ELAN_IAP_OPERATIONAL)
  980. return -EBUSY;
  981. disable_irq(client->irq);
  982. for (retry_cnt = 0; retry_cnt < MAX_RETRIES; retry_cnt++) {
  983. error = elants_i2c_send(client, set_sleep_cmd,
  984. sizeof(set_sleep_cmd));
  985. if (!error)
  986. break;
  987. dev_err(&client->dev, "suspend command failed: %d\n", error);
  988. }
  989. if (device_may_wakeup(dev))
  990. ts->wake_irq_enabled = (enable_irq_wake(client->irq) == 0);
  991. return 0;
  992. }
  993. static int __maybe_unused elants_i2c_resume(struct device *dev)
  994. {
  995. struct i2c_client *client = to_i2c_client(dev);
  996. struct elants_data *ts = i2c_get_clientdata(client);
  997. const u8 set_active_cmd[] = { 0x54, 0x58, 0x00, 0x01 };
  998. int retry_cnt;
  999. int error;
  1000. if (device_may_wakeup(dev) && ts->wake_irq_enabled)
  1001. disable_irq_wake(client->irq);
  1002. for (retry_cnt = 0; retry_cnt < MAX_RETRIES; retry_cnt++) {
  1003. error = elants_i2c_send(client, set_active_cmd,
  1004. sizeof(set_active_cmd));
  1005. if (!error)
  1006. break;
  1007. dev_err(&client->dev, "resume command failed: %d\n", error);
  1008. }
  1009. ts->state = ELAN_STATE_NORMAL;
  1010. enable_irq(client->irq);
  1011. return 0;
  1012. }
  1013. static SIMPLE_DEV_PM_OPS(elants_i2c_pm_ops,
  1014. elants_i2c_suspend, elants_i2c_resume);
  1015. static const struct i2c_device_id elants_i2c_id[] = {
  1016. { DEVICE_NAME, 0 },
  1017. { }
  1018. };
  1019. MODULE_DEVICE_TABLE(i2c, elants_i2c_id);
  1020. #ifdef CONFIG_ACPI
  1021. static const struct acpi_device_id elants_acpi_id[] = {
  1022. { "ELAN0001", 0 },
  1023. { }
  1024. };
  1025. MODULE_DEVICE_TABLE(acpi, elants_acpi_id);
  1026. #endif
  1027. #ifdef CONFIG_OF
  1028. static const struct of_device_id elants_of_match[] = {
  1029. { .compatible = "elan,ekth3500" },
  1030. { /* sentinel */ }
  1031. };
  1032. MODULE_DEVICE_TABLE(of, elants_of_match);
  1033. #endif
  1034. static struct i2c_driver elants_i2c_driver = {
  1035. .probe = elants_i2c_probe,
  1036. .id_table = elants_i2c_id,
  1037. .driver = {
  1038. .name = DEVICE_NAME,
  1039. .owner = THIS_MODULE,
  1040. .pm = &elants_i2c_pm_ops,
  1041. .acpi_match_table = ACPI_PTR(elants_acpi_id),
  1042. .of_match_table = of_match_ptr(elants_of_match),
  1043. },
  1044. };
  1045. module_i2c_driver(elants_i2c_driver);
  1046. MODULE_AUTHOR("Scott Liu <scott.liu@emc.com.tw>");
  1047. MODULE_DESCRIPTION("Elan I2c Touchscreen driver");
  1048. MODULE_VERSION(DRV_VERSION);
  1049. MODULE_LICENSE("GPL");