xref: /linux/drivers/hid/i2c-hid/i2c-hid-of-goodix.c (revision 9cbbd694a58bdf24def2462276514c90cab7cf80)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Driver for Goodix touchscreens that use the i2c-hid protocol.
4  *
5  * Copyright 2020 Google LLC
6  */
7 
8 #include <linux/delay.h>
9 #include <linux/device.h>
10 #include <linux/gpio/consumer.h>
11 #include <linux/i2c.h>
12 #include <linux/kernel.h>
13 #include <linux/module.h>
14 #include <linux/of.h>
15 #include <linux/pm.h>
16 #include <linux/regulator/consumer.h>
17 
18 #include "i2c-hid.h"
19 
20 struct goodix_i2c_hid_timing_data {
21 	unsigned int post_gpio_reset_delay_ms;
22 	unsigned int post_power_delay_ms;
23 };
24 
25 struct i2c_hid_of_goodix {
26 	struct i2chid_ops ops;
27 
28 	struct regulator *vdd;
29 	struct notifier_block nb;
30 	struct gpio_desc *reset_gpio;
31 	const struct goodix_i2c_hid_timing_data *timings;
32 };
33 
34 static void goodix_i2c_hid_deassert_reset(struct i2c_hid_of_goodix *ihid_goodix,
35 					  bool regulator_just_turned_on)
36 {
37 	if (regulator_just_turned_on && ihid_goodix->timings->post_power_delay_ms)
38 		msleep(ihid_goodix->timings->post_power_delay_ms);
39 
40 	gpiod_set_value_cansleep(ihid_goodix->reset_gpio, 0);
41 	if (ihid_goodix->timings->post_gpio_reset_delay_ms)
42 		msleep(ihid_goodix->timings->post_gpio_reset_delay_ms);
43 }
44 
45 static int goodix_i2c_hid_power_up(struct i2chid_ops *ops)
46 {
47 	struct i2c_hid_of_goodix *ihid_goodix =
48 		container_of(ops, struct i2c_hid_of_goodix, ops);
49 
50 	return regulator_enable(ihid_goodix->vdd);
51 }
52 
53 static void goodix_i2c_hid_power_down(struct i2chid_ops *ops)
54 {
55 	struct i2c_hid_of_goodix *ihid_goodix =
56 		container_of(ops, struct i2c_hid_of_goodix, ops);
57 
58 	regulator_disable(ihid_goodix->vdd);
59 }
60 
61 static int ihid_goodix_vdd_notify(struct notifier_block *nb,
62 				    unsigned long event,
63 				    void *ignored)
64 {
65 	struct i2c_hid_of_goodix *ihid_goodix =
66 		container_of(nb, struct i2c_hid_of_goodix, nb);
67 	int ret = NOTIFY_OK;
68 
69 	switch (event) {
70 	case REGULATOR_EVENT_PRE_DISABLE:
71 		gpiod_set_value_cansleep(ihid_goodix->reset_gpio, 1);
72 		break;
73 
74 	case REGULATOR_EVENT_ENABLE:
75 		goodix_i2c_hid_deassert_reset(ihid_goodix, true);
76 		break;
77 
78 	case REGULATOR_EVENT_ABORT_DISABLE:
79 		goodix_i2c_hid_deassert_reset(ihid_goodix, false);
80 		break;
81 
82 	default:
83 		ret = NOTIFY_DONE;
84 		break;
85 	}
86 
87 	return ret;
88 }
89 
90 static int i2c_hid_of_goodix_probe(struct i2c_client *client,
91 				   const struct i2c_device_id *id)
92 {
93 	struct i2c_hid_of_goodix *ihid_goodix;
94 	int ret;
95 	ihid_goodix = devm_kzalloc(&client->dev, sizeof(*ihid_goodix),
96 				   GFP_KERNEL);
97 	if (!ihid_goodix)
98 		return -ENOMEM;
99 
100 	ihid_goodix->ops.power_up = goodix_i2c_hid_power_up;
101 	ihid_goodix->ops.power_down = goodix_i2c_hid_power_down;
102 
103 	/* Start out with reset asserted */
104 	ihid_goodix->reset_gpio =
105 		devm_gpiod_get_optional(&client->dev, "reset", GPIOD_OUT_HIGH);
106 	if (IS_ERR(ihid_goodix->reset_gpio))
107 		return PTR_ERR(ihid_goodix->reset_gpio);
108 
109 	ihid_goodix->vdd = devm_regulator_get(&client->dev, "vdd");
110 	if (IS_ERR(ihid_goodix->vdd))
111 		return PTR_ERR(ihid_goodix->vdd);
112 
113 	ihid_goodix->timings = device_get_match_data(&client->dev);
114 
115 	/*
116 	 * We need to control the "reset" line in lockstep with the regulator
117 	 * actually turning on an off instead of just when we make the request.
118 	 * This matters if the regulator is shared with another consumer.
119 	 * - If the regulator is off then we must assert reset. The reset
120 	 *   line is active low and on some boards it could cause a current
121 	 *   leak if left high.
122 	 * - If the regulator is on then we don't want reset asserted for very
123 	 *   long. Holding the controller in reset apparently draws extra
124 	 *   power.
125 	 */
126 	ihid_goodix->nb.notifier_call = ihid_goodix_vdd_notify;
127 	ret = devm_regulator_register_notifier(ihid_goodix->vdd, &ihid_goodix->nb);
128 	if (ret)
129 		return dev_err_probe(&client->dev, ret,
130 			"regulator notifier request failed\n");
131 
132 	/*
133 	 * If someone else is holding the regulator on (or the regulator is
134 	 * an always-on one) we might never be told to deassert reset. Do it
135 	 * now... and temporarily bump the regulator reference count just to
136 	 * make sure it is impossible for this to race with our own notifier!
137 	 * We also assume that someone else might have _just barely_ turned
138 	 * the regulator on so we'll do the full "post_power_delay" just in
139 	 * case.
140 	 */
141 	if (ihid_goodix->reset_gpio && regulator_is_enabled(ihid_goodix->vdd)) {
142 		ret = regulator_enable(ihid_goodix->vdd);
143 		if (ret)
144 			return ret;
145 		goodix_i2c_hid_deassert_reset(ihid_goodix, true);
146 		regulator_disable(ihid_goodix->vdd);
147 	}
148 
149 	return i2c_hid_core_probe(client, &ihid_goodix->ops, 0x0001, 0);
150 }
151 
152 static const struct goodix_i2c_hid_timing_data goodix_gt7375p_timing_data = {
153 	.post_power_delay_ms = 10,
154 	.post_gpio_reset_delay_ms = 180,
155 };
156 
157 static const struct of_device_id goodix_i2c_hid_of_match[] = {
158 	{ .compatible = "goodix,gt7375p", .data = &goodix_gt7375p_timing_data },
159 	{ }
160 };
161 MODULE_DEVICE_TABLE(of, goodix_i2c_hid_of_match);
162 
163 static struct i2c_driver goodix_i2c_hid_ts_driver = {
164 	.driver = {
165 		.name	= "i2c_hid_of_goodix",
166 		.pm	= &i2c_hid_core_pm,
167 		.probe_type = PROBE_PREFER_ASYNCHRONOUS,
168 		.of_match_table = of_match_ptr(goodix_i2c_hid_of_match),
169 	},
170 	.probe		= i2c_hid_of_goodix_probe,
171 	.remove		= i2c_hid_core_remove,
172 	.shutdown	= i2c_hid_core_shutdown,
173 };
174 module_i2c_driver(goodix_i2c_hid_ts_driver);
175 
176 MODULE_AUTHOR("Douglas Anderson <dianders@chromium.org>");
177 MODULE_DESCRIPTION("Goodix i2c-hid touchscreen driver");
178 MODULE_LICENSE("GPL v2");
179