2 * Copyright (c) 2013 Andrew Duggan <aduggan@synaptics.com>
3 * Copyright (c) 2013 Synaptics Incorporated
4 * Copyright (c) 2014 Benjamin Tissoires <benjamin.tissoires@gmail.com>
5 * Copyright (c) 2014 Red Hat, Inc
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the Free
9 * Software Foundation; either version 2 of the License, or (at your option)
13 #include <linux/kernel.h>
14 #include <linux/hid.h>
15 #include <linux/input.h>
16 #include <linux/input/mt.h>
17 #include <linux/irq.h>
18 #include <linux/irqdomain.h>
19 #include <linux/module.h>
21 #include <linux/slab.h>
22 #include <linux/wait.h>
23 #include <linux/sched.h>
24 #include <linux/rmi.h>
27 #define RMI_MOUSE_REPORT_ID 0x01 /* Mouse emulation Report */
28 #define RMI_WRITE_REPORT_ID 0x09 /* Output Report */
29 #define RMI_READ_ADDR_REPORT_ID 0x0a /* Output Report */
30 #define RMI_READ_DATA_REPORT_ID 0x0b /* Input Report */
31 #define RMI_ATTN_REPORT_ID 0x0c /* Input Report */
32 #define RMI_SET_RMI_MODE_REPORT_ID 0x0f /* Feature Report */
35 #define RMI_READ_REQUEST_PENDING 0
36 #define RMI_READ_DATA_PENDING 1
40 #define RMI_DEVICE BIT(0)
41 #define RMI_DEVICE_HAS_PHYS_BUTTONS BIT(1)
44 * retrieve the ctrl registers
45 * the ctrl register has a size of 20 but a fw bug split it into 16 + 4,
46 * and there is no way to know if the first 20 bytes are here or not.
47 * We use only the first 12 bytes, so get only them.
49 #define RMI_F11_CTRL_REG_COUNT 12
53 RMI_MODE_ATTN_REPORTS
= 1,
54 RMI_MODE_NO_PACKED_ATTN_REPORTS
= 2,
58 * struct rmi_data - stores information for hid communication
60 * @page_mutex: Locks current page to avoid changing pages in unexpected ways.
61 * @page: Keeps track of the current virtual page
62 * @xport: transport device to be registered with the RMI4 core.
64 * @wait: Used for waiting for read data
66 * @writeReport: output buffer when writing RMI registers
67 * @readReport: input buffer when reading RMI registers
69 * @input_report_size: size of an input report (advertised by HID)
70 * @output_report_size: size of an output report (advertised by HID)
72 * @flags: flags for the current device (started, reading, etc...)
74 * @reset_work: worker which will be called in case of a mouse report
75 * @hdev: pointer to the struct hid_device
77 * @device_flags: flags which describe the device
79 * @domain: the IRQ domain allocated for this RMI4 device
80 * @rmi_irq: the irq that will be used to generate events to rmi-core
83 struct mutex page_mutex
;
85 struct rmi_transport_dev xport
;
87 wait_queue_head_t wait
;
92 u32 input_report_size
;
93 u32 output_report_size
;
97 struct work_struct reset_work
;
98 struct hid_device
*hdev
;
100 unsigned long device_flags
;
102 struct irq_domain
*domain
;
106 #define RMI_PAGE(addr) (((addr) >> 8) & 0xff)
108 static int rmi_write_report(struct hid_device
*hdev
, u8
*report
, int len
);
111 * rmi_set_page - Set RMI page
112 * @hdev: The pointer to the hid_device struct
113 * @page: The new page address.
115 * RMI devices have 16-bit addressing, but some of the physical
116 * implementations (like SMBus) only have 8-bit addressing. So RMI implements
117 * a page address at 0xff of every page so we can reliable page addresses
118 * every 256 registers.
120 * The page_mutex lock must be held when this function is entered.
122 * Returns zero on success, non-zero on failure.
124 static int rmi_set_page(struct hid_device
*hdev
, u8 page
)
126 struct rmi_data
*data
= hid_get_drvdata(hdev
);
129 data
->writeReport
[0] = RMI_WRITE_REPORT_ID
;
130 data
->writeReport
[1] = 1;
131 data
->writeReport
[2] = 0xFF;
132 data
->writeReport
[4] = page
;
134 retval
= rmi_write_report(hdev
, data
->writeReport
,
135 data
->output_report_size
);
136 if (retval
!= data
->output_report_size
) {
138 "%s: set page failed: %d.", __func__
, retval
);
146 static int rmi_set_mode(struct hid_device
*hdev
, u8 mode
)
149 const u8 txbuf
[2] = {RMI_SET_RMI_MODE_REPORT_ID
, mode
};
152 buf
= kmemdup(txbuf
, sizeof(txbuf
), GFP_KERNEL
);
156 ret
= hid_hw_raw_request(hdev
, RMI_SET_RMI_MODE_REPORT_ID
, buf
,
157 sizeof(txbuf
), HID_FEATURE_REPORT
, HID_REQ_SET_REPORT
);
160 dev_err(&hdev
->dev
, "unable to set rmi mode to %d (%d)\n", mode
,
168 static int rmi_write_report(struct hid_device
*hdev
, u8
*report
, int len
)
172 ret
= hid_hw_output_report(hdev
, (void *)report
, len
);
174 dev_err(&hdev
->dev
, "failed to write hid report (%d)\n", ret
);
181 static int rmi_hid_read_block(struct rmi_transport_dev
*xport
, u16 addr
,
182 void *buf
, size_t len
)
184 struct rmi_data
*data
= container_of(xport
, struct rmi_data
, xport
);
185 struct hid_device
*hdev
= data
->hdev
;
190 int read_input_count
;
192 mutex_lock(&data
->page_mutex
);
194 if (RMI_PAGE(addr
) != data
->page
) {
195 ret
= rmi_set_page(hdev
, RMI_PAGE(addr
));
200 for (retries
= 5; retries
> 0; retries
--) {
201 data
->writeReport
[0] = RMI_READ_ADDR_REPORT_ID
;
202 data
->writeReport
[1] = 0; /* old 1 byte read count */
203 data
->writeReport
[2] = addr
& 0xFF;
204 data
->writeReport
[3] = (addr
>> 8) & 0xFF;
205 data
->writeReport
[4] = len
& 0xFF;
206 data
->writeReport
[5] = (len
>> 8) & 0xFF;
208 set_bit(RMI_READ_REQUEST_PENDING
, &data
->flags
);
210 ret
= rmi_write_report(hdev
, data
->writeReport
,
211 data
->output_report_size
);
212 if (ret
!= data
->output_report_size
) {
213 clear_bit(RMI_READ_REQUEST_PENDING
, &data
->flags
);
215 "failed to write request output report (%d)\n",
222 while (bytes_read
< len
) {
223 if (!wait_event_timeout(data
->wait
,
224 test_bit(RMI_READ_DATA_PENDING
, &data
->flags
),
225 msecs_to_jiffies(1000))) {
226 hid_warn(hdev
, "%s: timeout elapsed\n",
232 read_input_count
= data
->readReport
[1];
233 memcpy(buf
+ bytes_read
, &data
->readReport
[2],
234 read_input_count
< bytes_needed
?
235 read_input_count
: bytes_needed
);
237 bytes_read
+= read_input_count
;
238 bytes_needed
-= read_input_count
;
239 clear_bit(RMI_READ_DATA_PENDING
, &data
->flags
);
249 clear_bit(RMI_READ_REQUEST_PENDING
, &data
->flags
);
250 mutex_unlock(&data
->page_mutex
);
254 static int rmi_hid_write_block(struct rmi_transport_dev
*xport
, u16 addr
,
255 const void *buf
, size_t len
)
257 struct rmi_data
*data
= container_of(xport
, struct rmi_data
, xport
);
258 struct hid_device
*hdev
= data
->hdev
;
261 mutex_lock(&data
->page_mutex
);
263 if (RMI_PAGE(addr
) != data
->page
) {
264 ret
= rmi_set_page(hdev
, RMI_PAGE(addr
));
269 data
->writeReport
[0] = RMI_WRITE_REPORT_ID
;
270 data
->writeReport
[1] = len
;
271 data
->writeReport
[2] = addr
& 0xFF;
272 data
->writeReport
[3] = (addr
>> 8) & 0xFF;
273 memcpy(&data
->writeReport
[4], buf
, len
);
275 ret
= rmi_write_report(hdev
, data
->writeReport
,
276 data
->output_report_size
);
279 "failed to write request output report (%d)\n",
286 mutex_unlock(&data
->page_mutex
);
290 static int rmi_reset_attn_mode(struct hid_device
*hdev
)
292 struct rmi_data
*data
= hid_get_drvdata(hdev
);
293 struct rmi_device
*rmi_dev
= data
->xport
.rmi_dev
;
296 ret
= rmi_set_mode(hdev
, RMI_MODE_ATTN_REPORTS
);
300 if (test_bit(RMI_STARTED
, &data
->flags
))
301 ret
= rmi_dev
->driver
->reset_handler(rmi_dev
);
306 static void rmi_reset_work(struct work_struct
*work
)
308 struct rmi_data
*hdata
= container_of(work
, struct rmi_data
,
311 /* switch the device to RMI if we receive a generic mouse report */
312 rmi_reset_attn_mode(hdata
->hdev
);
315 static int rmi_input_event(struct hid_device
*hdev
, u8
*data
, int size
)
317 struct rmi_data
*hdata
= hid_get_drvdata(hdev
);
318 struct rmi_device
*rmi_dev
= hdata
->xport
.rmi_dev
;
321 if (!(test_bit(RMI_STARTED
, &hdata
->flags
)))
324 local_irq_save(flags
);
326 rmi_set_attn_data(rmi_dev
, data
[1], &data
[2], size
- 2);
328 generic_handle_irq(hdata
->rmi_irq
);
330 local_irq_restore(flags
);
335 static int rmi_read_data_event(struct hid_device
*hdev
, u8
*data
, int size
)
337 struct rmi_data
*hdata
= hid_get_drvdata(hdev
);
339 if (!test_bit(RMI_READ_REQUEST_PENDING
, &hdata
->flags
)) {
340 hid_dbg(hdev
, "no read request pending\n");
344 memcpy(hdata
->readReport
, data
, size
< hdata
->input_report_size
?
345 size
: hdata
->input_report_size
);
346 set_bit(RMI_READ_DATA_PENDING
, &hdata
->flags
);
347 wake_up(&hdata
->wait
);
352 static int rmi_check_sanity(struct hid_device
*hdev
, u8
*data
, int size
)
354 int valid_size
= size
;
356 * On the Dell XPS 13 9333, the bus sometimes get confused and fills
357 * the report with a sentinel value "ff". Synaptics told us that such
358 * behavior does not comes from the touchpad itself, so we filter out
362 while ((data
[valid_size
- 1] == 0xff) && valid_size
> 0)
368 static int rmi_raw_event(struct hid_device
*hdev
,
369 struct hid_report
*report
, u8
*data
, int size
)
371 struct rmi_data
*hdata
= hid_get_drvdata(hdev
);
373 if (!(hdata
->device_flags
& RMI_DEVICE
))
376 size
= rmi_check_sanity(hdev
, data
, size
);
381 case RMI_READ_DATA_REPORT_ID
:
382 return rmi_read_data_event(hdev
, data
, size
);
383 case RMI_ATTN_REPORT_ID
:
384 return rmi_input_event(hdev
, data
, size
);
392 static int rmi_event(struct hid_device
*hdev
, struct hid_field
*field
,
393 struct hid_usage
*usage
, __s32 value
)
395 struct rmi_data
*data
= hid_get_drvdata(hdev
);
397 if ((data
->device_flags
& RMI_DEVICE
) &&
398 (field
->application
== HID_GD_POINTER
||
399 field
->application
== HID_GD_MOUSE
)) {
400 if (data
->device_flags
& RMI_DEVICE_HAS_PHYS_BUTTONS
) {
401 if ((usage
->hid
& HID_USAGE_PAGE
) == HID_UP_BUTTON
)
404 if ((usage
->hid
== HID_GD_X
|| usage
->hid
== HID_GD_Y
)
409 schedule_work(&data
->reset_work
);
416 static void rmi_report(struct hid_device
*hid
, struct hid_report
*report
)
418 struct hid_field
*field
= report
->field
[0];
420 if (!(hid
->claimed
& HID_CLAIMED_INPUT
))
423 switch (report
->id
) {
424 case RMI_READ_DATA_REPORT_ID
:
426 case RMI_ATTN_REPORT_ID
:
430 if (field
&& field
->hidinput
&& field
->hidinput
->input
)
431 input_sync(field
->hidinput
->input
);
435 static int rmi_suspend(struct hid_device
*hdev
, pm_message_t message
)
437 struct rmi_data
*data
= hid_get_drvdata(hdev
);
438 struct rmi_device
*rmi_dev
= data
->xport
.rmi_dev
;
441 if (!(data
->device_flags
& RMI_DEVICE
))
444 ret
= rmi_driver_suspend(rmi_dev
, false);
446 hid_warn(hdev
, "Failed to suspend device: %d\n", ret
);
453 static int rmi_post_resume(struct hid_device
*hdev
)
455 struct rmi_data
*data
= hid_get_drvdata(hdev
);
456 struct rmi_device
*rmi_dev
= data
->xport
.rmi_dev
;
459 if (!(data
->device_flags
& RMI_DEVICE
))
462 /* Make sure the HID device is ready to receive events */
463 ret
= hid_hw_open(hdev
);
467 ret
= rmi_reset_attn_mode(hdev
);
471 ret
= rmi_driver_resume(rmi_dev
, false);
473 hid_warn(hdev
, "Failed to resume device: %d\n", ret
);
481 #endif /* CONFIG_PM */
483 static int rmi_hid_reset(struct rmi_transport_dev
*xport
, u16 reset_addr
)
485 struct rmi_data
*data
= container_of(xport
, struct rmi_data
, xport
);
486 struct hid_device
*hdev
= data
->hdev
;
488 return rmi_reset_attn_mode(hdev
);
491 static int rmi_input_configured(struct hid_device
*hdev
, struct hid_input
*hi
)
493 struct rmi_data
*data
= hid_get_drvdata(hdev
);
494 struct input_dev
*input
= hi
->input
;
497 if (!(data
->device_flags
& RMI_DEVICE
))
500 data
->xport
.input
= input
;
502 hid_dbg(hdev
, "Opening low level driver\n");
503 ret
= hid_hw_open(hdev
);
507 /* Allow incoming hid reports */
508 hid_device_io_start(hdev
);
510 ret
= rmi_set_mode(hdev
, RMI_MODE_ATTN_REPORTS
);
512 dev_err(&hdev
->dev
, "failed to set rmi mode\n");
516 ret
= rmi_set_page(hdev
, 0);
518 dev_err(&hdev
->dev
, "failed to set page select to 0.\n");
522 ret
= rmi_register_transport_device(&data
->xport
);
524 dev_err(&hdev
->dev
, "failed to register transport driver\n");
528 set_bit(RMI_STARTED
, &data
->flags
);
531 hid_device_io_stop(hdev
);
536 static int rmi_input_mapping(struct hid_device
*hdev
,
537 struct hid_input
*hi
, struct hid_field
*field
,
538 struct hid_usage
*usage
, unsigned long **bit
, int *max
)
540 struct rmi_data
*data
= hid_get_drvdata(hdev
);
543 * we want to make HID ignore the advertised HID collection
546 if (data
->device_flags
& RMI_DEVICE
) {
547 if ((data
->device_flags
& RMI_DEVICE_HAS_PHYS_BUTTONS
) &&
548 ((usage
->hid
& HID_USAGE_PAGE
) == HID_UP_BUTTON
))
557 static int rmi_check_valid_report_id(struct hid_device
*hdev
, unsigned type
,
558 unsigned id
, struct hid_report
**report
)
562 *report
= hdev
->report_enum
[type
].report_id_hash
[id
];
564 for (i
= 0; i
< (*report
)->maxfield
; i
++) {
565 unsigned app
= (*report
)->field
[i
]->application
;
566 if ((app
& HID_USAGE_PAGE
) >= HID_UP_MSVENDOR
)
574 static struct rmi_device_platform_data rmi_hid_pdata
= {
576 .sensor_type
= rmi_sensor_touchpad
,
577 .axis_align
.flip_y
= true,
578 .dribble
= RMI_REG_STATE_ON
,
579 .palm_detect
= RMI_REG_STATE_OFF
,
583 static const struct rmi_transport_ops hid_rmi_ops
= {
584 .write_block
= rmi_hid_write_block
,
585 .read_block
= rmi_hid_read_block
,
586 .reset
= rmi_hid_reset
,
589 static void rmi_irq_teardown(void *data
)
591 struct rmi_data
*hdata
= data
;
592 struct irq_domain
*domain
= hdata
->domain
;
597 irq_dispose_mapping(irq_find_mapping(domain
, 0));
599 irq_domain_remove(domain
);
600 hdata
->domain
= NULL
;
604 static int rmi_irq_map(struct irq_domain
*h
, unsigned int virq
,
605 irq_hw_number_t hw_irq_num
)
607 irq_set_chip_and_handler(virq
, &dummy_irq_chip
, handle_simple_irq
);
612 static const struct irq_domain_ops rmi_irq_ops
= {
616 static int rmi_setup_irq_domain(struct hid_device
*hdev
)
618 struct rmi_data
*hdata
= hid_get_drvdata(hdev
);
621 hdata
->domain
= irq_domain_create_linear(hdev
->dev
.fwnode
, 1,
622 &rmi_irq_ops
, hdata
);
626 ret
= devm_add_action_or_reset(&hdev
->dev
, &rmi_irq_teardown
, hdata
);
630 hdata
->rmi_irq
= irq_create_mapping(hdata
->domain
, 0);
631 if (hdata
->rmi_irq
<= 0) {
632 hid_err(hdev
, "Can't allocate an IRQ\n");
633 return hdata
->rmi_irq
< 0 ? hdata
->rmi_irq
: -ENXIO
;
639 static int rmi_probe(struct hid_device
*hdev
, const struct hid_device_id
*id
)
641 struct rmi_data
*data
= NULL
;
644 struct hid_report
*input_report
;
645 struct hid_report
*output_report
;
646 struct hid_report
*feature_report
;
648 data
= devm_kzalloc(&hdev
->dev
, sizeof(struct rmi_data
), GFP_KERNEL
);
652 INIT_WORK(&data
->reset_work
, rmi_reset_work
);
655 hid_set_drvdata(hdev
, data
);
657 hdev
->quirks
|= HID_QUIRK_NO_INIT_REPORTS
;
658 hdev
->quirks
|= HID_QUIRK_NO_INPUT_SYNC
;
660 ret
= hid_parse(hdev
);
662 hid_err(hdev
, "parse failed\n");
667 data
->device_flags
= id
->driver_data
;
670 * Check for the RMI specific report ids. If they are misisng
671 * simply return and let the events be processed by hid-input
673 if (!rmi_check_valid_report_id(hdev
, HID_FEATURE_REPORT
,
674 RMI_SET_RMI_MODE_REPORT_ID
, &feature_report
)) {
675 hid_dbg(hdev
, "device does not have set mode feature report\n");
679 if (!rmi_check_valid_report_id(hdev
, HID_INPUT_REPORT
,
680 RMI_ATTN_REPORT_ID
, &input_report
)) {
681 hid_dbg(hdev
, "device does not have attention input report\n");
685 data
->input_report_size
= hid_report_len(input_report
);
687 if (!rmi_check_valid_report_id(hdev
, HID_OUTPUT_REPORT
,
688 RMI_WRITE_REPORT_ID
, &output_report
)) {
690 "device does not have rmi write output report\n");
694 data
->output_report_size
= hid_report_len(output_report
);
696 data
->device_flags
|= RMI_DEVICE
;
697 alloc_size
= data
->output_report_size
+ data
->input_report_size
;
699 data
->writeReport
= devm_kzalloc(&hdev
->dev
, alloc_size
, GFP_KERNEL
);
700 if (!data
->writeReport
) {
701 hid_err(hdev
, "failed to allocate buffer for HID reports\n");
705 data
->readReport
= data
->writeReport
+ data
->output_report_size
;
707 init_waitqueue_head(&data
->wait
);
709 mutex_init(&data
->page_mutex
);
711 ret
= rmi_setup_irq_domain(hdev
);
713 hid_err(hdev
, "failed to allocate IRQ domain\n");
717 if (data
->device_flags
& RMI_DEVICE_HAS_PHYS_BUTTONS
)
718 rmi_hid_pdata
.f30_data
.disable
= true;
720 data
->xport
.dev
= hdev
->dev
.parent
;
721 data
->xport
.pdata
= rmi_hid_pdata
;
722 data
->xport
.pdata
.irq
= data
->rmi_irq
;
723 data
->xport
.proto_name
= "hid";
724 data
->xport
.ops
= &hid_rmi_ops
;
727 ret
= hid_hw_start(hdev
, HID_CONNECT_DEFAULT
);
729 hid_err(hdev
, "hw start failed\n");
736 static void rmi_remove(struct hid_device
*hdev
)
738 struct rmi_data
*hdata
= hid_get_drvdata(hdev
);
740 if (hdata
->device_flags
& RMI_DEVICE
) {
741 clear_bit(RMI_STARTED
, &hdata
->flags
);
742 cancel_work_sync(&hdata
->reset_work
);
743 rmi_unregister_transport_device(&hdata
->xport
);
749 static const struct hid_device_id rmi_id
[] = {
750 { HID_USB_DEVICE(USB_VENDOR_ID_RAZER
, USB_DEVICE_ID_RAZER_BLADE_14
),
751 .driver_data
= RMI_DEVICE_HAS_PHYS_BUTTONS
},
752 { HID_USB_DEVICE(USB_VENDOR_ID_LENOVO
, USB_DEVICE_ID_LENOVO_X1_COVER
) },
753 { HID_USB_DEVICE(USB_VENDOR_ID_PRIMAX
, USB_DEVICE_ID_PRIMAX_REZEL
) },
754 { HID_DEVICE(HID_BUS_ANY
, HID_GROUP_RMI
, HID_ANY_ID
, HID_ANY_ID
) },
757 MODULE_DEVICE_TABLE(hid
, rmi_id
);
759 static struct hid_driver rmi_driver
= {
763 .remove
= rmi_remove
,
765 .raw_event
= rmi_raw_event
,
766 .report
= rmi_report
,
767 .input_mapping
= rmi_input_mapping
,
768 .input_configured
= rmi_input_configured
,
770 .suspend
= rmi_suspend
,
771 .resume
= rmi_post_resume
,
772 .reset_resume
= rmi_post_resume
,
776 module_hid_driver(rmi_driver
);
778 MODULE_AUTHOR("Andrew Duggan <aduggan@synaptics.com>");
779 MODULE_DESCRIPTION("RMI HID driver");
780 MODULE_LICENSE("GPL");