adxrs450.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494
  1. /*
  2. * ADXRS450/ADXRS453 Digital Output Gyroscope Driver
  3. *
  4. * Copyright 2011 Analog Devices Inc.
  5. *
  6. * Licensed under the GPL-2.
  7. */
  8. #include <linux/interrupt.h>
  9. #include <linux/irq.h>
  10. #include <linux/delay.h>
  11. #include <linux/mutex.h>
  12. #include <linux/device.h>
  13. #include <linux/kernel.h>
  14. #include <linux/spi/spi.h>
  15. #include <linux/slab.h>
  16. #include <linux/sysfs.h>
  17. #include <linux/list.h>
  18. #include <linux/module.h>
  19. #include <linux/iio/iio.h>
  20. #include <linux/iio/sysfs.h>
  21. #define ADXRS450_STARTUP_DELAY 50 /* ms */
  22. /* The MSB for the spi commands */
  23. #define ADXRS450_SENSOR_DATA (0x20 << 24)
  24. #define ADXRS450_WRITE_DATA (0x40 << 24)
  25. #define ADXRS450_READ_DATA (0x80 << 24)
  26. #define ADXRS450_RATE1 0x00 /* Rate Registers */
  27. #define ADXRS450_TEMP1 0x02 /* Temperature Registers */
  28. #define ADXRS450_LOCST1 0x04 /* Low CST Memory Registers */
  29. #define ADXRS450_HICST1 0x06 /* High CST Memory Registers */
  30. #define ADXRS450_QUAD1 0x08 /* Quad Memory Registers */
  31. #define ADXRS450_FAULT1 0x0A /* Fault Registers */
  32. #define ADXRS450_PID1 0x0C /* Part ID Register 1 */
  33. #define ADXRS450_SNH 0x0E /* Serial Number Registers, 4 bytes */
  34. #define ADXRS450_SNL 0x10
  35. #define ADXRS450_DNC1 0x12 /* Dynamic Null Correction Registers */
  36. /* Check bits */
  37. #define ADXRS450_P 0x01
  38. #define ADXRS450_CHK 0x02
  39. #define ADXRS450_CST 0x04
  40. #define ADXRS450_PWR 0x08
  41. #define ADXRS450_POR 0x10
  42. #define ADXRS450_NVM 0x20
  43. #define ADXRS450_Q 0x40
  44. #define ADXRS450_PLL 0x80
  45. #define ADXRS450_UV 0x100
  46. #define ADXRS450_OV 0x200
  47. #define ADXRS450_AMP 0x400
  48. #define ADXRS450_FAIL 0x800
  49. #define ADXRS450_WRERR_MASK (0x7 << 29)
  50. #define ADXRS450_MAX_RX 4
  51. #define ADXRS450_MAX_TX 4
  52. #define ADXRS450_GET_ST(a) ((a >> 26) & 0x3)
  53. enum {
  54. ID_ADXRS450,
  55. ID_ADXRS453,
  56. };
  57. /**
  58. * struct adxrs450_state - device instance specific data
  59. * @us: actual spi_device
  60. * @buf_lock: mutex to protect tx and rx
  61. * @tx: transmit buffer
  62. * @rx: receive buffer
  63. **/
  64. struct adxrs450_state {
  65. struct spi_device *us;
  66. struct mutex buf_lock;
  67. __be32 tx ____cacheline_aligned;
  68. __be32 rx;
  69. };
  70. /**
  71. * adxrs450_spi_read_reg_16() - read 2 bytes from a register pair
  72. * @indio_dev: device associated with child of actual iio_dev
  73. * @reg_address: the address of the lower of the two registers, which should be
  74. * an even address, the second register's address is reg_address + 1.
  75. * @val: somewhere to pass back the value read
  76. **/
  77. static int adxrs450_spi_read_reg_16(struct iio_dev *indio_dev,
  78. u8 reg_address,
  79. u16 *val)
  80. {
  81. struct spi_message msg;
  82. struct adxrs450_state *st = iio_priv(indio_dev);
  83. u32 tx;
  84. int ret;
  85. struct spi_transfer xfers[] = {
  86. {
  87. .tx_buf = &st->tx,
  88. .bits_per_word = 8,
  89. .len = sizeof(st->tx),
  90. .cs_change = 1,
  91. }, {
  92. .rx_buf = &st->rx,
  93. .bits_per_word = 8,
  94. .len = sizeof(st->rx),
  95. },
  96. };
  97. mutex_lock(&st->buf_lock);
  98. tx = ADXRS450_READ_DATA | (reg_address << 17);
  99. if (!(hweight32(tx) & 1))
  100. tx |= ADXRS450_P;
  101. st->tx = cpu_to_be32(tx);
  102. spi_message_init(&msg);
  103. spi_message_add_tail(&xfers[0], &msg);
  104. spi_message_add_tail(&xfers[1], &msg);
  105. ret = spi_sync(st->us, &msg);
  106. if (ret) {
  107. dev_err(&st->us->dev, "problem while reading 16 bit register 0x%02x\n",
  108. reg_address);
  109. goto error_ret;
  110. }
  111. *val = (be32_to_cpu(st->rx) >> 5) & 0xFFFF;
  112. error_ret:
  113. mutex_unlock(&st->buf_lock);
  114. return ret;
  115. }
  116. /**
  117. * adxrs450_spi_write_reg_16() - write 2 bytes data to a register pair
  118. * @indio_dev: device associated with child of actual actual iio_dev
  119. * @reg_address: the address of the lower of the two registers,which should be
  120. * an even address, the second register's address is reg_address + 1.
  121. * @val: value to be written.
  122. **/
  123. static int adxrs450_spi_write_reg_16(struct iio_dev *indio_dev,
  124. u8 reg_address,
  125. u16 val)
  126. {
  127. struct adxrs450_state *st = iio_priv(indio_dev);
  128. u32 tx;
  129. int ret;
  130. mutex_lock(&st->buf_lock);
  131. tx = ADXRS450_WRITE_DATA | (reg_address << 17) | (val << 1);
  132. if (!(hweight32(tx) & 1))
  133. tx |= ADXRS450_P;
  134. st->tx = cpu_to_be32(tx);
  135. ret = spi_write(st->us, &st->tx, sizeof(st->tx));
  136. if (ret)
  137. dev_err(&st->us->dev, "problem while writing 16 bit register 0x%02x\n",
  138. reg_address);
  139. usleep_range(100, 1000); /* enforce sequential transfer delay 0.1ms */
  140. mutex_unlock(&st->buf_lock);
  141. return ret;
  142. }
  143. /**
  144. * adxrs450_spi_sensor_data() - read 2 bytes sensor data
  145. * @indio_dev: device associated with child of actual iio_dev
  146. * @val: somewhere to pass back the value read
  147. **/
  148. static int adxrs450_spi_sensor_data(struct iio_dev *indio_dev, s16 *val)
  149. {
  150. struct spi_message msg;
  151. struct adxrs450_state *st = iio_priv(indio_dev);
  152. int ret;
  153. struct spi_transfer xfers[] = {
  154. {
  155. .tx_buf = &st->tx,
  156. .bits_per_word = 8,
  157. .len = sizeof(st->tx),
  158. .cs_change = 1,
  159. }, {
  160. .rx_buf = &st->rx,
  161. .bits_per_word = 8,
  162. .len = sizeof(st->rx),
  163. },
  164. };
  165. mutex_lock(&st->buf_lock);
  166. st->tx = cpu_to_be32(ADXRS450_SENSOR_DATA);
  167. spi_message_init(&msg);
  168. spi_message_add_tail(&xfers[0], &msg);
  169. spi_message_add_tail(&xfers[1], &msg);
  170. ret = spi_sync(st->us, &msg);
  171. if (ret) {
  172. dev_err(&st->us->dev, "Problem while reading sensor data\n");
  173. goto error_ret;
  174. }
  175. *val = (be32_to_cpu(st->rx) >> 10) & 0xFFFF;
  176. error_ret:
  177. mutex_unlock(&st->buf_lock);
  178. return ret;
  179. }
  180. /**
  181. * adxrs450_spi_initial() - use for initializing procedure.
  182. * @st: device instance specific data
  183. * @val: somewhere to pass back the value read
  184. * @chk: Whether to perform fault check
  185. **/
  186. static int adxrs450_spi_initial(struct adxrs450_state *st,
  187. u32 *val, char chk)
  188. {
  189. int ret;
  190. u32 tx;
  191. struct spi_transfer xfers = {
  192. .tx_buf = &st->tx,
  193. .rx_buf = &st->rx,
  194. .bits_per_word = 8,
  195. .len = sizeof(st->tx),
  196. };
  197. mutex_lock(&st->buf_lock);
  198. tx = ADXRS450_SENSOR_DATA;
  199. if (chk)
  200. tx |= (ADXRS450_CHK | ADXRS450_P);
  201. st->tx = cpu_to_be32(tx);
  202. ret = spi_sync_transfer(st->us, &xfers, 1);
  203. if (ret) {
  204. dev_err(&st->us->dev, "Problem while reading initializing data\n");
  205. goto error_ret;
  206. }
  207. *val = be32_to_cpu(st->rx);
  208. error_ret:
  209. mutex_unlock(&st->buf_lock);
  210. return ret;
  211. }
  212. /* Recommended Startup Sequence by spec */
  213. static int adxrs450_initial_setup(struct iio_dev *indio_dev)
  214. {
  215. u32 t;
  216. u16 data;
  217. int ret;
  218. struct adxrs450_state *st = iio_priv(indio_dev);
  219. msleep(ADXRS450_STARTUP_DELAY*2);
  220. ret = adxrs450_spi_initial(st, &t, 1);
  221. if (ret)
  222. return ret;
  223. if (t != 0x01)
  224. dev_warn(&st->us->dev, "The initial power on response is not correct! Restart without reset?\n");
  225. msleep(ADXRS450_STARTUP_DELAY);
  226. ret = adxrs450_spi_initial(st, &t, 0);
  227. if (ret)
  228. return ret;
  229. msleep(ADXRS450_STARTUP_DELAY);
  230. ret = adxrs450_spi_initial(st, &t, 0);
  231. if (ret)
  232. return ret;
  233. if (((t & 0xff) | 0x01) != 0xff || ADXRS450_GET_ST(t) != 2) {
  234. dev_err(&st->us->dev, "The second response is not correct!\n");
  235. return -EIO;
  236. }
  237. ret = adxrs450_spi_initial(st, &t, 0);
  238. if (ret)
  239. return ret;
  240. if (((t & 0xff) | 0x01) != 0xff || ADXRS450_GET_ST(t) != 2) {
  241. dev_err(&st->us->dev, "The third response is not correct!\n");
  242. return -EIO;
  243. }
  244. ret = adxrs450_spi_read_reg_16(indio_dev, ADXRS450_FAULT1, &data);
  245. if (ret)
  246. return ret;
  247. if (data & 0x0fff) {
  248. dev_err(&st->us->dev, "The device is not in normal status!\n");
  249. return -EINVAL;
  250. }
  251. return 0;
  252. }
  253. static int adxrs450_write_raw(struct iio_dev *indio_dev,
  254. struct iio_chan_spec const *chan,
  255. int val,
  256. int val2,
  257. long mask)
  258. {
  259. int ret;
  260. switch (mask) {
  261. case IIO_CHAN_INFO_CALIBBIAS:
  262. if (val < -0x400 || val >= 0x400)
  263. return -EINVAL;
  264. ret = adxrs450_spi_write_reg_16(indio_dev,
  265. ADXRS450_DNC1, val);
  266. break;
  267. default:
  268. ret = -EINVAL;
  269. break;
  270. }
  271. return ret;
  272. }
  273. static int adxrs450_read_raw(struct iio_dev *indio_dev,
  274. struct iio_chan_spec const *chan,
  275. int *val,
  276. int *val2,
  277. long mask)
  278. {
  279. int ret;
  280. s16 t;
  281. switch (mask) {
  282. case IIO_CHAN_INFO_RAW:
  283. switch (chan->type) {
  284. case IIO_ANGL_VEL:
  285. ret = adxrs450_spi_sensor_data(indio_dev, &t);
  286. if (ret)
  287. break;
  288. *val = t;
  289. ret = IIO_VAL_INT;
  290. break;
  291. case IIO_TEMP:
  292. ret = adxrs450_spi_read_reg_16(indio_dev,
  293. ADXRS450_TEMP1, &t);
  294. if (ret)
  295. break;
  296. *val = (t >> 6) + 225;
  297. ret = IIO_VAL_INT;
  298. break;
  299. default:
  300. ret = -EINVAL;
  301. break;
  302. }
  303. break;
  304. case IIO_CHAN_INFO_SCALE:
  305. switch (chan->type) {
  306. case IIO_ANGL_VEL:
  307. *val = 0;
  308. *val2 = 218166;
  309. return IIO_VAL_INT_PLUS_NANO;
  310. case IIO_TEMP:
  311. *val = 200;
  312. *val2 = 0;
  313. return IIO_VAL_INT;
  314. default:
  315. return -EINVAL;
  316. }
  317. break;
  318. case IIO_CHAN_INFO_QUADRATURE_CORRECTION_RAW:
  319. ret = adxrs450_spi_read_reg_16(indio_dev, ADXRS450_QUAD1, &t);
  320. if (ret)
  321. break;
  322. *val = t;
  323. ret = IIO_VAL_INT;
  324. break;
  325. case IIO_CHAN_INFO_CALIBBIAS:
  326. ret = adxrs450_spi_read_reg_16(indio_dev, ADXRS450_DNC1, &t);
  327. if (ret)
  328. break;
  329. *val = sign_extend32(t, 9);
  330. ret = IIO_VAL_INT;
  331. break;
  332. default:
  333. ret = -EINVAL;
  334. break;
  335. }
  336. return ret;
  337. }
  338. static const struct iio_chan_spec adxrs450_channels[2][2] = {
  339. [ID_ADXRS450] = {
  340. {
  341. .type = IIO_ANGL_VEL,
  342. .modified = 1,
  343. .channel2 = IIO_MOD_Z,
  344. .info_mask = IIO_CHAN_INFO_RAW_SEPARATE_BIT |
  345. IIO_CHAN_INFO_CALIBBIAS_SEPARATE_BIT |
  346. IIO_CHAN_INFO_QUADRATURE_CORRECTION_RAW_SEPARATE_BIT |
  347. IIO_CHAN_INFO_SCALE_SEPARATE_BIT,
  348. }, {
  349. .type = IIO_TEMP,
  350. .indexed = 1,
  351. .channel = 0,
  352. .info_mask = IIO_CHAN_INFO_RAW_SEPARATE_BIT |
  353. IIO_CHAN_INFO_SCALE_SEPARATE_BIT,
  354. }
  355. },
  356. [ID_ADXRS453] = {
  357. {
  358. .type = IIO_ANGL_VEL,
  359. .modified = 1,
  360. .channel2 = IIO_MOD_Z,
  361. .info_mask = IIO_CHAN_INFO_RAW_SEPARATE_BIT |
  362. IIO_CHAN_INFO_SCALE_SEPARATE_BIT |
  363. IIO_CHAN_INFO_QUADRATURE_CORRECTION_RAW_SEPARATE_BIT,
  364. }, {
  365. .type = IIO_TEMP,
  366. .indexed = 1,
  367. .channel = 0,
  368. .info_mask = IIO_CHAN_INFO_RAW_SEPARATE_BIT |
  369. IIO_CHAN_INFO_SCALE_SEPARATE_BIT,
  370. }
  371. },
  372. };
  373. static const struct iio_info adxrs450_info = {
  374. .driver_module = THIS_MODULE,
  375. .read_raw = &adxrs450_read_raw,
  376. .write_raw = &adxrs450_write_raw,
  377. };
  378. static int adxrs450_probe(struct spi_device *spi)
  379. {
  380. int ret;
  381. struct adxrs450_state *st;
  382. struct iio_dev *indio_dev;
  383. /* setup the industrialio driver allocated elements */
  384. indio_dev = iio_device_alloc(sizeof(*st));
  385. if (indio_dev == NULL) {
  386. ret = -ENOMEM;
  387. goto error_ret;
  388. }
  389. st = iio_priv(indio_dev);
  390. st->us = spi;
  391. mutex_init(&st->buf_lock);
  392. /* This is only used for removal purposes */
  393. spi_set_drvdata(spi, indio_dev);
  394. indio_dev->dev.parent = &spi->dev;
  395. indio_dev->info = &adxrs450_info;
  396. indio_dev->modes = INDIO_DIRECT_MODE;
  397. indio_dev->channels =
  398. adxrs450_channels[spi_get_device_id(spi)->driver_data];
  399. indio_dev->num_channels = ARRAY_SIZE(adxrs450_channels);
  400. indio_dev->name = spi->dev.driver->name;
  401. ret = iio_device_register(indio_dev);
  402. if (ret)
  403. goto error_free_dev;
  404. /* Get the device into a sane initial state */
  405. ret = adxrs450_initial_setup(indio_dev);
  406. if (ret)
  407. goto error_initial;
  408. return 0;
  409. error_initial:
  410. iio_device_unregister(indio_dev);
  411. error_free_dev:
  412. iio_device_free(indio_dev);
  413. error_ret:
  414. return ret;
  415. }
  416. static int adxrs450_remove(struct spi_device *spi)
  417. {
  418. iio_device_unregister(spi_get_drvdata(spi));
  419. iio_device_free(spi_get_drvdata(spi));
  420. return 0;
  421. }
  422. static const struct spi_device_id adxrs450_id[] = {
  423. {"adxrs450", ID_ADXRS450},
  424. {"adxrs453", ID_ADXRS453},
  425. {}
  426. };
  427. MODULE_DEVICE_TABLE(spi, adxrs450_id);
  428. static struct spi_driver adxrs450_driver = {
  429. .driver = {
  430. .name = "adxrs450",
  431. .owner = THIS_MODULE,
  432. },
  433. .probe = adxrs450_probe,
  434. .remove = adxrs450_remove,
  435. .id_table = adxrs450_id,
  436. };
  437. module_spi_driver(adxrs450_driver);
  438. MODULE_AUTHOR("Cliff Cai <cliff.cai@xxxxxxxxxx>");
  439. MODULE_DESCRIPTION("Analog Devices ADXRS450/ADXRS453 Gyroscope SPI driver");
  440. MODULE_LICENSE("GPL v2");