1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * HID Sensors Driver
4 * Copyright (c) 2012, Intel Corporation.
5 */
6 #include <linux/device.h>
7 #include <linux/platform_device.h>
8 #include <linux/module.h>
9 #include <linux/mod_devicetable.h>
10 #include <linux/slab.h>
11 #include <linux/hid-sensor-hub.h>
12 #include <linux/iio/iio.h>
13 #include <linux/iio/buffer.h>
14 #include "../common/hid-sensors/hid-sensor-trigger.h"
15
16 enum {
17 CHANNEL_SCAN_INDEX_INTENSITY = 0,
18 CHANNEL_SCAN_INDEX_ILLUM = 1,
19 CHANNEL_SCAN_INDEX_MAX
20 };
21
22 #define CHANNEL_SCAN_INDEX_TIMESTAMP CHANNEL_SCAN_INDEX_MAX
23
24 struct als_state {
25 struct hid_sensor_hub_callbacks callbacks;
26 struct hid_sensor_common common_attributes;
27 struct hid_sensor_hub_attribute_info als_illum;
28 struct {
29 u32 illum[CHANNEL_SCAN_INDEX_MAX];
30 u64 timestamp __aligned(8);
31 } scan;
32 int scale_pre_decml;
33 int scale_post_decml;
34 int scale_precision;
35 int value_offset;
36 s64 timestamp;
37 };
38
39 static const u32 als_sensitivity_addresses[] = {
40 HID_USAGE_SENSOR_DATA_LIGHT,
41 HID_USAGE_SENSOR_LIGHT_ILLUM,
42 };
43
44 /* Channel definitions */
45 static const struct iio_chan_spec als_channels[] = {
46 {
47 .type = IIO_INTENSITY,
48 .modified = 1,
49 .channel2 = IIO_MOD_LIGHT_BOTH,
50 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
51 .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_OFFSET) |
52 BIT(IIO_CHAN_INFO_SCALE) |
53 BIT(IIO_CHAN_INFO_SAMP_FREQ) |
54 BIT(IIO_CHAN_INFO_HYSTERESIS) |
55 BIT(IIO_CHAN_INFO_HYSTERESIS_RELATIVE),
56 .scan_index = CHANNEL_SCAN_INDEX_INTENSITY,
57 },
58 {
59 .type = IIO_LIGHT,
60 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
61 .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_OFFSET) |
62 BIT(IIO_CHAN_INFO_SCALE) |
63 BIT(IIO_CHAN_INFO_SAMP_FREQ) |
64 BIT(IIO_CHAN_INFO_HYSTERESIS) |
65 BIT(IIO_CHAN_INFO_HYSTERESIS_RELATIVE),
66 .scan_index = CHANNEL_SCAN_INDEX_ILLUM,
67 },
68 IIO_CHAN_SOFT_TIMESTAMP(CHANNEL_SCAN_INDEX_TIMESTAMP)
69 };
70
71 /* Adjust channel real bits based on report descriptor */
als_adjust_channel_bit_mask(struct iio_chan_spec * channels,int channel,int size)72 static void als_adjust_channel_bit_mask(struct iio_chan_spec *channels,
73 int channel, int size)
74 {
75 channels[channel].scan_type.sign = 's';
76 /* Real storage bits will change based on the report desc. */
77 channels[channel].scan_type.realbits = size * 8;
78 /* Maximum size of a sample to capture is u32 */
79 channels[channel].scan_type.storagebits = sizeof(u32) * 8;
80 }
81
82 /* Channel read_raw handler */
als_read_raw(struct iio_dev * indio_dev,struct iio_chan_spec const * chan,int * val,int * val2,long mask)83 static int als_read_raw(struct iio_dev *indio_dev,
84 struct iio_chan_spec const *chan,
85 int *val, int *val2,
86 long mask)
87 {
88 struct als_state *als_state = iio_priv(indio_dev);
89 int report_id = -1;
90 u32 address;
91 int ret_type;
92 s32 min;
93
94 *val = 0;
95 *val2 = 0;
96 switch (mask) {
97 case IIO_CHAN_INFO_RAW:
98 switch (chan->scan_index) {
99 case CHANNEL_SCAN_INDEX_INTENSITY:
100 case CHANNEL_SCAN_INDEX_ILLUM:
101 report_id = als_state->als_illum.report_id;
102 min = als_state->als_illum.logical_minimum;
103 address = HID_USAGE_SENSOR_LIGHT_ILLUM;
104 break;
105 default:
106 report_id = -1;
107 break;
108 }
109 if (report_id >= 0) {
110 hid_sensor_power_state(&als_state->common_attributes,
111 true);
112 *val = sensor_hub_input_attr_get_raw_value(
113 als_state->common_attributes.hsdev,
114 HID_USAGE_SENSOR_ALS, address,
115 report_id,
116 SENSOR_HUB_SYNC,
117 min < 0);
118 hid_sensor_power_state(&als_state->common_attributes,
119 false);
120 } else {
121 *val = 0;
122 return -EINVAL;
123 }
124 ret_type = IIO_VAL_INT;
125 break;
126 case IIO_CHAN_INFO_SCALE:
127 *val = als_state->scale_pre_decml;
128 *val2 = als_state->scale_post_decml;
129 ret_type = als_state->scale_precision;
130 break;
131 case IIO_CHAN_INFO_OFFSET:
132 *val = als_state->value_offset;
133 ret_type = IIO_VAL_INT;
134 break;
135 case IIO_CHAN_INFO_SAMP_FREQ:
136 ret_type = hid_sensor_read_samp_freq_value(
137 &als_state->common_attributes, val, val2);
138 break;
139 case IIO_CHAN_INFO_HYSTERESIS:
140 ret_type = hid_sensor_read_raw_hyst_value(
141 &als_state->common_attributes, val, val2);
142 break;
143 case IIO_CHAN_INFO_HYSTERESIS_RELATIVE:
144 ret_type = hid_sensor_read_raw_hyst_rel_value(
145 &als_state->common_attributes, val, val2);
146 break;
147 default:
148 ret_type = -EINVAL;
149 break;
150 }
151
152 return ret_type;
153 }
154
155 /* Channel write_raw handler */
als_write_raw(struct iio_dev * indio_dev,struct iio_chan_spec const * chan,int val,int val2,long mask)156 static int als_write_raw(struct iio_dev *indio_dev,
157 struct iio_chan_spec const *chan,
158 int val,
159 int val2,
160 long mask)
161 {
162 struct als_state *als_state = iio_priv(indio_dev);
163 int ret = 0;
164
165 switch (mask) {
166 case IIO_CHAN_INFO_SAMP_FREQ:
167 ret = hid_sensor_write_samp_freq_value(
168 &als_state->common_attributes, val, val2);
169 break;
170 case IIO_CHAN_INFO_HYSTERESIS:
171 ret = hid_sensor_write_raw_hyst_value(
172 &als_state->common_attributes, val, val2);
173 break;
174 case IIO_CHAN_INFO_HYSTERESIS_RELATIVE:
175 ret = hid_sensor_write_raw_hyst_rel_value(
176 &als_state->common_attributes, val, val2);
177 break;
178 default:
179 ret = -EINVAL;
180 }
181
182 return ret;
183 }
184
185 static const struct iio_info als_info = {
186 .read_raw = &als_read_raw,
187 .write_raw = &als_write_raw,
188 };
189
190 /* Callback handler to send event after all samples are received and captured */
als_proc_event(struct hid_sensor_hub_device * hsdev,unsigned usage_id,void * priv)191 static int als_proc_event(struct hid_sensor_hub_device *hsdev,
192 unsigned usage_id,
193 void *priv)
194 {
195 struct iio_dev *indio_dev = platform_get_drvdata(priv);
196 struct als_state *als_state = iio_priv(indio_dev);
197
198 dev_dbg(&indio_dev->dev, "als_proc_event\n");
199 if (atomic_read(&als_state->common_attributes.data_ready)) {
200 if (!als_state->timestamp)
201 als_state->timestamp = iio_get_time_ns(indio_dev);
202
203 iio_push_to_buffers_with_timestamp(indio_dev, &als_state->scan,
204 als_state->timestamp);
205 als_state->timestamp = 0;
206 }
207
208 return 0;
209 }
210
211 /* Capture samples in local storage */
als_capture_sample(struct hid_sensor_hub_device * hsdev,unsigned usage_id,size_t raw_len,char * raw_data,void * priv)212 static int als_capture_sample(struct hid_sensor_hub_device *hsdev,
213 unsigned usage_id,
214 size_t raw_len, char *raw_data,
215 void *priv)
216 {
217 struct iio_dev *indio_dev = platform_get_drvdata(priv);
218 struct als_state *als_state = iio_priv(indio_dev);
219 int ret = -EINVAL;
220 u32 sample_data = *(u32 *)raw_data;
221
222 switch (usage_id) {
223 case HID_USAGE_SENSOR_LIGHT_ILLUM:
224 als_state->scan.illum[CHANNEL_SCAN_INDEX_INTENSITY] = sample_data;
225 als_state->scan.illum[CHANNEL_SCAN_INDEX_ILLUM] = sample_data;
226 ret = 0;
227 break;
228 case HID_USAGE_SENSOR_TIME_TIMESTAMP:
229 als_state->timestamp = hid_sensor_convert_timestamp(&als_state->common_attributes,
230 *(s64 *)raw_data);
231 break;
232 default:
233 break;
234 }
235
236 return ret;
237 }
238
239 /* Parse report which is specific to an usage id*/
als_parse_report(struct platform_device * pdev,struct hid_sensor_hub_device * hsdev,struct iio_chan_spec * channels,unsigned usage_id,struct als_state * st)240 static int als_parse_report(struct platform_device *pdev,
241 struct hid_sensor_hub_device *hsdev,
242 struct iio_chan_spec *channels,
243 unsigned usage_id,
244 struct als_state *st)
245 {
246 int ret;
247
248 ret = sensor_hub_input_get_attribute_info(hsdev, HID_INPUT_REPORT,
249 usage_id,
250 HID_USAGE_SENSOR_LIGHT_ILLUM,
251 &st->als_illum);
252 if (ret < 0)
253 return ret;
254 als_adjust_channel_bit_mask(channels, CHANNEL_SCAN_INDEX_INTENSITY,
255 st->als_illum.size);
256 als_adjust_channel_bit_mask(channels, CHANNEL_SCAN_INDEX_ILLUM,
257 st->als_illum.size);
258
259 dev_dbg(&pdev->dev, "als %x:%x\n", st->als_illum.index,
260 st->als_illum.report_id);
261
262 st->scale_precision = hid_sensor_format_scale(
263 HID_USAGE_SENSOR_ALS,
264 &st->als_illum,
265 &st->scale_pre_decml, &st->scale_post_decml);
266
267 return ret;
268 }
269
270 /* Function to initialize the processing for usage id */
hid_als_probe(struct platform_device * pdev)271 static int hid_als_probe(struct platform_device *pdev)
272 {
273 int ret = 0;
274 static const char *name = "als";
275 struct iio_dev *indio_dev;
276 struct als_state *als_state;
277 struct hid_sensor_hub_device *hsdev = pdev->dev.platform_data;
278
279 indio_dev = devm_iio_device_alloc(&pdev->dev, sizeof(struct als_state));
280 if (!indio_dev)
281 return -ENOMEM;
282 platform_set_drvdata(pdev, indio_dev);
283
284 als_state = iio_priv(indio_dev);
285 als_state->common_attributes.hsdev = hsdev;
286 als_state->common_attributes.pdev = pdev;
287
288 ret = hid_sensor_parse_common_attributes(hsdev, HID_USAGE_SENSOR_ALS,
289 &als_state->common_attributes,
290 als_sensitivity_addresses,
291 ARRAY_SIZE(als_sensitivity_addresses));
292 if (ret) {
293 dev_err(&pdev->dev, "failed to setup common attributes\n");
294 return ret;
295 }
296
297 indio_dev->channels = devm_kmemdup(&pdev->dev, als_channels,
298 sizeof(als_channels), GFP_KERNEL);
299 if (!indio_dev->channels) {
300 dev_err(&pdev->dev, "failed to duplicate channels\n");
301 return -ENOMEM;
302 }
303
304 ret = als_parse_report(pdev, hsdev,
305 (struct iio_chan_spec *)indio_dev->channels,
306 HID_USAGE_SENSOR_ALS, als_state);
307 if (ret) {
308 dev_err(&pdev->dev, "failed to setup attributes\n");
309 return ret;
310 }
311
312 indio_dev->num_channels =
313 ARRAY_SIZE(als_channels);
314 indio_dev->info = &als_info;
315 indio_dev->name = name;
316 indio_dev->modes = INDIO_DIRECT_MODE;
317
318 atomic_set(&als_state->common_attributes.data_ready, 0);
319
320 ret = hid_sensor_setup_trigger(indio_dev, name,
321 &als_state->common_attributes);
322 if (ret < 0) {
323 dev_err(&pdev->dev, "trigger setup failed\n");
324 return ret;
325 }
326
327 ret = iio_device_register(indio_dev);
328 if (ret) {
329 dev_err(&pdev->dev, "device register failed\n");
330 goto error_remove_trigger;
331 }
332
333 als_state->callbacks.send_event = als_proc_event;
334 als_state->callbacks.capture_sample = als_capture_sample;
335 als_state->callbacks.pdev = pdev;
336 ret = sensor_hub_register_callback(hsdev, HID_USAGE_SENSOR_ALS,
337 &als_state->callbacks);
338 if (ret < 0) {
339 dev_err(&pdev->dev, "callback reg failed\n");
340 goto error_iio_unreg;
341 }
342
343 return ret;
344
345 error_iio_unreg:
346 iio_device_unregister(indio_dev);
347 error_remove_trigger:
348 hid_sensor_remove_trigger(indio_dev, &als_state->common_attributes);
349 return ret;
350 }
351
352 /* Function to deinitialize the processing for usage id */
hid_als_remove(struct platform_device * pdev)353 static int hid_als_remove(struct platform_device *pdev)
354 {
355 struct hid_sensor_hub_device *hsdev = pdev->dev.platform_data;
356 struct iio_dev *indio_dev = platform_get_drvdata(pdev);
357 struct als_state *als_state = iio_priv(indio_dev);
358
359 sensor_hub_remove_callback(hsdev, HID_USAGE_SENSOR_ALS);
360 iio_device_unregister(indio_dev);
361 hid_sensor_remove_trigger(indio_dev, &als_state->common_attributes);
362
363 return 0;
364 }
365
366 static const struct platform_device_id hid_als_ids[] = {
367 {
368 /* Format: HID-SENSOR-usage_id_in_hex_lowercase */
369 .name = "HID-SENSOR-200041",
370 },
371 { /* sentinel */ }
372 };
373 MODULE_DEVICE_TABLE(platform, hid_als_ids);
374
375 static struct platform_driver hid_als_platform_driver = {
376 .id_table = hid_als_ids,
377 .driver = {
378 .name = KBUILD_MODNAME,
379 .pm = &hid_sensor_pm_ops,
380 },
381 .probe = hid_als_probe,
382 .remove = hid_als_remove,
383 };
384 module_platform_driver(hid_als_platform_driver);
385
386 MODULE_DESCRIPTION("HID Sensor ALS");
387 MODULE_AUTHOR("Srinivas Pandruvada <srinivas.pandruvada@intel.com>");
388 MODULE_LICENSE("GPL");
389 MODULE_IMPORT_NS(IIO_HID);
390