xref: /linux/drivers/net/ipa/ipa_smp2p.c (revision 5ea2f5ffde39251115ef9a566262fb9e52b91cb7)
1 // SPDX-License-Identifier: GPL-2.0
2 
3 /* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved.
4  * Copyright (C) 2019-2020 Linaro Ltd.
5  */
6 
7 #include <linux/types.h>
8 #include <linux/device.h>
9 #include <linux/interrupt.h>
10 #include <linux/notifier.h>
11 #include <linux/panic_notifier.h>
12 #include <linux/soc/qcom/smem.h>
13 #include <linux/soc/qcom/smem_state.h>
14 
15 #include "ipa_smp2p.h"
16 #include "ipa.h"
17 #include "ipa_uc.h"
18 #include "ipa_clock.h"
19 
20 /**
21  * DOC: IPA SMP2P communication with the modem
22  *
23  * SMP2P is a primitive communication mechanism available between the AP and
24  * the modem.  The IPA driver uses this for two purposes:  to enable the modem
25  * to state that the GSI hardware is ready to use; and to communicate the
26  * state of the IPA clock in the event of a crash.
27  *
28  * GSI needs to have early initialization completed before it can be used.
29  * This initialization is done either by Trust Zone or by the modem.  In the
30  * latter case, the modem uses an SMP2P interrupt to tell the AP IPA driver
31  * when the GSI is ready to use.
32  *
33  * The modem is also able to inquire about the current state of the IPA
34  * clock by trigging another SMP2P interrupt to the AP.  We communicate
35  * whether the clock is enabled using two SMP2P state bits--one to
36  * indicate the clock state (on or off), and a second to indicate the
37  * clock state bit is valid.  The modem will poll the valid bit until it
38  * is set, and at that time records whether the AP has the IPA clock enabled.
39  *
40  * Finally, if the AP kernel panics, we update the SMP2P state bits even if
41  * we never receive an interrupt from the modem requesting this.
42  */
43 
44 /**
45  * struct ipa_smp2p - IPA SMP2P information
46  * @ipa:		IPA pointer
47  * @valid_state:	SMEM state indicating enabled state is valid
48  * @enabled_state:	SMEM state to indicate clock is enabled
49  * @valid_bit:		Valid bit in 32-bit SMEM state mask
50  * @enabled_bit:	Enabled bit in 32-bit SMEM state mask
51  * @enabled_bit:	Enabled bit in 32-bit SMEM state mask
52  * @clock_query_irq:	IPA interrupt triggered by modem for clock query
53  * @setup_ready_irq:	IPA interrupt triggered by modem to signal GSI ready
54  * @clock_on:		Whether IPA clock is on
55  * @notified:		Whether modem has been notified of clock state
56  * @disabled:		Whether setup ready interrupt handling is disabled
57  * @mutex:		Mutex protecting ready-interrupt/shutdown interlock
58  * @panic_notifier:	Panic notifier structure
59 */
60 struct ipa_smp2p {
61 	struct ipa *ipa;
62 	struct qcom_smem_state *valid_state;
63 	struct qcom_smem_state *enabled_state;
64 	u32 valid_bit;
65 	u32 enabled_bit;
66 	u32 clock_query_irq;
67 	u32 setup_ready_irq;
68 	bool clock_on;
69 	bool notified;
70 	bool disabled;
71 	struct mutex mutex;
72 	struct notifier_block panic_notifier;
73 };
74 
75 /**
76  * ipa_smp2p_notify() - use SMP2P to tell modem about IPA clock state
77  * @smp2p:	SMP2P information
78  *
79  * This is called either when the modem has requested it (by triggering
80  * the modem clock query IPA interrupt) or whenever the AP is shutting down
81  * (via a panic notifier).  It sets the two SMP2P state bits--one saying
82  * whether the IPA clock is running, and the other indicating the first bit
83  * is valid.
84  */
85 static void ipa_smp2p_notify(struct ipa_smp2p *smp2p)
86 {
87 	u32 value;
88 	u32 mask;
89 
90 	if (smp2p->notified)
91 		return;
92 
93 	smp2p->clock_on = ipa_clock_get_additional(smp2p->ipa);
94 
95 	/* Signal whether the clock is enabled */
96 	mask = BIT(smp2p->enabled_bit);
97 	value = smp2p->clock_on ? mask : 0;
98 	qcom_smem_state_update_bits(smp2p->enabled_state, mask, value);
99 
100 	/* Now indicate that the enabled flag is valid */
101 	mask = BIT(smp2p->valid_bit);
102 	value = mask;
103 	qcom_smem_state_update_bits(smp2p->valid_state, mask, value);
104 
105 	smp2p->notified = true;
106 }
107 
108 /* Threaded IRQ handler for modem "ipa-clock-query" SMP2P interrupt */
109 static irqreturn_t ipa_smp2p_modem_clk_query_isr(int irq, void *dev_id)
110 {
111 	struct ipa_smp2p *smp2p = dev_id;
112 
113 	ipa_smp2p_notify(smp2p);
114 
115 	return IRQ_HANDLED;
116 }
117 
118 static int ipa_smp2p_panic_notifier(struct notifier_block *nb,
119 				    unsigned long action, void *data)
120 {
121 	struct ipa_smp2p *smp2p;
122 
123 	smp2p = container_of(nb, struct ipa_smp2p, panic_notifier);
124 
125 	ipa_smp2p_notify(smp2p);
126 
127 	if (smp2p->clock_on)
128 		ipa_uc_panic_notifier(smp2p->ipa);
129 
130 	return NOTIFY_DONE;
131 }
132 
133 static int ipa_smp2p_panic_notifier_register(struct ipa_smp2p *smp2p)
134 {
135 	/* IPA panic handler needs to run before modem shuts down */
136 	smp2p->panic_notifier.notifier_call = ipa_smp2p_panic_notifier;
137 	smp2p->panic_notifier.priority = INT_MAX;	/* Do it early */
138 
139 	return atomic_notifier_chain_register(&panic_notifier_list,
140 					      &smp2p->panic_notifier);
141 }
142 
143 static void ipa_smp2p_panic_notifier_unregister(struct ipa_smp2p *smp2p)
144 {
145 	atomic_notifier_chain_unregister(&panic_notifier_list,
146 					 &smp2p->panic_notifier);
147 }
148 
149 /* Threaded IRQ handler for modem "ipa-setup-ready" SMP2P interrupt */
150 static irqreturn_t ipa_smp2p_modem_setup_ready_isr(int irq, void *dev_id)
151 {
152 	struct ipa_smp2p *smp2p = dev_id;
153 
154 	mutex_lock(&smp2p->mutex);
155 
156 	if (!smp2p->disabled) {
157 		int ret;
158 
159 		/* The clock needs to be active for setup */
160 		ipa_clock_get(smp2p->ipa);
161 
162 		ret = ipa_setup(smp2p->ipa);
163 		if (ret)
164 			dev_err(&smp2p->ipa->pdev->dev,
165 				"error %d from ipa_setup()\n", ret);
166 		smp2p->disabled = true;
167 
168 		ipa_clock_put(smp2p->ipa);
169 	}
170 
171 	mutex_unlock(&smp2p->mutex);
172 
173 	return IRQ_HANDLED;
174 }
175 
176 /* Initialize SMP2P interrupts */
177 static int ipa_smp2p_irq_init(struct ipa_smp2p *smp2p, const char *name,
178 			      irq_handler_t handler)
179 {
180 	struct device *dev = &smp2p->ipa->pdev->dev;
181 	unsigned int irq;
182 	int ret;
183 
184 	ret = platform_get_irq_byname(smp2p->ipa->pdev, name);
185 	if (ret <= 0)
186 		return ret ? : -EINVAL;
187 	irq = ret;
188 
189 	ret = request_threaded_irq(irq, NULL, handler, 0, name, smp2p);
190 	if (ret) {
191 		dev_err(dev, "error %d requesting \"%s\" IRQ\n", ret, name);
192 		return ret;
193 	}
194 
195 	return irq;
196 }
197 
198 static void ipa_smp2p_irq_exit(struct ipa_smp2p *smp2p, u32 irq)
199 {
200 	free_irq(irq, smp2p);
201 }
202 
203 /* Drop the clock reference if it was taken in ipa_smp2p_notify() */
204 static void ipa_smp2p_clock_release(struct ipa *ipa)
205 {
206 	if (!ipa->smp2p->clock_on)
207 		return;
208 
209 	ipa_clock_put(ipa);
210 	ipa->smp2p->clock_on = false;
211 }
212 
213 /* Initialize the IPA SMP2P subsystem */
214 int ipa_smp2p_init(struct ipa *ipa, bool modem_init)
215 {
216 	struct qcom_smem_state *enabled_state;
217 	struct device *dev = &ipa->pdev->dev;
218 	struct qcom_smem_state *valid_state;
219 	struct ipa_smp2p *smp2p;
220 	u32 enabled_bit;
221 	u32 valid_bit;
222 	int ret;
223 
224 	valid_state = qcom_smem_state_get(dev, "ipa-clock-enabled-valid",
225 					  &valid_bit);
226 	if (IS_ERR(valid_state))
227 		return PTR_ERR(valid_state);
228 	if (valid_bit >= 32)		/* BITS_PER_U32 */
229 		return -EINVAL;
230 
231 	enabled_state = qcom_smem_state_get(dev, "ipa-clock-enabled",
232 					    &enabled_bit);
233 	if (IS_ERR(enabled_state))
234 		return PTR_ERR(enabled_state);
235 	if (enabled_bit >= 32)		/* BITS_PER_U32 */
236 		return -EINVAL;
237 
238 	smp2p = kzalloc(sizeof(*smp2p), GFP_KERNEL);
239 	if (!smp2p)
240 		return -ENOMEM;
241 
242 	smp2p->ipa = ipa;
243 
244 	/* These fields are needed by the clock query interrupt
245 	 * handler, so initialize them now.
246 	 */
247 	mutex_init(&smp2p->mutex);
248 	smp2p->valid_state = valid_state;
249 	smp2p->valid_bit = valid_bit;
250 	smp2p->enabled_state = enabled_state;
251 	smp2p->enabled_bit = enabled_bit;
252 
253 	/* We have enough information saved to handle notifications */
254 	ipa->smp2p = smp2p;
255 
256 	ret = ipa_smp2p_irq_init(smp2p, "ipa-clock-query",
257 				 ipa_smp2p_modem_clk_query_isr);
258 	if (ret < 0)
259 		goto err_null_smp2p;
260 	smp2p->clock_query_irq = ret;
261 
262 	ret = ipa_smp2p_panic_notifier_register(smp2p);
263 	if (ret)
264 		goto err_irq_exit;
265 
266 	if (modem_init) {
267 		/* Result will be non-zero (negative for error) */
268 		ret = ipa_smp2p_irq_init(smp2p, "ipa-setup-ready",
269 					 ipa_smp2p_modem_setup_ready_isr);
270 		if (ret < 0)
271 			goto err_notifier_unregister;
272 		smp2p->setup_ready_irq = ret;
273 	}
274 
275 	return 0;
276 
277 err_notifier_unregister:
278 	ipa_smp2p_panic_notifier_unregister(smp2p);
279 err_irq_exit:
280 	ipa_smp2p_irq_exit(smp2p, smp2p->clock_query_irq);
281 err_null_smp2p:
282 	ipa->smp2p = NULL;
283 	mutex_destroy(&smp2p->mutex);
284 	kfree(smp2p);
285 
286 	return ret;
287 }
288 
289 void ipa_smp2p_exit(struct ipa *ipa)
290 {
291 	struct ipa_smp2p *smp2p = ipa->smp2p;
292 
293 	if (smp2p->setup_ready_irq)
294 		ipa_smp2p_irq_exit(smp2p, smp2p->setup_ready_irq);
295 	ipa_smp2p_panic_notifier_unregister(smp2p);
296 	ipa_smp2p_irq_exit(smp2p, smp2p->clock_query_irq);
297 	/* We won't get notified any more; drop clock reference (if any) */
298 	ipa_smp2p_clock_release(ipa);
299 	ipa->smp2p = NULL;
300 	mutex_destroy(&smp2p->mutex);
301 	kfree(smp2p);
302 }
303 
304 void ipa_smp2p_disable(struct ipa *ipa)
305 {
306 	struct ipa_smp2p *smp2p = ipa->smp2p;
307 
308 	if (!smp2p->setup_ready_irq)
309 		return;
310 
311 	mutex_lock(&smp2p->mutex);
312 
313 	smp2p->disabled = true;
314 
315 	mutex_unlock(&smp2p->mutex);
316 }
317 
318 /* Reset state tracking whether we have notified the modem */
319 void ipa_smp2p_notify_reset(struct ipa *ipa)
320 {
321 	struct ipa_smp2p *smp2p = ipa->smp2p;
322 	u32 mask;
323 
324 	if (!smp2p->notified)
325 		return;
326 
327 	ipa_smp2p_clock_release(ipa);
328 
329 	/* Reset the clock enabled valid flag */
330 	mask = BIT(smp2p->valid_bit);
331 	qcom_smem_state_update_bits(smp2p->valid_state, mask, 0);
332 
333 	/* Mark the clock disabled for good measure... */
334 	mask = BIT(smp2p->enabled_bit);
335 	qcom_smem_state_update_bits(smp2p->enabled_state, mask, 0);
336 
337 	smp2p->notified = false;
338 }
339