drivers/thunderbolt/tunnel.h

   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
  14 enum 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  */
  44 struct 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
  67 struct tb_tunnel *tb_tunnel_discover_pci(struct tb *tb, struct tb_port *down,
  68                                          bool alloc_hopid);
  69 struct tb_tunnel *tb_tunnel_alloc_pci(struct tb *tb, struct tb_port *up,
  70                                       struct tb_port *down);
  71 struct tb_tunnel *tb_tunnel_discover_dp(struct tb *tb, struct tb_port *in,
  72                                         bool alloc_hopid);
  73 struct 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);
  76 struct 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);
  80 bool tb_tunnel_match_dma(const struct tb_tunnel *tunnel, int transmit_path,
  81                          int transmit_ring, int receive_path, int receive_ring);
  82 struct tb_tunnel *tb_tunnel_discover_usb3(struct tb *tb, struct tb_port *down,
  83                                           bool alloc_hopid);
  84 struct 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
  88 void tb_tunnel_free(struct tb_tunnel *tunnel);
  89 int tb_tunnel_activate(struct tb_tunnel *tunnel);
  90 int tb_tunnel_restart(struct tb_tunnel *tunnel);
  91 void tb_tunnel_deactivate(struct tb_tunnel *tunnel);
  92 bool tb_tunnel_is_invalid(struct tb_tunnel *tunnel);
  93 bool tb_tunnel_port_on_path(const struct tb_tunnel *tunnel,
  94                             const struct tb_port *port);
  95 int tb_tunnel_consumed_bandwidth(struct tb_tunnel *tunnel, int *consumed_up,
  96                                  int *consumed_down);
  97 int tb_tunnel_release_unused_bandwidth(struct tb_tunnel *tunnel);
  98 void tb_tunnel_reclaim_available_bandwidth(struct tb_tunnel *tunnel,
  99                                            int *available_up,
 100                                            int *available_down);
 101
 102 static inline bool tb_tunnel_is_pci(const struct tb_tunnel *tunnel)
 103 {
 104         return tunnel->type == TB_TUNNEL_PCI;
 105 }
 106
 107 static inline bool tb_tunnel_is_dp(const struct tb_tunnel *tunnel)
 108 {
 109         return tunnel->type == TB_TUNNEL_DP;
 110 }
 111
 112 static inline bool tb_tunnel_is_dma(const struct tb_tunnel *tunnel)
 113 {
 114         return tunnel->type == TB_TUNNEL_DMA;
 115 }
 116
 117 static inline bool tb_tunnel_is_usb3(const struct tb_tunnel *tunnel)
 118 {
 119         return tunnel->type == TB_TUNNEL_USB3;
 120 }
 121
 122 #endif
 123