sx9360.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875
  1. // SPDX-License-Identifier: GPL-2.0
  2. /*
  3. * Copyright 2021 Google LLC.
  4. *
  5. * Driver for Semtech's SX9360 capacitive proximity/button solution.
  6. * Based on SX9360 driver and copy of datasheet at:
  7. * https://edit.wpgdadawant.com/uploads/news_file/program/2019/30184/tech_files/program_30184_suggest_other_file.pdf
  8. */
  9. #include <linux/bits.h>
  10. #include <linux/bitfield.h>
  11. #include <linux/delay.h>
  12. #include <linux/i2c.h>
  13. #include <linux/interrupt.h>
  14. #include <linux/kernel.h>
  15. #include <linux/log2.h>
  16. #include <linux/mod_devicetable.h>
  17. #include <linux/module.h>
  18. #include <linux/pm.h>
  19. #include <linux/property.h>
  20. #include <linux/regmap.h>
  21. #include <linux/iio/iio.h>
  22. #include "sx_common.h"
  23. /* Nominal Oscillator Frequency. */
  24. #define SX9360_FOSC_MHZ 4
  25. #define SX9360_FOSC_HZ (SX9360_FOSC_MHZ * 1000000)
  26. /* Register definitions. */
  27. #define SX9360_REG_IRQ_SRC SX_COMMON_REG_IRQ_SRC
  28. #define SX9360_REG_STAT 0x01
  29. #define SX9360_REG_STAT_COMPSTAT_MASK GENMASK(2, 1)
  30. #define SX9360_REG_IRQ_MSK 0x02
  31. #define SX9360_CONVDONE_IRQ BIT(0)
  32. #define SX9360_FAR_IRQ BIT(2)
  33. #define SX9360_CLOSE_IRQ BIT(3)
  34. #define SX9360_REG_IRQ_CFG 0x03
  35. #define SX9360_REG_GNRL_CTRL0 0x10
  36. #define SX9360_REG_GNRL_CTRL0_PHEN_MASK GENMASK(1, 0)
  37. #define SX9360_REG_GNRL_CTRL1 0x11
  38. #define SX9360_REG_GNRL_CTRL1_SCANPERIOD_MASK GENMASK(2, 0)
  39. #define SX9360_REG_GNRL_CTRL2 0x12
  40. #define SX9360_REG_GNRL_CTRL2_PERIOD_102MS 0x32
  41. #define SX9360_REG_GNRL_REG_2_PERIOD_MS(_r) \
  42. (((_r) * 8192) / (SX9360_FOSC_HZ / 1000))
  43. #define SX9360_REG_GNRL_FREQ_2_REG(_f) (((_f) * 8192) / SX9360_FOSC_HZ)
  44. #define SX9360_REG_GNRL_REG_2_FREQ(_r) (SX9360_FOSC_HZ / ((_r) * 8192))
  45. #define SX9360_REG_AFE_CTRL1 0x21
  46. #define SX9360_REG_AFE_CTRL1_RESFILTIN_MASK GENMASK(3, 0)
  47. #define SX9360_REG_AFE_CTRL1_RESFILTIN_0OHMS 0
  48. #define SX9360_REG_AFE_PARAM0_PHR 0x22
  49. #define SX9360_REG_AFE_PARAM1_PHR 0x23
  50. #define SX9360_REG_AFE_PARAM0_PHM 0x24
  51. #define SX9360_REG_AFE_PARAM0_RSVD 0x08
  52. #define SX9360_REG_AFE_PARAM0_RESOLUTION_MASK GENMASK(2, 0)
  53. #define SX9360_REG_AFE_PARAM0_RESOLUTION_128 0x02
  54. #define SX9360_REG_AFE_PARAM1_PHM 0x25
  55. #define SX9360_REG_AFE_PARAM1_AGAIN_PHM_6PF 0x40
  56. #define SX9360_REG_AFE_PARAM1_FREQ_83_33HZ 0x06
  57. #define SX9360_REG_PROX_CTRL0_PHR 0x40
  58. #define SX9360_REG_PROX_CTRL0_PHM 0x41
  59. #define SX9360_REG_PROX_CTRL0_GAIN_MASK GENMASK(5, 3)
  60. #define SX9360_REG_PROX_CTRL0_GAIN_1 0x80
  61. #define SX9360_REG_PROX_CTRL0_RAWFILT_MASK GENMASK(2, 0)
  62. #define SX9360_REG_PROX_CTRL0_RAWFILT_1P50 0x01
  63. #define SX9360_REG_PROX_CTRL1 0x42
  64. #define SX9360_REG_PROX_CTRL1_AVGNEG_THRESH_MASK GENMASK(5, 3)
  65. #define SX9360_REG_PROX_CTRL1_AVGNEG_THRESH_16K 0x20
  66. #define SX9360_REG_PROX_CTRL2 0x43
  67. #define SX9360_REG_PROX_CTRL2_AVGDEB_MASK GENMASK(7, 6)
  68. #define SX9360_REG_PROX_CTRL2_AVGDEB_2SAMPLES 0x40
  69. #define SX9360_REG_PROX_CTRL2_AVGPOS_THRESH_16K 0x20
  70. #define SX9360_REG_PROX_CTRL3 0x44
  71. #define SX9360_REG_PROX_CTRL3_AVGNEG_FILT_MASK GENMASK(5, 3)
  72. #define SX9360_REG_PROX_CTRL3_AVGNEG_FILT_2 0x08
  73. #define SX9360_REG_PROX_CTRL3_AVGPOS_FILT_MASK GENMASK(2, 0)
  74. #define SX9360_REG_PROX_CTRL3_AVGPOS_FILT_256 0x04
  75. #define SX9360_REG_PROX_CTRL4 0x45
  76. #define SX9360_REG_PROX_CTRL4_HYST_MASK GENMASK(5, 4)
  77. #define SX9360_REG_PROX_CTRL4_CLOSE_DEBOUNCE_MASK GENMASK(3, 2)
  78. #define SX9360_REG_PROX_CTRL4_FAR_DEBOUNCE_MASK GENMASK(1, 0)
  79. #define SX9360_REG_PROX_CTRL5 0x46
  80. #define SX9360_REG_PROX_CTRL5_PROXTHRESH_32 0x08
  81. #define SX9360_REG_REF_CORR0 0x60
  82. #define SX9360_REG_REF_CORR1 0x61
  83. #define SX9360_REG_USEFUL_PHR_MSB 0x90
  84. #define SX9360_REG_USEFUL_PHR_LSB 0x91
  85. #define SX9360_REG_OFFSET_PMR_MSB 0x92
  86. #define SX9360_REG_OFFSET_PMR_LSB 0x93
  87. #define SX9360_REG_USEFUL_PHM_MSB 0x94
  88. #define SX9360_REG_USEFUL_PHM_LSB 0x95
  89. #define SX9360_REG_AVG_PHM_MSB 0x96
  90. #define SX9360_REG_AVG_PHM_LSB 0x97
  91. #define SX9360_REG_DIFF_PHM_MSB 0x98
  92. #define SX9360_REG_DIFF_PHM_LSB 0x99
  93. #define SX9360_REG_OFFSET_PHM_MSB 0x9a
  94. #define SX9360_REG_OFFSET_PHM_LSB 0x9b
  95. #define SX9360_REG_USE_FILTER_MSB 0x9a
  96. #define SX9360_REG_USE_FILTER_LSB 0x9b
  97. #define SX9360_REG_RESET 0xcf
  98. /* Write this to REG_RESET to do a soft reset. */
  99. #define SX9360_SOFT_RESET 0xde
  100. #define SX9360_REG_WHOAMI 0xfa
  101. #define SX9360_WHOAMI_VALUE 0x60
  102. #define SX9360_REG_REVISION 0xfe
  103. /* 2 channels, Phase Reference and Measurement. */
  104. #define SX9360_NUM_CHANNELS 2
  105. static const struct iio_chan_spec sx9360_channels[] = {
  106. {
  107. .type = IIO_PROXIMITY,
  108. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
  109. BIT(IIO_CHAN_INFO_HARDWAREGAIN),
  110. .info_mask_shared_by_all = BIT(IIO_CHAN_INFO_SAMP_FREQ),
  111. .info_mask_separate_available =
  112. BIT(IIO_CHAN_INFO_HARDWAREGAIN),
  113. .info_mask_shared_by_all_available =
  114. BIT(IIO_CHAN_INFO_SAMP_FREQ),
  115. .indexed = 1,
  116. .address = SX9360_REG_USEFUL_PHR_MSB,
  117. .channel = 0,
  118. .scan_index = 0,
  119. .scan_type = {
  120. .sign = 's',
  121. .realbits = 12,
  122. .storagebits = 16,
  123. .endianness = IIO_BE,
  124. },
  125. },
  126. {
  127. .type = IIO_PROXIMITY,
  128. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
  129. BIT(IIO_CHAN_INFO_HARDWAREGAIN),
  130. .info_mask_shared_by_all = BIT(IIO_CHAN_INFO_SAMP_FREQ),
  131. .info_mask_separate_available =
  132. BIT(IIO_CHAN_INFO_HARDWAREGAIN),
  133. .info_mask_shared_by_all_available =
  134. BIT(IIO_CHAN_INFO_SAMP_FREQ),
  135. .indexed = 1,
  136. .address = SX9360_REG_USEFUL_PHM_MSB,
  137. .event_spec = sx_common_events,
  138. .num_event_specs = ARRAY_SIZE(sx_common_events),
  139. .channel = 1,
  140. .scan_index = 1,
  141. .scan_type = {
  142. .sign = 's',
  143. .realbits = 12,
  144. .storagebits = 16,
  145. .endianness = IIO_BE,
  146. },
  147. },
  148. IIO_CHAN_SOFT_TIMESTAMP(2),
  149. };
  150. /*
  151. * Each entry contains the integer part (val) and the fractional part, in micro
  152. * seconds. It conforms to the IIO output IIO_VAL_INT_PLUS_MICRO.
  153. *
  154. * The frequency control register holds the period, with a ~2ms increment.
  155. * Therefore the smallest frequency is 4MHz / (2047 * 8192),
  156. * The fastest is 4MHz / 8192.
  157. * The interval is not linear, but given there is 2047 possible value,
  158. * Returns the fake increment of (Max-Min)/2047
  159. */
  160. static const struct {
  161. int val;
  162. int val2;
  163. } sx9360_samp_freq_interval[] = {
  164. { 0, 281250 }, /* 4MHz / (8192 * 2047) */
  165. { 0, 281250 },
  166. { 448, 281250 }, /* 4MHz / 8192 */
  167. };
  168. static const struct regmap_range sx9360_writable_reg_ranges[] = {
  169. /*
  170. * To set COMPSTAT for compensation, even if datasheet says register is
  171. * RO.
  172. */
  173. regmap_reg_range(SX9360_REG_STAT, SX9360_REG_IRQ_CFG),
  174. regmap_reg_range(SX9360_REG_GNRL_CTRL0, SX9360_REG_GNRL_CTRL2),
  175. regmap_reg_range(SX9360_REG_AFE_CTRL1, SX9360_REG_AFE_PARAM1_PHM),
  176. regmap_reg_range(SX9360_REG_PROX_CTRL0_PHR, SX9360_REG_PROX_CTRL5),
  177. regmap_reg_range(SX9360_REG_REF_CORR0, SX9360_REG_REF_CORR1),
  178. regmap_reg_range(SX9360_REG_OFFSET_PMR_MSB, SX9360_REG_OFFSET_PMR_LSB),
  179. regmap_reg_range(SX9360_REG_RESET, SX9360_REG_RESET),
  180. };
  181. static const struct regmap_access_table sx9360_writeable_regs = {
  182. .yes_ranges = sx9360_writable_reg_ranges,
  183. .n_yes_ranges = ARRAY_SIZE(sx9360_writable_reg_ranges),
  184. };
  185. /*
  186. * All allocated registers are readable, so we just list unallocated
  187. * ones.
  188. */
  189. static const struct regmap_range sx9360_non_readable_reg_ranges[] = {
  190. regmap_reg_range(SX9360_REG_IRQ_CFG + 1, SX9360_REG_GNRL_CTRL0 - 1),
  191. regmap_reg_range(SX9360_REG_GNRL_CTRL2 + 1, SX9360_REG_AFE_CTRL1 - 1),
  192. regmap_reg_range(SX9360_REG_AFE_PARAM1_PHM + 1,
  193. SX9360_REG_PROX_CTRL0_PHR - 1),
  194. regmap_reg_range(SX9360_REG_PROX_CTRL5 + 1, SX9360_REG_REF_CORR0 - 1),
  195. regmap_reg_range(SX9360_REG_REF_CORR1 + 1,
  196. SX9360_REG_USEFUL_PHR_MSB - 1),
  197. regmap_reg_range(SX9360_REG_USE_FILTER_LSB + 1, SX9360_REG_RESET - 1),
  198. regmap_reg_range(SX9360_REG_RESET + 1, SX9360_REG_WHOAMI - 1),
  199. regmap_reg_range(SX9360_REG_WHOAMI + 1, SX9360_REG_REVISION - 1),
  200. };
  201. static const struct regmap_access_table sx9360_readable_regs = {
  202. .no_ranges = sx9360_non_readable_reg_ranges,
  203. .n_no_ranges = ARRAY_SIZE(sx9360_non_readable_reg_ranges),
  204. };
  205. static const struct regmap_range sx9360_volatile_reg_ranges[] = {
  206. regmap_reg_range(SX9360_REG_IRQ_SRC, SX9360_REG_STAT),
  207. regmap_reg_range(SX9360_REG_USEFUL_PHR_MSB, SX9360_REG_USE_FILTER_LSB),
  208. regmap_reg_range(SX9360_REG_WHOAMI, SX9360_REG_WHOAMI),
  209. regmap_reg_range(SX9360_REG_REVISION, SX9360_REG_REVISION),
  210. };
  211. static const struct regmap_access_table sx9360_volatile_regs = {
  212. .yes_ranges = sx9360_volatile_reg_ranges,
  213. .n_yes_ranges = ARRAY_SIZE(sx9360_volatile_reg_ranges),
  214. };
  215. static const struct regmap_config sx9360_regmap_config = {
  216. .reg_bits = 8,
  217. .val_bits = 8,
  218. .max_register = SX9360_REG_REVISION,
  219. .cache_type = REGCACHE_RBTREE,
  220. .wr_table = &sx9360_writeable_regs,
  221. .rd_table = &sx9360_readable_regs,
  222. .volatile_table = &sx9360_volatile_regs,
  223. };
  224. static int sx9360_read_prox_data(struct sx_common_data *data,
  225. const struct iio_chan_spec *chan,
  226. __be16 *val)
  227. {
  228. return regmap_bulk_read(data->regmap, chan->address, val, sizeof(*val));
  229. }
  230. /*
  231. * If we have no interrupt support, we have to wait for a scan period
  232. * after enabling a channel to get a result.
  233. */
  234. static int sx9360_wait_for_sample(struct sx_common_data *data)
  235. {
  236. int ret;
  237. __be16 buf;
  238. ret = regmap_bulk_read(data->regmap, SX9360_REG_GNRL_CTRL1,
  239. &buf, sizeof(buf));
  240. if (ret < 0)
  241. return ret;
  242. msleep(SX9360_REG_GNRL_REG_2_PERIOD_MS(be16_to_cpu(buf)));
  243. return 0;
  244. }
  245. static int sx9360_read_gain(struct sx_common_data *data,
  246. const struct iio_chan_spec *chan, int *val)
  247. {
  248. unsigned int reg, regval;
  249. int ret;
  250. reg = SX9360_REG_PROX_CTRL0_PHR + chan->channel;
  251. ret = regmap_read(data->regmap, reg, &regval);
  252. if (ret)
  253. return ret;
  254. *val = 1 << FIELD_GET(SX9360_REG_PROX_CTRL0_GAIN_MASK, regval);
  255. return IIO_VAL_INT;
  256. }
  257. static int sx9360_read_samp_freq(struct sx_common_data *data,
  258. int *val, int *val2)
  259. {
  260. int ret, divisor;
  261. __be16 buf;
  262. ret = regmap_bulk_read(data->regmap, SX9360_REG_GNRL_CTRL1,
  263. &buf, sizeof(buf));
  264. if (ret < 0)
  265. return ret;
  266. divisor = be16_to_cpu(buf);
  267. if (divisor == 0) {
  268. *val = 0;
  269. return IIO_VAL_INT;
  270. }
  271. *val = SX9360_FOSC_HZ;
  272. *val2 = divisor * 8192;
  273. return IIO_VAL_FRACTIONAL;
  274. }
  275. static int sx9360_read_raw(struct iio_dev *indio_dev,
  276. const struct iio_chan_spec *chan,
  277. int *val, int *val2, long mask)
  278. {
  279. struct sx_common_data *data = iio_priv(indio_dev);
  280. int ret;
  281. switch (mask) {
  282. case IIO_CHAN_INFO_RAW:
  283. if (!iio_device_claim_direct(indio_dev))
  284. return -EBUSY;
  285. ret = sx_common_read_proximity(data, chan, val);
  286. iio_device_release_direct(indio_dev);
  287. return ret;
  288. case IIO_CHAN_INFO_HARDWAREGAIN:
  289. if (!iio_device_claim_direct(indio_dev))
  290. return -EBUSY;
  291. ret = sx9360_read_gain(data, chan, val);
  292. iio_device_release_direct(indio_dev);
  293. return ret;
  294. case IIO_CHAN_INFO_SAMP_FREQ:
  295. return sx9360_read_samp_freq(data, val, val2);
  296. default:
  297. return -EINVAL;
  298. }
  299. }
  300. static const char *sx9360_channel_labels[SX9360_NUM_CHANNELS] = {
  301. "reference", "main",
  302. };
  303. static int sx9360_read_label(struct iio_dev *iio_dev, const struct iio_chan_spec *chan,
  304. char *label)
  305. {
  306. return sysfs_emit(label, "%s\n", sx9360_channel_labels[chan->channel]);
  307. }
  308. static const int sx9360_gain_vals[] = { 1, 2, 4, 8 };
  309. static int sx9360_read_avail(struct iio_dev *indio_dev,
  310. struct iio_chan_spec const *chan,
  311. const int **vals, int *type, int *length,
  312. long mask)
  313. {
  314. if (chan->type != IIO_PROXIMITY)
  315. return -EINVAL;
  316. switch (mask) {
  317. case IIO_CHAN_INFO_HARDWAREGAIN:
  318. *type = IIO_VAL_INT;
  319. *length = ARRAY_SIZE(sx9360_gain_vals);
  320. *vals = sx9360_gain_vals;
  321. return IIO_AVAIL_LIST;
  322. case IIO_CHAN_INFO_SAMP_FREQ:
  323. *type = IIO_VAL_INT_PLUS_MICRO;
  324. *length = ARRAY_SIZE(sx9360_samp_freq_interval) * 2;
  325. *vals = (int *)sx9360_samp_freq_interval;
  326. return IIO_AVAIL_RANGE;
  327. default:
  328. return -EINVAL;
  329. }
  330. }
  331. static int sx9360_set_samp_freq(struct sx_common_data *data,
  332. int val, int val2)
  333. {
  334. int reg;
  335. __be16 buf;
  336. reg = val * 8192 / SX9360_FOSC_HZ + val2 * 8192 / (SX9360_FOSC_MHZ);
  337. buf = cpu_to_be16(reg);
  338. guard(mutex)(&data->mutex);
  339. return regmap_bulk_write(data->regmap, SX9360_REG_GNRL_CTRL1, &buf,
  340. sizeof(buf));
  341. }
  342. static int sx9360_read_thresh(struct sx_common_data *data, int *val)
  343. {
  344. unsigned int regval;
  345. int ret;
  346. ret = regmap_read(data->regmap, SX9360_REG_PROX_CTRL5, &regval);
  347. if (ret)
  348. return ret;
  349. if (regval <= 1)
  350. *val = regval;
  351. else
  352. *val = (regval * regval) / 2;
  353. return IIO_VAL_INT;
  354. }
  355. static int sx9360_read_hysteresis(struct sx_common_data *data, int *val)
  356. {
  357. unsigned int regval, pthresh;
  358. int ret;
  359. ret = sx9360_read_thresh(data, &pthresh);
  360. if (ret < 0)
  361. return ret;
  362. ret = regmap_read(data->regmap, SX9360_REG_PROX_CTRL4, &regval);
  363. if (ret)
  364. return ret;
  365. regval = FIELD_GET(SX9360_REG_PROX_CTRL4_HYST_MASK, regval);
  366. if (!regval)
  367. *val = 0;
  368. else
  369. *val = pthresh >> (5 - regval);
  370. return IIO_VAL_INT;
  371. }
  372. static int sx9360_read_far_debounce(struct sx_common_data *data, int *val)
  373. {
  374. unsigned int regval;
  375. int ret;
  376. ret = regmap_read(data->regmap, SX9360_REG_PROX_CTRL4, &regval);
  377. if (ret)
  378. return ret;
  379. regval = FIELD_GET(SX9360_REG_PROX_CTRL4_FAR_DEBOUNCE_MASK, regval);
  380. if (regval)
  381. *val = 1 << regval;
  382. else
  383. *val = 0;
  384. return IIO_VAL_INT;
  385. }
  386. static int sx9360_read_close_debounce(struct sx_common_data *data, int *val)
  387. {
  388. unsigned int regval;
  389. int ret;
  390. ret = regmap_read(data->regmap, SX9360_REG_PROX_CTRL4, &regval);
  391. if (ret)
  392. return ret;
  393. regval = FIELD_GET(SX9360_REG_PROX_CTRL4_CLOSE_DEBOUNCE_MASK, regval);
  394. if (regval)
  395. *val = 1 << regval;
  396. else
  397. *val = 0;
  398. return IIO_VAL_INT;
  399. }
  400. static int sx9360_read_event_val(struct iio_dev *indio_dev,
  401. const struct iio_chan_spec *chan,
  402. enum iio_event_type type,
  403. enum iio_event_direction dir,
  404. enum iio_event_info info, int *val, int *val2)
  405. {
  406. struct sx_common_data *data = iio_priv(indio_dev);
  407. if (chan->type != IIO_PROXIMITY)
  408. return -EINVAL;
  409. switch (info) {
  410. case IIO_EV_INFO_VALUE:
  411. return sx9360_read_thresh(data, val);
  412. case IIO_EV_INFO_PERIOD:
  413. switch (dir) {
  414. case IIO_EV_DIR_RISING:
  415. return sx9360_read_far_debounce(data, val);
  416. case IIO_EV_DIR_FALLING:
  417. return sx9360_read_close_debounce(data, val);
  418. default:
  419. return -EINVAL;
  420. }
  421. case IIO_EV_INFO_HYSTERESIS:
  422. return sx9360_read_hysteresis(data, val);
  423. default:
  424. return -EINVAL;
  425. }
  426. }
  427. static int sx9360_write_thresh(struct sx_common_data *data, int _val)
  428. {
  429. unsigned int val = _val;
  430. if (val >= 1)
  431. val = int_sqrt(2 * val);
  432. if (val > 0xff)
  433. return -EINVAL;
  434. guard(mutex)(&data->mutex);
  435. return regmap_write(data->regmap, SX9360_REG_PROX_CTRL5, val);
  436. }
  437. static int sx9360_write_hysteresis(struct sx_common_data *data, int _val)
  438. {
  439. unsigned int hyst, val = _val;
  440. int ret, pthresh;
  441. ret = sx9360_read_thresh(data, &pthresh);
  442. if (ret < 0)
  443. return ret;
  444. if (val == 0)
  445. hyst = 0;
  446. else if (val >= pthresh >> 2)
  447. hyst = 3;
  448. else if (val >= pthresh >> 3)
  449. hyst = 2;
  450. else if (val >= pthresh >> 4)
  451. hyst = 1;
  452. else
  453. return -EINVAL;
  454. hyst = FIELD_PREP(SX9360_REG_PROX_CTRL4_HYST_MASK, hyst);
  455. guard(mutex)(&data->mutex);
  456. return regmap_update_bits(data->regmap, SX9360_REG_PROX_CTRL4,
  457. SX9360_REG_PROX_CTRL4_HYST_MASK, hyst);
  458. }
  459. static int sx9360_write_far_debounce(struct sx_common_data *data, int _val)
  460. {
  461. unsigned int regval, val = _val;
  462. if (val > 0)
  463. val = ilog2(val);
  464. if (!FIELD_FIT(SX9360_REG_PROX_CTRL4_FAR_DEBOUNCE_MASK, val))
  465. return -EINVAL;
  466. regval = FIELD_PREP(SX9360_REG_PROX_CTRL4_FAR_DEBOUNCE_MASK, val);
  467. guard(mutex)(&data->mutex);
  468. return regmap_update_bits(data->regmap, SX9360_REG_PROX_CTRL4,
  469. SX9360_REG_PROX_CTRL4_FAR_DEBOUNCE_MASK,
  470. regval);
  471. }
  472. static int sx9360_write_close_debounce(struct sx_common_data *data, int _val)
  473. {
  474. unsigned int regval, val = _val;
  475. if (val > 0)
  476. val = ilog2(val);
  477. if (!FIELD_FIT(SX9360_REG_PROX_CTRL4_CLOSE_DEBOUNCE_MASK, val))
  478. return -EINVAL;
  479. regval = FIELD_PREP(SX9360_REG_PROX_CTRL4_CLOSE_DEBOUNCE_MASK, val);
  480. guard(mutex)(&data->mutex);
  481. return regmap_update_bits(data->regmap, SX9360_REG_PROX_CTRL4,
  482. SX9360_REG_PROX_CTRL4_CLOSE_DEBOUNCE_MASK,
  483. regval);
  484. }
  485. static int sx9360_write_event_val(struct iio_dev *indio_dev,
  486. const struct iio_chan_spec *chan,
  487. enum iio_event_type type,
  488. enum iio_event_direction dir,
  489. enum iio_event_info info, int val, int val2)
  490. {
  491. struct sx_common_data *data = iio_priv(indio_dev);
  492. if (chan->type != IIO_PROXIMITY)
  493. return -EINVAL;
  494. switch (info) {
  495. case IIO_EV_INFO_VALUE:
  496. return sx9360_write_thresh(data, val);
  497. case IIO_EV_INFO_PERIOD:
  498. switch (dir) {
  499. case IIO_EV_DIR_RISING:
  500. return sx9360_write_far_debounce(data, val);
  501. case IIO_EV_DIR_FALLING:
  502. return sx9360_write_close_debounce(data, val);
  503. default:
  504. return -EINVAL;
  505. }
  506. case IIO_EV_INFO_HYSTERESIS:
  507. return sx9360_write_hysteresis(data, val);
  508. default:
  509. return -EINVAL;
  510. }
  511. }
  512. static int sx9360_write_gain(struct sx_common_data *data,
  513. const struct iio_chan_spec *chan, int val)
  514. {
  515. unsigned int gain, reg;
  516. gain = ilog2(val);
  517. reg = SX9360_REG_PROX_CTRL0_PHR + chan->channel;
  518. gain = FIELD_PREP(SX9360_REG_PROX_CTRL0_GAIN_MASK, gain);
  519. guard(mutex)(&data->mutex);
  520. return regmap_update_bits(data->regmap, reg,
  521. SX9360_REG_PROX_CTRL0_GAIN_MASK,
  522. gain);
  523. }
  524. static int sx9360_write_raw(struct iio_dev *indio_dev,
  525. const struct iio_chan_spec *chan, int val, int val2,
  526. long mask)
  527. {
  528. struct sx_common_data *data = iio_priv(indio_dev);
  529. switch (mask) {
  530. case IIO_CHAN_INFO_SAMP_FREQ:
  531. return sx9360_set_samp_freq(data, val, val2);
  532. case IIO_CHAN_INFO_HARDWAREGAIN:
  533. return sx9360_write_gain(data, chan, val);
  534. default:
  535. return -EINVAL;
  536. }
  537. }
  538. static const struct sx_common_reg_default sx9360_default_regs[] = {
  539. { SX9360_REG_IRQ_MSK, 0x00 },
  540. { SX9360_REG_IRQ_CFG, 0x00, "irq_cfg" },
  541. /*
  542. * The lower 2 bits should not be set as it enable sensors measurements.
  543. * Turning the detection on before the configuration values are set to
  544. * good values can cause the device to return erroneous readings.
  545. */
  546. { SX9360_REG_GNRL_CTRL0, 0x00, "gnrl_ctrl0" },
  547. { SX9360_REG_GNRL_CTRL1, 0x00, "gnrl_ctrl1" },
  548. { SX9360_REG_GNRL_CTRL2, SX9360_REG_GNRL_CTRL2_PERIOD_102MS, "gnrl_ctrl2" },
  549. { SX9360_REG_AFE_CTRL1, SX9360_REG_AFE_CTRL1_RESFILTIN_0OHMS, "afe_ctrl0" },
  550. { SX9360_REG_AFE_PARAM0_PHR, SX9360_REG_AFE_PARAM0_RSVD |
  551. SX9360_REG_AFE_PARAM0_RESOLUTION_128, "afe_param0_phr" },
  552. { SX9360_REG_AFE_PARAM1_PHR, SX9360_REG_AFE_PARAM1_AGAIN_PHM_6PF |
  553. SX9360_REG_AFE_PARAM1_FREQ_83_33HZ, "afe_param1_phr" },
  554. { SX9360_REG_AFE_PARAM0_PHM, SX9360_REG_AFE_PARAM0_RSVD |
  555. SX9360_REG_AFE_PARAM0_RESOLUTION_128, "afe_param0_phm" },
  556. { SX9360_REG_AFE_PARAM1_PHM, SX9360_REG_AFE_PARAM1_AGAIN_PHM_6PF |
  557. SX9360_REG_AFE_PARAM1_FREQ_83_33HZ, "afe_param1_phm" },
  558. { SX9360_REG_PROX_CTRL0_PHR, SX9360_REG_PROX_CTRL0_GAIN_1 |
  559. SX9360_REG_PROX_CTRL0_RAWFILT_1P50, "prox_ctrl0_phr" },
  560. { SX9360_REG_PROX_CTRL0_PHM, SX9360_REG_PROX_CTRL0_GAIN_1 |
  561. SX9360_REG_PROX_CTRL0_RAWFILT_1P50, "prox_ctrl0_phm" },
  562. { SX9360_REG_PROX_CTRL1, SX9360_REG_PROX_CTRL1_AVGNEG_THRESH_16K, "prox_ctrl1" },
  563. { SX9360_REG_PROX_CTRL2, SX9360_REG_PROX_CTRL2_AVGDEB_2SAMPLES |
  564. SX9360_REG_PROX_CTRL2_AVGPOS_THRESH_16K, "prox_ctrl2" },
  565. { SX9360_REG_PROX_CTRL3, SX9360_REG_PROX_CTRL3_AVGNEG_FILT_2 |
  566. SX9360_REG_PROX_CTRL3_AVGPOS_FILT_256, "prox_ctrl3" },
  567. { SX9360_REG_PROX_CTRL4, 0x00, "prox_ctrl4" },
  568. { SX9360_REG_PROX_CTRL5, SX9360_REG_PROX_CTRL5_PROXTHRESH_32, "prox_ctrl5" },
  569. };
  570. /* Activate all channels and perform an initial compensation. */
  571. static int sx9360_init_compensation(struct iio_dev *indio_dev)
  572. {
  573. struct sx_common_data *data = iio_priv(indio_dev);
  574. unsigned int val;
  575. int ret;
  576. /* run the compensation phase on all channels */
  577. ret = regmap_set_bits(data->regmap, SX9360_REG_STAT,
  578. SX9360_REG_STAT_COMPSTAT_MASK);
  579. if (ret)
  580. return ret;
  581. return regmap_read_poll_timeout(data->regmap, SX9360_REG_STAT, val,
  582. !(val & SX9360_REG_STAT_COMPSTAT_MASK),
  583. 20000, 2000000);
  584. }
  585. static const struct sx_common_reg_default *
  586. sx9360_get_default_reg(struct device *dev, int idx,
  587. struct sx_common_reg_default *reg_def)
  588. {
  589. u32 raw = 0, pos = 0;
  590. int ret;
  591. memcpy(reg_def, &sx9360_default_regs[idx], sizeof(*reg_def));
  592. switch (reg_def->reg) {
  593. case SX9360_REG_AFE_CTRL1:
  594. ret = device_property_read_u32(dev,
  595. "semtech,input-precharge-resistor-ohms",
  596. &raw);
  597. if (ret)
  598. break;
  599. reg_def->def &= ~SX9360_REG_AFE_CTRL1_RESFILTIN_MASK;
  600. reg_def->def |= FIELD_PREP(SX9360_REG_AFE_CTRL1_RESFILTIN_MASK,
  601. raw / 2000);
  602. break;
  603. case SX9360_REG_AFE_PARAM0_PHR:
  604. case SX9360_REG_AFE_PARAM0_PHM:
  605. ret = device_property_read_u32(dev, "semtech,resolution", &raw);
  606. if (ret)
  607. break;
  608. raw = ilog2(raw) - 3;
  609. reg_def->def &= ~SX9360_REG_AFE_PARAM0_RESOLUTION_MASK;
  610. reg_def->def |= FIELD_PREP(SX9360_REG_AFE_PARAM0_RESOLUTION_MASK, raw);
  611. break;
  612. case SX9360_REG_PROX_CTRL0_PHR:
  613. case SX9360_REG_PROX_CTRL0_PHM:
  614. ret = device_property_read_u32(dev, "semtech,proxraw-strength", &raw);
  615. if (ret)
  616. break;
  617. reg_def->def &= ~SX9360_REG_PROX_CTRL0_RAWFILT_MASK;
  618. reg_def->def |= FIELD_PREP(SX9360_REG_PROX_CTRL0_RAWFILT_MASK, raw);
  619. break;
  620. case SX9360_REG_PROX_CTRL3:
  621. ret = device_property_read_u32(dev, "semtech,avg-pos-strength",
  622. &pos);
  623. if (ret)
  624. break;
  625. /* Powers of 2, except for a gap between 16 and 64 */
  626. raw = clamp(ilog2(pos), 3, 11) - (pos >= 32 ? 4 : 3);
  627. reg_def->def &= ~SX9360_REG_PROX_CTRL3_AVGPOS_FILT_MASK;
  628. reg_def->def |= FIELD_PREP(SX9360_REG_PROX_CTRL3_AVGPOS_FILT_MASK, raw);
  629. break;
  630. }
  631. return reg_def;
  632. }
  633. static int sx9360_check_whoami(struct device *dev, struct iio_dev *indio_dev)
  634. {
  635. /*
  636. * Only one sensor for this driver. Assuming the device tree
  637. * is correct, just set the sensor name.
  638. */
  639. indio_dev->name = "sx9360";
  640. return 0;
  641. }
  642. static const struct sx_common_chip_info sx9360_chip_info = {
  643. .reg_stat = SX9360_REG_STAT,
  644. .reg_irq_msk = SX9360_REG_IRQ_MSK,
  645. .reg_enable_chan = SX9360_REG_GNRL_CTRL0,
  646. .reg_reset = SX9360_REG_RESET,
  647. .mask_enable_chan = SX9360_REG_GNRL_CTRL0_PHEN_MASK,
  648. .stat_offset = 2,
  649. .num_channels = SX9360_NUM_CHANNELS,
  650. .num_default_regs = ARRAY_SIZE(sx9360_default_regs),
  651. .ops = {
  652. .read_prox_data = sx9360_read_prox_data,
  653. .check_whoami = sx9360_check_whoami,
  654. .init_compensation = sx9360_init_compensation,
  655. .wait_for_sample = sx9360_wait_for_sample,
  656. .get_default_reg = sx9360_get_default_reg,
  657. },
  658. .iio_channels = sx9360_channels,
  659. .num_iio_channels = ARRAY_SIZE(sx9360_channels),
  660. .iio_info = {
  661. .read_raw = sx9360_read_raw,
  662. .read_avail = sx9360_read_avail,
  663. .read_label = sx9360_read_label,
  664. .read_event_value = sx9360_read_event_val,
  665. .write_event_value = sx9360_write_event_val,
  666. .write_raw = sx9360_write_raw,
  667. .read_event_config = sx_common_read_event_config,
  668. .write_event_config = sx_common_write_event_config,
  669. },
  670. };
  671. static int sx9360_probe(struct i2c_client *client)
  672. {
  673. return sx_common_probe(client, &sx9360_chip_info, &sx9360_regmap_config);
  674. }
  675. static int sx9360_suspend(struct device *dev)
  676. {
  677. struct sx_common_data *data = iio_priv(dev_get_drvdata(dev));
  678. unsigned int regval;
  679. int ret;
  680. disable_irq_nosync(data->client->irq);
  681. guard(mutex)(&data->mutex);
  682. ret = regmap_read(data->regmap, SX9360_REG_GNRL_CTRL0, &regval);
  683. if (ret < 0)
  684. return ret;
  685. data->suspend_ctrl =
  686. FIELD_GET(SX9360_REG_GNRL_CTRL0_PHEN_MASK, regval);
  687. /* Disable all phases, send the device to sleep. */
  688. return regmap_write(data->regmap, SX9360_REG_GNRL_CTRL0, 0);
  689. }
  690. static int sx9360_resume(struct device *dev)
  691. {
  692. struct sx_common_data *data = iio_priv(dev_get_drvdata(dev));
  693. scoped_guard(mutex, &data->mutex) {
  694. int ret = regmap_update_bits(data->regmap,
  695. SX9360_REG_GNRL_CTRL0,
  696. SX9360_REG_GNRL_CTRL0_PHEN_MASK,
  697. data->suspend_ctrl);
  698. if (ret)
  699. return ret;
  700. }
  701. enable_irq(data->client->irq);
  702. return 0;
  703. }
  704. static DEFINE_SIMPLE_DEV_PM_OPS(sx9360_pm_ops, sx9360_suspend, sx9360_resume);
  705. static const struct acpi_device_id sx9360_acpi_match[] = {
  706. { "STH9360", SX9360_WHOAMI_VALUE },
  707. { "SAMM0208", SX9360_WHOAMI_VALUE },
  708. { }
  709. };
  710. MODULE_DEVICE_TABLE(acpi, sx9360_acpi_match);
  711. static const struct of_device_id sx9360_of_match[] = {
  712. { .compatible = "semtech,sx9360", (void *)SX9360_WHOAMI_VALUE },
  713. { }
  714. };
  715. MODULE_DEVICE_TABLE(of, sx9360_of_match);
  716. static const struct i2c_device_id sx9360_id[] = {
  717. {"sx9360", SX9360_WHOAMI_VALUE },
  718. { }
  719. };
  720. MODULE_DEVICE_TABLE(i2c, sx9360_id);
  721. static struct i2c_driver sx9360_driver = {
  722. .driver = {
  723. .name = "sx9360",
  724. .acpi_match_table = sx9360_acpi_match,
  725. .of_match_table = sx9360_of_match,
  726. .pm = pm_sleep_ptr(&sx9360_pm_ops),
  727. /*
  728. * Lots of i2c transfers in probe + over 200 ms waiting in
  729. * sx9360_init_compensation() mean a slow probe; prefer async
  730. * so we don't delay boot if we're builtin to the kernel.
  731. */
  732. .probe_type = PROBE_PREFER_ASYNCHRONOUS,
  733. },
  734. .probe = sx9360_probe,
  735. .id_table = sx9360_id,
  736. };
  737. module_i2c_driver(sx9360_driver);
  738. MODULE_AUTHOR("Gwendal Grignou <gwendal@chromium.org>");
  739. MODULE_DESCRIPTION("Driver for Semtech SX9360 proximity sensor");
  740. MODULE_LICENSE("GPL v2");
  741. MODULE_IMPORT_NS("SEMTECH_PROX");