hdc2010.c 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350
  1. // SPDX-License-Identifier: GPL-2.0+
  2. /*
  3. * hdc2010.c - Support for the TI HDC2010 and HDC2080
  4. * temperature + relative humidity sensors
  5. *
  6. * Copyright (C) 2020 Norphonic AS
  7. * Author: Eugene Zaikonnikov <[email protected]>
  8. *
  9. * Datasheet: https://www.ti.com/product/HDC2010/datasheet
  10. * Datasheet: https://www.ti.com/product/HDC2080/datasheet
  11. */
  12. #include <linux/module.h>
  13. #include <linux/init.h>
  14. #include <linux/i2c.h>
  15. #include <linux/bitops.h>
  16. #include <linux/iio/iio.h>
  17. #include <linux/iio/sysfs.h>
  18. #define HDC2010_REG_TEMP_LOW 0x00
  19. #define HDC2010_REG_TEMP_HIGH 0x01
  20. #define HDC2010_REG_HUMIDITY_LOW 0x02
  21. #define HDC2010_REG_HUMIDITY_HIGH 0x03
  22. #define HDC2010_REG_INTERRUPT_DRDY 0x04
  23. #define HDC2010_REG_TEMP_MAX 0x05
  24. #define HDC2010_REG_HUMIDITY_MAX 0x06
  25. #define HDC2010_REG_INTERRUPT_EN 0x07
  26. #define HDC2010_REG_TEMP_OFFSET_ADJ 0x08
  27. #define HDC2010_REG_HUMIDITY_OFFSET_ADJ 0x09
  28. #define HDC2010_REG_TEMP_THR_L 0x0a
  29. #define HDC2010_REG_TEMP_THR_H 0x0b
  30. #define HDC2010_REG_RH_THR_L 0x0c
  31. #define HDC2010_REG_RH_THR_H 0x0d
  32. #define HDC2010_REG_RESET_DRDY_INT_CONF 0x0e
  33. #define HDC2010_REG_MEASUREMENT_CONF 0x0f
  34. #define HDC2010_MEAS_CONF GENMASK(2, 1)
  35. #define HDC2010_MEAS_TRIG BIT(0)
  36. #define HDC2010_HEATER_EN BIT(3)
  37. #define HDC2010_AMM GENMASK(6, 4)
  38. struct hdc2010_data {
  39. struct i2c_client *client;
  40. struct mutex lock;
  41. u8 measurement_config;
  42. u8 interrupt_config;
  43. u8 drdy_config;
  44. };
  45. enum hdc2010_addr_groups {
  46. HDC2010_GROUP_TEMP = 0,
  47. HDC2010_GROUP_HUMIDITY,
  48. };
  49. struct hdc2010_reg_record {
  50. unsigned long primary;
  51. unsigned long peak;
  52. };
  53. static const struct hdc2010_reg_record hdc2010_reg_translation[] = {
  54. [HDC2010_GROUP_TEMP] = {
  55. .primary = HDC2010_REG_TEMP_LOW,
  56. .peak = HDC2010_REG_TEMP_MAX,
  57. },
  58. [HDC2010_GROUP_HUMIDITY] = {
  59. .primary = HDC2010_REG_HUMIDITY_LOW,
  60. .peak = HDC2010_REG_HUMIDITY_MAX,
  61. },
  62. };
  63. static IIO_CONST_ATTR(out_current_heater_raw_available, "0 1");
  64. static struct attribute *hdc2010_attributes[] = {
  65. &iio_const_attr_out_current_heater_raw_available.dev_attr.attr,
  66. NULL
  67. };
  68. static const struct attribute_group hdc2010_attribute_group = {
  69. .attrs = hdc2010_attributes,
  70. };
  71. static const struct iio_chan_spec hdc2010_channels[] = {
  72. {
  73. .type = IIO_TEMP,
  74. .address = HDC2010_GROUP_TEMP,
  75. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
  76. BIT(IIO_CHAN_INFO_PEAK) |
  77. BIT(IIO_CHAN_INFO_OFFSET) |
  78. BIT(IIO_CHAN_INFO_SCALE),
  79. },
  80. {
  81. .type = IIO_HUMIDITYRELATIVE,
  82. .address = HDC2010_GROUP_HUMIDITY,
  83. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
  84. BIT(IIO_CHAN_INFO_PEAK) |
  85. BIT(IIO_CHAN_INFO_SCALE),
  86. },
  87. {
  88. .type = IIO_CURRENT,
  89. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
  90. .extend_name = "heater",
  91. .output = 1,
  92. },
  93. };
  94. static int hdc2010_update_drdy_config(struct hdc2010_data *data,
  95. char mask, char val)
  96. {
  97. u8 tmp = (~mask & data->drdy_config) | val;
  98. int ret;
  99. ret = i2c_smbus_write_byte_data(data->client,
  100. HDC2010_REG_RESET_DRDY_INT_CONF, tmp);
  101. if (ret)
  102. return ret;
  103. data->drdy_config = tmp;
  104. return 0;
  105. }
  106. static int hdc2010_get_prim_measurement_word(struct hdc2010_data *data,
  107. struct iio_chan_spec const *chan)
  108. {
  109. struct i2c_client *client = data->client;
  110. s32 ret;
  111. ret = i2c_smbus_read_word_data(client,
  112. hdc2010_reg_translation[chan->address].primary);
  113. if (ret < 0)
  114. dev_err(&client->dev, "Could not read sensor measurement word\n");
  115. return ret;
  116. }
  117. static int hdc2010_get_peak_measurement_byte(struct hdc2010_data *data,
  118. struct iio_chan_spec const *chan)
  119. {
  120. struct i2c_client *client = data->client;
  121. s32 ret;
  122. ret = i2c_smbus_read_byte_data(client,
  123. hdc2010_reg_translation[chan->address].peak);
  124. if (ret < 0)
  125. dev_err(&client->dev, "Could not read sensor measurement byte\n");
  126. return ret;
  127. }
  128. static int hdc2010_get_heater_status(struct hdc2010_data *data)
  129. {
  130. return !!(data->drdy_config & HDC2010_HEATER_EN);
  131. }
  132. static int hdc2010_read_raw(struct iio_dev *indio_dev,
  133. struct iio_chan_spec const *chan, int *val,
  134. int *val2, long mask)
  135. {
  136. struct hdc2010_data *data = iio_priv(indio_dev);
  137. switch (mask) {
  138. case IIO_CHAN_INFO_RAW: {
  139. int ret;
  140. if (chan->type == IIO_CURRENT) {
  141. *val = hdc2010_get_heater_status(data);
  142. return IIO_VAL_INT;
  143. }
  144. ret = iio_device_claim_direct_mode(indio_dev);
  145. if (ret)
  146. return ret;
  147. mutex_lock(&data->lock);
  148. ret = hdc2010_get_prim_measurement_word(data, chan);
  149. mutex_unlock(&data->lock);
  150. iio_device_release_direct_mode(indio_dev);
  151. if (ret < 0)
  152. return ret;
  153. *val = ret;
  154. return IIO_VAL_INT;
  155. }
  156. case IIO_CHAN_INFO_PEAK: {
  157. int ret;
  158. ret = iio_device_claim_direct_mode(indio_dev);
  159. if (ret)
  160. return ret;
  161. mutex_lock(&data->lock);
  162. ret = hdc2010_get_peak_measurement_byte(data, chan);
  163. mutex_unlock(&data->lock);
  164. iio_device_release_direct_mode(indio_dev);
  165. if (ret < 0)
  166. return ret;
  167. /* Scaling up the value so we can use same offset as RAW */
  168. *val = ret * 256;
  169. return IIO_VAL_INT;
  170. }
  171. case IIO_CHAN_INFO_SCALE:
  172. *val2 = 65536;
  173. if (chan->type == IIO_TEMP)
  174. *val = 165000;
  175. else
  176. *val = 100000;
  177. return IIO_VAL_FRACTIONAL;
  178. case IIO_CHAN_INFO_OFFSET:
  179. *val = -15887;
  180. *val2 = 515151;
  181. return IIO_VAL_INT_PLUS_MICRO;
  182. default:
  183. return -EINVAL;
  184. }
  185. }
  186. static int hdc2010_write_raw(struct iio_dev *indio_dev,
  187. struct iio_chan_spec const *chan,
  188. int val, int val2, long mask)
  189. {
  190. struct hdc2010_data *data = iio_priv(indio_dev);
  191. int new, ret;
  192. switch (mask) {
  193. case IIO_CHAN_INFO_RAW:
  194. if (chan->type != IIO_CURRENT || val2 != 0)
  195. return -EINVAL;
  196. switch (val) {
  197. case 1:
  198. new = HDC2010_HEATER_EN;
  199. break;
  200. case 0:
  201. new = 0;
  202. break;
  203. default:
  204. return -EINVAL;
  205. }
  206. mutex_lock(&data->lock);
  207. ret = hdc2010_update_drdy_config(data, HDC2010_HEATER_EN, new);
  208. mutex_unlock(&data->lock);
  209. return ret;
  210. default:
  211. return -EINVAL;
  212. }
  213. }
  214. static const struct iio_info hdc2010_info = {
  215. .read_raw = hdc2010_read_raw,
  216. .write_raw = hdc2010_write_raw,
  217. .attrs = &hdc2010_attribute_group,
  218. };
  219. static int hdc2010_probe(struct i2c_client *client,
  220. const struct i2c_device_id *id)
  221. {
  222. struct iio_dev *indio_dev;
  223. struct hdc2010_data *data;
  224. u8 tmp;
  225. int ret;
  226. if (!i2c_check_functionality(client->adapter,
  227. I2C_FUNC_SMBUS_WORD_DATA | I2C_FUNC_SMBUS_BYTE | I2C_FUNC_I2C))
  228. return -EOPNOTSUPP;
  229. indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
  230. if (!indio_dev)
  231. return -ENOMEM;
  232. data = iio_priv(indio_dev);
  233. i2c_set_clientdata(client, indio_dev);
  234. data->client = client;
  235. mutex_init(&data->lock);
  236. /*
  237. * As DEVICE ID register does not differentiate between
  238. * HDC2010 and HDC2080, we have the name hardcoded
  239. */
  240. indio_dev->name = "hdc2010";
  241. indio_dev->modes = INDIO_DIRECT_MODE;
  242. indio_dev->info = &hdc2010_info;
  243. indio_dev->channels = hdc2010_channels;
  244. indio_dev->num_channels = ARRAY_SIZE(hdc2010_channels);
  245. /* Enable Automatic Measurement Mode at 5Hz */
  246. ret = hdc2010_update_drdy_config(data, HDC2010_AMM, HDC2010_AMM);
  247. if (ret)
  248. return ret;
  249. /*
  250. * We enable both temp and humidity measurement.
  251. * However the measurement won't start even in AMM until triggered.
  252. */
  253. tmp = (data->measurement_config & ~HDC2010_MEAS_CONF) |
  254. HDC2010_MEAS_TRIG;
  255. ret = i2c_smbus_write_byte_data(client, HDC2010_REG_MEASUREMENT_CONF, tmp);
  256. if (ret) {
  257. dev_warn(&client->dev, "Unable to set up measurement\n");
  258. if (hdc2010_update_drdy_config(data, HDC2010_AMM, 0))
  259. dev_warn(&client->dev, "Unable to restore default AMM\n");
  260. return ret;
  261. }
  262. data->measurement_config = tmp;
  263. return iio_device_register(indio_dev);
  264. }
  265. static void hdc2010_remove(struct i2c_client *client)
  266. {
  267. struct iio_dev *indio_dev = i2c_get_clientdata(client);
  268. struct hdc2010_data *data = iio_priv(indio_dev);
  269. iio_device_unregister(indio_dev);
  270. /* Disable Automatic Measurement Mode */
  271. if (hdc2010_update_drdy_config(data, HDC2010_AMM, 0))
  272. dev_warn(&client->dev, "Unable to restore default AMM\n");
  273. }
  274. static const struct i2c_device_id hdc2010_id[] = {
  275. { "hdc2010" },
  276. { "hdc2080" },
  277. { }
  278. };
  279. MODULE_DEVICE_TABLE(i2c, hdc2010_id);
  280. static const struct of_device_id hdc2010_dt_ids[] = {
  281. { .compatible = "ti,hdc2010" },
  282. { .compatible = "ti,hdc2080" },
  283. { }
  284. };
  285. MODULE_DEVICE_TABLE(of, hdc2010_dt_ids);
  286. static struct i2c_driver hdc2010_driver = {
  287. .driver = {
  288. .name = "hdc2010",
  289. .of_match_table = hdc2010_dt_ids,
  290. },
  291. .probe = hdc2010_probe,
  292. .remove = hdc2010_remove,
  293. .id_table = hdc2010_id,
  294. };
  295. module_i2c_driver(hdc2010_driver);
  296. MODULE_AUTHOR("Eugene Zaikonnikov <[email protected]>");
  297. MODULE_DESCRIPTION("TI HDC2010 humidity and temperature sensor driver");
  298. MODULE_LICENSE("GPL");