mirror of
https://github.com/torvalds/linux.git
synced 2024-11-05 19:41:54 +00:00
872e79add7
This patch adds a generic magnetometer driver for STMicroelectronics magnetometers, currently it supports: LSM303DLHC, LSM303DLM, LIS3MDL. Signed-off-by: Denis Ciocca <denis.ciocca@st.com> Signed-off-by: Jonathan Cameron <jic23@kernel.org>
402 lines
12 KiB
C
402 lines
12 KiB
C
/*
|
|
* STMicroelectronics magnetometers driver
|
|
*
|
|
* Copyright 2012-2013 STMicroelectronics Inc.
|
|
*
|
|
* Denis Ciocca <denis.ciocca@st.com>
|
|
*
|
|
* Licensed under the GPL-2.
|
|
*/
|
|
|
|
#include <linux/kernel.h>
|
|
#include <linux/module.h>
|
|
#include <linux/slab.h>
|
|
#include <linux/errno.h>
|
|
#include <linux/types.h>
|
|
#include <linux/mutex.h>
|
|
#include <linux/interrupt.h>
|
|
#include <linux/i2c.h>
|
|
#include <linux/gpio.h>
|
|
#include <linux/irq.h>
|
|
#include <linux/delay.h>
|
|
#include <linux/iio/iio.h>
|
|
#include <linux/iio/sysfs.h>
|
|
#include <linux/iio/trigger_consumer.h>
|
|
#include <linux/iio/buffer.h>
|
|
|
|
#include <linux/iio/common/st_sensors.h>
|
|
#include "st_magn.h"
|
|
|
|
/* DEFAULT VALUE FOR SENSORS */
|
|
#define ST_MAGN_DEFAULT_OUT_X_L_ADDR 0X04
|
|
#define ST_MAGN_DEFAULT_OUT_Y_L_ADDR 0X08
|
|
#define ST_MAGN_DEFAULT_OUT_Z_L_ADDR 0X06
|
|
|
|
/* FULLSCALE */
|
|
#define ST_MAGN_FS_AVL_1300MG 1300
|
|
#define ST_MAGN_FS_AVL_1900MG 1900
|
|
#define ST_MAGN_FS_AVL_2500MG 2500
|
|
#define ST_MAGN_FS_AVL_4000MG 4000
|
|
#define ST_MAGN_FS_AVL_4700MG 4700
|
|
#define ST_MAGN_FS_AVL_5600MG 5600
|
|
#define ST_MAGN_FS_AVL_8000MG 8000
|
|
#define ST_MAGN_FS_AVL_8100MG 8100
|
|
#define ST_MAGN_FS_AVL_10000MG 10000
|
|
|
|
/* CUSTOM VALUES FOR SENSOR 1 */
|
|
#define ST_MAGN_1_WAI_EXP 0x3c
|
|
#define ST_MAGN_1_ODR_ADDR 0x00
|
|
#define ST_MAGN_1_ODR_MASK 0x1c
|
|
#define ST_MAGN_1_ODR_AVL_1HZ_VAL 0x00
|
|
#define ST_MAGN_1_ODR_AVL_2HZ_VAL 0x01
|
|
#define ST_MAGN_1_ODR_AVL_3HZ_VAL 0x02
|
|
#define ST_MAGN_1_ODR_AVL_8HZ_VAL 0x03
|
|
#define ST_MAGN_1_ODR_AVL_15HZ_VAL 0x04
|
|
#define ST_MAGN_1_ODR_AVL_30HZ_VAL 0x05
|
|
#define ST_MAGN_1_ODR_AVL_75HZ_VAL 0x06
|
|
#define ST_MAGN_1_ODR_AVL_220HZ_VAL 0x07
|
|
#define ST_MAGN_1_PW_ADDR 0x02
|
|
#define ST_MAGN_1_PW_MASK 0x03
|
|
#define ST_MAGN_1_PW_ON 0x00
|
|
#define ST_MAGN_1_PW_OFF 0x03
|
|
#define ST_MAGN_1_FS_ADDR 0x01
|
|
#define ST_MAGN_1_FS_MASK 0xe0
|
|
#define ST_MAGN_1_FS_AVL_1300_VAL 0x01
|
|
#define ST_MAGN_1_FS_AVL_1900_VAL 0x02
|
|
#define ST_MAGN_1_FS_AVL_2500_VAL 0x03
|
|
#define ST_MAGN_1_FS_AVL_4000_VAL 0x04
|
|
#define ST_MAGN_1_FS_AVL_4700_VAL 0x05
|
|
#define ST_MAGN_1_FS_AVL_5600_VAL 0x06
|
|
#define ST_MAGN_1_FS_AVL_8100_VAL 0x07
|
|
#define ST_MAGN_1_FS_AVL_1300_GAIN_XY 1100
|
|
#define ST_MAGN_1_FS_AVL_1900_GAIN_XY 855
|
|
#define ST_MAGN_1_FS_AVL_2500_GAIN_XY 670
|
|
#define ST_MAGN_1_FS_AVL_4000_GAIN_XY 450
|
|
#define ST_MAGN_1_FS_AVL_4700_GAIN_XY 400
|
|
#define ST_MAGN_1_FS_AVL_5600_GAIN_XY 330
|
|
#define ST_MAGN_1_FS_AVL_8100_GAIN_XY 230
|
|
#define ST_MAGN_1_FS_AVL_1300_GAIN_Z 980
|
|
#define ST_MAGN_1_FS_AVL_1900_GAIN_Z 760
|
|
#define ST_MAGN_1_FS_AVL_2500_GAIN_Z 600
|
|
#define ST_MAGN_1_FS_AVL_4000_GAIN_Z 400
|
|
#define ST_MAGN_1_FS_AVL_4700_GAIN_Z 355
|
|
#define ST_MAGN_1_FS_AVL_5600_GAIN_Z 295
|
|
#define ST_MAGN_1_FS_AVL_8100_GAIN_Z 205
|
|
#define ST_MAGN_1_MULTIREAD_BIT false
|
|
|
|
/* CUSTOM VALUES FOR SENSOR 2 */
|
|
#define ST_MAGN_2_WAI_EXP 0x3d
|
|
#define ST_MAGN_2_ODR_ADDR 0x20
|
|
#define ST_MAGN_2_ODR_MASK 0x1c
|
|
#define ST_MAGN_2_ODR_AVL_1HZ_VAL 0x00
|
|
#define ST_MAGN_2_ODR_AVL_2HZ_VAL 0x01
|
|
#define ST_MAGN_2_ODR_AVL_3HZ_VAL 0x02
|
|
#define ST_MAGN_2_ODR_AVL_5HZ_VAL 0x03
|
|
#define ST_MAGN_2_ODR_AVL_10HZ_VAL 0x04
|
|
#define ST_MAGN_2_ODR_AVL_20HZ_VAL 0x05
|
|
#define ST_MAGN_2_ODR_AVL_40HZ_VAL 0x06
|
|
#define ST_MAGN_2_ODR_AVL_80HZ_VAL 0x07
|
|
#define ST_MAGN_2_PW_ADDR 0x22
|
|
#define ST_MAGN_2_PW_MASK 0x03
|
|
#define ST_MAGN_2_PW_ON 0x00
|
|
#define ST_MAGN_2_PW_OFF 0x03
|
|
#define ST_MAGN_2_FS_ADDR 0x21
|
|
#define ST_MAGN_2_FS_MASK 0x60
|
|
#define ST_MAGN_2_FS_AVL_4000_VAL 0x00
|
|
#define ST_MAGN_2_FS_AVL_8000_VAL 0x01
|
|
#define ST_MAGN_2_FS_AVL_10000_VAL 0x02
|
|
#define ST_MAGN_2_FS_AVL_4000_GAIN 430
|
|
#define ST_MAGN_2_FS_AVL_8000_GAIN 230
|
|
#define ST_MAGN_2_FS_AVL_10000_GAIN 230
|
|
#define ST_MAGN_2_MULTIREAD_BIT false
|
|
#define ST_MAGN_2_OUT_X_L_ADDR 0x28
|
|
#define ST_MAGN_2_OUT_Y_L_ADDR 0x2a
|
|
#define ST_MAGN_2_OUT_Z_L_ADDR 0x2c
|
|
|
|
static const struct iio_chan_spec st_magn_16bit_channels[] = {
|
|
ST_SENSORS_LSM_CHANNELS(IIO_MAGN, ST_SENSORS_SCAN_X, IIO_MOD_X, IIO_LE,
|
|
ST_SENSORS_DEFAULT_16_REALBITS, ST_MAGN_DEFAULT_OUT_X_L_ADDR),
|
|
ST_SENSORS_LSM_CHANNELS(IIO_MAGN, ST_SENSORS_SCAN_Y, IIO_MOD_Y, IIO_LE,
|
|
ST_SENSORS_DEFAULT_16_REALBITS, ST_MAGN_DEFAULT_OUT_Y_L_ADDR),
|
|
ST_SENSORS_LSM_CHANNELS(IIO_MAGN, ST_SENSORS_SCAN_Z, IIO_MOD_Z, IIO_LE,
|
|
ST_SENSORS_DEFAULT_16_REALBITS, ST_MAGN_DEFAULT_OUT_Z_L_ADDR),
|
|
IIO_CHAN_SOFT_TIMESTAMP(3)
|
|
};
|
|
|
|
static const struct iio_chan_spec st_magn_2_16bit_channels[] = {
|
|
ST_SENSORS_LSM_CHANNELS(IIO_MAGN, ST_SENSORS_SCAN_X, IIO_MOD_X, IIO_LE,
|
|
ST_SENSORS_DEFAULT_16_REALBITS, ST_MAGN_2_OUT_X_L_ADDR),
|
|
ST_SENSORS_LSM_CHANNELS(IIO_MAGN, ST_SENSORS_SCAN_Y, IIO_MOD_Y, IIO_LE,
|
|
ST_SENSORS_DEFAULT_16_REALBITS, ST_MAGN_2_OUT_Y_L_ADDR),
|
|
ST_SENSORS_LSM_CHANNELS(IIO_MAGN, ST_SENSORS_SCAN_Z, IIO_MOD_Z, IIO_LE,
|
|
ST_SENSORS_DEFAULT_16_REALBITS, ST_MAGN_2_OUT_Z_L_ADDR),
|
|
IIO_CHAN_SOFT_TIMESTAMP(3)
|
|
};
|
|
|
|
static const struct st_sensors st_magn_sensors[] = {
|
|
{
|
|
.wai = ST_MAGN_1_WAI_EXP,
|
|
.sensors_supported = {
|
|
[0] = LSM303DLHC_MAGN_DEV_NAME,
|
|
[1] = LSM303DLM_MAGN_DEV_NAME,
|
|
},
|
|
.ch = (struct iio_chan_spec *)st_magn_16bit_channels,
|
|
.odr = {
|
|
.addr = ST_MAGN_1_ODR_ADDR,
|
|
.mask = ST_MAGN_1_ODR_MASK,
|
|
.odr_avl = {
|
|
{ 1, ST_MAGN_1_ODR_AVL_1HZ_VAL, },
|
|
{ 2, ST_MAGN_1_ODR_AVL_2HZ_VAL, },
|
|
{ 3, ST_MAGN_1_ODR_AVL_3HZ_VAL, },
|
|
{ 8, ST_MAGN_1_ODR_AVL_8HZ_VAL, },
|
|
{ 15, ST_MAGN_1_ODR_AVL_15HZ_VAL, },
|
|
{ 30, ST_MAGN_1_ODR_AVL_30HZ_VAL, },
|
|
{ 75, ST_MAGN_1_ODR_AVL_75HZ_VAL, },
|
|
{ 220, ST_MAGN_1_ODR_AVL_220HZ_VAL, },
|
|
},
|
|
},
|
|
.pw = {
|
|
.addr = ST_MAGN_1_PW_ADDR,
|
|
.mask = ST_MAGN_1_PW_MASK,
|
|
.value_on = ST_MAGN_1_PW_ON,
|
|
.value_off = ST_MAGN_1_PW_OFF,
|
|
},
|
|
.fs = {
|
|
.addr = ST_MAGN_1_FS_ADDR,
|
|
.mask = ST_MAGN_1_FS_MASK,
|
|
.fs_avl = {
|
|
[0] = {
|
|
.num = ST_MAGN_FS_AVL_1300MG,
|
|
.value = ST_MAGN_1_FS_AVL_1300_VAL,
|
|
.gain = ST_MAGN_1_FS_AVL_1300_GAIN_XY,
|
|
.gain2 = ST_MAGN_1_FS_AVL_1300_GAIN_Z,
|
|
},
|
|
[1] = {
|
|
.num = ST_MAGN_FS_AVL_1900MG,
|
|
.value = ST_MAGN_1_FS_AVL_1900_VAL,
|
|
.gain = ST_MAGN_1_FS_AVL_1900_GAIN_XY,
|
|
.gain2 = ST_MAGN_1_FS_AVL_1900_GAIN_Z,
|
|
},
|
|
[2] = {
|
|
.num = ST_MAGN_FS_AVL_2500MG,
|
|
.value = ST_MAGN_1_FS_AVL_2500_VAL,
|
|
.gain = ST_MAGN_1_FS_AVL_2500_GAIN_XY,
|
|
.gain2 = ST_MAGN_1_FS_AVL_2500_GAIN_Z,
|
|
},
|
|
[3] = {
|
|
.num = ST_MAGN_FS_AVL_4000MG,
|
|
.value = ST_MAGN_1_FS_AVL_4000_VAL,
|
|
.gain = ST_MAGN_1_FS_AVL_4000_GAIN_XY,
|
|
.gain2 = ST_MAGN_1_FS_AVL_4000_GAIN_Z,
|
|
},
|
|
[4] = {
|
|
.num = ST_MAGN_FS_AVL_4700MG,
|
|
.value = ST_MAGN_1_FS_AVL_4700_VAL,
|
|
.gain = ST_MAGN_1_FS_AVL_4700_GAIN_XY,
|
|
.gain2 = ST_MAGN_1_FS_AVL_4700_GAIN_Z,
|
|
},
|
|
[5] = {
|
|
.num = ST_MAGN_FS_AVL_5600MG,
|
|
.value = ST_MAGN_1_FS_AVL_5600_VAL,
|
|
.gain = ST_MAGN_1_FS_AVL_5600_GAIN_XY,
|
|
.gain2 = ST_MAGN_1_FS_AVL_5600_GAIN_Z,
|
|
},
|
|
[6] = {
|
|
.num = ST_MAGN_FS_AVL_8100MG,
|
|
.value = ST_MAGN_1_FS_AVL_8100_VAL,
|
|
.gain = ST_MAGN_1_FS_AVL_8100_GAIN_XY,
|
|
.gain2 = ST_MAGN_1_FS_AVL_8100_GAIN_Z,
|
|
},
|
|
},
|
|
},
|
|
.multi_read_bit = ST_MAGN_1_MULTIREAD_BIT,
|
|
.bootime = 2,
|
|
},
|
|
{
|
|
.wai = ST_MAGN_2_WAI_EXP,
|
|
.sensors_supported = {
|
|
[0] = LIS3MDL_MAGN_DEV_NAME,
|
|
},
|
|
.ch = (struct iio_chan_spec *)st_magn_2_16bit_channels,
|
|
.odr = {
|
|
.addr = ST_MAGN_2_ODR_ADDR,
|
|
.mask = ST_MAGN_2_ODR_MASK,
|
|
.odr_avl = {
|
|
{ 1, ST_MAGN_2_ODR_AVL_1HZ_VAL, },
|
|
{ 2, ST_MAGN_2_ODR_AVL_2HZ_VAL, },
|
|
{ 3, ST_MAGN_2_ODR_AVL_3HZ_VAL, },
|
|
{ 5, ST_MAGN_2_ODR_AVL_5HZ_VAL, },
|
|
{ 10, ST_MAGN_2_ODR_AVL_10HZ_VAL, },
|
|
{ 20, ST_MAGN_2_ODR_AVL_20HZ_VAL, },
|
|
{ 40, ST_MAGN_2_ODR_AVL_40HZ_VAL, },
|
|
{ 80, ST_MAGN_2_ODR_AVL_80HZ_VAL, },
|
|
},
|
|
},
|
|
.pw = {
|
|
.addr = ST_MAGN_2_PW_ADDR,
|
|
.mask = ST_MAGN_2_PW_MASK,
|
|
.value_on = ST_MAGN_2_PW_ON,
|
|
.value_off = ST_MAGN_2_PW_OFF,
|
|
},
|
|
.fs = {
|
|
.addr = ST_MAGN_2_FS_ADDR,
|
|
.mask = ST_MAGN_2_FS_MASK,
|
|
.fs_avl = {
|
|
[0] = {
|
|
.num = ST_MAGN_FS_AVL_4000MG,
|
|
.value = ST_MAGN_2_FS_AVL_4000_VAL,
|
|
.gain = ST_MAGN_2_FS_AVL_4000_GAIN,
|
|
},
|
|
[1] = {
|
|
.num = ST_MAGN_FS_AVL_8000MG,
|
|
.value = ST_MAGN_2_FS_AVL_8000_VAL,
|
|
.gain = ST_MAGN_2_FS_AVL_8000_GAIN,
|
|
},
|
|
[2] = {
|
|
.num = ST_MAGN_FS_AVL_10000MG,
|
|
.value = ST_MAGN_2_FS_AVL_10000_VAL,
|
|
.gain = ST_MAGN_2_FS_AVL_10000_GAIN,
|
|
},
|
|
},
|
|
},
|
|
.multi_read_bit = ST_MAGN_2_MULTIREAD_BIT,
|
|
.bootime = 2,
|
|
},
|
|
};
|
|
|
|
static int st_magn_read_raw(struct iio_dev *indio_dev,
|
|
struct iio_chan_spec const *ch, int *val,
|
|
int *val2, long mask)
|
|
{
|
|
int err;
|
|
struct st_sensor_data *mdata = iio_priv(indio_dev);
|
|
|
|
switch (mask) {
|
|
case IIO_CHAN_INFO_RAW:
|
|
err = st_sensors_read_info_raw(indio_dev, ch, val);
|
|
if (err < 0)
|
|
goto read_error;
|
|
|
|
return IIO_VAL_INT;
|
|
case IIO_CHAN_INFO_SCALE:
|
|
*val = 0;
|
|
if ((ch->scan_index == ST_SENSORS_SCAN_Z) &&
|
|
(mdata->current_fullscale->gain2 != 0))
|
|
*val2 = mdata->current_fullscale->gain2;
|
|
else
|
|
*val2 = mdata->current_fullscale->gain;
|
|
return IIO_VAL_INT_PLUS_MICRO;
|
|
default:
|
|
return -EINVAL;
|
|
}
|
|
|
|
read_error:
|
|
return err;
|
|
}
|
|
|
|
static int st_magn_write_raw(struct iio_dev *indio_dev,
|
|
struct iio_chan_spec const *chan, int val, int val2, long mask)
|
|
{
|
|
int err;
|
|
|
|
switch (mask) {
|
|
case IIO_CHAN_INFO_SCALE:
|
|
err = st_sensors_set_fullscale_by_gain(indio_dev, val2);
|
|
break;
|
|
default:
|
|
err = -EINVAL;
|
|
}
|
|
|
|
return err;
|
|
}
|
|
|
|
static ST_SENSOR_DEV_ATTR_SAMP_FREQ();
|
|
static ST_SENSORS_DEV_ATTR_SAMP_FREQ_AVAIL();
|
|
static ST_SENSORS_DEV_ATTR_SCALE_AVAIL(in_magn_scale_available);
|
|
|
|
static struct attribute *st_magn_attributes[] = {
|
|
&iio_dev_attr_sampling_frequency_available.dev_attr.attr,
|
|
&iio_dev_attr_in_magn_scale_available.dev_attr.attr,
|
|
&iio_dev_attr_sampling_frequency.dev_attr.attr,
|
|
NULL,
|
|
};
|
|
|
|
static const struct attribute_group st_magn_attribute_group = {
|
|
.attrs = st_magn_attributes,
|
|
};
|
|
|
|
static const struct iio_info magn_info = {
|
|
.driver_module = THIS_MODULE,
|
|
.attrs = &st_magn_attribute_group,
|
|
.read_raw = &st_magn_read_raw,
|
|
.write_raw = &st_magn_write_raw,
|
|
};
|
|
|
|
int st_magn_common_probe(struct iio_dev *indio_dev)
|
|
{
|
|
int err;
|
|
struct st_sensor_data *mdata = iio_priv(indio_dev);
|
|
|
|
indio_dev->modes = INDIO_DIRECT_MODE;
|
|
indio_dev->info = &magn_info;
|
|
|
|
err = st_sensors_check_device_support(indio_dev,
|
|
ARRAY_SIZE(st_magn_sensors), st_magn_sensors);
|
|
if (err < 0)
|
|
goto st_magn_common_probe_error;
|
|
|
|
mdata->multiread_bit = mdata->sensor->multi_read_bit;
|
|
indio_dev->channels = mdata->sensor->ch;
|
|
indio_dev->num_channels = ST_SENSORS_NUMBER_ALL_CHANNELS;
|
|
|
|
mdata->current_fullscale = (struct st_sensor_fullscale_avl *)
|
|
&mdata->sensor->fs.fs_avl[0];
|
|
mdata->odr = mdata->sensor->odr.odr_avl[0].hz;
|
|
|
|
err = st_sensors_init_sensor(indio_dev);
|
|
if (err < 0)
|
|
goto st_magn_common_probe_error;
|
|
|
|
if (mdata->get_irq_data_ready(indio_dev) > 0) {
|
|
err = st_magn_allocate_ring(indio_dev);
|
|
if (err < 0)
|
|
goto st_magn_common_probe_error;
|
|
err = st_sensors_allocate_trigger(indio_dev, NULL);
|
|
if (err < 0)
|
|
goto st_magn_probe_trigger_error;
|
|
}
|
|
|
|
err = iio_device_register(indio_dev);
|
|
if (err)
|
|
goto st_magn_device_register_error;
|
|
|
|
return err;
|
|
|
|
st_magn_device_register_error:
|
|
if (mdata->get_irq_data_ready(indio_dev) > 0)
|
|
st_sensors_deallocate_trigger(indio_dev);
|
|
st_magn_probe_trigger_error:
|
|
if (mdata->get_irq_data_ready(indio_dev) > 0)
|
|
st_magn_deallocate_ring(indio_dev);
|
|
st_magn_common_probe_error:
|
|
return err;
|
|
}
|
|
EXPORT_SYMBOL(st_magn_common_probe);
|
|
|
|
void st_magn_common_remove(struct iio_dev *indio_dev)
|
|
{
|
|
struct st_sensor_data *mdata = iio_priv(indio_dev);
|
|
|
|
iio_device_unregister(indio_dev);
|
|
if (mdata->get_irq_data_ready(indio_dev) > 0) {
|
|
st_sensors_deallocate_trigger(indio_dev);
|
|
st_magn_deallocate_ring(indio_dev);
|
|
}
|
|
iio_device_free(indio_dev);
|
|
}
|
|
EXPORT_SYMBOL(st_magn_common_remove);
|
|
|
|
MODULE_AUTHOR("Denis Ciocca <denis.ciocca@st.com>");
|
|
MODULE_DESCRIPTION("STMicroelectronics magnetometers driver");
|
|
MODULE_LICENSE("GPL v2");
|