media: videobuf2: fix buffer management issues
[linux-2.6.git] / Documentation / input / cma3000_d0x.txt
1 Kernel driver for CMA3000-D0x
2 ============================
3
4 Supported chips:
5 * VTI CMA3000-D0x
6 Datasheet:
7   CMA3000-D0X Product Family Specification 8281000A.02.pdf
8   <http://www.vti.fi/en/>
9
10 Author: Hemanth V <hemanthv@ti.com>
11
12
13 Description
14 -----------
15 CMA3000 Tri-axis accelerometer supports Motion detect, Measurement and
16 Free fall modes.
17
18 Motion Detect Mode: Its the low power mode where interrupts are generated only
19 when motion exceeds the defined thresholds.
20
21 Measurement Mode: This mode is used to read the acceleration data on X,Y,Z
22 axis and supports 400, 100, 40 Hz sample frequency.
23
24 Free fall Mode: This mode is intended to save system resources.
25
26 Threshold values: Chip supports defining threshold values for above modes
27 which includes time and g value. Refer product specifications for more details.
28
29 CMA3000 chip supports mutually exclusive I2C and SPI interfaces for
30 communication, currently the driver supports I2C based communication only.
31 Initial configuration for bus mode is set in non volatile memory and can later
32 be modified through bus interface command.
33
34 Driver reports acceleration data through input subsystem. It generates ABS_MISC
35 event with value 1 when free fall is detected.
36
37 Platform data need to be configured for initial default values.
38
39 Platform Data
40 -------------
41 fuzz_x: Noise on X Axis
42
43 fuzz_y: Noise on Y Axis
44
45 fuzz_z: Noise on Z Axis
46
47 g_range: G range in milli g i.e 2000 or 8000
48
49 mode: Default Operating mode
50
51 mdthr: Motion detect g range threshold value
52
53 mdfftmr: Motion detect and free fall time threshold value
54
55 ffthr: Free fall g range threshold value
56
57 Input Interface
58 --------------
59 Input driver version is 1.0.0
60 Input device ID: bus 0x18 vendor 0x0 product 0x0 version 0x0
61 Input device name: "cma3000-accelerometer"
62 Supported events:
63   Event type 0 (Sync)
64   Event type 3 (Absolute)
65     Event code 0 (X)
66       Value     47
67       Min    -8000
68       Max     8000
69       Fuzz     200
70     Event code 1 (Y)
71       Value    -28
72       Min    -8000
73       Max     8000
74       Fuzz     200
75     Event code 2 (Z)
76       Value    905
77       Min    -8000
78       Max     8000
79       Fuzz     200
80     Event code 40 (Misc)
81       Value      0
82       Min        0
83       Max        1
84   Event type 4 (Misc)
85
86
87 Register/Platform parameters Description
88 ----------------------------------------
89
90 mode:
91         0: power down mode
92         1: 100 Hz Measurement mode
93         2: 400 Hz Measurement mode
94         3: 40 Hz Measurement mode
95         4: Motion Detect mode (default)
96         5: 100 Hz Free fall mode
97         6: 40 Hz Free fall mode
98         7: Power off mode
99
100 grange:
101         2000: 2000 mg or 2G Range
102         8000: 8000 mg or 8G Range
103
104 mdthr:
105         X: X * 71mg (8G Range)
106         X: X * 18mg (2G Range)
107
108 mdfftmr:
109         X: (X & 0x70) * 100 ms (MDTMR)
110            (X & 0x0F) * 2.5 ms (FFTMR 400 Hz)
111            (X & 0x0F) * 10 ms  (FFTMR 100 Hz)
112
113 ffthr:
114        X: (X >> 2) * 18mg (2G Range)
115        X: (X & 0x0F) * 71 mg (8G Range)