]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - drivers/rtc/rtc-hid-sensor-time.c
Merge branch 'linux-4.15' of git://github.com/skeggsb/linux into drm-fixes
[mirror_ubuntu-bionic-kernel.git] / drivers / rtc / rtc-hid-sensor-time.c
CommitLineData
62e00cb9
AH
1/*
2 * HID Sensor Time Driver
3 * Copyright (c) 2012, Alexander Holler.
4 *
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
8 *
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12 * more details.
13 *
14 * You should have received a copy of the GNU General Public License along with
15 * this program; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
17 *
18 */
19#include <linux/device.h>
20#include <linux/platform_device.h>
21#include <linux/module.h>
22#include <linux/hid-sensor-hub.h>
23#include <linux/iio/iio.h>
24#include <linux/rtc.h>
25
62e00cb9
AH
26enum hid_time_channel {
27 CHANNEL_SCAN_INDEX_YEAR,
28 CHANNEL_SCAN_INDEX_MONTH,
29 CHANNEL_SCAN_INDEX_DAY,
30 CHANNEL_SCAN_INDEX_HOUR,
31 CHANNEL_SCAN_INDEX_MINUTE,
32 CHANNEL_SCAN_INDEX_SECOND,
33 TIME_RTC_CHANNEL_MAX,
34};
35
36struct hid_time_state {
37 struct hid_sensor_hub_callbacks callbacks;
e07c6d17 38 struct hid_sensor_common common_attributes;
62e00cb9
AH
39 struct hid_sensor_hub_attribute_info info[TIME_RTC_CHANNEL_MAX];
40 struct rtc_time last_time;
41 spinlock_t lock_last_time;
42 struct completion comp_last_time;
43 struct rtc_time time_buf;
44 struct rtc_device *rtc;
45};
46
47static const u32 hid_time_addresses[TIME_RTC_CHANNEL_MAX] = {
48 HID_USAGE_SENSOR_TIME_YEAR,
49 HID_USAGE_SENSOR_TIME_MONTH,
50 HID_USAGE_SENSOR_TIME_DAY,
51 HID_USAGE_SENSOR_TIME_HOUR,
52 HID_USAGE_SENSOR_TIME_MINUTE,
53 HID_USAGE_SENSOR_TIME_SECOND,
54};
55
56/* Channel names for verbose error messages */
57static const char * const hid_time_channel_names[TIME_RTC_CHANNEL_MAX] = {
58 "year", "month", "day", "hour", "minute", "second",
59};
60
61/* Callback handler to send event after all samples are received and captured */
62static int hid_time_proc_event(struct hid_sensor_hub_device *hsdev,
63 unsigned usage_id, void *priv)
64{
65 unsigned long flags;
66 struct hid_time_state *time_state = platform_get_drvdata(priv);
67
68 spin_lock_irqsave(&time_state->lock_last_time, flags);
69 time_state->last_time = time_state->time_buf;
70 spin_unlock_irqrestore(&time_state->lock_last_time, flags);
71 complete(&time_state->comp_last_time);
72 return 0;
73}
74
c67d96e3
AH
75static u32 hid_time_value(size_t raw_len, char *raw_data)
76{
77 switch (raw_len) {
78 case 1:
79 return *(u8 *)raw_data;
80 case 2:
81 return *(u16 *)raw_data;
82 case 4:
83 return *(u32 *)raw_data;
84 default:
85 return (u32)(~0U); /* 0xff... or -1 to denote an error */
86 }
87}
88
62e00cb9
AH
89static int hid_time_capture_sample(struct hid_sensor_hub_device *hsdev,
90 unsigned usage_id, size_t raw_len,
91 char *raw_data, void *priv)
92{
93 struct hid_time_state *time_state = platform_get_drvdata(priv);
94 struct rtc_time *time_buf = &time_state->time_buf;
95
96 switch (usage_id) {
97 case HID_USAGE_SENSOR_TIME_YEAR:
c67d96e3
AH
98 /*
99 * The draft for HID-sensors (HUTRR39) currently doesn't define
100 * the range for the year attribute. Therefor we support
101 * 8 bit (0-99) and 16 or 32 bits (full) as size for the year.
102 */
7e3c741a
AH
103 if (raw_len == 1) {
104 time_buf->tm_year = *(u8 *)raw_data;
105 if (time_buf->tm_year < 70)
106 /* assume we are in 1970...2069 */
107 time_buf->tm_year += 100;
108 } else
c67d96e3
AH
109 time_buf->tm_year =
110 (int)hid_time_value(raw_len, raw_data)-1900;
62e00cb9
AH
111 break;
112 case HID_USAGE_SENSOR_TIME_MONTH:
c67d96e3
AH
113 /* sensors are sending the month as 1-12, we need 0-11 */
114 time_buf->tm_mon = (int)hid_time_value(raw_len, raw_data)-1;
62e00cb9
AH
115 break;
116 case HID_USAGE_SENSOR_TIME_DAY:
c67d96e3 117 time_buf->tm_mday = (int)hid_time_value(raw_len, raw_data);
62e00cb9
AH
118 break;
119 case HID_USAGE_SENSOR_TIME_HOUR:
c67d96e3 120 time_buf->tm_hour = (int)hid_time_value(raw_len, raw_data);
62e00cb9
AH
121 break;
122 case HID_USAGE_SENSOR_TIME_MINUTE:
c67d96e3 123 time_buf->tm_min = (int)hid_time_value(raw_len, raw_data);
62e00cb9
AH
124 break;
125 case HID_USAGE_SENSOR_TIME_SECOND:
c67d96e3 126 time_buf->tm_sec = (int)hid_time_value(raw_len, raw_data);
62e00cb9
AH
127 break;
128 default:
129 return -EINVAL;
130 }
131 return 0;
132}
133
134/* small helper, haven't found any other way */
135static const char *hid_time_attrib_name(u32 attrib_id)
136{
137 static const char unknown[] = "unknown";
138 unsigned i;
139
140 for (i = 0; i < TIME_RTC_CHANNEL_MAX; ++i) {
141 if (hid_time_addresses[i] == attrib_id)
142 return hid_time_channel_names[i];
143 }
144 return unknown; /* should never happen */
145}
146
147static int hid_time_parse_report(struct platform_device *pdev,
148 struct hid_sensor_hub_device *hsdev,
149 unsigned usage_id,
150 struct hid_time_state *time_state)
151{
152 int report_id, i;
153
154 for (i = 0; i < TIME_RTC_CHANNEL_MAX; ++i)
155 if (sensor_hub_input_get_attribute_info(hsdev,
156 HID_INPUT_REPORT, usage_id,
157 hid_time_addresses[i],
158 &time_state->info[i]) < 0)
159 return -EINVAL;
160 /* Check the (needed) attributes for sanity */
161 report_id = time_state->info[0].report_id;
162 if (report_id < 0) {
163 dev_err(&pdev->dev, "bad report ID!\n");
164 return -EINVAL;
165 }
166 for (i = 0; i < TIME_RTC_CHANNEL_MAX; ++i) {
167 if (time_state->info[i].report_id != report_id) {
168 dev_err(&pdev->dev,
169 "not all needed attributes inside the same report!\n");
170 return -EINVAL;
171 }
c67d96e3
AH
172 if (time_state->info[i].size == 3 ||
173 time_state->info[i].size > 4) {
174 dev_err(&pdev->dev,
175 "attribute '%s' not 8, 16 or 32 bits wide!\n",
7e3c741a
AH
176 hid_time_attrib_name(
177 time_state->info[i].attrib_id));
c67d96e3 178 return -EINVAL;
62e00cb9
AH
179 }
180 if (time_state->info[i].units !=
181 HID_USAGE_SENSOR_UNITS_NOT_SPECIFIED &&
182 /* allow attribute seconds with unit seconds */
183 !(time_state->info[i].attrib_id ==
184 HID_USAGE_SENSOR_TIME_SECOND &&
185 time_state->info[i].units ==
186 HID_USAGE_SENSOR_UNITS_SECOND)) {
187 dev_err(&pdev->dev,
188 "attribute '%s' hasn't a unit of type 'none'!\n",
189 hid_time_attrib_name(
190 time_state->info[i].attrib_id));
191 return -EINVAL;
192 }
193 if (time_state->info[i].unit_expo) {
194 dev_err(&pdev->dev,
195 "attribute '%s' hasn't a unit exponent of 1!\n",
196 hid_time_attrib_name(
197 time_state->info[i].attrib_id));
198 return -EINVAL;
199 }
200 }
201
202 return 0;
203}
204
205static int hid_rtc_read_time(struct device *dev, struct rtc_time *tm)
206{
207 unsigned long flags;
208 struct hid_time_state *time_state =
209 platform_get_drvdata(to_platform_device(dev));
210 int ret;
211
16735d02 212 reinit_completion(&time_state->comp_last_time);
62e00cb9
AH
213 /* get a report with all values through requesting one value */
214 sensor_hub_input_attr_get_raw_value(time_state->common_attributes.hsdev,
215 HID_USAGE_SENSOR_TIME, hid_time_addresses[0],
b3f4737d 216 time_state->info[0].report_id, SENSOR_HUB_SYNC);
62e00cb9
AH
217 /* wait for all values (event) */
218 ret = wait_for_completion_killable_timeout(
219 &time_state->comp_last_time, HZ*6);
220 if (ret > 0) {
221 /* no error */
222 spin_lock_irqsave(&time_state->lock_last_time, flags);
223 *tm = time_state->last_time;
224 spin_unlock_irqrestore(&time_state->lock_last_time, flags);
225 return 0;
226 }
227 if (!ret)
228 return -EIO; /* timeouted */
229 return ret; /* killed (-ERESTARTSYS) */
230}
231
232static const struct rtc_class_ops hid_time_rtc_ops = {
233 .read_time = hid_rtc_read_time,
234};
235
236static int hid_time_probe(struct platform_device *pdev)
237{
238 int ret = 0;
d5ceede8 239 struct hid_sensor_hub_device *hsdev = dev_get_platdata(&pdev->dev);
62e00cb9
AH
240 struct hid_time_state *time_state = devm_kzalloc(&pdev->dev,
241 sizeof(struct hid_time_state), GFP_KERNEL);
242
243 if (time_state == NULL)
244 return -ENOMEM;
245
246 platform_set_drvdata(pdev, time_state);
247
b775dce9 248 spin_lock_init(&time_state->lock_last_time);
62e00cb9
AH
249 init_completion(&time_state->comp_last_time);
250 time_state->common_attributes.hsdev = hsdev;
251 time_state->common_attributes.pdev = pdev;
252
253 ret = hid_sensor_parse_common_attributes(hsdev,
254 HID_USAGE_SENSOR_TIME,
255 &time_state->common_attributes);
256 if (ret) {
257 dev_err(&pdev->dev, "failed to setup common attributes!\n");
258 return ret;
259 }
260
261 ret = hid_time_parse_report(pdev, hsdev, HID_USAGE_SENSOR_TIME,
262 time_state);
263 if (ret) {
264 dev_err(&pdev->dev, "failed to setup attributes!\n");
265 return ret;
266 }
267
268 time_state->callbacks.send_event = hid_time_proc_event;
269 time_state->callbacks.capture_sample = hid_time_capture_sample;
270 time_state->callbacks.pdev = pdev;
271 ret = sensor_hub_register_callback(hsdev, HID_USAGE_SENSOR_TIME,
272 &time_state->callbacks);
273 if (ret < 0) {
274 dev_err(&pdev->dev, "register callback failed!\n");
275 return ret;
276 }
277
476b9547
SP
278 ret = sensor_hub_device_open(hsdev);
279 if (ret) {
280 dev_err(&pdev->dev, "failed to open sensor hub device!\n");
281 goto err_open;
282 }
283
406bf318
AH
284 /*
285 * Enable HID input processing early in order to be able to read the
286 * clock already in devm_rtc_device_register().
287 */
288 hid_device_io_start(hsdev->hdev);
289
479243b2
JH
290 time_state->rtc = devm_rtc_device_register(&pdev->dev,
291 "hid-sensor-time", &hid_time_rtc_ops,
292 THIS_MODULE);
62e00cb9 293
e73ef755 294 if (IS_ERR(time_state->rtc)) {
406bf318 295 hid_device_io_stop(hsdev->hdev);
e73ef755 296 ret = PTR_ERR(time_state->rtc);
7707bda3 297 time_state->rtc = NULL;
62e00cb9 298 dev_err(&pdev->dev, "rtc device register failed!\n");
476b9547 299 goto err_rtc;
62e00cb9
AH
300 }
301
302 return ret;
476b9547
SP
303
304err_rtc:
305 sensor_hub_device_close(hsdev);
306err_open:
307 sensor_hub_remove_callback(hsdev, HID_USAGE_SENSOR_TIME);
308 return ret;
62e00cb9
AH
309}
310
311static int hid_time_remove(struct platform_device *pdev)
312{
d5ceede8 313 struct hid_sensor_hub_device *hsdev = dev_get_platdata(&pdev->dev);
62e00cb9 314
476b9547 315 sensor_hub_device_close(hsdev);
62e00cb9
AH
316 sensor_hub_remove_callback(hsdev, HID_USAGE_SENSOR_TIME);
317
318 return 0;
319}
320
19fd685f 321static const struct platform_device_id hid_time_ids[] = {
ae259925
AH
322 {
323 /* Format: HID-SENSOR-usage_id_in_hex_lowercase */
324 .name = "HID-SENSOR-2000a0",
325 },
326 { /* sentinel */ }
327};
328MODULE_DEVICE_TABLE(platform, hid_time_ids);
329
62e00cb9 330static struct platform_driver hid_time_platform_driver = {
ae259925 331 .id_table = hid_time_ids,
62e00cb9 332 .driver = {
ae259925 333 .name = KBUILD_MODNAME,
62e00cb9
AH
334 },
335 .probe = hid_time_probe,
336 .remove = hid_time_remove,
337};
338module_platform_driver(hid_time_platform_driver);
339
340MODULE_DESCRIPTION("HID Sensor Time");
341MODULE_AUTHOR("Alexander Holler <holler@ahsoftware.de>");
342MODULE_LICENSE("GPL");