hid-sensor-humidity.c 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * HID Sensors Driver
  4. * Copyright (c) 2017, Intel Corporation.
  5. */
  6. #include <linux/device.h>
  7. #include <linux/hid-sensor-hub.h>
  8. #include <linux/iio/buffer.h>
  9. #include <linux/iio/iio.h>
  10. #include <linux/module.h>
  11. #include <linux/mod_devicetable.h>
  12. #include <linux/platform_device.h>
  13. #include "hid-sensor-trigger.h"
  14. struct hid_humidity_state {
  15. struct hid_sensor_common common_attributes;
  16. struct hid_sensor_hub_attribute_info humidity_attr;
  17. struct {
  18. s32 humidity_data;
  19. u64 timestamp __aligned(8);
  20. } scan;
  21. int scale_pre_decml;
  22. int scale_post_decml;
  23. int scale_precision;
  24. int value_offset;
  25. };
  26. static const u32 humidity_sensitivity_addresses[] = {
  27. HID_USAGE_SENSOR_ATMOSPHERIC_HUMIDITY,
  28. };
  29. /* Channel definitions */
  30. static const struct iio_chan_spec humidity_channels[] = {
  31. {
  32. .type = IIO_HUMIDITYRELATIVE,
  33. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
  34. .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_OFFSET) |
  35. BIT(IIO_CHAN_INFO_SCALE) |
  36. BIT(IIO_CHAN_INFO_SAMP_FREQ) |
  37. BIT(IIO_CHAN_INFO_HYSTERESIS),
  38. },
  39. IIO_CHAN_SOFT_TIMESTAMP(1)
  40. };
  41. /* Adjust channel real bits based on report descriptor */
  42. static void humidity_adjust_channel_bit_mask(struct iio_chan_spec *channels,
  43. int channel, int size)
  44. {
  45. channels[channel].scan_type.sign = 's';
  46. /* Real storage bits will change based on the report desc. */
  47. channels[channel].scan_type.realbits = size * 8;
  48. /* Maximum size of a sample to capture is s32 */
  49. channels[channel].scan_type.storagebits = sizeof(s32) * 8;
  50. }
  51. static int humidity_read_raw(struct iio_dev *indio_dev,
  52. struct iio_chan_spec const *chan,
  53. int *val, int *val2, long mask)
  54. {
  55. struct hid_humidity_state *humid_st = iio_priv(indio_dev);
  56. switch (mask) {
  57. case IIO_CHAN_INFO_RAW:
  58. if (chan->type != IIO_HUMIDITYRELATIVE)
  59. return -EINVAL;
  60. hid_sensor_power_state(&humid_st->common_attributes, true);
  61. *val = sensor_hub_input_attr_get_raw_value(
  62. humid_st->common_attributes.hsdev,
  63. HID_USAGE_SENSOR_HUMIDITY,
  64. HID_USAGE_SENSOR_ATMOSPHERIC_HUMIDITY,
  65. humid_st->humidity_attr.report_id,
  66. SENSOR_HUB_SYNC,
  67. humid_st->humidity_attr.logical_minimum < 0);
  68. hid_sensor_power_state(&humid_st->common_attributes, false);
  69. return IIO_VAL_INT;
  70. case IIO_CHAN_INFO_SCALE:
  71. *val = humid_st->scale_pre_decml;
  72. *val2 = humid_st->scale_post_decml;
  73. return humid_st->scale_precision;
  74. case IIO_CHAN_INFO_OFFSET:
  75. *val = humid_st->value_offset;
  76. return IIO_VAL_INT;
  77. case IIO_CHAN_INFO_SAMP_FREQ:
  78. return hid_sensor_read_samp_freq_value(
  79. &humid_st->common_attributes, val, val2);
  80. case IIO_CHAN_INFO_HYSTERESIS:
  81. return hid_sensor_read_raw_hyst_value(
  82. &humid_st->common_attributes, val, val2);
  83. default:
  84. return -EINVAL;
  85. }
  86. }
  87. static int humidity_write_raw(struct iio_dev *indio_dev,
  88. struct iio_chan_spec const *chan,
  89. int val, int val2, long mask)
  90. {
  91. struct hid_humidity_state *humid_st = iio_priv(indio_dev);
  92. switch (mask) {
  93. case IIO_CHAN_INFO_SAMP_FREQ:
  94. return hid_sensor_write_samp_freq_value(
  95. &humid_st->common_attributes, val, val2);
  96. case IIO_CHAN_INFO_HYSTERESIS:
  97. return hid_sensor_write_raw_hyst_value(
  98. &humid_st->common_attributes, val, val2);
  99. default:
  100. return -EINVAL;
  101. }
  102. }
  103. static const struct iio_info humidity_info = {
  104. .read_raw = &humidity_read_raw,
  105. .write_raw = &humidity_write_raw,
  106. };
  107. /* Callback handler to send event after all samples are received and captured */
  108. static int humidity_proc_event(struct hid_sensor_hub_device *hsdev,
  109. unsigned int usage_id, void *pdev)
  110. {
  111. struct iio_dev *indio_dev = platform_get_drvdata(pdev);
  112. struct hid_humidity_state *humid_st = iio_priv(indio_dev);
  113. if (atomic_read(&humid_st->common_attributes.data_ready))
  114. iio_push_to_buffers_with_timestamp(indio_dev, &humid_st->scan,
  115. iio_get_time_ns(indio_dev));
  116. return 0;
  117. }
  118. /* Capture samples in local storage */
  119. static int humidity_capture_sample(struct hid_sensor_hub_device *hsdev,
  120. unsigned int usage_id, size_t raw_len,
  121. char *raw_data, void *pdev)
  122. {
  123. struct iio_dev *indio_dev = platform_get_drvdata(pdev);
  124. struct hid_humidity_state *humid_st = iio_priv(indio_dev);
  125. switch (usage_id) {
  126. case HID_USAGE_SENSOR_ATMOSPHERIC_HUMIDITY:
  127. humid_st->scan.humidity_data = *(s32 *)raw_data;
  128. return 0;
  129. default:
  130. return -EINVAL;
  131. }
  132. }
  133. /* Parse report which is specific to an usage id */
  134. static int humidity_parse_report(struct platform_device *pdev,
  135. struct hid_sensor_hub_device *hsdev,
  136. struct iio_chan_spec *channels,
  137. unsigned int usage_id,
  138. struct hid_humidity_state *st)
  139. {
  140. int ret;
  141. ret = sensor_hub_input_get_attribute_info(hsdev, HID_INPUT_REPORT,
  142. usage_id,
  143. HID_USAGE_SENSOR_ATMOSPHERIC_HUMIDITY,
  144. &st->humidity_attr);
  145. if (ret < 0)
  146. return ret;
  147. humidity_adjust_channel_bit_mask(channels, 0, st->humidity_attr.size);
  148. st->scale_precision = hid_sensor_format_scale(
  149. HID_USAGE_SENSOR_HUMIDITY,
  150. &st->humidity_attr,
  151. &st->scale_pre_decml,
  152. &st->scale_post_decml);
  153. return ret;
  154. }
  155. static struct hid_sensor_hub_callbacks humidity_callbacks = {
  156. .send_event = &humidity_proc_event,
  157. .capture_sample = &humidity_capture_sample,
  158. };
  159. /* Function to initialize the processing for usage id */
  160. static int hid_humidity_probe(struct platform_device *pdev)
  161. {
  162. static const char *name = "humidity";
  163. struct iio_dev *indio_dev;
  164. struct hid_humidity_state *humid_st;
  165. struct iio_chan_spec *humid_chans;
  166. struct hid_sensor_hub_device *hsdev = dev_get_platdata(&pdev->dev);
  167. int ret;
  168. indio_dev = devm_iio_device_alloc(&pdev->dev, sizeof(*humid_st));
  169. if (!indio_dev)
  170. return -ENOMEM;
  171. humid_st = iio_priv(indio_dev);
  172. humid_st->common_attributes.hsdev = hsdev;
  173. humid_st->common_attributes.pdev = pdev;
  174. ret = hid_sensor_parse_common_attributes(hsdev,
  175. HID_USAGE_SENSOR_HUMIDITY,
  176. &humid_st->common_attributes,
  177. humidity_sensitivity_addresses,
  178. ARRAY_SIZE(humidity_sensitivity_addresses));
  179. if (ret)
  180. return ret;
  181. humid_chans = devm_kmemdup(&indio_dev->dev, humidity_channels,
  182. sizeof(humidity_channels), GFP_KERNEL);
  183. if (!humid_chans)
  184. return -ENOMEM;
  185. ret = humidity_parse_report(pdev, hsdev, humid_chans,
  186. HID_USAGE_SENSOR_HUMIDITY, humid_st);
  187. if (ret)
  188. return ret;
  189. indio_dev->channels = humid_chans;
  190. indio_dev->num_channels = ARRAY_SIZE(humidity_channels);
  191. indio_dev->info = &humidity_info;
  192. indio_dev->name = name;
  193. indio_dev->modes = INDIO_DIRECT_MODE;
  194. atomic_set(&humid_st->common_attributes.data_ready, 0);
  195. ret = hid_sensor_setup_trigger(indio_dev, name,
  196. &humid_st->common_attributes);
  197. if (ret)
  198. return ret;
  199. platform_set_drvdata(pdev, indio_dev);
  200. humidity_callbacks.pdev = pdev;
  201. ret = sensor_hub_register_callback(hsdev, HID_USAGE_SENSOR_HUMIDITY,
  202. &humidity_callbacks);
  203. if (ret)
  204. goto error_remove_trigger;
  205. ret = iio_device_register(indio_dev);
  206. if (ret)
  207. goto error_remove_callback;
  208. return ret;
  209. error_remove_callback:
  210. sensor_hub_remove_callback(hsdev, HID_USAGE_SENSOR_HUMIDITY);
  211. error_remove_trigger:
  212. hid_sensor_remove_trigger(indio_dev, &humid_st->common_attributes);
  213. return ret;
  214. }
  215. /* Function to deinitialize the processing for usage id */
  216. static int hid_humidity_remove(struct platform_device *pdev)
  217. {
  218. struct hid_sensor_hub_device *hsdev = dev_get_platdata(&pdev->dev);
  219. struct iio_dev *indio_dev = platform_get_drvdata(pdev);
  220. struct hid_humidity_state *humid_st = iio_priv(indio_dev);
  221. iio_device_unregister(indio_dev);
  222. sensor_hub_remove_callback(hsdev, HID_USAGE_SENSOR_HUMIDITY);
  223. hid_sensor_remove_trigger(indio_dev, &humid_st->common_attributes);
  224. return 0;
  225. }
  226. static const struct platform_device_id hid_humidity_ids[] = {
  227. {
  228. /* Format: HID-SENSOR-usage_id_in_hex_lowercase */
  229. .name = "HID-SENSOR-200032",
  230. },
  231. { /* sentinel */ }
  232. };
  233. MODULE_DEVICE_TABLE(platform, hid_humidity_ids);
  234. static struct platform_driver hid_humidity_platform_driver = {
  235. .id_table = hid_humidity_ids,
  236. .driver = {
  237. .name = KBUILD_MODNAME,
  238. .pm = &hid_sensor_pm_ops,
  239. },
  240. .probe = hid_humidity_probe,
  241. .remove = hid_humidity_remove,
  242. };
  243. module_platform_driver(hid_humidity_platform_driver);
  244. MODULE_DESCRIPTION("HID Environmental humidity sensor");
  245. MODULE_AUTHOR("Song Hongyan <[email protected]>");
  246. MODULE_LICENSE("GPL v2");
  247. MODULE_IMPORT_NS(IIO_HID);