1 // SPDX-License-Identifier: GPL-2.0-only
3 * STMicroelectronics magnetometers 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/gpio.h>
18 #include <linux/irq.h>
19 #include <linux/delay.h>
20 #include <linux/iio/iio.h>
21 #include <linux/iio/sysfs.h>
22 #include <linux/iio/buffer.h>
24 #include <linux/iio/common/st_sensors.h>
27 #define ST_MAGN_NUMBER_DATA_CHANNELS 3
29 /* DEFAULT VALUE FOR SENSORS */
30 #define ST_MAGN_DEFAULT_OUT_X_H_ADDR 0x03
31 #define ST_MAGN_DEFAULT_OUT_Y_H_ADDR 0x07
32 #define ST_MAGN_DEFAULT_OUT_Z_H_ADDR 0x05
35 #define ST_MAGN_FS_AVL_1300MG 1300
36 #define ST_MAGN_FS_AVL_1900MG 1900
37 #define ST_MAGN_FS_AVL_2500MG 2500
38 #define ST_MAGN_FS_AVL_4000MG 4000
39 #define ST_MAGN_FS_AVL_4700MG 4700
40 #define ST_MAGN_FS_AVL_5600MG 5600
41 #define ST_MAGN_FS_AVL_8000MG 8000
42 #define ST_MAGN_FS_AVL_8100MG 8100
43 #define ST_MAGN_FS_AVL_12000MG 12000
44 #define ST_MAGN_FS_AVL_15000MG 15000
45 #define ST_MAGN_FS_AVL_16000MG 16000
47 /* Special L addresses for Sensor 2 */
48 #define ST_MAGN_2_OUT_X_L_ADDR 0x28
49 #define ST_MAGN_2_OUT_Y_L_ADDR 0x2a
50 #define ST_MAGN_2_OUT_Z_L_ADDR 0x2c
52 /* Special L addresses for sensor 3 */
53 #define ST_MAGN_3_OUT_X_L_ADDR 0x68
54 #define ST_MAGN_3_OUT_Y_L_ADDR 0x6a
55 #define ST_MAGN_3_OUT_Z_L_ADDR 0x6c
57 static const struct iio_chan_spec st_magn_16bit_channels[] = {
58 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
59 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
60 ST_SENSORS_SCAN_X, 1, IIO_MOD_X, 's', IIO_BE, 16, 16,
61 ST_MAGN_DEFAULT_OUT_X_H_ADDR),
62 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
63 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
64 ST_SENSORS_SCAN_Y, 1, IIO_MOD_Y, 's', IIO_BE, 16, 16,
65 ST_MAGN_DEFAULT_OUT_Y_H_ADDR),
66 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
67 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
68 ST_SENSORS_SCAN_Z, 1, IIO_MOD_Z, 's', IIO_BE, 16, 16,
69 ST_MAGN_DEFAULT_OUT_Z_H_ADDR),
70 IIO_CHAN_SOFT_TIMESTAMP(3)
73 static const struct iio_chan_spec st_magn_2_16bit_channels[] = {
74 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
75 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
76 ST_SENSORS_SCAN_X, 1, IIO_MOD_X, 's', IIO_LE, 16, 16,
77 ST_MAGN_2_OUT_X_L_ADDR),
78 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
79 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
80 ST_SENSORS_SCAN_Y, 1, IIO_MOD_Y, 's', IIO_LE, 16, 16,
81 ST_MAGN_2_OUT_Y_L_ADDR),
82 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
83 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
84 ST_SENSORS_SCAN_Z, 1, IIO_MOD_Z, 's', IIO_LE, 16, 16,
85 ST_MAGN_2_OUT_Z_L_ADDR),
86 IIO_CHAN_SOFT_TIMESTAMP(3)
89 static const struct iio_chan_spec st_magn_3_16bit_channels[] = {
90 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
91 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
92 ST_SENSORS_SCAN_X, 1, IIO_MOD_X, 's', IIO_LE, 16, 16,
93 ST_MAGN_3_OUT_X_L_ADDR),
94 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
95 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
96 ST_SENSORS_SCAN_Y, 1, IIO_MOD_Y, 's', IIO_LE, 16, 16,
97 ST_MAGN_3_OUT_Y_L_ADDR),
98 ST_SENSORS_LSM_CHANNELS(IIO_MAGN,
99 BIT(IIO_CHAN_INFO_RAW) | BIT(IIO_CHAN_INFO_SCALE),
100 ST_SENSORS_SCAN_Z, 1, IIO_MOD_Z, 's', IIO_LE, 16, 16,
101 ST_MAGN_3_OUT_Z_L_ADDR),
102 IIO_CHAN_SOFT_TIMESTAMP(3)
105 static const struct st_sensor_settings st_magn_sensors_settings[] = {
107 .wai = 0, /* This sensor has no valid WhoAmI report 0 */
108 .wai_addr = ST_SENSORS_DEFAULT_WAI_ADDRESS,
109 .sensors_supported = {
110 [0] = LSM303DLH_MAGN_DEV_NAME,
112 .ch = (struct iio_chan_spec *)st_magn_16bit_channels,
117 { .hz = 1, .value = 0x00 },
118 { .hz = 2, .value = 0x01 },
119 { .hz = 3, .value = 0x02 },
120 { .hz = 8, .value = 0x03 },
121 { .hz = 15, .value = 0x04 },
122 { .hz = 30, .value = 0x05 },
123 { .hz = 75, .value = 0x06 },
124 /* 220 Hz, 0x07 reportedly exist */
138 .num = ST_MAGN_FS_AVL_1300MG,
144 .num = ST_MAGN_FS_AVL_1900MG,
150 .num = ST_MAGN_FS_AVL_2500MG,
156 .num = ST_MAGN_FS_AVL_4000MG,
162 .num = ST_MAGN_FS_AVL_4700MG,
168 .num = ST_MAGN_FS_AVL_5600MG,
174 .num = ST_MAGN_FS_AVL_8100MG,
181 .multi_read_bit = false,
186 .wai_addr = ST_SENSORS_DEFAULT_WAI_ADDRESS,
187 .sensors_supported = {
188 [0] = LSM303DLHC_MAGN_DEV_NAME,
189 [1] = LSM303DLM_MAGN_DEV_NAME,
191 .ch = (struct iio_chan_spec *)st_magn_16bit_channels,
196 { .hz = 1, .value = 0x00 },
197 { .hz = 2, .value = 0x01 },
198 { .hz = 3, .value = 0x02 },
199 { .hz = 8, .value = 0x03 },
200 { .hz = 15, .value = 0x04 },
201 { .hz = 30, .value = 0x05 },
202 { .hz = 75, .value = 0x06 },
203 { .hz = 220, .value = 0x07 },
217 .num = ST_MAGN_FS_AVL_1300MG,
223 .num = ST_MAGN_FS_AVL_1900MG,
229 .num = ST_MAGN_FS_AVL_2500MG,
235 .num = ST_MAGN_FS_AVL_4000MG,
241 .num = ST_MAGN_FS_AVL_4700MG,
247 .num = ST_MAGN_FS_AVL_5600MG,
253 .num = ST_MAGN_FS_AVL_8100MG,
260 .multi_read_bit = false,
265 .wai_addr = ST_SENSORS_DEFAULT_WAI_ADDRESS,
266 .sensors_supported = {
267 [0] = LIS3MDL_MAGN_DEV_NAME,
268 [1] = LSM9DS1_MAGN_DEV_NAME,
270 .ch = (struct iio_chan_spec *)st_magn_2_16bit_channels,
275 { .hz = 1, .value = 0x00 },
276 { .hz = 2, .value = 0x01 },
277 { .hz = 3, .value = 0x02 },
278 { .hz = 5, .value = 0x03 },
279 { .hz = 10, .value = 0x04 },
280 { .hz = 20, .value = 0x05 },
281 { .hz = 40, .value = 0x06 },
282 { .hz = 80, .value = 0x07 },
296 .num = ST_MAGN_FS_AVL_4000MG,
301 .num = ST_MAGN_FS_AVL_8000MG,
306 .num = ST_MAGN_FS_AVL_12000MG,
311 .num = ST_MAGN_FS_AVL_16000MG,
322 /* drdy line is routed drdy pin */
324 .addr = ST_SENSORS_DEFAULT_STAT_ADDR,
332 .multi_read_bit = true,
338 .sensors_supported = {
339 [0] = LSM303AGR_MAGN_DEV_NAME,
340 [1] = LIS2MDL_MAGN_DEV_NAME,
342 .ch = (struct iio_chan_spec *)st_magn_3_16bit_channels,
347 { .hz = 10, .value = 0x00 },
348 { .hz = 20, .value = 0x01 },
349 { .hz = 50, .value = 0x02 },
350 { .hz = 100, .value = 0x03 },
362 .num = ST_MAGN_FS_AVL_15000MG,
381 .multi_read_bit = false,
386 static int st_magn_read_raw(struct iio_dev *indio_dev,
387 struct iio_chan_spec const *ch, int *val,
388 int *val2, long mask)
391 struct st_sensor_data *mdata = iio_priv(indio_dev);
394 case IIO_CHAN_INFO_RAW:
395 err = st_sensors_read_info_raw(indio_dev, ch, val);
400 case IIO_CHAN_INFO_SCALE:
402 if ((ch->scan_index == ST_SENSORS_SCAN_Z) &&
403 (mdata->current_fullscale->gain2 != 0))
404 *val2 = mdata->current_fullscale->gain2;
406 *val2 = mdata->current_fullscale->gain;
407 return IIO_VAL_INT_PLUS_MICRO;
408 case IIO_CHAN_INFO_SAMP_FREQ:
419 static int st_magn_write_raw(struct iio_dev *indio_dev,
420 struct iio_chan_spec const *chan, int val, int val2, long mask)
425 case IIO_CHAN_INFO_SCALE:
426 err = st_sensors_set_fullscale_by_gain(indio_dev, val2);
428 case IIO_CHAN_INFO_SAMP_FREQ:
431 mutex_lock(&indio_dev->mlock);
432 err = st_sensors_set_odr(indio_dev, val);
433 mutex_unlock(&indio_dev->mlock);
442 static ST_SENSORS_DEV_ATTR_SAMP_FREQ_AVAIL();
443 static ST_SENSORS_DEV_ATTR_SCALE_AVAIL(in_magn_scale_available);
445 static struct attribute *st_magn_attributes[] = {
446 &iio_dev_attr_sampling_frequency_available.dev_attr.attr,
447 &iio_dev_attr_in_magn_scale_available.dev_attr.attr,
451 static const struct attribute_group st_magn_attribute_group = {
452 .attrs = st_magn_attributes,
455 static const struct iio_info magn_info = {
456 .attrs = &st_magn_attribute_group,
457 .read_raw = &st_magn_read_raw,
458 .write_raw = &st_magn_write_raw,
459 .debugfs_reg_access = &st_sensors_debugfs_reg_access,
462 #ifdef CONFIG_IIO_TRIGGER
463 static const struct iio_trigger_ops st_magn_trigger_ops = {
464 .set_trigger_state = ST_MAGN_TRIGGER_SET_STATE,
465 .validate_device = st_sensors_validate_device,
467 #define ST_MAGN_TRIGGER_OPS (&st_magn_trigger_ops)
469 #define ST_MAGN_TRIGGER_OPS NULL
473 * st_magn_get_settings() - get sensor settings from device name
474 * @name: device name buffer reference.
476 * Return: valid reference on success, NULL otherwise.
478 const struct st_sensor_settings *st_magn_get_settings(const char *name)
480 int index = st_sensors_get_settings_index(name,
481 st_magn_sensors_settings,
482 ARRAY_SIZE(st_magn_sensors_settings));
486 return &st_magn_sensors_settings[index];
488 EXPORT_SYMBOL(st_magn_get_settings);
490 int st_magn_common_probe(struct iio_dev *indio_dev)
492 struct st_sensor_data *mdata = iio_priv(indio_dev);
495 indio_dev->modes = INDIO_DIRECT_MODE;
496 indio_dev->info = &magn_info;
498 err = st_sensors_power_enable(indio_dev);
502 err = st_sensors_verify_id(indio_dev);
504 goto st_magn_power_off;
506 mdata->num_data_channels = ST_MAGN_NUMBER_DATA_CHANNELS;
507 indio_dev->channels = mdata->sensor_settings->ch;
508 indio_dev->num_channels = ST_SENSORS_NUMBER_ALL_CHANNELS;
510 mdata->current_fullscale = (struct st_sensor_fullscale_avl *)
511 &mdata->sensor_settings->fs.fs_avl[0];
512 mdata->odr = mdata->sensor_settings->odr.odr_avl[0].hz;
514 err = st_sensors_init_sensor(indio_dev, NULL);
516 goto st_magn_power_off;
518 err = st_magn_allocate_ring(indio_dev);
520 goto st_magn_power_off;
522 if (mdata->irq > 0) {
523 err = st_sensors_allocate_trigger(indio_dev,
524 ST_MAGN_TRIGGER_OPS);
526 goto st_magn_probe_trigger_error;
529 err = iio_device_register(indio_dev);
531 goto st_magn_device_register_error;
533 dev_info(&indio_dev->dev, "registered magnetometer %s\n",
538 st_magn_device_register_error:
540 st_sensors_deallocate_trigger(indio_dev);
541 st_magn_probe_trigger_error:
542 st_magn_deallocate_ring(indio_dev);
544 st_sensors_power_disable(indio_dev);
548 EXPORT_SYMBOL(st_magn_common_probe);
550 void st_magn_common_remove(struct iio_dev *indio_dev)
552 struct st_sensor_data *mdata = iio_priv(indio_dev);
554 st_sensors_power_disable(indio_dev);
556 iio_device_unregister(indio_dev);
558 st_sensors_deallocate_trigger(indio_dev);
560 st_magn_deallocate_ring(indio_dev);
562 EXPORT_SYMBOL(st_magn_common_remove);
564 MODULE_AUTHOR("Denis Ciocca <denis.ciocca@st.com>");
565 MODULE_DESCRIPTION("STMicroelectronics magnetometers driver");
566 MODULE_LICENSE("GPL v2");