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 
itg3200_remove_trigger(struct iio_dev * indio_dev)134 static inline void itg3200_remove_trigger(struct iio_dev *indio_dev)
135 {
136 }
137 
itg3200_probe_trigger(struct iio_dev * indio_dev)138 static inline int itg3200_probe_trigger(struct iio_dev *indio_dev)
139 {
140 	return 0;
141 }
142 
itg3200_buffer_configure(struct iio_dev * indio_dev)143 static inline int itg3200_buffer_configure(struct iio_dev *indio_dev)
144 {
145 	return 0;
146 }
147 
itg3200_buffer_unconfigure(struct iio_dev * indio_dev)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