3  * Driver for the Asahi Kasei EMD Corporation AK8974
42 /* These registers are common for AK8974 and AMI30x */
68 /* AK8974-specific offsets */
173  * struct ak8974 - state container for the AK8974 driver
176  * @map: regmap to access the AK8974 registers over I2C
186 struct ak8974 {  struct
207 static int ak8974_get_u16_val(struct ak8974 *ak8974, u8 reg, u16 *val)  in ak8974_get_u16_val()  argument
212 	ret = regmap_bulk_read(ak8974->map, reg, &bulk, 2);  in ak8974_get_u16_val()
220 static int ak8974_set_u16_val(struct ak8974 *ak8974, u8 reg, u16 val)  in ak8974_set_u16_val()  argument
224 	return regmap_bulk_write(ak8974->map, reg, &bulk, 2);  in ak8974_set_u16_val()
227 static int ak8974_set_power(struct ak8974 *ak8974, bool mode)  in ak8974_set_power()  argument
234 	ret = regmap_write(ak8974->map, AK8974_CTRL1, val);  in ak8974_set_power()
244 static int ak8974_reset(struct ak8974 *ak8974)  in ak8974_reset()  argument
249 	ret = ak8974_set_power(ak8974, AK8974_PWR_ON);  in ak8974_reset()
252 	ret = regmap_write(ak8974->map, AK8974_CTRL2, AK8974_CTRL2_RESDEF);  in ak8974_reset()
255 	ret = regmap_write(ak8974->map, AK8974_CTRL3, AK8974_CTRL3_RESDEF);  in ak8974_reset()
258 	if (ak8974->variant != AK8974_WHOAMI_VALUE_HSCDTD008A) {  in ak8974_reset()
259 		ret = regmap_write(ak8974->map, AK8974_INT_CTRL,  in ak8974_reset()
264 		ret = regmap_write(ak8974->map, HSCDTD008A_CTRL4,  in ak8974_reset()
271 	return ak8974_set_power(ak8974, AK8974_PWR_OFF);  in ak8974_reset()
274 static int ak8974_configure(struct ak8974 *ak8974)  in ak8974_configure()  argument
278 	ret = regmap_write(ak8974->map, AK8974_CTRL2, AK8974_CTRL2_DRDY_EN |  in ak8974_configure()
282 	ret = regmap_write(ak8974->map, AK8974_CTRL3, 0);  in ak8974_configure()
285 	if (ak8974->variant == AK8974_WHOAMI_VALUE_AMI306) {  in ak8974_configure()
287 		ret = ak8974_set_u16_val(ak8974, AMI306_CTRL4, 0xA07E);  in ak8974_configure()
291 	if (ak8974->variant == AK8974_WHOAMI_VALUE_HSCDTD008A)  in ak8974_configure()
293 	ret = regmap_write(ak8974->map, AK8974_INT_CTRL, AK8974_INT_CTRL_POL);  in ak8974_configure()
297 	return regmap_write(ak8974->map, AK8974_PRESET, 0);  in ak8974_configure()
300 static int ak8974_trigmeas(struct ak8974 *ak8974)  in ak8974_trigmeas()  argument
308 	ret = regmap_read(ak8974->map, AK8974_INT_CLEAR, &clear);  in ak8974_trigmeas()
313 	if (ak8974->drdy_irq) {  in ak8974_trigmeas()
319 		if (!ak8974->drdy_active_low)  in ak8974_trigmeas()
322 		init_completion(&ak8974->drdy_complete);  in ak8974_trigmeas()
323 		ret = regmap_update_bits(ak8974->map, AK8974_CTRL2,  in ak8974_trigmeas()
330 	return regmap_update_bits(ak8974->map,  in ak8974_trigmeas()
336 static int ak8974_await_drdy(struct ak8974 *ak8974)  in ak8974_await_drdy()  argument
342 	if (ak8974->drdy_irq) {  in ak8974_await_drdy()
343 		ret = wait_for_completion_timeout(&ak8974->drdy_complete,  in ak8974_await_drdy()
346 			dev_err(&ak8974->i2c->dev,  in ak8974_await_drdy()
356 		ret = regmap_read(ak8974->map, AK8974_STATUS, &val);  in ak8974_await_drdy()
363 	dev_err(&ak8974->i2c->dev, "timeout waiting for DRDY\n");  in ak8974_await_drdy()
367 static int ak8974_getresult(struct ak8974 *ak8974, __le16 *result)  in ak8974_getresult()  argument
372 	ret = ak8974_await_drdy(ak8974);  in ak8974_getresult()
375 	ret = regmap_read(ak8974->map, AK8974_INT_SRC, &src);  in ak8974_getresult()
381 		dev_err(&ak8974->i2c->dev,  in ak8974_getresult()
386 	ret = regmap_bulk_read(ak8974->map, AK8974_DATA_X, result, 6);  in ak8974_getresult()
395 	struct ak8974 *ak8974 = d;  in ak8974_drdy_irq()  local
397 	if (!ak8974->drdy_irq)  in ak8974_drdy_irq()
406 	struct ak8974 *ak8974 = d;  in ak8974_drdy_irq_thread()  local
411 	ret = regmap_read(ak8974->map, AK8974_STATUS, &val);  in ak8974_drdy_irq_thread()
413 		dev_err(&ak8974->i2c->dev, "error reading DRDY status\n");  in ak8974_drdy_irq_thread()
418 		complete(&ak8974->drdy_complete);  in ak8974_drdy_irq_thread()
426 static int ak8974_selftest(struct ak8974 *ak8974)  in ak8974_selftest()  argument
428 	struct device *dev = &ak8974->i2c->dev;  in ak8974_selftest()
432 	ret = regmap_read(ak8974->map, AK8974_SELFTEST, &val);  in ak8974_selftest()
441 	ret = regmap_update_bits(ak8974->map,  in ak8974_selftest()
452 	ret = regmap_read(ak8974->map, AK8974_SELFTEST, &val);  in ak8974_selftest()
460 	ret = regmap_read(ak8974->map, AK8974_SELFTEST, &val);  in ak8974_selftest()
472 static void ak8974_read_calib_data(struct ak8974 *ak8974, unsigned int reg,  in ak8974_read_calib_data()  argument
475 	int ret = regmap_bulk_read(ak8974->map, reg, tab, tab_size);  in ak8974_read_calib_data()
478 		dev_warn(&ak8974->i2c->dev,  in ak8974_read_calib_data()
486 static int ak8974_detect(struct ak8974 *ak8974)  in ak8974_detect()  argument
494 	ret = regmap_read(ak8974->map, AK8974_WHOAMI, &whoami);  in ak8974_detect()
505 		ret = regmap_read(ak8974->map, AMI305_VER, &fw);  in ak8974_detect()
509 		ret = ak8974_get_u16_val(ak8974, AMI305_SN, &sn);  in ak8974_detect()
513 		dev_info(&ak8974->i2c->dev,  in ak8974_detect()
518 		name = "ak8974";  in ak8974_detect()
519 		dev_info(&ak8974->i2c->dev, "detected AK8974\n");  in ak8974_detect()
523 		dev_info(&ak8974->i2c->dev, "detected hscdtd008a\n");  in ak8974_detect()
526 		dev_err(&ak8974->i2c->dev, "unsupported device (%02x) ",  in ak8974_detect()
531 	ak8974->name = name;  in ak8974_detect()
532 	ak8974->variant = whoami;  in ak8974_detect()
538 		ak8974_read_calib_data(ak8974, AMI306_FINEOUTPUT_X,  in ak8974_detect()
540 		ak8974_read_calib_data(ak8974, AMI306_OFFZERO_X,  in ak8974_detect()
554 			dev_info(&ak8974->i2c->dev,  in ak8974_detect()
564 static int ak8974_measure_channel(struct ak8974 *ak8974, unsigned long address,  in ak8974_measure_channel()  argument
570 	pm_runtime_get_sync(&ak8974->i2c->dev);  in ak8974_measure_channel()
571 	mutex_lock(&ak8974->lock);  in ak8974_measure_channel()
577 	ret = ak8974_trigmeas(ak8974);  in ak8974_measure_channel()
580 	ret = ak8974_getresult(ak8974, hw_values);  in ak8974_measure_channel()
591 	mutex_unlock(&ak8974->lock);  in ak8974_measure_channel()
592 	pm_runtime_mark_last_busy(&ak8974->i2c->dev);  in ak8974_measure_channel()
593 	pm_runtime_put_autosuspend(&ak8974->i2c->dev);  in ak8974_measure_channel()
603 	struct ak8974 *ak8974 = iio_priv(indio_dev);  in ak8974_read_raw()  local
609 			dev_err(&ak8974->i2c->dev, "faulty channel address\n");  in ak8974_read_raw()
612 		ret = ak8974_measure_channel(ak8974, chan->address, val);  in ak8974_read_raw()
617 		switch (ak8974->variant) {  in ak8974_read_raw()
665 	struct ak8974 *ak8974 = iio_priv(indio_dev);  in ak8974_fill_buffer()  local
668 	pm_runtime_get_sync(&ak8974->i2c->dev);  in ak8974_fill_buffer()
669 	mutex_lock(&ak8974->lock);  in ak8974_fill_buffer()
671 	ret = ak8974_trigmeas(ak8974);  in ak8974_fill_buffer()
673 		dev_err(&ak8974->i2c->dev, "error triggering measure\n");  in ak8974_fill_buffer()
676 	ret = ak8974_getresult(ak8974, ak8974->scan.channels);  in ak8974_fill_buffer()
678 		dev_err(&ak8974->i2c->dev, "error getting measures\n");  in ak8974_fill_buffer()
682 	iio_push_to_buffers_with_timestamp(indio_dev, &ak8974->scan,  in ak8974_fill_buffer()
686 	mutex_unlock(&ak8974->lock);  in ak8974_fill_buffer()
687 	pm_runtime_mark_last_busy(&ak8974->i2c->dev);  in ak8974_fill_buffer()
688 	pm_runtime_put_autosuspend(&ak8974->i2c->dev);  in ak8974_fill_buffer()
706 	struct ak8974 *ak8974 = iio_priv(indio_dev);  in ak8974_get_mount_matrix()  local
708 	return &ak8974->orientation;  in ak8974_get_mount_matrix()
735  * We have no datasheet for the AK8974 but we guess that its
767 	struct ak8974 *ak8974 = iio_priv(indio_dev);  in ak8974_writeable_reg()  local
779 		return ak8974->variant != AK8974_WHOAMI_VALUE_HSCDTD008A;  in ak8974_writeable_reg()
786 		return ak8974->variant == AK8974_WHOAMI_VALUE_AK8974 ||  in ak8974_writeable_reg()
787 		       ak8974->variant == AK8974_WHOAMI_VALUE_HSCDTD008A;  in ak8974_writeable_reg()
794 		return ak8974->variant == AK8974_WHOAMI_VALUE_AMI305 ||  in ak8974_writeable_reg()
795 		       ak8974->variant == AK8974_WHOAMI_VALUE_AMI306;  in ak8974_writeable_reg()
798 		return ak8974->variant == AK8974_WHOAMI_VALUE_AMI306;  in ak8974_writeable_reg()
820 	struct ak8974 *ak8974;  in ak8974_probe()  local
826 	indio_dev = devm_iio_device_alloc(&i2c->dev, sizeof(*ak8974));  in ak8974_probe()
830 	ak8974 = iio_priv(indio_dev);  in ak8974_probe()
832 	ak8974->i2c = i2c;  in ak8974_probe()
833 	mutex_init(&ak8974->lock);  in ak8974_probe()
835 	ret = iio_read_mount_matrix(&i2c->dev, &ak8974->orientation);  in ak8974_probe()
839 	ak8974->regs[0].supply = ak8974_reg_avdd;  in ak8974_probe()
840 	ak8974->regs[1].supply = ak8974_reg_dvdd;  in ak8974_probe()
843 				      ARRAY_SIZE(ak8974->regs),  in ak8974_probe()
844 				      ak8974->regs);  in ak8974_probe()
848 	ret = regulator_bulk_enable(ARRAY_SIZE(ak8974->regs), ak8974->regs);  in ak8974_probe()
859 	ak8974->map = devm_regmap_init_i2c(i2c, &ak8974_regmap_config);  in ak8974_probe()
860 	if (IS_ERR(ak8974->map)) {  in ak8974_probe()
864 		return PTR_ERR(ak8974->map);  in ak8974_probe()
867 	ret = ak8974_set_power(ak8974, AK8974_PWR_ON);  in ak8974_probe()
873 	ret = ak8974_detect(ak8974);  in ak8974_probe()
875 		dev_err(&i2c->dev, "neither AK8974 nor AMI30x found\n");  in ak8974_probe()
879 	ret = ak8974_selftest(ak8974);  in ak8974_probe()
883 	ret = ak8974_reset(ak8974);  in ak8974_probe()
885 		dev_err(&i2c->dev, "AK8974 reset failed\n");  in ak8974_probe()
889 	switch (ak8974->variant) {  in ak8974_probe()
907 	indio_dev->name = ak8974->name;  in ak8974_probe()
923 			ak8974->drdy_active_low = true;  in ak8974_probe()
936 						ak8974->name,  in ak8974_probe()
937 						ak8974);  in ak8974_probe()
943 		ak8974->drdy_irq = true;  in ak8974_probe()
965 	ak8974_set_power(ak8974, AK8974_PWR_OFF);  in ak8974_probe()
966 	regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);  in ak8974_probe()
974 	struct ak8974 *ak8974 = iio_priv(indio_dev);  in ak8974_remove()  local
981 	ak8974_set_power(ak8974, AK8974_PWR_OFF);  in ak8974_remove()
982 	regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);  in ak8974_remove()
987 	struct ak8974 *ak8974 =  in ak8974_runtime_suspend()  local
990 	ak8974_set_power(ak8974, AK8974_PWR_OFF);  in ak8974_runtime_suspend()
991 	regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);  in ak8974_runtime_suspend()
998 	struct ak8974 *ak8974 =  in ak8974_runtime_resume()  local
1002 	ret = regulator_bulk_enable(ARRAY_SIZE(ak8974->regs), ak8974->regs);  in ak8974_runtime_resume()
1006 	ret = ak8974_set_power(ak8974, AK8974_PWR_ON);  in ak8974_runtime_resume()
1010 	ret = ak8974_configure(ak8974);  in ak8974_runtime_resume()
1017 	ak8974_set_power(ak8974, AK8974_PWR_OFF);  in ak8974_runtime_resume()
1019 	regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);  in ak8974_runtime_resume()
1030 	{"ak8974", 0 },
1037 	{ .compatible = "asahi-kasei,ak8974", },
1045 		.name	= "ak8974",
1055 MODULE_DESCRIPTION("AK8974 and AMI30x 3-axis magnetometer driver");