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 **/
101struct 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
109enum 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
117int itg3200_write_reg_8(struct iio_dev *indio_dev,
118		u8 reg_address, u8 val);
119
120int itg3200_read_reg_8(struct iio_dev *indio_dev,
121		u8 reg_address, u8 *val);
122
123
124#ifdef CONFIG_IIO_BUFFER
125
126void itg3200_remove_trigger(struct iio_dev *indio_dev);
127int itg3200_probe_trigger(struct iio_dev *indio_dev);
128
129int itg3200_buffer_configure(struct iio_dev *indio_dev);
130void itg3200_buffer_unconfigure(struct iio_dev *indio_dev);
131
132#else /* CONFIG_IIO_BUFFER */
133
134static inline void itg3200_remove_trigger(struct iio_dev *indio_dev)
135{
136}
137
138static inline int itg3200_probe_trigger(struct iio_dev *indio_dev)
139{
140	return 0;
141}
142
143static inline int itg3200_buffer_configure(struct iio_dev *indio_dev)
144{
145	return 0;
146}
147
148static inline void itg3200_buffer_unconfigure(struct iio_dev *indio_dev)
149{
150}
151
152#endif  /* CONFIG_IIO_BUFFER */
153
154#endif /* ITG3200_H_ */
155