adis16201.c 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303
  1. // SPDX-License-Identifier: GPL-2.0-or-later
  2. /*
  3. * ADIS16201 Dual-Axis Digital Inclinometer and Accelerometer
  4. *
  5. * Copyright 2010 Analog Devices Inc.
  6. */
  7. #include <linux/device.h>
  8. #include <linux/kernel.h>
  9. #include <linux/module.h>
  10. #include <linux/spi/spi.h>
  11. #include <linux/iio/iio.h>
  12. #include <linux/iio/imu/adis.h>
  13. #define ADIS16201_STARTUP_DELAY_MS 220
  14. #define ADIS16201_FLASH_CNT 0x00
  15. /* Data Output Register Information */
  16. #define ADIS16201_SUPPLY_OUT_REG 0x02
  17. #define ADIS16201_XACCL_OUT_REG 0x04
  18. #define ADIS16201_YACCL_OUT_REG 0x06
  19. #define ADIS16201_AUX_ADC_REG 0x08
  20. #define ADIS16201_TEMP_OUT_REG 0x0A
  21. #define ADIS16201_XINCL_OUT_REG 0x0C
  22. #define ADIS16201_YINCL_OUT_REG 0x0E
  23. /* Calibration Register Definition */
  24. #define ADIS16201_XACCL_OFFS_REG 0x10
  25. #define ADIS16201_YACCL_OFFS_REG 0x12
  26. #define ADIS16201_XACCL_SCALE_REG 0x14
  27. #define ADIS16201_YACCL_SCALE_REG 0x16
  28. #define ADIS16201_XINCL_OFFS_REG 0x18
  29. #define ADIS16201_YINCL_OFFS_REG 0x1A
  30. #define ADIS16201_XINCL_SCALE_REG 0x1C
  31. #define ADIS16201_YINCL_SCALE_REG 0x1E
  32. /* Alarm Register Definition */
  33. #define ADIS16201_ALM_MAG1_REG 0x20
  34. #define ADIS16201_ALM_MAG2_REG 0x22
  35. #define ADIS16201_ALM_SMPL1_REG 0x24
  36. #define ADIS16201_ALM_SMPL2_REG 0x26
  37. #define ADIS16201_ALM_CTRL_REG 0x28
  38. #define ADIS16201_AUX_DAC_REG 0x30
  39. #define ADIS16201_GPIO_CTRL_REG 0x32
  40. #define ADIS16201_SMPL_PRD_REG 0x36
  41. /* Operation, filter configuration */
  42. #define ADIS16201_AVG_CNT_REG 0x38
  43. #define ADIS16201_SLP_CNT_REG 0x3A
  44. /* Miscellaneous Control Register Definition */
  45. #define ADIS16201_MSC_CTRL_REG 0x34
  46. #define ADIS16201_MSC_CTRL_SELF_TEST_EN BIT(8)
  47. /* Data-ready enable: 1 = enabled, 0 = disabled */
  48. #define ADIS16201_MSC_CTRL_DATA_RDY_EN BIT(2)
  49. /* Data-ready polarity: 1 = active high, 0 = active low */
  50. #define ADIS16201_MSC_CTRL_ACTIVE_DATA_RDY_HIGH BIT(1)
  51. /* Data-ready line selection: 1 = DIO1, 0 = DIO0 */
  52. #define ADIS16201_MSC_CTRL_DATA_RDY_DIO1 BIT(0)
  53. /* Diagnostics System Status Register Definition */
  54. #define ADIS16201_DIAG_STAT_REG 0x3C
  55. #define ADIS16201_DIAG_STAT_ALARM2 BIT(9)
  56. #define ADIS16201_DIAG_STAT_ALARM1 BIT(8)
  57. #define ADIS16201_DIAG_STAT_SPI_FAIL_BIT 3
  58. #define ADIS16201_DIAG_STAT_FLASH_UPT_FAIL_BIT 2
  59. /* Power supply above 3.625 V */
  60. #define ADIS16201_DIAG_STAT_POWER_HIGH_BIT 1
  61. /* Power supply below 2.975 V */
  62. #define ADIS16201_DIAG_STAT_POWER_LOW_BIT 0
  63. /* System Command Register Definition */
  64. #define ADIS16201_GLOB_CMD_REG 0x3E
  65. #define ADIS16201_GLOB_CMD_SW_RESET BIT(7)
  66. #define ADIS16201_GLOB_CMD_FACTORY_RESET BIT(1)
  67. #define ADIS16201_ERROR_ACTIVE BIT(14)
  68. enum adis16201_scan {
  69. ADIS16201_SCAN_ACC_X,
  70. ADIS16201_SCAN_ACC_Y,
  71. ADIS16201_SCAN_INCLI_X,
  72. ADIS16201_SCAN_INCLI_Y,
  73. ADIS16201_SCAN_SUPPLY,
  74. ADIS16201_SCAN_AUX_ADC,
  75. ADIS16201_SCAN_TEMP,
  76. };
  77. static const u8 adis16201_addresses[] = {
  78. [ADIS16201_SCAN_ACC_X] = ADIS16201_XACCL_OFFS_REG,
  79. [ADIS16201_SCAN_ACC_Y] = ADIS16201_YACCL_OFFS_REG,
  80. [ADIS16201_SCAN_INCLI_X] = ADIS16201_XINCL_OFFS_REG,
  81. [ADIS16201_SCAN_INCLI_Y] = ADIS16201_YINCL_OFFS_REG,
  82. };
  83. static int adis16201_read_raw(struct iio_dev *indio_dev,
  84. struct iio_chan_spec const *chan,
  85. int *val, int *val2,
  86. long mask)
  87. {
  88. struct adis *st = iio_priv(indio_dev);
  89. int ret;
  90. int bits;
  91. u8 addr;
  92. s16 val16;
  93. switch (mask) {
  94. case IIO_CHAN_INFO_RAW:
  95. return adis_single_conversion(indio_dev, chan,
  96. ADIS16201_ERROR_ACTIVE, val);
  97. case IIO_CHAN_INFO_SCALE:
  98. switch (chan->type) {
  99. case IIO_VOLTAGE:
  100. if (chan->channel == 0) {
  101. /* Voltage base units are mV hence 1.22 mV */
  102. *val = 1;
  103. *val2 = 220000;
  104. } else {
  105. /* Voltage base units are mV hence 0.61 mV */
  106. *val = 0;
  107. *val2 = 610000;
  108. }
  109. return IIO_VAL_INT_PLUS_MICRO;
  110. case IIO_TEMP:
  111. *val = -470;
  112. *val2 = 0;
  113. return IIO_VAL_INT_PLUS_MICRO;
  114. case IIO_ACCEL:
  115. /*
  116. * IIO base unit for sensitivity of accelerometer
  117. * is milli g.
  118. * 1 LSB represents 0.244 mg.
  119. */
  120. *val = 0;
  121. *val2 = IIO_G_TO_M_S_2(462400);
  122. return IIO_VAL_INT_PLUS_NANO;
  123. case IIO_INCLI:
  124. *val = 0;
  125. *val2 = 100000;
  126. return IIO_VAL_INT_PLUS_MICRO;
  127. default:
  128. return -EINVAL;
  129. }
  130. break;
  131. case IIO_CHAN_INFO_OFFSET:
  132. /*
  133. * The raw ADC value is 1278 when the temperature
  134. * is 25 degrees and the scale factor per milli
  135. * degree celcius is -470.
  136. */
  137. *val = 25000 / -470 - 1278;
  138. return IIO_VAL_INT;
  139. case IIO_CHAN_INFO_CALIBBIAS:
  140. switch (chan->type) {
  141. case IIO_ACCEL:
  142. bits = 12;
  143. break;
  144. case IIO_INCLI:
  145. bits = 9;
  146. break;
  147. default:
  148. return -EINVAL;
  149. }
  150. addr = adis16201_addresses[chan->scan_index];
  151. ret = adis_read_reg_16(st, addr, &val16);
  152. if (ret)
  153. return ret;
  154. *val = sign_extend32(val16, bits - 1);
  155. return IIO_VAL_INT;
  156. }
  157. return -EINVAL;
  158. }
  159. static int adis16201_write_raw(struct iio_dev *indio_dev,
  160. struct iio_chan_spec const *chan,
  161. int val,
  162. int val2,
  163. long mask)
  164. {
  165. struct adis *st = iio_priv(indio_dev);
  166. int m;
  167. if (mask != IIO_CHAN_INFO_CALIBBIAS)
  168. return -EINVAL;
  169. switch (chan->type) {
  170. case IIO_ACCEL:
  171. m = GENMASK(11, 0);
  172. break;
  173. case IIO_INCLI:
  174. m = GENMASK(8, 0);
  175. break;
  176. default:
  177. return -EINVAL;
  178. }
  179. return adis_write_reg_16(st, adis16201_addresses[chan->scan_index],
  180. val & m);
  181. }
  182. static const struct iio_chan_spec adis16201_channels[] = {
  183. ADIS_SUPPLY_CHAN(ADIS16201_SUPPLY_OUT_REG, ADIS16201_SCAN_SUPPLY, 0,
  184. 12),
  185. ADIS_TEMP_CHAN(ADIS16201_TEMP_OUT_REG, ADIS16201_SCAN_TEMP, 0, 12),
  186. ADIS_ACCEL_CHAN(X, ADIS16201_XACCL_OUT_REG, ADIS16201_SCAN_ACC_X,
  187. BIT(IIO_CHAN_INFO_CALIBBIAS), 0, 14),
  188. ADIS_ACCEL_CHAN(Y, ADIS16201_YACCL_OUT_REG, ADIS16201_SCAN_ACC_Y,
  189. BIT(IIO_CHAN_INFO_CALIBBIAS), 0, 14),
  190. ADIS_AUX_ADC_CHAN(ADIS16201_AUX_ADC_REG, ADIS16201_SCAN_AUX_ADC, 0, 12),
  191. ADIS_INCLI_CHAN(X, ADIS16201_XINCL_OUT_REG, ADIS16201_SCAN_INCLI_X,
  192. BIT(IIO_CHAN_INFO_CALIBBIAS), 0, 14),
  193. ADIS_INCLI_CHAN(Y, ADIS16201_YINCL_OUT_REG, ADIS16201_SCAN_INCLI_Y,
  194. BIT(IIO_CHAN_INFO_CALIBBIAS), 0, 14),
  195. IIO_CHAN_SOFT_TIMESTAMP(7)
  196. };
  197. static const struct iio_info adis16201_info = {
  198. .read_raw = adis16201_read_raw,
  199. .write_raw = adis16201_write_raw,
  200. .update_scan_mode = adis_update_scan_mode,
  201. };
  202. static const char * const adis16201_status_error_msgs[] = {
  203. [ADIS16201_DIAG_STAT_SPI_FAIL_BIT] = "SPI failure",
  204. [ADIS16201_DIAG_STAT_FLASH_UPT_FAIL_BIT] = "Flash update failed",
  205. [ADIS16201_DIAG_STAT_POWER_HIGH_BIT] = "Power supply above 3.625V",
  206. [ADIS16201_DIAG_STAT_POWER_LOW_BIT] = "Power supply below 2.975V",
  207. };
  208. static const struct adis_timeout adis16201_timeouts = {
  209. .reset_ms = ADIS16201_STARTUP_DELAY_MS,
  210. .sw_reset_ms = ADIS16201_STARTUP_DELAY_MS,
  211. .self_test_ms = ADIS16201_STARTUP_DELAY_MS,
  212. };
  213. static const struct adis_data adis16201_data = {
  214. .read_delay = 20,
  215. .msc_ctrl_reg = ADIS16201_MSC_CTRL_REG,
  216. .glob_cmd_reg = ADIS16201_GLOB_CMD_REG,
  217. .diag_stat_reg = ADIS16201_DIAG_STAT_REG,
  218. .self_test_mask = ADIS16201_MSC_CTRL_SELF_TEST_EN,
  219. .self_test_reg = ADIS16201_MSC_CTRL_REG,
  220. .self_test_no_autoclear = true,
  221. .timeouts = &adis16201_timeouts,
  222. .status_error_msgs = adis16201_status_error_msgs,
  223. .status_error_mask = BIT(ADIS16201_DIAG_STAT_SPI_FAIL_BIT) |
  224. BIT(ADIS16201_DIAG_STAT_FLASH_UPT_FAIL_BIT) |
  225. BIT(ADIS16201_DIAG_STAT_POWER_HIGH_BIT) |
  226. BIT(ADIS16201_DIAG_STAT_POWER_LOW_BIT),
  227. };
  228. static int adis16201_probe(struct spi_device *spi)
  229. {
  230. struct iio_dev *indio_dev;
  231. struct adis *st;
  232. int ret;
  233. indio_dev = devm_iio_device_alloc(&spi->dev, sizeof(*st));
  234. if (!indio_dev)
  235. return -ENOMEM;
  236. st = iio_priv(indio_dev);
  237. indio_dev->name = spi->dev.driver->name;
  238. indio_dev->info = &adis16201_info;
  239. indio_dev->channels = adis16201_channels;
  240. indio_dev->num_channels = ARRAY_SIZE(adis16201_channels);
  241. indio_dev->modes = INDIO_DIRECT_MODE;
  242. ret = adis_init(st, indio_dev, spi, &adis16201_data);
  243. if (ret)
  244. return ret;
  245. ret = devm_adis_setup_buffer_and_trigger(st, indio_dev, NULL);
  246. if (ret)
  247. return ret;
  248. ret = adis_initial_startup(st);
  249. if (ret)
  250. return ret;
  251. return devm_iio_device_register(&spi->dev, indio_dev);
  252. }
  253. static struct spi_driver adis16201_driver = {
  254. .driver = {
  255. .name = "adis16201",
  256. },
  257. .probe = adis16201_probe,
  258. };
  259. module_spi_driver(adis16201_driver);
  260. MODULE_AUTHOR("Barry Song <[email protected]>");
  261. MODULE_DESCRIPTION("Analog Devices ADIS16201 Dual-Axis Digital Inclinometer and Accelerometer");
  262. MODULE_LICENSE("GPL v2");
  263. MODULE_ALIAS("spi:adis16201");
  264. MODULE_IMPORT_NS(IIO_ADISLIB);