1 // SPDX-License-Identifier: GPL-2.0-only
3 * STMicroelectronics gyroscopes driver
5 * Copyright 2012-2013 STMicroelectronics Inc.
7 * Denis Ciocca <denis.ciocca@st.com>
10 #include <linux/kernel.h>
11 #include <linux/module.h>
12 #include <linux/slab.h>
13 #include <linux/errno.h>
14 #include <linux/types.h>
15 #include <linux/interrupt.h>
16 #include <linux/i2c.h>
17 #include <linux/irq.h>
18 #include <linux/delay.h>
19 #include <linux/iio/iio.h>
20 #include <linux/iio/sysfs.h>
21 #include <linux/iio/trigger.h>
22 #include <linux/iio/buffer.h>
24 #include <linux/iio/common/st_sensors.h>
27 #define ST_GYRO_NUMBER_DATA_CHANNELS 3
29 /* DEFAULT VALUE FOR SENSORS */
30 #define ST_GYRO_DEFAULT_OUT_X_L_ADDR 0x28
31 #define ST_GYRO_DEFAULT_OUT_Y_L_ADDR 0x2a
32 #define ST_GYRO_DEFAULT_OUT_Z_L_ADDR 0x2c
35 #define ST_GYRO_FS_AVL_245DPS 245
36 #define ST_GYRO_FS_AVL_250DPS 250
37 #define ST_GYRO_FS_AVL_500DPS 500
38 #define ST_GYRO_FS_AVL_2000DPS 2000
40 static const struct iio_chan_spec st_gyro_16bit_channels[] = {
41 ST_SENSORS_LSM_CHANNELS(IIO_ANGL_VEL,
42 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
43 ST_SENSORS_SCAN_X, 1, IIO_MOD_X, 's', IIO_LE, 16, 16,
44 ST_GYRO_DEFAULT_OUT_X_L_ADDR),
45 ST_SENSORS_LSM_CHANNELS(IIO_ANGL_VEL,
46 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
47 ST_SENSORS_SCAN_Y, 1, IIO_MOD_Y, 's', IIO_LE, 16, 16,
48 ST_GYRO_DEFAULT_OUT_Y_L_ADDR),
49 ST_SENSORS_LSM_CHANNELS(IIO_ANGL_VEL,
50 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
51 ST_SENSORS_SCAN_Z, 1, IIO_MOD_Z, 's', IIO_LE, 16, 16,
52 ST_GYRO_DEFAULT_OUT_Z_L_ADDR),
53 IIO_CHAN_SOFT_TIMESTAMP(3)
56 static const struct st_sensor_settings st_gyro_sensors_settings[] = {
59 .wai_addr = ST_SENSORS_DEFAULT_WAI_ADDRESS,
60 .sensors_supported = {
61 [0] = L3G4200D_GYRO_DEV_NAME,
62 [1] = LSM330DL_GYRO_DEV_NAME,
64 .ch = (struct iio_chan_spec *)st_gyro_16bit_channels,
69 { .hz = 100, .value = 0x00, },
70 { .hz = 200, .value = 0x01, },
71 { .hz = 400, .value = 0x02, },
72 { .hz = 800, .value = 0x03, },
78 .value_on = ST_SENSORS_DEFAULT_POWER_ON_VALUE,
79 .value_off = ST_SENSORS_DEFAULT_POWER_OFF_VALUE,
82 .addr = ST_SENSORS_DEFAULT_AXIS_ADDR,
83 .mask = ST_SENSORS_DEFAULT_AXIS_MASK,
90 .num = ST_GYRO_FS_AVL_250DPS,
92 .gain = IIO_DEGREE_TO_RAD(8750),
95 .num = ST_GYRO_FS_AVL_500DPS,
97 .gain = IIO_DEGREE_TO_RAD(17500),
100 .num = ST_GYRO_FS_AVL_2000DPS,
102 .gain = IIO_DEGREE_TO_RAD(70000),
116 * The sensor has IHL (active low) and open
117 * drain settings, but only for INT1 and not
118 * for the DRDY line on INT2.
121 .addr = ST_SENSORS_DEFAULT_STAT_ADDR,
129 .multi_read_bit = true,
134 .wai_addr = ST_SENSORS_DEFAULT_WAI_ADDRESS,
135 .sensors_supported = {
136 [0] = L3GD20_GYRO_DEV_NAME,
137 [1] = LSM330D_GYRO_DEV_NAME,
138 [2] = LSM330DLC_GYRO_DEV_NAME,
139 [3] = L3G4IS_GYRO_DEV_NAME,
140 [4] = LSM330_GYRO_DEV_NAME,
141 [5] = LSM9DS0_GYRO_DEV_NAME,
143 .ch = (struct iio_chan_spec *)st_gyro_16bit_channels,
148 { .hz = 95, .value = 0x00, },
149 { .hz = 190, .value = 0x01, },
150 { .hz = 380, .value = 0x02, },
151 { .hz = 760, .value = 0x03, },
157 .value_on = ST_SENSORS_DEFAULT_POWER_ON_VALUE,
158 .value_off = ST_SENSORS_DEFAULT_POWER_OFF_VALUE,
161 .addr = ST_SENSORS_DEFAULT_AXIS_ADDR,
162 .mask = ST_SENSORS_DEFAULT_AXIS_MASK,
169 .num = ST_GYRO_FS_AVL_250DPS,
171 .gain = IIO_DEGREE_TO_RAD(8750),
174 .num = ST_GYRO_FS_AVL_500DPS,
176 .gain = IIO_DEGREE_TO_RAD(17500),
179 .num = ST_GYRO_FS_AVL_2000DPS,
181 .gain = IIO_DEGREE_TO_RAD(70000),
195 * The sensor has IHL (active low) and open
196 * drain settings, but only for INT1 and not
197 * for the DRDY line on INT2.
200 .addr = ST_SENSORS_DEFAULT_STAT_ADDR,
208 .multi_read_bit = true,
213 .wai_addr = ST_SENSORS_DEFAULT_WAI_ADDRESS,
214 .sensors_supported = {
215 [0] = L3GD20H_GYRO_DEV_NAME,
217 .ch = (struct iio_chan_spec *)st_gyro_16bit_channels,
222 { .hz = 100, .value = 0x00, },
223 { .hz = 200, .value = 0x01, },
224 { .hz = 400, .value = 0x02, },
225 { .hz = 800, .value = 0x03, },
231 .value_on = ST_SENSORS_DEFAULT_POWER_ON_VALUE,
232 .value_off = ST_SENSORS_DEFAULT_POWER_OFF_VALUE,
235 .addr = ST_SENSORS_DEFAULT_AXIS_ADDR,
236 .mask = ST_SENSORS_DEFAULT_AXIS_MASK,
243 .num = ST_GYRO_FS_AVL_245DPS,
245 .gain = IIO_DEGREE_TO_RAD(8750),
248 .num = ST_GYRO_FS_AVL_500DPS,
250 .gain = IIO_DEGREE_TO_RAD(17500),
253 .num = ST_GYRO_FS_AVL_2000DPS,
255 .gain = IIO_DEGREE_TO_RAD(70000),
269 * The sensor has IHL (active low) and open
270 * drain settings, but only for INT1 and not
271 * for the DRDY line on INT2.
274 .addr = ST_SENSORS_DEFAULT_STAT_ADDR,
282 .multi_read_bit = true,
287 static int st_gyro_read_raw(struct iio_dev *indio_dev,
288 struct iio_chan_spec const *ch, int *val,
289 int *val2, long mask)
292 struct st_sensor_data *gdata = iio_priv(indio_dev);
295 case IIO_CHAN_INFO_RAW:
296 err = st_sensors_read_info_raw(indio_dev, ch, val);
301 case IIO_CHAN_INFO_SCALE:
303 *val2 = gdata->current_fullscale->gain;
304 return IIO_VAL_INT_PLUS_MICRO;
305 case IIO_CHAN_INFO_SAMP_FREQ:
316 static int st_gyro_write_raw(struct iio_dev *indio_dev,
317 struct iio_chan_spec const *chan, int val, int val2, long mask)
322 case IIO_CHAN_INFO_SCALE:
323 err = st_sensors_set_fullscale_by_gain(indio_dev, val2);
325 case IIO_CHAN_INFO_SAMP_FREQ:
328 mutex_lock(&indio_dev->mlock);
329 err = st_sensors_set_odr(indio_dev, val);
330 mutex_unlock(&indio_dev->mlock);
339 static ST_SENSORS_DEV_ATTR_SAMP_FREQ_AVAIL();
340 static ST_SENSORS_DEV_ATTR_SCALE_AVAIL(in_anglvel_scale_available);
342 static struct attribute *st_gyro_attributes[] = {
343 &iio_dev_attr_sampling_frequency_available.dev_attr.attr,
344 &iio_dev_attr_in_anglvel_scale_available.dev_attr.attr,
348 static const struct attribute_group st_gyro_attribute_group = {
349 .attrs = st_gyro_attributes,
352 static const struct iio_info gyro_info = {
353 .attrs = &st_gyro_attribute_group,
354 .read_raw = &st_gyro_read_raw,
355 .write_raw = &st_gyro_write_raw,
356 .debugfs_reg_access = &st_sensors_debugfs_reg_access,
359 #ifdef CONFIG_IIO_TRIGGER
360 static const struct iio_trigger_ops st_gyro_trigger_ops = {
361 .set_trigger_state = ST_GYRO_TRIGGER_SET_STATE,
362 .validate_device = st_sensors_validate_device,
364 #define ST_GYRO_TRIGGER_OPS (&st_gyro_trigger_ops)
366 #define ST_GYRO_TRIGGER_OPS NULL
370 * st_gyro_get_settings() - get sensor settings from device name
371 * @name: device name buffer reference.
373 * Return: valid reference on success, NULL otherwise.
375 const struct st_sensor_settings *st_gyro_get_settings(const char *name)
377 int index = st_sensors_get_settings_index(name,
378 st_gyro_sensors_settings,
379 ARRAY_SIZE(st_gyro_sensors_settings));
383 return &st_gyro_sensors_settings[index];
385 EXPORT_SYMBOL(st_gyro_get_settings);
387 int st_gyro_common_probe(struct iio_dev *indio_dev)
389 struct st_sensor_data *gdata = iio_priv(indio_dev);
392 indio_dev->modes = INDIO_DIRECT_MODE;
393 indio_dev->info = &gyro_info;
395 err = st_sensors_power_enable(indio_dev);
399 err = st_sensors_verify_id(indio_dev);
401 goto st_gyro_power_off;
403 gdata->num_data_channels = ST_GYRO_NUMBER_DATA_CHANNELS;
404 indio_dev->channels = gdata->sensor_settings->ch;
405 indio_dev->num_channels = ST_SENSORS_NUMBER_ALL_CHANNELS;
407 gdata->current_fullscale = (struct st_sensor_fullscale_avl *)
408 &gdata->sensor_settings->fs.fs_avl[0];
409 gdata->odr = gdata->sensor_settings->odr.odr_avl[0].hz;
411 err = st_sensors_init_sensor(indio_dev,
412 (struct st_sensors_platform_data *)&gyro_pdata);
414 goto st_gyro_power_off;
416 err = st_gyro_allocate_ring(indio_dev);
418 goto st_gyro_power_off;
420 if (gdata->irq > 0) {
421 err = st_sensors_allocate_trigger(indio_dev,
422 ST_GYRO_TRIGGER_OPS);
424 goto st_gyro_probe_trigger_error;
427 err = iio_device_register(indio_dev);
429 goto st_gyro_device_register_error;
431 dev_info(&indio_dev->dev, "registered gyroscope %s\n",
436 st_gyro_device_register_error:
438 st_sensors_deallocate_trigger(indio_dev);
439 st_gyro_probe_trigger_error:
440 st_gyro_deallocate_ring(indio_dev);
442 st_sensors_power_disable(indio_dev);
446 EXPORT_SYMBOL(st_gyro_common_probe);
448 void st_gyro_common_remove(struct iio_dev *indio_dev)
450 struct st_sensor_data *gdata = iio_priv(indio_dev);
452 st_sensors_power_disable(indio_dev);
454 iio_device_unregister(indio_dev);
456 st_sensors_deallocate_trigger(indio_dev);
458 st_gyro_deallocate_ring(indio_dev);
460 EXPORT_SYMBOL(st_gyro_common_remove);
462 MODULE_AUTHOR("Denis Ciocca <denis.ciocca@st.com>");
463 MODULE_DESCRIPTION("STMicroelectronics gyroscopes driver");
464 MODULE_LICENSE("GPL v2");