1 /* SPDX-License-Identifier: GPL-2.0 */
3 * Thunderbolt driver - bus logic (NHI independent)
5 * Copyright (c) 2014 Andreas Noever <andreas.noever@gmail.com>
6 * Copyright (C) 2018, Intel Corporation
12 #include <linux/nvmem-provider.h>
13 #include <linux/pci.h>
14 #include <linux/thunderbolt.h>
15 #include <linux/uuid.h>
22 * struct tb_switch_nvm - Structure holding switch NVM information
23 * @major: Major version number of the active NVM portion
24 * @minor: Minor version number of the active NVM portion
25 * @id: Identifier used with both NVM portions
26 * @active: Active portion NVMem device
27 * @non_active: Non-active portion NVMem device
28 * @buf: Buffer where the NVM image is stored before it is written to
29 * the actual NVM flash device
30 * @buf_data_size: Number of bytes actually consumed by the new NVM
32 * @authenticating: The switch is authenticating the new NVM
34 struct tb_switch_nvm {
38 struct nvmem_device *active;
39 struct nvmem_device *non_active;
45 #define TB_SWITCH_KEY_SIZE 32
46 #define TB_SWITCH_MAX_DEPTH 6
47 #define USB4_SWITCH_MAX_DEPTH 5
50 * struct tb_switch - a thunderbolt switch
51 * @dev: Device for the switch
52 * @config: Switch configuration
53 * @ports: Ports in this switch
54 * @dma_port: If the switch has port supporting DMA configuration based
55 * mailbox this will hold the pointer to that (%NULL
56 * otherwise). If set it also means the switch has
58 * @tb: Pointer to the domain the switch belongs to
59 * @uid: Unique ID of the switch
60 * @uuid: UUID of the switch (or %NULL if not supported)
61 * @vendor: Vendor ID of the switch
62 * @device: Device ID of the switch
63 * @vendor_name: Name of the vendor (or %NULL if not known)
64 * @device_name: Name of the device (or %NULL if not known)
65 * @link_speed: Speed of the link in Gb/s
66 * @link_width: Width of the link (1 or 2)
67 * @generation: Switch Thunderbolt generation
68 * @cap_plug_events: Offset to the plug events capability (%0 if not found)
69 * @cap_lc: Offset to the link controller capability (%0 if not found)
70 * @is_unplugged: The switch is going away
71 * @drom: DROM of the switch (%NULL if not found)
72 * @nvm: Pointer to the NVM if the switch has one (%NULL otherwise)
73 * @no_nvm_upgrade: Prevent NVM upgrade of this switch
74 * @safe_mode: The switch is in safe-mode
75 * @boot: Whether the switch was already authorized on boot or not
76 * @rpm: The switch supports runtime PM
77 * @authorized: Whether the switch is authorized by user or policy
78 * @security_level: Switch supported security level
79 * @key: Contains the key used to challenge the device or %NULL if not
80 * supported. Size of the key is %TB_SWITCH_KEY_SIZE.
81 * @connection_id: Connection ID used with ICM messaging
82 * @connection_key: Connection key used with ICM messaging
83 * @link: Root switch link this switch is connected (ICM only)
84 * @depth: Depth in the chain this switch is connected (ICM only)
85 * @rpm_complete: Completion used to wait for runtime resume to
88 * When the switch is being added or removed to the domain (other
89 * switches) you need to have domain lock held.
93 struct tb_regs_switch_header config;
94 struct tb_port *ports;
95 struct tb_dma_port *dma_port;
101 const char *vendor_name;
102 const char *device_name;
103 unsigned int link_speed;
104 unsigned int link_width;
105 unsigned int generation;
110 struct tb_switch_nvm *nvm;
115 unsigned int authorized;
116 enum tb_security_level security_level;
122 struct completion rpm_complete;
126 * struct tb_port - a thunderbolt port, part of a tb_switch
127 * @config: Cached port configuration read from registers
128 * @sw: Switch the port belongs to
129 * @remote: Remote port (%NULL if not connected)
130 * @xdomain: Remote host (%NULL if not connected)
131 * @cap_phy: Offset, zero if not found
132 * @cap_adap: Offset of the adapter specific capability (%0 if not present)
133 * @cap_usb4: Offset to the USB4 port capability (%0 if not present)
134 * @port: Port number on switch
135 * @disabled: Disabled by eeprom
136 * @bonded: true if the port is bonded (two lanes combined as one)
137 * @dual_link_port: If the switch is connected using two ports, points
139 * @link_nr: Is this primary or secondary port on the dual_link.
140 * @in_hopids: Currently allocated input HopIDs
141 * @out_hopids: Currently allocated output HopIDs
142 * @list: Used to link ports to DP resources list
145 struct tb_regs_port_header config;
146 struct tb_switch *sw;
147 struct tb_port *remote;
148 struct tb_xdomain *xdomain;
155 struct tb_port *dual_link_port;
157 struct ida in_hopids;
158 struct ida out_hopids;
159 struct list_head list;
163 * struct tb_path_hop - routing information for a tb_path
164 * @in_port: Ingress port of a switch
165 * @out_port: Egress port of a switch where the packet is routed out
166 * (must be on the same switch than @in_port)
167 * @in_hop_index: HopID where the path configuration entry is placed in
168 * the path config space of @in_port.
169 * @in_counter_index: Used counter index (not used in the driver
170 * currently, %-1 to disable)
171 * @next_hop_index: HopID of the packet when it is routed out from @out_port
172 * @initial_credits: Number of initial flow control credits allocated for
175 * Hop configuration is always done on the IN port of a switch.
176 * in_port and out_port have to be on the same switch. Packets arriving on
177 * in_port with "hop" = in_hop_index will get routed to through out_port. The
178 * next hop to take (on out_port->remote) is determined by
179 * next_hop_index. When routing packet to another switch (out->remote is
180 * set) the @next_hop_index must match the @in_hop_index of that next
181 * hop to make routing possible.
183 * in_counter_index is the index of a counter (in TB_CFG_COUNTERS) on the in
187 struct tb_port *in_port;
188 struct tb_port *out_port;
190 int in_counter_index;
192 unsigned int initial_credits;
196 * enum tb_path_port - path options mask
197 * @TB_PATH_NONE: Do not activate on any hop on path
198 * @TB_PATH_SOURCE: Activate on the first hop (out of src)
199 * @TB_PATH_INTERNAL: Activate on the intermediate hops (not the first/last)
200 * @TB_PATH_DESTINATION: Activate on the last hop (into dst)
201 * @TB_PATH_ALL: Activate on all hops on the path
206 TB_PATH_INTERNAL = 2,
207 TB_PATH_DESTINATION = 4,
212 * struct tb_path - a unidirectional path between two ports
213 * @tb: Pointer to the domain structure
214 * @name: Name of the path (used for debugging)
215 * @nfc_credits: Number of non flow controlled credits allocated for the path
216 * @ingress_shared_buffer: Shared buffering used for ingress ports on the path
217 * @egress_shared_buffer: Shared buffering used for egress ports on the path
218 * @ingress_fc_enable: Flow control for ingress ports on the path
219 * @egress_fc_enable: Flow control for egress ports on the path
220 * @priority: Priority group if the path
221 * @weight: Weight of the path inside the priority group
222 * @drop_packages: Drop packages from queue tail or head
223 * @activated: Is the path active
224 * @clear_fc: Clear all flow control from the path config space entries
225 * when deactivating this path
227 * @path_length: How many hops the path uses
229 * A path consists of a number of hops (see &struct tb_path_hop). To
230 * establish a PCIe tunnel two paths have to be created between the two
237 enum tb_path_port ingress_shared_buffer;
238 enum tb_path_port egress_shared_buffer;
239 enum tb_path_port ingress_fc_enable;
240 enum tb_path_port egress_fc_enable;
242 unsigned int priority:3;
247 struct tb_path_hop *hops;
251 /* HopIDs 0-7 are reserved by the Thunderbolt protocol */
252 #define TB_PATH_MIN_HOPID 8
253 #define TB_PATH_MAX_HOPS 7
256 * struct tb_cm_ops - Connection manager specific operations vector
257 * @driver_ready: Called right after control channel is started. Used by
258 * ICM to send driver ready message to the firmware.
259 * @start: Starts the domain
260 * @stop: Stops the domain
261 * @suspend_noirq: Connection manager specific suspend_noirq
262 * @resume_noirq: Connection manager specific resume_noirq
263 * @suspend: Connection manager specific suspend
264 * @complete: Connection manager specific complete
265 * @runtime_suspend: Connection manager specific runtime_suspend
266 * @runtime_resume: Connection manager specific runtime_resume
267 * @runtime_suspend_switch: Runtime suspend a switch
268 * @runtime_resume_switch: Runtime resume a switch
269 * @handle_event: Handle thunderbolt event
270 * @get_boot_acl: Get boot ACL list
271 * @set_boot_acl: Set boot ACL list
272 * @approve_switch: Approve switch
273 * @add_switch_key: Add key to switch
274 * @challenge_switch_key: Challenge switch using key
275 * @disconnect_pcie_paths: Disconnects PCIe paths before NVM update
276 * @approve_xdomain_paths: Approve (establish) XDomain DMA paths
277 * @disconnect_xdomain_paths: Disconnect XDomain DMA paths
280 int (*driver_ready)(struct tb *tb);
281 int (*start)(struct tb *tb);
282 void (*stop)(struct tb *tb);
283 int (*suspend_noirq)(struct tb *tb);
284 int (*resume_noirq)(struct tb *tb);
285 int (*suspend)(struct tb *tb);
286 void (*complete)(struct tb *tb);
287 int (*runtime_suspend)(struct tb *tb);
288 int (*runtime_resume)(struct tb *tb);
289 int (*runtime_suspend_switch)(struct tb_switch *sw);
290 int (*runtime_resume_switch)(struct tb_switch *sw);
291 void (*handle_event)(struct tb *tb, enum tb_cfg_pkg_type,
292 const void *buf, size_t size);
293 int (*get_boot_acl)(struct tb *tb, uuid_t *uuids, size_t nuuids);
294 int (*set_boot_acl)(struct tb *tb, const uuid_t *uuids, size_t nuuids);
295 int (*approve_switch)(struct tb *tb, struct tb_switch *sw);
296 int (*add_switch_key)(struct tb *tb, struct tb_switch *sw);
297 int (*challenge_switch_key)(struct tb *tb, struct tb_switch *sw,
298 const u8 *challenge, u8 *response);
299 int (*disconnect_pcie_paths)(struct tb *tb);
300 int (*approve_xdomain_paths)(struct tb *tb, struct tb_xdomain *xd);
301 int (*disconnect_xdomain_paths)(struct tb *tb, struct tb_xdomain *xd);
304 static inline void *tb_priv(struct tb *tb)
306 return (void *)tb->privdata;
309 #define TB_AUTOSUSPEND_DELAY 15000 /* ms */
311 /* helper functions & macros */
314 * tb_upstream_port() - return the upstream port of a switch
316 * Every switch has an upstream port (for the root switch it is the NHI).
318 * During switch alloc/init tb_upstream_port()->remote may be NULL, even for
319 * non root switches (on the NHI port remote is always NULL).
321 * Return: Returns the upstream port of the switch.
323 static inline struct tb_port *tb_upstream_port(struct tb_switch *sw)
325 return &sw->ports[sw->config.upstream_port_number];
329 * tb_is_upstream_port() - Is the port upstream facing
330 * @port: Port to check
332 * Returns true if @port is upstream facing port. In case of dual link
333 * ports both return true.
335 static inline bool tb_is_upstream_port(const struct tb_port *port)
337 const struct tb_port *upstream_port = tb_upstream_port(port->sw);
338 return port == upstream_port || port->dual_link_port == upstream_port;
341 static inline u64 tb_route(const struct tb_switch *sw)
343 return ((u64) sw->config.route_hi) << 32 | sw->config.route_lo;
346 static inline struct tb_port *tb_port_at(u64 route, struct tb_switch *sw)
350 port = route >> (sw->config.depth * 8);
351 if (WARN_ON(port > sw->config.max_port_number))
353 return &sw->ports[port];
357 * tb_port_has_remote() - Does the port have switch connected downstream
358 * @port: Port to check
360 * Returns true only when the port is primary port and has remote set.
362 static inline bool tb_port_has_remote(const struct tb_port *port)
364 if (tb_is_upstream_port(port))
368 if (port->dual_link_port && port->link_nr)
374 static inline bool tb_port_is_null(const struct tb_port *port)
376 return port && port->port && port->config.type == TB_TYPE_PORT;
379 static inline bool tb_port_is_pcie_down(const struct tb_port *port)
381 return port && port->config.type == TB_TYPE_PCIE_DOWN;
384 static inline bool tb_port_is_pcie_up(const struct tb_port *port)
386 return port && port->config.type == TB_TYPE_PCIE_UP;
389 static inline bool tb_port_is_dpin(const struct tb_port *port)
391 return port && port->config.type == TB_TYPE_DP_HDMI_IN;
394 static inline bool tb_port_is_dpout(const struct tb_port *port)
396 return port && port->config.type == TB_TYPE_DP_HDMI_OUT;
399 static inline int tb_sw_read(struct tb_switch *sw, void *buffer,
400 enum tb_cfg_space space, u32 offset, u32 length)
402 if (sw->is_unplugged)
404 return tb_cfg_read(sw->tb->ctl,
413 static inline int tb_sw_write(struct tb_switch *sw, const void *buffer,
414 enum tb_cfg_space space, u32 offset, u32 length)
416 if (sw->is_unplugged)
418 return tb_cfg_write(sw->tb->ctl,
427 static inline int tb_port_read(struct tb_port *port, void *buffer,
428 enum tb_cfg_space space, u32 offset, u32 length)
430 if (port->sw->is_unplugged)
432 return tb_cfg_read(port->sw->tb->ctl,
441 static inline int tb_port_write(struct tb_port *port, const void *buffer,
442 enum tb_cfg_space space, u32 offset, u32 length)
444 if (port->sw->is_unplugged)
446 return tb_cfg_write(port->sw->tb->ctl,
455 #define tb_err(tb, fmt, arg...) dev_err(&(tb)->nhi->pdev->dev, fmt, ## arg)
456 #define tb_WARN(tb, fmt, arg...) dev_WARN(&(tb)->nhi->pdev->dev, fmt, ## arg)
457 #define tb_warn(tb, fmt, arg...) dev_warn(&(tb)->nhi->pdev->dev, fmt, ## arg)
458 #define tb_info(tb, fmt, arg...) dev_info(&(tb)->nhi->pdev->dev, fmt, ## arg)
459 #define tb_dbg(tb, fmt, arg...) dev_dbg(&(tb)->nhi->pdev->dev, fmt, ## arg)
461 #define __TB_SW_PRINT(level, sw, fmt, arg...) \
463 const struct tb_switch *__sw = (sw); \
464 level(__sw->tb, "%llx: " fmt, \
465 tb_route(__sw), ## arg); \
467 #define tb_sw_WARN(sw, fmt, arg...) __TB_SW_PRINT(tb_WARN, sw, fmt, ##arg)
468 #define tb_sw_warn(sw, fmt, arg...) __TB_SW_PRINT(tb_warn, sw, fmt, ##arg)
469 #define tb_sw_info(sw, fmt, arg...) __TB_SW_PRINT(tb_info, sw, fmt, ##arg)
470 #define tb_sw_dbg(sw, fmt, arg...) __TB_SW_PRINT(tb_dbg, sw, fmt, ##arg)
472 #define __TB_PORT_PRINT(level, _port, fmt, arg...) \
474 const struct tb_port *__port = (_port); \
475 level(__port->sw->tb, "%llx:%x: " fmt, \
476 tb_route(__port->sw), __port->port, ## arg); \
478 #define tb_port_WARN(port, fmt, arg...) \
479 __TB_PORT_PRINT(tb_WARN, port, fmt, ##arg)
480 #define tb_port_warn(port, fmt, arg...) \
481 __TB_PORT_PRINT(tb_warn, port, fmt, ##arg)
482 #define tb_port_info(port, fmt, arg...) \
483 __TB_PORT_PRINT(tb_info, port, fmt, ##arg)
484 #define tb_port_dbg(port, fmt, arg...) \
485 __TB_PORT_PRINT(tb_dbg, port, fmt, ##arg)
487 struct tb *icm_probe(struct tb_nhi *nhi);
488 struct tb *tb_probe(struct tb_nhi *nhi);
490 extern struct device_type tb_domain_type;
491 extern struct device_type tb_switch_type;
493 int tb_domain_init(void);
494 void tb_domain_exit(void);
495 void tb_switch_exit(void);
496 int tb_xdomain_init(void);
497 void tb_xdomain_exit(void);
499 struct tb *tb_domain_alloc(struct tb_nhi *nhi, size_t privsize);
500 int tb_domain_add(struct tb *tb);
501 void tb_domain_remove(struct tb *tb);
502 int tb_domain_suspend_noirq(struct tb *tb);
503 int tb_domain_resume_noirq(struct tb *tb);
504 int tb_domain_suspend(struct tb *tb);
505 void tb_domain_complete(struct tb *tb);
506 int tb_domain_runtime_suspend(struct tb *tb);
507 int tb_domain_runtime_resume(struct tb *tb);
508 int tb_domain_approve_switch(struct tb *tb, struct tb_switch *sw);
509 int tb_domain_approve_switch_key(struct tb *tb, struct tb_switch *sw);
510 int tb_domain_challenge_switch_key(struct tb *tb, struct tb_switch *sw);
511 int tb_domain_disconnect_pcie_paths(struct tb *tb);
512 int tb_domain_approve_xdomain_paths(struct tb *tb, struct tb_xdomain *xd);
513 int tb_domain_disconnect_xdomain_paths(struct tb *tb, struct tb_xdomain *xd);
514 int tb_domain_disconnect_all_paths(struct tb *tb);
516 static inline struct tb *tb_domain_get(struct tb *tb)
519 get_device(&tb->dev);
523 static inline void tb_domain_put(struct tb *tb)
525 put_device(&tb->dev);
528 struct tb_switch *tb_switch_alloc(struct tb *tb, struct device *parent,
530 struct tb_switch *tb_switch_alloc_safe_mode(struct tb *tb,
531 struct device *parent, u64 route);
532 int tb_switch_configure(struct tb_switch *sw);
533 int tb_switch_add(struct tb_switch *sw);
534 void tb_switch_remove(struct tb_switch *sw);
535 void tb_switch_suspend(struct tb_switch *sw);
536 int tb_switch_resume(struct tb_switch *sw);
537 int tb_switch_reset(struct tb *tb, u64 route);
538 void tb_sw_set_unplugged(struct tb_switch *sw);
539 struct tb_port *tb_switch_find_port(struct tb_switch *sw,
540 enum tb_port_type type);
541 struct tb_switch *tb_switch_find_by_link_depth(struct tb *tb, u8 link,
543 struct tb_switch *tb_switch_find_by_uuid(struct tb *tb, const uuid_t *uuid);
544 struct tb_switch *tb_switch_find_by_route(struct tb *tb, u64 route);
547 * tb_switch_for_each_port() - Iterate over each switch port
548 * @sw: Switch whose ports to iterate
549 * @p: Port used as iterator
551 * Iterates over each switch port skipping the control port (port %0).
553 #define tb_switch_for_each_port(sw, p) \
554 for ((p) = &(sw)->ports[1]; \
555 (p) <= &(sw)->ports[(sw)->config.max_port_number]; (p)++)
557 static inline struct tb_switch *tb_switch_get(struct tb_switch *sw)
560 get_device(&sw->dev);
564 static inline void tb_switch_put(struct tb_switch *sw)
566 put_device(&sw->dev);
569 static inline bool tb_is_switch(const struct device *dev)
571 return dev->type == &tb_switch_type;
574 static inline struct tb_switch *tb_to_switch(struct device *dev)
576 if (tb_is_switch(dev))
577 return container_of(dev, struct tb_switch, dev);
581 static inline struct tb_switch *tb_switch_parent(struct tb_switch *sw)
583 return tb_to_switch(sw->dev.parent);
586 static inline bool tb_switch_is_light_ridge(const struct tb_switch *sw)
588 return sw->config.device_id == PCI_DEVICE_ID_INTEL_LIGHT_RIDGE;
591 static inline bool tb_switch_is_eagle_ridge(const struct tb_switch *sw)
593 return sw->config.device_id == PCI_DEVICE_ID_INTEL_EAGLE_RIDGE;
596 static inline bool tb_switch_is_cactus_ridge(const struct tb_switch *sw)
598 switch (sw->config.device_id) {
599 case PCI_DEVICE_ID_INTEL_CACTUS_RIDGE_2C:
600 case PCI_DEVICE_ID_INTEL_CACTUS_RIDGE_4C:
607 static inline bool tb_switch_is_falcon_ridge(const struct tb_switch *sw)
609 switch (sw->config.device_id) {
610 case PCI_DEVICE_ID_INTEL_FALCON_RIDGE_2C_BRIDGE:
611 case PCI_DEVICE_ID_INTEL_FALCON_RIDGE_4C_BRIDGE:
618 static inline bool tb_switch_is_alpine_ridge(const struct tb_switch *sw)
620 switch (sw->config.device_id) {
621 case PCI_DEVICE_ID_INTEL_ALPINE_RIDGE_2C_BRIDGE:
622 case PCI_DEVICE_ID_INTEL_ALPINE_RIDGE_LP_BRIDGE:
623 case PCI_DEVICE_ID_INTEL_ALPINE_RIDGE_C_4C_BRIDGE:
624 case PCI_DEVICE_ID_INTEL_ALPINE_RIDGE_C_2C_BRIDGE:
631 static inline bool tb_switch_is_titan_ridge(const struct tb_switch *sw)
633 switch (sw->config.device_id) {
634 case PCI_DEVICE_ID_INTEL_TITAN_RIDGE_2C_BRIDGE:
635 case PCI_DEVICE_ID_INTEL_TITAN_RIDGE_4C_BRIDGE:
636 case PCI_DEVICE_ID_INTEL_TITAN_RIDGE_DD_BRIDGE:
644 * tb_switch_is_usb4() - Is the switch USB4 compliant
645 * @sw: Switch to check
647 * Returns true if the @sw is USB4 compliant router, false otherwise.
649 static inline bool tb_switch_is_usb4(const struct tb_switch *sw)
651 return sw->config.thunderbolt_version == USB4_VERSION_1_0;
655 * tb_switch_is_icm() - Is the switch handled by ICM firmware
656 * @sw: Switch to check
658 * In case there is a need to differentiate whether ICM firmware or SW CM
659 * is handling @sw this function can be called. It is valid to call this
660 * after tb_switch_alloc() and tb_switch_configure() has been called
661 * (latter only for SW CM case).
663 static inline bool tb_switch_is_icm(const struct tb_switch *sw)
665 return !sw->config.enabled;
668 int tb_switch_lane_bonding_enable(struct tb_switch *sw);
669 void tb_switch_lane_bonding_disable(struct tb_switch *sw);
671 bool tb_switch_query_dp_resource(struct tb_switch *sw, struct tb_port *in);
672 int tb_switch_alloc_dp_resource(struct tb_switch *sw, struct tb_port *in);
673 void tb_switch_dealloc_dp_resource(struct tb_switch *sw, struct tb_port *in);
675 int tb_wait_for_port(struct tb_port *port, bool wait_if_unplugged);
676 int tb_port_add_nfc_credits(struct tb_port *port, int credits);
677 int tb_port_set_initial_credits(struct tb_port *port, u32 credits);
678 int tb_port_clear_counter(struct tb_port *port, int counter);
679 int tb_port_unlock(struct tb_port *port);
680 int tb_port_alloc_in_hopid(struct tb_port *port, int hopid, int max_hopid);
681 void tb_port_release_in_hopid(struct tb_port *port, int hopid);
682 int tb_port_alloc_out_hopid(struct tb_port *port, int hopid, int max_hopid);
683 void tb_port_release_out_hopid(struct tb_port *port, int hopid);
684 struct tb_port *tb_next_port_on_path(struct tb_port *start, struct tb_port *end,
685 struct tb_port *prev);
687 int tb_switch_find_vse_cap(struct tb_switch *sw, enum tb_switch_vse_cap vsec);
688 int tb_switch_find_cap(struct tb_switch *sw, enum tb_switch_cap cap);
689 int tb_port_find_cap(struct tb_port *port, enum tb_port_cap cap);
690 bool tb_port_is_enabled(struct tb_port *port);
692 bool tb_pci_port_is_enabled(struct tb_port *port);
693 int tb_pci_port_enable(struct tb_port *port, bool enable);
695 int tb_dp_port_hpd_is_active(struct tb_port *port);
696 int tb_dp_port_hpd_clear(struct tb_port *port);
697 int tb_dp_port_set_hops(struct tb_port *port, unsigned int video,
698 unsigned int aux_tx, unsigned int aux_rx);
699 bool tb_dp_port_is_enabled(struct tb_port *port);
700 int tb_dp_port_enable(struct tb_port *port, bool enable);
702 struct tb_path *tb_path_discover(struct tb_port *src, int src_hopid,
703 struct tb_port *dst, int dst_hopid,
704 struct tb_port **last, const char *name);
705 struct tb_path *tb_path_alloc(struct tb *tb, struct tb_port *src, int src_hopid,
706 struct tb_port *dst, int dst_hopid, int link_nr,
708 void tb_path_free(struct tb_path *path);
709 int tb_path_activate(struct tb_path *path);
710 void tb_path_deactivate(struct tb_path *path);
711 bool tb_path_is_invalid(struct tb_path *path);
712 bool tb_path_switch_on_path(const struct tb_path *path,
713 const struct tb_switch *sw);
715 int tb_drom_read(struct tb_switch *sw);
716 int tb_drom_read_uid_only(struct tb_switch *sw, u64 *uid);
718 int tb_lc_read_uuid(struct tb_switch *sw, u32 *uuid);
719 int tb_lc_configure_link(struct tb_switch *sw);
720 void tb_lc_unconfigure_link(struct tb_switch *sw);
721 int tb_lc_set_sleep(struct tb_switch *sw);
722 bool tb_lc_lane_bonding_possible(struct tb_switch *sw);
723 bool tb_lc_dp_sink_query(struct tb_switch *sw, struct tb_port *in);
724 int tb_lc_dp_sink_alloc(struct tb_switch *sw, struct tb_port *in);
725 int tb_lc_dp_sink_dealloc(struct tb_switch *sw, struct tb_port *in);
727 static inline int tb_route_length(u64 route)
729 return (fls64(route) + TB_ROUTE_SHIFT - 1) / TB_ROUTE_SHIFT;
733 * tb_downstream_route() - get route to downstream switch
735 * Port must not be the upstream port (otherwise a loop is created).
737 * Return: Returns a route to the switch behind @port.
739 static inline u64 tb_downstream_route(struct tb_port *port)
741 return tb_route(port->sw)
742 | ((u64) port->port << (port->sw->config.depth * 8));
745 bool tb_xdomain_handle_request(struct tb *tb, enum tb_cfg_pkg_type type,
746 const void *buf, size_t size);
747 struct tb_xdomain *tb_xdomain_alloc(struct tb *tb, struct device *parent,
748 u64 route, const uuid_t *local_uuid,
749 const uuid_t *remote_uuid);
750 void tb_xdomain_add(struct tb_xdomain *xd);
751 void tb_xdomain_remove(struct tb_xdomain *xd);
752 struct tb_xdomain *tb_xdomain_find_by_link_depth(struct tb *tb, u8 link,
755 int usb4_switch_setup(struct tb_switch *sw);
756 int usb4_switch_read_uid(struct tb_switch *sw, u64 *uid);
757 int usb4_switch_drom_read(struct tb_switch *sw, unsigned int address, void *buf,
759 int usb4_switch_configure_link(struct tb_switch *sw);
760 void usb4_switch_unconfigure_link(struct tb_switch *sw);
761 bool usb4_switch_lane_bonding_possible(struct tb_switch *sw);
762 int usb4_switch_set_sleep(struct tb_switch *sw);
763 int usb4_switch_nvm_sector_size(struct tb_switch *sw);
764 int usb4_switch_nvm_read(struct tb_switch *sw, unsigned int address, void *buf,
766 int usb4_switch_nvm_write(struct tb_switch *sw, unsigned int address,
767 const void *buf, size_t size);
768 int usb4_switch_nvm_authenticate(struct tb_switch *sw);
769 bool usb4_switch_query_dp_resource(struct tb_switch *sw, struct tb_port *in);
770 int usb4_switch_alloc_dp_resource(struct tb_switch *sw, struct tb_port *in);
771 int usb4_switch_dealloc_dp_resource(struct tb_switch *sw, struct tb_port *in);
772 struct tb_port *usb4_switch_map_pcie_down(struct tb_switch *sw,
773 const struct tb_port *port);
775 int usb4_port_unlock(struct tb_port *port);