ak8974.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959
  1. /*
  2. * Driver for the Asahi Kasei EMD Corporation AK8974
  3. * and Aichi Steel AMI305 magnetometer chips.
  4. * Based on a patch from Samu Onkalo and the AK8975 IIO driver.
  5. *
  6. * Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
  7. * Copyright (c) 2010 NVIDIA Corporation.
  8. * Copyright (C) 2016 Linaro Ltd.
  9. *
  10. * Author: Samu Onkalo <samu.p.onkalo@nokia.com>
  11. * Author: Linus Walleij <linus.walleij@linaro.org>
  12. */
  13. #include <linux/module.h>
  14. #include <linux/kernel.h>
  15. #include <linux/i2c.h>
  16. #include <linux/interrupt.h>
  17. #include <linux/irq.h> /* For irq_get_irq_data() */
  18. #include <linux/completion.h>
  19. #include <linux/err.h>
  20. #include <linux/mutex.h>
  21. #include <linux/delay.h>
  22. #include <linux/bitops.h>
  23. #include <linux/random.h>
  24. #include <linux/regmap.h>
  25. #include <linux/regulator/consumer.h>
  26. #include <linux/pm_runtime.h>
  27. #include <linux/iio/iio.h>
  28. #include <linux/iio/sysfs.h>
  29. #include <linux/iio/buffer.h>
  30. #include <linux/iio/trigger.h>
  31. #include <linux/iio/trigger_consumer.h>
  32. #include <linux/iio/triggered_buffer.h>
  33. /*
  34. * 16-bit registers are little-endian. LSB is at the address defined below
  35. * and MSB is at the next higher address.
  36. */
  37. /* These registers are common for AK8974 and AMI30x */
  38. #define AK8974_SELFTEST 0x0C
  39. #define AK8974_SELFTEST_IDLE 0x55
  40. #define AK8974_SELFTEST_OK 0xAA
  41. #define AK8974_INFO 0x0D
  42. #define AK8974_WHOAMI 0x0F
  43. #define AK8974_WHOAMI_VALUE_AMI306 0x46
  44. #define AK8974_WHOAMI_VALUE_AMI305 0x47
  45. #define AK8974_WHOAMI_VALUE_AK8974 0x48
  46. #define AK8974_DATA_X 0x10
  47. #define AK8974_DATA_Y 0x12
  48. #define AK8974_DATA_Z 0x14
  49. #define AK8974_INT_SRC 0x16
  50. #define AK8974_STATUS 0x18
  51. #define AK8974_INT_CLEAR 0x1A
  52. #define AK8974_CTRL1 0x1B
  53. #define AK8974_CTRL2 0x1C
  54. #define AK8974_CTRL3 0x1D
  55. #define AK8974_INT_CTRL 0x1E
  56. #define AK8974_INT_THRES 0x26 /* Absolute any axis value threshold */
  57. #define AK8974_PRESET 0x30
  58. /* AK8974-specific offsets */
  59. #define AK8974_OFFSET_X 0x20
  60. #define AK8974_OFFSET_Y 0x22
  61. #define AK8974_OFFSET_Z 0x24
  62. /* AMI305-specific offsets */
  63. #define AMI305_OFFSET_X 0x6C
  64. #define AMI305_OFFSET_Y 0x72
  65. #define AMI305_OFFSET_Z 0x78
  66. /* Different temperature registers */
  67. #define AK8974_TEMP 0x31
  68. #define AMI305_TEMP 0x60
  69. /* AMI306-specific control register */
  70. #define AMI306_CTRL4 0x5C
  71. /* AMI306 factory calibration data */
  72. /* fine axis sensitivity */
  73. #define AMI306_FINEOUTPUT_X 0x90
  74. #define AMI306_FINEOUTPUT_Y 0x92
  75. #define AMI306_FINEOUTPUT_Z 0x94
  76. /* axis sensitivity */
  77. #define AMI306_SENS_X 0x96
  78. #define AMI306_SENS_Y 0x98
  79. #define AMI306_SENS_Z 0x9A
  80. /* axis cross-interference */
  81. #define AMI306_GAIN_PARA_XZ 0x9C
  82. #define AMI306_GAIN_PARA_XY 0x9D
  83. #define AMI306_GAIN_PARA_YZ 0x9E
  84. #define AMI306_GAIN_PARA_YX 0x9F
  85. #define AMI306_GAIN_PARA_ZY 0xA0
  86. #define AMI306_GAIN_PARA_ZX 0xA1
  87. /* offset at ZERO magnetic field */
  88. #define AMI306_OFFZERO_X 0xF8
  89. #define AMI306_OFFZERO_Y 0xFA
  90. #define AMI306_OFFZERO_Z 0xFC
  91. #define AK8974_INT_X_HIGH BIT(7) /* Axis over +threshold */
  92. #define AK8974_INT_Y_HIGH BIT(6)
  93. #define AK8974_INT_Z_HIGH BIT(5)
  94. #define AK8974_INT_X_LOW BIT(4) /* Axis below -threshold */
  95. #define AK8974_INT_Y_LOW BIT(3)
  96. #define AK8974_INT_Z_LOW BIT(2)
  97. #define AK8974_INT_RANGE BIT(1) /* Range overflow (any axis) */
  98. #define AK8974_STATUS_DRDY BIT(6) /* Data ready */
  99. #define AK8974_STATUS_OVERRUN BIT(5) /* Data overrun */
  100. #define AK8974_STATUS_INT BIT(4) /* Interrupt occurred */
  101. #define AK8974_CTRL1_POWER BIT(7) /* 0 = standby; 1 = active */
  102. #define AK8974_CTRL1_RATE BIT(4) /* 0 = 10 Hz; 1 = 20 Hz */
  103. #define AK8974_CTRL1_FORCE_EN BIT(1) /* 0 = normal; 1 = force */
  104. #define AK8974_CTRL1_MODE2 BIT(0) /* 0 */
  105. #define AK8974_CTRL2_INT_EN BIT(4) /* 1 = enable interrupts */
  106. #define AK8974_CTRL2_DRDY_EN BIT(3) /* 1 = enable data ready signal */
  107. #define AK8974_CTRL2_DRDY_POL BIT(2) /* 1 = data ready active high */
  108. #define AK8974_CTRL2_RESDEF (AK8974_CTRL2_DRDY_POL)
  109. #define AK8974_CTRL3_RESET BIT(7) /* Software reset */
  110. #define AK8974_CTRL3_FORCE BIT(6) /* Start forced measurement */
  111. #define AK8974_CTRL3_SELFTEST BIT(4) /* Set selftest register */
  112. #define AK8974_CTRL3_RESDEF 0x00
  113. #define AK8974_INT_CTRL_XEN BIT(7) /* Enable interrupt for this axis */
  114. #define AK8974_INT_CTRL_YEN BIT(6)
  115. #define AK8974_INT_CTRL_ZEN BIT(5)
  116. #define AK8974_INT_CTRL_XYZEN (BIT(7)|BIT(6)|BIT(5))
  117. #define AK8974_INT_CTRL_POL BIT(3) /* 0 = active low; 1 = active high */
  118. #define AK8974_INT_CTRL_PULSE BIT(1) /* 0 = latched; 1 = pulse (50 usec) */
  119. #define AK8974_INT_CTRL_RESDEF (AK8974_INT_CTRL_XYZEN | AK8974_INT_CTRL_POL)
  120. /* The AMI305 has elaborate FW version and serial number registers */
  121. #define AMI305_VER 0xE8
  122. #define AMI305_SN 0xEA
  123. #define AK8974_MAX_RANGE 2048
  124. #define AK8974_POWERON_DELAY 50
  125. #define AK8974_ACTIVATE_DELAY 1
  126. #define AK8974_SELFTEST_DELAY 1
  127. /*
  128. * Set the autosuspend to two orders of magnitude larger than the poweron
  129. * delay to make sane reasonable power tradeoff savings (5 seconds in
  130. * this case).
  131. */
  132. #define AK8974_AUTOSUSPEND_DELAY 5000
  133. #define AK8974_MEASTIME 3
  134. #define AK8974_PWR_ON 1
  135. #define AK8974_PWR_OFF 0
  136. /**
  137. * struct ak8974 - state container for the AK8974 driver
  138. * @i2c: parent I2C client
  139. * @orientation: mounting matrix, flipped axis etc
  140. * @map: regmap to access the AK8974 registers over I2C
  141. * @regs: the avdd and dvdd power regulators
  142. * @name: the name of the part
  143. * @variant: the whoami ID value (for selecting code paths)
  144. * @lock: locks the magnetometer for exclusive use during a measurement
  145. * @drdy_irq: uses the DRDY IRQ line
  146. * @drdy_complete: completion for DRDY
  147. * @drdy_active_low: the DRDY IRQ is active low
  148. */
  149. struct ak8974 {
  150. struct i2c_client *i2c;
  151. struct iio_mount_matrix orientation;
  152. struct regmap *map;
  153. struct regulator_bulk_data regs[2];
  154. const char *name;
  155. u8 variant;
  156. struct mutex lock;
  157. bool drdy_irq;
  158. struct completion drdy_complete;
  159. bool drdy_active_low;
  160. /* Ensure timestamp is naturally aligned */
  161. struct {
  162. __le16 channels[3];
  163. s64 ts __aligned(8);
  164. } scan;
  165. };
  166. static const char ak8974_reg_avdd[] = "avdd";
  167. static const char ak8974_reg_dvdd[] = "dvdd";
  168. static int ak8974_get_u16_val(struct ak8974 *ak8974, u8 reg, u16 *val)
  169. {
  170. int ret;
  171. __le16 bulk;
  172. ret = regmap_bulk_read(ak8974->map, reg, &bulk, 2);
  173. if (ret)
  174. return ret;
  175. *val = le16_to_cpu(bulk);
  176. return 0;
  177. }
  178. static int ak8974_set_u16_val(struct ak8974 *ak8974, u8 reg, u16 val)
  179. {
  180. __le16 bulk = cpu_to_le16(val);
  181. return regmap_bulk_write(ak8974->map, reg, &bulk, 2);
  182. }
  183. static int ak8974_set_power(struct ak8974 *ak8974, bool mode)
  184. {
  185. int ret;
  186. u8 val;
  187. val = mode ? AK8974_CTRL1_POWER : 0;
  188. val |= AK8974_CTRL1_FORCE_EN;
  189. ret = regmap_write(ak8974->map, AK8974_CTRL1, val);
  190. if (ret < 0)
  191. return ret;
  192. if (mode)
  193. msleep(AK8974_ACTIVATE_DELAY);
  194. return 0;
  195. }
  196. static int ak8974_reset(struct ak8974 *ak8974)
  197. {
  198. int ret;
  199. /* Power on to get register access. Sets CTRL1 reg to reset state */
  200. ret = ak8974_set_power(ak8974, AK8974_PWR_ON);
  201. if (ret)
  202. return ret;
  203. ret = regmap_write(ak8974->map, AK8974_CTRL2, AK8974_CTRL2_RESDEF);
  204. if (ret)
  205. return ret;
  206. ret = regmap_write(ak8974->map, AK8974_CTRL3, AK8974_CTRL3_RESDEF);
  207. if (ret)
  208. return ret;
  209. ret = regmap_write(ak8974->map, AK8974_INT_CTRL,
  210. AK8974_INT_CTRL_RESDEF);
  211. if (ret)
  212. return ret;
  213. /* After reset, power off is default state */
  214. return ak8974_set_power(ak8974, AK8974_PWR_OFF);
  215. }
  216. static int ak8974_configure(struct ak8974 *ak8974)
  217. {
  218. int ret;
  219. ret = regmap_write(ak8974->map, AK8974_CTRL2, AK8974_CTRL2_DRDY_EN |
  220. AK8974_CTRL2_INT_EN);
  221. if (ret)
  222. return ret;
  223. ret = regmap_write(ak8974->map, AK8974_CTRL3, 0);
  224. if (ret)
  225. return ret;
  226. if (ak8974->variant == AK8974_WHOAMI_VALUE_AMI306) {
  227. /* magic from datasheet: set high-speed measurement mode */
  228. ret = ak8974_set_u16_val(ak8974, AMI306_CTRL4, 0xA07E);
  229. if (ret)
  230. return ret;
  231. }
  232. ret = regmap_write(ak8974->map, AK8974_INT_CTRL, AK8974_INT_CTRL_POL);
  233. if (ret)
  234. return ret;
  235. return regmap_write(ak8974->map, AK8974_PRESET, 0);
  236. }
  237. static int ak8974_trigmeas(struct ak8974 *ak8974)
  238. {
  239. unsigned int clear;
  240. u8 mask;
  241. u8 val;
  242. int ret;
  243. /* Clear any previous measurement overflow status */
  244. ret = regmap_read(ak8974->map, AK8974_INT_CLEAR, &clear);
  245. if (ret)
  246. return ret;
  247. /* If we have a DRDY IRQ line, use it */
  248. if (ak8974->drdy_irq) {
  249. mask = AK8974_CTRL2_INT_EN |
  250. AK8974_CTRL2_DRDY_EN |
  251. AK8974_CTRL2_DRDY_POL;
  252. val = AK8974_CTRL2_DRDY_EN;
  253. if (!ak8974->drdy_active_low)
  254. val |= AK8974_CTRL2_DRDY_POL;
  255. init_completion(&ak8974->drdy_complete);
  256. ret = regmap_update_bits(ak8974->map, AK8974_CTRL2,
  257. mask, val);
  258. if (ret)
  259. return ret;
  260. }
  261. /* Force a measurement */
  262. return regmap_update_bits(ak8974->map,
  263. AK8974_CTRL3,
  264. AK8974_CTRL3_FORCE,
  265. AK8974_CTRL3_FORCE);
  266. }
  267. static int ak8974_await_drdy(struct ak8974 *ak8974)
  268. {
  269. int timeout = 2;
  270. unsigned int val;
  271. int ret;
  272. if (ak8974->drdy_irq) {
  273. ret = wait_for_completion_timeout(&ak8974->drdy_complete,
  274. 1 + msecs_to_jiffies(1000));
  275. if (!ret) {
  276. dev_err(&ak8974->i2c->dev,
  277. "timeout waiting for DRDY IRQ\n");
  278. return -ETIMEDOUT;
  279. }
  280. return 0;
  281. }
  282. /* Default delay-based poll loop */
  283. do {
  284. msleep(AK8974_MEASTIME);
  285. ret = regmap_read(ak8974->map, AK8974_STATUS, &val);
  286. if (ret < 0)
  287. return ret;
  288. if (val & AK8974_STATUS_DRDY)
  289. return 0;
  290. } while (--timeout);
  291. dev_err(&ak8974->i2c->dev, "timeout waiting for DRDY\n");
  292. return -ETIMEDOUT;
  293. }
  294. static int ak8974_getresult(struct ak8974 *ak8974, __le16 *result)
  295. {
  296. unsigned int src;
  297. int ret;
  298. ret = ak8974_await_drdy(ak8974);
  299. if (ret)
  300. return ret;
  301. ret = regmap_read(ak8974->map, AK8974_INT_SRC, &src);
  302. if (ret < 0)
  303. return ret;
  304. /* Out of range overflow! Strong magnet close? */
  305. if (src & AK8974_INT_RANGE) {
  306. dev_err(&ak8974->i2c->dev,
  307. "range overflow in sensor\n");
  308. return -ERANGE;
  309. }
  310. ret = regmap_bulk_read(ak8974->map, AK8974_DATA_X, result, 6);
  311. if (ret)
  312. return ret;
  313. return ret;
  314. }
  315. static irqreturn_t ak8974_drdy_irq(int irq, void *d)
  316. {
  317. struct ak8974 *ak8974 = d;
  318. if (!ak8974->drdy_irq)
  319. return IRQ_NONE;
  320. /* TODO: timestamp here to get good measurement stamps */
  321. return IRQ_WAKE_THREAD;
  322. }
  323. static irqreturn_t ak8974_drdy_irq_thread(int irq, void *d)
  324. {
  325. struct ak8974 *ak8974 = d;
  326. unsigned int val;
  327. int ret;
  328. /* Check if this was a DRDY from us */
  329. ret = regmap_read(ak8974->map, AK8974_STATUS, &val);
  330. if (ret < 0) {
  331. dev_err(&ak8974->i2c->dev, "error reading DRDY status\n");
  332. return IRQ_HANDLED;
  333. }
  334. if (val & AK8974_STATUS_DRDY) {
  335. /* Yes this was our IRQ */
  336. complete(&ak8974->drdy_complete);
  337. return IRQ_HANDLED;
  338. }
  339. /* We may be on a shared IRQ, let the next client check */
  340. return IRQ_NONE;
  341. }
  342. static int ak8974_selftest(struct ak8974 *ak8974)
  343. {
  344. struct device *dev = &ak8974->i2c->dev;
  345. unsigned int val;
  346. int ret;
  347. ret = regmap_read(ak8974->map, AK8974_SELFTEST, &val);
  348. if (ret)
  349. return ret;
  350. if (val != AK8974_SELFTEST_IDLE) {
  351. dev_err(dev, "selftest not idle before test\n");
  352. return -EIO;
  353. }
  354. /* Trigger self-test */
  355. ret = regmap_update_bits(ak8974->map,
  356. AK8974_CTRL3,
  357. AK8974_CTRL3_SELFTEST,
  358. AK8974_CTRL3_SELFTEST);
  359. if (ret) {
  360. dev_err(dev, "could not write CTRL3\n");
  361. return ret;
  362. }
  363. msleep(AK8974_SELFTEST_DELAY);
  364. ret = regmap_read(ak8974->map, AK8974_SELFTEST, &val);
  365. if (ret)
  366. return ret;
  367. if (val != AK8974_SELFTEST_OK) {
  368. dev_err(dev, "selftest result NOT OK (%02x)\n", val);
  369. return -EIO;
  370. }
  371. ret = regmap_read(ak8974->map, AK8974_SELFTEST, &val);
  372. if (ret)
  373. return ret;
  374. if (val != AK8974_SELFTEST_IDLE) {
  375. dev_err(dev, "selftest not idle after test (%02x)\n", val);
  376. return -EIO;
  377. }
  378. dev_dbg(dev, "passed self-test\n");
  379. return 0;
  380. }
  381. static void ak8974_read_calib_data(struct ak8974 *ak8974, unsigned int reg,
  382. __le16 *tab, size_t tab_size)
  383. {
  384. int ret = regmap_bulk_read(ak8974->map, reg, tab, tab_size);
  385. if (ret) {
  386. memset(tab, 0xFF, tab_size);
  387. dev_warn(&ak8974->i2c->dev,
  388. "can't read calibration data (regs %u..%zu): %d\n",
  389. reg, reg + tab_size - 1, ret);
  390. } else {
  391. add_device_randomness(tab, tab_size);
  392. }
  393. }
  394. static int ak8974_detect(struct ak8974 *ak8974)
  395. {
  396. unsigned int whoami;
  397. const char *name;
  398. int ret;
  399. unsigned int fw;
  400. u16 sn;
  401. ret = regmap_read(ak8974->map, AK8974_WHOAMI, &whoami);
  402. if (ret)
  403. return ret;
  404. name = "ami305";
  405. switch (whoami) {
  406. case AK8974_WHOAMI_VALUE_AMI306:
  407. name = "ami306";
  408. /* fall-through */
  409. case AK8974_WHOAMI_VALUE_AMI305:
  410. ret = regmap_read(ak8974->map, AMI305_VER, &fw);
  411. if (ret)
  412. return ret;
  413. fw &= 0x7f; /* only bits 0 thru 6 valid */
  414. ret = ak8974_get_u16_val(ak8974, AMI305_SN, &sn);
  415. if (ret)
  416. return ret;
  417. add_device_randomness(&sn, sizeof(sn));
  418. dev_info(&ak8974->i2c->dev,
  419. "detected %s, FW ver %02x, S/N: %04x\n",
  420. name, fw, sn);
  421. break;
  422. case AK8974_WHOAMI_VALUE_AK8974:
  423. name = "ak8974";
  424. dev_info(&ak8974->i2c->dev, "detected AK8974\n");
  425. break;
  426. default:
  427. dev_err(&ak8974->i2c->dev, "unsupported device (%02x) ",
  428. whoami);
  429. return -ENODEV;
  430. }
  431. ak8974->name = name;
  432. ak8974->variant = whoami;
  433. if (whoami == AK8974_WHOAMI_VALUE_AMI306) {
  434. __le16 fab_data1[9], fab_data2[3];
  435. int i;
  436. ak8974_read_calib_data(ak8974, AMI306_FINEOUTPUT_X,
  437. fab_data1, sizeof(fab_data1));
  438. ak8974_read_calib_data(ak8974, AMI306_OFFZERO_X,
  439. fab_data2, sizeof(fab_data2));
  440. for (i = 0; i < 3; ++i) {
  441. static const char axis[3] = "XYZ";
  442. static const char pgaxis[6] = "ZYZXYX";
  443. unsigned offz = le16_to_cpu(fab_data2[i]) & 0x7F;
  444. unsigned fine = le16_to_cpu(fab_data1[i]);
  445. unsigned sens = le16_to_cpu(fab_data1[i + 3]);
  446. unsigned pgain1 = le16_to_cpu(fab_data1[i + 6]);
  447. unsigned pgain2 = pgain1 >> 8;
  448. pgain1 &= 0xFF;
  449. dev_info(&ak8974->i2c->dev,
  450. "factory calibration for axis %c: offz=%u sens=%u fine=%u pga%c=%u pga%c=%u\n",
  451. axis[i], offz, sens, fine, pgaxis[i * 2],
  452. pgain1, pgaxis[i * 2 + 1], pgain2);
  453. }
  454. }
  455. return 0;
  456. }
  457. static int ak8974_read_raw(struct iio_dev *indio_dev,
  458. struct iio_chan_spec const *chan,
  459. int *val, int *val2,
  460. long mask)
  461. {
  462. struct ak8974 *ak8974 = iio_priv(indio_dev);
  463. __le16 hw_values[3];
  464. int ret = -EINVAL;
  465. pm_runtime_get_sync(&ak8974->i2c->dev);
  466. mutex_lock(&ak8974->lock);
  467. switch (mask) {
  468. case IIO_CHAN_INFO_RAW:
  469. if (chan->address > 2) {
  470. dev_err(&ak8974->i2c->dev, "faulty channel address\n");
  471. ret = -EIO;
  472. goto out_unlock;
  473. }
  474. ret = ak8974_trigmeas(ak8974);
  475. if (ret)
  476. goto out_unlock;
  477. ret = ak8974_getresult(ak8974, hw_values);
  478. if (ret)
  479. goto out_unlock;
  480. /*
  481. * We read all axes and discard all but one, for optimized
  482. * reading, use the triggered buffer.
  483. */
  484. *val = (s16)le16_to_cpu(hw_values[chan->address]);
  485. ret = IIO_VAL_INT;
  486. }
  487. out_unlock:
  488. mutex_unlock(&ak8974->lock);
  489. pm_runtime_mark_last_busy(&ak8974->i2c->dev);
  490. pm_runtime_put_autosuspend(&ak8974->i2c->dev);
  491. return ret;
  492. }
  493. static void ak8974_fill_buffer(struct iio_dev *indio_dev)
  494. {
  495. struct ak8974 *ak8974 = iio_priv(indio_dev);
  496. int ret;
  497. pm_runtime_get_sync(&ak8974->i2c->dev);
  498. mutex_lock(&ak8974->lock);
  499. ret = ak8974_trigmeas(ak8974);
  500. if (ret) {
  501. dev_err(&ak8974->i2c->dev, "error triggering measure\n");
  502. goto out_unlock;
  503. }
  504. ret = ak8974_getresult(ak8974, ak8974->scan.channels);
  505. if (ret) {
  506. dev_err(&ak8974->i2c->dev, "error getting measures\n");
  507. goto out_unlock;
  508. }
  509. iio_push_to_buffers_with_timestamp(indio_dev, &ak8974->scan,
  510. iio_get_time_ns(indio_dev));
  511. out_unlock:
  512. mutex_unlock(&ak8974->lock);
  513. pm_runtime_mark_last_busy(&ak8974->i2c->dev);
  514. pm_runtime_put_autosuspend(&ak8974->i2c->dev);
  515. }
  516. static irqreturn_t ak8974_handle_trigger(int irq, void *p)
  517. {
  518. const struct iio_poll_func *pf = p;
  519. struct iio_dev *indio_dev = pf->indio_dev;
  520. ak8974_fill_buffer(indio_dev);
  521. iio_trigger_notify_done(indio_dev->trig);
  522. return IRQ_HANDLED;
  523. }
  524. static const struct iio_mount_matrix *
  525. ak8974_get_mount_matrix(const struct iio_dev *indio_dev,
  526. const struct iio_chan_spec *chan)
  527. {
  528. struct ak8974 *ak8974 = iio_priv(indio_dev);
  529. return &ak8974->orientation;
  530. }
  531. static const struct iio_chan_spec_ext_info ak8974_ext_info[] = {
  532. IIO_MOUNT_MATRIX(IIO_SHARED_BY_DIR, ak8974_get_mount_matrix),
  533. { },
  534. };
  535. #define AK8974_AXIS_CHANNEL(axis, index) \
  536. { \
  537. .type = IIO_MAGN, \
  538. .modified = 1, \
  539. .channel2 = IIO_MOD_##axis, \
  540. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW), \
  541. .ext_info = ak8974_ext_info, \
  542. .address = index, \
  543. .scan_index = index, \
  544. .scan_type = { \
  545. .sign = 's', \
  546. .realbits = 16, \
  547. .storagebits = 16, \
  548. .endianness = IIO_LE \
  549. }, \
  550. }
  551. static const struct iio_chan_spec ak8974_channels[] = {
  552. AK8974_AXIS_CHANNEL(X, 0),
  553. AK8974_AXIS_CHANNEL(Y, 1),
  554. AK8974_AXIS_CHANNEL(Z, 2),
  555. IIO_CHAN_SOFT_TIMESTAMP(3),
  556. };
  557. static const unsigned long ak8974_scan_masks[] = { 0x7, 0 };
  558. static const struct iio_info ak8974_info = {
  559. .read_raw = &ak8974_read_raw,
  560. };
  561. static bool ak8974_writeable_reg(struct device *dev, unsigned int reg)
  562. {
  563. struct i2c_client *i2c = to_i2c_client(dev);
  564. struct iio_dev *indio_dev = i2c_get_clientdata(i2c);
  565. struct ak8974 *ak8974 = iio_priv(indio_dev);
  566. switch (reg) {
  567. case AK8974_CTRL1:
  568. case AK8974_CTRL2:
  569. case AK8974_CTRL3:
  570. case AK8974_INT_CTRL:
  571. case AK8974_INT_THRES:
  572. case AK8974_INT_THRES + 1:
  573. case AK8974_PRESET:
  574. case AK8974_PRESET + 1:
  575. return true;
  576. case AK8974_OFFSET_X:
  577. case AK8974_OFFSET_X + 1:
  578. case AK8974_OFFSET_Y:
  579. case AK8974_OFFSET_Y + 1:
  580. case AK8974_OFFSET_Z:
  581. case AK8974_OFFSET_Z + 1:
  582. if (ak8974->variant == AK8974_WHOAMI_VALUE_AK8974)
  583. return true;
  584. return false;
  585. case AMI305_OFFSET_X:
  586. case AMI305_OFFSET_X + 1:
  587. case AMI305_OFFSET_Y:
  588. case AMI305_OFFSET_Y + 1:
  589. case AMI305_OFFSET_Z:
  590. case AMI305_OFFSET_Z + 1:
  591. return ak8974->variant == AK8974_WHOAMI_VALUE_AMI305 ||
  592. ak8974->variant == AK8974_WHOAMI_VALUE_AMI306;
  593. case AMI306_CTRL4:
  594. case AMI306_CTRL4 + 1:
  595. return ak8974->variant == AK8974_WHOAMI_VALUE_AMI306;
  596. default:
  597. return false;
  598. }
  599. }
  600. static bool ak8974_precious_reg(struct device *dev, unsigned int reg)
  601. {
  602. return reg == AK8974_INT_CLEAR;
  603. }
  604. static const struct regmap_config ak8974_regmap_config = {
  605. .reg_bits = 8,
  606. .val_bits = 8,
  607. .max_register = 0xff,
  608. .writeable_reg = ak8974_writeable_reg,
  609. .precious_reg = ak8974_precious_reg,
  610. };
  611. static int ak8974_probe(struct i2c_client *i2c,
  612. const struct i2c_device_id *id)
  613. {
  614. struct iio_dev *indio_dev;
  615. struct ak8974 *ak8974;
  616. unsigned long irq_trig;
  617. int irq = i2c->irq;
  618. int ret;
  619. /* Register with IIO */
  620. indio_dev = devm_iio_device_alloc(&i2c->dev, sizeof(*ak8974));
  621. if (indio_dev == NULL)
  622. return -ENOMEM;
  623. ak8974 = iio_priv(indio_dev);
  624. i2c_set_clientdata(i2c, indio_dev);
  625. ak8974->i2c = i2c;
  626. mutex_init(&ak8974->lock);
  627. ret = of_iio_read_mount_matrix(&i2c->dev,
  628. "mount-matrix",
  629. &ak8974->orientation);
  630. if (ret)
  631. return ret;
  632. ak8974->regs[0].supply = ak8974_reg_avdd;
  633. ak8974->regs[1].supply = ak8974_reg_dvdd;
  634. ret = devm_regulator_bulk_get(&i2c->dev,
  635. ARRAY_SIZE(ak8974->regs),
  636. ak8974->regs);
  637. if (ret < 0) {
  638. dev_err(&i2c->dev, "cannot get regulators\n");
  639. return ret;
  640. }
  641. ret = regulator_bulk_enable(ARRAY_SIZE(ak8974->regs), ak8974->regs);
  642. if (ret < 0) {
  643. dev_err(&i2c->dev, "cannot enable regulators\n");
  644. return ret;
  645. }
  646. /* Take runtime PM online */
  647. pm_runtime_get_noresume(&i2c->dev);
  648. pm_runtime_set_active(&i2c->dev);
  649. pm_runtime_enable(&i2c->dev);
  650. ak8974->map = devm_regmap_init_i2c(i2c, &ak8974_regmap_config);
  651. if (IS_ERR(ak8974->map)) {
  652. dev_err(&i2c->dev, "failed to allocate register map\n");
  653. pm_runtime_put_noidle(&i2c->dev);
  654. pm_runtime_disable(&i2c->dev);
  655. return PTR_ERR(ak8974->map);
  656. }
  657. ret = ak8974_set_power(ak8974, AK8974_PWR_ON);
  658. if (ret) {
  659. dev_err(&i2c->dev, "could not power on\n");
  660. goto disable_pm;
  661. }
  662. ret = ak8974_detect(ak8974);
  663. if (ret) {
  664. dev_err(&i2c->dev, "neither AK8974 nor AMI30x found\n");
  665. goto disable_pm;
  666. }
  667. ret = ak8974_selftest(ak8974);
  668. if (ret)
  669. dev_err(&i2c->dev, "selftest failed (continuing anyway)\n");
  670. ret = ak8974_reset(ak8974);
  671. if (ret) {
  672. dev_err(&i2c->dev, "AK8974 reset failed\n");
  673. goto disable_pm;
  674. }
  675. indio_dev->dev.parent = &i2c->dev;
  676. indio_dev->channels = ak8974_channels;
  677. indio_dev->num_channels = ARRAY_SIZE(ak8974_channels);
  678. indio_dev->info = &ak8974_info;
  679. indio_dev->available_scan_masks = ak8974_scan_masks;
  680. indio_dev->modes = INDIO_DIRECT_MODE;
  681. indio_dev->name = ak8974->name;
  682. ret = iio_triggered_buffer_setup(indio_dev, NULL,
  683. ak8974_handle_trigger,
  684. NULL);
  685. if (ret) {
  686. dev_err(&i2c->dev, "triggered buffer setup failed\n");
  687. goto disable_pm;
  688. }
  689. /* If we have a valid DRDY IRQ, make use of it */
  690. if (irq > 0) {
  691. irq_trig = irqd_get_trigger_type(irq_get_irq_data(irq));
  692. if (irq_trig == IRQF_TRIGGER_RISING) {
  693. dev_info(&i2c->dev, "enable rising edge DRDY IRQ\n");
  694. } else if (irq_trig == IRQF_TRIGGER_FALLING) {
  695. ak8974->drdy_active_low = true;
  696. dev_info(&i2c->dev, "enable falling edge DRDY IRQ\n");
  697. } else {
  698. irq_trig = IRQF_TRIGGER_RISING;
  699. }
  700. irq_trig |= IRQF_ONESHOT;
  701. irq_trig |= IRQF_SHARED;
  702. ret = devm_request_threaded_irq(&i2c->dev,
  703. irq,
  704. ak8974_drdy_irq,
  705. ak8974_drdy_irq_thread,
  706. irq_trig,
  707. ak8974->name,
  708. ak8974);
  709. if (ret) {
  710. dev_err(&i2c->dev, "unable to request DRDY IRQ "
  711. "- proceeding without IRQ\n");
  712. goto no_irq;
  713. }
  714. ak8974->drdy_irq = true;
  715. }
  716. no_irq:
  717. ret = iio_device_register(indio_dev);
  718. if (ret) {
  719. dev_err(&i2c->dev, "device register failed\n");
  720. goto cleanup_buffer;
  721. }
  722. pm_runtime_set_autosuspend_delay(&i2c->dev,
  723. AK8974_AUTOSUSPEND_DELAY);
  724. pm_runtime_use_autosuspend(&i2c->dev);
  725. pm_runtime_put(&i2c->dev);
  726. return 0;
  727. cleanup_buffer:
  728. iio_triggered_buffer_cleanup(indio_dev);
  729. disable_pm:
  730. pm_runtime_put_noidle(&i2c->dev);
  731. pm_runtime_disable(&i2c->dev);
  732. ak8974_set_power(ak8974, AK8974_PWR_OFF);
  733. regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);
  734. return ret;
  735. }
  736. static int ak8974_remove(struct i2c_client *i2c)
  737. {
  738. struct iio_dev *indio_dev = i2c_get_clientdata(i2c);
  739. struct ak8974 *ak8974 = iio_priv(indio_dev);
  740. iio_device_unregister(indio_dev);
  741. iio_triggered_buffer_cleanup(indio_dev);
  742. pm_runtime_get_sync(&i2c->dev);
  743. pm_runtime_put_noidle(&i2c->dev);
  744. pm_runtime_disable(&i2c->dev);
  745. ak8974_set_power(ak8974, AK8974_PWR_OFF);
  746. regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);
  747. return 0;
  748. }
  749. static int __maybe_unused ak8974_runtime_suspend(struct device *dev)
  750. {
  751. struct ak8974 *ak8974 =
  752. iio_priv(i2c_get_clientdata(to_i2c_client(dev)));
  753. ak8974_set_power(ak8974, AK8974_PWR_OFF);
  754. regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);
  755. return 0;
  756. }
  757. static int __maybe_unused ak8974_runtime_resume(struct device *dev)
  758. {
  759. struct ak8974 *ak8974 =
  760. iio_priv(i2c_get_clientdata(to_i2c_client(dev)));
  761. int ret;
  762. ret = regulator_bulk_enable(ARRAY_SIZE(ak8974->regs), ak8974->regs);
  763. if (ret)
  764. return ret;
  765. msleep(AK8974_POWERON_DELAY);
  766. ret = ak8974_set_power(ak8974, AK8974_PWR_ON);
  767. if (ret)
  768. goto out_regulator_disable;
  769. ret = ak8974_configure(ak8974);
  770. if (ret)
  771. goto out_disable_power;
  772. return 0;
  773. out_disable_power:
  774. ak8974_set_power(ak8974, AK8974_PWR_OFF);
  775. out_regulator_disable:
  776. regulator_bulk_disable(ARRAY_SIZE(ak8974->regs), ak8974->regs);
  777. return ret;
  778. }
  779. static const struct dev_pm_ops ak8974_dev_pm_ops = {
  780. SET_SYSTEM_SLEEP_PM_OPS(pm_runtime_force_suspend,
  781. pm_runtime_force_resume)
  782. SET_RUNTIME_PM_OPS(ak8974_runtime_suspend,
  783. ak8974_runtime_resume, NULL)
  784. };
  785. static const struct i2c_device_id ak8974_id[] = {
  786. {"ami305", 0 },
  787. {"ami306", 0 },
  788. {"ak8974", 0 },
  789. {}
  790. };
  791. MODULE_DEVICE_TABLE(i2c, ak8974_id);
  792. static const struct of_device_id ak8974_of_match[] = {
  793. { .compatible = "asahi-kasei,ak8974", },
  794. {}
  795. };
  796. MODULE_DEVICE_TABLE(of, ak8974_of_match);
  797. static struct i2c_driver ak8974_driver = {
  798. .driver = {
  799. .name = "ak8974",
  800. .pm = &ak8974_dev_pm_ops,
  801. .of_match_table = of_match_ptr(ak8974_of_match),
  802. },
  803. .probe = ak8974_probe,
  804. .remove = ak8974_remove,
  805. .id_table = ak8974_id,
  806. };
  807. module_i2c_driver(ak8974_driver);
  808. MODULE_DESCRIPTION("AK8974 and AMI30x 3-axis magnetometer driver");
  809. MODULE_AUTHOR("Samu Onkalo");
  810. MODULE_AUTHOR("Linus Walleij");
  811. MODULE_LICENSE("GPL v2");