summaryrefslogtreecommitdiffstats
path: root/drivers/greybus/interface.c
diff options
context:
space:
mode:
Diffstat (limited to 'drivers/greybus/interface.c')
-rw-r--r--drivers/greybus/interface.c1263
1 files changed, 1263 insertions, 0 deletions
diff --git a/drivers/greybus/interface.c b/drivers/greybus/interface.c
new file mode 100644
index 000000000000..67dbe6fda9a1
--- /dev/null
+++ b/drivers/greybus/interface.c
@@ -0,0 +1,1263 @@
1// SPDX-License-Identifier: GPL-2.0
2/*
3 * Greybus interface code
4 *
5 * Copyright 2014 Google Inc.
6 * Copyright 2014 Linaro Ltd.
7 */
8
9#include <linux/delay.h>
10#include <linux/greybus.h>
11
12#include "greybus_trace.h"
13
14#define GB_INTERFACE_MODE_SWITCH_TIMEOUT 2000
15
16#define GB_INTERFACE_DEVICE_ID_BAD 0xff
17
18#define GB_INTERFACE_AUTOSUSPEND_MS 3000
19
20/* Time required for interface to enter standby before disabling REFCLK */
21#define GB_INTERFACE_SUSPEND_HIBERNATE_DELAY_MS 20
22
23/* Don't-care selector index */
24#define DME_SELECTOR_INDEX_NULL 0
25
26/* DME attributes */
27/* FIXME: remove ES2 support and DME_T_TST_SRC_INCREMENT */
28#define DME_T_TST_SRC_INCREMENT 0x4083
29
30#define DME_DDBL1_MANUFACTURERID 0x5003
31#define DME_DDBL1_PRODUCTID 0x5004
32
33#define DME_TOSHIBA_GMP_VID 0x6000
34#define DME_TOSHIBA_GMP_PID 0x6001
35#define DME_TOSHIBA_GMP_SN0 0x6002
36#define DME_TOSHIBA_GMP_SN1 0x6003
37#define DME_TOSHIBA_GMP_INIT_STATUS 0x6101
38
39/* DDBL1 Manufacturer and Product ids */
40#define TOSHIBA_DMID 0x0126
41#define TOSHIBA_ES2_BRIDGE_DPID 0x1000
42#define TOSHIBA_ES3_APBRIDGE_DPID 0x1001
43#define TOSHIBA_ES3_GBPHY_DPID 0x1002
44
45static int gb_interface_hibernate_link(struct gb_interface *intf);
46static int gb_interface_refclk_set(struct gb_interface *intf, bool enable);
47
48static int gb_interface_dme_attr_get(struct gb_interface *intf,
49 u16 attr, u32 *val)
50{
51 return gb_svc_dme_peer_get(intf->hd->svc, intf->interface_id,
52 attr, DME_SELECTOR_INDEX_NULL, val);
53}
54
55static int gb_interface_read_ara_dme(struct gb_interface *intf)
56{
57 u32 sn0, sn1;
58 int ret;
59
60 /*
61 * Unless this is a Toshiba bridge, bail out until we have defined
62 * standard GMP attributes.
63 */
64 if (intf->ddbl1_manufacturer_id != TOSHIBA_DMID) {
65 dev_err(&intf->dev, "unknown manufacturer %08x\n",
66 intf->ddbl1_manufacturer_id);
67 return -ENODEV;
68 }
69
70 ret = gb_interface_dme_attr_get(intf, DME_TOSHIBA_GMP_VID,
71 &intf->vendor_id);
72 if (ret)
73 return ret;
74
75 ret = gb_interface_dme_attr_get(intf, DME_TOSHIBA_GMP_PID,
76 &intf->product_id);
77 if (ret)
78 return ret;
79
80 ret = gb_interface_dme_attr_get(intf, DME_TOSHIBA_GMP_SN0, &sn0);
81 if (ret)
82 return ret;
83
84 ret = gb_interface_dme_attr_get(intf, DME_TOSHIBA_GMP_SN1, &sn1);
85 if (ret)
86 return ret;
87
88 intf->serial_number = (u64)sn1 << 32 | sn0;
89
90 return 0;
91}
92
93static int gb_interface_read_dme(struct gb_interface *intf)
94{
95 int ret;
96
97 /* DME attributes have already been read */
98 if (intf->dme_read)
99 return 0;
100
101 ret = gb_interface_dme_attr_get(intf, DME_DDBL1_MANUFACTURERID,
102 &intf->ddbl1_manufacturer_id);
103 if (ret)
104 return ret;
105
106 ret = gb_interface_dme_attr_get(intf, DME_DDBL1_PRODUCTID,
107 &intf->ddbl1_product_id);
108 if (ret)
109 return ret;
110
111 if (intf->ddbl1_manufacturer_id == TOSHIBA_DMID &&
112 intf->ddbl1_product_id == TOSHIBA_ES2_BRIDGE_DPID) {
113 intf->quirks |= GB_INTERFACE_QUIRK_NO_GMP_IDS;
114 intf->quirks |= GB_INTERFACE_QUIRK_NO_INIT_STATUS;
115 }
116
117 ret = gb_interface_read_ara_dme(intf);
118 if (ret)
119 return ret;
120
121 intf->dme_read = true;
122
123 return 0;
124}
125
126static int gb_interface_route_create(struct gb_interface *intf)
127{
128 struct gb_svc *svc = intf->hd->svc;
129 u8 intf_id = intf->interface_id;
130 u8 device_id;
131 int ret;
132
133 /* Allocate an interface device id. */
134 ret = ida_simple_get(&svc->device_id_map,
135 GB_SVC_DEVICE_ID_MIN, GB_SVC_DEVICE_ID_MAX + 1,
136 GFP_KERNEL);
137 if (ret < 0) {
138 dev_err(&intf->dev, "failed to allocate device id: %d\n", ret);
139 return ret;
140 }
141 device_id = ret;
142
143 ret = gb_svc_intf_device_id(svc, intf_id, device_id);
144 if (ret) {
145 dev_err(&intf->dev, "failed to set device id %u: %d\n",
146 device_id, ret);
147 goto err_ida_remove;
148 }
149
150 /* FIXME: Hard-coded AP device id. */
151 ret = gb_svc_route_create(svc, svc->ap_intf_id, GB_SVC_DEVICE_ID_AP,
152 intf_id, device_id);
153 if (ret) {
154 dev_err(&intf->dev, "failed to create route: %d\n", ret);
155 goto err_svc_id_free;
156 }
157
158 intf->device_id = device_id;
159
160 return 0;
161
162err_svc_id_free:
163 /*
164 * XXX Should we tell SVC that this id doesn't belong to interface
165 * XXX anymore.
166 */
167err_ida_remove:
168 ida_simple_remove(&svc->device_id_map, device_id);
169
170 return ret;
171}
172
173static void gb_interface_route_destroy(struct gb_interface *intf)
174{
175 struct gb_svc *svc = intf->hd->svc;
176
177 if (intf->device_id == GB_INTERFACE_DEVICE_ID_BAD)
178 return;
179
180 gb_svc_route_destroy(svc, svc->ap_intf_id, intf->interface_id);
181 ida_simple_remove(&svc->device_id_map, intf->device_id);
182 intf->device_id = GB_INTERFACE_DEVICE_ID_BAD;
183}
184
185/* Locking: Caller holds the interface mutex. */
186static int gb_interface_legacy_mode_switch(struct gb_interface *intf)
187{
188 int ret;
189
190 dev_info(&intf->dev, "legacy mode switch detected\n");
191
192 /* Mark as disconnected to prevent I/O during disable. */
193 intf->disconnected = true;
194 gb_interface_disable(intf);
195 intf->disconnected = false;
196
197 ret = gb_interface_enable(intf);
198 if (ret) {
199 dev_err(&intf->dev, "failed to re-enable interface: %d\n", ret);
200 gb_interface_deactivate(intf);
201 }
202
203 return ret;
204}
205
206void gb_interface_mailbox_event(struct gb_interface *intf, u16 result,
207 u32 mailbox)
208{
209 mutex_lock(&intf->mutex);
210
211 if (result) {
212 dev_warn(&intf->dev,
213 "mailbox event with UniPro error: 0x%04x\n",
214 result);
215 goto err_disable;
216 }
217
218 if (mailbox != GB_SVC_INTF_MAILBOX_GREYBUS) {
219 dev_warn(&intf->dev,
220 "mailbox event with unexpected value: 0x%08x\n",
221 mailbox);
222 goto err_disable;
223 }
224
225 if (intf->quirks & GB_INTERFACE_QUIRK_LEGACY_MODE_SWITCH) {
226 gb_interface_legacy_mode_switch(intf);
227 goto out_unlock;
228 }
229
230 if (!intf->mode_switch) {
231 dev_warn(&intf->dev, "unexpected mailbox event: 0x%08x\n",
232 mailbox);
233 goto err_disable;
234 }
235
236 dev_info(&intf->dev, "mode switch detected\n");
237
238 complete(&intf->mode_switch_completion);
239
240out_unlock:
241 mutex_unlock(&intf->mutex);
242
243 return;
244
245err_disable:
246 gb_interface_disable(intf);
247 gb_interface_deactivate(intf);
248 mutex_unlock(&intf->mutex);
249}
250
251static void gb_interface_mode_switch_work(struct work_struct *work)
252{
253 struct gb_interface *intf;
254 struct gb_control *control;
255 unsigned long timeout;
256 int ret;
257
258 intf = container_of(work, struct gb_interface, mode_switch_work);
259
260 mutex_lock(&intf->mutex);
261 /* Make sure interface is still enabled. */
262 if (!intf->enabled) {
263 dev_dbg(&intf->dev, "mode switch aborted\n");
264 intf->mode_switch = false;
265 mutex_unlock(&intf->mutex);
266 goto out_interface_put;
267 }
268
269 /*
270 * Prepare the control device for mode switch and make sure to get an
271 * extra reference before it goes away during interface disable.
272 */
273 control = gb_control_get(intf->control);
274 gb_control_mode_switch_prepare(control);
275 gb_interface_disable(intf);
276 mutex_unlock(&intf->mutex);
277
278 timeout = msecs_to_jiffies(GB_INTERFACE_MODE_SWITCH_TIMEOUT);
279 ret = wait_for_completion_interruptible_timeout(
280 &intf->mode_switch_completion, timeout);
281
282 /* Finalise control-connection mode switch. */
283 gb_control_mode_switch_complete(control);
284 gb_control_put(control);
285
286 if (ret < 0) {
287 dev_err(&intf->dev, "mode switch interrupted\n");
288 goto err_deactivate;
289 } else if (ret == 0) {
290 dev_err(&intf->dev, "mode switch timed out\n");
291 goto err_deactivate;
292 }
293
294 /* Re-enable (re-enumerate) interface if still active. */
295 mutex_lock(&intf->mutex);
296 intf->mode_switch = false;
297 if (intf->active) {
298 ret = gb_interface_enable(intf);
299 if (ret) {
300 dev_err(&intf->dev, "failed to re-enable interface: %d\n",
301 ret);
302 gb_interface_deactivate(intf);
303 }
304 }
305 mutex_unlock(&intf->mutex);
306
307out_interface_put:
308 gb_interface_put(intf);
309
310 return;
311
312err_deactivate:
313 mutex_lock(&intf->mutex);
314 intf->mode_switch = false;
315 gb_interface_deactivate(intf);
316 mutex_unlock(&intf->mutex);
317
318 gb_interface_put(intf);
319}
320
321int gb_interface_request_mode_switch(struct gb_interface *intf)
322{
323 int ret = 0;
324
325 mutex_lock(&intf->mutex);
326 if (intf->mode_switch) {
327 ret = -EBUSY;
328 goto out_unlock;
329 }
330
331 intf->mode_switch = true;
332 reinit_completion(&intf->mode_switch_completion);
333
334 /*
335 * Get a reference to the interface device, which will be put once the
336 * mode switch is complete.
337 */
338 get_device(&intf->dev);
339
340 if (!queue_work(system_long_wq, &intf->mode_switch_work)) {
341 put_device(&intf->dev);
342 ret = -EBUSY;
343 goto out_unlock;
344 }
345
346out_unlock:
347 mutex_unlock(&intf->mutex);
348
349 return ret;
350}
351EXPORT_SYMBOL_GPL(gb_interface_request_mode_switch);
352
353/*
354 * T_TstSrcIncrement is written by the module on ES2 as a stand-in for the
355 * init-status attribute DME_TOSHIBA_INIT_STATUS. The AP needs to read and
356 * clear it after reading a non-zero value from it.
357 *
358 * FIXME: This is module-hardware dependent and needs to be extended for every
359 * type of module we want to support.
360 */
361static int gb_interface_read_and_clear_init_status(struct gb_interface *intf)
362{
363 struct gb_host_device *hd = intf->hd;
364 unsigned long bootrom_quirks;
365 unsigned long s2l_quirks;
366 int ret;
367 u32 value;
368 u16 attr;
369 u8 init_status;
370
371 /*
372 * ES2 bridges use T_TstSrcIncrement for the init status.
373 *
374 * FIXME: Remove ES2 support
375 */
376 if (intf->quirks & GB_INTERFACE_QUIRK_NO_INIT_STATUS)
377 attr = DME_T_TST_SRC_INCREMENT;
378 else
379 attr = DME_TOSHIBA_GMP_INIT_STATUS;
380
381 ret = gb_svc_dme_peer_get(hd->svc, intf->interface_id, attr,
382 DME_SELECTOR_INDEX_NULL, &value);
383 if (ret)
384 return ret;
385
386 /*
387 * A nonzero init status indicates the module has finished
388 * initializing.
389 */
390 if (!value) {
391 dev_err(&intf->dev, "invalid init status\n");
392 return -ENODEV;
393 }
394
395 /*
396 * Extract the init status.
397 *
398 * For ES2: We need to check lowest 8 bits of 'value'.
399 * For ES3: We need to check highest 8 bits out of 32 of 'value'.
400 *
401 * FIXME: Remove ES2 support
402 */
403 if (intf->quirks & GB_INTERFACE_QUIRK_NO_INIT_STATUS)
404 init_status = value & 0xff;
405 else
406 init_status = value >> 24;
407
408 /*
409 * Check if the interface is executing the quirky ES3 bootrom that,
410 * for example, requires E2EFC, CSD and CSV to be disabled.
411 */
412 bootrom_quirks = GB_INTERFACE_QUIRK_NO_CPORT_FEATURES |
413 GB_INTERFACE_QUIRK_FORCED_DISABLE |
414 GB_INTERFACE_QUIRK_LEGACY_MODE_SWITCH |
415 GB_INTERFACE_QUIRK_NO_BUNDLE_ACTIVATE;
416
417 s2l_quirks = GB_INTERFACE_QUIRK_NO_PM;
418
419 switch (init_status) {
420 case GB_INIT_BOOTROM_UNIPRO_BOOT_STARTED:
421 case GB_INIT_BOOTROM_FALLBACK_UNIPRO_BOOT_STARTED:
422 intf->quirks |= bootrom_quirks;
423 break;
424 case GB_INIT_S2_LOADER_BOOT_STARTED:
425 /* S2 Loader doesn't support runtime PM */
426 intf->quirks &= ~bootrom_quirks;
427 intf->quirks |= s2l_quirks;
428 break;
429 default:
430 intf->quirks &= ~bootrom_quirks;
431 intf->quirks &= ~s2l_quirks;
432 }
433
434 /* Clear the init status. */
435 return gb_svc_dme_peer_set(hd->svc, intf->interface_id, attr,
436 DME_SELECTOR_INDEX_NULL, 0);
437}
438
439/* interface sysfs attributes */
440#define gb_interface_attr(field, type) \
441static ssize_t field##_show(struct device *dev, \
442 struct device_attribute *attr, \
443 char *buf) \
444{ \
445 struct gb_interface *intf = to_gb_interface(dev); \
446 return scnprintf(buf, PAGE_SIZE, type"\n", intf->field); \
447} \
448static DEVICE_ATTR_RO(field)
449
450gb_interface_attr(ddbl1_manufacturer_id, "0x%08x");
451gb_interface_attr(ddbl1_product_id, "0x%08x");
452gb_interface_attr(interface_id, "%u");
453gb_interface_attr(vendor_id, "0x%08x");
454gb_interface_attr(product_id, "0x%08x");
455gb_interface_attr(serial_number, "0x%016llx");
456
457static ssize_t voltage_now_show(struct device *dev,
458 struct device_attribute *attr, char *buf)
459{
460 struct gb_interface *intf = to_gb_interface(dev);
461 int ret;
462 u32 measurement;
463
464 ret = gb_svc_pwrmon_intf_sample_get(intf->hd->svc, intf->interface_id,
465 GB_SVC_PWRMON_TYPE_VOL,
466 &measurement);
467 if (ret) {
468 dev_err(&intf->dev, "failed to get voltage sample (%d)\n", ret);
469 return ret;
470 }
471
472 return sprintf(buf, "%u\n", measurement);
473}
474static DEVICE_ATTR_RO(voltage_now);
475
476static ssize_t current_now_show(struct device *dev,
477 struct device_attribute *attr, char *buf)
478{
479 struct gb_interface *intf = to_gb_interface(dev);
480 int ret;
481 u32 measurement;
482
483 ret = gb_svc_pwrmon_intf_sample_get(intf->hd->svc, intf->interface_id,
484 GB_SVC_PWRMON_TYPE_CURR,
485 &measurement);
486 if (ret) {
487 dev_err(&intf->dev, "failed to get current sample (%d)\n", ret);
488 return ret;
489 }
490
491 return sprintf(buf, "%u\n", measurement);
492}
493static DEVICE_ATTR_RO(current_now);
494
495static ssize_t power_now_show(struct device *dev,
496 struct device_attribute *attr, char *buf)
497{
498 struct gb_interface *intf = to_gb_interface(dev);
499 int ret;
500 u32 measurement;
501
502 ret = gb_svc_pwrmon_intf_sample_get(intf->hd->svc, intf->interface_id,
503 GB_SVC_PWRMON_TYPE_PWR,
504 &measurement);
505 if (ret) {
506 dev_err(&intf->dev, "failed to get power sample (%d)\n", ret);
507 return ret;
508 }
509
510 return sprintf(buf, "%u\n", measurement);
511}
512static DEVICE_ATTR_RO(power_now);
513
514static ssize_t power_state_show(struct device *dev,
515 struct device_attribute *attr, char *buf)
516{
517 struct gb_interface *intf = to_gb_interface(dev);
518
519 if (intf->active)
520 return scnprintf(buf, PAGE_SIZE, "on\n");
521 else
522 return scnprintf(buf, PAGE_SIZE, "off\n");
523}
524
525static ssize_t power_state_store(struct device *dev,
526 struct device_attribute *attr, const char *buf,
527 size_t len)
528{
529 struct gb_interface *intf = to_gb_interface(dev);
530 bool activate;
531 int ret = 0;
532
533 if (kstrtobool(buf, &activate))
534 return -EINVAL;
535
536 mutex_lock(&intf->mutex);
537
538 if (activate == intf->active)
539 goto unlock;
540
541 if (activate) {
542 ret = gb_interface_activate(intf);
543 if (ret) {
544 dev_err(&intf->dev,
545 "failed to activate interface: %d\n", ret);
546 goto unlock;
547 }
548
549 ret = gb_interface_enable(intf);
550 if (ret) {
551 dev_err(&intf->dev,
552 "failed to enable interface: %d\n", ret);
553 gb_interface_deactivate(intf);
554 goto unlock;
555 }
556 } else {
557 gb_interface_disable(intf);
558 gb_interface_deactivate(intf);
559 }
560
561unlock:
562 mutex_unlock(&intf->mutex);
563
564 if (ret)
565 return ret;
566
567 return len;
568}
569static DEVICE_ATTR_RW(power_state);
570
571static const char *gb_interface_type_string(struct gb_interface *intf)
572{
573 static const char * const types[] = {
574 [GB_INTERFACE_TYPE_INVALID] = "invalid",
575 [GB_INTERFACE_TYPE_UNKNOWN] = "unknown",
576 [GB_INTERFACE_TYPE_DUMMY] = "dummy",
577 [GB_INTERFACE_TYPE_UNIPRO] = "unipro",
578 [GB_INTERFACE_TYPE_GREYBUS] = "greybus",
579 };
580
581 return types[intf->type];
582}
583
584static ssize_t interface_type_show(struct device *dev,
585 struct device_attribute *attr, char *buf)
586{
587 struct gb_interface *intf = to_gb_interface(dev);
588
589 return sprintf(buf, "%s\n", gb_interface_type_string(intf));
590}
591static DEVICE_ATTR_RO(interface_type);
592
593static struct attribute *interface_unipro_attrs[] = {
594 &dev_attr_ddbl1_manufacturer_id.attr,
595 &dev_attr_ddbl1_product_id.attr,
596 NULL
597};
598
599static struct attribute *interface_greybus_attrs[] = {
600 &dev_attr_vendor_id.attr,
601 &dev_attr_product_id.attr,
602 &dev_attr_serial_number.attr,
603 NULL
604};
605
606static struct attribute *interface_power_attrs[] = {
607 &dev_attr_voltage_now.attr,
608 &dev_attr_current_now.attr,
609 &dev_attr_power_now.attr,
610 &dev_attr_power_state.attr,
611 NULL
612};
613
614static struct attribute *interface_common_attrs[] = {
615 &dev_attr_interface_id.attr,
616 &dev_attr_interface_type.attr,
617 NULL
618};
619
620static umode_t interface_unipro_is_visible(struct kobject *kobj,
621 struct attribute *attr, int n)
622{
623 struct device *dev = container_of(kobj, struct device, kobj);
624 struct gb_interface *intf = to_gb_interface(dev);
625
626 switch (intf->type) {
627 case GB_INTERFACE_TYPE_UNIPRO:
628 case GB_INTERFACE_TYPE_GREYBUS:
629 return attr->mode;
630 default:
631 return 0;
632 }
633}
634
635static umode_t interface_greybus_is_visible(struct kobject *kobj,
636 struct attribute *attr, int n)
637{
638 struct device *dev = container_of(kobj, struct device, kobj);
639 struct gb_interface *intf = to_gb_interface(dev);
640
641 switch (intf->type) {
642 case GB_INTERFACE_TYPE_GREYBUS:
643 return attr->mode;
644 default:
645 return 0;
646 }
647}
648
649static umode_t interface_power_is_visible(struct kobject *kobj,
650 struct attribute *attr, int n)
651{
652 struct device *dev = container_of(kobj, struct device, kobj);
653 struct gb_interface *intf = to_gb_interface(dev);
654
655 switch (intf->type) {
656 case GB_INTERFACE_TYPE_UNIPRO:
657 case GB_INTERFACE_TYPE_GREYBUS:
658 return attr->mode;
659 default:
660 return 0;
661 }
662}
663
664static const struct attribute_group interface_unipro_group = {
665 .is_visible = interface_unipro_is_visible,
666 .attrs = interface_unipro_attrs,
667};
668
669static const struct attribute_group interface_greybus_group = {
670 .is_visible = interface_greybus_is_visible,
671 .attrs = interface_greybus_attrs,
672};
673
674static const struct attribute_group interface_power_group = {
675 .is_visible = interface_power_is_visible,
676 .attrs = interface_power_attrs,
677};
678
679static const struct attribute_group interface_common_group = {
680 .attrs = interface_common_attrs,
681};
682
683static const struct attribute_group *interface_groups[] = {
684 &interface_unipro_group,
685 &interface_greybus_group,
686 &interface_power_group,
687 &interface_common_group,
688 NULL
689};
690
691static void gb_interface_release(struct device *dev)
692{
693 struct gb_interface *intf = to_gb_interface(dev);
694
695 trace_gb_interface_release(intf);
696
697 kfree(intf);
698}
699
700#ifdef CONFIG_PM
701static int gb_interface_suspend(struct device *dev)
702{
703 struct gb_interface *intf = to_gb_interface(dev);
704 int ret;
705
706 ret = gb_control_interface_suspend_prepare(intf->control);
707 if (ret)
708 return ret;
709
710 ret = gb_control_suspend(intf->control);
711 if (ret)
712 goto err_hibernate_abort;
713
714 ret = gb_interface_hibernate_link(intf);
715 if (ret)
716 return ret;
717
718 /* Delay to allow interface to enter standby before disabling refclk */
719 msleep(GB_INTERFACE_SUSPEND_HIBERNATE_DELAY_MS);
720
721 ret = gb_interface_refclk_set(intf, false);
722 if (ret)
723 return ret;
724
725 return 0;
726
727err_hibernate_abort:
728 gb_control_interface_hibernate_abort(intf->control);
729
730 return ret;
731}
732
733static int gb_interface_resume(struct device *dev)
734{
735 struct gb_interface *intf = to_gb_interface(dev);
736 struct gb_svc *svc = intf->hd->svc;
737 int ret;
738
739 ret = gb_interface_refclk_set(intf, true);
740 if (ret)
741 return ret;
742
743 ret = gb_svc_intf_resume(svc, intf->interface_id);
744 if (ret)
745 return ret;
746
747 ret = gb_control_resume(intf->control);
748 if (ret)
749 return ret;
750
751 return 0;
752}
753
754static int gb_interface_runtime_idle(struct device *dev)
755{
756 pm_runtime_mark_last_busy(dev);
757 pm_request_autosuspend(dev);
758
759 return 0;
760}
761#endif
762
763static const struct dev_pm_ops gb_interface_pm_ops = {
764 SET_RUNTIME_PM_OPS(gb_interface_suspend, gb_interface_resume,
765 gb_interface_runtime_idle)
766};
767
768struct device_type greybus_interface_type = {
769 .name = "greybus_interface",
770 .release = gb_interface_release,
771 .pm = &gb_interface_pm_ops,
772};
773
774/*
775 * A Greybus module represents a user-replaceable component on a GMP
776 * phone. An interface is the physical connection on that module. A
777 * module may have more than one interface.
778 *
779 * Create a gb_interface structure to represent a discovered interface.
780 * The position of interface within the Endo is encoded in "interface_id"
781 * argument.
782 *
783 * Returns a pointer to the new interfce or a null pointer if a
784 * failure occurs due to memory exhaustion.
785 */
786struct gb_interface *gb_interface_create(struct gb_module *module,
787 u8 interface_id)
788{
789 struct gb_host_device *hd = module->hd;
790 struct gb_interface *intf;
791
792 intf = kzalloc(sizeof(*intf), GFP_KERNEL);
793 if (!intf)
794 return NULL;
795
796 intf->hd = hd; /* XXX refcount? */
797 intf->module = module;
798 intf->interface_id = interface_id;
799 INIT_LIST_HEAD(&intf->bundles);
800 INIT_LIST_HEAD(&intf->manifest_descs);
801 mutex_init(&intf->mutex);
802 INIT_WORK(&intf->mode_switch_work, gb_interface_mode_switch_work);
803 init_completion(&intf->mode_switch_completion);
804
805 /* Invalid device id to start with */
806 intf->device_id = GB_INTERFACE_DEVICE_ID_BAD;
807
808 intf->dev.parent = &module->dev;
809 intf->dev.bus = &greybus_bus_type;
810 intf->dev.type = &greybus_interface_type;
811 intf->dev.groups = interface_groups;
812 intf->dev.dma_mask = module->dev.dma_mask;
813 device_initialize(&intf->dev);
814 dev_set_name(&intf->dev, "%s.%u", dev_name(&module->dev),
815 interface_id);
816
817 pm_runtime_set_autosuspend_delay(&intf->dev,
818 GB_INTERFACE_AUTOSUSPEND_MS);
819
820 trace_gb_interface_create(intf);
821
822 return intf;
823}
824
825static int gb_interface_vsys_set(struct gb_interface *intf, bool enable)
826{
827 struct gb_svc *svc = intf->hd->svc;
828 int ret;
829
830 dev_dbg(&intf->dev, "%s - %d\n", __func__, enable);
831
832 ret = gb_svc_intf_vsys_set(svc, intf->interface_id, enable);
833 if (ret) {
834 dev_err(&intf->dev, "failed to set v_sys: %d\n", ret);
835 return ret;
836 }
837
838 return 0;
839}
840
841static int gb_interface_refclk_set(struct gb_interface *intf, bool enable)
842{
843 struct gb_svc *svc = intf->hd->svc;
844 int ret;
845
846 dev_dbg(&intf->dev, "%s - %d\n", __func__, enable);
847
848 ret = gb_svc_intf_refclk_set(svc, intf->interface_id, enable);
849 if (ret) {
850 dev_err(&intf->dev, "failed to set refclk: %d\n", ret);
851 return ret;
852 }
853
854 return 0;
855}
856
857static int gb_interface_unipro_set(struct gb_interface *intf, bool enable)
858{
859 struct gb_svc *svc = intf->hd->svc;
860 int ret;
861
862 dev_dbg(&intf->dev, "%s - %d\n", __func__, enable);
863
864 ret = gb_svc_intf_unipro_set(svc, intf->interface_id, enable);
865 if (ret) {
866 dev_err(&intf->dev, "failed to set UniPro: %d\n", ret);
867 return ret;
868 }
869
870 return 0;
871}
872
873static int gb_interface_activate_operation(struct gb_interface *intf,
874 enum gb_interface_type *intf_type)
875{
876 struct gb_svc *svc = intf->hd->svc;
877 u8 type;
878 int ret;
879
880 dev_dbg(&intf->dev, "%s\n", __func__);
881
882 ret = gb_svc_intf_activate(svc, intf->interface_id, &type);
883 if (ret) {
884 dev_err(&intf->dev, "failed to activate: %d\n", ret);
885 return ret;
886 }
887
888 switch (type) {
889 case GB_SVC_INTF_TYPE_DUMMY:
890 *intf_type = GB_INTERFACE_TYPE_DUMMY;
891 /* FIXME: handle as an error for now */
892 return -ENODEV;
893 case GB_SVC_INTF_TYPE_UNIPRO:
894 *intf_type = GB_INTERFACE_TYPE_UNIPRO;
895 dev_err(&intf->dev, "interface type UniPro not supported\n");
896 /* FIXME: handle as an error for now */
897 return -ENODEV;
898 case GB_SVC_INTF_TYPE_GREYBUS:
899 *intf_type = GB_INTERFACE_TYPE_GREYBUS;
900 break;
901 default:
902 dev_err(&intf->dev, "unknown interface type: %u\n", type);
903 *intf_type = GB_INTERFACE_TYPE_UNKNOWN;
904 return -ENODEV;
905 }
906
907 return 0;
908}
909
910static int gb_interface_hibernate_link(struct gb_interface *intf)
911{
912 struct gb_svc *svc = intf->hd->svc;
913
914 return gb_svc_intf_set_power_mode_hibernate(svc, intf->interface_id);
915}
916
917static int _gb_interface_activate(struct gb_interface *intf,
918 enum gb_interface_type *type)
919{
920 int ret;
921
922 *type = GB_INTERFACE_TYPE_UNKNOWN;
923
924 if (intf->ejected || intf->removed)
925 return -ENODEV;
926
927 ret = gb_interface_vsys_set(intf, true);
928 if (ret)
929 return ret;
930
931 ret = gb_interface_refclk_set(intf, true);
932 if (ret)
933 goto err_vsys_disable;
934
935 ret = gb_interface_unipro_set(intf, true);
936 if (ret)
937 goto err_refclk_disable;
938
939 ret = gb_interface_activate_operation(intf, type);
940 if (ret) {
941 switch (*type) {
942 case GB_INTERFACE_TYPE_UNIPRO:
943 case GB_INTERFACE_TYPE_GREYBUS:
944 goto err_hibernate_link;
945 default:
946 goto err_unipro_disable;
947 }
948 }
949
950 ret = gb_interface_read_dme(intf);
951 if (ret)
952 goto err_hibernate_link;
953
954 ret = gb_interface_route_create(intf);
955 if (ret)
956 goto err_hibernate_link;
957
958 intf->active = true;
959
960 trace_gb_interface_activate(intf);
961
962 return 0;
963
964err_hibernate_link:
965 gb_interface_hibernate_link(intf);
966err_unipro_disable:
967 gb_interface_unipro_set(intf, false);
968err_refclk_disable:
969 gb_interface_refclk_set(intf, false);
970err_vsys_disable:
971 gb_interface_vsys_set(intf, false);
972
973 return ret;
974}
975
976/*
977 * At present, we assume a UniPro-only module to be a Greybus module that
978 * failed to send its mailbox poke. There is some reason to believe that this
979 * is because of a bug in the ES3 bootrom.
980 *
981 * FIXME: Check if this is a Toshiba bridge before retrying?
982 */
983static int _gb_interface_activate_es3_hack(struct gb_interface *intf,
984 enum gb_interface_type *type)
985{
986 int retries = 3;
987 int ret;
988
989 while (retries--) {
990 ret = _gb_interface_activate(intf, type);
991 if (ret == -ENODEV && *type == GB_INTERFACE_TYPE_UNIPRO)
992 continue;
993
994 break;
995 }
996
997 return ret;
998}
999
1000/*
1001 * Activate an interface.
1002 *
1003 * Locking: Caller holds the interface mutex.
1004 */
1005int gb_interface_activate(struct gb_interface *intf)
1006{
1007 enum gb_interface_type type;
1008 int ret;
1009
1010 switch (intf->type) {
1011 case GB_INTERFACE_TYPE_INVALID:
1012 case GB_INTERFACE_TYPE_GREYBUS:
1013 ret = _gb_interface_activate_es3_hack(intf, &type);
1014 break;
1015 default:
1016 ret = _gb_interface_activate(intf, &type);
1017 }
1018
1019 /* Make sure type is detected correctly during reactivation. */
1020 if (intf->type != GB_INTERFACE_TYPE_INVALID) {
1021 if (type != intf->type) {
1022 dev_err(&intf->dev, "failed to detect interface type\n");
1023
1024 if (!ret)
1025 gb_interface_deactivate(intf);
1026
1027 return -EIO;
1028 }
1029 } else {
1030 intf->type = type;
1031 }
1032
1033 return ret;
1034}
1035
1036/*
1037 * Deactivate an interface.
1038 *
1039 * Locking: Caller holds the interface mutex.
1040 */
1041void gb_interface_deactivate(struct gb_interface *intf)
1042{
1043 if (!intf->active)
1044 return;
1045
1046 trace_gb_interface_deactivate(intf);
1047
1048 /* Abort any ongoing mode switch. */
1049 if (intf->mode_switch)
1050 complete(&intf->mode_switch_completion);
1051
1052 gb_interface_route_destroy(intf);
1053 gb_interface_hibernate_link(intf);
1054 gb_interface_unipro_set(intf, false);
1055 gb_interface_refclk_set(intf, false);
1056 gb_interface_vsys_set(intf, false);
1057
1058 intf->active = false;
1059}
1060
1061/*
1062 * Enable an interface by enabling its control connection, fetching the
1063 * manifest and other information over it, and finally registering its child
1064 * devices.
1065 *
1066 * Locking: Caller holds the interface mutex.
1067 */
1068int gb_interface_enable(struct gb_interface *intf)
1069{
1070 struct gb_control *control;
1071 struct gb_bundle *bundle, *tmp;
1072 int ret, size;
1073 void *manifest;
1074
1075 ret = gb_interface_read_and_clear_init_status(intf);
1076 if (ret) {
1077 dev_err(&intf->dev, "failed to clear init status: %d\n", ret);
1078 return ret;
1079 }
1080
1081 /* Establish control connection */
1082 control = gb_control_create(intf);
1083 if (IS_ERR(control)) {
1084 dev_err(&intf->dev, "failed to create control device: %ld\n",
1085 PTR_ERR(control));
1086 return PTR_ERR(control);
1087 }
1088 intf->control = control;
1089
1090 ret = gb_control_enable(intf->control);
1091 if (ret)
1092 goto err_put_control;
1093
1094 /* Get manifest size using control protocol on CPort */
1095 size = gb_control_get_manifest_size_operation(intf);
1096 if (size <= 0) {
1097 dev_err(&intf->dev, "failed to get manifest size: %d\n", size);
1098
1099 if (size)
1100 ret = size;
1101 else
1102 ret = -EINVAL;
1103
1104 goto err_disable_control;
1105 }
1106
1107 manifest = kmalloc(size, GFP_KERNEL);
1108 if (!manifest) {
1109 ret = -ENOMEM;
1110 goto err_disable_control;
1111 }
1112
1113 /* Get manifest using control protocol on CPort */
1114 ret = gb_control_get_manifest_operation(intf, manifest, size);
1115 if (ret) {
1116 dev_err(&intf->dev, "failed to get manifest: %d\n", ret);
1117 goto err_free_manifest;
1118 }
1119
1120 /*
1121 * Parse the manifest and build up our data structures representing
1122 * what's in it.
1123 */
1124 if (!gb_manifest_parse(intf, manifest, size)) {
1125 dev_err(&intf->dev, "failed to parse manifest\n");
1126 ret = -EINVAL;
1127 goto err_destroy_bundles;
1128 }
1129
1130 ret = gb_control_get_bundle_versions(intf->control);
1131 if (ret)
1132 goto err_destroy_bundles;
1133
1134 /* Register the control device and any bundles */
1135 ret = gb_control_add(intf->control);
1136 if (ret)
1137 goto err_destroy_bundles;
1138
1139 pm_runtime_use_autosuspend(&intf->dev);
1140 pm_runtime_get_noresume(&intf->dev);
1141 pm_runtime_set_active(&intf->dev);
1142 pm_runtime_enable(&intf->dev);
1143
1144 list_for_each_entry_safe_reverse(bundle, tmp, &intf->bundles, links) {
1145 ret = gb_bundle_add(bundle);
1146 if (ret) {
1147 gb_bundle_destroy(bundle);
1148 continue;
1149 }
1150 }
1151
1152 kfree(manifest);
1153
1154 intf->enabled = true;
1155
1156 pm_runtime_put(&intf->dev);
1157
1158 trace_gb_interface_enable(intf);
1159
1160 return 0;
1161
1162err_destroy_bundles:
1163 list_for_each_entry_safe(bundle, tmp, &intf->bundles, links)
1164 gb_bundle_destroy(bundle);
1165err_free_manifest:
1166 kfree(manifest);
1167err_disable_control:
1168 gb_control_disable(intf->control);
1169err_put_control:
1170 gb_control_put(intf->control);
1171 intf->control = NULL;
1172
1173 return ret;
1174}
1175
1176/*
1177 * Disable an interface and destroy its bundles.
1178 *
1179 * Locking: Caller holds the interface mutex.
1180 */
1181void gb_interface_disable(struct gb_interface *intf)
1182{
1183 struct gb_bundle *bundle;
1184 struct gb_bundle *next;
1185
1186 if (!intf->enabled)
1187 return;
1188
1189 trace_gb_interface_disable(intf);
1190
1191 pm_runtime_get_sync(&intf->dev);
1192
1193 /* Set disconnected flag to avoid I/O during connection tear down. */
1194 if (intf->quirks & GB_INTERFACE_QUIRK_FORCED_DISABLE)
1195 intf->disconnected = true;
1196
1197 list_for_each_entry_safe(bundle, next, &intf->bundles, links)
1198 gb_bundle_destroy(bundle);
1199
1200 if (!intf->mode_switch && !intf->disconnected)
1201 gb_control_interface_deactivate_prepare(intf->control);
1202
1203 gb_control_del(intf->control);
1204 gb_control_disable(intf->control);
1205 gb_control_put(intf->control);
1206 intf->control = NULL;
1207
1208 intf->enabled = false;
1209
1210 pm_runtime_disable(&intf->dev);
1211 pm_runtime_set_suspended(&intf->dev);
1212 pm_runtime_dont_use_autosuspend(&intf->dev);
1213 pm_runtime_put_noidle(&intf->dev);
1214}
1215
1216/* Register an interface. */
1217int gb_interface_add(struct gb_interface *intf)
1218{
1219 int ret;
1220
1221 ret = device_add(&intf->dev);
1222 if (ret) {
1223 dev_err(&intf->dev, "failed to register interface: %d\n", ret);
1224 return ret;
1225 }
1226
1227 trace_gb_interface_add(intf);
1228
1229 dev_info(&intf->dev, "Interface added (%s)\n",
1230 gb_interface_type_string(intf));
1231
1232 switch (intf->type) {
1233 case GB_INTERFACE_TYPE_GREYBUS:
1234 dev_info(&intf->dev, "GMP VID=0x%08x, PID=0x%08x\n",
1235 intf->vendor_id, intf->product_id);
1236 /* fall-through */
1237 case GB_INTERFACE_TYPE_UNIPRO:
1238 dev_info(&intf->dev, "DDBL1 Manufacturer=0x%08x, Product=0x%08x\n",
1239 intf->ddbl1_manufacturer_id,
1240 intf->ddbl1_product_id);
1241 break;
1242 default:
1243 break;
1244 }
1245
1246 return 0;
1247}
1248
1249/* Deregister an interface. */
1250void gb_interface_del(struct gb_interface *intf)
1251{
1252 if (device_is_registered(&intf->dev)) {
1253 trace_gb_interface_del(intf);
1254
1255 device_del(&intf->dev);
1256 dev_info(&intf->dev, "Interface removed\n");
1257 }
1258}
1259
1260void gb_interface_put(struct gb_interface *intf)
1261{
1262 put_device(&intf->dev);
1263}
generated by cgit v1.2.2 (git 2.25.0) at 2025-09-11 07:36:31 -0400