1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (c) 2011-2016 Synaptics Incorporated
4 * Copyright (c) 2011 Unixphere
7 #include <linux/kernel.h>
9 #include <linux/slab.h>
10 #include <linux/uaccess.h>
12 #include <linux/unaligned.h>
13 #include "rmi_driver.h"
15 #define RMI_PRODUCT_ID_LENGTH 10
16 #define RMI_PRODUCT_INFO_LENGTH 2
18 #define RMI_DATE_CODE_LENGTH 3
20 #define PRODUCT_ID_OFFSET 0x10
21 #define PRODUCT_INFO_OFFSET 0x1E
24 /* Force a firmware reset of the sensor */
25 #define RMI_F01_CMD_DEVICE_RESET 1
27 /* Various F01_RMI_QueryX bits */
29 #define RMI_F01_QRY1_CUSTOM_MAP BIT(0)
30 #define RMI_F01_QRY1_NON_COMPLIANT BIT(1)
31 #define RMI_F01_QRY1_HAS_LTS BIT(2)
32 #define RMI_F01_QRY1_HAS_SENSOR_ID BIT(3)
33 #define RMI_F01_QRY1_HAS_CHARGER_INP BIT(4)
34 #define RMI_F01_QRY1_HAS_ADJ_DOZE BIT(5)
35 #define RMI_F01_QRY1_HAS_ADJ_DOZE_HOFF BIT(6)
36 #define RMI_F01_QRY1_HAS_QUERY42 BIT(7)
38 #define RMI_F01_QRY5_YEAR_MASK 0x1f
39 #define RMI_F01_QRY6_MONTH_MASK 0x0f
40 #define RMI_F01_QRY7_DAY_MASK 0x1f
42 #define RMI_F01_QRY2_PRODINFO_MASK 0x7f
44 #define RMI_F01_BASIC_QUERY_LEN 21 /* From Query 00 through 20 */
46 struct f01_basic_properties
{
49 bool has_adjustable_doze
;
50 bool has_adjustable_doze_holdoff
;
51 char dom
[11]; /* YYYY/MM/DD + '\0' */
52 u8 product_id
[RMI_PRODUCT_ID_LENGTH
+ 1];
58 /* F01 device status bits */
60 /* Most recent device status event */
61 #define RMI_F01_STATUS_CODE(status) ((status) & 0x0f)
62 /* The device has lost its configuration for some reason. */
63 #define RMI_F01_STATUS_UNCONFIGURED(status) (!!((status) & 0x80))
64 /* The device is in bootloader mode */
65 #define RMI_F01_STATUS_BOOTLOADER(status) ((status) & 0x40)
67 /* Control register bits */
70 * Sleep mode controls power management on the device and affects all
71 * functions of the device.
73 #define RMI_F01_CTRL0_SLEEP_MODE_MASK 0x03
75 #define RMI_SLEEP_MODE_NORMAL 0x00
76 #define RMI_SLEEP_MODE_SENSOR_SLEEP 0x01
77 #define RMI_SLEEP_MODE_RESERVED0 0x02
78 #define RMI_SLEEP_MODE_RESERVED1 0x03
81 * This bit disables whatever sleep mode may be selected by the sleep_mode
82 * field and forces the device to run at full power without sleeping.
84 #define RMI_F01_CTRL0_NOSLEEP_BIT BIT(2)
87 * When this bit is set, the touch controller employs a noise-filtering
88 * algorithm designed for use with a connected battery charger.
90 #define RMI_F01_CTRL0_CHARGER_BIT BIT(5)
93 * Sets the report rate for the device. The effect of this setting is
94 * highly product dependent. Check the spec sheet for your particular
97 #define RMI_F01_CTRL0_REPORTRATE_BIT BIT(6)
100 * Written by the host as an indicator that the device has been
101 * successfully configured.
103 #define RMI_F01_CTRL0_CONFIGURED_BIT BIT(7)
106 * struct f01_device_control - controls basic sensor functions
108 * @ctrl0: see the bit definitions above.
109 * @doze_interval: controls the interval between checks for finger presence
110 * when the touch sensor is in doze mode, in units of 10ms.
111 * @wakeup_threshold: controls the capacitance threshold at which the touch
112 * sensor will decide to wake up from that low power state.
113 * @doze_holdoff: controls how long the touch sensor waits after the last
114 * finger lifts before entering the doze state, in units of 100ms.
116 struct f01_device_control
{
124 struct f01_basic_properties properties
;
125 struct f01_device_control device_control
;
127 u16 doze_interval_addr
;
128 u16 wakeup_threshold_addr
;
129 u16 doze_holdoff_addr
;
134 unsigned int num_of_irq_regs
;
137 static int rmi_f01_read_properties(struct rmi_device
*rmi_dev
,
139 struct f01_basic_properties
*props
)
141 u8 queries
[RMI_F01_BASIC_QUERY_LEN
];
143 int query_offset
= query_base_addr
;
144 bool has_ds4_queries
= false;
145 bool has_query42
= false;
146 bool has_sensor_id
= false;
147 bool has_package_id_query
= false;
148 bool has_build_id_query
= false;
152 ret
= rmi_read_block(rmi_dev
, query_offset
,
153 queries
, RMI_F01_BASIC_QUERY_LEN
);
155 dev_err(&rmi_dev
->dev
,
156 "Failed to read device query registers: %d\n", ret
);
160 prod_info_addr
= query_offset
+ 17;
161 query_offset
+= RMI_F01_BASIC_QUERY_LEN
;
163 /* Now parse what we got */
164 props
->manufacturer_id
= queries
[0];
166 props
->has_lts
= queries
[1] & RMI_F01_QRY1_HAS_LTS
;
167 props
->has_adjustable_doze
=
168 queries
[1] & RMI_F01_QRY1_HAS_ADJ_DOZE
;
169 props
->has_adjustable_doze_holdoff
=
170 queries
[1] & RMI_F01_QRY1_HAS_ADJ_DOZE_HOFF
;
171 has_query42
= queries
[1] & RMI_F01_QRY1_HAS_QUERY42
;
172 has_sensor_id
= queries
[1] & RMI_F01_QRY1_HAS_SENSOR_ID
;
174 snprintf(props
->dom
, sizeof(props
->dom
), "20%02d/%02d/%02d",
175 queries
[5] & RMI_F01_QRY5_YEAR_MASK
,
176 queries
[6] & RMI_F01_QRY6_MONTH_MASK
,
177 queries
[7] & RMI_F01_QRY7_DAY_MASK
);
179 memcpy(props
->product_id
, &queries
[11],
180 RMI_PRODUCT_ID_LENGTH
);
181 props
->product_id
[RMI_PRODUCT_ID_LENGTH
] = '\0';
184 ((queries
[2] & RMI_F01_QRY2_PRODINFO_MASK
) << 7) |
185 (queries
[3] & RMI_F01_QRY2_PRODINFO_MASK
);
191 ret
= rmi_read(rmi_dev
, query_offset
, queries
);
193 dev_err(&rmi_dev
->dev
,
194 "Failed to read query 42 register: %d\n", ret
);
198 has_ds4_queries
= !!(queries
[0] & BIT(0));
202 if (has_ds4_queries
) {
203 ret
= rmi_read(rmi_dev
, query_offset
, &ds4_query_len
);
205 dev_err(&rmi_dev
->dev
,
206 "Failed to read DS4 queries length: %d\n", ret
);
211 if (ds4_query_len
> 0) {
212 ret
= rmi_read(rmi_dev
, query_offset
, queries
);
214 dev_err(&rmi_dev
->dev
,
215 "Failed to read DS4 queries: %d\n",
220 has_package_id_query
= !!(queries
[0] & BIT(0));
221 has_build_id_query
= !!(queries
[0] & BIT(1));
224 if (has_package_id_query
) {
225 ret
= rmi_read_block(rmi_dev
, prod_info_addr
,
226 queries
, sizeof(__le64
));
228 dev_err(&rmi_dev
->dev
,
229 "Failed to read package info: %d\n",
234 props
->package_id
= get_unaligned_le64(queries
);
238 if (has_build_id_query
) {
239 ret
= rmi_read_block(rmi_dev
, prod_info_addr
, queries
,
242 dev_err(&rmi_dev
->dev
,
243 "Failed to read product info: %d\n",
248 props
->firmware_id
= queries
[1] << 8 | queries
[0];
249 props
->firmware_id
+= queries
[2] * 65536;
256 const char *rmi_f01_get_product_ID(struct rmi_function
*fn
)
258 struct f01_data
*f01
= dev_get_drvdata(&fn
->dev
);
260 return f01
->properties
.product_id
;
263 static ssize_t
rmi_driver_manufacturer_id_show(struct device
*dev
,
264 struct device_attribute
*dattr
,
267 struct rmi_driver_data
*data
= dev_get_drvdata(dev
);
268 struct f01_data
*f01
= dev_get_drvdata(&data
->f01_container
->dev
);
270 return sysfs_emit(buf
, "%d\n", f01
->properties
.manufacturer_id
);
273 static DEVICE_ATTR(manufacturer_id
, 0444,
274 rmi_driver_manufacturer_id_show
, NULL
);
276 static ssize_t
rmi_driver_dom_show(struct device
*dev
,
277 struct device_attribute
*dattr
, char *buf
)
279 struct rmi_driver_data
*data
= dev_get_drvdata(dev
);
280 struct f01_data
*f01
= dev_get_drvdata(&data
->f01_container
->dev
);
282 return sysfs_emit(buf
, "%s\n", f01
->properties
.dom
);
285 static DEVICE_ATTR(date_of_manufacture
, 0444, rmi_driver_dom_show
, NULL
);
287 static ssize_t
rmi_driver_product_id_show(struct device
*dev
,
288 struct device_attribute
*dattr
,
291 struct rmi_driver_data
*data
= dev_get_drvdata(dev
);
292 struct f01_data
*f01
= dev_get_drvdata(&data
->f01_container
->dev
);
294 return sysfs_emit(buf
, "%s\n", f01
->properties
.product_id
);
297 static DEVICE_ATTR(product_id
, 0444, rmi_driver_product_id_show
, NULL
);
299 static ssize_t
rmi_driver_firmware_id_show(struct device
*dev
,
300 struct device_attribute
*dattr
,
303 struct rmi_driver_data
*data
= dev_get_drvdata(dev
);
304 struct f01_data
*f01
= dev_get_drvdata(&data
->f01_container
->dev
);
306 return sysfs_emit(buf
, "%d\n", f01
->properties
.firmware_id
);
309 static DEVICE_ATTR(firmware_id
, 0444, rmi_driver_firmware_id_show
, NULL
);
311 static ssize_t
rmi_driver_package_id_show(struct device
*dev
,
312 struct device_attribute
*dattr
,
315 struct rmi_driver_data
*data
= dev_get_drvdata(dev
);
316 struct f01_data
*f01
= dev_get_drvdata(&data
->f01_container
->dev
);
318 u32 package_id
= f01
->properties
.package_id
;
320 return sysfs_emit(buf
, "%04x.%04x\n",
321 package_id
& 0xffff, (package_id
>> 16) & 0xffff);
324 static DEVICE_ATTR(package_id
, 0444, rmi_driver_package_id_show
, NULL
);
326 static struct attribute
*rmi_f01_attrs
[] = {
327 &dev_attr_manufacturer_id
.attr
,
328 &dev_attr_date_of_manufacture
.attr
,
329 &dev_attr_product_id
.attr
,
330 &dev_attr_firmware_id
.attr
,
331 &dev_attr_package_id
.attr
,
335 static const struct attribute_group rmi_f01_attr_group
= {
336 .attrs
= rmi_f01_attrs
,
340 static int rmi_f01_of_probe(struct device
*dev
,
341 struct rmi_device_platform_data
*pdata
)
346 retval
= rmi_of_property_read_u32(dev
,
347 (u32
*)&pdata
->power_management
.nosleep
,
348 "syna,nosleep-mode", 1);
352 retval
= rmi_of_property_read_u32(dev
, &val
,
353 "syna,wakeup-threshold", 1);
357 pdata
->power_management
.wakeup_threshold
= val
;
359 retval
= rmi_of_property_read_u32(dev
, &val
,
360 "syna,doze-holdoff-ms", 1);
364 pdata
->power_management
.doze_holdoff
= val
* 100;
366 retval
= rmi_of_property_read_u32(dev
, &val
,
367 "syna,doze-interval-ms", 1);
371 pdata
->power_management
.doze_interval
= val
/ 10;
376 static inline int rmi_f01_of_probe(struct device
*dev
,
377 struct rmi_device_platform_data
*pdata
)
383 static int rmi_f01_probe(struct rmi_function
*fn
)
385 struct rmi_device
*rmi_dev
= fn
->rmi_dev
;
386 struct rmi_driver_data
*driver_data
= dev_get_drvdata(&rmi_dev
->dev
);
387 struct rmi_device_platform_data
*pdata
= rmi_get_platform_data(rmi_dev
);
388 struct f01_data
*f01
;
390 u16 ctrl_base_addr
= fn
->fd
.control_base_addr
;
394 if (fn
->dev
.of_node
) {
395 error
= rmi_f01_of_probe(&fn
->dev
, pdata
);
400 f01
= devm_kzalloc(&fn
->dev
, sizeof(struct f01_data
), GFP_KERNEL
);
404 f01
->num_of_irq_regs
= driver_data
->num_of_irq_regs
;
407 * Set the configured bit and (optionally) other important stuff
408 * in the device control register.
411 error
= rmi_read(rmi_dev
, fn
->fd
.control_base_addr
,
412 &f01
->device_control
.ctrl0
);
414 dev_err(&fn
->dev
, "Failed to read F01 control: %d\n", error
);
418 switch (pdata
->power_management
.nosleep
) {
419 case RMI_REG_STATE_DEFAULT
:
421 case RMI_REG_STATE_OFF
:
422 f01
->device_control
.ctrl0
&= ~RMI_F01_CTRL0_NOSLEEP_BIT
;
424 case RMI_REG_STATE_ON
:
425 f01
->device_control
.ctrl0
|= RMI_F01_CTRL0_NOSLEEP_BIT
;
430 * Sleep mode might be set as a hangover from a system crash or
431 * reboot without power cycle. If so, clear it so the sensor
432 * is certain to function.
434 if ((f01
->device_control
.ctrl0
& RMI_F01_CTRL0_SLEEP_MODE_MASK
) !=
435 RMI_SLEEP_MODE_NORMAL
) {
437 "WARNING: Non-zero sleep mode found. Clearing...\n");
438 f01
->device_control
.ctrl0
&= ~RMI_F01_CTRL0_SLEEP_MODE_MASK
;
441 f01
->device_control
.ctrl0
|= RMI_F01_CTRL0_CONFIGURED_BIT
;
443 error
= rmi_write(rmi_dev
, fn
->fd
.control_base_addr
,
444 f01
->device_control
.ctrl0
);
446 dev_err(&fn
->dev
, "Failed to write F01 control: %d\n", error
);
450 /* Dummy read in order to clear irqs */
451 error
= rmi_read(rmi_dev
, fn
->fd
.data_base_addr
+ 1, &temp
);
453 dev_err(&fn
->dev
, "Failed to read Interrupt Status.\n");
457 error
= rmi_f01_read_properties(rmi_dev
, fn
->fd
.query_base_addr
,
460 dev_err(&fn
->dev
, "Failed to read F01 properties.\n");
464 dev_info(&fn
->dev
, "found RMI device, manufacturer: %s, product: %s, fw id: %d\n",
465 f01
->properties
.manufacturer_id
== 1 ? "Synaptics" : "unknown",
466 f01
->properties
.product_id
, f01
->properties
.firmware_id
);
468 /* Advance to interrupt control registers, then skip over them. */
470 ctrl_base_addr
+= f01
->num_of_irq_regs
;
472 /* read control register */
473 if (f01
->properties
.has_adjustable_doze
) {
474 f01
->doze_interval_addr
= ctrl_base_addr
;
477 if (pdata
->power_management
.doze_interval
) {
478 f01
->device_control
.doze_interval
=
479 pdata
->power_management
.doze_interval
;
480 error
= rmi_write(rmi_dev
, f01
->doze_interval_addr
,
481 f01
->device_control
.doze_interval
);
484 "Failed to configure F01 doze interval register: %d\n",
489 error
= rmi_read(rmi_dev
, f01
->doze_interval_addr
,
490 &f01
->device_control
.doze_interval
);
493 "Failed to read F01 doze interval register: %d\n",
499 f01
->wakeup_threshold_addr
= ctrl_base_addr
;
502 if (pdata
->power_management
.wakeup_threshold
) {
503 f01
->device_control
.wakeup_threshold
=
504 pdata
->power_management
.wakeup_threshold
;
505 error
= rmi_write(rmi_dev
, f01
->wakeup_threshold_addr
,
506 f01
->device_control
.wakeup_threshold
);
509 "Failed to configure F01 wakeup threshold register: %d\n",
514 error
= rmi_read(rmi_dev
, f01
->wakeup_threshold_addr
,
515 &f01
->device_control
.wakeup_threshold
);
518 "Failed to read F01 wakeup threshold register: %d\n",
525 if (f01
->properties
.has_lts
)
528 if (f01
->properties
.has_adjustable_doze_holdoff
) {
529 f01
->doze_holdoff_addr
= ctrl_base_addr
;
532 if (pdata
->power_management
.doze_holdoff
) {
533 f01
->device_control
.doze_holdoff
=
534 pdata
->power_management
.doze_holdoff
;
535 error
= rmi_write(rmi_dev
, f01
->doze_holdoff_addr
,
536 f01
->device_control
.doze_holdoff
);
539 "Failed to configure F01 doze holdoff register: %d\n",
544 error
= rmi_read(rmi_dev
, f01
->doze_holdoff_addr
,
545 &f01
->device_control
.doze_holdoff
);
548 "Failed to read F01 doze holdoff register: %d\n",
555 error
= rmi_read(rmi_dev
, fn
->fd
.data_base_addr
, &device_status
);
558 "Failed to read device status: %d\n", error
);
562 if (RMI_F01_STATUS_UNCONFIGURED(device_status
)) {
564 "Device was reset during configuration process, status: %#02x!\n",
565 RMI_F01_STATUS_CODE(device_status
));
569 dev_set_drvdata(&fn
->dev
, f01
);
571 error
= sysfs_create_group(&fn
->rmi_dev
->dev
.kobj
, &rmi_f01_attr_group
);
573 dev_warn(&fn
->dev
, "Failed to create sysfs group: %d\n", error
);
578 static void rmi_f01_remove(struct rmi_function
*fn
)
580 /* Note that the bus device is used, not the F01 device */
581 sysfs_remove_group(&fn
->rmi_dev
->dev
.kobj
, &rmi_f01_attr_group
);
584 static int rmi_f01_config(struct rmi_function
*fn
)
586 struct f01_data
*f01
= dev_get_drvdata(&fn
->dev
);
589 error
= rmi_write(fn
->rmi_dev
, fn
->fd
.control_base_addr
,
590 f01
->device_control
.ctrl0
);
593 "Failed to write device_control register: %d\n", error
);
597 if (f01
->properties
.has_adjustable_doze
) {
598 error
= rmi_write(fn
->rmi_dev
, f01
->doze_interval_addr
,
599 f01
->device_control
.doze_interval
);
602 "Failed to write doze interval: %d\n", error
);
606 error
= rmi_write_block(fn
->rmi_dev
,
607 f01
->wakeup_threshold_addr
,
608 &f01
->device_control
.wakeup_threshold
,
612 "Failed to write wakeup threshold: %d\n",
618 if (f01
->properties
.has_adjustable_doze_holdoff
) {
619 error
= rmi_write(fn
->rmi_dev
, f01
->doze_holdoff_addr
,
620 f01
->device_control
.doze_holdoff
);
623 "Failed to write doze holdoff: %d\n", error
);
631 static int rmi_f01_suspend(struct rmi_function
*fn
)
633 struct f01_data
*f01
= dev_get_drvdata(&fn
->dev
);
637 f01
->device_control
.ctrl0
& RMI_F01_CTRL0_NOSLEEP_BIT
;
638 f01
->device_control
.ctrl0
&= ~RMI_F01_CTRL0_NOSLEEP_BIT
;
640 f01
->device_control
.ctrl0
&= ~RMI_F01_CTRL0_SLEEP_MODE_MASK
;
641 if (device_may_wakeup(fn
->rmi_dev
->xport
->dev
))
642 f01
->device_control
.ctrl0
|= RMI_SLEEP_MODE_RESERVED1
;
644 f01
->device_control
.ctrl0
|= RMI_SLEEP_MODE_SENSOR_SLEEP
;
646 error
= rmi_write(fn
->rmi_dev
, fn
->fd
.control_base_addr
,
647 f01
->device_control
.ctrl0
);
649 dev_err(&fn
->dev
, "Failed to write sleep mode: %d.\n", error
);
650 if (f01
->old_nosleep
)
651 f01
->device_control
.ctrl0
|= RMI_F01_CTRL0_NOSLEEP_BIT
;
652 f01
->device_control
.ctrl0
&= ~RMI_F01_CTRL0_SLEEP_MODE_MASK
;
653 f01
->device_control
.ctrl0
|= RMI_SLEEP_MODE_NORMAL
;
660 static int rmi_f01_resume(struct rmi_function
*fn
)
662 struct f01_data
*f01
= dev_get_drvdata(&fn
->dev
);
665 if (f01
->old_nosleep
)
666 f01
->device_control
.ctrl0
|= RMI_F01_CTRL0_NOSLEEP_BIT
;
668 f01
->device_control
.ctrl0
&= ~RMI_F01_CTRL0_SLEEP_MODE_MASK
;
669 f01
->device_control
.ctrl0
|= RMI_SLEEP_MODE_NORMAL
;
671 error
= rmi_write(fn
->rmi_dev
, fn
->fd
.control_base_addr
,
672 f01
->device_control
.ctrl0
);
675 "Failed to restore normal operation: %d.\n", error
);
682 static irqreturn_t
rmi_f01_attention(int irq
, void *ctx
)
684 struct rmi_function
*fn
= ctx
;
685 struct rmi_device
*rmi_dev
= fn
->rmi_dev
;
689 error
= rmi_read(rmi_dev
, fn
->fd
.data_base_addr
, &device_status
);
692 "Failed to read device status: %d.\n", error
);
693 return IRQ_RETVAL(error
);
696 if (RMI_F01_STATUS_BOOTLOADER(device_status
))
698 "Device in bootloader mode, please update firmware\n");
700 if (RMI_F01_STATUS_UNCONFIGURED(device_status
)) {
701 dev_warn(&fn
->dev
, "Device reset detected.\n");
702 error
= rmi_dev
->driver
->reset_handler(rmi_dev
);
704 dev_err(&fn
->dev
, "Device reset failed: %d\n", error
);
705 return IRQ_RETVAL(error
);
712 struct rmi_function_handler rmi_f01_handler
= {
716 * Do not allow user unbinding F01 as it is critical
719 .suppress_bind_attrs
= true,
722 .probe
= rmi_f01_probe
,
723 .remove
= rmi_f01_remove
,
724 .config
= rmi_f01_config
,
725 .attention
= rmi_f01_attention
,
726 .suspend
= rmi_f01_suspend
,
727 .resume
= rmi_f01_resume
,