as3935.c 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470
  1. // SPDX-License-Identifier: GPL-2.0+
  2. /*
  3. * as3935.c - Support for AS3935 Franklin lightning sensor
  4. *
  5. * Copyright (C) 2014, 2017-2018
  6. * Author: Matt Ranostay <[email protected]>
  7. */
  8. #include <linux/module.h>
  9. #include <linux/mod_devicetable.h>
  10. #include <linux/init.h>
  11. #include <linux/interrupt.h>
  12. #include <linux/delay.h>
  13. #include <linux/workqueue.h>
  14. #include <linux/devm-helpers.h>
  15. #include <linux/mutex.h>
  16. #include <linux/err.h>
  17. #include <linux/irq.h>
  18. #include <linux/spi/spi.h>
  19. #include <linux/iio/iio.h>
  20. #include <linux/iio/sysfs.h>
  21. #include <linux/iio/trigger.h>
  22. #include <linux/iio/trigger_consumer.h>
  23. #include <linux/iio/buffer.h>
  24. #include <linux/iio/triggered_buffer.h>
  25. #define AS3935_AFE_GAIN 0x00
  26. #define AS3935_AFE_MASK 0x3F
  27. #define AS3935_AFE_GAIN_MAX 0x1F
  28. #define AS3935_AFE_PWR_BIT BIT(0)
  29. #define AS3935_NFLWDTH 0x01
  30. #define AS3935_NFLWDTH_MASK 0x7f
  31. #define AS3935_INT 0x03
  32. #define AS3935_INT_MASK 0x0f
  33. #define AS3935_DISTURB_INT BIT(2)
  34. #define AS3935_EVENT_INT BIT(3)
  35. #define AS3935_NOISE_INT BIT(0)
  36. #define AS3935_DATA 0x07
  37. #define AS3935_DATA_MASK 0x3F
  38. #define AS3935_TUNE_CAP 0x08
  39. #define AS3935_DEFAULTS 0x3C
  40. #define AS3935_CALIBRATE 0x3D
  41. #define AS3935_READ_DATA BIT(14)
  42. #define AS3935_ADDRESS(x) ((x) << 8)
  43. #define MAX_PF_CAP 120
  44. #define TUNE_CAP_DIV 8
  45. struct as3935_state {
  46. struct spi_device *spi;
  47. struct iio_trigger *trig;
  48. struct mutex lock;
  49. struct delayed_work work;
  50. unsigned long noise_tripped;
  51. u32 tune_cap;
  52. u32 nflwdth_reg;
  53. /* Ensure timestamp is naturally aligned */
  54. struct {
  55. u8 chan;
  56. s64 timestamp __aligned(8);
  57. } scan;
  58. u8 buf[2] __aligned(IIO_DMA_MINALIGN);
  59. };
  60. static const struct iio_chan_spec as3935_channels[] = {
  61. {
  62. .type = IIO_PROXIMITY,
  63. .info_mask_separate =
  64. BIT(IIO_CHAN_INFO_RAW) |
  65. BIT(IIO_CHAN_INFO_PROCESSED) |
  66. BIT(IIO_CHAN_INFO_SCALE),
  67. .scan_index = 0,
  68. .scan_type = {
  69. .sign = 'u',
  70. .realbits = 6,
  71. .storagebits = 8,
  72. },
  73. },
  74. IIO_CHAN_SOFT_TIMESTAMP(1),
  75. };
  76. static int as3935_read(struct as3935_state *st, unsigned int reg, int *val)
  77. {
  78. u8 cmd;
  79. int ret;
  80. cmd = (AS3935_READ_DATA | AS3935_ADDRESS(reg)) >> 8;
  81. ret = spi_w8r8(st->spi, cmd);
  82. if (ret < 0)
  83. return ret;
  84. *val = ret;
  85. return 0;
  86. }
  87. static int as3935_write(struct as3935_state *st,
  88. unsigned int reg,
  89. unsigned int val)
  90. {
  91. u8 *buf = st->buf;
  92. buf[0] = AS3935_ADDRESS(reg) >> 8;
  93. buf[1] = val;
  94. return spi_write(st->spi, buf, 2);
  95. }
  96. static ssize_t as3935_sensor_sensitivity_show(struct device *dev,
  97. struct device_attribute *attr,
  98. char *buf)
  99. {
  100. struct as3935_state *st = iio_priv(dev_to_iio_dev(dev));
  101. int val, ret;
  102. ret = as3935_read(st, AS3935_AFE_GAIN, &val);
  103. if (ret)
  104. return ret;
  105. val = (val & AS3935_AFE_MASK) >> 1;
  106. return sysfs_emit(buf, "%d\n", val);
  107. }
  108. static ssize_t as3935_sensor_sensitivity_store(struct device *dev,
  109. struct device_attribute *attr,
  110. const char *buf, size_t len)
  111. {
  112. struct as3935_state *st = iio_priv(dev_to_iio_dev(dev));
  113. unsigned long val;
  114. int ret;
  115. ret = kstrtoul(buf, 10, &val);
  116. if (ret)
  117. return -EINVAL;
  118. if (val > AS3935_AFE_GAIN_MAX)
  119. return -EINVAL;
  120. as3935_write(st, AS3935_AFE_GAIN, val << 1);
  121. return len;
  122. }
  123. static ssize_t as3935_noise_level_tripped_show(struct device *dev,
  124. struct device_attribute *attr,
  125. char *buf)
  126. {
  127. struct as3935_state *st = iio_priv(dev_to_iio_dev(dev));
  128. int ret;
  129. mutex_lock(&st->lock);
  130. ret = sysfs_emit(buf, "%d\n", !time_after(jiffies, st->noise_tripped + HZ));
  131. mutex_unlock(&st->lock);
  132. return ret;
  133. }
  134. static IIO_DEVICE_ATTR(sensor_sensitivity, S_IRUGO | S_IWUSR,
  135. as3935_sensor_sensitivity_show, as3935_sensor_sensitivity_store, 0);
  136. static IIO_DEVICE_ATTR(noise_level_tripped, S_IRUGO,
  137. as3935_noise_level_tripped_show, NULL, 0);
  138. static struct attribute *as3935_attributes[] = {
  139. &iio_dev_attr_sensor_sensitivity.dev_attr.attr,
  140. &iio_dev_attr_noise_level_tripped.dev_attr.attr,
  141. NULL,
  142. };
  143. static const struct attribute_group as3935_attribute_group = {
  144. .attrs = as3935_attributes,
  145. };
  146. static int as3935_read_raw(struct iio_dev *indio_dev,
  147. struct iio_chan_spec const *chan,
  148. int *val,
  149. int *val2,
  150. long m)
  151. {
  152. struct as3935_state *st = iio_priv(indio_dev);
  153. int ret;
  154. switch (m) {
  155. case IIO_CHAN_INFO_PROCESSED:
  156. case IIO_CHAN_INFO_RAW:
  157. *val2 = 0;
  158. ret = as3935_read(st, AS3935_DATA, val);
  159. if (ret)
  160. return ret;
  161. /* storm out of range */
  162. if (*val == AS3935_DATA_MASK)
  163. return -EINVAL;
  164. if (m == IIO_CHAN_INFO_RAW)
  165. return IIO_VAL_INT;
  166. if (m == IIO_CHAN_INFO_PROCESSED)
  167. *val *= 1000;
  168. break;
  169. case IIO_CHAN_INFO_SCALE:
  170. *val = 1000;
  171. break;
  172. default:
  173. return -EINVAL;
  174. }
  175. return IIO_VAL_INT;
  176. }
  177. static const struct iio_info as3935_info = {
  178. .attrs = &as3935_attribute_group,
  179. .read_raw = &as3935_read_raw,
  180. };
  181. static irqreturn_t as3935_trigger_handler(int irq, void *private)
  182. {
  183. struct iio_poll_func *pf = private;
  184. struct iio_dev *indio_dev = pf->indio_dev;
  185. struct as3935_state *st = iio_priv(indio_dev);
  186. int val, ret;
  187. ret = as3935_read(st, AS3935_DATA, &val);
  188. if (ret)
  189. goto err_read;
  190. st->scan.chan = val & AS3935_DATA_MASK;
  191. iio_push_to_buffers_with_timestamp(indio_dev, &st->scan,
  192. iio_get_time_ns(indio_dev));
  193. err_read:
  194. iio_trigger_notify_done(indio_dev->trig);
  195. return IRQ_HANDLED;
  196. }
  197. static void as3935_event_work(struct work_struct *work)
  198. {
  199. struct as3935_state *st;
  200. int val;
  201. int ret;
  202. st = container_of(work, struct as3935_state, work.work);
  203. ret = as3935_read(st, AS3935_INT, &val);
  204. if (ret) {
  205. dev_warn(&st->spi->dev, "read error\n");
  206. return;
  207. }
  208. val &= AS3935_INT_MASK;
  209. switch (val) {
  210. case AS3935_EVENT_INT:
  211. iio_trigger_poll_chained(st->trig);
  212. break;
  213. case AS3935_DISTURB_INT:
  214. case AS3935_NOISE_INT:
  215. mutex_lock(&st->lock);
  216. st->noise_tripped = jiffies;
  217. mutex_unlock(&st->lock);
  218. dev_warn(&st->spi->dev, "noise level is too high\n");
  219. break;
  220. }
  221. }
  222. static irqreturn_t as3935_interrupt_handler(int irq, void *private)
  223. {
  224. struct iio_dev *indio_dev = private;
  225. struct as3935_state *st = iio_priv(indio_dev);
  226. /*
  227. * Delay work for >2 milliseconds after an interrupt to allow
  228. * estimated distance to recalculated.
  229. */
  230. schedule_delayed_work(&st->work, msecs_to_jiffies(3));
  231. return IRQ_HANDLED;
  232. }
  233. static void calibrate_as3935(struct as3935_state *st)
  234. {
  235. as3935_write(st, AS3935_DEFAULTS, 0x96);
  236. as3935_write(st, AS3935_CALIBRATE, 0x96);
  237. as3935_write(st, AS3935_TUNE_CAP,
  238. BIT(5) | (st->tune_cap / TUNE_CAP_DIV));
  239. mdelay(2);
  240. as3935_write(st, AS3935_TUNE_CAP, (st->tune_cap / TUNE_CAP_DIV));
  241. as3935_write(st, AS3935_NFLWDTH, st->nflwdth_reg);
  242. }
  243. static int as3935_suspend(struct device *dev)
  244. {
  245. struct iio_dev *indio_dev = dev_get_drvdata(dev);
  246. struct as3935_state *st = iio_priv(indio_dev);
  247. int val, ret;
  248. mutex_lock(&st->lock);
  249. ret = as3935_read(st, AS3935_AFE_GAIN, &val);
  250. if (ret)
  251. goto err_suspend;
  252. val |= AS3935_AFE_PWR_BIT;
  253. ret = as3935_write(st, AS3935_AFE_GAIN, val);
  254. err_suspend:
  255. mutex_unlock(&st->lock);
  256. return ret;
  257. }
  258. static int as3935_resume(struct device *dev)
  259. {
  260. struct iio_dev *indio_dev = dev_get_drvdata(dev);
  261. struct as3935_state *st = iio_priv(indio_dev);
  262. int val, ret;
  263. mutex_lock(&st->lock);
  264. ret = as3935_read(st, AS3935_AFE_GAIN, &val);
  265. if (ret)
  266. goto err_resume;
  267. val &= ~AS3935_AFE_PWR_BIT;
  268. ret = as3935_write(st, AS3935_AFE_GAIN, val);
  269. calibrate_as3935(st);
  270. err_resume:
  271. mutex_unlock(&st->lock);
  272. return ret;
  273. }
  274. static DEFINE_SIMPLE_DEV_PM_OPS(as3935_pm_ops, as3935_suspend, as3935_resume);
  275. static int as3935_probe(struct spi_device *spi)
  276. {
  277. struct device *dev = &spi->dev;
  278. struct iio_dev *indio_dev;
  279. struct iio_trigger *trig;
  280. struct as3935_state *st;
  281. int ret;
  282. /* Be sure lightning event interrupt is specified */
  283. if (!spi->irq) {
  284. dev_err(dev, "unable to get event interrupt\n");
  285. return -EINVAL;
  286. }
  287. indio_dev = devm_iio_device_alloc(dev, sizeof(*st));
  288. if (!indio_dev)
  289. return -ENOMEM;
  290. st = iio_priv(indio_dev);
  291. st->spi = spi;
  292. spi_set_drvdata(spi, indio_dev);
  293. mutex_init(&st->lock);
  294. ret = device_property_read_u32(dev,
  295. "ams,tuning-capacitor-pf", &st->tune_cap);
  296. if (ret) {
  297. st->tune_cap = 0;
  298. dev_warn(dev, "no tuning-capacitor-pf set, defaulting to %d",
  299. st->tune_cap);
  300. }
  301. if (st->tune_cap > MAX_PF_CAP) {
  302. dev_err(dev, "wrong tuning-capacitor-pf setting of %d\n",
  303. st->tune_cap);
  304. return -EINVAL;
  305. }
  306. ret = device_property_read_u32(dev,
  307. "ams,nflwdth", &st->nflwdth_reg);
  308. if (!ret && st->nflwdth_reg > AS3935_NFLWDTH_MASK) {
  309. dev_err(dev, "invalid nflwdth setting of %d\n",
  310. st->nflwdth_reg);
  311. return -EINVAL;
  312. }
  313. indio_dev->name = spi_get_device_id(spi)->name;
  314. indio_dev->channels = as3935_channels;
  315. indio_dev->num_channels = ARRAY_SIZE(as3935_channels);
  316. indio_dev->modes = INDIO_DIRECT_MODE;
  317. indio_dev->info = &as3935_info;
  318. trig = devm_iio_trigger_alloc(dev, "%s-dev%d",
  319. indio_dev->name,
  320. iio_device_id(indio_dev));
  321. if (!trig)
  322. return -ENOMEM;
  323. st->trig = trig;
  324. st->noise_tripped = jiffies - HZ;
  325. iio_trigger_set_drvdata(trig, indio_dev);
  326. ret = devm_iio_trigger_register(dev, trig);
  327. if (ret) {
  328. dev_err(dev, "failed to register trigger\n");
  329. return ret;
  330. }
  331. ret = devm_iio_triggered_buffer_setup(dev, indio_dev,
  332. iio_pollfunc_store_time,
  333. as3935_trigger_handler, NULL);
  334. if (ret) {
  335. dev_err(dev, "cannot setup iio trigger\n");
  336. return ret;
  337. }
  338. calibrate_as3935(st);
  339. ret = devm_delayed_work_autocancel(dev, &st->work, as3935_event_work);
  340. if (ret)
  341. return ret;
  342. ret = devm_request_irq(dev, spi->irq,
  343. &as3935_interrupt_handler,
  344. IRQF_TRIGGER_RISING,
  345. dev_name(dev),
  346. indio_dev);
  347. if (ret) {
  348. dev_err(dev, "unable to request irq\n");
  349. return ret;
  350. }
  351. ret = devm_iio_device_register(dev, indio_dev);
  352. if (ret < 0) {
  353. dev_err(dev, "unable to register device\n");
  354. return ret;
  355. }
  356. return 0;
  357. }
  358. static const struct of_device_id as3935_of_match[] = {
  359. { .compatible = "ams,as3935", },
  360. { /* sentinel */ },
  361. };
  362. MODULE_DEVICE_TABLE(of, as3935_of_match);
  363. static const struct spi_device_id as3935_id[] = {
  364. {"as3935", 0},
  365. {},
  366. };
  367. MODULE_DEVICE_TABLE(spi, as3935_id);
  368. static struct spi_driver as3935_driver = {
  369. .driver = {
  370. .name = "as3935",
  371. .of_match_table = as3935_of_match,
  372. .pm = pm_sleep_ptr(&as3935_pm_ops),
  373. },
  374. .probe = as3935_probe,
  375. .id_table = as3935_id,
  376. };
  377. module_spi_driver(as3935_driver);
  378. MODULE_AUTHOR("Matt Ranostay <[email protected]>");
  379. MODULE_DESCRIPTION("AS3935 lightning sensor");
  380. MODULE_LICENSE("GPL");