mlx90635.c 30 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097
  1. // SPDX-License-Identifier: GPL-2.0
  2. /*
  3. * mlx90635.c - Melexis MLX90635 contactless IR temperature sensor
  4. *
  5. * Copyright (c) 2023 Melexis <cmo@melexis.com>
  6. *
  7. * Driver for the Melexis MLX90635 I2C 16-bit IR thermopile sensor
  8. */
  9. #include <linux/bitfield.h>
  10. #include <linux/delay.h>
  11. #include <linux/device.h>
  12. #include <linux/err.h>
  13. #include <linux/gpio/consumer.h>
  14. #include <linux/i2c.h>
  15. #include <linux/iopoll.h>
  16. #include <linux/jiffies.h>
  17. #include <linux/kernel.h>
  18. #include <linux/limits.h>
  19. #include <linux/mod_devicetable.h>
  20. #include <linux/module.h>
  21. #include <linux/math64.h>
  22. #include <linux/pm_runtime.h>
  23. #include <linux/regmap.h>
  24. #include <linux/regulator/consumer.h>
  25. #include <linux/iio/iio.h>
  26. /* Memory sections addresses */
  27. #define MLX90635_ADDR_RAM 0x0000 /* Start address of ram */
  28. #define MLX90635_ADDR_EEPROM 0x0018 /* Start address of user eeprom */
  29. /* EEPROM addresses - used at startup */
  30. #define MLX90635_EE_I2C_CFG 0x0018 /* I2C address register initial value */
  31. #define MLX90635_EE_CTRL1 0x001A /* Control register1 initial value */
  32. #define MLX90635_EE_CTRL2 0x001C /* Control register2 initial value */
  33. #define MLX90635_EE_Ha 0x001E /* Ha customer calib value reg 16bit */
  34. #define MLX90635_EE_Hb 0x0020 /* Hb customer calib value reg 16bit */
  35. #define MLX90635_EE_Fa 0x0026 /* Fa calibration register 32bit */
  36. #define MLX90635_EE_FASCALE 0x002A /* Scaling coefficient for Fa register 16bit */
  37. #define MLX90635_EE_Ga 0x002C /* Ga calibration register 16bit */
  38. #define MLX90635_EE_Fb 0x002E /* Fb calibration register 16bit */
  39. #define MLX90635_EE_Ea 0x0030 /* Ea calibration register 32bit */
  40. #define MLX90635_EE_Eb 0x0034 /* Eb calibration register 32bit */
  41. #define MLX90635_EE_P_G 0x0038 /* P_G calibration register 16bit */
  42. #define MLX90635_EE_P_O 0x003A /* P_O calibration register 16bit */
  43. #define MLX90635_EE_Aa 0x003C /* Aa calibration register 16bit */
  44. #define MLX90635_EE_VERSION 0x003E /* Version bits 4:7 and 12:15 */
  45. #define MLX90635_EE_Gb 0x0040 /* Gb calibration register 16bit */
  46. /* Device status register - volatile */
  47. #define MLX90635_REG_STATUS 0x0000
  48. #define MLX90635_STAT_BUSY BIT(6) /* Device busy indicator */
  49. #define MLX90635_STAT_BRST BIT(5) /* Brown out reset indicator */
  50. #define MLX90635_STAT_CYCLE_POS GENMASK(4, 2) /* Data position */
  51. #define MLX90635_STAT_END_CONV BIT(1) /* End of conversion indicator */
  52. #define MLX90635_STAT_DATA_RDY BIT(0) /* Data ready indicator */
  53. /* EEPROM control register address - volatile */
  54. #define MLX90635_REG_EE 0x000C
  55. #define MLX90635_EE_ACTIVE BIT(4) /* Power-on EEPROM */
  56. #define MLX90635_EE_BUSY_MASK BIT(15)
  57. #define MLX90635_REG_CMD 0x0010 /* Command register address */
  58. /* Control register1 address - volatile */
  59. #define MLX90635_REG_CTRL1 0x0014
  60. #define MLX90635_CTRL1_REFRESH_RATE_MASK GENMASK(2, 0)
  61. #define MLX90635_CTRL1_RES_CTRL_MASK GENMASK(4, 3)
  62. #define MLX90635_CTRL1_TABLE_MASK BIT(15) /* Table select */
  63. /* Control register2 address - volatile */
  64. #define MLX90635_REG_CTRL2 0x0016
  65. #define MLX90635_CTRL2_BURST_CNT_MASK GENMASK(10, 6) /* Burst count */
  66. #define MLX90635_CTRL2_MODE_MASK GENMASK(12, 11) /* Power mode */
  67. #define MLX90635_CTRL2_SOB_MASK BIT(15)
  68. /* PowerModes statuses */
  69. #define MLX90635_PWR_STATUS_HALT 0
  70. #define MLX90635_PWR_STATUS_SLEEP_STEP 1
  71. #define MLX90635_PWR_STATUS_STEP 2
  72. #define MLX90635_PWR_STATUS_CONTINUOUS 3
  73. /* Measurement data addresses */
  74. #define MLX90635_RESULT_1 0x0002
  75. #define MLX90635_RESULT_2 0x0004
  76. #define MLX90635_RESULT_3 0x0006
  77. #define MLX90635_RESULT_4 0x0008
  78. #define MLX90635_RESULT_5 0x000A
  79. /* Timings (ms) */
  80. #define MLX90635_TIMING_RST_MIN 200 /* Minimum time after addressed reset command */
  81. #define MLX90635_TIMING_RST_MAX 250 /* Maximum time after addressed reset command */
  82. #define MLX90635_TIMING_POLLING 10000 /* Time between bit polling*/
  83. #define MLX90635_TIMING_EE_ACTIVE_MIN 100 /* Minimum time after activating the EEPROM for read */
  84. #define MLX90635_TIMING_EE_ACTIVE_MAX 150 /* Maximum time after activating the EEPROM for read */
  85. /* Magic constants */
  86. #define MLX90635_ID_DSPv1 0x01 /* EEPROM DSP version */
  87. #define MLX90635_RESET_CMD 0x0006 /* Reset sensor (address or global) */
  88. #define MLX90635_MAX_MEAS_NUM 31 /* Maximum number of measurements in list */
  89. #define MLX90635_PTAT_DIV 12 /* Used to divide the PTAT value in pre-processing */
  90. #define MLX90635_IR_DIV 24 /* Used to divide the IR value in pre-processing */
  91. #define MLX90635_SLEEP_DELAY_MS 6000 /* Autosleep delay */
  92. #define MLX90635_MEAS_MAX_TIME 2000 /* Max measurement time in ms for the lowest refresh rate */
  93. #define MLX90635_READ_RETRIES 100 /* Number of read retries before quitting with timeout error */
  94. #define MLX90635_VERSION_MASK (GENMASK(15, 12) | GENMASK(7, 4))
  95. #define MLX90635_DSP_VERSION(reg) (((reg & GENMASK(14, 12)) >> 9) | ((reg & GENMASK(6, 4)) >> 4))
  96. #define MLX90635_DSP_FIXED BIT(15)
  97. /**
  98. * struct mlx90635_data - private data for the MLX90635 device
  99. * @client: I2C client of the device
  100. * @lock: Internal mutex because multiple reads are needed for single triggered
  101. * measurement to ensure data consistency
  102. * @regmap: Regmap of the device registers
  103. * @regmap_ee: Regmap of the device EEPROM which can be cached
  104. * @emissivity: Object emissivity from 0 to 1000 where 1000 = 1
  105. * @regulator: Regulator of the device
  106. * @powerstatus: Current POWER status of the device
  107. * @interaction_ts: Timestamp of the last temperature read that is used
  108. * for power management in jiffies
  109. */
  110. struct mlx90635_data {
  111. struct i2c_client *client;
  112. struct mutex lock;
  113. struct regmap *regmap;
  114. struct regmap *regmap_ee;
  115. u16 emissivity;
  116. struct regulator *regulator;
  117. int powerstatus;
  118. unsigned long interaction_ts;
  119. };
  120. static const struct regmap_range mlx90635_volatile_reg_range[] = {
  121. regmap_reg_range(MLX90635_REG_STATUS, MLX90635_REG_STATUS),
  122. regmap_reg_range(MLX90635_RESULT_1, MLX90635_RESULT_5),
  123. regmap_reg_range(MLX90635_REG_EE, MLX90635_REG_EE),
  124. regmap_reg_range(MLX90635_REG_CMD, MLX90635_REG_CMD),
  125. regmap_reg_range(MLX90635_REG_CTRL1, MLX90635_REG_CTRL2),
  126. };
  127. static const struct regmap_access_table mlx90635_volatile_regs_tbl = {
  128. .yes_ranges = mlx90635_volatile_reg_range,
  129. .n_yes_ranges = ARRAY_SIZE(mlx90635_volatile_reg_range),
  130. };
  131. static const struct regmap_range mlx90635_read_reg_range[] = {
  132. regmap_reg_range(MLX90635_REG_STATUS, MLX90635_REG_STATUS),
  133. regmap_reg_range(MLX90635_RESULT_1, MLX90635_RESULT_5),
  134. regmap_reg_range(MLX90635_REG_EE, MLX90635_REG_EE),
  135. regmap_reg_range(MLX90635_REG_CMD, MLX90635_REG_CMD),
  136. regmap_reg_range(MLX90635_REG_CTRL1, MLX90635_REG_CTRL2),
  137. };
  138. static const struct regmap_access_table mlx90635_readable_regs_tbl = {
  139. .yes_ranges = mlx90635_read_reg_range,
  140. .n_yes_ranges = ARRAY_SIZE(mlx90635_read_reg_range),
  141. };
  142. static const struct regmap_range mlx90635_no_write_reg_range[] = {
  143. regmap_reg_range(MLX90635_RESULT_1, MLX90635_RESULT_5),
  144. };
  145. static const struct regmap_access_table mlx90635_writeable_regs_tbl = {
  146. .no_ranges = mlx90635_no_write_reg_range,
  147. .n_no_ranges = ARRAY_SIZE(mlx90635_no_write_reg_range),
  148. };
  149. static const struct regmap_config mlx90635_regmap = {
  150. .name = "mlx90635-registers",
  151. .reg_stride = 1,
  152. .reg_bits = 16,
  153. .val_bits = 16,
  154. .volatile_table = &mlx90635_volatile_regs_tbl,
  155. .rd_table = &mlx90635_readable_regs_tbl,
  156. .wr_table = &mlx90635_writeable_regs_tbl,
  157. .use_single_read = true,
  158. .use_single_write = true,
  159. .can_multi_write = false,
  160. .reg_format_endian = REGMAP_ENDIAN_BIG,
  161. .val_format_endian = REGMAP_ENDIAN_BIG,
  162. .cache_type = REGCACHE_RBTREE,
  163. };
  164. static const struct regmap_range mlx90635_read_ee_range[] = {
  165. regmap_reg_range(MLX90635_EE_I2C_CFG, MLX90635_EE_CTRL2),
  166. regmap_reg_range(MLX90635_EE_Ha, MLX90635_EE_Gb),
  167. };
  168. static const struct regmap_access_table mlx90635_readable_ees_tbl = {
  169. .yes_ranges = mlx90635_read_ee_range,
  170. .n_yes_ranges = ARRAY_SIZE(mlx90635_read_ee_range),
  171. };
  172. static const struct regmap_range mlx90635_no_write_ee_range[] = {
  173. regmap_reg_range(MLX90635_ADDR_EEPROM, MLX90635_EE_Gb),
  174. };
  175. static const struct regmap_access_table mlx90635_writeable_ees_tbl = {
  176. .no_ranges = mlx90635_no_write_ee_range,
  177. .n_no_ranges = ARRAY_SIZE(mlx90635_no_write_ee_range),
  178. };
  179. static const struct regmap_config mlx90635_regmap_ee = {
  180. .name = "mlx90635-eeprom",
  181. .reg_stride = 1,
  182. .reg_bits = 16,
  183. .val_bits = 16,
  184. .volatile_table = NULL,
  185. .rd_table = &mlx90635_readable_ees_tbl,
  186. .wr_table = &mlx90635_writeable_ees_tbl,
  187. .use_single_read = true,
  188. .use_single_write = true,
  189. .can_multi_write = false,
  190. .reg_format_endian = REGMAP_ENDIAN_BIG,
  191. .val_format_endian = REGMAP_ENDIAN_BIG,
  192. .cache_type = REGCACHE_RBTREE,
  193. };
  194. /**
  195. * mlx90635_reset_delay() - Give the mlx90635 some time to reset properly
  196. * If this is not done, the following I2C command(s) will not be accepted.
  197. */
  198. static void mlx90635_reset_delay(void)
  199. {
  200. usleep_range(MLX90635_TIMING_RST_MIN, MLX90635_TIMING_RST_MAX);
  201. }
  202. static int mlx90635_pwr_sleep_step(struct mlx90635_data *data)
  203. {
  204. int ret;
  205. if (data->powerstatus == MLX90635_PWR_STATUS_SLEEP_STEP)
  206. return 0;
  207. ret = regmap_write_bits(data->regmap, MLX90635_REG_CTRL2, MLX90635_CTRL2_MODE_MASK,
  208. FIELD_PREP(MLX90635_CTRL2_MODE_MASK, MLX90635_PWR_STATUS_SLEEP_STEP));
  209. if (ret < 0)
  210. return ret;
  211. data->powerstatus = MLX90635_PWR_STATUS_SLEEP_STEP;
  212. return 0;
  213. }
  214. static int mlx90635_pwr_continuous(struct mlx90635_data *data)
  215. {
  216. int ret;
  217. if (data->powerstatus == MLX90635_PWR_STATUS_CONTINUOUS)
  218. return 0;
  219. ret = regmap_write_bits(data->regmap, MLX90635_REG_CTRL2, MLX90635_CTRL2_MODE_MASK,
  220. FIELD_PREP(MLX90635_CTRL2_MODE_MASK, MLX90635_PWR_STATUS_CONTINUOUS));
  221. if (ret < 0)
  222. return ret;
  223. data->powerstatus = MLX90635_PWR_STATUS_CONTINUOUS;
  224. return 0;
  225. }
  226. static int mlx90635_read_ee_register(struct regmap *regmap, u16 reg_lsb,
  227. s32 *reg_value)
  228. {
  229. unsigned int read;
  230. u32 value;
  231. int ret;
  232. ret = regmap_read(regmap, reg_lsb + 2, &read);
  233. if (ret < 0)
  234. return ret;
  235. value = read;
  236. ret = regmap_read(regmap, reg_lsb, &read);
  237. if (ret < 0)
  238. return ret;
  239. *reg_value = (read << 16) | (value & 0xffff);
  240. return 0;
  241. }
  242. static int mlx90635_read_ee_ambient(struct regmap *regmap, s16 *PG, s16 *PO, s16 *Gb)
  243. {
  244. unsigned int read_tmp;
  245. int ret;
  246. ret = regmap_read(regmap, MLX90635_EE_P_O, &read_tmp);
  247. if (ret < 0)
  248. return ret;
  249. *PO = (s16)read_tmp;
  250. ret = regmap_read(regmap, MLX90635_EE_P_G, &read_tmp);
  251. if (ret < 0)
  252. return ret;
  253. *PG = (s16)read_tmp;
  254. ret = regmap_read(regmap, MLX90635_EE_Gb, &read_tmp);
  255. if (ret < 0)
  256. return ret;
  257. *Gb = (u16)read_tmp;
  258. return 0;
  259. }
  260. static int mlx90635_read_ee_object(struct regmap *regmap, u32 *Ea, u32 *Eb, u32 *Fa, s16 *Fb,
  261. s16 *Ga, s16 *Gb, s16 *Ha, s16 *Hb, u16 *Fa_scale)
  262. {
  263. unsigned int read_tmp;
  264. int ret;
  265. ret = mlx90635_read_ee_register(regmap, MLX90635_EE_Ea, Ea);
  266. if (ret < 0)
  267. return ret;
  268. ret = mlx90635_read_ee_register(regmap, MLX90635_EE_Eb, Eb);
  269. if (ret < 0)
  270. return ret;
  271. ret = mlx90635_read_ee_register(regmap, MLX90635_EE_Fa, Fa);
  272. if (ret < 0)
  273. return ret;
  274. ret = regmap_read(regmap, MLX90635_EE_Ha, &read_tmp);
  275. if (ret < 0)
  276. return ret;
  277. *Ha = (s16)read_tmp;
  278. ret = regmap_read(regmap, MLX90635_EE_Hb, &read_tmp);
  279. if (ret < 0)
  280. return ret;
  281. *Hb = (s16)read_tmp;
  282. ret = regmap_read(regmap, MLX90635_EE_Ga, &read_tmp);
  283. if (ret < 0)
  284. return ret;
  285. *Ga = (s16)read_tmp;
  286. ret = regmap_read(regmap, MLX90635_EE_Gb, &read_tmp);
  287. if (ret < 0)
  288. return ret;
  289. *Gb = (s16)read_tmp;
  290. ret = regmap_read(regmap, MLX90635_EE_Fb, &read_tmp);
  291. if (ret < 0)
  292. return ret;
  293. *Fb = (s16)read_tmp;
  294. ret = regmap_read(regmap, MLX90635_EE_FASCALE, &read_tmp);
  295. if (ret < 0)
  296. return ret;
  297. *Fa_scale = (u16)read_tmp;
  298. return 0;
  299. }
  300. static int mlx90635_calculate_dataset_ready_time(struct mlx90635_data *data, int *refresh_time)
  301. {
  302. unsigned int reg;
  303. int ret;
  304. ret = regmap_read(data->regmap, MLX90635_REG_CTRL1, &reg);
  305. if (ret < 0)
  306. return ret;
  307. *refresh_time = 2 * (MLX90635_MEAS_MAX_TIME >> FIELD_GET(MLX90635_CTRL1_REFRESH_RATE_MASK, reg)) + 80;
  308. return 0;
  309. }
  310. static int mlx90635_perform_measurement_burst(struct mlx90635_data *data)
  311. {
  312. unsigned int reg_status;
  313. int refresh_time;
  314. int ret;
  315. ret = regmap_write_bits(data->regmap, MLX90635_REG_STATUS,
  316. MLX90635_STAT_END_CONV, MLX90635_STAT_END_CONV);
  317. if (ret < 0)
  318. return ret;
  319. ret = mlx90635_calculate_dataset_ready_time(data, &refresh_time);
  320. if (ret < 0)
  321. return ret;
  322. ret = regmap_write_bits(data->regmap, MLX90635_REG_CTRL2,
  323. FIELD_PREP(MLX90635_CTRL2_SOB_MASK, 1),
  324. FIELD_PREP(MLX90635_CTRL2_SOB_MASK, 1));
  325. if (ret < 0)
  326. return ret;
  327. msleep(refresh_time); /* Wait minimum time for dataset to be ready */
  328. ret = regmap_read_poll_timeout(data->regmap, MLX90635_REG_STATUS, reg_status,
  329. (!(reg_status & MLX90635_STAT_END_CONV)) == 0,
  330. MLX90635_TIMING_POLLING, MLX90635_READ_RETRIES * 10000);
  331. if (ret < 0) {
  332. dev_err(&data->client->dev, "data not ready");
  333. return -ETIMEDOUT;
  334. }
  335. return 0;
  336. }
  337. static int mlx90635_read_ambient_raw(struct regmap *regmap,
  338. s16 *ambient_new_raw, s16 *ambient_old_raw)
  339. {
  340. unsigned int read_tmp;
  341. int ret;
  342. ret = regmap_read(regmap, MLX90635_RESULT_2, &read_tmp);
  343. if (ret < 0)
  344. return ret;
  345. *ambient_new_raw = (s16)read_tmp;
  346. ret = regmap_read(regmap, MLX90635_RESULT_3, &read_tmp);
  347. if (ret < 0)
  348. return ret;
  349. *ambient_old_raw = (s16)read_tmp;
  350. return 0;
  351. }
  352. static int mlx90635_read_object_raw(struct regmap *regmap, s16 *object_raw)
  353. {
  354. unsigned int read_tmp;
  355. s16 read;
  356. int ret;
  357. ret = regmap_read(regmap, MLX90635_RESULT_1, &read_tmp);
  358. if (ret < 0)
  359. return ret;
  360. read = (s16)read_tmp;
  361. ret = regmap_read(regmap, MLX90635_RESULT_4, &read_tmp);
  362. if (ret < 0)
  363. return ret;
  364. *object_raw = (read - (s16)read_tmp) / 2;
  365. return 0;
  366. }
  367. static int mlx90635_read_all_channel(struct mlx90635_data *data,
  368. s16 *ambient_new_raw, s16 *ambient_old_raw,
  369. s16 *object_raw)
  370. {
  371. int ret;
  372. mutex_lock(&data->lock);
  373. if (data->powerstatus == MLX90635_PWR_STATUS_SLEEP_STEP) {
  374. /* Trigger measurement in Sleep Step mode */
  375. ret = mlx90635_perform_measurement_burst(data);
  376. if (ret < 0)
  377. goto read_unlock;
  378. }
  379. ret = mlx90635_read_ambient_raw(data->regmap, ambient_new_raw,
  380. ambient_old_raw);
  381. if (ret < 0)
  382. goto read_unlock;
  383. ret = mlx90635_read_object_raw(data->regmap, object_raw);
  384. read_unlock:
  385. mutex_unlock(&data->lock);
  386. return ret;
  387. }
  388. static s64 mlx90635_preprocess_temp_amb(s16 ambient_new_raw,
  389. s16 ambient_old_raw, s16 Gb)
  390. {
  391. s64 VR_Ta, kGb, tmp;
  392. kGb = ((s64)Gb * 1000LL) >> 10ULL;
  393. VR_Ta = (s64)ambient_old_raw * 1000000LL +
  394. kGb * div64_s64(((s64)ambient_new_raw * 1000LL),
  395. (MLX90635_PTAT_DIV));
  396. tmp = div64_s64(
  397. div64_s64(((s64)ambient_new_raw * 1000000000000LL),
  398. (MLX90635_PTAT_DIV)), VR_Ta);
  399. return div64_s64(tmp << 19ULL, 1000LL);
  400. }
  401. static s64 mlx90635_preprocess_temp_obj(s16 object_raw,
  402. s16 ambient_new_raw,
  403. s16 ambient_old_raw, s16 Gb)
  404. {
  405. s64 VR_IR, kGb, tmp;
  406. kGb = ((s64)Gb * 1000LL) >> 10ULL;
  407. VR_IR = (s64)ambient_old_raw * 1000000LL +
  408. kGb * (div64_s64((s64)ambient_new_raw * 1000LL,
  409. MLX90635_PTAT_DIV));
  410. tmp = div64_s64(
  411. div64_s64((s64)(object_raw * 1000000LL),
  412. MLX90635_IR_DIV) * 1000000LL,
  413. VR_IR);
  414. return div64_s64((tmp << 19ULL), 1000LL);
  415. }
  416. static s32 mlx90635_calc_temp_ambient(s16 ambient_new_raw, s16 ambient_old_raw,
  417. u16 P_G, u16 P_O, s16 Gb)
  418. {
  419. s64 kPG, kPO, AMB;
  420. AMB = mlx90635_preprocess_temp_amb(ambient_new_raw, ambient_old_raw,
  421. Gb);
  422. kPG = ((s64)P_G * 1000000LL) >> 9ULL;
  423. kPO = AMB - (((s64)P_O * 1000LL) >> 1ULL);
  424. return 30 * 1000LL + div64_s64(kPO * 1000000LL, kPG);
  425. }
  426. static s32 mlx90635_calc_temp_object_iteration(s32 prev_object_temp, s64 object,
  427. s64 TAdut, s64 TAdut4, s16 Ga,
  428. u32 Fa, u16 Fa_scale, s16 Fb,
  429. s16 Ha, s16 Hb, u16 emissivity)
  430. {
  431. s64 calcedGa, calcedGb, calcedFa, Alpha_corr;
  432. s64 Ha_customer, Hb_customer;
  433. Ha_customer = ((s64)Ha * 1000000LL) >> 14ULL;
  434. Hb_customer = ((s64)Hb * 100) >> 10ULL;
  435. calcedGa = ((s64)((s64)Ga * (prev_object_temp - 35 * 1000LL)
  436. * 1000LL)) >> 24LL;
  437. calcedGb = ((s64)(Fb * (TAdut - 30 * 1000000LL))) >> 24LL;
  438. Alpha_corr = ((s64)((s64)Fa * Ha_customer * 10000LL) >> Fa_scale);
  439. Alpha_corr *= ((s64)(1 * 1000000LL + calcedGa + calcedGb));
  440. Alpha_corr = div64_s64(Alpha_corr, 1000LL);
  441. Alpha_corr *= emissivity;
  442. Alpha_corr = div64_s64(Alpha_corr, 100LL);
  443. calcedFa = div64_s64((s64)object * 100000000000LL, Alpha_corr);
  444. return (int_sqrt64(int_sqrt64(calcedFa * 100000000LL + TAdut4))
  445. - 27315 - Hb_customer) * 10;
  446. }
  447. static s64 mlx90635_calc_ta4(s64 TAdut, s64 scale)
  448. {
  449. return (div64_s64(TAdut, scale) + 27315) *
  450. (div64_s64(TAdut, scale) + 27315) *
  451. (div64_s64(TAdut, scale) + 27315) *
  452. (div64_s64(TAdut, scale) + 27315);
  453. }
  454. static s32 mlx90635_calc_temp_object(s64 object, s64 ambient, u32 Ea, u32 Eb,
  455. s16 Ga, u32 Fa, u16 Fa_scale, s16 Fb, s16 Ha, s16 Hb,
  456. u16 tmp_emi)
  457. {
  458. s64 kTA, kTA0, TAdut, TAdut4;
  459. s64 temp = 35000;
  460. s8 i;
  461. kTA = (Ea * 1000LL) >> 16LL;
  462. kTA0 = (Eb * 1000LL) >> 8LL;
  463. TAdut = div64_s64(((ambient - kTA0) * 1000000LL), kTA) + 30 * 1000000LL;
  464. TAdut4 = mlx90635_calc_ta4(TAdut, 10000LL);
  465. /* Iterations of calculation as described in datasheet */
  466. for (i = 0; i < 5; ++i) {
  467. temp = mlx90635_calc_temp_object_iteration(temp, object, TAdut, TAdut4,
  468. Ga, Fa, Fa_scale, Fb, Ha, Hb,
  469. tmp_emi);
  470. }
  471. return temp;
  472. }
  473. static int mlx90635_calc_object(struct mlx90635_data *data, int *val)
  474. {
  475. s16 ambient_new_raw, ambient_old_raw, object_raw;
  476. s16 Fb, Ga, Gb, Ha, Hb;
  477. s64 object, ambient;
  478. u32 Ea, Eb, Fa;
  479. u16 Fa_scale;
  480. int ret;
  481. ret = mlx90635_read_ee_object(data->regmap_ee, &Ea, &Eb, &Fa, &Fb, &Ga, &Gb, &Ha, &Hb, &Fa_scale);
  482. if (ret < 0)
  483. return ret;
  484. ret = mlx90635_read_all_channel(data,
  485. &ambient_new_raw, &ambient_old_raw,
  486. &object_raw);
  487. if (ret < 0)
  488. return ret;
  489. ambient = mlx90635_preprocess_temp_amb(ambient_new_raw,
  490. ambient_old_raw, Gb);
  491. object = mlx90635_preprocess_temp_obj(object_raw,
  492. ambient_new_raw,
  493. ambient_old_raw, Gb);
  494. *val = mlx90635_calc_temp_object(object, ambient, Ea, Eb, Ga, Fa, Fa_scale, Fb,
  495. Ha, Hb, data->emissivity);
  496. return 0;
  497. }
  498. static int mlx90635_calc_ambient(struct mlx90635_data *data, int *val)
  499. {
  500. s16 ambient_new_raw, ambient_old_raw;
  501. s16 PG, PO, Gb;
  502. int ret;
  503. ret = mlx90635_read_ee_ambient(data->regmap_ee, &PG, &PO, &Gb);
  504. if (ret < 0)
  505. return ret;
  506. mutex_lock(&data->lock);
  507. if (data->powerstatus == MLX90635_PWR_STATUS_SLEEP_STEP) {
  508. ret = mlx90635_perform_measurement_burst(data);
  509. if (ret < 0)
  510. goto read_ambient_unlock;
  511. }
  512. ret = mlx90635_read_ambient_raw(data->regmap, &ambient_new_raw,
  513. &ambient_old_raw);
  514. read_ambient_unlock:
  515. mutex_unlock(&data->lock);
  516. if (ret < 0)
  517. return ret;
  518. *val = mlx90635_calc_temp_ambient(ambient_new_raw, ambient_old_raw,
  519. PG, PO, Gb);
  520. return ret;
  521. }
  522. static int mlx90635_get_refresh_rate(struct mlx90635_data *data,
  523. unsigned int *refresh_rate)
  524. {
  525. unsigned int reg;
  526. int ret;
  527. ret = regmap_read(data->regmap, MLX90635_REG_CTRL1, &reg);
  528. if (ret < 0)
  529. return ret;
  530. *refresh_rate = FIELD_GET(MLX90635_CTRL1_REFRESH_RATE_MASK, reg);
  531. return 0;
  532. }
  533. static const struct {
  534. int val;
  535. int val2;
  536. } mlx90635_freqs[] = {
  537. { 0, 200000 },
  538. { 0, 500000 },
  539. { 0, 900000 },
  540. { 1, 700000 },
  541. { 3, 0 },
  542. { 4, 800000 },
  543. { 6, 900000 },
  544. { 8, 900000 }
  545. };
  546. /**
  547. * mlx90635_pm_interaction_wakeup() - Measure time between user interactions to change powermode
  548. * @data: pointer to mlx90635_data object containing interaction_ts information
  549. *
  550. * Switch to continuous mode when interaction is faster than MLX90635_MEAS_MAX_TIME. Update the
  551. * interaction_ts for each function call with the jiffies to enable measurement between function
  552. * calls. Initial value of the interaction_ts needs to be set before this function call.
  553. */
  554. static int mlx90635_pm_interaction_wakeup(struct mlx90635_data *data)
  555. {
  556. unsigned long now;
  557. int ret;
  558. now = jiffies;
  559. if (time_in_range(now, data->interaction_ts,
  560. data->interaction_ts +
  561. msecs_to_jiffies(MLX90635_MEAS_MAX_TIME + 100))) {
  562. ret = mlx90635_pwr_continuous(data);
  563. if (ret < 0)
  564. return ret;
  565. }
  566. data->interaction_ts = now;
  567. return 0;
  568. }
  569. static int mlx90635_read_raw(struct iio_dev *indio_dev,
  570. struct iio_chan_spec const *channel, int *val,
  571. int *val2, long mask)
  572. {
  573. struct mlx90635_data *data = iio_priv(indio_dev);
  574. int ret;
  575. int cr;
  576. pm_runtime_get_sync(&data->client->dev);
  577. ret = mlx90635_pm_interaction_wakeup(data);
  578. if (ret < 0)
  579. goto mlx90635_read_raw_pm;
  580. switch (mask) {
  581. case IIO_CHAN_INFO_PROCESSED:
  582. switch (channel->channel2) {
  583. case IIO_MOD_TEMP_AMBIENT:
  584. ret = mlx90635_calc_ambient(data, val);
  585. if (ret < 0)
  586. goto mlx90635_read_raw_pm;
  587. ret = IIO_VAL_INT;
  588. break;
  589. case IIO_MOD_TEMP_OBJECT:
  590. ret = mlx90635_calc_object(data, val);
  591. if (ret < 0)
  592. goto mlx90635_read_raw_pm;
  593. ret = IIO_VAL_INT;
  594. break;
  595. default:
  596. ret = -EINVAL;
  597. break;
  598. }
  599. break;
  600. case IIO_CHAN_INFO_CALIBEMISSIVITY:
  601. if (data->emissivity == 1000) {
  602. *val = 1;
  603. *val2 = 0;
  604. } else {
  605. *val = 0;
  606. *val2 = data->emissivity * 1000;
  607. }
  608. ret = IIO_VAL_INT_PLUS_MICRO;
  609. break;
  610. case IIO_CHAN_INFO_SAMP_FREQ:
  611. ret = mlx90635_get_refresh_rate(data, &cr);
  612. if (ret < 0)
  613. goto mlx90635_read_raw_pm;
  614. *val = mlx90635_freqs[cr].val;
  615. *val2 = mlx90635_freqs[cr].val2;
  616. ret = IIO_VAL_INT_PLUS_MICRO;
  617. break;
  618. default:
  619. ret = -EINVAL;
  620. break;
  621. }
  622. mlx90635_read_raw_pm:
  623. pm_runtime_mark_last_busy(&data->client->dev);
  624. pm_runtime_put_autosuspend(&data->client->dev);
  625. return ret;
  626. }
  627. static int mlx90635_write_raw(struct iio_dev *indio_dev,
  628. struct iio_chan_spec const *channel, int val,
  629. int val2, long mask)
  630. {
  631. struct mlx90635_data *data = iio_priv(indio_dev);
  632. int ret;
  633. int i;
  634. switch (mask) {
  635. case IIO_CHAN_INFO_CALIBEMISSIVITY:
  636. /* Confirm we are within 0 and 1.0 */
  637. if (val < 0 || val2 < 0 || val > 1 ||
  638. (val == 1 && val2 != 0))
  639. return -EINVAL;
  640. data->emissivity = val * 1000 + val2 / 1000;
  641. return 0;
  642. case IIO_CHAN_INFO_SAMP_FREQ:
  643. for (i = 0; i < ARRAY_SIZE(mlx90635_freqs); i++) {
  644. if (val == mlx90635_freqs[i].val &&
  645. val2 == mlx90635_freqs[i].val2)
  646. break;
  647. }
  648. if (i == ARRAY_SIZE(mlx90635_freqs))
  649. return -EINVAL;
  650. ret = regmap_write_bits(data->regmap, MLX90635_REG_CTRL1,
  651. MLX90635_CTRL1_REFRESH_RATE_MASK, i);
  652. return ret;
  653. default:
  654. return -EINVAL;
  655. }
  656. }
  657. static int mlx90635_read_avail(struct iio_dev *indio_dev,
  658. struct iio_chan_spec const *chan,
  659. const int **vals, int *type, int *length,
  660. long mask)
  661. {
  662. switch (mask) {
  663. case IIO_CHAN_INFO_SAMP_FREQ:
  664. *vals = (int *)mlx90635_freqs;
  665. *type = IIO_VAL_INT_PLUS_MICRO;
  666. *length = 2 * ARRAY_SIZE(mlx90635_freqs);
  667. return IIO_AVAIL_LIST;
  668. default:
  669. return -EINVAL;
  670. }
  671. }
  672. static const struct iio_chan_spec mlx90635_channels[] = {
  673. {
  674. .type = IIO_TEMP,
  675. .modified = 1,
  676. .channel2 = IIO_MOD_TEMP_AMBIENT,
  677. .info_mask_separate = BIT(IIO_CHAN_INFO_PROCESSED),
  678. .info_mask_shared_by_all = BIT(IIO_CHAN_INFO_SAMP_FREQ),
  679. .info_mask_shared_by_all_available = BIT(IIO_CHAN_INFO_SAMP_FREQ),
  680. },
  681. {
  682. .type = IIO_TEMP,
  683. .modified = 1,
  684. .channel2 = IIO_MOD_TEMP_OBJECT,
  685. .info_mask_separate = BIT(IIO_CHAN_INFO_PROCESSED) |
  686. BIT(IIO_CHAN_INFO_CALIBEMISSIVITY),
  687. .info_mask_shared_by_all = BIT(IIO_CHAN_INFO_SAMP_FREQ),
  688. .info_mask_shared_by_all_available = BIT(IIO_CHAN_INFO_SAMP_FREQ),
  689. },
  690. };
  691. static const struct iio_info mlx90635_info = {
  692. .read_raw = mlx90635_read_raw,
  693. .write_raw = mlx90635_write_raw,
  694. .read_avail = mlx90635_read_avail,
  695. };
  696. static void mlx90635_sleep(void *_data)
  697. {
  698. struct mlx90635_data *data = _data;
  699. mlx90635_pwr_sleep_step(data);
  700. }
  701. static int mlx90635_suspend(struct mlx90635_data *data)
  702. {
  703. return mlx90635_pwr_sleep_step(data);
  704. }
  705. static int mlx90635_wakeup(struct mlx90635_data *data)
  706. {
  707. s16 Fb, Ga, Gb, Ha, Hb, PG, PO;
  708. unsigned int dsp_version;
  709. u32 Ea, Eb, Fa;
  710. u16 Fa_scale;
  711. int ret;
  712. regcache_cache_bypass(data->regmap_ee, false);
  713. regcache_cache_only(data->regmap_ee, false);
  714. regcache_cache_only(data->regmap, false);
  715. ret = mlx90635_pwr_continuous(data);
  716. if (ret < 0) {
  717. dev_err(&data->client->dev, "Switch to continuous mode failed\n");
  718. return ret;
  719. }
  720. ret = regmap_write_bits(data->regmap, MLX90635_REG_EE,
  721. MLX90635_EE_ACTIVE, MLX90635_EE_ACTIVE);
  722. if (ret < 0) {
  723. dev_err(&data->client->dev, "Powering EEPROM failed\n");
  724. return ret;
  725. }
  726. usleep_range(MLX90635_TIMING_EE_ACTIVE_MIN, MLX90635_TIMING_EE_ACTIVE_MAX);
  727. regcache_mark_dirty(data->regmap_ee);
  728. ret = regcache_sync(data->regmap_ee);
  729. if (ret < 0) {
  730. dev_err(&data->client->dev,
  731. "Failed to sync cache: %d\n", ret);
  732. return ret;
  733. }
  734. ret = mlx90635_read_ee_ambient(data->regmap_ee, &PG, &PO, &Gb);
  735. if (ret < 0) {
  736. dev_err(&data->client->dev,
  737. "Failed to read to cache Ambient coefficients EEPROM region: %d\n", ret);
  738. return ret;
  739. }
  740. ret = mlx90635_read_ee_object(data->regmap_ee, &Ea, &Eb, &Fa, &Fb, &Ga, &Gb, &Ha, &Hb, &Fa_scale);
  741. if (ret < 0) {
  742. dev_err(&data->client->dev,
  743. "Failed to read to cache Object coefficients EEPROM region: %d\n", ret);
  744. return ret;
  745. }
  746. ret = regmap_read(data->regmap_ee, MLX90635_EE_VERSION, &dsp_version);
  747. if (ret < 0) {
  748. dev_err(&data->client->dev,
  749. "Failed to read to cache of EEPROM version: %d\n", ret);
  750. return ret;
  751. }
  752. regcache_cache_only(data->regmap_ee, true);
  753. return ret;
  754. }
  755. static void mlx90635_disable_regulator(void *_data)
  756. {
  757. struct mlx90635_data *data = _data;
  758. int ret;
  759. ret = regulator_disable(data->regulator);
  760. if (ret < 0)
  761. dev_err(regmap_get_device(data->regmap),
  762. "Failed to disable power regulator: %d\n", ret);
  763. }
  764. static int mlx90635_enable_regulator(struct mlx90635_data *data)
  765. {
  766. int ret;
  767. ret = regulator_enable(data->regulator);
  768. if (ret < 0) {
  769. dev_err(regmap_get_device(data->regmap), "Failed to enable power regulator!\n");
  770. return ret;
  771. }
  772. mlx90635_reset_delay();
  773. return ret;
  774. }
  775. static int mlx90635_probe(struct i2c_client *client)
  776. {
  777. struct mlx90635_data *mlx90635;
  778. struct iio_dev *indio_dev;
  779. unsigned int dsp_version;
  780. struct regmap *regmap;
  781. struct regmap *regmap_ee;
  782. int ret;
  783. indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*mlx90635));
  784. if (!indio_dev)
  785. return dev_err_probe(&client->dev, -ENOMEM, "failed to allocate device\n");
  786. regmap = devm_regmap_init_i2c(client, &mlx90635_regmap);
  787. if (IS_ERR(regmap))
  788. return dev_err_probe(&client->dev, PTR_ERR(regmap),
  789. "failed to allocate regmap\n");
  790. regmap_ee = devm_regmap_init_i2c(client, &mlx90635_regmap_ee);
  791. if (IS_ERR(regmap_ee))
  792. return dev_err_probe(&client->dev, PTR_ERR(regmap_ee),
  793. "failed to allocate EEPROM regmap\n");
  794. mlx90635 = iio_priv(indio_dev);
  795. i2c_set_clientdata(client, indio_dev);
  796. mlx90635->client = client;
  797. mlx90635->regmap = regmap;
  798. mlx90635->regmap_ee = regmap_ee;
  799. mlx90635->powerstatus = MLX90635_PWR_STATUS_SLEEP_STEP;
  800. mutex_init(&mlx90635->lock);
  801. indio_dev->name = "mlx90635";
  802. indio_dev->modes = INDIO_DIRECT_MODE;
  803. indio_dev->info = &mlx90635_info;
  804. indio_dev->channels = mlx90635_channels;
  805. indio_dev->num_channels = ARRAY_SIZE(mlx90635_channels);
  806. mlx90635->regulator = devm_regulator_get(&client->dev, "vdd");
  807. if (IS_ERR(mlx90635->regulator))
  808. return dev_err_probe(&client->dev, PTR_ERR(mlx90635->regulator),
  809. "failed to get vdd regulator");
  810. ret = mlx90635_enable_regulator(mlx90635);
  811. if (ret < 0)
  812. return ret;
  813. ret = devm_add_action_or_reset(&client->dev, mlx90635_disable_regulator,
  814. mlx90635);
  815. if (ret < 0)
  816. return dev_err_probe(&client->dev, ret,
  817. "failed to setup regulator cleanup action\n");
  818. ret = mlx90635_wakeup(mlx90635);
  819. if (ret < 0)
  820. return dev_err_probe(&client->dev, ret, "wakeup failed\n");
  821. ret = devm_add_action_or_reset(&client->dev, mlx90635_sleep, mlx90635);
  822. if (ret < 0)
  823. return dev_err_probe(&client->dev, ret,
  824. "failed to setup low power cleanup\n");
  825. ret = regmap_read(mlx90635->regmap_ee, MLX90635_EE_VERSION, &dsp_version);
  826. if (ret < 0)
  827. return dev_err_probe(&client->dev, ret, "read of version failed\n");
  828. dsp_version = dsp_version & MLX90635_VERSION_MASK;
  829. if (FIELD_GET(MLX90635_DSP_FIXED, dsp_version)) {
  830. if (MLX90635_DSP_VERSION(dsp_version) == MLX90635_ID_DSPv1) {
  831. dev_dbg(&client->dev,
  832. "Detected DSP v1 calibration %x\n", dsp_version);
  833. } else {
  834. dev_dbg(&client->dev,
  835. "Detected Unknown EEPROM calibration %lx\n",
  836. MLX90635_DSP_VERSION(dsp_version));
  837. }
  838. } else {
  839. return dev_err_probe(&client->dev, -EPROTONOSUPPORT,
  840. "Wrong fixed top bit %x (expected 0x8X0X)\n",
  841. dsp_version);
  842. }
  843. mlx90635->emissivity = 1000;
  844. mlx90635->interaction_ts = jiffies; /* Set initial value */
  845. pm_runtime_get_noresume(&client->dev);
  846. pm_runtime_set_active(&client->dev);
  847. ret = devm_pm_runtime_enable(&client->dev);
  848. if (ret)
  849. return dev_err_probe(&client->dev, ret,
  850. "failed to enable powermanagement\n");
  851. pm_runtime_set_autosuspend_delay(&client->dev, MLX90635_SLEEP_DELAY_MS);
  852. pm_runtime_use_autosuspend(&client->dev);
  853. pm_runtime_put_autosuspend(&client->dev);
  854. return devm_iio_device_register(&client->dev, indio_dev);
  855. }
  856. static const struct i2c_device_id mlx90635_id[] = {
  857. { "mlx90635" },
  858. { }
  859. };
  860. MODULE_DEVICE_TABLE(i2c, mlx90635_id);
  861. static const struct of_device_id mlx90635_of_match[] = {
  862. { .compatible = "melexis,mlx90635" },
  863. { }
  864. };
  865. MODULE_DEVICE_TABLE(of, mlx90635_of_match);
  866. static int mlx90635_pm_suspend(struct device *dev)
  867. {
  868. struct mlx90635_data *data = iio_priv(dev_get_drvdata(dev));
  869. int ret;
  870. ret = mlx90635_suspend(data);
  871. if (ret < 0)
  872. return ret;
  873. ret = regulator_disable(data->regulator);
  874. if (ret < 0)
  875. dev_err(regmap_get_device(data->regmap),
  876. "Failed to disable power regulator: %d\n", ret);
  877. return ret;
  878. }
  879. static int mlx90635_pm_resume(struct device *dev)
  880. {
  881. struct mlx90635_data *data = iio_priv(dev_get_drvdata(dev));
  882. int ret;
  883. ret = mlx90635_enable_regulator(data);
  884. if (ret < 0)
  885. return ret;
  886. return mlx90635_wakeup(data);
  887. }
  888. static int mlx90635_pm_runtime_suspend(struct device *dev)
  889. {
  890. struct mlx90635_data *data = iio_priv(dev_get_drvdata(dev));
  891. return mlx90635_pwr_sleep_step(data);
  892. }
  893. static const struct dev_pm_ops mlx90635_pm_ops = {
  894. SYSTEM_SLEEP_PM_OPS(mlx90635_pm_suspend, mlx90635_pm_resume)
  895. RUNTIME_PM_OPS(mlx90635_pm_runtime_suspend, NULL, NULL)
  896. };
  897. static struct i2c_driver mlx90635_driver = {
  898. .driver = {
  899. .name = "mlx90635",
  900. .of_match_table = mlx90635_of_match,
  901. .pm = pm_ptr(&mlx90635_pm_ops),
  902. },
  903. .probe = mlx90635_probe,
  904. .id_table = mlx90635_id,
  905. };
  906. module_i2c_driver(mlx90635_driver);
  907. MODULE_AUTHOR("Crt Mori <cmo@melexis.com>");
  908. MODULE_DESCRIPTION("Melexis MLX90635 contactless Infra Red temperature sensor driver");
  909. MODULE_LICENSE("GPL");