2 * lis3lv02d.h - ST LIS3LV02DL accelerometer driver
4 * Copyright (C) 2007-2008 Yan Burman
5 * Copyright (C) 2008-2009 Eric Piel
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.
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.
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
21 #include <linux/platform_device.h>
22 #include <linux/input-polldev.h>
23 #include <linux/regulator/consumer.h>
24 #include <linux/miscdevice.h>
27 * This driver tries to support the "digital" accelerometer chips from
28 * STMicroelectronics such as LIS3LV02DL, LIS302DL, LIS3L02DQ, LIS331DL,
29 * LIS331DLH, LIS35DE, or LIS202DL. They are very similar in terms of
30 * programming, with almost the same registers. In addition to differing
31 * on physical properties, they differ on the number of axes (2/3),
32 * precision (8/12 bits), and special features (freefall detection,
33 * click...). Unfortunately, not all the differences can be probed via
34 * a register. They can be connected either via I²C or SPI.
37 #include <linux/lis3lv02d.h>
51 HP_FILTER_RESET = 0x23,
68 FF_WU_DURATION_1 = 0x33,
72 FF_WU_DURATION_2 = 0x37,
77 CLICK_TIMELIMIT = 0x3D,
88 FF_WU_DURATION = 0x36,
99 WAI_3DLH = 0x32, /* 16 bits: LIS331DLH */
100 WAI_3DC = 0x33, /* 8 bits: LIS3DC, HP3DC */
101 WAI_12B = 0x3A, /* 12 bits: LIS3LV02D[LQ]... */
102 WAI_8B = 0x3B, /* 8 bits: LIS[23]02D[LQ]... */
103 WAI_6B = 0x52, /* 6 bits: LIS331DLF - not supported */
115 enum lis3lv02d_ctrl1_12b {
126 /* Delta to ctrl1_12b version */
127 enum lis3lv02d_ctrl1_8b {
135 enum lis3lv02d_ctrl1_3dc {
142 enum lis331dlh_ctrl1 {
150 enum lis331dlh_ctrl2 {
153 CTRL2_FDS_3DLH = 0x10,
154 CTRL2_BOOT_3DLH = 0x80,
157 enum lis331dlh_ctrl4 {
163 enum lis3lv02d_ctrl2 {
170 CTRL2_BDU = 0x40, /* Block Data Update */
171 CTRL2_FS = 0x80, /* Full Scale selection */
174 enum lis3lv02d_ctrl4_3dc {
185 CTRL2_BOOT_8B = 0x40,
188 enum lis3lv02d_ctrl3 {
197 enum lis3lv02d_status_reg {
208 enum lis3lv02d_ff_wu_cfg {
209 FF_WU_CFG_XLIE = 0x01,
210 FF_WU_CFG_XHIE = 0x02,
211 FF_WU_CFG_YLIE = 0x04,
212 FF_WU_CFG_YHIE = 0x08,
213 FF_WU_CFG_ZLIE = 0x10,
214 FF_WU_CFG_ZHIE = 0x20,
215 FF_WU_CFG_LIR = 0x40,
216 FF_WU_CFG_AOI = 0x80,
219 enum lis3lv02d_ff_wu_src {
229 enum lis3lv02d_dd_cfg {
240 enum lis3lv02d_dd_src {
250 enum lis3lv02d_click_src_8b {
251 CLICK_SINGLE_X = 0x01,
252 CLICK_DOUBLE_X = 0x02,
253 CLICK_SINGLE_Y = 0x04,
254 CLICK_DOUBLE_Y = 0x08,
255 CLICK_SINGLE_Z = 0x10,
256 CLICK_DOUBLE_Z = 0x20,
260 enum lis3lv02d_reg_state {
265 union axis_conversion {
274 void *bus_priv; /* used by the bus layer only */
275 struct device *pm_dev; /* for pm_runtime purposes */
276 int (*init) (struct lis3lv02d *lis3);
277 int (*write) (struct lis3lv02d *lis3, int reg, u8 val);
278 int (*read) (struct lis3lv02d *lis3, int reg, u8 *ret);
279 int (*blkread) (struct lis3lv02d *lis3, int reg, int len, u8 *ret);
280 int (*reg_ctrl) (struct lis3lv02d *lis3, bool state);
282 int *odrs; /* Supported output data rates */
283 u8 *regs; /* Regs to store / restore */
287 u8 odr_mask; /* ODR bit mask */
288 u8 whoami; /* indicates measurement precision */
289 s16 (*read_data) (struct lis3lv02d *lis3, int reg);
293 * relationship between 1 LBS and mG
294 * (1/1000th of earth gravity)
297 struct input_polled_dev *idev; /* input device */
298 struct platform_device *pdev; /* platform device */
299 struct regulator_bulk_data regulators[2];
300 atomic_t count; /* interrupt count after last read */
301 union axis_conversion ac; /* hw -> logical axis */
304 u32 irq; /* IRQ number */
305 struct fasync_struct *async_queue; /* queue for the misc device */
306 wait_queue_head_t misc_wait; /* Wait queue for the misc device */
307 unsigned long misc_opened; /* bit0: whether the device is open */
308 struct miscdevice miscdev;
310 int data_ready_count[2];
311 atomic_t wake_thread;
312 unsigned char irq_cfg;
313 unsigned int shift_adj;
315 struct lis3lv02d_platform_data *pdata; /* for passing board config */
316 struct mutex mutex; /* Serialize poll and selftest */
319 struct device_node *of_node;
323 int lis3lv02d_init_device(struct lis3lv02d *lis3);
324 int lis3lv02d_joystick_enable(struct lis3lv02d *lis3);
325 void lis3lv02d_joystick_disable(struct lis3lv02d *lis3);
326 void lis3lv02d_poweroff(struct lis3lv02d *lis3);
327 int lis3lv02d_poweron(struct lis3lv02d *lis3);
328 int lis3lv02d_remove_fs(struct lis3lv02d *lis3);
329 int lis3lv02d_init_dt(struct lis3lv02d *lis3);
331 extern struct lis3lv02d lis3_dev;