xref: /linux/drivers/usb/typec/class.c (revision bf4afc53b77aeaa48b5409da5c8da6bb4eff7f43)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * USB Type-C Connector Class
4  *
5  * Copyright (C) 2017, Intel Corporation
6  * Author: Heikki Krogerus <heikki.krogerus@linux.intel.com>
7  */
8 
9 #include <linux/module.h>
10 #include <linux/mutex.h>
11 #include <linux/property.h>
12 #include <linux/slab.h>
13 #include <linux/string_choices.h>
14 #include <linux/usb/pd_vdo.h>
15 #include <linux/usb/typec_mux.h>
16 #include <linux/usb/typec_retimer.h>
17 #include <linux/usb.h>
18 
19 #include "bus.h"
20 #include "class.h"
21 #include "pd.h"
22 
23 static DEFINE_IDA(typec_index_ida);
24 
25 const struct class typec_class = {
26 	.name = "typec",
27 };
28 
29 /* ------------------------------------------------------------------------- */
30 /* Common attributes */
31 
32 static const char * const typec_accessory_modes[] = {
33 	[TYPEC_ACCESSORY_NONE]		= "none",
34 	[TYPEC_ACCESSORY_AUDIO]		= "analog_audio",
35 	[TYPEC_ACCESSORY_DEBUG]		= "debug",
36 };
37 
38 /* Product types defined in USB PD Specification R3.0 V2.0 */
39 static const char * const product_type_ufp[8] = {
40 	[IDH_PTYPE_NOT_UFP]		= "not_ufp",
41 	[IDH_PTYPE_HUB]			= "hub",
42 	[IDH_PTYPE_PERIPH]		= "peripheral",
43 	[IDH_PTYPE_PSD]			= "psd",
44 	[IDH_PTYPE_AMA]			= "ama",
45 };
46 
47 static const char * const product_type_dfp[8] = {
48 	[IDH_PTYPE_NOT_DFP]		= "not_dfp",
49 	[IDH_PTYPE_DFP_HUB]		= "hub",
50 	[IDH_PTYPE_DFP_HOST]		= "host",
51 	[IDH_PTYPE_DFP_PB]		= "power_brick",
52 };
53 
54 static const char * const product_type_cable[8] = {
55 	[IDH_PTYPE_NOT_CABLE]		= "not_cable",
56 	[IDH_PTYPE_PCABLE]		= "passive",
57 	[IDH_PTYPE_ACABLE]		= "active",
58 	[IDH_PTYPE_VPD]			= "vpd",
59 };
60 
get_pd_identity(struct device * dev)61 static struct usb_pd_identity *get_pd_identity(struct device *dev)
62 {
63 	if (is_typec_partner(dev)) {
64 		struct typec_partner *partner = to_typec_partner(dev);
65 
66 		return partner->identity;
67 	} else if (is_typec_cable(dev)) {
68 		struct typec_cable *cable = to_typec_cable(dev);
69 
70 		return cable->identity;
71 	}
72 	return NULL;
73 }
74 
get_pd_product_type(struct device * dev)75 static const char *get_pd_product_type(struct device *dev)
76 {
77 	struct typec_port *port = to_typec_port(dev->parent);
78 	struct usb_pd_identity *id = get_pd_identity(dev);
79 	const char *ptype = NULL;
80 
81 	if (is_typec_partner(dev)) {
82 		if (!id)
83 			return NULL;
84 
85 		if (port->data_role == TYPEC_HOST)
86 			ptype = product_type_ufp[PD_IDH_PTYPE(id->id_header)];
87 		else
88 			ptype = product_type_dfp[PD_IDH_DFP_PTYPE(id->id_header)];
89 	} else if (is_typec_cable(dev)) {
90 		if (id)
91 			ptype = product_type_cable[PD_IDH_PTYPE(id->id_header)];
92 		else
93 			ptype = to_typec_cable(dev)->active ?
94 				product_type_cable[IDH_PTYPE_ACABLE] :
95 				product_type_cable[IDH_PTYPE_PCABLE];
96 	}
97 
98 	return ptype;
99 }
100 
id_header_show(struct device * dev,struct device_attribute * attr,char * buf)101 static ssize_t id_header_show(struct device *dev, struct device_attribute *attr,
102 			      char *buf)
103 {
104 	struct usb_pd_identity *id = get_pd_identity(dev);
105 
106 	return sprintf(buf, "0x%08x\n", id->id_header);
107 }
108 static DEVICE_ATTR_RO(id_header);
109 
cert_stat_show(struct device * dev,struct device_attribute * attr,char * buf)110 static ssize_t cert_stat_show(struct device *dev, struct device_attribute *attr,
111 			      char *buf)
112 {
113 	struct usb_pd_identity *id = get_pd_identity(dev);
114 
115 	return sprintf(buf, "0x%08x\n", id->cert_stat);
116 }
117 static DEVICE_ATTR_RO(cert_stat);
118 
product_show(struct device * dev,struct device_attribute * attr,char * buf)119 static ssize_t product_show(struct device *dev, struct device_attribute *attr,
120 			    char *buf)
121 {
122 	struct usb_pd_identity *id = get_pd_identity(dev);
123 
124 	return sprintf(buf, "0x%08x\n", id->product);
125 }
126 static DEVICE_ATTR_RO(product);
127 
product_type_vdo1_show(struct device * dev,struct device_attribute * attr,char * buf)128 static ssize_t product_type_vdo1_show(struct device *dev, struct device_attribute *attr,
129 				      char *buf)
130 {
131 	struct usb_pd_identity *id = get_pd_identity(dev);
132 
133 	return sysfs_emit(buf, "0x%08x\n", id->vdo[0]);
134 }
135 static DEVICE_ATTR_RO(product_type_vdo1);
136 
product_type_vdo2_show(struct device * dev,struct device_attribute * attr,char * buf)137 static ssize_t product_type_vdo2_show(struct device *dev, struct device_attribute *attr,
138 				      char *buf)
139 {
140 	struct usb_pd_identity *id = get_pd_identity(dev);
141 
142 	return sysfs_emit(buf, "0x%08x\n", id->vdo[1]);
143 }
144 static DEVICE_ATTR_RO(product_type_vdo2);
145 
product_type_vdo3_show(struct device * dev,struct device_attribute * attr,char * buf)146 static ssize_t product_type_vdo3_show(struct device *dev, struct device_attribute *attr,
147 				      char *buf)
148 {
149 	struct usb_pd_identity *id = get_pd_identity(dev);
150 
151 	return sysfs_emit(buf, "0x%08x\n", id->vdo[2]);
152 }
153 static DEVICE_ATTR_RO(product_type_vdo3);
154 
155 static struct attribute *usb_pd_id_attrs[] = {
156 	&dev_attr_id_header.attr,
157 	&dev_attr_cert_stat.attr,
158 	&dev_attr_product.attr,
159 	&dev_attr_product_type_vdo1.attr,
160 	&dev_attr_product_type_vdo2.attr,
161 	&dev_attr_product_type_vdo3.attr,
162 	NULL
163 };
164 
165 static const struct attribute_group usb_pd_id_group = {
166 	.name = "identity",
167 	.attrs = usb_pd_id_attrs,
168 };
169 
170 static const struct attribute_group *usb_pd_id_groups[] = {
171 	&usb_pd_id_group,
172 	NULL,
173 };
174 
typec_product_type_notify(struct device * dev)175 static void typec_product_type_notify(struct device *dev)
176 {
177 	char *envp[2] = { };
178 	const char *ptype;
179 
180 	ptype = get_pd_product_type(dev);
181 	if (!ptype)
182 		return;
183 
184 	sysfs_notify(&dev->kobj, NULL, "type");
185 
186 	envp[0] = kasprintf(GFP_KERNEL, "PRODUCT_TYPE=%s", ptype);
187 	if (!envp[0])
188 		return;
189 
190 	kobject_uevent_env(&dev->kobj, KOBJ_CHANGE, envp);
191 	kfree(envp[0]);
192 }
193 
typec_report_identity(struct device * dev)194 static void typec_report_identity(struct device *dev)
195 {
196 	sysfs_notify(&dev->kobj, "identity", "id_header");
197 	sysfs_notify(&dev->kobj, "identity", "cert_stat");
198 	sysfs_notify(&dev->kobj, "identity", "product");
199 	sysfs_notify(&dev->kobj, "identity", "product_type_vdo1");
200 	sysfs_notify(&dev->kobj, "identity", "product_type_vdo2");
201 	sysfs_notify(&dev->kobj, "identity", "product_type_vdo3");
202 	typec_product_type_notify(dev);
203 }
204 
205 static ssize_t
type_show(struct device * dev,struct device_attribute * attr,char * buf)206 type_show(struct device *dev, struct device_attribute *attr, char *buf)
207 {
208 	const char *ptype;
209 
210 	ptype = get_pd_product_type(dev);
211 	if (!ptype)
212 		return 0;
213 
214 	return sysfs_emit(buf, "%s\n", ptype);
215 }
216 static DEVICE_ATTR_RO(type);
217 
218 static ssize_t usb_power_delivery_revision_show(struct device *dev,
219 						struct device_attribute *attr,
220 						char *buf);
221 static DEVICE_ATTR_RO(usb_power_delivery_revision);
222 
223 static const char * const usb_modes[] = {
224 	[USB_MODE_NONE] = "none",
225 	[USB_MODE_USB2] = "usb2",
226 	[USB_MODE_USB3] = "usb3",
227 	[USB_MODE_USB4] = "usb4"
228 };
229 
230 /* ------------------------------------------------------------------------- */
231 /* Alternate Modes */
232 
altmode_match(struct device * dev,const void * data)233 static int altmode_match(struct device *dev, const void *data)
234 {
235 	struct typec_altmode *adev = to_typec_altmode(dev);
236 	const struct typec_device_id *id = data;
237 
238 	if (!is_typec_port_altmode(dev))
239 		return 0;
240 
241 	return (adev->svid == id->svid);
242 }
243 
typec_altmode_set_partner(struct altmode * altmode)244 static void typec_altmode_set_partner(struct altmode *altmode)
245 {
246 	struct typec_altmode *adev = &altmode->adev;
247 	struct typec_device_id id = { adev->svid };
248 	struct typec_port *port = typec_altmode2port(adev);
249 	struct altmode *partner;
250 	struct device *dev;
251 
252 	dev = device_find_child(&port->dev, &id, altmode_match);
253 	if (!dev)
254 		return;
255 
256 	/* Bind the port alt mode to the partner/plug alt mode. */
257 	partner = to_altmode(to_typec_altmode(dev));
258 	altmode->partner = partner;
259 
260 	/* Bind the partner/plug alt mode to the port alt mode. */
261 	if (is_typec_plug(adev->dev.parent)) {
262 		struct typec_plug *plug = to_typec_plug(adev->dev.parent);
263 
264 		partner->plug[plug->index] = altmode;
265 	} else {
266 		partner->partner = altmode;
267 	}
268 }
269 
typec_altmode_put_partner(struct altmode * altmode)270 static void typec_altmode_put_partner(struct altmode *altmode)
271 {
272 	struct altmode *partner = altmode->partner;
273 	struct typec_altmode *adev;
274 	struct typec_altmode *partner_adev;
275 
276 	if (!partner)
277 		return;
278 
279 	adev = &altmode->adev;
280 	partner_adev = &partner->adev;
281 
282 	if (is_typec_plug(adev->dev.parent)) {
283 		struct typec_plug *plug = to_typec_plug(adev->dev.parent);
284 
285 		partner->plug[plug->index] = NULL;
286 	} else {
287 		partner->partner = NULL;
288 	}
289 	put_device(&partner_adev->dev);
290 }
291 
292 /**
293  * typec_altmode_update_active - Report Enter/Exit mode
294  * @adev: Handle to the alternate mode
295  * @active: True when the mode has been entered
296  *
297  * If a partner or cable plug executes Enter/Exit Mode command successfully, the
298  * drivers use this routine to report the updated state of the mode.
299  */
typec_altmode_update_active(struct typec_altmode * adev,bool active)300 void typec_altmode_update_active(struct typec_altmode *adev, bool active)
301 {
302 	char dir[6];
303 
304 	if (adev->active == active)
305 		return;
306 
307 	if (!is_typec_port(adev->dev.parent) && adev->dev.driver) {
308 		if (!active)
309 			module_put(adev->dev.driver->owner);
310 		else
311 			WARN_ON(!try_module_get(adev->dev.driver->owner));
312 	}
313 
314 	adev->active = active;
315 	snprintf(dir, sizeof(dir), "mode%d", adev->mode);
316 	sysfs_notify(&adev->dev.kobj, dir, "active");
317 	sysfs_notify(&adev->dev.kobj, NULL, "active");
318 	kobject_uevent(&adev->dev.kobj, KOBJ_CHANGE);
319 }
320 EXPORT_SYMBOL_GPL(typec_altmode_update_active);
321 
322 /**
323  * typec_altmode2port - Alternate Mode to USB Type-C port
324  * @alt: The Alternate Mode
325  *
326  * Returns handle to the port that a cable plug or partner with @alt is
327  * connected to.
328  */
typec_altmode2port(struct typec_altmode * alt)329 struct typec_port *typec_altmode2port(struct typec_altmode *alt)
330 {
331 	if (is_typec_plug(alt->dev.parent))
332 		return to_typec_port(alt->dev.parent->parent->parent);
333 	if (is_typec_partner(alt->dev.parent))
334 		return to_typec_port(alt->dev.parent->parent);
335 	if (is_typec_port(alt->dev.parent))
336 		return to_typec_port(alt->dev.parent);
337 
338 	return NULL;
339 }
340 EXPORT_SYMBOL_GPL(typec_altmode2port);
341 
342 static ssize_t
vdo_show(struct device * dev,struct device_attribute * attr,char * buf)343 vdo_show(struct device *dev, struct device_attribute *attr, char *buf)
344 {
345 	struct typec_altmode *alt = to_typec_altmode(dev);
346 
347 	return sprintf(buf, "0x%08x\n", alt->vdo);
348 }
349 static DEVICE_ATTR_RO(vdo);
350 
351 static ssize_t
description_show(struct device * dev,struct device_attribute * attr,char * buf)352 description_show(struct device *dev, struct device_attribute *attr, char *buf)
353 {
354 	struct typec_altmode *alt = to_typec_altmode(dev);
355 
356 	return sprintf(buf, "%s\n", alt->desc ? alt->desc : "");
357 }
358 static DEVICE_ATTR_RO(description);
359 
360 static ssize_t
active_show(struct device * dev,struct device_attribute * attr,char * buf)361 active_show(struct device *dev, struct device_attribute *attr, char *buf)
362 {
363 	struct typec_altmode *alt = to_typec_altmode(dev);
364 
365 	return sprintf(buf, "%s\n", str_yes_no(alt->active));
366 }
367 
active_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)368 static ssize_t active_store(struct device *dev, struct device_attribute *attr,
369 			    const char *buf, size_t size)
370 {
371 	struct typec_altmode *adev = to_typec_altmode(dev);
372 	struct altmode *altmode = to_altmode(adev);
373 	bool enter;
374 	int ret;
375 
376 	ret = kstrtobool(buf, &enter);
377 	if (ret)
378 		return ret;
379 
380 	if (adev->active == enter)
381 		return size;
382 
383 	if (is_typec_port(adev->dev.parent)) {
384 		typec_altmode_update_active(adev, enter);
385 
386 		/* Make sure that the partner exits the mode before disabling */
387 		if (altmode->partner && !enter && altmode->partner->adev.active)
388 			typec_altmode_exit(&altmode->partner->adev);
389 	} else if (altmode->partner) {
390 		if (enter && !altmode->partner->adev.active) {
391 			dev_warn(dev, "port has the mode disabled\n");
392 			return -EPERM;
393 		}
394 	}
395 
396 	/* Note: If there is no driver, the mode will not be entered */
397 	if (adev->ops && adev->ops->activate) {
398 		ret = adev->ops->activate(adev, enter);
399 		if (ret)
400 			return ret;
401 	}
402 
403 	return size;
404 }
405 static DEVICE_ATTR_RW(active);
406 
407 static ssize_t
supported_roles_show(struct device * dev,struct device_attribute * attr,char * buf)408 supported_roles_show(struct device *dev, struct device_attribute *attr,
409 		     char *buf)
410 {
411 	struct altmode *alt = to_altmode(to_typec_altmode(dev));
412 	ssize_t ret;
413 
414 	switch (alt->roles) {
415 	case TYPEC_PORT_SRC:
416 		ret = sprintf(buf, "source\n");
417 		break;
418 	case TYPEC_PORT_SNK:
419 		ret = sprintf(buf, "sink\n");
420 		break;
421 	case TYPEC_PORT_DRP:
422 	default:
423 		ret = sprintf(buf, "source sink\n");
424 		break;
425 	}
426 	return ret;
427 }
428 static DEVICE_ATTR_RO(supported_roles);
429 
430 static ssize_t
mode_show(struct device * dev,struct device_attribute * attr,char * buf)431 mode_show(struct device *dev, struct device_attribute *attr, char *buf)
432 {
433 	struct typec_altmode *adev = to_typec_altmode(dev);
434 
435 	return sprintf(buf, "%u\n", adev->mode);
436 }
437 static DEVICE_ATTR_RO(mode);
438 
439 static ssize_t
svid_show(struct device * dev,struct device_attribute * attr,char * buf)440 svid_show(struct device *dev, struct device_attribute *attr, char *buf)
441 {
442 	struct typec_altmode *adev = to_typec_altmode(dev);
443 
444 	return sprintf(buf, "%04x\n", adev->svid);
445 }
446 static DEVICE_ATTR_RO(svid);
447 
increment_duplicated_priority(struct device * dev,void * data)448 static int increment_duplicated_priority(struct device *dev, void *data)
449 {
450 	if (is_typec_port_altmode(dev)) {
451 		struct typec_altmode **alt_target = (struct typec_altmode **)data;
452 		struct typec_altmode *alt = to_typec_altmode(dev);
453 
454 		if (alt != *alt_target && alt->priority == (*alt_target)->priority) {
455 			alt->priority++;
456 			*alt_target = alt;
457 			return 1;
458 		}
459 	}
460 	return 0;
461 }
462 
find_duplicated_priority(struct device * dev,void * data)463 static int find_duplicated_priority(struct device *dev, void *data)
464 {
465 	if (is_typec_port_altmode(dev)) {
466 		struct typec_altmode **alt_target = (struct typec_altmode **)data;
467 		struct typec_altmode *alt = to_typec_altmode(dev);
468 
469 		if (alt != *alt_target && alt->priority == (*alt_target)->priority)
470 			return 1;
471 	}
472 	return 0;
473 }
474 
typec_mode_set_priority(struct typec_altmode * alt,const u8 priority)475 static int typec_mode_set_priority(struct typec_altmode *alt, const u8 priority)
476 {
477 	struct typec_port *port = to_typec_port(alt->dev.parent);
478 	const u8 old_priority = alt->priority;
479 	int res = 1;
480 
481 	alt->priority = priority;
482 	while (res) {
483 		res = device_for_each_child(&port->dev, &alt, find_duplicated_priority);
484 		if (res) {
485 			alt->priority++;
486 			if (alt->priority == 0) {
487 				alt->priority = old_priority;
488 				return -EOVERFLOW;
489 			}
490 		}
491 	}
492 
493 	res = 1;
494 	alt->priority = priority;
495 	while (res)
496 		res = device_for_each_child(&port->dev, &alt,
497 					    increment_duplicated_priority);
498 
499 	return 0;
500 }
501 
priority_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)502 static ssize_t priority_store(struct device *dev,
503 			      struct device_attribute *attr,
504 			      const char *buf, size_t size)
505 {
506 	u8 val;
507 	int err = kstrtou8(buf, 10, &val);
508 
509 	if (!err)
510 		err = typec_mode_set_priority(to_typec_altmode(dev), val);
511 
512 	if (!err)
513 		return size;
514 	return err;
515 }
516 
priority_show(struct device * dev,struct device_attribute * attr,char * buf)517 static ssize_t priority_show(struct device *dev,
518 			     struct device_attribute *attr, char *buf)
519 {
520 	return sysfs_emit(buf, "%u\n", to_typec_altmode(dev)->priority);
521 }
522 static DEVICE_ATTR_RW(priority);
523 
524 static struct attribute *typec_altmode_attrs[] = {
525 	&dev_attr_active.attr,
526 	&dev_attr_mode.attr,
527 	&dev_attr_svid.attr,
528 	&dev_attr_vdo.attr,
529 	&dev_attr_priority.attr,
530 	NULL
531 };
532 
typec_altmode_attr_is_visible(struct kobject * kobj,struct attribute * attr,int n)533 static umode_t typec_altmode_attr_is_visible(struct kobject *kobj,
534 					     struct attribute *attr, int n)
535 {
536 	struct typec_altmode *adev = to_typec_altmode(kobj_to_dev(kobj));
537 	struct typec_port *port = typec_altmode2port(adev);
538 
539 	if (attr == &dev_attr_active.attr) {
540 		if (!is_typec_port(adev->dev.parent)) {
541 			if (!port->mode_control || !adev->ops || !adev->ops->activate)
542 				return 0444;
543 		}
544 	} else if (attr == &dev_attr_priority.attr) {
545 		if (!is_typec_port(adev->dev.parent) || !port->mode_control)
546 			return 0;
547 	}
548 
549 	return attr->mode;
550 }
551 
552 static const struct attribute_group typec_altmode_group = {
553 	.is_visible = typec_altmode_attr_is_visible,
554 	.attrs = typec_altmode_attrs,
555 };
556 
557 static const struct attribute_group *typec_altmode_groups[] = {
558 	&typec_altmode_group,
559 	NULL
560 };
561 
562 /**
563  * typec_altmode_set_ops - Set ops for altmode
564  * @adev: Handle to the alternate mode
565  * @ops: Ops for the alternate mode
566  *
567  * After setting ops, attribute visiblity needs to be refreshed if the alternate
568  * mode can be activated.
569  */
typec_altmode_set_ops(struct typec_altmode * adev,const struct typec_altmode_ops * ops)570 void typec_altmode_set_ops(struct typec_altmode *adev,
571 			   const struct typec_altmode_ops *ops)
572 {
573 	adev->ops = ops;
574 	sysfs_update_group(&adev->dev.kobj, &typec_altmode_group);
575 }
576 EXPORT_SYMBOL_GPL(typec_altmode_set_ops);
577 
altmode_id_get(struct device * dev)578 static int altmode_id_get(struct device *dev)
579 {
580 	struct ida *ids;
581 
582 	if (is_typec_partner(dev))
583 		ids = &to_typec_partner(dev)->mode_ids;
584 	else if (is_typec_plug(dev))
585 		ids = &to_typec_plug(dev)->mode_ids;
586 	else
587 		ids = &to_typec_port(dev)->mode_ids;
588 
589 	return ida_alloc(ids, GFP_KERNEL);
590 }
591 
altmode_id_remove(struct device * dev,int id)592 static void altmode_id_remove(struct device *dev, int id)
593 {
594 	struct ida *ids;
595 
596 	if (is_typec_partner(dev))
597 		ids = &to_typec_partner(dev)->mode_ids;
598 	else if (is_typec_plug(dev))
599 		ids = &to_typec_plug(dev)->mode_ids;
600 	else
601 		ids = &to_typec_port(dev)->mode_ids;
602 
603 	ida_free(ids, id);
604 }
605 
typec_altmode_release(struct device * dev)606 static void typec_altmode_release(struct device *dev)
607 {
608 	struct altmode *alt = to_altmode(to_typec_altmode(dev));
609 
610 	if (!is_typec_port(dev->parent))
611 		typec_altmode_put_partner(alt);
612 
613 	altmode_id_remove(alt->adev.dev.parent, alt->id);
614 	put_device(alt->adev.dev.parent);
615 	kfree(alt);
616 }
617 
618 const struct device_type typec_port_altmode_dev_type = {
619 	.name = "typec_port_alternate_mode",
620 	.groups = typec_altmode_groups,
621 	.release = typec_altmode_release,
622 };
623 EXPORT_SYMBOL_GPL(typec_port_altmode_dev_type);
624 
625 const struct device_type typec_plug_altmode_dev_type = {
626 	.name = "typec_plug_alternate_mode",
627 	.groups = typec_altmode_groups,
628 	.release = typec_altmode_release,
629 };
630 EXPORT_SYMBOL_GPL(typec_plug_altmode_dev_type);
631 
632 const struct device_type typec_partner_altmode_dev_type = {
633 	.name = "typec_partner_alternate_mode",
634 	.groups = typec_altmode_groups,
635 	.release = typec_altmode_release,
636 };
637 EXPORT_SYMBOL_GPL(typec_partner_altmode_dev_type);
638 
639 static struct typec_altmode *
typec_register_altmode(struct device * parent,const struct typec_altmode_desc * desc,const struct device_type * type)640 typec_register_altmode(struct device *parent,
641 		       const struct typec_altmode_desc *desc,
642 		       const struct device_type *type)
643 {
644 	unsigned int id = altmode_id_get(parent);
645 	bool is_port = is_typec_port(parent);
646 	struct altmode *alt;
647 	int ret;
648 
649 	alt = kzalloc_obj(*alt);
650 	if (!alt) {
651 		altmode_id_remove(parent, id);
652 		return ERR_PTR(-ENOMEM);
653 	}
654 
655 	alt->adev.svid = desc->svid;
656 	alt->adev.mode = desc->mode;
657 	alt->adev.vdo = desc->vdo;
658 	alt->adev.mode_selection = desc->mode_selection;
659 	alt->roles = desc->roles;
660 	alt->id = id;
661 
662 	alt->attrs[0] = &dev_attr_vdo.attr;
663 	alt->attrs[1] = &dev_attr_description.attr;
664 	alt->attrs[2] = &dev_attr_active.attr;
665 
666 	if (is_port) {
667 		alt->attrs[3] = &dev_attr_supported_roles.attr;
668 		alt->adev.active = !desc->inactive; /* Enabled by default */
669 	}
670 
671 	sprintf(alt->group_name, "mode%d", desc->mode);
672 	alt->group.name = alt->group_name;
673 	alt->group.attrs = alt->attrs;
674 	alt->groups[0] = &alt->group;
675 
676 	alt->adev.dev.parent = parent;
677 	alt->adev.dev.groups = alt->groups;
678 	alt->adev.dev.type = type;
679 	dev_set_name(&alt->adev.dev, "%s.%u", dev_name(parent), id);
680 
681 	get_device(alt->adev.dev.parent);
682 
683 	/* Link partners and plugs with the ports */
684 	if (!is_port)
685 		typec_altmode_set_partner(alt);
686 
687 	alt->adev.dev.bus = &typec_bus;
688 
689 	/* Plug alt modes need a class to generate udev events. */
690 	if (is_typec_plug(parent))
691 		alt->adev.dev.class = &typec_class;
692 
693 	ret = device_register(&alt->adev.dev);
694 	if (ret) {
695 		dev_err(parent, "failed to register alternate mode (%d)\n",
696 			ret);
697 		put_device(&alt->adev.dev);
698 		return ERR_PTR(ret);
699 	}
700 
701 	return &alt->adev;
702 }
703 
704 /**
705  * typec_unregister_altmode - Unregister Alternate Mode
706  * @adev: The alternate mode to be unregistered
707  *
708  * Unregister device created with typec_partner_register_altmode(),
709  * typec_plug_register_altmode() or typec_port_register_altmode().
710  */
typec_unregister_altmode(struct typec_altmode * adev)711 void typec_unregister_altmode(struct typec_altmode *adev)
712 {
713 	if (IS_ERR_OR_NULL(adev))
714 		return;
715 	typec_retimer_put(to_altmode(adev)->retimer);
716 	typec_mux_put(to_altmode(adev)->mux);
717 	device_unregister(&adev->dev);
718 }
719 EXPORT_SYMBOL_GPL(typec_unregister_altmode);
720 
721 /* ------------------------------------------------------------------------- */
722 /* Type-C Partners */
723 
724 /**
725  * typec_partner_set_usb_mode - Assign active USB Mode for the partner
726  * @partner: USB Type-C partner
727  * @mode: USB Mode (USB2, USB3 or USB4)
728  *
729  * The port drivers can use this function to assign the active USB Mode to
730  * @partner. The USB Mode can change for example due to Data Reset.
731  */
typec_partner_set_usb_mode(struct typec_partner * partner,enum usb_mode mode)732 void typec_partner_set_usb_mode(struct typec_partner *partner, enum usb_mode mode)
733 {
734 	if (!partner || partner->usb_mode == mode)
735 		return;
736 
737 	partner->usb_capability |= BIT(mode - 1);
738 	partner->usb_mode = mode;
739 	sysfs_notify(&partner->dev.kobj, NULL, "usb_mode");
740 }
741 EXPORT_SYMBOL_GPL(typec_partner_set_usb_mode);
742 
743 static ssize_t
usb_mode_show(struct device * dev,struct device_attribute * attr,char * buf)744 usb_mode_show(struct device *dev, struct device_attribute *attr, char *buf)
745 {
746 	struct typec_partner *partner = to_typec_partner(dev);
747 	int len = 0;
748 	int i;
749 
750 	for (i = USB_MODE_USB2; i < USB_MODE_USB4 + 1; i++) {
751 		if (!(BIT(i - 1) & partner->usb_capability))
752 			continue;
753 
754 		if (i == partner->usb_mode)
755 			len += sysfs_emit_at(buf, len, "[%s] ", usb_modes[i]);
756 		else
757 			len += sysfs_emit_at(buf, len, "%s ", usb_modes[i]);
758 	}
759 
760 	sysfs_emit_at(buf, len - 1, "\n");
761 
762 	return len;
763 }
764 
usb_mode_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)765 static ssize_t usb_mode_store(struct device *dev, struct device_attribute *attr,
766 			      const char *buf, size_t size)
767 {
768 	struct typec_partner *partner = to_typec_partner(dev);
769 	struct typec_port *port = to_typec_port(dev->parent);
770 	int mode;
771 	int ret;
772 
773 	if (!port->ops || !port->ops->enter_usb_mode)
774 		return -EOPNOTSUPP;
775 
776 	mode = sysfs_match_string(usb_modes, buf);
777 	if (mode < 0)
778 		return mode;
779 
780 	if (mode == partner->usb_mode)
781 		return size;
782 
783 	ret = port->ops->enter_usb_mode(port, mode);
784 	if (ret)
785 		return ret;
786 
787 	typec_partner_set_usb_mode(partner, mode);
788 
789 	return size;
790 }
791 static DEVICE_ATTR_RW(usb_mode);
792 
accessory_mode_show(struct device * dev,struct device_attribute * attr,char * buf)793 static ssize_t accessory_mode_show(struct device *dev,
794 				   struct device_attribute *attr,
795 				   char *buf)
796 {
797 	struct typec_partner *p = to_typec_partner(dev);
798 
799 	return sprintf(buf, "%s\n", typec_accessory_modes[p->accessory]);
800 }
801 static DEVICE_ATTR_RO(accessory_mode);
802 
supports_usb_power_delivery_show(struct device * dev,struct device_attribute * attr,char * buf)803 static ssize_t supports_usb_power_delivery_show(struct device *dev,
804 						struct device_attribute *attr,
805 						char *buf)
806 {
807 	struct typec_partner *p = to_typec_partner(dev);
808 
809 	return sprintf(buf, "%s\n", str_yes_no(p->usb_pd));
810 }
811 static DEVICE_ATTR_RO(supports_usb_power_delivery);
812 
number_of_alternate_modes_show(struct device * dev,struct device_attribute * attr,char * buf)813 static ssize_t number_of_alternate_modes_show(struct device *dev, struct device_attribute *attr,
814 					      char *buf)
815 {
816 	struct typec_partner *partner;
817 	struct typec_plug *plug;
818 	int num_altmodes;
819 
820 	if (is_typec_partner(dev)) {
821 		partner = to_typec_partner(dev);
822 		num_altmodes = partner->num_altmodes;
823 	} else if (is_typec_plug(dev)) {
824 		plug = to_typec_plug(dev);
825 		num_altmodes = plug->num_altmodes;
826 	} else {
827 		return 0;
828 	}
829 
830 	return sysfs_emit(buf, "%d\n", num_altmodes);
831 }
832 static DEVICE_ATTR_RO(number_of_alternate_modes);
833 
834 static struct attribute *typec_partner_attrs[] = {
835 	&dev_attr_accessory_mode.attr,
836 	&dev_attr_supports_usb_power_delivery.attr,
837 	&dev_attr_number_of_alternate_modes.attr,
838 	&dev_attr_type.attr,
839 	&dev_attr_usb_mode.attr,
840 	&dev_attr_usb_power_delivery_revision.attr,
841 	NULL
842 };
843 
typec_partner_attr_is_visible(struct kobject * kobj,struct attribute * attr,int n)844 static umode_t typec_partner_attr_is_visible(struct kobject *kobj, struct attribute *attr, int n)
845 {
846 	struct typec_partner *partner = to_typec_partner(kobj_to_dev(kobj));
847 	struct typec_port *port = to_typec_port(partner->dev.parent);
848 
849 	if (attr == &dev_attr_usb_mode.attr) {
850 		if (!partner->usb_capability)
851 			return 0;
852 		if (!port->ops || !port->ops->enter_usb_mode)
853 			return 0444;
854 	}
855 
856 	if (attr == &dev_attr_number_of_alternate_modes.attr) {
857 		if (partner->num_altmodes < 0)
858 			return 0;
859 	}
860 
861 	if (attr == &dev_attr_type.attr)
862 		if (!get_pd_product_type(kobj_to_dev(kobj)))
863 			return 0;
864 
865 	return attr->mode;
866 }
867 
868 static const struct attribute_group typec_partner_group = {
869 	.is_visible = typec_partner_attr_is_visible,
870 	.attrs = typec_partner_attrs
871 };
872 
873 static const struct attribute_group *typec_partner_groups[] = {
874 	&typec_partner_group,
875 	NULL
876 };
877 
typec_partner_release(struct device * dev)878 static void typec_partner_release(struct device *dev)
879 {
880 	struct typec_partner *partner = to_typec_partner(dev);
881 
882 	ida_destroy(&partner->mode_ids);
883 	kfree(partner);
884 }
885 
886 const struct device_type typec_partner_dev_type = {
887 	.name = "typec_partner",
888 	.groups = typec_partner_groups,
889 	.release = typec_partner_release,
890 };
891 
typec_partner_link_device(struct typec_partner * partner,struct device * dev)892 static void typec_partner_link_device(struct typec_partner *partner, struct device *dev)
893 {
894 	int ret;
895 
896 	ret = sysfs_create_link(&dev->kobj, &partner->dev.kobj, "typec");
897 	if (ret)
898 		return;
899 
900 	ret = sysfs_create_link(&partner->dev.kobj, &dev->kobj, dev_name(dev));
901 	if (ret) {
902 		sysfs_remove_link(&dev->kobj, "typec");
903 		return;
904 	}
905 
906 	if (partner->attach)
907 		partner->attach(partner, dev);
908 }
909 
typec_partner_unlink_device(struct typec_partner * partner,struct device * dev)910 static void typec_partner_unlink_device(struct typec_partner *partner, struct device *dev)
911 {
912 	sysfs_remove_link(&partner->dev.kobj, dev_name(dev));
913 	sysfs_remove_link(&dev->kobj, "typec");
914 
915 	if (partner->deattach)
916 		partner->deattach(partner, dev);
917 }
918 
919 /**
920  * typec_partner_set_identity - Report result from Discover Identity command
921  * @partner: The partner updated identity values
922  *
923  * This routine is used to report that the result of Discover Identity USB power
924  * delivery command has become available.
925  */
typec_partner_set_identity(struct typec_partner * partner)926 int typec_partner_set_identity(struct typec_partner *partner)
927 {
928 	u8 usb_capability = partner->usb_capability;
929 	struct device *dev = &partner->dev;
930 	struct usb_pd_identity *id;
931 
932 	id = get_pd_identity(dev);
933 	if (!id)
934 		return -EINVAL;
935 
936 	if (to_typec_port(dev->parent)->data_role == TYPEC_HOST)  {
937 		u32 devcap = PD_VDO_UFP_DEVCAP(id->vdo[0]);
938 
939 		if (devcap & (DEV_USB2_CAPABLE | DEV_USB2_BILLBOARD))
940 			usb_capability |= USB_CAPABILITY_USB2;
941 		if (devcap & DEV_USB3_CAPABLE)
942 			usb_capability |= USB_CAPABILITY_USB3;
943 		if (devcap & DEV_USB4_CAPABLE)
944 			usb_capability |= USB_CAPABILITY_USB4;
945 	} else {
946 		usb_capability = PD_VDO_DFP_HOSTCAP(id->vdo[0]);
947 	}
948 
949 	if (partner->usb_capability != usb_capability) {
950 		partner->usb_capability = usb_capability;
951 		sysfs_notify(&dev->kobj, NULL, "usb_mode");
952 	}
953 
954 	typec_report_identity(dev);
955 	return 0;
956 }
957 EXPORT_SYMBOL_GPL(typec_partner_set_identity);
958 
959 /**
960  * typec_partner_set_pd_revision - Set the PD revision supported by the partner
961  * @partner: The partner to be updated.
962  * @pd_revision:  USB Power Delivery Specification Revision supported by partner
963  *
964  * This routine is used to report that the PD revision of the port partner has
965  * become available.
966  */
typec_partner_set_pd_revision(struct typec_partner * partner,u16 pd_revision)967 void typec_partner_set_pd_revision(struct typec_partner *partner, u16 pd_revision)
968 {
969 	if (partner->pd_revision == pd_revision)
970 		return;
971 
972 	partner->pd_revision = pd_revision;
973 	sysfs_notify(&partner->dev.kobj, NULL, "usb_power_delivery_revision");
974 	if (pd_revision != 0 && !partner->usb_pd) {
975 		partner->usb_pd = 1;
976 		sysfs_notify(&partner->dev.kobj, NULL,
977 			     "supports_usb_power_delivery");
978 	}
979 	kobject_uevent(&partner->dev.kobj, KOBJ_CHANGE);
980 }
981 EXPORT_SYMBOL_GPL(typec_partner_set_pd_revision);
982 
983 /**
984  * typec_partner_set_usb_power_delivery - Declare USB Power Delivery Contract.
985  * @partner: The partner device.
986  * @pd: The USB PD instance.
987  *
988  * This routine can be used to declare USB Power Delivery Contract with @partner
989  * by linking @partner to @pd which contains the objects that were used during the
990  * negotiation of the contract.
991  *
992  * If @pd is NULL, the link is removed and the contract with @partner has ended.
993  */
typec_partner_set_usb_power_delivery(struct typec_partner * partner,struct usb_power_delivery * pd)994 int typec_partner_set_usb_power_delivery(struct typec_partner *partner,
995 					 struct usb_power_delivery *pd)
996 {
997 	int ret;
998 
999 	if (IS_ERR_OR_NULL(partner) || partner->pd == pd)
1000 		return 0;
1001 
1002 	if (pd) {
1003 		ret = usb_power_delivery_link_device(pd, &partner->dev);
1004 		if (ret)
1005 			return ret;
1006 	} else {
1007 		usb_power_delivery_unlink_device(partner->pd, &partner->dev);
1008 	}
1009 
1010 	partner->pd = pd;
1011 
1012 	return 0;
1013 }
1014 EXPORT_SYMBOL_GPL(typec_partner_set_usb_power_delivery);
1015 
1016 /**
1017  * typec_partner_set_num_altmodes - Set the number of available partner altmodes
1018  * @partner: The partner to be updated.
1019  * @num_altmodes: The number of altmodes we want to specify as available.
1020  *
1021  * This routine is used to report the number of alternate modes supported by the
1022  * partner. This value is *not* enforced in alternate mode registration routines.
1023  *
1024  * @partner.num_altmodes is set to -1 on partner registration, denoting that
1025  * a valid value has not been set for it yet.
1026  *
1027  * Returns 0 on success or negative error number on failure.
1028  */
typec_partner_set_num_altmodes(struct typec_partner * partner,int num_altmodes)1029 int typec_partner_set_num_altmodes(struct typec_partner *partner, int num_altmodes)
1030 {
1031 	int ret;
1032 
1033 	if (num_altmodes < 0)
1034 		return -EINVAL;
1035 
1036 	partner->num_altmodes = num_altmodes;
1037 	ret = sysfs_update_group(&partner->dev.kobj, &typec_partner_group);
1038 	if (ret < 0)
1039 		return ret;
1040 
1041 	sysfs_notify(&partner->dev.kobj, NULL, "number_of_alternate_modes");
1042 	kobject_uevent(&partner->dev.kobj, KOBJ_CHANGE);
1043 
1044 	return 0;
1045 }
1046 EXPORT_SYMBOL_GPL(typec_partner_set_num_altmodes);
1047 
1048 /**
1049  * typec_partner_register_altmode - Register USB Type-C Partner Alternate Mode
1050  * @partner: USB Type-C Partner that supports the alternate mode
1051  * @desc: Description of the alternate mode
1052  *
1053  * This routine is used to register each alternate mode individually that
1054  * @partner has listed in response to Discover SVIDs command. The modes for a
1055  * SVID listed in response to Discover Modes command need to be listed in an
1056  * array in @desc.
1057  *
1058  * Returns handle to the alternate mode on success or ERR_PTR on failure.
1059  */
1060 struct typec_altmode *
typec_partner_register_altmode(struct typec_partner * partner,const struct typec_altmode_desc * desc)1061 typec_partner_register_altmode(struct typec_partner *partner,
1062 			       const struct typec_altmode_desc *desc)
1063 {
1064 	return typec_register_altmode(&partner->dev, desc, &typec_partner_altmode_dev_type);
1065 }
1066 EXPORT_SYMBOL_GPL(typec_partner_register_altmode);
1067 
1068 /**
1069  * typec_partner_set_svdm_version - Set negotiated Structured VDM (SVDM) Version
1070  * @partner: USB Type-C Partner that supports SVDM
1071  * @svdm_version: Negotiated SVDM Version
1072  *
1073  * This routine is used to save the negotiated SVDM Version.
1074  */
typec_partner_set_svdm_version(struct typec_partner * partner,enum usb_pd_svdm_ver svdm_version)1075 void typec_partner_set_svdm_version(struct typec_partner *partner,
1076 				   enum usb_pd_svdm_ver svdm_version)
1077 {
1078 	partner->svdm_version = svdm_version;
1079 }
1080 EXPORT_SYMBOL_GPL(typec_partner_set_svdm_version);
1081 
1082 /**
1083  * typec_partner_usb_power_delivery_register - Register Type-C partner USB Power Delivery Support
1084  * @partner: Type-C partner device.
1085  * @desc: Description of the USB PD contract.
1086  *
1087  * This routine is a wrapper around usb_power_delivery_register(). It registers
1088  * USB Power Delivery Capabilities for a Type-C partner device. Specifically,
1089  * it sets the Type-C partner device as a parent for the resulting USB Power Delivery object.
1090  *
1091  * Returns handle to struct usb_power_delivery or ERR_PTR.
1092  */
1093 struct usb_power_delivery *
typec_partner_usb_power_delivery_register(struct typec_partner * partner,struct usb_power_delivery_desc * desc)1094 typec_partner_usb_power_delivery_register(struct typec_partner *partner,
1095 					  struct usb_power_delivery_desc *desc)
1096 {
1097 	return usb_power_delivery_register(&partner->dev, desc);
1098 }
1099 EXPORT_SYMBOL_GPL(typec_partner_usb_power_delivery_register);
1100 
1101 /**
1102  * typec_register_partner - Register a USB Type-C Partner
1103  * @port: The USB Type-C Port the partner is connected to
1104  * @desc: Description of the partner
1105  *
1106  * Registers a device for USB Type-C Partner described in @desc.
1107  *
1108  * Returns handle to the partner on success or ERR_PTR on failure.
1109  */
typec_register_partner(struct typec_port * port,struct typec_partner_desc * desc)1110 struct typec_partner *typec_register_partner(struct typec_port *port,
1111 					     struct typec_partner_desc *desc)
1112 {
1113 	struct typec_partner *partner;
1114 	int ret;
1115 
1116 	partner = kzalloc_obj(*partner);
1117 	if (!partner)
1118 		return ERR_PTR(-ENOMEM);
1119 
1120 	ida_init(&partner->mode_ids);
1121 	partner->usb_pd = desc->usb_pd;
1122 	partner->accessory = desc->accessory;
1123 	partner->num_altmodes = -1;
1124 	partner->usb_capability = desc->usb_capability;
1125 	partner->pd_revision = desc->pd_revision;
1126 	partner->svdm_version = port->cap->svdm_version;
1127 	partner->attach = desc->attach;
1128 	partner->deattach = desc->deattach;
1129 
1130 	if (desc->identity) {
1131 		/*
1132 		 * Creating directory for the identity only if the driver is
1133 		 * able to provide data to it.
1134 		 */
1135 		partner->dev.groups = usb_pd_id_groups;
1136 		partner->identity = desc->identity;
1137 	}
1138 
1139 	partner->dev.class = &typec_class;
1140 	partner->dev.parent = &port->dev;
1141 	partner->dev.type = &typec_partner_dev_type;
1142 	dev_set_name(&partner->dev, "%s-partner", dev_name(&port->dev));
1143 
1144 	if (port->usb2_dev) {
1145 		partner->usb_capability |= USB_CAPABILITY_USB2;
1146 		partner->usb_mode = USB_MODE_USB2;
1147 	}
1148 	if (port->usb3_dev) {
1149 		partner->usb_capability |= USB_CAPABILITY_USB2 | USB_CAPABILITY_USB3;
1150 		partner->usb_mode = USB_MODE_USB3;
1151 	}
1152 
1153 	mutex_lock(&port->partner_link_lock);
1154 	ret = device_register(&partner->dev);
1155 	if (ret) {
1156 		dev_err(&port->dev, "failed to register partner (%d)\n", ret);
1157 		mutex_unlock(&port->partner_link_lock);
1158 		put_device(&partner->dev);
1159 		return ERR_PTR(ret);
1160 	}
1161 
1162 	if (port->usb2_dev)
1163 		typec_partner_link_device(partner, port->usb2_dev);
1164 	if (port->usb3_dev)
1165 		typec_partner_link_device(partner, port->usb3_dev);
1166 	mutex_unlock(&port->partner_link_lock);
1167 
1168 	return partner;
1169 }
1170 EXPORT_SYMBOL_GPL(typec_register_partner);
1171 
1172 /**
1173  * typec_unregister_partner - Unregister a USB Type-C Partner
1174  * @partner: The partner to be unregistered
1175  *
1176  * Unregister device created with typec_register_partner().
1177  */
typec_unregister_partner(struct typec_partner * partner)1178 void typec_unregister_partner(struct typec_partner *partner)
1179 {
1180 	struct typec_port *port;
1181 
1182 	if (IS_ERR_OR_NULL(partner))
1183 		return;
1184 
1185 	port = to_typec_port(partner->dev.parent);
1186 
1187 	mutex_lock(&port->partner_link_lock);
1188 	if (port->usb2_dev) {
1189 		typec_partner_unlink_device(partner, port->usb2_dev);
1190 		port->usb2_dev = NULL;
1191 	}
1192 	if (port->usb3_dev) {
1193 		typec_partner_unlink_device(partner, port->usb3_dev);
1194 		port->usb3_dev = NULL;
1195 	}
1196 
1197 	device_unregister(&partner->dev);
1198 	mutex_unlock(&port->partner_link_lock);
1199 }
1200 EXPORT_SYMBOL_GPL(typec_unregister_partner);
1201 
1202 /* ------------------------------------------------------------------------- */
1203 /* Type-C Cable Plugs */
1204 
typec_plug_release(struct device * dev)1205 static void typec_plug_release(struct device *dev)
1206 {
1207 	struct typec_plug *plug = to_typec_plug(dev);
1208 
1209 	ida_destroy(&plug->mode_ids);
1210 	kfree(plug);
1211 }
1212 
1213 static struct attribute *typec_plug_attrs[] = {
1214 	&dev_attr_number_of_alternate_modes.attr,
1215 	NULL
1216 };
1217 
typec_plug_attr_is_visible(struct kobject * kobj,struct attribute * attr,int n)1218 static umode_t typec_plug_attr_is_visible(struct kobject *kobj, struct attribute *attr, int n)
1219 {
1220 	struct typec_plug *plug = to_typec_plug(kobj_to_dev(kobj));
1221 
1222 	if (attr == &dev_attr_number_of_alternate_modes.attr) {
1223 		if (plug->num_altmodes < 0)
1224 			return 0;
1225 	}
1226 
1227 	return attr->mode;
1228 }
1229 
1230 static const struct attribute_group typec_plug_group = {
1231 	.is_visible = typec_plug_attr_is_visible,
1232 	.attrs = typec_plug_attrs
1233 };
1234 
1235 static const struct attribute_group *typec_plug_groups[] = {
1236 	&typec_plug_group,
1237 	NULL
1238 };
1239 
1240 const struct device_type typec_plug_dev_type = {
1241 	.name = "typec_plug",
1242 	.groups = typec_plug_groups,
1243 	.release = typec_plug_release,
1244 };
1245 
1246 /**
1247  * typec_plug_set_num_altmodes - Set the number of available plug altmodes
1248  * @plug: The plug to be updated.
1249  * @num_altmodes: The number of altmodes we want to specify as available.
1250  *
1251  * This routine is used to report the number of alternate modes supported by the
1252  * plug. This value is *not* enforced in alternate mode registration routines.
1253  *
1254  * @plug.num_altmodes is set to -1 on plug registration, denoting that
1255  * a valid value has not been set for it yet.
1256  *
1257  * Returns 0 on success or negative error number on failure.
1258  */
typec_plug_set_num_altmodes(struct typec_plug * plug,int num_altmodes)1259 int typec_plug_set_num_altmodes(struct typec_plug *plug, int num_altmodes)
1260 {
1261 	int ret;
1262 
1263 	if (num_altmodes < 0)
1264 		return -EINVAL;
1265 
1266 	plug->num_altmodes = num_altmodes;
1267 	ret = sysfs_update_group(&plug->dev.kobj, &typec_plug_group);
1268 	if (ret < 0)
1269 		return ret;
1270 
1271 	sysfs_notify(&plug->dev.kobj, NULL, "number_of_alternate_modes");
1272 	kobject_uevent(&plug->dev.kobj, KOBJ_CHANGE);
1273 
1274 	return 0;
1275 }
1276 EXPORT_SYMBOL_GPL(typec_plug_set_num_altmodes);
1277 
1278 /**
1279  * typec_plug_register_altmode - Register USB Type-C Cable Plug Alternate Mode
1280  * @plug: USB Type-C Cable Plug that supports the alternate mode
1281  * @desc: Description of the alternate mode
1282  *
1283  * This routine is used to register each alternate mode individually that @plug
1284  * has listed in response to Discover SVIDs command. The modes for a SVID that
1285  * the plug lists in response to Discover Modes command need to be listed in an
1286  * array in @desc.
1287  *
1288  * Returns handle to the alternate mode on success or ERR_PTR on failure.
1289  */
1290 struct typec_altmode *
typec_plug_register_altmode(struct typec_plug * plug,const struct typec_altmode_desc * desc)1291 typec_plug_register_altmode(struct typec_plug *plug,
1292 			    const struct typec_altmode_desc *desc)
1293 {
1294 	return typec_register_altmode(&plug->dev, desc, &typec_plug_altmode_dev_type);
1295 }
1296 EXPORT_SYMBOL_GPL(typec_plug_register_altmode);
1297 
1298 /**
1299  * typec_register_plug - Register a USB Type-C Cable Plug
1300  * @cable: USB Type-C Cable with the plug
1301  * @desc: Description of the cable plug
1302  *
1303  * Registers a device for USB Type-C Cable Plug described in @desc. A USB Type-C
1304  * Cable Plug represents a plug with electronics in it that can response to USB
1305  * Power Delivery SOP Prime or SOP Double Prime packages.
1306  *
1307  * Returns handle to the cable plug on success or ERR_PTR on failure.
1308  */
typec_register_plug(struct typec_cable * cable,struct typec_plug_desc * desc)1309 struct typec_plug *typec_register_plug(struct typec_cable *cable,
1310 				       struct typec_plug_desc *desc)
1311 {
1312 	struct typec_plug *plug;
1313 	char name[8];
1314 	int ret;
1315 
1316 	plug = kzalloc_obj(*plug);
1317 	if (!plug)
1318 		return ERR_PTR(-ENOMEM);
1319 
1320 	sprintf(name, "plug%d", desc->index);
1321 
1322 	ida_init(&plug->mode_ids);
1323 	plug->num_altmodes = -1;
1324 	plug->index = desc->index;
1325 	plug->dev.class = &typec_class;
1326 	plug->dev.parent = &cable->dev;
1327 	plug->dev.type = &typec_plug_dev_type;
1328 	dev_set_name(&plug->dev, "%s-%s", dev_name(cable->dev.parent), name);
1329 
1330 	ret = device_register(&plug->dev);
1331 	if (ret) {
1332 		dev_err(&cable->dev, "failed to register plug (%d)\n", ret);
1333 		put_device(&plug->dev);
1334 		return ERR_PTR(ret);
1335 	}
1336 
1337 	return plug;
1338 }
1339 EXPORT_SYMBOL_GPL(typec_register_plug);
1340 
1341 /**
1342  * typec_unregister_plug - Unregister a USB Type-C Cable Plug
1343  * @plug: The cable plug to be unregistered
1344  *
1345  * Unregister device created with typec_register_plug().
1346  */
typec_unregister_plug(struct typec_plug * plug)1347 void typec_unregister_plug(struct typec_plug *plug)
1348 {
1349 	if (!IS_ERR_OR_NULL(plug))
1350 		device_unregister(&plug->dev);
1351 }
1352 EXPORT_SYMBOL_GPL(typec_unregister_plug);
1353 
1354 /* Type-C Cables */
1355 
1356 static const char * const typec_plug_types[] = {
1357 	[USB_PLUG_NONE]		= "unknown",
1358 	[USB_PLUG_TYPE_A]	= "type-a",
1359 	[USB_PLUG_TYPE_B]	= "type-b",
1360 	[USB_PLUG_TYPE_C]	= "type-c",
1361 	[USB_PLUG_CAPTIVE]	= "captive",
1362 };
1363 
plug_type_show(struct device * dev,struct device_attribute * attr,char * buf)1364 static ssize_t plug_type_show(struct device *dev,
1365 			      struct device_attribute *attr, char *buf)
1366 {
1367 	struct typec_cable *cable = to_typec_cable(dev);
1368 
1369 	return sprintf(buf, "%s\n", typec_plug_types[cable->type]);
1370 }
1371 static DEVICE_ATTR_RO(plug_type);
1372 
1373 static struct attribute *typec_cable_attrs[] = {
1374 	&dev_attr_type.attr,
1375 	&dev_attr_plug_type.attr,
1376 	&dev_attr_usb_power_delivery_revision.attr,
1377 	NULL
1378 };
1379 ATTRIBUTE_GROUPS(typec_cable);
1380 
typec_cable_release(struct device * dev)1381 static void typec_cable_release(struct device *dev)
1382 {
1383 	struct typec_cable *cable = to_typec_cable(dev);
1384 
1385 	kfree(cable);
1386 }
1387 
1388 const struct device_type typec_cable_dev_type = {
1389 	.name = "typec_cable",
1390 	.groups = typec_cable_groups,
1391 	.release = typec_cable_release,
1392 };
1393 
1394 /**
1395  * typec_cable_get - Get a reference to the USB Type-C cable
1396  * @port: The USB Type-C Port the cable is connected to
1397  *
1398  * The caller must decrement the reference count with typec_cable_put() after
1399  * use.
1400  */
typec_cable_get(struct typec_port * port)1401 struct typec_cable *typec_cable_get(struct typec_port *port)
1402 {
1403 	struct device *dev;
1404 
1405 	dev = device_find_child(&port->dev, &typec_cable_dev_type,
1406 				device_match_type);
1407 	if (!dev)
1408 		return NULL;
1409 
1410 	return to_typec_cable(dev);
1411 }
1412 EXPORT_SYMBOL_GPL(typec_cable_get);
1413 
1414 /**
1415  * typec_cable_put - Decrement the reference count on USB Type-C cable
1416  * @cable: The USB Type-C cable
1417  */
typec_cable_put(struct typec_cable * cable)1418 void typec_cable_put(struct typec_cable *cable)
1419 {
1420 	put_device(&cable->dev);
1421 }
1422 EXPORT_SYMBOL_GPL(typec_cable_put);
1423 
1424 /**
1425  * typec_cable_is_active - Check is the USB Type-C cable active or passive
1426  * @cable: The USB Type-C Cable
1427  *
1428  * Return 1 if the cable is active or 0 if it's passive.
1429  */
typec_cable_is_active(struct typec_cable * cable)1430 int typec_cable_is_active(struct typec_cable *cable)
1431 {
1432 	return cable->active;
1433 }
1434 EXPORT_SYMBOL_GPL(typec_cable_is_active);
1435 
1436 /**
1437  * typec_cable_set_identity - Report result from Discover Identity command
1438  * @cable: The cable updated identity values
1439  *
1440  * This routine is used to report that the result of Discover Identity USB power
1441  * delivery command has become available.
1442  */
typec_cable_set_identity(struct typec_cable * cable)1443 int typec_cable_set_identity(struct typec_cable *cable)
1444 {
1445 	if (!cable->identity)
1446 		return -EINVAL;
1447 
1448 	typec_report_identity(&cable->dev);
1449 	return 0;
1450 }
1451 EXPORT_SYMBOL_GPL(typec_cable_set_identity);
1452 
1453 /**
1454  * typec_register_cable - Register a USB Type-C Cable
1455  * @port: The USB Type-C Port the cable is connected to
1456  * @desc: Description of the cable
1457  *
1458  * Registers a device for USB Type-C Cable described in @desc. The cable will be
1459  * parent for the optional cable plug devises.
1460  *
1461  * Returns handle to the cable on success or ERR_PTR on failure.
1462  */
typec_register_cable(struct typec_port * port,struct typec_cable_desc * desc)1463 struct typec_cable *typec_register_cable(struct typec_port *port,
1464 					 struct typec_cable_desc *desc)
1465 {
1466 	struct typec_cable *cable;
1467 	int ret;
1468 
1469 	cable = kzalloc_obj(*cable);
1470 	if (!cable)
1471 		return ERR_PTR(-ENOMEM);
1472 
1473 	cable->type = desc->type;
1474 	cable->active = desc->active;
1475 	cable->pd_revision = desc->pd_revision;
1476 
1477 	if (desc->identity) {
1478 		/*
1479 		 * Creating directory for the identity only if the driver is
1480 		 * able to provide data to it.
1481 		 */
1482 		cable->dev.groups = usb_pd_id_groups;
1483 		cable->identity = desc->identity;
1484 	}
1485 
1486 	cable->dev.class = &typec_class;
1487 	cable->dev.parent = &port->dev;
1488 	cable->dev.type = &typec_cable_dev_type;
1489 	dev_set_name(&cable->dev, "%s-cable", dev_name(&port->dev));
1490 
1491 	ret = device_register(&cable->dev);
1492 	if (ret) {
1493 		dev_err(&port->dev, "failed to register cable (%d)\n", ret);
1494 		put_device(&cable->dev);
1495 		return ERR_PTR(ret);
1496 	}
1497 
1498 	return cable;
1499 }
1500 EXPORT_SYMBOL_GPL(typec_register_cable);
1501 
1502 /**
1503  * typec_unregister_cable - Unregister a USB Type-C Cable
1504  * @cable: The cable to be unregistered
1505  *
1506  * Unregister device created with typec_register_cable().
1507  */
typec_unregister_cable(struct typec_cable * cable)1508 void typec_unregister_cable(struct typec_cable *cable)
1509 {
1510 	if (!IS_ERR_OR_NULL(cable))
1511 		device_unregister(&cable->dev);
1512 }
1513 EXPORT_SYMBOL_GPL(typec_unregister_cable);
1514 
1515 /* ------------------------------------------------------------------------- */
1516 /* USB Type-C ports */
1517 
1518 /**
1519  * typec_port_set_usb_mode - Set the operational USB mode for the port
1520  * @port: USB Type-C port
1521  * @mode: USB Mode (USB2, USB3 or USB4)
1522  *
1523  * @mode will be used with the next Enter_USB message. Existing connections are
1524  * not affected.
1525  */
typec_port_set_usb_mode(struct typec_port * port,enum usb_mode mode)1526 void typec_port_set_usb_mode(struct typec_port *port, enum usb_mode mode)
1527 {
1528 	port->usb_mode = mode;
1529 }
1530 EXPORT_SYMBOL_GPL(typec_port_set_usb_mode);
1531 
1532 static ssize_t
usb_capability_show(struct device * dev,struct device_attribute * attr,char * buf)1533 usb_capability_show(struct device *dev, struct device_attribute *attr, char *buf)
1534 {
1535 	struct typec_port *port = to_typec_port(dev);
1536 	int len = 0;
1537 	int i;
1538 
1539 	for (i = USB_MODE_USB2; i < USB_MODE_USB4 + 1; i++) {
1540 		if (!(BIT(i - 1) & port->cap->usb_capability))
1541 			continue;
1542 
1543 		if (i == port->usb_mode)
1544 			len += sysfs_emit_at(buf, len, "[%s] ", usb_modes[i]);
1545 		else
1546 			len += sysfs_emit_at(buf, len, "%s ", usb_modes[i]);
1547 	}
1548 
1549 	sysfs_emit_at(buf, len - 1, "\n");
1550 
1551 	return len;
1552 }
1553 
1554 static ssize_t
usb_capability_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)1555 usb_capability_store(struct device *dev, struct device_attribute *attr,
1556 		     const char *buf, size_t size)
1557 {
1558 	struct typec_port *port = to_typec_port(dev);
1559 	int ret = 0;
1560 	int mode;
1561 
1562 	if (!port->ops || !port->ops->default_usb_mode_set)
1563 		return -EOPNOTSUPP;
1564 
1565 	mode = sysfs_match_string(usb_modes, buf);
1566 	if (mode < 0)
1567 		return mode;
1568 
1569 	ret = port->ops->default_usb_mode_set(port, mode);
1570 	if (ret)
1571 		return ret;
1572 
1573 	port->usb_mode = mode;
1574 
1575 	return size;
1576 }
1577 static DEVICE_ATTR_RW(usb_capability);
1578 
1579 /**
1580  * typec_port_set_usb_power_delivery - Assign USB PD for port.
1581  * @port: USB Type-C port.
1582  * @pd: USB PD instance.
1583  *
1584  * This routine can be used to set the USB Power Delivery Capabilities for @port
1585  * that it will advertise to the partner.
1586  *
1587  * If @pd is NULL, the assignment is removed.
1588  */
typec_port_set_usb_power_delivery(struct typec_port * port,struct usb_power_delivery * pd)1589 int typec_port_set_usb_power_delivery(struct typec_port *port, struct usb_power_delivery *pd)
1590 {
1591 	int ret;
1592 
1593 	if (IS_ERR_OR_NULL(port) || port->pd == pd)
1594 		return 0;
1595 
1596 	if (pd) {
1597 		ret = usb_power_delivery_link_device(pd, &port->dev);
1598 		if (ret)
1599 			return ret;
1600 	} else {
1601 		usb_power_delivery_unlink_device(port->pd, &port->dev);
1602 	}
1603 
1604 	port->pd = pd;
1605 
1606 	return 0;
1607 }
1608 EXPORT_SYMBOL_GPL(typec_port_set_usb_power_delivery);
1609 
select_usb_power_delivery_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)1610 static ssize_t select_usb_power_delivery_store(struct device *dev,
1611 					       struct device_attribute *attr,
1612 					       const char *buf, size_t size)
1613 {
1614 	struct typec_port *port = to_typec_port(dev);
1615 	struct usb_power_delivery *pd;
1616 	int ret;
1617 
1618 	if (!port->ops || !port->ops->pd_set)
1619 		return -EOPNOTSUPP;
1620 
1621 	pd = usb_power_delivery_find(buf);
1622 	if (!pd)
1623 		return -EINVAL;
1624 
1625 	ret = port->ops->pd_set(port, pd);
1626 	if (ret)
1627 		return ret;
1628 
1629 	return size;
1630 }
1631 
select_usb_power_delivery_show(struct device * dev,struct device_attribute * attr,char * buf)1632 static ssize_t select_usb_power_delivery_show(struct device *dev,
1633 					      struct device_attribute *attr, char *buf)
1634 {
1635 	struct typec_port *port = to_typec_port(dev);
1636 	struct usb_power_delivery **pds;
1637 	int i, ret = 0;
1638 
1639 	if (!port->ops || !port->ops->pd_get)
1640 		return -EOPNOTSUPP;
1641 
1642 	pds = port->ops->pd_get(port);
1643 	if (!pds)
1644 		return 0;
1645 
1646 	for (i = 0; pds[i]; i++) {
1647 		if (pds[i] == port->pd)
1648 			ret += sysfs_emit_at(buf, ret, "[%s] ", dev_name(&pds[i]->dev));
1649 		else
1650 			ret += sysfs_emit_at(buf, ret, "%s ", dev_name(&pds[i]->dev));
1651 	}
1652 
1653 	buf[ret - 1] = '\n';
1654 
1655 	return ret;
1656 }
1657 static DEVICE_ATTR_RW(select_usb_power_delivery);
1658 
1659 static struct attribute *port_attrs[] = {
1660 	&dev_attr_select_usb_power_delivery.attr,
1661 	NULL
1662 };
1663 
port_attr_is_visible(struct kobject * kobj,struct attribute * attr,int n)1664 static umode_t port_attr_is_visible(struct kobject *kobj, struct attribute *attr, int n)
1665 {
1666 	struct typec_port *port = to_typec_port(kobj_to_dev(kobj));
1667 
1668 	if (!port->pd || !port->ops || !port->ops->pd_get)
1669 		return 0;
1670 	if (!port->ops->pd_set)
1671 		return 0444;
1672 
1673 	return attr->mode;
1674 }
1675 
1676 static const struct attribute_group pd_group = {
1677 	.is_visible = port_attr_is_visible,
1678 	.attrs = port_attrs,
1679 };
1680 
1681 static const char * const typec_orientations[] = {
1682 	[TYPEC_ORIENTATION_NONE]	= "unknown",
1683 	[TYPEC_ORIENTATION_NORMAL]	= "normal",
1684 	[TYPEC_ORIENTATION_REVERSE]	= "reverse",
1685 };
1686 
1687 static const char * const typec_roles[] = {
1688 	[TYPEC_SINK]	= "sink",
1689 	[TYPEC_SOURCE]	= "source",
1690 };
1691 
1692 static const char * const typec_data_roles[] = {
1693 	[TYPEC_DEVICE]	= "device",
1694 	[TYPEC_HOST]	= "host",
1695 };
1696 
1697 static const char * const typec_port_power_roles[] = {
1698 	[TYPEC_PORT_SRC] = "source",
1699 	[TYPEC_PORT_SNK] = "sink",
1700 	[TYPEC_PORT_DRP] = "dual",
1701 };
1702 
1703 static const char * const typec_port_data_roles[] = {
1704 	[TYPEC_PORT_DFP] = "host",
1705 	[TYPEC_PORT_UFP] = "device",
1706 	[TYPEC_PORT_DRD] = "dual",
1707 };
1708 
1709 static const char * const typec_port_types_drp[] = {
1710 	[TYPEC_PORT_SRC] = "dual [source] sink",
1711 	[TYPEC_PORT_SNK] = "dual source [sink]",
1712 	[TYPEC_PORT_DRP] = "[dual] source sink",
1713 };
1714 
1715 static ssize_t
preferred_role_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)1716 preferred_role_store(struct device *dev, struct device_attribute *attr,
1717 		     const char *buf, size_t size)
1718 {
1719 	struct typec_port *port = to_typec_port(dev);
1720 	int role;
1721 	int ret;
1722 
1723 	if (port->cap->type != TYPEC_PORT_DRP) {
1724 		dev_dbg(dev, "Preferred role only supported with DRP ports\n");
1725 		return -EOPNOTSUPP;
1726 	}
1727 
1728 	if (!port->ops || !port->ops->try_role) {
1729 		dev_dbg(dev, "Setting preferred role not supported\n");
1730 		return -EOPNOTSUPP;
1731 	}
1732 
1733 	role = sysfs_match_string(typec_roles, buf);
1734 	if (role < 0) {
1735 		if (sysfs_streq(buf, "none"))
1736 			role = TYPEC_NO_PREFERRED_ROLE;
1737 		else
1738 			return -EINVAL;
1739 	}
1740 
1741 	ret = port->ops->try_role(port, role);
1742 	if (ret)
1743 		return ret;
1744 
1745 	port->prefer_role = role;
1746 	return size;
1747 }
1748 
1749 static ssize_t
preferred_role_show(struct device * dev,struct device_attribute * attr,char * buf)1750 preferred_role_show(struct device *dev, struct device_attribute *attr,
1751 		    char *buf)
1752 {
1753 	struct typec_port *port = to_typec_port(dev);
1754 
1755 	if (port->cap->type != TYPEC_PORT_DRP)
1756 		return 0;
1757 
1758 	if (port->prefer_role < 0)
1759 		return 0;
1760 
1761 	return sprintf(buf, "%s\n", typec_roles[port->prefer_role]);
1762 }
1763 static DEVICE_ATTR_RW(preferred_role);
1764 
data_role_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)1765 static ssize_t data_role_store(struct device *dev,
1766 			       struct device_attribute *attr,
1767 			       const char *buf, size_t size)
1768 {
1769 	struct typec_port *port = to_typec_port(dev);
1770 	int ret;
1771 
1772 	if (!port->ops || !port->ops->dr_set) {
1773 		dev_dbg(dev, "data role swapping not supported\n");
1774 		return -EOPNOTSUPP;
1775 	}
1776 
1777 	ret = sysfs_match_string(typec_data_roles, buf);
1778 	if (ret < 0)
1779 		return ret;
1780 
1781 	mutex_lock(&port->port_type_lock);
1782 	if (port->cap->data != TYPEC_PORT_DRD) {
1783 		ret = -EOPNOTSUPP;
1784 		goto unlock_and_ret;
1785 	}
1786 
1787 	ret = port->ops->dr_set(port, ret);
1788 	if (ret)
1789 		goto unlock_and_ret;
1790 
1791 	ret = size;
1792 unlock_and_ret:
1793 	mutex_unlock(&port->port_type_lock);
1794 	return ret;
1795 }
1796 
data_role_show(struct device * dev,struct device_attribute * attr,char * buf)1797 static ssize_t data_role_show(struct device *dev,
1798 			      struct device_attribute *attr, char *buf)
1799 {
1800 	struct typec_port *port = to_typec_port(dev);
1801 
1802 	if (port->cap->data == TYPEC_PORT_DRD)
1803 		return sprintf(buf, "%s\n", port->data_role == TYPEC_HOST ?
1804 			       "[host] device" : "host [device]");
1805 
1806 	return sprintf(buf, "[%s]\n", typec_data_roles[port->data_role]);
1807 }
1808 static DEVICE_ATTR_RW(data_role);
1809 
power_role_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)1810 static ssize_t power_role_store(struct device *dev,
1811 				struct device_attribute *attr,
1812 				const char *buf, size_t size)
1813 {
1814 	struct typec_port *port = to_typec_port(dev);
1815 	int ret;
1816 
1817 	if (!port->ops || !port->ops->pr_set) {
1818 		dev_dbg(dev, "power role swapping not supported\n");
1819 		return -EOPNOTSUPP;
1820 	}
1821 
1822 	if (port->pwr_opmode != TYPEC_PWR_MODE_PD) {
1823 		dev_dbg(dev, "partner unable to swap power role\n");
1824 		return -EIO;
1825 	}
1826 
1827 	ret = sysfs_match_string(typec_roles, buf);
1828 	if (ret < 0)
1829 		return ret;
1830 
1831 	mutex_lock(&port->port_type_lock);
1832 	if (port->port_type != TYPEC_PORT_DRP) {
1833 		dev_dbg(dev, "port type fixed at \"%s\"",
1834 			     typec_port_power_roles[port->port_type]);
1835 		ret = -EOPNOTSUPP;
1836 		goto unlock_and_ret;
1837 	}
1838 
1839 	ret = port->ops->pr_set(port, ret);
1840 	if (ret)
1841 		goto unlock_and_ret;
1842 
1843 	ret = size;
1844 unlock_and_ret:
1845 	mutex_unlock(&port->port_type_lock);
1846 	return ret;
1847 }
1848 
power_role_show(struct device * dev,struct device_attribute * attr,char * buf)1849 static ssize_t power_role_show(struct device *dev,
1850 			       struct device_attribute *attr, char *buf)
1851 {
1852 	struct typec_port *port = to_typec_port(dev);
1853 
1854 	if (port->cap->type == TYPEC_PORT_DRP)
1855 		return sprintf(buf, "%s\n", port->pwr_role == TYPEC_SOURCE ?
1856 			       "[source] sink" : "source [sink]");
1857 
1858 	return sprintf(buf, "[%s]\n", typec_roles[port->pwr_role]);
1859 }
1860 static DEVICE_ATTR_RW(power_role);
1861 
1862 static ssize_t
port_type_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)1863 port_type_store(struct device *dev, struct device_attribute *attr,
1864 			const char *buf, size_t size)
1865 {
1866 	struct typec_port *port = to_typec_port(dev);
1867 	int ret;
1868 	enum typec_port_type type;
1869 
1870 	if (port->cap->type != TYPEC_PORT_DRP ||
1871 	    !port->ops || !port->ops->port_type_set) {
1872 		dev_dbg(dev, "changing port type not supported\n");
1873 		return -EOPNOTSUPP;
1874 	}
1875 
1876 	ret = sysfs_match_string(typec_port_power_roles, buf);
1877 	if (ret < 0)
1878 		return ret;
1879 
1880 	type = ret;
1881 	mutex_lock(&port->port_type_lock);
1882 
1883 	if (port->port_type == type) {
1884 		ret = size;
1885 		goto unlock_and_ret;
1886 	}
1887 
1888 	ret = port->ops->port_type_set(port, type);
1889 	if (ret)
1890 		goto unlock_and_ret;
1891 
1892 	port->port_type = type;
1893 	ret = size;
1894 
1895 unlock_and_ret:
1896 	mutex_unlock(&port->port_type_lock);
1897 	return ret;
1898 }
1899 
1900 static ssize_t
port_type_show(struct device * dev,struct device_attribute * attr,char * buf)1901 port_type_show(struct device *dev, struct device_attribute *attr,
1902 		char *buf)
1903 {
1904 	struct typec_port *port = to_typec_port(dev);
1905 
1906 	if (port->cap->type == TYPEC_PORT_DRP)
1907 		return sprintf(buf, "%s\n",
1908 			       typec_port_types_drp[port->port_type]);
1909 
1910 	return sprintf(buf, "[%s]\n", typec_port_power_roles[port->cap->type]);
1911 }
1912 static DEVICE_ATTR_RW(port_type);
1913 
1914 static const char * const typec_pwr_opmodes[] = {
1915 	[TYPEC_PWR_MODE_USB]	= "default",
1916 	[TYPEC_PWR_MODE_1_5A]	= "1.5A",
1917 	[TYPEC_PWR_MODE_3_0A]	= "3.0A",
1918 	[TYPEC_PWR_MODE_PD]	= "usb_power_delivery",
1919 };
1920 
power_operation_mode_show(struct device * dev,struct device_attribute * attr,char * buf)1921 static ssize_t power_operation_mode_show(struct device *dev,
1922 					 struct device_attribute *attr,
1923 					 char *buf)
1924 {
1925 	struct typec_port *port = to_typec_port(dev);
1926 
1927 	return sprintf(buf, "%s\n", typec_pwr_opmodes[port->pwr_opmode]);
1928 }
1929 static DEVICE_ATTR_RO(power_operation_mode);
1930 
vconn_source_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)1931 static ssize_t vconn_source_store(struct device *dev,
1932 				  struct device_attribute *attr,
1933 				  const char *buf, size_t size)
1934 {
1935 	struct typec_port *port = to_typec_port(dev);
1936 	bool source;
1937 	int ret;
1938 
1939 	if (!port->cap->pd_revision) {
1940 		dev_dbg(dev, "VCONN swap depends on USB Power Delivery\n");
1941 		return -EOPNOTSUPP;
1942 	}
1943 
1944 	if (!port->ops || !port->ops->vconn_set) {
1945 		dev_dbg(dev, "VCONN swapping not supported\n");
1946 		return -EOPNOTSUPP;
1947 	}
1948 
1949 	ret = kstrtobool(buf, &source);
1950 	if (ret)
1951 		return ret;
1952 
1953 	ret = port->ops->vconn_set(port, (enum typec_role)source);
1954 	if (ret)
1955 		return ret;
1956 
1957 	return size;
1958 }
1959 
vconn_source_show(struct device * dev,struct device_attribute * attr,char * buf)1960 static ssize_t vconn_source_show(struct device *dev,
1961 				 struct device_attribute *attr, char *buf)
1962 {
1963 	struct typec_port *port = to_typec_port(dev);
1964 
1965 	return sprintf(buf, "%s\n",
1966 		       str_yes_no(port->vconn_role == TYPEC_SOURCE));
1967 }
1968 static DEVICE_ATTR_RW(vconn_source);
1969 
supported_accessory_modes_show(struct device * dev,struct device_attribute * attr,char * buf)1970 static ssize_t supported_accessory_modes_show(struct device *dev,
1971 					      struct device_attribute *attr,
1972 					      char *buf)
1973 {
1974 	struct typec_port *port = to_typec_port(dev);
1975 	ssize_t ret = 0;
1976 	int i;
1977 
1978 	for (i = 0; i < ARRAY_SIZE(port->cap->accessory); i++) {
1979 		if (port->cap->accessory[i])
1980 			ret += sprintf(buf + ret, "%s ",
1981 			       typec_accessory_modes[port->cap->accessory[i]]);
1982 	}
1983 
1984 	if (!ret)
1985 		return sprintf(buf, "none\n");
1986 
1987 	buf[ret - 1] = '\n';
1988 
1989 	return ret;
1990 }
1991 static DEVICE_ATTR_RO(supported_accessory_modes);
1992 
usb_typec_revision_show(struct device * dev,struct device_attribute * attr,char * buf)1993 static ssize_t usb_typec_revision_show(struct device *dev,
1994 				       struct device_attribute *attr,
1995 				       char *buf)
1996 {
1997 	struct typec_port *port = to_typec_port(dev);
1998 	u16 rev = port->cap->revision;
1999 
2000 	return sprintf(buf, "%d.%d\n", (rev >> 8) & 0xff, (rev >> 4) & 0xf);
2001 }
2002 static DEVICE_ATTR_RO(usb_typec_revision);
2003 
usb_power_delivery_revision_show(struct device * dev,struct device_attribute * attr,char * buf)2004 static ssize_t usb_power_delivery_revision_show(struct device *dev,
2005 						struct device_attribute *attr,
2006 						char *buf)
2007 {
2008 	u16 rev = 0;
2009 
2010 	if (is_typec_partner(dev)) {
2011 		struct typec_partner *partner = to_typec_partner(dev);
2012 
2013 		rev = partner->pd_revision;
2014 	} else if (is_typec_cable(dev)) {
2015 		struct typec_cable *cable = to_typec_cable(dev);
2016 
2017 		rev = cable->pd_revision;
2018 	} else if (is_typec_port(dev)) {
2019 		struct typec_port *p = to_typec_port(dev);
2020 
2021 		rev = p->cap->pd_revision;
2022 	}
2023 	return sysfs_emit(buf, "%d.%d\n", (rev >> 8) & 0xff, (rev >> 4) & 0xf);
2024 }
2025 
orientation_show(struct device * dev,struct device_attribute * attr,char * buf)2026 static ssize_t orientation_show(struct device *dev,
2027 				   struct device_attribute *attr,
2028 				   char *buf)
2029 {
2030 	struct typec_port *port = to_typec_port(dev);
2031 
2032 	return sprintf(buf, "%s\n", typec_orientations[port->orientation]);
2033 }
2034 static DEVICE_ATTR_RO(orientation);
2035 
2036 static struct attribute *typec_attrs[] = {
2037 	&dev_attr_data_role.attr,
2038 	&dev_attr_power_operation_mode.attr,
2039 	&dev_attr_power_role.attr,
2040 	&dev_attr_preferred_role.attr,
2041 	&dev_attr_supported_accessory_modes.attr,
2042 	&dev_attr_usb_power_delivery_revision.attr,
2043 	&dev_attr_usb_typec_revision.attr,
2044 	&dev_attr_vconn_source.attr,
2045 	&dev_attr_port_type.attr,
2046 	&dev_attr_orientation.attr,
2047 	&dev_attr_usb_capability.attr,
2048 	NULL,
2049 };
2050 
typec_attr_is_visible(struct kobject * kobj,struct attribute * attr,int n)2051 static umode_t typec_attr_is_visible(struct kobject *kobj,
2052 				     struct attribute *attr, int n)
2053 {
2054 	struct typec_port *port = to_typec_port(kobj_to_dev(kobj));
2055 
2056 	if (attr == &dev_attr_data_role.attr) {
2057 		if (port->cap->data != TYPEC_PORT_DRD ||
2058 		    !port->ops || !port->ops->dr_set)
2059 			return 0444;
2060 	} else if (attr == &dev_attr_power_role.attr) {
2061 		if (port->cap->type != TYPEC_PORT_DRP ||
2062 		    !port->ops || !port->ops->pr_set)
2063 			return 0444;
2064 	} else if (attr == &dev_attr_vconn_source.attr) {
2065 		if (!port->cap->pd_revision ||
2066 		    !port->ops || !port->ops->vconn_set)
2067 			return 0444;
2068 	} else if (attr == &dev_attr_preferred_role.attr) {
2069 		if (port->cap->type != TYPEC_PORT_DRP ||
2070 		    !port->ops || !port->ops->try_role)
2071 			return 0444;
2072 	} else if (attr == &dev_attr_port_type.attr) {
2073 		if (!port->ops || !port->ops->port_type_set)
2074 			return 0;
2075 		if (port->cap->type != TYPEC_PORT_DRP)
2076 			return 0444;
2077 	} else if (attr == &dev_attr_orientation.attr) {
2078 		if (port->cap->orientation_aware)
2079 			return 0444;
2080 		return 0;
2081 	} else if (attr == &dev_attr_usb_capability.attr) {
2082 		if (!port->cap->usb_capability)
2083 			return 0;
2084 		if (!port->ops || !port->ops->default_usb_mode_set)
2085 			return 0444;
2086 	}
2087 
2088 	return attr->mode;
2089 }
2090 
2091 static const struct attribute_group typec_group = {
2092 	.is_visible = typec_attr_is_visible,
2093 	.attrs = typec_attrs,
2094 };
2095 
2096 static const struct attribute_group *typec_groups[] = {
2097 	&typec_group,
2098 	&pd_group,
2099 	NULL
2100 };
2101 
typec_uevent(const struct device * dev,struct kobj_uevent_env * env)2102 static int typec_uevent(const struct device *dev, struct kobj_uevent_env *env)
2103 {
2104 	int ret;
2105 
2106 	ret = add_uevent_var(env, "TYPEC_PORT=%s", dev_name(dev));
2107 	if (ret)
2108 		dev_err(dev, "failed to add uevent TYPEC_PORT\n");
2109 
2110 	return ret;
2111 }
2112 
typec_release(struct device * dev)2113 static void typec_release(struct device *dev)
2114 {
2115 	struct typec_port *port = to_typec_port(dev);
2116 
2117 	ida_free(&typec_index_ida, port->id);
2118 	ida_destroy(&port->mode_ids);
2119 	typec_switch_put(port->sw);
2120 	typec_mux_put(port->mux);
2121 	typec_retimer_put(port->retimer);
2122 	kfree(port->cap);
2123 	kfree(port);
2124 }
2125 
2126 const struct device_type typec_port_dev_type = {
2127 	.name = "typec_port",
2128 	.groups = typec_groups,
2129 	.uevent = typec_uevent,
2130 	.release = typec_release,
2131 };
2132 
2133 /* --------------------------------------- */
2134 /* Driver callbacks to report role updates */
2135 
typec_get_partner(struct typec_port * port)2136 static struct typec_partner *typec_get_partner(struct typec_port *port)
2137 {
2138 	struct device *dev;
2139 
2140 	dev = device_find_child(&port->dev, &typec_partner_dev_type,
2141 				device_match_type);
2142 	if (!dev)
2143 		return NULL;
2144 
2145 	return to_typec_partner(dev);
2146 }
2147 
typec_partner_attach(struct typec_connector * con,struct device * dev)2148 static void typec_partner_attach(struct typec_connector *con, struct device *dev)
2149 {
2150 	struct typec_port *port = container_of(con, struct typec_port, con);
2151 	struct typec_partner *partner;
2152 	struct usb_device *udev = to_usb_device(dev);
2153 	enum usb_mode usb_mode;
2154 
2155 	mutex_lock(&port->partner_link_lock);
2156 	if (udev->speed < USB_SPEED_SUPER) {
2157 		usb_mode = USB_MODE_USB2;
2158 		port->usb2_dev = dev;
2159 	} else {
2160 		usb_mode = USB_MODE_USB3;
2161 		port->usb3_dev = dev;
2162 	}
2163 
2164 	partner = typec_get_partner(port);
2165 	if (partner) {
2166 		typec_partner_set_usb_mode(partner, usb_mode);
2167 		typec_partner_link_device(partner, dev);
2168 		put_device(&partner->dev);
2169 	}
2170 	mutex_unlock(&port->partner_link_lock);
2171 }
2172 
typec_partner_deattach(struct typec_connector * con,struct device * dev)2173 static void typec_partner_deattach(struct typec_connector *con, struct device *dev)
2174 {
2175 	struct typec_port *port = container_of(con, struct typec_port, con);
2176 	struct typec_partner *partner;
2177 
2178 	mutex_lock(&port->partner_link_lock);
2179 	partner = typec_get_partner(port);
2180 	if (partner) {
2181 		typec_partner_unlink_device(partner, dev);
2182 		put_device(&partner->dev);
2183 	}
2184 
2185 	if (port->usb2_dev == dev)
2186 		port->usb2_dev = NULL;
2187 	else if (port->usb3_dev == dev)
2188 		port->usb3_dev = NULL;
2189 	mutex_unlock(&port->partner_link_lock);
2190 }
2191 
2192 /**
2193  * typec_set_data_role - Report data role change
2194  * @port: The USB Type-C Port where the role was changed
2195  * @role: The new data role
2196  *
2197  * This routine is used by the port drivers to report data role changes.
2198  */
typec_set_data_role(struct typec_port * port,enum typec_data_role role)2199 void typec_set_data_role(struct typec_port *port, enum typec_data_role role)
2200 {
2201 	struct typec_partner *partner;
2202 
2203 	if (port->data_role == role)
2204 		return;
2205 
2206 	port->data_role = role;
2207 	sysfs_notify(&port->dev.kobj, NULL, "data_role");
2208 	kobject_uevent(&port->dev.kobj, KOBJ_CHANGE);
2209 
2210 	partner = typec_get_partner(port);
2211 	if (!partner)
2212 		return;
2213 
2214 	if (partner->identity)
2215 		typec_product_type_notify(&partner->dev);
2216 
2217 	put_device(&partner->dev);
2218 }
2219 EXPORT_SYMBOL_GPL(typec_set_data_role);
2220 
2221 /**
2222  * typec_get_data_role - Get port data role
2223  * @port: The USB Type-C Port to query
2224  *
2225  * This routine is used by the altmode drivers to determine if the port is the
2226  * DFP before issuing Enter Mode
2227  */
typec_get_data_role(struct typec_port * port)2228 enum typec_data_role typec_get_data_role(struct typec_port *port)
2229 {
2230 	return port->data_role;
2231 }
2232 EXPORT_SYMBOL_GPL(typec_get_data_role);
2233 
2234 /**
2235  * typec_set_pwr_role - Report power role change
2236  * @port: The USB Type-C Port where the role was changed
2237  * @role: The new data role
2238  *
2239  * This routine is used by the port drivers to report power role changes.
2240  */
typec_set_pwr_role(struct typec_port * port,enum typec_role role)2241 void typec_set_pwr_role(struct typec_port *port, enum typec_role role)
2242 {
2243 	if (port->pwr_role == role)
2244 		return;
2245 
2246 	port->pwr_role = role;
2247 	sysfs_notify(&port->dev.kobj, NULL, "power_role");
2248 	kobject_uevent(&port->dev.kobj, KOBJ_CHANGE);
2249 }
2250 EXPORT_SYMBOL_GPL(typec_set_pwr_role);
2251 
2252 /**
2253  * typec_set_vconn_role - Report VCONN source change
2254  * @port: The USB Type-C Port which VCONN role changed
2255  * @role: Source when @port is sourcing VCONN, or Sink when it's not
2256  *
2257  * This routine is used by the port drivers to report if the VCONN source is
2258  * changes.
2259  */
typec_set_vconn_role(struct typec_port * port,enum typec_role role)2260 void typec_set_vconn_role(struct typec_port *port, enum typec_role role)
2261 {
2262 	if (port->vconn_role == role)
2263 		return;
2264 
2265 	port->vconn_role = role;
2266 	sysfs_notify(&port->dev.kobj, NULL, "vconn_source");
2267 	kobject_uevent(&port->dev.kobj, KOBJ_CHANGE);
2268 }
2269 EXPORT_SYMBOL_GPL(typec_set_vconn_role);
2270 
2271 /**
2272  * typec_set_pwr_opmode - Report changed power operation mode
2273  * @port: The USB Type-C Port where the mode was changed
2274  * @opmode: New power operation mode
2275  *
2276  * This routine is used by the port drivers to report changed power operation
2277  * mode in @port. The modes are USB (default), 1.5A, 3.0A as defined in USB
2278  * Type-C specification, and "USB Power Delivery" when the power levels are
2279  * negotiated with methods defined in USB Power Delivery specification.
2280  */
typec_set_pwr_opmode(struct typec_port * port,enum typec_pwr_opmode opmode)2281 void typec_set_pwr_opmode(struct typec_port *port,
2282 			  enum typec_pwr_opmode opmode)
2283 {
2284 	struct device *partner_dev;
2285 
2286 	if (port->pwr_opmode == opmode)
2287 		return;
2288 
2289 	port->pwr_opmode = opmode;
2290 	sysfs_notify(&port->dev.kobj, NULL, "power_operation_mode");
2291 	kobject_uevent(&port->dev.kobj, KOBJ_CHANGE);
2292 
2293 	partner_dev = device_find_child(&port->dev,
2294 					&typec_partner_dev_type,
2295 					device_match_type);
2296 	if (partner_dev) {
2297 		struct typec_partner *partner = to_typec_partner(partner_dev);
2298 
2299 		if (opmode == TYPEC_PWR_MODE_PD && !partner->usb_pd) {
2300 			partner->usb_pd = 1;
2301 			sysfs_notify(&partner_dev->kobj, NULL,
2302 				     "supports_usb_power_delivery");
2303 			kobject_uevent(&partner_dev->kobj, KOBJ_CHANGE);
2304 		}
2305 		put_device(partner_dev);
2306 	}
2307 }
2308 EXPORT_SYMBOL_GPL(typec_set_pwr_opmode);
2309 
2310 /**
2311  * typec_find_pwr_opmode - Get the typec power operation mode capability
2312  * @name: power operation mode string
2313  *
2314  * This routine is used to find the typec_pwr_opmode by its string @name.
2315  *
2316  * Returns typec_pwr_opmode if success, otherwise negative error code.
2317  */
typec_find_pwr_opmode(const char * name)2318 int typec_find_pwr_opmode(const char *name)
2319 {
2320 	return match_string(typec_pwr_opmodes,
2321 			    ARRAY_SIZE(typec_pwr_opmodes), name);
2322 }
2323 EXPORT_SYMBOL_GPL(typec_find_pwr_opmode);
2324 
2325 /**
2326  * typec_find_orientation - Convert orientation string to enum typec_orientation
2327  * @name: Orientation string
2328  *
2329  * This routine is used to find the typec_orientation by its string name @name.
2330  *
2331  * Returns the orientation value on success, otherwise negative error code.
2332  */
typec_find_orientation(const char * name)2333 int typec_find_orientation(const char *name)
2334 {
2335 	return match_string(typec_orientations, ARRAY_SIZE(typec_orientations),
2336 			    name);
2337 }
2338 EXPORT_SYMBOL_GPL(typec_find_orientation);
2339 
2340 /**
2341  * typec_find_port_power_role - Get the typec port power capability
2342  * @name: port power capability string
2343  *
2344  * This routine is used to find the typec_port_type by its string name.
2345  *
2346  * Returns typec_port_type if success, otherwise negative error code.
2347  */
typec_find_port_power_role(const char * name)2348 int typec_find_port_power_role(const char *name)
2349 {
2350 	return match_string(typec_port_power_roles,
2351 			    ARRAY_SIZE(typec_port_power_roles), name);
2352 }
2353 EXPORT_SYMBOL_GPL(typec_find_port_power_role);
2354 
2355 /**
2356  * typec_find_power_role - Find the typec one specific power role
2357  * @name: power role string
2358  *
2359  * This routine is used to find the typec_role by its string name.
2360  *
2361  * Returns typec_role if success, otherwise negative error code.
2362  */
typec_find_power_role(const char * name)2363 int typec_find_power_role(const char *name)
2364 {
2365 	return match_string(typec_roles, ARRAY_SIZE(typec_roles), name);
2366 }
2367 EXPORT_SYMBOL_GPL(typec_find_power_role);
2368 
2369 /**
2370  * typec_find_port_data_role - Get the typec port data capability
2371  * @name: port data capability string
2372  *
2373  * This routine is used to find the typec_port_data by its string name.
2374  *
2375  * Returns typec_port_data if success, otherwise negative error code.
2376  */
typec_find_port_data_role(const char * name)2377 int typec_find_port_data_role(const char *name)
2378 {
2379 	return match_string(typec_port_data_roles,
2380 			    ARRAY_SIZE(typec_port_data_roles), name);
2381 }
2382 EXPORT_SYMBOL_GPL(typec_find_port_data_role);
2383 
2384 /* ------------------------------------------ */
2385 /* API for Multiplexer/DeMultiplexer Switches */
2386 
2387 /**
2388  * typec_set_orientation - Set USB Type-C cable plug orientation
2389  * @port: USB Type-C Port
2390  * @orientation: USB Type-C cable plug orientation
2391  *
2392  * Set cable plug orientation for @port.
2393  */
typec_set_orientation(struct typec_port * port,enum typec_orientation orientation)2394 int typec_set_orientation(struct typec_port *port,
2395 			  enum typec_orientation orientation)
2396 {
2397 	int ret;
2398 
2399 	ret = typec_switch_set(port->sw, orientation);
2400 	if (ret)
2401 		return ret;
2402 
2403 	port->orientation = orientation;
2404 	sysfs_notify(&port->dev.kobj, NULL, "orientation");
2405 	kobject_uevent(&port->dev.kobj, KOBJ_CHANGE);
2406 
2407 	return 0;
2408 }
2409 EXPORT_SYMBOL_GPL(typec_set_orientation);
2410 
2411 /**
2412  * typec_get_orientation - Get USB Type-C cable plug orientation
2413  * @port: USB Type-C Port
2414  *
2415  * Get current cable plug orientation for @port.
2416  */
typec_get_orientation(struct typec_port * port)2417 enum typec_orientation typec_get_orientation(struct typec_port *port)
2418 {
2419 	return port->orientation;
2420 }
2421 EXPORT_SYMBOL_GPL(typec_get_orientation);
2422 
2423 /**
2424  * typec_set_mode - Set mode of operation for USB Type-C connector
2425  * @port: USB Type-C connector
2426  * @mode: Accessory Mode, USB Operation or Safe State
2427  *
2428  * Configure @port for Accessory Mode @mode. This function will configure the
2429  * muxes needed for @mode.
2430  */
typec_set_mode(struct typec_port * port,int mode)2431 int typec_set_mode(struct typec_port *port, int mode)
2432 {
2433 	struct typec_mux_state state = { };
2434 
2435 	state.mode = mode;
2436 
2437 	return typec_mux_set(port->mux, &state);
2438 }
2439 EXPORT_SYMBOL_GPL(typec_set_mode);
2440 
2441 /* --------------------------------------- */
2442 
2443 /**
2444  * typec_get_negotiated_svdm_version - Get negotiated SVDM Version
2445  * @port: USB Type-C Port.
2446  *
2447  * Get the negotiated SVDM Version. The Version is set to the port default
2448  * value stored in typec_capability on partner registration, and updated after
2449  * a successful Discover Identity if the negotiated value is less than the
2450  * default value.
2451  *
2452  * Returns usb_pd_svdm_ver if the partner has been registered otherwise -ENODEV.
2453  */
typec_get_negotiated_svdm_version(struct typec_port * port)2454 int typec_get_negotiated_svdm_version(struct typec_port *port)
2455 {
2456 	enum usb_pd_svdm_ver svdm_version;
2457 	struct device *partner_dev;
2458 
2459 	partner_dev = device_find_child(&port->dev,
2460 					&typec_partner_dev_type,
2461 					device_match_type);
2462 	if (!partner_dev)
2463 		return -ENODEV;
2464 
2465 	svdm_version = to_typec_partner(partner_dev)->svdm_version;
2466 	put_device(partner_dev);
2467 
2468 	return svdm_version;
2469 }
2470 EXPORT_SYMBOL_GPL(typec_get_negotiated_svdm_version);
2471 
2472 /**
2473  * typec_get_cable_svdm_version - Get cable negotiated SVDM Version
2474  * @port: USB Type-C Port.
2475  *
2476  * Get the negotiated SVDM Version for the cable. The Version is set to the port
2477  * default value based on the PD Revision during cable registration, and updated
2478  * after a successful Discover Identity if the negotiated value is less than the
2479  * default.
2480  *
2481  * Returns usb_pd_svdm_ver if the cable has been registered otherwise -ENODEV.
2482  */
typec_get_cable_svdm_version(struct typec_port * port)2483 int typec_get_cable_svdm_version(struct typec_port *port)
2484 {
2485 	enum usb_pd_svdm_ver svdm_version;
2486 	struct device *cable_dev;
2487 
2488 	cable_dev = device_find_child(&port->dev, &typec_cable_dev_type,
2489 				      device_match_type);
2490 	if (!cable_dev)
2491 		return -ENODEV;
2492 
2493 	svdm_version = to_typec_cable(cable_dev)->svdm_version;
2494 	put_device(cable_dev);
2495 
2496 	return svdm_version;
2497 }
2498 EXPORT_SYMBOL_GPL(typec_get_cable_svdm_version);
2499 
2500 /**
2501  * typec_cable_set_svdm_version - Set negotiated Structured VDM (SVDM) Version
2502  * @cable: USB Type-C Active Cable that supports SVDM
2503  * @svdm_version: Negotiated SVDM Version
2504  *
2505  * This routine is used to save the negotiated SVDM Version.
2506  */
typec_cable_set_svdm_version(struct typec_cable * cable,enum usb_pd_svdm_ver svdm_version)2507 void typec_cable_set_svdm_version(struct typec_cable *cable, enum usb_pd_svdm_ver svdm_version)
2508 {
2509 	cable->svdm_version = svdm_version;
2510 }
2511 EXPORT_SYMBOL_GPL(typec_cable_set_svdm_version);
2512 
2513 /**
2514  * typec_get_drvdata - Return private driver data pointer
2515  * @port: USB Type-C port
2516  */
typec_get_drvdata(struct typec_port * port)2517 void *typec_get_drvdata(struct typec_port *port)
2518 {
2519 	return dev_get_drvdata(&port->dev);
2520 }
2521 EXPORT_SYMBOL_GPL(typec_get_drvdata);
2522 
typec_get_fw_cap(struct typec_capability * cap,struct fwnode_handle * fwnode)2523 int typec_get_fw_cap(struct typec_capability *cap,
2524 		     struct fwnode_handle *fwnode)
2525 {
2526 	const char *cap_str;
2527 	int ret;
2528 
2529 	cap->fwnode = fwnode;
2530 
2531 	ret = fwnode_property_read_string(fwnode, "power-role", &cap_str);
2532 	if (ret < 0)
2533 		return ret;
2534 
2535 	ret = typec_find_port_power_role(cap_str);
2536 	if (ret < 0)
2537 		return ret;
2538 	cap->type = ret;
2539 
2540 	/* USB data support is optional */
2541 	ret = fwnode_property_read_string(fwnode, "data-role", &cap_str);
2542 	if (ret == 0) {
2543 		ret = typec_find_port_data_role(cap_str);
2544 		if (ret < 0)
2545 			return ret;
2546 		cap->data = ret;
2547 	}
2548 
2549 	/* Get the preferred power role for a DRP */
2550 	if (cap->type == TYPEC_PORT_DRP) {
2551 		cap->prefer_role = TYPEC_NO_PREFERRED_ROLE;
2552 
2553 		ret = fwnode_property_read_string(fwnode, "try-power-role", &cap_str);
2554 		if (ret == 0) {
2555 			ret = typec_find_power_role(cap_str);
2556 			if (ret < 0)
2557 				return ret;
2558 			cap->prefer_role = ret;
2559 		}
2560 	}
2561 
2562 	return 0;
2563 }
2564 EXPORT_SYMBOL_GPL(typec_get_fw_cap);
2565 
2566 /**
2567  * typec_port_register_altmode - Register USB Type-C Port Alternate Mode
2568  * @port: USB Type-C Port that supports the alternate mode
2569  * @desc: Description of the alternate mode
2570  *
2571  * This routine is used to register an alternate mode that @port is capable of
2572  * supporting.
2573  *
2574  * Returns handle to the alternate mode on success or ERR_PTR on failure.
2575  */
2576 struct typec_altmode *
typec_port_register_altmode(struct typec_port * port,const struct typec_altmode_desc * desc)2577 typec_port_register_altmode(struct typec_port *port,
2578 			    const struct typec_altmode_desc *desc)
2579 {
2580 	struct typec_altmode *adev;
2581 	struct typec_mux *mux;
2582 	struct typec_retimer *retimer;
2583 	int ret;
2584 
2585 	mux = typec_mux_get(&port->dev);
2586 	if (IS_ERR(mux))
2587 		return ERR_CAST(mux);
2588 
2589 	retimer = typec_retimer_get(&port->dev);
2590 	if (IS_ERR(retimer)) {
2591 		typec_mux_put(mux);
2592 		return ERR_CAST(retimer);
2593 	}
2594 
2595 	adev = typec_register_altmode(&port->dev, desc, &typec_port_altmode_dev_type);
2596 	if (IS_ERR(adev)) {
2597 		typec_retimer_put(retimer);
2598 		typec_mux_put(mux);
2599 	} else {
2600 		to_altmode(adev)->mux = mux;
2601 		to_altmode(adev)->retimer = retimer;
2602 
2603 		ret = typec_mode_set_priority(adev, 0);
2604 		if (ret) {
2605 			typec_unregister_altmode(adev);
2606 			return ERR_PTR(ret);
2607 		}
2608 	}
2609 
2610 	return adev;
2611 }
2612 EXPORT_SYMBOL_GPL(typec_port_register_altmode);
2613 
typec_port_register_altmodes(struct typec_port * port,const struct typec_altmode_ops * ops,void * drvdata,struct typec_altmode ** altmodes,size_t n)2614 void typec_port_register_altmodes(struct typec_port *port,
2615 	const struct typec_altmode_ops *ops, void *drvdata,
2616 	struct typec_altmode **altmodes, size_t n)
2617 {
2618 	struct fwnode_handle *child;
2619 	struct typec_altmode_desc desc;
2620 	struct typec_altmode *alt;
2621 	size_t index = 0;
2622 	u16 svid;
2623 	u32 vdo;
2624 	int ret;
2625 
2626 	struct fwnode_handle *altmodes_node  __free(fwnode_handle) =
2627 		device_get_named_child_node(&port->dev, "altmodes");
2628 
2629 	if (!altmodes_node)
2630 		return; /* No altmodes specified */
2631 
2632 	fwnode_for_each_child_node(altmodes_node, child) {
2633 		ret = fwnode_property_read_u16(child, "svid", &svid);
2634 		if (ret) {
2635 			dev_err(&port->dev, "Error reading svid for altmode %s\n",
2636 				fwnode_get_name(child));
2637 			continue;
2638 		}
2639 
2640 		ret = fwnode_property_read_u32(child, "vdo", &vdo);
2641 		if (ret) {
2642 			dev_err(&port->dev, "Error reading vdo for altmode %s\n",
2643 				fwnode_get_name(child));
2644 			continue;
2645 		}
2646 
2647 		if (index >= n) {
2648 			dev_err(&port->dev, "Error not enough space for altmode %s\n",
2649 				fwnode_get_name(child));
2650 			continue;
2651 		}
2652 
2653 		desc.svid = svid;
2654 		desc.vdo = vdo;
2655 		desc.mode = index + 1;
2656 		alt = typec_port_register_altmode(port, &desc);
2657 		if (IS_ERR(alt)) {
2658 			dev_err(&port->dev, "Error registering altmode %s\n",
2659 				fwnode_get_name(child));
2660 			continue;
2661 		}
2662 
2663 		typec_altmode_set_ops(alt, ops);
2664 		typec_altmode_set_drvdata(alt, drvdata);
2665 		altmodes[index] = alt;
2666 		index++;
2667 	}
2668 }
2669 EXPORT_SYMBOL_GPL(typec_port_register_altmodes);
2670 
2671 /**
2672  * typec_port_register_cable_ops - Register typec_cable_ops to port altmodes
2673  * @altmodes: USB Type-C Port's altmode vector
2674  * @max_altmodes: The maximum number of alt modes supported by the port
2675  * @ops: Cable alternate mode vector
2676  */
typec_port_register_cable_ops(struct typec_altmode ** altmodes,int max_altmodes,const struct typec_cable_ops * ops)2677 void typec_port_register_cable_ops(struct typec_altmode **altmodes, int max_altmodes,
2678 				   const struct typec_cable_ops *ops)
2679 {
2680 	int i;
2681 
2682 	for (i = 0; i < max_altmodes; i++) {
2683 		if (!altmodes[i])
2684 			return;
2685 		altmodes[i]->cable_ops = ops;
2686 	}
2687 }
2688 EXPORT_SYMBOL_GPL(typec_port_register_cable_ops);
2689 
2690 /**
2691  * typec_register_port - Register a USB Type-C Port
2692  * @parent: Parent device
2693  * @cap: Description of the port
2694  *
2695  * Registers a device for USB Type-C Port described in @cap.
2696  *
2697  * Returns handle to the port on success or ERR_PTR on failure.
2698  */
typec_register_port(struct device * parent,const struct typec_capability * cap)2699 struct typec_port *typec_register_port(struct device *parent,
2700 				       const struct typec_capability *cap)
2701 {
2702 	struct typec_port *port;
2703 	int ret;
2704 	int id;
2705 
2706 	port = kzalloc_obj(*port);
2707 	if (!port)
2708 		return ERR_PTR(-ENOMEM);
2709 
2710 	id = ida_alloc(&typec_index_ida, GFP_KERNEL);
2711 	if (id < 0) {
2712 		kfree(port);
2713 		return ERR_PTR(id);
2714 	}
2715 
2716 	switch (cap->type) {
2717 	case TYPEC_PORT_SRC:
2718 		port->pwr_role = TYPEC_SOURCE;
2719 		port->vconn_role = TYPEC_SOURCE;
2720 		break;
2721 	case TYPEC_PORT_SNK:
2722 		port->pwr_role = TYPEC_SINK;
2723 		port->vconn_role = TYPEC_SINK;
2724 		break;
2725 	case TYPEC_PORT_DRP:
2726 		if (cap->prefer_role != TYPEC_NO_PREFERRED_ROLE)
2727 			port->pwr_role = cap->prefer_role;
2728 		else
2729 			port->pwr_role = TYPEC_SINK;
2730 		break;
2731 	}
2732 
2733 	switch (cap->data) {
2734 	case TYPEC_PORT_DFP:
2735 		port->data_role = TYPEC_HOST;
2736 		break;
2737 	case TYPEC_PORT_UFP:
2738 		port->data_role = TYPEC_DEVICE;
2739 		break;
2740 	case TYPEC_PORT_DRD:
2741 		if (cap->prefer_role == TYPEC_SOURCE)
2742 			port->data_role = TYPEC_HOST;
2743 		else
2744 			port->data_role = TYPEC_DEVICE;
2745 		break;
2746 	}
2747 
2748 	ida_init(&port->mode_ids);
2749 	mutex_init(&port->port_type_lock);
2750 	mutex_init(&port->partner_link_lock);
2751 
2752 	port->id = id;
2753 	port->ops = cap->ops;
2754 	port->port_type = cap->type;
2755 	port->prefer_role = cap->prefer_role;
2756 	port->con.attach = typec_partner_attach;
2757 	port->con.deattach = typec_partner_deattach;
2758 
2759 	if (cap->usb_capability & USB_CAPABILITY_USB4)
2760 		port->usb_mode = USB_MODE_USB4;
2761 	else if (cap->usb_capability & USB_CAPABILITY_USB3)
2762 		port->usb_mode = USB_MODE_USB3;
2763 	else if (cap->usb_capability & USB_CAPABILITY_USB2)
2764 		port->usb_mode = USB_MODE_USB2;
2765 
2766 	device_initialize(&port->dev);
2767 	port->dev.class = &typec_class;
2768 	port->dev.parent = parent;
2769 	port->dev.fwnode = cap->fwnode;
2770 	port->dev.type = &typec_port_dev_type;
2771 	dev_set_name(&port->dev, "port%d", id);
2772 	dev_set_drvdata(&port->dev, cap->driver_data);
2773 
2774 	port->cap = kmemdup(cap, sizeof(*cap), GFP_KERNEL);
2775 	if (!port->cap) {
2776 		put_device(&port->dev);
2777 		return ERR_PTR(-ENOMEM);
2778 	}
2779 
2780 	port->sw = typec_switch_get(&port->dev);
2781 	if (IS_ERR(port->sw)) {
2782 		ret = PTR_ERR(port->sw);
2783 		put_device(&port->dev);
2784 		return ERR_PTR(ret);
2785 	}
2786 
2787 	port->mux = typec_mux_get(&port->dev);
2788 	if (IS_ERR(port->mux)) {
2789 		ret = PTR_ERR(port->mux);
2790 		put_device(&port->dev);
2791 		return ERR_PTR(ret);
2792 	}
2793 
2794 	port->retimer = typec_retimer_get(&port->dev);
2795 	if (IS_ERR(port->retimer)) {
2796 		ret = PTR_ERR(port->retimer);
2797 		put_device(&port->dev);
2798 		return ERR_PTR(ret);
2799 	}
2800 
2801 	port->pd = cap->pd;
2802 	port->mode_control = !cap->no_mode_control;
2803 
2804 	ret = device_add(&port->dev);
2805 	if (ret) {
2806 		dev_err(parent, "failed to register port (%d)\n", ret);
2807 		put_device(&port->dev);
2808 		return ERR_PTR(ret);
2809 	}
2810 
2811 	ret = usb_power_delivery_link_device(port->pd, &port->dev);
2812 	if (ret) {
2813 		dev_err(&port->dev, "failed to link pd\n");
2814 		device_unregister(&port->dev);
2815 		return ERR_PTR(ret);
2816 	}
2817 
2818 	ret = typec_link_ports(port);
2819 	if (ret)
2820 		dev_warn(&port->dev, "failed to create symlinks (%d)\n", ret);
2821 
2822 	return port;
2823 }
2824 EXPORT_SYMBOL_GPL(typec_register_port);
2825 
2826 /**
2827  * typec_unregister_port - Unregister a USB Type-C Port
2828  * @port: The port to be unregistered
2829  *
2830  * Unregister device created with typec_register_port().
2831  */
typec_unregister_port(struct typec_port * port)2832 void typec_unregister_port(struct typec_port *port)
2833 {
2834 	if (!IS_ERR_OR_NULL(port)) {
2835 		typec_unlink_ports(port);
2836 		typec_port_set_usb_power_delivery(port, NULL);
2837 		device_unregister(&port->dev);
2838 	}
2839 }
2840 EXPORT_SYMBOL_GPL(typec_unregister_port);
2841 
typec_init(void)2842 static int __init typec_init(void)
2843 {
2844 	int ret;
2845 
2846 	ret = bus_register(&typec_bus);
2847 	if (ret)
2848 		return ret;
2849 
2850 	ret = class_register(&typec_mux_class);
2851 	if (ret)
2852 		goto err_unregister_bus;
2853 
2854 	ret = class_register(&retimer_class);
2855 	if (ret)
2856 		goto err_unregister_mux_class;
2857 
2858 	ret = class_register(&typec_class);
2859 	if (ret)
2860 		goto err_unregister_retimer_class;
2861 
2862 	ret = usb_power_delivery_init();
2863 	if (ret)
2864 		goto err_unregister_class;
2865 
2866 	return 0;
2867 
2868 err_unregister_class:
2869 	class_unregister(&typec_class);
2870 
2871 err_unregister_retimer_class:
2872 	class_unregister(&retimer_class);
2873 
2874 err_unregister_mux_class:
2875 	class_unregister(&typec_mux_class);
2876 
2877 err_unregister_bus:
2878 	bus_unregister(&typec_bus);
2879 
2880 	return ret;
2881 }
2882 subsys_initcall(typec_init);
2883 
typec_exit(void)2884 static void __exit typec_exit(void)
2885 {
2886 	usb_power_delivery_exit();
2887 	class_unregister(&typec_class);
2888 	ida_destroy(&typec_index_ida);
2889 	bus_unregister(&typec_bus);
2890 	class_unregister(&typec_mux_class);
2891 	class_unregister(&retimer_class);
2892 }
2893 module_exit(typec_exit);
2894 
2895 MODULE_AUTHOR("Heikki Krogerus <heikki.krogerus@linux.intel.com>");
2896 MODULE_LICENSE("GPL v2");
2897 MODULE_DESCRIPTION("USB Type-C Connector Class");
2898