lis3: fix show rate for 8 bits chips
[linux-2.6.git] / drivers / hwmon / lis3lv02d.h
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 /*
25  * This driver tries to support the "digital" accelerometer chips from
26  * STMicroelectronics such as LIS3LV02DL, LIS302DL, LIS3L02DQ, LIS331DL,
27  * LIS35DE, or LIS202DL. They are very similar in terms of programming, with
28  * almost the same registers. In addition to differing on physical properties,
29  * they differ on the number of axes (2/3), precision (8/12 bits), and special
30  * features (freefall detection, click...). Unfortunately, not all the
31  * differences can be probed via a register.
32  * They can be connected either via I²C or SPI.
33  */
34
35 #include <linux/lis3lv02d.h>
36
37 enum lis3_reg {
38         WHO_AM_I        = 0x0F,
39         OFFSET_X        = 0x16,
40         OFFSET_Y        = 0x17,
41         OFFSET_Z        = 0x18,
42         GAIN_X          = 0x19,
43         GAIN_Y          = 0x1A,
44         GAIN_Z          = 0x1B,
45         CTRL_REG1       = 0x20,
46         CTRL_REG2       = 0x21,
47         CTRL_REG3       = 0x22,
48         HP_FILTER_RESET = 0x23,
49         STATUS_REG      = 0x27,
50         OUTX_L          = 0x28,
51         OUTX_H          = 0x29,
52         OUTX            = 0x29,
53         OUTY_L          = 0x2A,
54         OUTY_H          = 0x2B,
55         OUTY            = 0x2B,
56         OUTZ_L          = 0x2C,
57         OUTZ_H          = 0x2D,
58         OUTZ            = 0x2D,
59 };
60
61 enum lis302d_reg {
62         FF_WU_CFG_1     = 0x30,
63         FF_WU_SRC_1     = 0x31,
64         FF_WU_THS_1     = 0x32,
65         FF_WU_DURATION_1 = 0x33,
66         FF_WU_CFG_2     = 0x34,
67         FF_WU_SRC_2     = 0x35,
68         FF_WU_THS_2     = 0x36,
69         FF_WU_DURATION_2 = 0x37,
70         CLICK_CFG       = 0x38,
71         CLICK_SRC       = 0x39,
72         CLICK_THSY_X    = 0x3B,
73         CLICK_THSZ      = 0x3C,
74         CLICK_TIMELIMIT = 0x3D,
75         CLICK_LATENCY   = 0x3E,
76         CLICK_WINDOW    = 0x3F,
77 };
78
79 enum lis3lv02d_reg {
80         FF_WU_CFG       = 0x30,
81         FF_WU_SRC       = 0x31,
82         FF_WU_ACK       = 0x32,
83         FF_WU_THS_L     = 0x34,
84         FF_WU_THS_H     = 0x35,
85         FF_WU_DURATION  = 0x36,
86         DD_CFG          = 0x38,
87         DD_SRC          = 0x39,
88         DD_ACK          = 0x3A,
89         DD_THSI_L       = 0x3C,
90         DD_THSI_H       = 0x3D,
91         DD_THSE_L       = 0x3E,
92         DD_THSE_H       = 0x3F,
93 };
94
95 enum lis3_who_am_i {
96         WAI_12B         = 0x3A, /* 12 bits: LIS3LV02D[LQ]... */
97         WAI_8B          = 0x3B, /* 8 bits: LIS[23]02D[LQ]... */
98         WAI_6B          = 0x52, /* 6 bits: LIS331DLF - not supported */
99 };
100
101 enum lis3lv02d_ctrl1 {
102         CTRL1_Xen       = 0x01,
103         CTRL1_Yen       = 0x02,
104         CTRL1_Zen       = 0x04,
105         CTRL1_ST        = 0x08,
106         CTRL1_DF0       = 0x10,
107         CTRL1_DF1       = 0x20,
108         CTRL1_PD0       = 0x40,
109         CTRL1_PD1       = 0x80,
110         CTRL1_DR        = 0x80, /* Data rate on 8 bits */
111 };
112 enum lis3lv02d_ctrl2 {
113         CTRL2_DAS       = 0x01,
114         CTRL2_SIM       = 0x02,
115         CTRL2_DRDY      = 0x04,
116         CTRL2_IEN       = 0x08,
117         CTRL2_BOOT      = 0x10,
118         CTRL2_BLE       = 0x20,
119         CTRL2_BDU       = 0x40, /* Block Data Update */
120         CTRL2_FS        = 0x80, /* Full Scale selection */
121 };
122
123 enum lis302d_ctrl2 {
124         HP_FF_WU2       = 0x08,
125         HP_FF_WU1       = 0x04,
126 };
127
128 enum lis3lv02d_ctrl3 {
129         CTRL3_CFS0      = 0x01,
130         CTRL3_CFS1      = 0x02,
131         CTRL3_FDS       = 0x10,
132         CTRL3_HPFF      = 0x20,
133         CTRL3_HPDD      = 0x40,
134         CTRL3_ECK       = 0x80,
135 };
136
137 enum lis3lv02d_status_reg {
138         STATUS_XDA      = 0x01,
139         STATUS_YDA      = 0x02,
140         STATUS_ZDA      = 0x04,
141         STATUS_XYZDA    = 0x08,
142         STATUS_XOR      = 0x10,
143         STATUS_YOR      = 0x20,
144         STATUS_ZOR      = 0x40,
145         STATUS_XYZOR    = 0x80,
146 };
147
148 enum lis3lv02d_ff_wu_cfg {
149         FF_WU_CFG_XLIE  = 0x01,
150         FF_WU_CFG_XHIE  = 0x02,
151         FF_WU_CFG_YLIE  = 0x04,
152         FF_WU_CFG_YHIE  = 0x08,
153         FF_WU_CFG_ZLIE  = 0x10,
154         FF_WU_CFG_ZHIE  = 0x20,
155         FF_WU_CFG_LIR   = 0x40,
156         FF_WU_CFG_AOI   = 0x80,
157 };
158
159 enum lis3lv02d_ff_wu_src {
160         FF_WU_SRC_XL    = 0x01,
161         FF_WU_SRC_XH    = 0x02,
162         FF_WU_SRC_YL    = 0x04,
163         FF_WU_SRC_YH    = 0x08,
164         FF_WU_SRC_ZL    = 0x10,
165         FF_WU_SRC_ZH    = 0x20,
166         FF_WU_SRC_IA    = 0x40,
167 };
168
169 enum lis3lv02d_dd_cfg {
170         DD_CFG_XLIE     = 0x01,
171         DD_CFG_XHIE     = 0x02,
172         DD_CFG_YLIE     = 0x04,
173         DD_CFG_YHIE     = 0x08,
174         DD_CFG_ZLIE     = 0x10,
175         DD_CFG_ZHIE     = 0x20,
176         DD_CFG_LIR      = 0x40,
177         DD_CFG_IEND     = 0x80,
178 };
179
180 enum lis3lv02d_dd_src {
181         DD_SRC_XL       = 0x01,
182         DD_SRC_XH       = 0x02,
183         DD_SRC_YL       = 0x04,
184         DD_SRC_YH       = 0x08,
185         DD_SRC_ZL       = 0x10,
186         DD_SRC_ZH       = 0x20,
187         DD_SRC_IA       = 0x40,
188 };
189
190 struct axis_conversion {
191         s8      x;
192         s8      y;
193         s8      z;
194 };
195
196 struct lis3lv02d {
197         void                    *bus_priv; /* used by the bus layer only */
198         int (*init) (struct lis3lv02d *lis3);
199         int (*write) (struct lis3lv02d *lis3, int reg, u8 val);
200         int (*read) (struct lis3lv02d *lis3, int reg, u8 *ret);
201
202         u8                      whoami;    /* indicates measurement precision */
203         s16 (*read_data) (struct lis3lv02d *lis3, int reg);
204         int                     mdps_max_val;
205
206         struct input_polled_dev *idev;     /* input device */
207         struct platform_device  *pdev;     /* platform device */
208         atomic_t                count;     /* interrupt count after last read */
209         int                     xcalib;    /* calibrated null value for x */
210         int                     ycalib;    /* calibrated null value for y */
211         int                     zcalib;    /* calibrated null value for z */
212         struct axis_conversion  ac;        /* hw -> logical axis */
213
214         u32                     irq;       /* IRQ number */
215         struct fasync_struct    *async_queue; /* queue for the misc device */
216         wait_queue_head_t       misc_wait; /* Wait queue for the misc device */
217         unsigned long           misc_opened; /* bit0: whether the device is open */
218
219         struct lis3lv02d_platform_data *pdata;  /* for passing board config */
220 };
221
222 int lis3lv02d_init_device(struct lis3lv02d *lis3);
223 int lis3lv02d_joystick_enable(void);
224 void lis3lv02d_joystick_disable(void);
225 void lis3lv02d_poweroff(struct lis3lv02d *lis3);
226 void lis3lv02d_poweron(struct lis3lv02d *lis3);
227 int lis3lv02d_remove_fs(struct lis3lv02d *lis3);
228
229 extern struct lis3lv02d lis3_dev;