2 * MMC35240 - MEMSIC 3-axis Magnetic Sensor
4 * Copyright (c) 2015, Intel Corporation.
6 * This file is subject to the terms and conditions of version 2 of
7 * the GNU General Public License. See the file COPYING in the main
8 * directory of this archive for more details.
10 * IIO driver for MMC35240 (7-bit I2C slave address 0x30).
12 * TODO: offset, ACPI, continuous measurement mode, PM
15 #include <linux/module.h>
16 #include <linux/init.h>
17 #include <linux/i2c.h>
18 #include <linux/delay.h>
19 #include <linux/regmap.h>
20 #include <linux/acpi.h>
23 #include <linux/iio/iio.h>
24 #include <linux/iio/sysfs.h>
26 #define MMC35240_DRV_NAME "mmc35240"
27 #define MMC35240_REGMAP_NAME "mmc35240_regmap"
29 #define MMC35240_REG_XOUT_L 0x00
30 #define MMC35240_REG_XOUT_H 0x01
31 #define MMC35240_REG_YOUT_L 0x02
32 #define MMC35240_REG_YOUT_H 0x03
33 #define MMC35240_REG_ZOUT_L 0x04
34 #define MMC35240_REG_ZOUT_H 0x05
36 #define MMC35240_REG_STATUS 0x06
37 #define MMC35240_REG_CTRL0 0x07
38 #define MMC35240_REG_CTRL1 0x08
40 #define MMC35240_REG_ID 0x20
42 #define MMC35240_STATUS_MEAS_DONE_BIT BIT(0)
44 #define MMC35240_CTRL0_REFILL_BIT BIT(7)
45 #define MMC35240_CTRL0_RESET_BIT BIT(6)
46 #define MMC35240_CTRL0_SET_BIT BIT(5)
47 #define MMC35240_CTRL0_CMM_BIT BIT(1)
48 #define MMC35240_CTRL0_TM_BIT BIT(0)
50 /* output resolution bits */
51 #define MMC35240_CTRL1_BW0_BIT BIT(0)
52 #define MMC35240_CTRL1_BW1_BIT BIT(1)
54 #define MMC35240_CTRL1_BW_MASK (MMC35240_CTRL1_BW0_BIT | \
55 MMC35240_CTRL1_BW1_BIT)
56 #define MMC35240_CTRL1_BW_SHIFT 0
58 #define MMC35240_WAIT_CHARGE_PUMP 50000 /* us */
59 #define MMC53240_WAIT_SET_RESET 1000 /* us */
61 enum mmc35240_resolution
{
62 MMC35240_16_BITS_SLOW
= 0, /* 100 Hz */
63 MMC35240_16_BITS_FAST
, /* 200 Hz */
64 MMC35240_14_BITS
, /* 333 Hz */
65 MMC35240_12_BITS
, /* 666 Hz */
75 int sens
[3]; /* sensitivity per X, Y, Z axis */
76 int nfo
; /* null field output */
77 } mmc35240_props_table
[] = {
78 /* 16 bits, 100Hz ODR */
83 /* 16 bits, 200Hz ODR */
88 /* 14 bits, 333Hz ODR */
93 /* 12 bits, 666Hz ODR */
100 struct mmc35240_data
{
101 struct i2c_client
*client
;
103 struct regmap
*regmap
;
104 enum mmc35240_resolution res
;
107 static const int mmc35240_samp_freq
[] = {100, 200, 333, 666};
109 static IIO_CONST_ATTR_SAMP_FREQ_AVAIL("100 200 333 666");
111 #define MMC35240_CHANNEL(_axis) { \
114 .channel2 = IIO_MOD_ ## _axis, \
115 .address = AXIS_ ## _axis, \
116 .info_mask_separate = BIT(IIO_CHAN_INFO_PROCESSED), \
117 .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SAMP_FREQ), \
120 static const struct iio_chan_spec mmc35240_channels
[] = {
126 static struct attribute
*mmc35240_attributes
[] = {
127 &iio_const_attr_sampling_frequency_available
.dev_attr
.attr
,
131 static const struct attribute_group mmc35240_attribute_group
= {
132 .attrs
= mmc35240_attributes
,
135 static int mmc35240_get_samp_freq_index(struct mmc35240_data
*data
,
140 for (i
= 0; i
< ARRAY_SIZE(mmc35240_samp_freq
); i
++)
141 if (mmc35240_samp_freq
[i
] == val
)
146 static int mmc35240_hw_set(struct mmc35240_data
*data
, bool set
)
152 * Recharge the capacitor at VCAP pin, requested to be issued
153 * before a SET/RESET command.
155 ret
= regmap_update_bits(data
->regmap
, MMC35240_REG_CTRL0
,
156 MMC35240_CTRL0_REFILL_BIT
,
157 MMC35240_CTRL0_REFILL_BIT
);
160 usleep_range(MMC35240_WAIT_CHARGE_PUMP
, MMC35240_WAIT_CHARGE_PUMP
+ 1);
163 coil_bit
= MMC35240_CTRL0_SET_BIT
;
165 coil_bit
= MMC35240_CTRL0_RESET_BIT
;
167 return regmap_update_bits(data
->regmap
, MMC35240_REG_CTRL0
,
168 MMC35240_CTRL0_REFILL_BIT
,
172 static int mmc35240_init(struct mmc35240_data
*data
)
177 ret
= regmap_read(data
->regmap
, MMC35240_REG_ID
, ®_id
);
179 dev_err(&data
->client
->dev
, "Error reading product id\n");
183 dev_dbg(&data
->client
->dev
, "MMC35240 chip id %x\n", reg_id
);
186 * make sure we restore sensor characteristics, by doing
187 * a RESET/SET sequence
189 ret
= mmc35240_hw_set(data
, false);
192 usleep_range(MMC53240_WAIT_SET_RESET
, MMC53240_WAIT_SET_RESET
+ 1);
194 ret
= mmc35240_hw_set(data
, true);
198 /* set default sampling frequency */
199 return regmap_update_bits(data
->regmap
, MMC35240_REG_CTRL1
,
200 MMC35240_CTRL1_BW_MASK
,
201 data
->res
<< MMC35240_CTRL1_BW_SHIFT
);
204 static int mmc35240_take_measurement(struct mmc35240_data
*data
)
206 int ret
, tries
= 100;
207 unsigned int reg_status
;
209 ret
= regmap_write(data
->regmap
, MMC35240_REG_CTRL0
,
210 MMC35240_CTRL0_TM_BIT
);
214 while (tries
-- > 0) {
215 ret
= regmap_read(data
->regmap
, MMC35240_REG_STATUS
,
219 if (reg_status
& MMC35240_STATUS_MEAS_DONE_BIT
)
225 dev_err(&data
->client
->dev
, "data not ready\n");
232 static int mmc35240_read_measurement(struct mmc35240_data
*data
, __le16 buf
[3])
236 ret
= mmc35240_take_measurement(data
);
240 return regmap_bulk_read(data
->regmap
, MMC35240_REG_XOUT_L
, (u8
*)buf
,
244 static int mmc35240_raw_to_gauss(struct mmc35240_data
*data
, int index
,
248 int raw_x
, raw_y
, raw_z
;
249 int sens_x
, sens_y
, sens_z
;
252 raw_x
= le16_to_cpu(buf
[AXIS_X
]);
253 raw_y
= le16_to_cpu(buf
[AXIS_Y
]);
254 raw_z
= le16_to_cpu(buf
[AXIS_Z
]);
256 sens_x
= mmc35240_props_table
[data
->res
].sens
[AXIS_X
];
257 sens_y
= mmc35240_props_table
[data
->res
].sens
[AXIS_Y
];
258 sens_z
= mmc35240_props_table
[data
->res
].sens
[AXIS_Z
];
260 nfo
= mmc35240_props_table
[data
->res
].nfo
;
264 *val
= (raw_x
- nfo
) / sens_x
;
265 *val2
= ((raw_x
- nfo
) % sens_x
) * 1000000;
268 *val
= (raw_y
- nfo
) / sens_y
- (raw_z
- nfo
) / sens_z
;
269 *val2
= (((raw_y
- nfo
) % sens_y
- (raw_z
- nfo
) % sens_z
))
273 *val
= (raw_y
- nfo
) / sens_y
+ (raw_z
- nfo
) / sens_z
;
274 *val2
= (((raw_y
- nfo
) % sens_y
+ (raw_z
- nfo
) % sens_z
))
283 static int mmc35240_read_raw(struct iio_dev
*indio_dev
,
284 struct iio_chan_spec
const *chan
, int *val
,
285 int *val2
, long mask
)
287 struct mmc35240_data
*data
= iio_priv(indio_dev
);
293 case IIO_CHAN_INFO_PROCESSED
:
294 mutex_lock(&data
->mutex
);
295 ret
= mmc35240_read_measurement(data
, buf
);
296 mutex_unlock(&data
->mutex
);
299 ret
= mmc35240_raw_to_gauss(data
, chan
->address
,
303 return IIO_VAL_INT_PLUS_MICRO
;
304 case IIO_CHAN_INFO_SAMP_FREQ
:
305 mutex_lock(&data
->mutex
);
306 ret
= regmap_read(data
->regmap
, MMC35240_REG_CTRL1
, ®
);
307 mutex_unlock(&data
->mutex
);
311 i
= (reg
& MMC35240_CTRL1_BW_MASK
) >> MMC35240_CTRL1_BW_SHIFT
;
312 if (i
< 0 || i
>= ARRAY_SIZE(mmc35240_samp_freq
))
315 *val
= mmc35240_samp_freq
[i
];
323 static int mmc35240_write_raw(struct iio_dev
*indio_dev
,
324 struct iio_chan_spec
const *chan
, int val
,
327 struct mmc35240_data
*data
= iio_priv(indio_dev
);
331 case IIO_CHAN_INFO_SAMP_FREQ
:
332 i
= mmc35240_get_samp_freq_index(data
, val
, val2
);
335 mutex_lock(&data
->mutex
);
336 ret
= regmap_update_bits(data
->regmap
, MMC35240_REG_CTRL1
,
337 MMC35240_CTRL1_BW_MASK
,
338 i
<< MMC35240_CTRL1_BW_SHIFT
);
339 mutex_unlock(&data
->mutex
);
346 static const struct iio_info mmc35240_info
= {
347 .driver_module
= THIS_MODULE
,
348 .read_raw
= mmc35240_read_raw
,
349 .write_raw
= mmc35240_write_raw
,
350 .attrs
= &mmc35240_attribute_group
,
353 static bool mmc35240_is_writeable_reg(struct device
*dev
, unsigned int reg
)
356 case MMC35240_REG_CTRL0
:
357 case MMC35240_REG_CTRL1
:
364 static bool mmc35240_is_readable_reg(struct device
*dev
, unsigned int reg
)
367 case MMC35240_REG_XOUT_L
:
368 case MMC35240_REG_XOUT_H
:
369 case MMC35240_REG_YOUT_L
:
370 case MMC35240_REG_YOUT_H
:
371 case MMC35240_REG_ZOUT_L
:
372 case MMC35240_REG_ZOUT_H
:
373 case MMC35240_REG_STATUS
:
374 case MMC35240_REG_ID
:
381 static bool mmc35240_is_volatile_reg(struct device
*dev
, unsigned int reg
)
384 case MMC35240_REG_CTRL0
:
385 case MMC35240_REG_CTRL1
:
392 static struct reg_default mmc35240_reg_defaults
[] = {
393 { MMC35240_REG_CTRL0
, 0x00 },
394 { MMC35240_REG_CTRL1
, 0x00 },
397 static const struct regmap_config mmc35240_regmap_config
= {
398 .name
= MMC35240_REGMAP_NAME
,
403 .max_register
= MMC35240_REG_ID
,
404 .cache_type
= REGCACHE_FLAT
,
406 .writeable_reg
= mmc35240_is_writeable_reg
,
407 .readable_reg
= mmc35240_is_readable_reg
,
408 .volatile_reg
= mmc35240_is_volatile_reg
,
410 .reg_defaults
= mmc35240_reg_defaults
,
411 .num_reg_defaults
= ARRAY_SIZE(mmc35240_reg_defaults
),
414 static int mmc35240_probe(struct i2c_client
*client
,
415 const struct i2c_device_id
*id
)
417 struct mmc35240_data
*data
;
418 struct iio_dev
*indio_dev
;
419 struct regmap
*regmap
;
422 indio_dev
= devm_iio_device_alloc(&client
->dev
, sizeof(*data
));
426 regmap
= devm_regmap_init_i2c(client
, &mmc35240_regmap_config
);
427 if (IS_ERR(regmap
)) {
428 dev_err(&client
->dev
, "regmap initialization failed\n");
429 return PTR_ERR(regmap
);
432 data
= iio_priv(indio_dev
);
433 data
->client
= client
;
434 data
->regmap
= regmap
;
435 data
->res
= MMC35240_16_BITS_SLOW
;
437 mutex_init(&data
->mutex
);
439 indio_dev
->dev
.parent
= &client
->dev
;
440 indio_dev
->info
= &mmc35240_info
;
441 indio_dev
->name
= MMC35240_DRV_NAME
;
442 indio_dev
->channels
= mmc35240_channels
;
443 indio_dev
->num_channels
= ARRAY_SIZE(mmc35240_channels
);
444 indio_dev
->modes
= INDIO_DIRECT_MODE
;
446 ret
= mmc35240_init(data
);
448 dev_err(&client
->dev
, "mmc35240 chip init failed\n");
451 return devm_iio_device_register(&client
->dev
, indio_dev
);
454 #ifdef CONFIG_PM_SLEEP
455 static int mmc35240_suspend(struct device
*dev
)
457 struct iio_dev
*indio_dev
= i2c_get_clientdata(to_i2c_client(dev
));
458 struct mmc35240_data
*data
= iio_priv(indio_dev
);
460 regcache_cache_only(data
->regmap
, true);
465 static int mmc35240_resume(struct device
*dev
)
467 struct iio_dev
*indio_dev
= i2c_get_clientdata(to_i2c_client(dev
));
468 struct mmc35240_data
*data
= iio_priv(indio_dev
);
471 regcache_mark_dirty(data
->regmap
);
472 ret
= regcache_sync_region(data
->regmap
, MMC35240_REG_CTRL0
,
475 dev_err(dev
, "Failed to restore control registers\n");
477 regcache_cache_only(data
->regmap
, false);
483 static const struct dev_pm_ops mmc35240_pm_ops
= {
484 SET_SYSTEM_SLEEP_PM_OPS(mmc35240_suspend
, mmc35240_resume
)
487 static const struct acpi_device_id mmc35240_acpi_match
[] = {
491 MODULE_DEVICE_TABLE(acpi
, mmc35240_acpi_match
);
493 static const struct i2c_device_id mmc35240_id
[] = {
497 MODULE_DEVICE_TABLE(i2c
, mmc35240_id
);
499 static struct i2c_driver mmc35240_driver
= {
501 .name
= MMC35240_DRV_NAME
,
502 .pm
= &mmc35240_pm_ops
,
503 .acpi_match_table
= ACPI_PTR(mmc35240_acpi_match
),
505 .probe
= mmc35240_probe
,
506 .id_table
= mmc35240_id
,
509 module_i2c_driver(mmc35240_driver
);
511 MODULE_AUTHOR("Daniel Baluta <daniel.baluta@intel.com>");
512 MODULE_DESCRIPTION("MEMSIC MMC35240 magnetic sensor driver");
513 MODULE_LICENSE("GPL v2");