lis3lv02d.h 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. #ifndef __LIS3LV02D_H_
  3. #define __LIS3LV02D_H_
  4. /**
  5. * struct lis3lv02d_platform_data - lis3 chip family platform data
  6. * @click_flags: Click detection unit configuration
  7. * @click_thresh_x: Click detection unit x axis threshold
  8. * @click_thresh_y: Click detection unit y axis threshold
  9. * @click_thresh_z: Click detection unit z axis threshold
  10. * @click_time_limit: Click detection unit time parameter
  11. * @click_latency: Click detection unit latency parameter
  12. * @click_window: Click detection unit window parameter
  13. * @irq_cfg: On chip irq source and type configuration (click /
  14. * data available / wake up, open drain, polarity)
  15. * @irq_flags1: Additional irq triggering flags for irq channel 0
  16. * @irq_flags2: Additional irq triggering flags for irq channel 1
  17. * @duration1: Wake up unit 1 duration parameter
  18. * @duration2: Wake up unit 2 duration parameter
  19. * @wakeup_flags: Wake up unit 1 flags
  20. * @wakeup_thresh: Wake up unit 1 threshold value
  21. * @wakeup_flags2: Wake up unit 2 flags
  22. * @wakeup_thresh2: Wake up unit 2 threshold value
  23. * @hipass_ctrl: High pass filter control (enable / disable, cut off
  24. * frequency)
  25. * @axis_x: Sensor orientation remapping for x-axis
  26. * @axis_y: Sensor orientation remapping for y-axis
  27. * @axis_z: Sensor orientation remapping for z-axis
  28. * @driver_features: Enable bits for different features. Disabled by default
  29. * @default_rate: Default sampling rate. 0 means reset default
  30. * @setup_resources: Interrupt line setup call back function
  31. * @release_resources: Interrupt line release call back function
  32. * @st_min_limits[3]: Selftest acceptance minimum values
  33. * @st_max_limits[3]: Selftest acceptance maximum values
  34. * @irq2: Irq line 2 number
  35. *
  36. * Platform data is used to setup the sensor chip. Meaning of the different
  37. * chip features can be found from the data sheet. It is publicly available
  38. * at www.st.com web pages. Currently the platform data is used
  39. * only for the 8 bit device. The 8 bit device has two wake up / free fall
  40. * detection units and click detection unit. There are plenty of ways to
  41. * configure the chip which makes is quite hard to explain deeper meaning of
  42. * the fields here. Behaviour of the detection blocks varies heavily depending
  43. * on the configuration. For example, interrupt detection block can use high
  44. * pass filtered data which makes it react to the changes in the acceleration.
  45. * Irq_flags can be used to enable interrupt detection on the both edges.
  46. * With proper chip configuration this produces interrupt when some trigger
  47. * starts and when it goes away.
  48. */
  49. struct lis3lv02d_platform_data {
  50. /* please note: the 'click' feature is only supported for
  51. * LIS[32]02DL variants of the chip and will be ignored for
  52. * others */
  53. #define LIS3_CLICK_SINGLE_X (1 << 0)
  54. #define LIS3_CLICK_DOUBLE_X (1 << 1)
  55. #define LIS3_CLICK_SINGLE_Y (1 << 2)
  56. #define LIS3_CLICK_DOUBLE_Y (1 << 3)
  57. #define LIS3_CLICK_SINGLE_Z (1 << 4)
  58. #define LIS3_CLICK_DOUBLE_Z (1 << 5)
  59. unsigned char click_flags;
  60. unsigned char click_thresh_x;
  61. unsigned char click_thresh_y;
  62. unsigned char click_thresh_z;
  63. unsigned char click_time_limit;
  64. unsigned char click_latency;
  65. unsigned char click_window;
  66. #define LIS3_IRQ1_DISABLE (0 << 0)
  67. #define LIS3_IRQ1_FF_WU_1 (1 << 0)
  68. #define LIS3_IRQ1_FF_WU_2 (2 << 0)
  69. #define LIS3_IRQ1_FF_WU_12 (3 << 0)
  70. #define LIS3_IRQ1_DATA_READY (4 << 0)
  71. #define LIS3_IRQ1_CLICK (7 << 0)
  72. #define LIS3_IRQ1_MASK (7 << 0)
  73. #define LIS3_IRQ2_DISABLE (0 << 3)
  74. #define LIS3_IRQ2_FF_WU_1 (1 << 3)
  75. #define LIS3_IRQ2_FF_WU_2 (2 << 3)
  76. #define LIS3_IRQ2_FF_WU_12 (3 << 3)
  77. #define LIS3_IRQ2_DATA_READY (4 << 3)
  78. #define LIS3_IRQ2_CLICK (7 << 3)
  79. #define LIS3_IRQ2_MASK (7 << 3)
  80. #define LIS3_IRQ_OPEN_DRAIN (1 << 6)
  81. #define LIS3_IRQ_ACTIVE_LOW (1 << 7)
  82. unsigned char irq_cfg;
  83. unsigned char irq_flags1; /* Additional irq edge / level flags */
  84. unsigned char irq_flags2; /* Additional irq edge / level flags */
  85. unsigned char duration1;
  86. unsigned char duration2;
  87. #define LIS3_WAKEUP_X_LO (1 << 0)
  88. #define LIS3_WAKEUP_X_HI (1 << 1)
  89. #define LIS3_WAKEUP_Y_LO (1 << 2)
  90. #define LIS3_WAKEUP_Y_HI (1 << 3)
  91. #define LIS3_WAKEUP_Z_LO (1 << 4)
  92. #define LIS3_WAKEUP_Z_HI (1 << 5)
  93. unsigned char wakeup_flags;
  94. unsigned char wakeup_thresh;
  95. unsigned char wakeup_flags2;
  96. unsigned char wakeup_thresh2;
  97. #define LIS3_HIPASS_CUTFF_8HZ 0
  98. #define LIS3_HIPASS_CUTFF_4HZ 1
  99. #define LIS3_HIPASS_CUTFF_2HZ 2
  100. #define LIS3_HIPASS_CUTFF_1HZ 3
  101. #define LIS3_HIPASS1_DISABLE (1 << 2)
  102. #define LIS3_HIPASS2_DISABLE (1 << 3)
  103. unsigned char hipass_ctrl;
  104. #define LIS3_NO_MAP 0
  105. #define LIS3_DEV_X 1
  106. #define LIS3_DEV_Y 2
  107. #define LIS3_DEV_Z 3
  108. #define LIS3_INV_DEV_X -1
  109. #define LIS3_INV_DEV_Y -2
  110. #define LIS3_INV_DEV_Z -3
  111. s8 axis_x;
  112. s8 axis_y;
  113. s8 axis_z;
  114. #define LIS3_USE_BLOCK_READ 0x02
  115. u16 driver_features;
  116. int default_rate;
  117. int (*setup_resources)(void);
  118. int (*release_resources)(void);
  119. /* Limits for selftest are specified in chip data sheet */
  120. s16 st_min_limits[3]; /* min pass limit x, y, z */
  121. s16 st_max_limits[3]; /* max pass limit x, y, z */
  122. int irq2;
  123. };
  124. #endif /* __LIS3LV02D_H_ */