DPDK  17.05.2
rte_eth_bond_8023ad_private.h
1 /*-
2  * BSD LICENSE
3  *
4  * Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * * Redistributions of source code must retain the above copyright
12  * notice, this list of conditions and the following disclaimer.
13  * * Redistributions in binary form must reproduce the above copyright
14  * notice, this list of conditions and the following disclaimer in
15  * the documentation and/or other materials provided with the
16  * distribution.
17  * * Neither the name of Intel Corporation nor the names of its
18  * contributors may be used to endorse or promote products derived
19  * from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #ifndef RTE_ETH_BOND_8023AD_PRIVATE_H_
35 #define RTE_ETH_BOND_8023AD_PRIVATE_H_
36 
37 #include <stdint.h>
38 
39 #include <rte_ether.h>
40 #include <rte_byteorder.h>
41 #include <rte_atomic.h>
42 
43 #include "rte_eth_bond_8023ad.h"
44 
45 #define BOND_MODE_8023AX_UPDATE_TIMEOUT_MS 100
46 
47 #define BOND_MODE_8023AX_SLAVE_RX_PKTS 3
48 
49 #define BOND_MODE_8023AX_SLAVE_TX_PKTS 1
50 
53 #define BOND_8023AD_FAST_PERIODIC_MS 900
54 #define BOND_8023AD_SLOW_PERIODIC_MS 29000
55 #define BOND_8023AD_SHORT_TIMEOUT_MS 3000
56 #define BOND_8023AD_LONG_TIMEOUT_MS 90000
57 #define BOND_8023AD_CHURN_DETECTION_TIMEOUT_MS 60000
58 #define BOND_8023AD_AGGREGATE_WAIT_TIMEOUT_MS 2000
59 #define BOND_8023AD_TX_MACHINE_PERIOD_MS 500
60 #define BOND_8023AD_RX_MARKER_PERIOD_MS 2000
61 
67 #define BOND_8023AD_WARNINGS_PERIOD_MS 1000
68 
69 
70 
74 #define SM_FLAGS_BEGIN 0x0001
75 #define SM_FLAGS_LACP_ENABLED 0x0002
76 #define SM_FLAGS_ACTOR_CHURN 0x0004
77 #define SM_FLAGS_PARTNER_CHURN 0x0008
78 #define SM_FLAGS_MOVED 0x0100
79 #define SM_FLAGS_PARTNER_SHORT_TIMEOUT 0x0200
80 #define SM_FLAGS_NTT 0x0400
81 
82 #define BOND_LINK_FULL_DUPLEX_KEY 0x01
83 #define BOND_LINK_SPEED_KEY_10M 0x02
84 #define BOND_LINK_SPEED_KEY_100M 0x04
85 #define BOND_LINK_SPEED_KEY_1000M 0x08
86 #define BOND_LINK_SPEED_KEY_10G 0x10
87 #define BOND_LINK_SPEED_KEY_20G 0x11
88 #define BOND_LINK_SPEED_KEY_40G 0x12
89 
90 #define WRN_RX_MARKER_TO_FAST 0x01
91 #define WRN_UNKNOWN_SLOW_TYPE 0x02
92 #define WRN_UNKNOWN_MARKER_TYPE 0x04
93 #define WRN_NOT_LACP_CAPABLE 0x08
94 #define WRN_RX_QUEUE_FULL 0x10
95 #define WRN_TX_QUEUE_FULL 0x20
96 
97 #define CHECK_FLAGS(_variable, _f) ((_variable) & (_f))
98 #define SET_FLAGS(_variable, _f) ((_variable) |= (_f))
99 #define CLEAR_FLAGS(_variable, _f) ((_variable) &= ~(_f))
100 
101 #define SM_FLAG(_p, _f) (!!CHECK_FLAGS((_p)->sm_flags, SM_FLAGS_ ## _f))
102 #define SM_FLAG_SET(_p, _f) SET_FLAGS((_p)->sm_flags, SM_FLAGS_ ## _f)
103 #define SM_FLAG_CLR(_p, _f) CLEAR_FLAGS((_p)->sm_flags, SM_FLAGS_ ## _f)
104 
105 #define ACTOR_STATE(_p, _f) (!!CHECK_FLAGS((_p)->actor_state, STATE_ ## _f))
106 #define ACTOR_STATE_SET(_p, _f) SET_FLAGS((_p)->actor_state, STATE_ ## _f)
107 #define ACTOR_STATE_CLR(_p, _f) CLEAR_FLAGS((_p)->actor_state, STATE_ ## _f)
108 
109 #define PARTNER_STATE(_p, _f) (!!CHECK_FLAGS((_p)->partner_state, STATE_ ## _f))
110 #define PARTNER_STATE_SET(_p, _f) SET_FLAGS((_p)->partner_state, STATE_ ## _f)
111 #define PARTNER_STATE_CLR(_p, _f) CLEAR_FLAGS((_p)->partner_state, STATE_ ## _f)
112 
114 struct port {
119  uint8_t actor_state;
120 
122  struct port_params actor;
123 
130  uint8_t partner_state;
131 
133  struct port_params partner;
134 
135  /* Additional port parameters not listed in documentation */
137  uint16_t sm_flags;
138  enum rte_bond_8023ad_selection selected;
139 
140  uint64_t current_while_timer;
141  uint64_t periodic_timer;
142  uint64_t wait_while_timer;
143  uint64_t tx_machine_timer;
144  uint64_t tx_marker_timer;
145  /* Agregator parameters */
148 
151 
153  struct rte_ring *rx_ring;
154 
156  struct rte_ring *tx_ring;
157 
161  volatile uint64_t rx_marker_timer;
162 
163  uint64_t warning_timer;
164  volatile uint16_t warnings_to_show;
165 };
166 
167 struct mode8023ad_private {
168  uint64_t fast_periodic_timeout;
169  uint64_t slow_periodic_timeout;
170  uint64_t short_timeout;
171  uint64_t long_timeout;
172  uint64_t aggregate_wait_timeout;
173  uint64_t tx_period_timeout;
174  uint64_t rx_marker_timeout;
175  uint64_t update_timeout_us;
176  rte_eth_bond_8023ad_ext_slowrx_fn slowrx_cb;
177  uint8_t external_sm;
178 };
179 
185 extern struct port mode_8023ad_ports[];
186 
187 /* Forward declaration */
188 struct bond_dev_private;
189 
190 
201 void
202 bond_mode_8023ad_setup(struct rte_eth_dev *dev,
203  struct rte_eth_bond_8023ad_conf *conf);
204 
214 int
215 bond_mode_8023ad_enable(struct rte_eth_dev *dev);
216 
226 int bond_mode_8023ad_disable(struct rte_eth_dev *dev);
227 
237 int
238 bond_mode_8023ad_start(struct rte_eth_dev *dev);
239 
248 void
249 bond_mode_8023ad_stop(struct rte_eth_dev *dev);
250 
259 void
260 bond_mode_8023ad_handle_slow_pkt(struct bond_dev_private *internals,
261  uint8_t slave_id, struct rte_mbuf *pkt);
262 
274 void
275 bond_mode_8023ad_activate_slave(struct rte_eth_dev *dev, uint8_t port_id);
276 
288 int
289 bond_mode_8023ad_deactivate_slave(struct rte_eth_dev *dev, uint8_t slave_pos);
290 
295 void
296 bond_mode_8023ad_mac_address_update(struct rte_eth_dev *bond_dev);
297 
298 #endif /* RTE_ETH_BOND_8023AD_H_ */