lis3lv02d.h 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272
  1. /*
  2. * lis3lv02d.h - ST LIS3LV02DL accelerometer driver
  3. *
  4. * Copyright (C) 2007-2008 Yan Burman
  5. * Copyright (C) 2008-2009 Eric Piel
  6. *
  7. * This program is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU General Public License as published by
  9. * the Free Software Foundation; either version 2 of the License, or
  10. * (at your option) any later version.
  11. *
  12. * This program is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15. * GNU General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU General Public License
  18. * along with this program; if not, write to the Free Software
  19. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  20. */
  21. #include <linux/platform_device.h>
  22. #include <linux/input-polldev.h>
  23. /*
  24. * This driver tries to support the "digital" accelerometer chips from
  25. * STMicroelectronics such as LIS3LV02DL, LIS302DL, LIS3L02DQ, LIS331DL,
  26. * LIS35DE, or LIS202DL. They are very similar in terms of programming, with
  27. * almost the same registers. In addition to differing on physical properties,
  28. * they differ on the number of axes (2/3), precision (8/12 bits), and special
  29. * features (freefall detection, click...). Unfortunately, not all the
  30. * differences can be probed via a register.
  31. * They can be connected either via I²C or SPI.
  32. */
  33. #include <linux/lis3lv02d.h>
  34. enum lis3_reg {
  35. WHO_AM_I = 0x0F,
  36. OFFSET_X = 0x16,
  37. OFFSET_Y = 0x17,
  38. OFFSET_Z = 0x18,
  39. GAIN_X = 0x19,
  40. GAIN_Y = 0x1A,
  41. GAIN_Z = 0x1B,
  42. CTRL_REG1 = 0x20,
  43. CTRL_REG2 = 0x21,
  44. CTRL_REG3 = 0x22,
  45. CTRL_REG4 = 0x23,
  46. HP_FILTER_RESET = 0x23,
  47. STATUS_REG = 0x27,
  48. OUTX_L = 0x28,
  49. OUTX_H = 0x29,
  50. OUTX = 0x29,
  51. OUTY_L = 0x2A,
  52. OUTY_H = 0x2B,
  53. OUTY = 0x2B,
  54. OUTZ_L = 0x2C,
  55. OUTZ_H = 0x2D,
  56. OUTZ = 0x2D,
  57. };
  58. enum lis302d_reg {
  59. FF_WU_CFG_1 = 0x30,
  60. FF_WU_SRC_1 = 0x31,
  61. FF_WU_THS_1 = 0x32,
  62. FF_WU_DURATION_1 = 0x33,
  63. FF_WU_CFG_2 = 0x34,
  64. FF_WU_SRC_2 = 0x35,
  65. FF_WU_THS_2 = 0x36,
  66. FF_WU_DURATION_2 = 0x37,
  67. CLICK_CFG = 0x38,
  68. CLICK_SRC = 0x39,
  69. CLICK_THSY_X = 0x3B,
  70. CLICK_THSZ = 0x3C,
  71. CLICK_TIMELIMIT = 0x3D,
  72. CLICK_LATENCY = 0x3E,
  73. CLICK_WINDOW = 0x3F,
  74. };
  75. enum lis3lv02d_reg {
  76. FF_WU_CFG = 0x30,
  77. FF_WU_SRC = 0x31,
  78. FF_WU_ACK = 0x32,
  79. FF_WU_THS_L = 0x34,
  80. FF_WU_THS_H = 0x35,
  81. FF_WU_DURATION = 0x36,
  82. DD_CFG = 0x38,
  83. DD_SRC = 0x39,
  84. DD_ACK = 0x3A,
  85. DD_THSI_L = 0x3C,
  86. DD_THSI_H = 0x3D,
  87. DD_THSE_L = 0x3E,
  88. DD_THSE_H = 0x3F,
  89. };
  90. enum lis3_who_am_i {
  91. WAI_3DC = 0x33, /* 8 bits: LIS3DC, HP3DC */
  92. WAI_12B = 0x3A, /* 12 bits: LIS3LV02D[LQ]... */
  93. WAI_8B = 0x3B, /* 8 bits: LIS[23]02D[LQ]... */
  94. WAI_6B = 0x52, /* 6 bits: LIS331DLF - not supported */
  95. };
  96. enum lis3lv02d_ctrl1_12b {
  97. CTRL1_Xen = 0x01,
  98. CTRL1_Yen = 0x02,
  99. CTRL1_Zen = 0x04,
  100. CTRL1_ST = 0x08,
  101. CTRL1_DF0 = 0x10,
  102. CTRL1_DF1 = 0x20,
  103. CTRL1_PD0 = 0x40,
  104. CTRL1_PD1 = 0x80,
  105. };
  106. /* Delta to ctrl1_12b version */
  107. enum lis3lv02d_ctrl1_8b {
  108. CTRL1_STM = 0x08,
  109. CTRL1_STP = 0x10,
  110. CTRL1_FS = 0x20,
  111. CTRL1_PD = 0x40,
  112. CTRL1_DR = 0x80,
  113. };
  114. enum lis3lv02d_ctrl1_3dc {
  115. CTRL1_ODR0 = 0x10,
  116. CTRL1_ODR1 = 0x20,
  117. CTRL1_ODR2 = 0x40,
  118. CTRL1_ODR3 = 0x80,
  119. };
  120. enum lis3lv02d_ctrl2 {
  121. CTRL2_DAS = 0x01,
  122. CTRL2_SIM = 0x02,
  123. CTRL2_DRDY = 0x04,
  124. CTRL2_IEN = 0x08,
  125. CTRL2_BOOT = 0x10,
  126. CTRL2_BLE = 0x20,
  127. CTRL2_BDU = 0x40, /* Block Data Update */
  128. CTRL2_FS = 0x80, /* Full Scale selection */
  129. };
  130. enum lis3lv02d_ctrl4_3dc {
  131. CTRL4_SIM = 0x01,
  132. CTRL4_ST0 = 0x02,
  133. CTRL4_ST1 = 0x04,
  134. CTRL4_FS0 = 0x10,
  135. CTRL4_FS1 = 0x20,
  136. };
  137. enum lis302d_ctrl2 {
  138. HP_FF_WU2 = 0x08,
  139. HP_FF_WU1 = 0x04,
  140. };
  141. enum lis3lv02d_ctrl3 {
  142. CTRL3_CFS0 = 0x01,
  143. CTRL3_CFS1 = 0x02,
  144. CTRL3_FDS = 0x10,
  145. CTRL3_HPFF = 0x20,
  146. CTRL3_HPDD = 0x40,
  147. CTRL3_ECK = 0x80,
  148. };
  149. enum lis3lv02d_status_reg {
  150. STATUS_XDA = 0x01,
  151. STATUS_YDA = 0x02,
  152. STATUS_ZDA = 0x04,
  153. STATUS_XYZDA = 0x08,
  154. STATUS_XOR = 0x10,
  155. STATUS_YOR = 0x20,
  156. STATUS_ZOR = 0x40,
  157. STATUS_XYZOR = 0x80,
  158. };
  159. enum lis3lv02d_ff_wu_cfg {
  160. FF_WU_CFG_XLIE = 0x01,
  161. FF_WU_CFG_XHIE = 0x02,
  162. FF_WU_CFG_YLIE = 0x04,
  163. FF_WU_CFG_YHIE = 0x08,
  164. FF_WU_CFG_ZLIE = 0x10,
  165. FF_WU_CFG_ZHIE = 0x20,
  166. FF_WU_CFG_LIR = 0x40,
  167. FF_WU_CFG_AOI = 0x80,
  168. };
  169. enum lis3lv02d_ff_wu_src {
  170. FF_WU_SRC_XL = 0x01,
  171. FF_WU_SRC_XH = 0x02,
  172. FF_WU_SRC_YL = 0x04,
  173. FF_WU_SRC_YH = 0x08,
  174. FF_WU_SRC_ZL = 0x10,
  175. FF_WU_SRC_ZH = 0x20,
  176. FF_WU_SRC_IA = 0x40,
  177. };
  178. enum lis3lv02d_dd_cfg {
  179. DD_CFG_XLIE = 0x01,
  180. DD_CFG_XHIE = 0x02,
  181. DD_CFG_YLIE = 0x04,
  182. DD_CFG_YHIE = 0x08,
  183. DD_CFG_ZLIE = 0x10,
  184. DD_CFG_ZHIE = 0x20,
  185. DD_CFG_LIR = 0x40,
  186. DD_CFG_IEND = 0x80,
  187. };
  188. enum lis3lv02d_dd_src {
  189. DD_SRC_XL = 0x01,
  190. DD_SRC_XH = 0x02,
  191. DD_SRC_YL = 0x04,
  192. DD_SRC_YH = 0x08,
  193. DD_SRC_ZL = 0x10,
  194. DD_SRC_ZH = 0x20,
  195. DD_SRC_IA = 0x40,
  196. };
  197. enum lis3lv02d_click_src_8b {
  198. CLICK_SINGLE_X = 0x01,
  199. CLICK_DOUBLE_X = 0x02,
  200. CLICK_SINGLE_Y = 0x04,
  201. CLICK_DOUBLE_Y = 0x08,
  202. CLICK_SINGLE_Z = 0x10,
  203. CLICK_DOUBLE_Z = 0x20,
  204. CLICK_IA = 0x40,
  205. };
  206. union axis_conversion {
  207. struct {
  208. int x, y, z;
  209. };
  210. int as_array[3];
  211. };
  212. struct lis3lv02d {
  213. void *bus_priv; /* used by the bus layer only */
  214. int (*init) (struct lis3lv02d *lis3);
  215. int (*write) (struct lis3lv02d *lis3, int reg, u8 val);
  216. int (*read) (struct lis3lv02d *lis3, int reg, u8 *ret);
  217. int *odrs; /* Supported output data rates */
  218. u8 odr_mask; /* ODR bit mask */
  219. u8 whoami; /* indicates measurement precision */
  220. s16 (*read_data) (struct lis3lv02d *lis3, int reg);
  221. int mdps_max_val;
  222. int pwron_delay;
  223. int scale; /*
  224. * relationship between 1 LBS and mG
  225. * (1/1000th of earth gravity)
  226. */
  227. struct input_polled_dev *idev; /* input device */
  228. struct platform_device *pdev; /* platform device */
  229. atomic_t count; /* interrupt count after last read */
  230. union axis_conversion ac; /* hw -> logical axis */
  231. int mapped_btns[3];
  232. u32 irq; /* IRQ number */
  233. struct fasync_struct *async_queue; /* queue for the misc device */
  234. wait_queue_head_t misc_wait; /* Wait queue for the misc device */
  235. unsigned long misc_opened; /* bit0: whether the device is open */
  236. struct lis3lv02d_platform_data *pdata; /* for passing board config */
  237. struct mutex mutex; /* Serialize poll and selftest */
  238. };
  239. int lis3lv02d_init_device(struct lis3lv02d *lis3);
  240. int lis3lv02d_joystick_enable(void);
  241. void lis3lv02d_joystick_disable(void);
  242. void lis3lv02d_poweroff(struct lis3lv02d *lis3);
  243. void lis3lv02d_poweron(struct lis3lv02d *lis3);
  244. int lis3lv02d_remove_fs(struct lis3lv02d *lis3);
  245. extern struct lis3lv02d lis3_dev;