input.h 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191
  1. /*
  2. * Copyright (c) 1999-2002 Vojtech Pavlik
  3. *
  4. * This program is free software; you can redistribute it and/or modify it
  5. * under the terms of the GNU General Public License version 2 as published by
  6. * the Free Software Foundation.
  7. */
  8. #ifndef _UAPI_INPUT_H
  9. #define _UAPI_INPUT_H
  10. #ifndef __KERNEL__
  11. #include <sys/time.h>
  12. #include <sys/ioctl.h>
  13. #include <sys/types.h>
  14. #include <linux/types.h>
  15. #endif
  16. /*
  17. * The event structure itself
  18. */
  19. struct input_event {
  20. struct timeval time;
  21. __u16 type;
  22. __u16 code;
  23. __s32 value;
  24. };
  25. /*
  26. * Protocol version.
  27. */
  28. #define EV_VERSION 0x010001
  29. /*
  30. * IOCTLs (0x00 - 0x7f)
  31. */
  32. struct input_id {
  33. __u16 bustype;
  34. __u16 vendor;
  35. __u16 product;
  36. __u16 version;
  37. };
  38. /**
  39. * struct input_absinfo - used by EVIOCGABS/EVIOCSABS ioctls
  40. * @value: latest reported value for the axis.
  41. * @minimum: specifies minimum value for the axis.
  42. * @maximum: specifies maximum value for the axis.
  43. * @fuzz: specifies fuzz value that is used to filter noise from
  44. * the event stream.
  45. * @flat: values that are within this value will be discarded by
  46. * joydev interface and reported as 0 instead.
  47. * @resolution: specifies resolution for the values reported for
  48. * the axis.
  49. *
  50. * Note that input core does not clamp reported values to the
  51. * [minimum, maximum] limits, such task is left to userspace.
  52. *
  53. * Resolution for main axes (ABS_X, ABS_Y, ABS_Z) is reported in
  54. * units per millimeter (units/mm), resolution for rotational axes
  55. * (ABS_RX, ABS_RY, ABS_RZ) is reported in units per radian.
  56. */
  57. struct input_absinfo {
  58. __s32 value;
  59. __s32 minimum;
  60. __s32 maximum;
  61. __s32 fuzz;
  62. __s32 flat;
  63. __s32 resolution;
  64. };
  65. /**
  66. * struct input_keymap_entry - used by EVIOCGKEYCODE/EVIOCSKEYCODE ioctls
  67. * @scancode: scancode represented in machine-endian form.
  68. * @len: length of the scancode that resides in @scancode buffer.
  69. * @index: index in the keymap, may be used instead of scancode
  70. * @flags: allows to specify how kernel should handle the request. For
  71. * example, setting INPUT_KEYMAP_BY_INDEX flag indicates that kernel
  72. * should perform lookup in keymap by @index instead of @scancode
  73. * @keycode: key code assigned to this scancode
  74. *
  75. * The structure is used to retrieve and modify keymap data. Users have
  76. * option of performing lookup either by @scancode itself or by @index
  77. * in keymap entry. EVIOCGKEYCODE will also return scancode or index
  78. * (depending on which element was used to perform lookup).
  79. */
  80. struct input_keymap_entry {
  81. #define INPUT_KEYMAP_BY_INDEX (1 << 0)
  82. __u8 flags;
  83. __u8 len;
  84. __u16 index;
  85. __u32 keycode;
  86. __u8 scancode[32];
  87. };
  88. #define EVIOCGVERSION _IOR('E', 0x01, int) /* get driver version */
  89. #define EVIOCGID _IOR('E', 0x02, struct input_id) /* get device ID */
  90. #define EVIOCGREP _IOR('E', 0x03, unsigned int[2]) /* get repeat settings */
  91. #define EVIOCSREP _IOW('E', 0x03, unsigned int[2]) /* set repeat settings */
  92. #define EVIOCGKEYCODE _IOR('E', 0x04, unsigned int[2]) /* get keycode */
  93. #define EVIOCGKEYCODE_V2 _IOR('E', 0x04, struct input_keymap_entry)
  94. #define EVIOCSKEYCODE _IOW('E', 0x04, unsigned int[2]) /* set keycode */
  95. #define EVIOCSKEYCODE_V2 _IOW('E', 0x04, struct input_keymap_entry)
  96. #define EVIOCGNAME(len) _IOC(_IOC_READ, 'E', 0x06, len) /* get device name */
  97. #define EVIOCGPHYS(len) _IOC(_IOC_READ, 'E', 0x07, len) /* get physical location */
  98. #define EVIOCGUNIQ(len) _IOC(_IOC_READ, 'E', 0x08, len) /* get unique identifier */
  99. #define EVIOCGPROP(len) _IOC(_IOC_READ, 'E', 0x09, len) /* get device properties */
  100. /**
  101. * EVIOCGMTSLOTS(len) - get MT slot values
  102. * @len: size of the data buffer in bytes
  103. *
  104. * The ioctl buffer argument should be binary equivalent to
  105. *
  106. * struct input_mt_request_layout {
  107. * __u32 code;
  108. * __s32 values[num_slots];
  109. * };
  110. *
  111. * where num_slots is the (arbitrary) number of MT slots to extract.
  112. *
  113. * The ioctl size argument (len) is the size of the buffer, which
  114. * should satisfy len = (num_slots + 1) * sizeof(__s32). If len is
  115. * too small to fit all available slots, the first num_slots are
  116. * returned.
  117. *
  118. * Before the call, code is set to the wanted ABS_MT event type. On
  119. * return, values[] is filled with the slot values for the specified
  120. * ABS_MT code.
  121. *
  122. * If the request code is not an ABS_MT value, -EINVAL is returned.
  123. */
  124. #define EVIOCGMTSLOTS(len) _IOC(_IOC_READ, 'E', 0x0a, len)
  125. #define EVIOCGKEY(len) _IOC(_IOC_READ, 'E', 0x18, len) /* get global key state */
  126. #define EVIOCGLED(len) _IOC(_IOC_READ, 'E', 0x19, len) /* get all LEDs */
  127. #define EVIOCGSND(len) _IOC(_IOC_READ, 'E', 0x1a, len) /* get all sounds status */
  128. #define EVIOCGSW(len) _IOC(_IOC_READ, 'E', 0x1b, len) /* get all switch states */
  129. #define EVIOCGBIT(ev,len) _IOC(_IOC_READ, 'E', 0x20 + (ev), len) /* get event bits */
  130. #define EVIOCGABS(abs) _IOR('E', 0x40 + (abs), struct input_absinfo) /* get abs value/limits */
  131. #define EVIOCSABS(abs) _IOW('E', 0xc0 + (abs), struct input_absinfo) /* set abs value/limits */
  132. #define EVIOCSFF _IOC(_IOC_WRITE, 'E', 0x80, sizeof(struct ff_effect)) /* send a force effect to a force feedback device */
  133. #define EVIOCRMFF _IOW('E', 0x81, int) /* Erase a force effect */
  134. #define EVIOCGEFFECTS _IOR('E', 0x84, int) /* Report number of effects playable at the same time */
  135. #define EVIOCGRAB _IOW('E', 0x90, int) /* Grab/Release device */
  136. #define EVIOCREVOKE _IOW('E', 0x91, int) /* Revoke device access */
  137. #define EVIOCSCLOCKID _IOW('E', 0xa0, int) /* Set clockid to be used for timestamps */
  138. /*
  139. * Device properties and quirks
  140. */
  141. #define INPUT_PROP_POINTER 0x00 /* needs a pointer */
  142. #define INPUT_PROP_DIRECT 0x01 /* direct input devices */
  143. #define INPUT_PROP_BUTTONPAD 0x02 /* has button(s) under pad */
  144. #define INPUT_PROP_SEMI_MT 0x03 /* touch rectangle only */
  145. #define INPUT_PROP_TOPBUTTONPAD 0x04 /* softbuttons at top of pad */
  146. #define INPUT_PROP_MAX 0x1f
  147. #define INPUT_PROP_CNT (INPUT_PROP_MAX + 1)
  148. /*
  149. * Event types
  150. */
  151. #define EV_SYN 0x00
  152. #define EV_KEY 0x01
  153. #define EV_REL 0x02
  154. #define EV_ABS 0x03
  155. #define EV_MSC 0x04
  156. #define EV_SW 0x05
  157. #define EV_LED 0x11
  158. #define EV_SND 0x12
  159. #define EV_REP 0x14
  160. #define EV_FF 0x15
  161. #define EV_PWR 0x16
  162. #define EV_FF_STATUS 0x17
  163. #define EV_MAX 0x1f
  164. #define EV_CNT (EV_MAX+1)
  165. /*
  166. * Synchronization events.
  167. */
  168. #define SYN_REPORT 0
  169. #define SYN_CONFIG 1
  170. #define SYN_MT_REPORT 2
  171. #define SYN_DROPPED 3
  172. #define SYN_MAX 0xf
  173. #define SYN_CNT (SYN_MAX+1)
  174. /*
  175. * Keys and buttons
  176. *
  177. * Most of the keys/buttons are modeled after USB HUT 1.12
  178. * (see http://www.usb.org/developers/hidpage).
  179. * Abbreviations in the comments:
  180. * AC - Application Control
  181. * AL - Application Launch Button
  182. * SC - System Control
  183. */
  184. #define KEY_RESERVED 0
  185. #define KEY_ESC 1
  186. #define KEY_1 2
  187. #define KEY_2 3
  188. #define KEY_3 4
  189. #define KEY_4 5
  190. #define KEY_5 6
  191. #define KEY_6 7
  192. #define KEY_7 8
  193. #define KEY_8 9
  194. #define KEY_9 10
  195. #define KEY_0 11
  196. #define KEY_MINUS 12
  197. #define KEY_EQUAL 13
  198. #define KEY_BACKSPACE 14
  199. #define KEY_TAB 15
  200. #define KEY_Q 16
  201. #define KEY_W 17
  202. #define KEY_E 18
  203. #define KEY_R 19
  204. #define KEY_T 20
  205. #define KEY_Y 21
  206. #define KEY_U 22
  207. #define KEY_I 23
  208. #define KEY_O 24
  209. #define KEY_P 25
  210. #define KEY_LEFTBRACE 26
  211. #define KEY_RIGHTBRACE 27
  212. #define KEY_ENTER 28
  213. #define KEY_LEFTCTRL 29
  214. #define KEY_A 30
  215. #define KEY_S 31
  216. #define KEY_D 32
  217. #define KEY_F 33
  218. #define KEY_G 34
  219. #define KEY_H 35
  220. #define KEY_J 36
  221. #define KEY_K 37
  222. #define KEY_L 38
  223. #define KEY_SEMICOLON 39
  224. #define KEY_APOSTROPHE 40
  225. #define KEY_GRAVE 41
  226. #define KEY_LEFTSHIFT 42
  227. #define KEY_BACKSLASH 43
  228. #define KEY_Z 44
  229. #define KEY_X 45
  230. #define KEY_C 46
  231. #define KEY_V 47
  232. #define KEY_B 48
  233. #define KEY_N 49
  234. #define KEY_M 50
  235. #define KEY_COMMA 51
  236. #define KEY_DOT 52
  237. #define KEY_SLASH 53
  238. #define KEY_RIGHTSHIFT 54
  239. #define KEY_KPASTERISK 55
  240. #define KEY_LEFTALT 56
  241. #define KEY_SPACE 57
  242. #define KEY_CAPSLOCK 58
  243. #define KEY_F1 59
  244. #define KEY_F2 60
  245. #define KEY_F3 61
  246. #define KEY_F4 62
  247. #define KEY_F5 63
  248. #define KEY_F6 64
  249. #define KEY_F7 65
  250. #define KEY_F8 66
  251. #define KEY_F9 67
  252. #define KEY_F10 68
  253. #define KEY_NUMLOCK 69
  254. #define KEY_SCROLLLOCK 70
  255. #define KEY_KP7 71
  256. #define KEY_KP8 72
  257. #define KEY_KP9 73
  258. #define KEY_KPMINUS 74
  259. #define KEY_KP4 75
  260. #define KEY_KP5 76
  261. #define KEY_KP6 77
  262. #define KEY_KPPLUS 78
  263. #define KEY_KP1 79
  264. #define KEY_KP2 80
  265. #define KEY_KP3 81
  266. #define KEY_KP0 82
  267. #define KEY_KPDOT 83
  268. #define KEY_ZENKAKUHANKAKU 85
  269. #define KEY_102ND 86
  270. #define KEY_F11 87
  271. #define KEY_F12 88
  272. #define KEY_RO 89
  273. #define KEY_KATAKANA 90
  274. #define KEY_HIRAGANA 91
  275. #define KEY_HENKAN 92
  276. #define KEY_KATAKANAHIRAGANA 93
  277. #define KEY_MUHENKAN 94
  278. #define KEY_KPJPCOMMA 95
  279. #define KEY_KPENTER 96
  280. #define KEY_RIGHTCTRL 97
  281. #define KEY_KPSLASH 98
  282. #define KEY_SYSRQ 99
  283. #define KEY_RIGHTALT 100
  284. #define KEY_LINEFEED 101
  285. #define KEY_HOME 102
  286. #define KEY_UP 103
  287. #define KEY_PAGEUP 104
  288. #define KEY_LEFT 105
  289. #define KEY_RIGHT 106
  290. #define KEY_END 107
  291. #define KEY_DOWN 108
  292. #define KEY_PAGEDOWN 109
  293. #define KEY_INSERT 110
  294. #define KEY_DELETE 111
  295. #define KEY_MACRO 112
  296. #define KEY_MUTE 113
  297. #define KEY_VOLUMEDOWN 114
  298. #define KEY_VOLUMEUP 115
  299. #define KEY_POWER 116 /* SC System Power Down */
  300. #define KEY_KPEQUAL 117
  301. #define KEY_KPPLUSMINUS 118
  302. #define KEY_PAUSE 119
  303. #define KEY_SCALE 120 /* AL Compiz Scale (Expose) */
  304. #define KEY_KPCOMMA 121
  305. #define KEY_HANGEUL 122
  306. #define KEY_HANGUEL KEY_HANGEUL
  307. #define KEY_HANJA 123
  308. #define KEY_YEN 124
  309. #define KEY_LEFTMETA 125
  310. #define KEY_RIGHTMETA 126
  311. #define KEY_COMPOSE 127
  312. #define KEY_STOP 128 /* AC Stop */
  313. #define KEY_AGAIN 129
  314. #define KEY_PROPS 130 /* AC Properties */
  315. #define KEY_UNDO 131 /* AC Undo */
  316. #define KEY_FRONT 132
  317. #define KEY_COPY 133 /* AC Copy */
  318. #define KEY_OPEN 134 /* AC Open */
  319. #define KEY_PASTE 135 /* AC Paste */
  320. #define KEY_FIND 136 /* AC Search */
  321. #define KEY_CUT 137 /* AC Cut */
  322. #define KEY_HELP 138 /* AL Integrated Help Center */
  323. #define KEY_MENU 139 /* Menu (show menu) */
  324. #define KEY_CALC 140 /* AL Calculator */
  325. #define KEY_SETUP 141
  326. #define KEY_SLEEP 142 /* SC System Sleep */
  327. #define KEY_WAKEUP 143 /* System Wake Up */
  328. #define KEY_FILE 144 /* AL Local Machine Browser */
  329. #define KEY_SENDFILE 145
  330. #define KEY_DELETEFILE 146
  331. #define KEY_XFER 147
  332. #define KEY_PROG1 148
  333. #define KEY_PROG2 149
  334. #define KEY_WWW 150 /* AL Internet Browser */
  335. #define KEY_MSDOS 151
  336. #define KEY_COFFEE 152 /* AL Terminal Lock/Screensaver */
  337. #define KEY_SCREENLOCK KEY_COFFEE
  338. #define KEY_DIRECTION 153
  339. #define KEY_CYCLEWINDOWS 154
  340. #define KEY_MAIL 155
  341. #define KEY_BOOKMARKS 156 /* AC Bookmarks */
  342. #define KEY_COMPUTER 157
  343. #define KEY_BACK 158 /* AC Back */
  344. #define KEY_FORWARD 159 /* AC Forward */
  345. #define KEY_CLOSECD 160
  346. #define KEY_EJECTCD 161
  347. #define KEY_EJECTCLOSECD 162
  348. #define KEY_NEXTSONG 163
  349. #define KEY_PLAYPAUSE 164
  350. #define KEY_PREVIOUSSONG 165
  351. #define KEY_STOPCD 166
  352. #define KEY_RECORD 167
  353. #define KEY_REWIND 168
  354. #define KEY_PHONE 169 /* Media Select Telephone */
  355. #define KEY_ISO 170
  356. #define KEY_CONFIG 171 /* AL Consumer Control Configuration */
  357. #define KEY_HOMEPAGE 172 /* AC Home */
  358. #define KEY_REFRESH 173 /* AC Refresh */
  359. #define KEY_EXIT 174 /* AC Exit */
  360. #define KEY_MOVE 175
  361. #define KEY_EDIT 176
  362. #define KEY_SCROLLUP 177
  363. #define KEY_SCROLLDOWN 178
  364. #define KEY_KPLEFTPAREN 179
  365. #define KEY_KPRIGHTPAREN 180
  366. #define KEY_NEW 181 /* AC New */
  367. #define KEY_REDO 182 /* AC Redo/Repeat */
  368. #define KEY_F13 183
  369. #define KEY_F14 184
  370. #define KEY_F15 185
  371. #define KEY_F16 186
  372. #define KEY_F17 187
  373. #define KEY_F18 188
  374. #define KEY_F19 189
  375. #define KEY_F20 190
  376. #define KEY_F21 191
  377. #define KEY_F22 192
  378. #define KEY_F23 193
  379. #define KEY_F24 194
  380. #define KEY_PLAYCD 200
  381. #define KEY_PAUSECD 201
  382. #define KEY_PROG3 202
  383. #define KEY_PROG4 203
  384. #define KEY_DASHBOARD 204 /* AL Dashboard */
  385. #define KEY_SUSPEND 205
  386. #define KEY_CLOSE 206 /* AC Close */
  387. #define KEY_PLAY 207
  388. #define KEY_FASTFORWARD 208
  389. #define KEY_BASSBOOST 209
  390. #define KEY_PRINT 210 /* AC Print */
  391. #define KEY_HP 211
  392. #define KEY_CAMERA 212
  393. #define KEY_SOUND 213
  394. #define KEY_QUESTION 214
  395. #define KEY_EMAIL 215
  396. #define KEY_CHAT 216
  397. #define KEY_SEARCH 217
  398. #define KEY_CONNECT 218
  399. #define KEY_FINANCE 219 /* AL Checkbook/Finance */
  400. #define KEY_SPORT 220
  401. #define KEY_SHOP 221
  402. #define KEY_ALTERASE 222
  403. #define KEY_CANCEL 223 /* AC Cancel */
  404. #define KEY_BRIGHTNESSDOWN 224
  405. #define KEY_BRIGHTNESSUP 225
  406. #define KEY_MEDIA 226
  407. #define KEY_SWITCHVIDEOMODE 227 /* Cycle between available video
  408. outputs (Monitor/LCD/TV-out/etc) */
  409. #define KEY_KBDILLUMTOGGLE 228
  410. #define KEY_KBDILLUMDOWN 229
  411. #define KEY_KBDILLUMUP 230
  412. #define KEY_SEND 231 /* AC Send */
  413. #define KEY_REPLY 232 /* AC Reply */
  414. #define KEY_FORWARDMAIL 233 /* AC Forward Msg */
  415. #define KEY_SAVE 234 /* AC Save */
  416. #define KEY_DOCUMENTS 235
  417. #define KEY_BATTERY 236
  418. #define KEY_BLUETOOTH 237
  419. #define KEY_WLAN 238
  420. #define KEY_UWB 239
  421. #define KEY_UNKNOWN 240
  422. #define KEY_VIDEO_NEXT 241 /* drive next video source */
  423. #define KEY_VIDEO_PREV 242 /* drive previous video source */
  424. #define KEY_BRIGHTNESS_CYCLE 243 /* brightness up, after max is min */
  425. #define KEY_BRIGHTNESS_AUTO 244 /* Set Auto Brightness: manual
  426. brightness control is off,
  427. rely on ambient */
  428. #define KEY_BRIGHTNESS_ZERO KEY_BRIGHTNESS_AUTO
  429. #define KEY_DISPLAY_OFF 245 /* display device to off state */
  430. #define KEY_WWAN 246 /* Wireless WAN (LTE, UMTS, GSM, etc.) */
  431. #define KEY_WIMAX KEY_WWAN
  432. #define KEY_RFKILL 247 /* Key that controls all radios */
  433. #define KEY_MICMUTE 248 /* Mute / unmute the microphone */
  434. /* Code 255 is reserved for special needs of AT keyboard driver */
  435. #define BTN_MISC 0x100
  436. #define BTN_0 0x100
  437. #define BTN_1 0x101
  438. #define BTN_2 0x102
  439. #define BTN_3 0x103
  440. #define BTN_4 0x104
  441. #define BTN_5 0x105
  442. #define BTN_6 0x106
  443. #define BTN_7 0x107
  444. #define BTN_8 0x108
  445. #define BTN_9 0x109
  446. #define BTN_MOUSE 0x110
  447. #define BTN_LEFT 0x110
  448. #define BTN_RIGHT 0x111
  449. #define BTN_MIDDLE 0x112
  450. #define BTN_SIDE 0x113
  451. #define BTN_EXTRA 0x114
  452. #define BTN_FORWARD 0x115
  453. #define BTN_BACK 0x116
  454. #define BTN_TASK 0x117
  455. #define BTN_JOYSTICK 0x120
  456. #define BTN_TRIGGER 0x120
  457. #define BTN_THUMB 0x121
  458. #define BTN_THUMB2 0x122
  459. #define BTN_TOP 0x123
  460. #define BTN_TOP2 0x124
  461. #define BTN_PINKIE 0x125
  462. #define BTN_BASE 0x126
  463. #define BTN_BASE2 0x127
  464. #define BTN_BASE3 0x128
  465. #define BTN_BASE4 0x129
  466. #define BTN_BASE5 0x12a
  467. #define BTN_BASE6 0x12b
  468. #define BTN_DEAD 0x12f
  469. #define BTN_GAMEPAD 0x130
  470. #define BTN_SOUTH 0x130
  471. #define BTN_A BTN_SOUTH
  472. #define BTN_EAST 0x131
  473. #define BTN_B BTN_EAST
  474. #define BTN_C 0x132
  475. #define BTN_NORTH 0x133
  476. #define BTN_X BTN_NORTH
  477. #define BTN_WEST 0x134
  478. #define BTN_Y BTN_WEST
  479. #define BTN_Z 0x135
  480. #define BTN_TL 0x136
  481. #define BTN_TR 0x137
  482. #define BTN_TL2 0x138
  483. #define BTN_TR2 0x139
  484. #define BTN_SELECT 0x13a
  485. #define BTN_START 0x13b
  486. #define BTN_MODE 0x13c
  487. #define BTN_THUMBL 0x13d
  488. #define BTN_THUMBR 0x13e
  489. #define BTN_DIGI 0x140
  490. #define BTN_TOOL_PEN 0x140
  491. #define BTN_TOOL_RUBBER 0x141
  492. #define BTN_TOOL_BRUSH 0x142
  493. #define BTN_TOOL_PENCIL 0x143
  494. #define BTN_TOOL_AIRBRUSH 0x144
  495. #define BTN_TOOL_FINGER 0x145
  496. #define BTN_TOOL_MOUSE 0x146
  497. #define BTN_TOOL_LENS 0x147
  498. #define BTN_TOOL_QUINTTAP 0x148 /* Five fingers on trackpad */
  499. #define BTN_TOUCH 0x14a
  500. #define BTN_STYLUS 0x14b
  501. #define BTN_STYLUS2 0x14c
  502. #define BTN_TOOL_DOUBLETAP 0x14d
  503. #define BTN_TOOL_TRIPLETAP 0x14e
  504. #define BTN_TOOL_QUADTAP 0x14f /* Four fingers on trackpad */
  505. #define BTN_WHEEL 0x150
  506. #define BTN_GEAR_DOWN 0x150
  507. #define BTN_GEAR_UP 0x151
  508. #define KEY_OK 0x160
  509. #define KEY_SELECT 0x161
  510. #define KEY_GOTO 0x162
  511. #define KEY_CLEAR 0x163
  512. #define KEY_POWER2 0x164
  513. #define KEY_OPTION 0x165
  514. #define KEY_INFO 0x166 /* AL OEM Features/Tips/Tutorial */
  515. #define KEY_TIME 0x167
  516. #define KEY_VENDOR 0x168
  517. #define KEY_ARCHIVE 0x169
  518. #define KEY_PROGRAM 0x16a /* Media Select Program Guide */
  519. #define KEY_CHANNEL 0x16b
  520. #define KEY_FAVORITES 0x16c
  521. #define KEY_EPG 0x16d
  522. #define KEY_PVR 0x16e /* Media Select Home */
  523. #define KEY_MHP 0x16f
  524. #define KEY_LANGUAGE 0x170
  525. #define KEY_TITLE 0x171
  526. #define KEY_SUBTITLE 0x172
  527. #define KEY_ANGLE 0x173
  528. #define KEY_ZOOM 0x174
  529. #define KEY_MODE 0x175
  530. #define KEY_KEYBOARD 0x176
  531. #define KEY_SCREEN 0x177
  532. #define KEY_PC 0x178 /* Media Select Computer */
  533. #define KEY_TV 0x179 /* Media Select TV */
  534. #define KEY_TV2 0x17a /* Media Select Cable */
  535. #define KEY_VCR 0x17b /* Media Select VCR */
  536. #define KEY_VCR2 0x17c /* VCR Plus */
  537. #define KEY_SAT 0x17d /* Media Select Satellite */
  538. #define KEY_SAT2 0x17e
  539. #define KEY_CD 0x17f /* Media Select CD */
  540. #define KEY_TAPE 0x180 /* Media Select Tape */
  541. #define KEY_RADIO 0x181
  542. #define KEY_TUNER 0x182 /* Media Select Tuner */
  543. #define KEY_PLAYER 0x183
  544. #define KEY_TEXT 0x184
  545. #define KEY_DVD 0x185 /* Media Select DVD */
  546. #define KEY_AUX 0x186
  547. #define KEY_MP3 0x187
  548. #define KEY_AUDIO 0x188 /* AL Audio Browser */
  549. #define KEY_VIDEO 0x189 /* AL Movie Browser */
  550. #define KEY_DIRECTORY 0x18a
  551. #define KEY_LIST 0x18b
  552. #define KEY_MEMO 0x18c /* Media Select Messages */
  553. #define KEY_CALENDAR 0x18d
  554. #define KEY_RED 0x18e
  555. #define KEY_GREEN 0x18f
  556. #define KEY_YELLOW 0x190
  557. #define KEY_BLUE 0x191
  558. #define KEY_CHANNELUP 0x192 /* Channel Increment */
  559. #define KEY_CHANNELDOWN 0x193 /* Channel Decrement */
  560. #define KEY_FIRST 0x194
  561. #define KEY_LAST 0x195 /* Recall Last */
  562. #define KEY_AB 0x196
  563. #define KEY_NEXT 0x197
  564. #define KEY_RESTART 0x198
  565. #define KEY_SLOW 0x199
  566. #define KEY_SHUFFLE 0x19a
  567. #define KEY_BREAK 0x19b
  568. #define KEY_PREVIOUS 0x19c
  569. #define KEY_DIGITS 0x19d
  570. #define KEY_TEEN 0x19e
  571. #define KEY_TWEN 0x19f
  572. #define KEY_VIDEOPHONE 0x1a0 /* Media Select Video Phone */
  573. #define KEY_GAMES 0x1a1 /* Media Select Games */
  574. #define KEY_ZOOMIN 0x1a2 /* AC Zoom In */
  575. #define KEY_ZOOMOUT 0x1a3 /* AC Zoom Out */
  576. #define KEY_ZOOMRESET 0x1a4 /* AC Zoom */
  577. #define KEY_WORDPROCESSOR 0x1a5 /* AL Word Processor */
  578. #define KEY_EDITOR 0x1a6 /* AL Text Editor */
  579. #define KEY_SPREADSHEET 0x1a7 /* AL Spreadsheet */
  580. #define KEY_GRAPHICSEDITOR 0x1a8 /* AL Graphics Editor */
  581. #define KEY_PRESENTATION 0x1a9 /* AL Presentation App */
  582. #define KEY_DATABASE 0x1aa /* AL Database App */
  583. #define KEY_NEWS 0x1ab /* AL Newsreader */
  584. #define KEY_VOICEMAIL 0x1ac /* AL Voicemail */
  585. #define KEY_ADDRESSBOOK 0x1ad /* AL Contacts/Address Book */
  586. #define KEY_MESSENGER 0x1ae /* AL Instant Messaging */
  587. #define KEY_DISPLAYTOGGLE 0x1af /* Turn display (LCD) on and off */
  588. #define KEY_BRIGHTNESS_TOGGLE KEY_DISPLAYTOGGLE
  589. #define KEY_SPELLCHECK 0x1b0 /* AL Spell Check */
  590. #define KEY_LOGOFF 0x1b1 /* AL Logoff */
  591. #define KEY_DOLLAR 0x1b2
  592. #define KEY_EURO 0x1b3
  593. #define KEY_FRAMEBACK 0x1b4 /* Consumer - transport controls */
  594. #define KEY_FRAMEFORWARD 0x1b5
  595. #define KEY_CONTEXT_MENU 0x1b6 /* GenDesc - system context menu */
  596. #define KEY_MEDIA_REPEAT 0x1b7 /* Consumer - transport control */
  597. #define KEY_10CHANNELSUP 0x1b8 /* 10 channels up (10+) */
  598. #define KEY_10CHANNELSDOWN 0x1b9 /* 10 channels down (10-) */
  599. #define KEY_IMAGES 0x1ba /* AL Image Browser */
  600. #define KEY_DEL_EOL 0x1c0
  601. #define KEY_DEL_EOS 0x1c1
  602. #define KEY_INS_LINE 0x1c2
  603. #define KEY_DEL_LINE 0x1c3
  604. #define KEY_FN 0x1d0
  605. #define KEY_FN_ESC 0x1d1
  606. #define KEY_FN_F1 0x1d2
  607. #define KEY_FN_F2 0x1d3
  608. #define KEY_FN_F3 0x1d4
  609. #define KEY_FN_F4 0x1d5
  610. #define KEY_FN_F5 0x1d6
  611. #define KEY_FN_F6 0x1d7
  612. #define KEY_FN_F7 0x1d8
  613. #define KEY_FN_F8 0x1d9
  614. #define KEY_FN_F9 0x1da
  615. #define KEY_FN_F10 0x1db
  616. #define KEY_FN_F11 0x1dc
  617. #define KEY_FN_F12 0x1dd
  618. #define KEY_FN_1 0x1de
  619. #define KEY_FN_2 0x1df
  620. #define KEY_FN_D 0x1e0
  621. #define KEY_FN_E 0x1e1
  622. #define KEY_FN_F 0x1e2
  623. #define KEY_FN_S 0x1e3
  624. #define KEY_FN_B 0x1e4
  625. #define KEY_BRL_DOT1 0x1f1
  626. #define KEY_BRL_DOT2 0x1f2
  627. #define KEY_BRL_DOT3 0x1f3
  628. #define KEY_BRL_DOT4 0x1f4
  629. #define KEY_BRL_DOT5 0x1f5
  630. #define KEY_BRL_DOT6 0x1f6
  631. #define KEY_BRL_DOT7 0x1f7
  632. #define KEY_BRL_DOT8 0x1f8
  633. #define KEY_BRL_DOT9 0x1f9
  634. #define KEY_BRL_DOT10 0x1fa
  635. #define KEY_NUMERIC_0 0x200 /* used by phones, remote controls, */
  636. #define KEY_NUMERIC_1 0x201 /* and other keypads */
  637. #define KEY_NUMERIC_2 0x202
  638. #define KEY_NUMERIC_3 0x203
  639. #define KEY_NUMERIC_4 0x204
  640. #define KEY_NUMERIC_5 0x205
  641. #define KEY_NUMERIC_6 0x206
  642. #define KEY_NUMERIC_7 0x207
  643. #define KEY_NUMERIC_8 0x208
  644. #define KEY_NUMERIC_9 0x209
  645. #define KEY_NUMERIC_STAR 0x20a
  646. #define KEY_NUMERIC_POUND 0x20b
  647. #define KEY_CAMERA_FOCUS 0x210
  648. #define KEY_WPS_BUTTON 0x211 /* WiFi Protected Setup key */
  649. #define KEY_TOUCHPAD_TOGGLE 0x212 /* Request switch touchpad on or off */
  650. #define KEY_TOUCHPAD_ON 0x213
  651. #define KEY_TOUCHPAD_OFF 0x214
  652. #define KEY_CAMERA_ZOOMIN 0x215
  653. #define KEY_CAMERA_ZOOMOUT 0x216
  654. #define KEY_CAMERA_UP 0x217
  655. #define KEY_CAMERA_DOWN 0x218
  656. #define KEY_CAMERA_LEFT 0x219
  657. #define KEY_CAMERA_RIGHT 0x21a
  658. #define KEY_ATTENDANT_ON 0x21b
  659. #define KEY_ATTENDANT_OFF 0x21c
  660. #define KEY_ATTENDANT_TOGGLE 0x21d /* Attendant call on or off */
  661. #define KEY_LIGHTS_TOGGLE 0x21e /* Reading light on or off */
  662. #define BTN_DPAD_UP 0x220
  663. #define BTN_DPAD_DOWN 0x221
  664. #define BTN_DPAD_LEFT 0x222
  665. #define BTN_DPAD_RIGHT 0x223
  666. #define KEY_ALS_TOGGLE 0x230 /* Ambient light sensor */
  667. #define KEY_BUTTONCONFIG 0x240 /* AL Button Configuration */
  668. #define KEY_TASKMANAGER 0x241 /* AL Task/Project Manager */
  669. #define KEY_JOURNAL 0x242 /* AL Log/Journal/Timecard */
  670. #define KEY_CONTROLPANEL 0x243 /* AL Control Panel */
  671. #define KEY_APPSELECT 0x244 /* AL Select Task/Application */
  672. #define KEY_SCREENSAVER 0x245 /* AL Screen Saver */
  673. #define KEY_VOICECOMMAND 0x246 /* Listening Voice Command */
  674. #define KEY_BRIGHTNESS_MIN 0x250 /* Set Brightness to Minimum */
  675. #define KEY_BRIGHTNESS_MAX 0x251 /* Set Brightness to Maximum */
  676. #define BTN_TRIGGER_HAPPY 0x2c0
  677. #define BTN_TRIGGER_HAPPY1 0x2c0
  678. #define BTN_TRIGGER_HAPPY2 0x2c1
  679. #define BTN_TRIGGER_HAPPY3 0x2c2
  680. #define BTN_TRIGGER_HAPPY4 0x2c3
  681. #define BTN_TRIGGER_HAPPY5 0x2c4
  682. #define BTN_TRIGGER_HAPPY6 0x2c5
  683. #define BTN_TRIGGER_HAPPY7 0x2c6
  684. #define BTN_TRIGGER_HAPPY8 0x2c7
  685. #define BTN_TRIGGER_HAPPY9 0x2c8
  686. #define BTN_TRIGGER_HAPPY10 0x2c9
  687. #define BTN_TRIGGER_HAPPY11 0x2ca
  688. #define BTN_TRIGGER_HAPPY12 0x2cb
  689. #define BTN_TRIGGER_HAPPY13 0x2cc
  690. #define BTN_TRIGGER_HAPPY14 0x2cd
  691. #define BTN_TRIGGER_HAPPY15 0x2ce
  692. #define BTN_TRIGGER_HAPPY16 0x2cf
  693. #define BTN_TRIGGER_HAPPY17 0x2d0
  694. #define BTN_TRIGGER_HAPPY18 0x2d1
  695. #define BTN_TRIGGER_HAPPY19 0x2d2
  696. #define BTN_TRIGGER_HAPPY20 0x2d3
  697. #define BTN_TRIGGER_HAPPY21 0x2d4
  698. #define BTN_TRIGGER_HAPPY22 0x2d5
  699. #define BTN_TRIGGER_HAPPY23 0x2d6
  700. #define BTN_TRIGGER_HAPPY24 0x2d7
  701. #define BTN_TRIGGER_HAPPY25 0x2d8
  702. #define BTN_TRIGGER_HAPPY26 0x2d9
  703. #define BTN_TRIGGER_HAPPY27 0x2da
  704. #define BTN_TRIGGER_HAPPY28 0x2db
  705. #define BTN_TRIGGER_HAPPY29 0x2dc
  706. #define BTN_TRIGGER_HAPPY30 0x2dd
  707. #define BTN_TRIGGER_HAPPY31 0x2de
  708. #define BTN_TRIGGER_HAPPY32 0x2df
  709. #define BTN_TRIGGER_HAPPY33 0x2e0
  710. #define BTN_TRIGGER_HAPPY34 0x2e1
  711. #define BTN_TRIGGER_HAPPY35 0x2e2
  712. #define BTN_TRIGGER_HAPPY36 0x2e3
  713. #define BTN_TRIGGER_HAPPY37 0x2e4
  714. #define BTN_TRIGGER_HAPPY38 0x2e5
  715. #define BTN_TRIGGER_HAPPY39 0x2e6
  716. #define BTN_TRIGGER_HAPPY40 0x2e7
  717. /* We avoid low common keys in module aliases so they don't get huge. */
  718. #define KEY_MIN_INTERESTING KEY_MUTE
  719. #define KEY_MAX 0x2ff
  720. #define KEY_CNT (KEY_MAX+1)
  721. /*
  722. * Relative axes
  723. */
  724. #define REL_X 0x00
  725. #define REL_Y 0x01
  726. #define REL_Z 0x02
  727. #define REL_RX 0x03
  728. #define REL_RY 0x04
  729. #define REL_RZ 0x05
  730. #define REL_HWHEEL 0x06
  731. #define REL_DIAL 0x07
  732. #define REL_WHEEL 0x08
  733. #define REL_MISC 0x09
  734. #define REL_MAX 0x0f
  735. #define REL_CNT (REL_MAX+1)
  736. /*
  737. * Absolute axes
  738. */
  739. #define ABS_X 0x00
  740. #define ABS_Y 0x01
  741. #define ABS_Z 0x02
  742. #define ABS_RX 0x03
  743. #define ABS_RY 0x04
  744. #define ABS_RZ 0x05
  745. #define ABS_THROTTLE 0x06
  746. #define ABS_RUDDER 0x07
  747. #define ABS_WHEEL 0x08
  748. #define ABS_GAS 0x09
  749. #define ABS_BRAKE 0x0a
  750. #define ABS_HAT0X 0x10
  751. #define ABS_HAT0Y 0x11
  752. #define ABS_HAT1X 0x12
  753. #define ABS_HAT1Y 0x13
  754. #define ABS_HAT2X 0x14
  755. #define ABS_HAT2Y 0x15
  756. #define ABS_HAT3X 0x16
  757. #define ABS_HAT3Y 0x17
  758. #define ABS_PRESSURE 0x18
  759. #define ABS_DISTANCE 0x19
  760. #define ABS_TILT_X 0x1a
  761. #define ABS_TILT_Y 0x1b
  762. #define ABS_TOOL_WIDTH 0x1c
  763. #define ABS_VOLUME 0x20
  764. #define ABS_MISC 0x28
  765. #define ABS_MT_SLOT 0x2f /* MT slot being modified */
  766. #define ABS_MT_TOUCH_MAJOR 0x30 /* Major axis of touching ellipse */
  767. #define ABS_MT_TOUCH_MINOR 0x31 /* Minor axis (omit if circular) */
  768. #define ABS_MT_WIDTH_MAJOR 0x32 /* Major axis of approaching ellipse */
  769. #define ABS_MT_WIDTH_MINOR 0x33 /* Minor axis (omit if circular) */
  770. #define ABS_MT_ORIENTATION 0x34 /* Ellipse orientation */
  771. #define ABS_MT_POSITION_X 0x35 /* Center X touch position */
  772. #define ABS_MT_POSITION_Y 0x36 /* Center Y touch position */
  773. #define ABS_MT_TOOL_TYPE 0x37 /* Type of touching device */
  774. #define ABS_MT_BLOB_ID 0x38 /* Group a set of packets as a blob */
  775. #define ABS_MT_TRACKING_ID 0x39 /* Unique ID of initiated contact */
  776. #define ABS_MT_PRESSURE 0x3a /* Pressure on contact area */
  777. #define ABS_MT_DISTANCE 0x3b /* Contact hover distance */
  778. #define ABS_MT_TOOL_X 0x3c /* Center X tool position */
  779. #define ABS_MT_TOOL_Y 0x3d /* Center Y tool position */
  780. #define ABS_MAX 0x3f
  781. #define ABS_CNT (ABS_MAX+1)
  782. /*
  783. * Switch events
  784. */
  785. #define SW_LID 0x00 /* set = lid shut */
  786. #define SW_TABLET_MODE 0x01 /* set = tablet mode */
  787. #define SW_HEADPHONE_INSERT 0x02 /* set = inserted */
  788. #define SW_RFKILL_ALL 0x03 /* rfkill master switch, type "any"
  789. set = radio enabled */
  790. #define SW_RADIO SW_RFKILL_ALL /* deprecated */
  791. #define SW_MICROPHONE_INSERT 0x04 /* set = inserted */
  792. #define SW_DOCK 0x05 /* set = plugged into dock */
  793. #define SW_LINEOUT_INSERT 0x06 /* set = inserted */
  794. #define SW_JACK_PHYSICAL_INSERT 0x07 /* set = mechanical switch set */
  795. #define SW_VIDEOOUT_INSERT 0x08 /* set = inserted */
  796. #define SW_CAMERA_LENS_COVER 0x09 /* set = lens covered */
  797. #define SW_KEYPAD_SLIDE 0x0a /* set = keypad slide out */
  798. #define SW_FRONT_PROXIMITY 0x0b /* set = front proximity sensor active */
  799. #define SW_ROTATE_LOCK 0x0c /* set = rotate locked/disabled */
  800. #define SW_LINEIN_INSERT 0x0d /* set = inserted */
  801. #define SW_MUTE_DEVICE 0x0e /* set = device disabled */
  802. #define SW_MAX 0x0f
  803. #define SW_CNT (SW_MAX+1)
  804. /*
  805. * Misc events
  806. */
  807. #define MSC_SERIAL 0x00
  808. #define MSC_PULSELED 0x01
  809. #define MSC_GESTURE 0x02
  810. #define MSC_RAW 0x03
  811. #define MSC_SCAN 0x04
  812. #define MSC_TIMESTAMP 0x05
  813. #define MSC_MAX 0x07
  814. #define MSC_CNT (MSC_MAX+1)
  815. /*
  816. * LEDs
  817. */
  818. #define LED_NUML 0x00
  819. #define LED_CAPSL 0x01
  820. #define LED_SCROLLL 0x02
  821. #define LED_COMPOSE 0x03
  822. #define LED_KANA 0x04
  823. #define LED_SLEEP 0x05
  824. #define LED_SUSPEND 0x06
  825. #define LED_MUTE 0x07
  826. #define LED_MISC 0x08
  827. #define LED_MAIL 0x09
  828. #define LED_CHARGING 0x0a
  829. #define LED_MAX 0x0f
  830. #define LED_CNT (LED_MAX+1)
  831. /*
  832. * Autorepeat values
  833. */
  834. #define REP_DELAY 0x00
  835. #define REP_PERIOD 0x01
  836. #define REP_MAX 0x01
  837. #define REP_CNT (REP_MAX+1)
  838. /*
  839. * Sounds
  840. */
  841. #define SND_CLICK 0x00
  842. #define SND_BELL 0x01
  843. #define SND_TONE 0x02
  844. #define SND_MAX 0x07
  845. #define SND_CNT (SND_MAX+1)
  846. /*
  847. * IDs.
  848. */
  849. #define ID_BUS 0
  850. #define ID_VENDOR 1
  851. #define ID_PRODUCT 2
  852. #define ID_VERSION 3
  853. #define BUS_PCI 0x01
  854. #define BUS_ISAPNP 0x02
  855. #define BUS_USB 0x03
  856. #define BUS_HIL 0x04
  857. #define BUS_BLUETOOTH 0x05
  858. #define BUS_VIRTUAL 0x06
  859. #define BUS_ISA 0x10
  860. #define BUS_I8042 0x11
  861. #define BUS_XTKBD 0x12
  862. #define BUS_RS232 0x13
  863. #define BUS_GAMEPORT 0x14
  864. #define BUS_PARPORT 0x15
  865. #define BUS_AMIGA 0x16
  866. #define BUS_ADB 0x17
  867. #define BUS_I2C 0x18
  868. #define BUS_HOST 0x19
  869. #define BUS_GSC 0x1A
  870. #define BUS_ATARI 0x1B
  871. #define BUS_SPI 0x1C
  872. /*
  873. * MT_TOOL types
  874. */
  875. #define MT_TOOL_FINGER 0
  876. #define MT_TOOL_PEN 1
  877. #define MT_TOOL_MAX 1
  878. /*
  879. * Values describing the status of a force-feedback effect
  880. */
  881. #define FF_STATUS_STOPPED 0x00
  882. #define FF_STATUS_PLAYING 0x01
  883. #define FF_STATUS_MAX 0x01
  884. /*
  885. * Structures used in ioctls to upload effects to a device
  886. * They are pieces of a bigger structure (called ff_effect)
  887. */
  888. /*
  889. * All duration values are expressed in ms. Values above 32767 ms (0x7fff)
  890. * should not be used and have unspecified results.
  891. */
  892. /**
  893. * struct ff_replay - defines scheduling of the force-feedback effect
  894. * @length: duration of the effect
  895. * @delay: delay before effect should start playing
  896. */
  897. struct ff_replay {
  898. __u16 length;
  899. __u16 delay;
  900. };
  901. /**
  902. * struct ff_trigger - defines what triggers the force-feedback effect
  903. * @button: number of the button triggering the effect
  904. * @interval: controls how soon the effect can be re-triggered
  905. */
  906. struct ff_trigger {
  907. __u16 button;
  908. __u16 interval;
  909. };
  910. /**
  911. * struct ff_envelope - generic force-feedback effect envelope
  912. * @attack_length: duration of the attack (ms)
  913. * @attack_level: level at the beginning of the attack
  914. * @fade_length: duration of fade (ms)
  915. * @fade_level: level at the end of fade
  916. *
  917. * The @attack_level and @fade_level are absolute values; when applying
  918. * envelope force-feedback core will convert to positive/negative
  919. * value based on polarity of the default level of the effect.
  920. * Valid range for the attack and fade levels is 0x0000 - 0x7fff
  921. */
  922. struct ff_envelope {
  923. __u16 attack_length;
  924. __u16 attack_level;
  925. __u16 fade_length;
  926. __u16 fade_level;
  927. };
  928. /**
  929. * struct ff_constant_effect - defines parameters of a constant force-feedback effect
  930. * @level: strength of the effect; may be negative
  931. * @envelope: envelope data
  932. */
  933. struct ff_constant_effect {
  934. __s16 level;
  935. struct ff_envelope envelope;
  936. };
  937. /**
  938. * struct ff_ramp_effect - defines parameters of a ramp force-feedback effect
  939. * @start_level: beginning strength of the effect; may be negative
  940. * @end_level: final strength of the effect; may be negative
  941. * @envelope: envelope data
  942. */
  943. struct ff_ramp_effect {
  944. __s16 start_level;
  945. __s16 end_level;
  946. struct ff_envelope envelope;
  947. };
  948. /**
  949. * struct ff_condition_effect - defines a spring or friction force-feedback effect
  950. * @right_saturation: maximum level when joystick moved all way to the right
  951. * @left_saturation: same for the left side
  952. * @right_coeff: controls how fast the force grows when the joystick moves
  953. * to the right
  954. * @left_coeff: same for the left side
  955. * @deadband: size of the dead zone, where no force is produced
  956. * @center: position of the dead zone
  957. */
  958. struct ff_condition_effect {
  959. __u16 right_saturation;
  960. __u16 left_saturation;
  961. __s16 right_coeff;
  962. __s16 left_coeff;
  963. __u16 deadband;
  964. __s16 center;
  965. };
  966. /**
  967. * struct ff_periodic_effect - defines parameters of a periodic force-feedback effect
  968. * @waveform: kind of the effect (wave)
  969. * @period: period of the wave (ms)
  970. * @magnitude: peak value
  971. * @offset: mean value of the wave (roughly)
  972. * @phase: 'horizontal' shift
  973. * @envelope: envelope data
  974. * @custom_len: number of samples (FF_CUSTOM only)
  975. * @custom_data: buffer of samples (FF_CUSTOM only)
  976. *
  977. * Known waveforms - FF_SQUARE, FF_TRIANGLE, FF_SINE, FF_SAW_UP,
  978. * FF_SAW_DOWN, FF_CUSTOM. The exact syntax FF_CUSTOM is undefined
  979. * for the time being as no driver supports it yet.
  980. *
  981. * Note: the data pointed by custom_data is copied by the driver.
  982. * You can therefore dispose of the memory after the upload/update.
  983. */
  984. struct ff_periodic_effect {
  985. __u16 waveform;
  986. __u16 period;
  987. __s16 magnitude;
  988. __s16 offset;
  989. __u16 phase;
  990. struct ff_envelope envelope;
  991. __u32 custom_len;
  992. __s16 __user *custom_data;
  993. };
  994. /**
  995. * struct ff_rumble_effect - defines parameters of a periodic force-feedback effect
  996. * @strong_magnitude: magnitude of the heavy motor
  997. * @weak_magnitude: magnitude of the light one
  998. *
  999. * Some rumble pads have two motors of different weight. Strong_magnitude
  1000. * represents the magnitude of the vibration generated by the heavy one.
  1001. */
  1002. struct ff_rumble_effect {
  1003. __u16 strong_magnitude;
  1004. __u16 weak_magnitude;
  1005. };
  1006. /**
  1007. * struct ff_effect - defines force feedback effect
  1008. * @type: type of the effect (FF_CONSTANT, FF_PERIODIC, FF_RAMP, FF_SPRING,
  1009. * FF_FRICTION, FF_DAMPER, FF_RUMBLE, FF_INERTIA, or FF_CUSTOM)
  1010. * @id: an unique id assigned to an effect
  1011. * @direction: direction of the effect
  1012. * @trigger: trigger conditions (struct ff_trigger)
  1013. * @replay: scheduling of the effect (struct ff_replay)
  1014. * @u: effect-specific structure (one of ff_constant_effect, ff_ramp_effect,
  1015. * ff_periodic_effect, ff_condition_effect, ff_rumble_effect) further
  1016. * defining effect parameters
  1017. *
  1018. * This structure is sent through ioctl from the application to the driver.
  1019. * To create a new effect application should set its @id to -1; the kernel
  1020. * will return assigned @id which can later be used to update or delete
  1021. * this effect.
  1022. *
  1023. * Direction of the effect is encoded as follows:
  1024. * 0 deg -> 0x0000 (down)
  1025. * 90 deg -> 0x4000 (left)
  1026. * 180 deg -> 0x8000 (up)
  1027. * 270 deg -> 0xC000 (right)
  1028. */
  1029. struct ff_effect {
  1030. __u16 type;
  1031. __s16 id;
  1032. __u16 direction;
  1033. struct ff_trigger trigger;
  1034. struct ff_replay replay;
  1035. union {
  1036. struct ff_constant_effect constant;
  1037. struct ff_ramp_effect ramp;
  1038. struct ff_periodic_effect periodic;
  1039. struct ff_condition_effect condition[2]; /* One for each axis */
  1040. struct ff_rumble_effect rumble;
  1041. } u;
  1042. };
  1043. /*
  1044. * Force feedback effect types
  1045. */
  1046. #define FF_RUMBLE 0x50
  1047. #define FF_PERIODIC 0x51
  1048. #define FF_CONSTANT 0x52
  1049. #define FF_SPRING 0x53
  1050. #define FF_FRICTION 0x54
  1051. #define FF_DAMPER 0x55
  1052. #define FF_INERTIA 0x56
  1053. #define FF_RAMP 0x57
  1054. #define FF_EFFECT_MIN FF_RUMBLE
  1055. #define FF_EFFECT_MAX FF_RAMP
  1056. /*
  1057. * Force feedback periodic effect types
  1058. */
  1059. #define FF_SQUARE 0x58
  1060. #define FF_TRIANGLE 0x59
  1061. #define FF_SINE 0x5a
  1062. #define FF_SAW_UP 0x5b
  1063. #define FF_SAW_DOWN 0x5c
  1064. #define FF_CUSTOM 0x5d
  1065. #define FF_WAVEFORM_MIN FF_SQUARE
  1066. #define FF_WAVEFORM_MAX FF_CUSTOM
  1067. /*
  1068. * Set ff device properties
  1069. */
  1070. #define FF_GAIN 0x60
  1071. #define FF_AUTOCENTER 0x61
  1072. #define FF_MAX 0x7f
  1073. #define FF_CNT (FF_MAX+1)
  1074. #endif /* _UAPI_INPUT_H */