1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * itg3200.h -- support InvenSense ITG3200
4 * Digital 3-Axis Gyroscope driver
5 *
6 * Copyright (c) 2011 Christian Strobel <christian.strobel@iis.fraunhofer.de>
7 * Copyright (c) 2011 Manuel Stahl <manuel.stahl@iis.fraunhofer.de>
8 * Copyright (c) 2012 Thorsten Nowak <thorsten.nowak@iis.fraunhofer.de>
9 */
10
11 #ifndef I2C_ITG3200_H_
12 #define I2C_ITG3200_H_
13
14 #include <linux/iio/iio.h>
15
16 /* Register with I2C address (34h) */
17 #define ITG3200_REG_ADDRESS 0x00
18
19 /* Sample rate divider
20 * Range: 0 to 255
21 * Default value: 0x00 */
22 #define ITG3200_REG_SAMPLE_RATE_DIV 0x15
23
24 /* Digital low pass filter settings */
25 #define ITG3200_REG_DLPF 0x16
26 /* DLPF full scale range */
27 #define ITG3200_DLPF_FS_SEL_2000 0x18
28 /* Bandwidth (Hz) and internal sample rate
29 * (kHz) of DLPF */
30 #define ITG3200_DLPF_256_8 0x00
31 #define ITG3200_DLPF_188_1 0x01
32 #define ITG3200_DLPF_98_1 0x02
33 #define ITG3200_DLPF_42_1 0x03
34 #define ITG3200_DLPF_20_1 0x04
35 #define ITG3200_DLPF_10_1 0x05
36 #define ITG3200_DLPF_5_1 0x06
37
38 #define ITG3200_DLPF_CFG_MASK 0x07
39
40 /* Configuration for interrupt operations */
41 #define ITG3200_REG_IRQ_CONFIG 0x17
42 /* Logic level */
43 #define ITG3200_IRQ_ACTIVE_LOW 0x80
44 #define ITG3200_IRQ_ACTIVE_HIGH 0x00
45 /* Drive type */
46 #define ITG3200_IRQ_OPEN_DRAIN 0x40
47 #define ITG3200_IRQ_PUSH_PULL 0x00
48 /* Latch mode */
49 #define ITG3200_IRQ_LATCH_UNTIL_CLEARED 0x20
50 #define ITG3200_IRQ_LATCH_50US_PULSE 0x00
51 /* Latch clear method */
52 #define ITG3200_IRQ_LATCH_CLEAR_ANY 0x10
53 #define ITG3200_IRQ_LATCH_CLEAR_STATUS 0x00
54 /* Enable interrupt when device is ready */
55 #define ITG3200_IRQ_DEVICE_RDY_ENABLE 0x04
56 /* Enable interrupt when data is available */
57 #define ITG3200_IRQ_DATA_RDY_ENABLE 0x01
58
59 /* Determine the status of ITG-3200 interrupts */
60 #define ITG3200_REG_IRQ_STATUS 0x1A
61 /* Status of 'device is ready'-interrupt */
62 #define ITG3200_IRQ_DEVICE_RDY_STATUS 0x04
63 /* Status of 'data is available'-interrupt */
64 #define ITG3200_IRQ_DATA_RDY_STATUS 0x01
65
66 /* Sensor registers */
67 #define ITG3200_REG_TEMP_OUT_H 0x1B
68 #define ITG3200_REG_TEMP_OUT_L 0x1C
69 #define ITG3200_REG_GYRO_XOUT_H 0x1D
70 #define ITG3200_REG_GYRO_XOUT_L 0x1E
71 #define ITG3200_REG_GYRO_YOUT_H 0x1F
72 #define ITG3200_REG_GYRO_YOUT_L 0x20
73 #define ITG3200_REG_GYRO_ZOUT_H 0x21
74 #define ITG3200_REG_GYRO_ZOUT_L 0x22
75
76 /* Power management */
77 #define ITG3200_REG_POWER_MANAGEMENT 0x3E
78 /* Reset device and internal registers to the
79 * power-up-default settings */
80 #define ITG3200_RESET 0x80
81 /* Enable low power sleep mode */
82 #define ITG3200_SLEEP 0x40
83 /* Put according gyroscope in standby mode */
84 #define ITG3200_STANDBY_GYRO_X 0x20
85 #define ITG3200_STANDBY_GYRO_Y 0x10
86 #define ITG3200_STANDBY_GYRO_Z 0x08
87 /* Determine the device clock source */
88 #define ITG3200_CLK_INTERNAL 0x00
89 #define ITG3200_CLK_GYRO_X 0x01
90 #define ITG3200_CLK_GYRO_Y 0x02
91 #define ITG3200_CLK_GYRO_Z 0x03
92 #define ITG3200_CLK_EXT_32K 0x04
93 #define ITG3200_CLK_EXT_19M 0x05
94
95
96 /**
97 * struct itg3200 - device instance specific data
98 * @i2c: actual i2c_client
99 * @trig: data ready trigger from itg3200 pin
100 **/
101 struct itg3200 {
102 struct i2c_client *i2c;
103 struct iio_trigger *trig;
104 struct iio_mount_matrix orientation;
105 /* lock to protect against multiple access to the device */
106 struct mutex lock;
107 };
108
109 enum ITG3200_SCAN_INDEX {
110 ITG3200_SCAN_TEMP,
111 ITG3200_SCAN_GYRO_X,
112 ITG3200_SCAN_GYRO_Y,
113 ITG3200_SCAN_GYRO_Z,
114 ITG3200_SCAN_ELEMENTS,
115 };
116
117 int itg3200_write_reg_8(struct iio_dev *indio_dev,
118 u8 reg_address, u8 val);
119
120 int itg3200_read_reg_8(struct iio_dev *indio_dev,
121 u8 reg_address, u8 *val);
122
123
124 #ifdef CONFIG_IIO_BUFFER
125
126 void itg3200_remove_trigger(struct iio_dev *indio_dev);
127 int itg3200_probe_trigger(struct iio_dev *indio_dev);
128
129 int itg3200_buffer_configure(struct iio_dev *indio_dev);
130 void itg3200_buffer_unconfigure(struct iio_dev *indio_dev);
131
132 #else /* CONFIG_IIO_BUFFER */
133
134 static inline void itg3200_remove_trigger(struct iio_dev *indio_dev)
135 {
136 }
137
138 static inline int itg3200_probe_trigger(struct iio_dev *indio_dev)
139 {
140 return 0;
141 }
142
143 static inline int itg3200_buffer_configure(struct iio_dev *indio_dev)
144 {
145 return 0;
146 }
147
148 static inline void itg3200_buffer_unconfigure(struct iio_dev *indio_dev)
149 {
150 }
151
152 #endif /* CONFIG_IIO_BUFFER */
153
154 #endif /* ITG3200_H_ */
155
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.