hid-wiimote.h 9.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376
  1. #ifndef __HID_WIIMOTE_H
  2. #define __HID_WIIMOTE_H
  3. /*
  4. * HID driver for Nintendo Wii / Wii U peripherals
  5. * Copyright (c) 2011-2013 David Herrmann <dh.herrmann@gmail.com>
  6. */
  7. /*
  8. * This program is free software; you can redistribute it and/or modify it
  9. * under the terms of the GNU General Public License as published by the Free
  10. * Software Foundation; either version 2 of the License, or (at your option)
  11. * any later version.
  12. */
  13. #include <linux/completion.h>
  14. #include <linux/device.h>
  15. #include <linux/hid.h>
  16. #include <linux/input.h>
  17. #include <linux/leds.h>
  18. #include <linux/module.h>
  19. #include <linux/mutex.h>
  20. #include <linux/power_supply.h>
  21. #include <linux/spinlock.h>
  22. #include <linux/timer.h>
  23. #define WIIMOTE_NAME "Nintendo Wii Remote"
  24. #define WIIMOTE_BUFSIZE 32
  25. #define WIIPROTO_FLAG_LED1 0x01
  26. #define WIIPROTO_FLAG_LED2 0x02
  27. #define WIIPROTO_FLAG_LED3 0x04
  28. #define WIIPROTO_FLAG_LED4 0x08
  29. #define WIIPROTO_FLAG_RUMBLE 0x10
  30. #define WIIPROTO_FLAG_ACCEL 0x20
  31. #define WIIPROTO_FLAG_IR_BASIC 0x40
  32. #define WIIPROTO_FLAG_IR_EXT 0x80
  33. #define WIIPROTO_FLAG_IR_FULL 0xc0 /* IR_BASIC | IR_EXT */
  34. #define WIIPROTO_FLAG_EXT_PLUGGED 0x0100
  35. #define WIIPROTO_FLAG_EXT_USED 0x0200
  36. #define WIIPROTO_FLAG_EXT_ACTIVE 0x0400
  37. #define WIIPROTO_FLAG_MP_PLUGGED 0x0800
  38. #define WIIPROTO_FLAG_MP_USED 0x1000
  39. #define WIIPROTO_FLAG_MP_ACTIVE 0x2000
  40. #define WIIPROTO_FLAG_EXITING 0x4000
  41. #define WIIPROTO_FLAG_DRM_LOCKED 0x8000
  42. #define WIIPROTO_FLAG_BUILTIN_MP 0x010000
  43. #define WIIPROTO_FLAG_NO_MP 0x020000
  44. #define WIIPROTO_FLAG_PRO_CALIB_DONE 0x040000
  45. #define WIIPROTO_FLAGS_LEDS (WIIPROTO_FLAG_LED1 | WIIPROTO_FLAG_LED2 | \
  46. WIIPROTO_FLAG_LED3 | WIIPROTO_FLAG_LED4)
  47. #define WIIPROTO_FLAGS_IR (WIIPROTO_FLAG_IR_BASIC | WIIPROTO_FLAG_IR_EXT | \
  48. WIIPROTO_FLAG_IR_FULL)
  49. /* return flag for led \num */
  50. #define WIIPROTO_FLAG_LED(num) (WIIPROTO_FLAG_LED1 << (num - 1))
  51. enum wiiproto_keys {
  52. WIIPROTO_KEY_LEFT,
  53. WIIPROTO_KEY_RIGHT,
  54. WIIPROTO_KEY_UP,
  55. WIIPROTO_KEY_DOWN,
  56. WIIPROTO_KEY_PLUS,
  57. WIIPROTO_KEY_MINUS,
  58. WIIPROTO_KEY_ONE,
  59. WIIPROTO_KEY_TWO,
  60. WIIPROTO_KEY_A,
  61. WIIPROTO_KEY_B,
  62. WIIPROTO_KEY_HOME,
  63. WIIPROTO_KEY_COUNT
  64. };
  65. enum wiimote_devtype {
  66. WIIMOTE_DEV_PENDING,
  67. WIIMOTE_DEV_UNKNOWN,
  68. WIIMOTE_DEV_GENERIC,
  69. WIIMOTE_DEV_GEN10,
  70. WIIMOTE_DEV_GEN20,
  71. WIIMOTE_DEV_BALANCE_BOARD,
  72. WIIMOTE_DEV_PRO_CONTROLLER,
  73. WIIMOTE_DEV_NUM,
  74. };
  75. enum wiimote_exttype {
  76. WIIMOTE_EXT_NONE,
  77. WIIMOTE_EXT_UNKNOWN,
  78. WIIMOTE_EXT_NUNCHUK,
  79. WIIMOTE_EXT_CLASSIC_CONTROLLER,
  80. WIIMOTE_EXT_BALANCE_BOARD,
  81. WIIMOTE_EXT_PRO_CONTROLLER,
  82. WIIMOTE_EXT_NUM,
  83. };
  84. enum wiimote_mptype {
  85. WIIMOTE_MP_NONE,
  86. WIIMOTE_MP_UNKNOWN,
  87. WIIMOTE_MP_SINGLE,
  88. WIIMOTE_MP_PASSTHROUGH_NUNCHUK,
  89. WIIMOTE_MP_PASSTHROUGH_CLASSIC,
  90. };
  91. struct wiimote_buf {
  92. __u8 data[HID_MAX_BUFFER_SIZE];
  93. size_t size;
  94. };
  95. struct wiimote_queue {
  96. spinlock_t lock;
  97. struct work_struct worker;
  98. __u8 head;
  99. __u8 tail;
  100. struct wiimote_buf outq[WIIMOTE_BUFSIZE];
  101. };
  102. struct wiimote_state {
  103. spinlock_t lock;
  104. __u32 flags;
  105. __u8 accel_split[2];
  106. __u8 drm;
  107. __u8 devtype;
  108. __u8 exttype;
  109. __u8 mp;
  110. /* synchronous cmd requests */
  111. struct mutex sync;
  112. struct completion ready;
  113. int cmd;
  114. __u32 opt;
  115. /* results of synchronous requests */
  116. __u8 cmd_battery;
  117. __u8 cmd_err;
  118. __u8 *cmd_read_buf;
  119. __u8 cmd_read_size;
  120. /* calibration/cache data */
  121. __u16 calib_bboard[4][3];
  122. __s16 calib_pro_sticks[4];
  123. __u8 cache_rumble;
  124. };
  125. struct wiimote_data {
  126. struct hid_device *hdev;
  127. struct input_dev *input;
  128. struct work_struct rumble_worker;
  129. struct led_classdev *leds[4];
  130. struct input_dev *accel;
  131. struct input_dev *ir;
  132. struct power_supply *battery;
  133. struct power_supply_desc battery_desc;
  134. struct input_dev *mp;
  135. struct timer_list timer;
  136. struct wiimote_debug *debug;
  137. union {
  138. struct input_dev *input;
  139. } extension;
  140. struct wiimote_queue queue;
  141. struct wiimote_state state;
  142. struct work_struct init_worker;
  143. };
  144. /* wiimote modules */
  145. enum wiimod_module {
  146. WIIMOD_KEYS,
  147. WIIMOD_RUMBLE,
  148. WIIMOD_BATTERY,
  149. WIIMOD_LED1,
  150. WIIMOD_LED2,
  151. WIIMOD_LED3,
  152. WIIMOD_LED4,
  153. WIIMOD_ACCEL,
  154. WIIMOD_IR,
  155. WIIMOD_BUILTIN_MP,
  156. WIIMOD_NO_MP,
  157. WIIMOD_NUM,
  158. WIIMOD_NULL = WIIMOD_NUM,
  159. };
  160. #define WIIMOD_FLAG_INPUT 0x0001
  161. #define WIIMOD_FLAG_EXT8 0x0002
  162. #define WIIMOD_FLAG_EXT16 0x0004
  163. struct wiimod_ops {
  164. __u16 flags;
  165. unsigned long arg;
  166. int (*probe) (const struct wiimod_ops *ops,
  167. struct wiimote_data *wdata);
  168. void (*remove) (const struct wiimod_ops *ops,
  169. struct wiimote_data *wdata);
  170. void (*in_keys) (struct wiimote_data *wdata, const __u8 *keys);
  171. void (*in_accel) (struct wiimote_data *wdata, const __u8 *accel);
  172. void (*in_ir) (struct wiimote_data *wdata, const __u8 *ir, bool packed,
  173. unsigned int id);
  174. void (*in_mp) (struct wiimote_data *wdata, const __u8 *mp);
  175. void (*in_ext) (struct wiimote_data *wdata, const __u8 *ext);
  176. };
  177. extern const struct wiimod_ops *wiimod_table[WIIMOD_NUM];
  178. extern const struct wiimod_ops *wiimod_ext_table[WIIMOTE_EXT_NUM];
  179. extern const struct wiimod_ops wiimod_mp;
  180. /* wiimote requests */
  181. enum wiiproto_reqs {
  182. WIIPROTO_REQ_NULL = 0x0,
  183. WIIPROTO_REQ_RUMBLE = 0x10,
  184. WIIPROTO_REQ_LED = 0x11,
  185. WIIPROTO_REQ_DRM = 0x12,
  186. WIIPROTO_REQ_IR1 = 0x13,
  187. WIIPROTO_REQ_SREQ = 0x15,
  188. WIIPROTO_REQ_WMEM = 0x16,
  189. WIIPROTO_REQ_RMEM = 0x17,
  190. WIIPROTO_REQ_IR2 = 0x1a,
  191. WIIPROTO_REQ_STATUS = 0x20,
  192. WIIPROTO_REQ_DATA = 0x21,
  193. WIIPROTO_REQ_RETURN = 0x22,
  194. /* DRM_K: BB*2 */
  195. WIIPROTO_REQ_DRM_K = 0x30,
  196. /* DRM_KA: BB*2 AA*3 */
  197. WIIPROTO_REQ_DRM_KA = 0x31,
  198. /* DRM_KE: BB*2 EE*8 */
  199. WIIPROTO_REQ_DRM_KE = 0x32,
  200. /* DRM_KAI: BB*2 AA*3 II*12 */
  201. WIIPROTO_REQ_DRM_KAI = 0x33,
  202. /* DRM_KEE: BB*2 EE*19 */
  203. WIIPROTO_REQ_DRM_KEE = 0x34,
  204. /* DRM_KAE: BB*2 AA*3 EE*16 */
  205. WIIPROTO_REQ_DRM_KAE = 0x35,
  206. /* DRM_KIE: BB*2 II*10 EE*9 */
  207. WIIPROTO_REQ_DRM_KIE = 0x36,
  208. /* DRM_KAIE: BB*2 AA*3 II*10 EE*6 */
  209. WIIPROTO_REQ_DRM_KAIE = 0x37,
  210. /* DRM_E: EE*21 */
  211. WIIPROTO_REQ_DRM_E = 0x3d,
  212. /* DRM_SKAI1: BB*2 AA*1 II*18 */
  213. WIIPROTO_REQ_DRM_SKAI1 = 0x3e,
  214. /* DRM_SKAI2: BB*2 AA*1 II*18 */
  215. WIIPROTO_REQ_DRM_SKAI2 = 0x3f,
  216. WIIPROTO_REQ_MAX
  217. };
  218. #define dev_to_wii(pdev) hid_get_drvdata(container_of(pdev, struct hid_device, \
  219. dev))
  220. void __wiimote_schedule(struct wiimote_data *wdata);
  221. extern void wiiproto_req_drm(struct wiimote_data *wdata, __u8 drm);
  222. extern void wiiproto_req_rumble(struct wiimote_data *wdata, __u8 rumble);
  223. extern void wiiproto_req_leds(struct wiimote_data *wdata, int leds);
  224. extern void wiiproto_req_status(struct wiimote_data *wdata);
  225. extern void wiiproto_req_accel(struct wiimote_data *wdata, __u8 accel);
  226. extern void wiiproto_req_ir1(struct wiimote_data *wdata, __u8 flags);
  227. extern void wiiproto_req_ir2(struct wiimote_data *wdata, __u8 flags);
  228. extern int wiimote_cmd_write(struct wiimote_data *wdata, __u32 offset,
  229. const __u8 *wmem, __u8 size);
  230. extern ssize_t wiimote_cmd_read(struct wiimote_data *wdata, __u32 offset,
  231. __u8 *rmem, __u8 size);
  232. #define wiiproto_req_rreg(wdata, os, sz) \
  233. wiiproto_req_rmem((wdata), false, (os), (sz))
  234. #define wiiproto_req_reeprom(wdata, os, sz) \
  235. wiiproto_req_rmem((wdata), true, (os), (sz))
  236. extern void wiiproto_req_rmem(struct wiimote_data *wdata, bool eeprom,
  237. __u32 offset, __u16 size);
  238. #ifdef CONFIG_DEBUG_FS
  239. extern int wiidebug_init(struct wiimote_data *wdata);
  240. extern void wiidebug_deinit(struct wiimote_data *wdata);
  241. #else
  242. static inline int wiidebug_init(void *u) { return 0; }
  243. static inline void wiidebug_deinit(void *u) { }
  244. #endif
  245. /* requires the state.lock spinlock to be held */
  246. static inline bool wiimote_cmd_pending(struct wiimote_data *wdata, int cmd,
  247. __u32 opt)
  248. {
  249. return wdata->state.cmd == cmd && wdata->state.opt == opt;
  250. }
  251. /* requires the state.lock spinlock to be held */
  252. static inline void wiimote_cmd_complete(struct wiimote_data *wdata)
  253. {
  254. wdata->state.cmd = WIIPROTO_REQ_NULL;
  255. complete(&wdata->state.ready);
  256. }
  257. /* requires the state.lock spinlock to be held */
  258. static inline void wiimote_cmd_abort(struct wiimote_data *wdata)
  259. {
  260. /* Abort synchronous request by waking up the sleeping caller. But
  261. * reset the state.cmd field to an invalid value so no further event
  262. * handlers will work with it. */
  263. wdata->state.cmd = WIIPROTO_REQ_MAX;
  264. complete(&wdata->state.ready);
  265. }
  266. static inline int wiimote_cmd_acquire(struct wiimote_data *wdata)
  267. {
  268. return mutex_lock_interruptible(&wdata->state.sync) ? -ERESTARTSYS : 0;
  269. }
  270. static inline void wiimote_cmd_acquire_noint(struct wiimote_data *wdata)
  271. {
  272. mutex_lock(&wdata->state.sync);
  273. }
  274. /* requires the state.lock spinlock to be held */
  275. static inline void wiimote_cmd_set(struct wiimote_data *wdata, int cmd,
  276. __u32 opt)
  277. {
  278. reinit_completion(&wdata->state.ready);
  279. wdata->state.cmd = cmd;
  280. wdata->state.opt = opt;
  281. }
  282. static inline void wiimote_cmd_release(struct wiimote_data *wdata)
  283. {
  284. mutex_unlock(&wdata->state.sync);
  285. }
  286. static inline int wiimote_cmd_wait(struct wiimote_data *wdata)
  287. {
  288. int ret;
  289. /* The completion acts as implicit memory barrier so we can safely
  290. * assume that state.cmd is set on success/failure and isn't accessed
  291. * by any other thread, anymore. */
  292. ret = wait_for_completion_interruptible_timeout(&wdata->state.ready, HZ);
  293. if (ret < 0)
  294. return -ERESTARTSYS;
  295. else if (ret == 0)
  296. return -EIO;
  297. else if (wdata->state.cmd != WIIPROTO_REQ_NULL)
  298. return -EIO;
  299. else
  300. return 0;
  301. }
  302. static inline int wiimote_cmd_wait_noint(struct wiimote_data *wdata)
  303. {
  304. unsigned long ret;
  305. /* no locking needed; see wiimote_cmd_wait() */
  306. ret = wait_for_completion_timeout(&wdata->state.ready, HZ);
  307. if (!ret)
  308. return -EIO;
  309. else if (wdata->state.cmd != WIIPROTO_REQ_NULL)
  310. return -EIO;
  311. else
  312. return 0;
  313. }
  314. #endif