sparse-keymap.c 8.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331
  1. /*
  2. * Generic support for sparse keymaps
  3. *
  4. * Copyright (c) 2009 Dmitry Torokhov
  5. *
  6. * Derived from wistron button driver:
  7. * Copyright (C) 2005 Miloslav Trmac <mitr@volny.cz>
  8. * Copyright (C) 2005 Bernhard Rosenkraenzer <bero@arklinux.org>
  9. * Copyright (C) 2005 Dmitry Torokhov <dtor@mail.ru>
  10. *
  11. * This program is free software; you can redistribute it and/or modify it
  12. * under the terms of the GNU General Public License version 2 as published by
  13. * the Free Software Foundation.
  14. */
  15. #include <linux/input.h>
  16. #include <linux/input/sparse-keymap.h>
  17. #include <linux/slab.h>
  18. MODULE_AUTHOR("Dmitry Torokhov <dtor@mail.ru>");
  19. MODULE_DESCRIPTION("Generic support for sparse keymaps");
  20. MODULE_LICENSE("GPL v2");
  21. MODULE_VERSION("0.1");
  22. static unsigned int sparse_keymap_get_key_index(struct input_dev *dev,
  23. const struct key_entry *k)
  24. {
  25. struct key_entry *key;
  26. unsigned int idx = 0;
  27. for (key = dev->keycode; key->type != KE_END; key++) {
  28. if (key->type == KE_KEY) {
  29. if (key == k)
  30. break;
  31. idx++;
  32. }
  33. }
  34. return idx;
  35. }
  36. static struct key_entry *sparse_keymap_entry_by_index(struct input_dev *dev,
  37. unsigned int index)
  38. {
  39. struct key_entry *key;
  40. unsigned int key_cnt = 0;
  41. for (key = dev->keycode; key->type != KE_END; key++)
  42. if (key->type == KE_KEY)
  43. if (key_cnt++ == index)
  44. return key;
  45. return NULL;
  46. }
  47. /**
  48. * sparse_keymap_entry_from_scancode - perform sparse keymap lookup
  49. * @dev: Input device using sparse keymap
  50. * @code: Scan code
  51. *
  52. * This function is used to perform &struct key_entry lookup in an
  53. * input device using sparse keymap.
  54. */
  55. struct key_entry *sparse_keymap_entry_from_scancode(struct input_dev *dev,
  56. unsigned int code)
  57. {
  58. struct key_entry *key;
  59. for (key = dev->keycode; key->type != KE_END; key++)
  60. if (code == key->code)
  61. return key;
  62. return NULL;
  63. }
  64. EXPORT_SYMBOL(sparse_keymap_entry_from_scancode);
  65. /**
  66. * sparse_keymap_entry_from_keycode - perform sparse keymap lookup
  67. * @dev: Input device using sparse keymap
  68. * @keycode: Key code
  69. *
  70. * This function is used to perform &struct key_entry lookup in an
  71. * input device using sparse keymap.
  72. */
  73. struct key_entry *sparse_keymap_entry_from_keycode(struct input_dev *dev,
  74. unsigned int keycode)
  75. {
  76. struct key_entry *key;
  77. for (key = dev->keycode; key->type != KE_END; key++)
  78. if (key->type == KE_KEY && keycode == key->keycode)
  79. return key;
  80. return NULL;
  81. }
  82. EXPORT_SYMBOL(sparse_keymap_entry_from_keycode);
  83. static struct key_entry *sparse_keymap_locate(struct input_dev *dev,
  84. const struct input_keymap_entry *ke)
  85. {
  86. struct key_entry *key;
  87. unsigned int scancode;
  88. if (ke->flags & INPUT_KEYMAP_BY_INDEX)
  89. key = sparse_keymap_entry_by_index(dev, ke->index);
  90. else if (input_scancode_to_scalar(ke, &scancode) == 0)
  91. key = sparse_keymap_entry_from_scancode(dev, scancode);
  92. else
  93. key = NULL;
  94. return key;
  95. }
  96. static int sparse_keymap_getkeycode(struct input_dev *dev,
  97. struct input_keymap_entry *ke)
  98. {
  99. const struct key_entry *key;
  100. if (dev->keycode) {
  101. key = sparse_keymap_locate(dev, ke);
  102. if (key && key->type == KE_KEY) {
  103. ke->keycode = key->keycode;
  104. if (!(ke->flags & INPUT_KEYMAP_BY_INDEX))
  105. ke->index =
  106. sparse_keymap_get_key_index(dev, key);
  107. ke->len = sizeof(key->code);
  108. memcpy(ke->scancode, &key->code, sizeof(key->code));
  109. return 0;
  110. }
  111. }
  112. return -EINVAL;
  113. }
  114. static int sparse_keymap_setkeycode(struct input_dev *dev,
  115. const struct input_keymap_entry *ke,
  116. unsigned int *old_keycode)
  117. {
  118. struct key_entry *key;
  119. if (dev->keycode) {
  120. key = sparse_keymap_locate(dev, ke);
  121. if (key && key->type == KE_KEY) {
  122. *old_keycode = key->keycode;
  123. key->keycode = ke->keycode;
  124. set_bit(ke->keycode, dev->keybit);
  125. if (!sparse_keymap_entry_from_keycode(dev, *old_keycode))
  126. clear_bit(*old_keycode, dev->keybit);
  127. return 0;
  128. }
  129. }
  130. return -EINVAL;
  131. }
  132. /**
  133. * sparse_keymap_setup - set up sparse keymap for an input device
  134. * @dev: Input device
  135. * @keymap: Keymap in form of array of &key_entry structures ending
  136. * with %KE_END type entry
  137. * @setup: Function that can be used to adjust keymap entries
  138. * depending on device's deeds, may be %NULL
  139. *
  140. * The function calculates size and allocates copy of the original
  141. * keymap after which sets up input device event bits appropriately.
  142. * Before destroying input device allocated keymap should be freed
  143. * with a call to sparse_keymap_free().
  144. */
  145. int sparse_keymap_setup(struct input_dev *dev,
  146. const struct key_entry *keymap,
  147. int (*setup)(struct input_dev *, struct key_entry *))
  148. {
  149. size_t map_size = 1; /* to account for the last KE_END entry */
  150. const struct key_entry *e;
  151. struct key_entry *map, *entry;
  152. int i;
  153. int error;
  154. for (e = keymap; e->type != KE_END; e++)
  155. map_size++;
  156. map = kcalloc(map_size, sizeof (struct key_entry), GFP_KERNEL);
  157. if (!map)
  158. return -ENOMEM;
  159. memcpy(map, keymap, map_size * sizeof (struct key_entry));
  160. for (i = 0; i < map_size; i++) {
  161. entry = &map[i];
  162. if (setup) {
  163. error = setup(dev, entry);
  164. if (error)
  165. goto err_out;
  166. }
  167. switch (entry->type) {
  168. case KE_KEY:
  169. __set_bit(EV_KEY, dev->evbit);
  170. __set_bit(entry->keycode, dev->keybit);
  171. break;
  172. case KE_SW:
  173. case KE_VSW:
  174. __set_bit(EV_SW, dev->evbit);
  175. __set_bit(entry->sw.code, dev->swbit);
  176. break;
  177. }
  178. }
  179. if (test_bit(EV_KEY, dev->evbit)) {
  180. __set_bit(KEY_UNKNOWN, dev->keybit);
  181. __set_bit(EV_MSC, dev->evbit);
  182. __set_bit(MSC_SCAN, dev->mscbit);
  183. }
  184. dev->keycode = map;
  185. dev->keycodemax = map_size;
  186. dev->getkeycode = sparse_keymap_getkeycode;
  187. dev->setkeycode = sparse_keymap_setkeycode;
  188. return 0;
  189. err_out:
  190. kfree(map);
  191. return error;
  192. }
  193. EXPORT_SYMBOL(sparse_keymap_setup);
  194. /**
  195. * sparse_keymap_free - free memory allocated for sparse keymap
  196. * @dev: Input device using sparse keymap
  197. *
  198. * This function is used to free memory allocated by sparse keymap
  199. * in an input device that was set up by sparse_keymap_setup().
  200. * NOTE: It is safe to cal this function while input device is
  201. * still registered (however the drivers should care not to try to
  202. * use freed keymap and thus have to shut off interrups/polling
  203. * before freeing the keymap).
  204. */
  205. void sparse_keymap_free(struct input_dev *dev)
  206. {
  207. unsigned long flags;
  208. /*
  209. * Take event lock to prevent racing with input_get_keycode()
  210. * and input_set_keycode() if we are called while input device
  211. * is still registered.
  212. */
  213. spin_lock_irqsave(&dev->event_lock, flags);
  214. kfree(dev->keycode);
  215. dev->keycode = NULL;
  216. dev->keycodemax = 0;
  217. spin_unlock_irqrestore(&dev->event_lock, flags);
  218. }
  219. EXPORT_SYMBOL(sparse_keymap_free);
  220. /**
  221. * sparse_keymap_report_entry - report event corresponding to given key entry
  222. * @dev: Input device for which event should be reported
  223. * @ke: key entry describing event
  224. * @value: Value that should be reported (ignored by %KE_SW entries)
  225. * @autorelease: Signals whether release event should be emitted for %KE_KEY
  226. * entries right after reporting press event, ignored by all other
  227. * entries
  228. *
  229. * This function is used to report input event described by given
  230. * &struct key_entry.
  231. */
  232. void sparse_keymap_report_entry(struct input_dev *dev, const struct key_entry *ke,
  233. unsigned int value, bool autorelease)
  234. {
  235. switch (ke->type) {
  236. case KE_KEY:
  237. input_event(dev, EV_MSC, MSC_SCAN, ke->code);
  238. input_report_key(dev, ke->keycode, value);
  239. input_sync(dev);
  240. if (value && autorelease) {
  241. input_report_key(dev, ke->keycode, 0);
  242. input_sync(dev);
  243. }
  244. break;
  245. case KE_SW:
  246. value = ke->sw.value;
  247. /* fall through */
  248. case KE_VSW:
  249. input_report_switch(dev, ke->sw.code, value);
  250. break;
  251. }
  252. }
  253. EXPORT_SYMBOL(sparse_keymap_report_entry);
  254. /**
  255. * sparse_keymap_report_event - report event corresponding to given scancode
  256. * @dev: Input device using sparse keymap
  257. * @code: Scan code
  258. * @value: Value that should be reported (ignored by %KE_SW entries)
  259. * @autorelease: Signals whether release event should be emitted for %KE_KEY
  260. * entries right after reporting press event, ignored by all other
  261. * entries
  262. *
  263. * This function is used to perform lookup in an input device using sparse
  264. * keymap and report corresponding event. Returns %true if lookup was
  265. * successful and %false otherwise.
  266. */
  267. bool sparse_keymap_report_event(struct input_dev *dev, unsigned int code,
  268. unsigned int value, bool autorelease)
  269. {
  270. const struct key_entry *ke =
  271. sparse_keymap_entry_from_scancode(dev, code);
  272. struct key_entry unknown_ke;
  273. if (ke) {
  274. sparse_keymap_report_entry(dev, ke, value, autorelease);
  275. return true;
  276. }
  277. /* Report an unknown key event as a debugging aid */
  278. unknown_ke.type = KE_KEY;
  279. unknown_ke.code = code;
  280. unknown_ke.keycode = KEY_UNKNOWN;
  281. sparse_keymap_report_entry(dev, &unknown_ke, value, true);
  282. return false;
  283. }
  284. EXPORT_SYMBOL(sparse_keymap_report_event);