tunnel.h (4333B)
1/* SPDX-License-Identifier: GPL-2.0 */ 2/* 3 * Thunderbolt driver - Tunneling support 4 * 5 * Copyright (c) 2014 Andreas Noever <andreas.noever@gmail.com> 6 * Copyright (C) 2019, Intel Corporation 7 */ 8 9#ifndef TB_TUNNEL_H_ 10#define TB_TUNNEL_H_ 11 12#include "tb.h" 13 14enum tb_tunnel_type { 15 TB_TUNNEL_PCI, 16 TB_TUNNEL_DP, 17 TB_TUNNEL_DMA, 18 TB_TUNNEL_USB3, 19}; 20 21/** 22 * struct tb_tunnel - Tunnel between two ports 23 * @tb: Pointer to the domain 24 * @src_port: Source port of the tunnel 25 * @dst_port: Destination port of the tunnel. For discovered incomplete 26 * tunnels may be %NULL or null adapter port instead. 27 * @paths: All paths required by the tunnel 28 * @npaths: Number of paths in @paths 29 * @init: Optional tunnel specific initialization 30 * @deinit: Optional tunnel specific de-initialization 31 * @activate: Optional tunnel specific activation/deactivation 32 * @consumed_bandwidth: Return how much bandwidth the tunnel consumes 33 * @release_unused_bandwidth: Release all unused bandwidth 34 * @reclaim_available_bandwidth: Reclaim back available bandwidth 35 * @list: Tunnels are linked using this field 36 * @type: Type of the tunnel 37 * @max_up: Maximum upstream bandwidth (Mb/s) available for the tunnel. 38 * Only set if the bandwidth needs to be limited. 39 * @max_down: Maximum downstream bandwidth (Mb/s) available for the tunnel. 40 * Only set if the bandwidth needs to be limited. 41 * @allocated_up: Allocated upstream bandwidth (only for USB3) 42 * @allocated_down: Allocated downstream bandwidth (only for USB3) 43 */ 44struct tb_tunnel { 45 struct tb *tb; 46 struct tb_port *src_port; 47 struct tb_port *dst_port; 48 struct tb_path **paths; 49 size_t npaths; 50 int (*init)(struct tb_tunnel *tunnel); 51 void (*deinit)(struct tb_tunnel *tunnel); 52 int (*activate)(struct tb_tunnel *tunnel, bool activate); 53 int (*consumed_bandwidth)(struct tb_tunnel *tunnel, int *consumed_up, 54 int *consumed_down); 55 int (*release_unused_bandwidth)(struct tb_tunnel *tunnel); 56 void (*reclaim_available_bandwidth)(struct tb_tunnel *tunnel, 57 int *available_up, 58 int *available_down); 59 struct list_head list; 60 enum tb_tunnel_type type; 61 int max_up; 62 int max_down; 63 int allocated_up; 64 int allocated_down; 65}; 66 67struct tb_tunnel *tb_tunnel_discover_pci(struct tb *tb, struct tb_port *down, 68 bool alloc_hopid); 69struct tb_tunnel *tb_tunnel_alloc_pci(struct tb *tb, struct tb_port *up, 70 struct tb_port *down); 71struct tb_tunnel *tb_tunnel_discover_dp(struct tb *tb, struct tb_port *in, 72 bool alloc_hopid); 73struct tb_tunnel *tb_tunnel_alloc_dp(struct tb *tb, struct tb_port *in, 74 struct tb_port *out, int link_nr, 75 int max_up, int max_down); 76struct tb_tunnel *tb_tunnel_alloc_dma(struct tb *tb, struct tb_port *nhi, 77 struct tb_port *dst, int transmit_path, 78 int transmit_ring, int receive_path, 79 int receive_ring); 80bool tb_tunnel_match_dma(const struct tb_tunnel *tunnel, int transmit_path, 81 int transmit_ring, int receive_path, int receive_ring); 82struct tb_tunnel *tb_tunnel_discover_usb3(struct tb *tb, struct tb_port *down, 83 bool alloc_hopid); 84struct tb_tunnel *tb_tunnel_alloc_usb3(struct tb *tb, struct tb_port *up, 85 struct tb_port *down, int max_up, 86 int max_down); 87 88void tb_tunnel_free(struct tb_tunnel *tunnel); 89int tb_tunnel_activate(struct tb_tunnel *tunnel); 90int tb_tunnel_restart(struct tb_tunnel *tunnel); 91void tb_tunnel_deactivate(struct tb_tunnel *tunnel); 92bool tb_tunnel_is_invalid(struct tb_tunnel *tunnel); 93bool tb_tunnel_port_on_path(const struct tb_tunnel *tunnel, 94 const struct tb_port *port); 95int tb_tunnel_consumed_bandwidth(struct tb_tunnel *tunnel, int *consumed_up, 96 int *consumed_down); 97int tb_tunnel_release_unused_bandwidth(struct tb_tunnel *tunnel); 98void tb_tunnel_reclaim_available_bandwidth(struct tb_tunnel *tunnel, 99 int *available_up, 100 int *available_down); 101 102static inline bool tb_tunnel_is_pci(const struct tb_tunnel *tunnel) 103{ 104 return tunnel->type == TB_TUNNEL_PCI; 105} 106 107static inline bool tb_tunnel_is_dp(const struct tb_tunnel *tunnel) 108{ 109 return tunnel->type == TB_TUNNEL_DP; 110} 111 112static inline bool tb_tunnel_is_dma(const struct tb_tunnel *tunnel) 113{ 114 return tunnel->type == TB_TUNNEL_DMA; 115} 116 117static inline bool tb_tunnel_is_usb3(const struct tb_tunnel *tunnel) 118{ 119 return tunnel->type == TB_TUNNEL_USB3; 120} 121 122#endif 123