xref: /dpdk/drivers/net/mlx5/mlx5_ethdev.c (revision 9f3b3a96dec2f4c01cc92a132d763b8887d29e6a)
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright 2015 6WIND S.A.
3  * Copyright 2015 Mellanox Technologies, Ltd
4  */
5 
6 #include <stddef.h>
7 #include <unistd.h>
8 #include <string.h>
9 #include <stdint.h>
10 #include <stdlib.h>
11 #include <errno.h>
12 
13 #include <rte_ethdev_driver.h>
14 #include <rte_bus_pci.h>
15 #include <rte_mbuf.h>
16 #include <rte_common.h>
17 #include <rte_interrupts.h>
18 #include <rte_malloc.h>
19 #include <rte_string_fns.h>
20 #include <rte_rwlock.h>
21 #include <rte_cycles.h>
22 
23 #include <mlx5_malloc.h>
24 
25 #include "mlx5_rxtx.h"
26 #include "mlx5_autoconf.h"
27 
28 /**
29  * Get the interface index from device name.
30  *
31  * @param[in] dev
32  *   Pointer to Ethernet device.
33  *
34  * @return
35  *   Nonzero interface index on success, zero otherwise and rte_errno is set.
36  */
37 unsigned int
38 mlx5_ifindex(const struct rte_eth_dev *dev)
39 {
40 	struct mlx5_priv *priv = dev->data->dev_private;
41 	unsigned int ifindex;
42 
43 	MLX5_ASSERT(priv);
44 	MLX5_ASSERT(priv->if_index);
45 	ifindex = priv->bond_ifindex > 0 ? priv->bond_ifindex : priv->if_index;
46 	if (!ifindex)
47 		rte_errno = ENXIO;
48 	return ifindex;
49 }
50 
51 /**
52  * DPDK callback for Ethernet device configuration.
53  *
54  * @param dev
55  *   Pointer to Ethernet device structure.
56  *
57  * @return
58  *   0 on success, a negative errno value otherwise and rte_errno is set.
59  */
60 int
61 mlx5_dev_configure(struct rte_eth_dev *dev)
62 {
63 	struct mlx5_priv *priv = dev->data->dev_private;
64 	unsigned int rxqs_n = dev->data->nb_rx_queues;
65 	unsigned int txqs_n = dev->data->nb_tx_queues;
66 	const uint8_t use_app_rss_key =
67 		!!dev->data->dev_conf.rx_adv_conf.rss_conf.rss_key;
68 	int ret = 0;
69 
70 	if (use_app_rss_key &&
71 	    (dev->data->dev_conf.rx_adv_conf.rss_conf.rss_key_len !=
72 	     MLX5_RSS_HASH_KEY_LEN)) {
73 		DRV_LOG(ERR, "port %u RSS key len must be %s Bytes long",
74 			dev->data->port_id, RTE_STR(MLX5_RSS_HASH_KEY_LEN));
75 		rte_errno = EINVAL;
76 		return -rte_errno;
77 	}
78 	priv->rss_conf.rss_key =
79 		mlx5_realloc(priv->rss_conf.rss_key, MLX5_MEM_RTE,
80 			    MLX5_RSS_HASH_KEY_LEN, 0, SOCKET_ID_ANY);
81 	if (!priv->rss_conf.rss_key) {
82 		DRV_LOG(ERR, "port %u cannot allocate RSS hash key memory (%u)",
83 			dev->data->port_id, rxqs_n);
84 		rte_errno = ENOMEM;
85 		return -rte_errno;
86 	}
87 
88 	if ((dev->data->dev_conf.txmode.offloads &
89 			DEV_TX_OFFLOAD_SEND_ON_TIMESTAMP) &&
90 			rte_mbuf_dyn_tx_timestamp_register(NULL, NULL) != 0) {
91 		DRV_LOG(ERR, "port %u cannot register Tx timestamp field/flag",
92 			dev->data->port_id);
93 		return -rte_errno;
94 	}
95 	memcpy(priv->rss_conf.rss_key,
96 	       use_app_rss_key ?
97 	       dev->data->dev_conf.rx_adv_conf.rss_conf.rss_key :
98 	       rss_hash_default_key,
99 	       MLX5_RSS_HASH_KEY_LEN);
100 	priv->rss_conf.rss_key_len = MLX5_RSS_HASH_KEY_LEN;
101 	priv->rss_conf.rss_hf = dev->data->dev_conf.rx_adv_conf.rss_conf.rss_hf;
102 	priv->rxqs = (void *)dev->data->rx_queues;
103 	priv->txqs = (void *)dev->data->tx_queues;
104 	if (txqs_n != priv->txqs_n) {
105 		DRV_LOG(INFO, "port %u Tx queues number update: %u -> %u",
106 			dev->data->port_id, priv->txqs_n, txqs_n);
107 		priv->txqs_n = txqs_n;
108 	}
109 	if (rxqs_n > priv->config.ind_table_max_size) {
110 		DRV_LOG(ERR, "port %u cannot handle this many Rx queues (%u)",
111 			dev->data->port_id, rxqs_n);
112 		rte_errno = EINVAL;
113 		return -rte_errno;
114 	}
115 	if (rxqs_n != priv->rxqs_n) {
116 		DRV_LOG(INFO, "port %u Rx queues number update: %u -> %u",
117 			dev->data->port_id, priv->rxqs_n, rxqs_n);
118 		priv->rxqs_n = rxqs_n;
119 	}
120 	priv->skip_default_rss_reta = 0;
121 	ret = mlx5_proc_priv_init(dev);
122 	if (ret)
123 		return ret;
124 	return 0;
125 }
126 
127 /**
128  * Configure default RSS reta.
129  *
130  * @param dev
131  *   Pointer to Ethernet device structure.
132  *
133  * @return
134  *   0 on success, a negative errno value otherwise and rte_errno is set.
135  */
136 int
137 mlx5_dev_configure_rss_reta(struct rte_eth_dev *dev)
138 {
139 	struct mlx5_priv *priv = dev->data->dev_private;
140 	unsigned int rxqs_n = dev->data->nb_rx_queues;
141 	unsigned int i;
142 	unsigned int j;
143 	unsigned int reta_idx_n;
144 	int ret = 0;
145 	unsigned int *rss_queue_arr = NULL;
146 	unsigned int rss_queue_n = 0;
147 
148 	if (priv->skip_default_rss_reta)
149 		return ret;
150 	rss_queue_arr = mlx5_malloc(0, rxqs_n * sizeof(unsigned int), 0,
151 				    SOCKET_ID_ANY);
152 	if (!rss_queue_arr) {
153 		DRV_LOG(ERR, "port %u cannot allocate RSS queue list (%u)",
154 			dev->data->port_id, rxqs_n);
155 		rte_errno = ENOMEM;
156 		return -rte_errno;
157 	}
158 	for (i = 0, j = 0; i < rxqs_n; i++) {
159 		struct mlx5_rxq_data *rxq_data;
160 		struct mlx5_rxq_ctrl *rxq_ctrl;
161 
162 		rxq_data = (*priv->rxqs)[i];
163 		rxq_ctrl = container_of(rxq_data, struct mlx5_rxq_ctrl, rxq);
164 		if (rxq_ctrl && rxq_ctrl->type == MLX5_RXQ_TYPE_STANDARD)
165 			rss_queue_arr[j++] = i;
166 	}
167 	rss_queue_n = j;
168 	if (rss_queue_n > priv->config.ind_table_max_size) {
169 		DRV_LOG(ERR, "port %u cannot handle this many Rx queues (%u)",
170 			dev->data->port_id, rss_queue_n);
171 		rte_errno = EINVAL;
172 		mlx5_free(rss_queue_arr);
173 		return -rte_errno;
174 	}
175 	DRV_LOG(INFO, "port %u Rx queues number update: %u -> %u",
176 		dev->data->port_id, priv->rxqs_n, rxqs_n);
177 	priv->rxqs_n = rxqs_n;
178 	/*
179 	 * If the requested number of RX queues is not a power of two,
180 	 * use the maximum indirection table size for better balancing.
181 	 * The result is always rounded to the next power of two.
182 	 */
183 	reta_idx_n = (1 << log2above((rss_queue_n & (rss_queue_n - 1)) ?
184 				priv->config.ind_table_max_size :
185 				rss_queue_n));
186 	ret = mlx5_rss_reta_index_resize(dev, reta_idx_n);
187 	if (ret) {
188 		mlx5_free(rss_queue_arr);
189 		return ret;
190 	}
191 	/*
192 	 * When the number of RX queues is not a power of two,
193 	 * the remaining table entries are padded with reused WQs
194 	 * and hashes are not spread uniformly.
195 	 */
196 	for (i = 0, j = 0; (i != reta_idx_n); ++i) {
197 		(*priv->reta_idx)[i] = rss_queue_arr[j];
198 		if (++j == rss_queue_n)
199 			j = 0;
200 	}
201 	mlx5_free(rss_queue_arr);
202 	return ret;
203 }
204 
205 /**
206  * Sets default tuning parameters.
207  *
208  * @param dev
209  *   Pointer to Ethernet device.
210  * @param[out] info
211  *   Info structure output buffer.
212  */
213 static void
214 mlx5_set_default_params(struct rte_eth_dev *dev, struct rte_eth_dev_info *info)
215 {
216 	struct mlx5_priv *priv = dev->data->dev_private;
217 
218 	/* Minimum CPU utilization. */
219 	info->default_rxportconf.ring_size = 256;
220 	info->default_txportconf.ring_size = 256;
221 	info->default_rxportconf.burst_size = MLX5_RX_DEFAULT_BURST;
222 	info->default_txportconf.burst_size = MLX5_TX_DEFAULT_BURST;
223 	if ((priv->link_speed_capa & ETH_LINK_SPEED_200G) |
224 		(priv->link_speed_capa & ETH_LINK_SPEED_100G)) {
225 		info->default_rxportconf.nb_queues = 16;
226 		info->default_txportconf.nb_queues = 16;
227 		if (dev->data->nb_rx_queues > 2 ||
228 		    dev->data->nb_tx_queues > 2) {
229 			/* Max Throughput. */
230 			info->default_rxportconf.ring_size = 2048;
231 			info->default_txportconf.ring_size = 2048;
232 		}
233 	} else {
234 		info->default_rxportconf.nb_queues = 8;
235 		info->default_txportconf.nb_queues = 8;
236 		if (dev->data->nb_rx_queues > 2 ||
237 		    dev->data->nb_tx_queues > 2) {
238 			/* Max Throughput. */
239 			info->default_rxportconf.ring_size = 4096;
240 			info->default_txportconf.ring_size = 4096;
241 		}
242 	}
243 }
244 
245 /**
246  * Sets tx mbuf limiting parameters.
247  *
248  * @param dev
249  *   Pointer to Ethernet device.
250  * @param[out] info
251  *   Info structure output buffer.
252  */
253 static void
254 mlx5_set_txlimit_params(struct rte_eth_dev *dev, struct rte_eth_dev_info *info)
255 {
256 	struct mlx5_priv *priv = dev->data->dev_private;
257 	struct mlx5_dev_config *config = &priv->config;
258 	unsigned int inlen;
259 	uint16_t nb_max;
260 
261 	inlen = (config->txq_inline_max == MLX5_ARG_UNSET) ?
262 		MLX5_SEND_DEF_INLINE_LEN :
263 		(unsigned int)config->txq_inline_max;
264 	MLX5_ASSERT(config->txq_inline_min >= 0);
265 	inlen = RTE_MAX(inlen, (unsigned int)config->txq_inline_min);
266 	inlen = RTE_MIN(inlen, MLX5_WQE_SIZE_MAX +
267 			       MLX5_ESEG_MIN_INLINE_SIZE -
268 			       MLX5_WQE_CSEG_SIZE -
269 			       MLX5_WQE_ESEG_SIZE -
270 			       MLX5_WQE_DSEG_SIZE * 2);
271 	nb_max = (MLX5_WQE_SIZE_MAX +
272 		  MLX5_ESEG_MIN_INLINE_SIZE -
273 		  MLX5_WQE_CSEG_SIZE -
274 		  MLX5_WQE_ESEG_SIZE -
275 		  MLX5_WQE_DSEG_SIZE -
276 		  inlen) / MLX5_WSEG_SIZE;
277 	info->tx_desc_lim.nb_seg_max = nb_max;
278 	info->tx_desc_lim.nb_mtu_seg_max = nb_max;
279 }
280 
281 /**
282  * DPDK callback to get information about the device.
283  *
284  * @param dev
285  *   Pointer to Ethernet device structure.
286  * @param[out] info
287  *   Info structure output buffer.
288  */
289 int
290 mlx5_dev_infos_get(struct rte_eth_dev *dev, struct rte_eth_dev_info *info)
291 {
292 	struct mlx5_priv *priv = dev->data->dev_private;
293 	struct mlx5_dev_config *config = &priv->config;
294 	unsigned int max;
295 
296 	/* FIXME: we should ask the device for these values. */
297 	info->min_rx_bufsize = 32;
298 	info->max_rx_pktlen = 65536;
299 	info->max_lro_pkt_size = MLX5_MAX_LRO_SIZE;
300 	/*
301 	 * Since we need one CQ per QP, the limit is the minimum number
302 	 * between the two values.
303 	 */
304 	max = RTE_MIN(priv->sh->device_attr.max_cq,
305 		      priv->sh->device_attr.max_qp);
306 	/* max_rx_queues is uint16_t. */
307 	max = RTE_MIN(max, (unsigned int)UINT16_MAX);
308 	info->max_rx_queues = max;
309 	info->max_tx_queues = max;
310 	info->max_mac_addrs = MLX5_MAX_UC_MAC_ADDRESSES;
311 	info->rx_queue_offload_capa = mlx5_get_rx_queue_offloads(dev);
312 	info->rx_seg_capa.max_nseg = MLX5_MAX_RXQ_NSEG;
313 	info->rx_seg_capa.multi_pools = 1;
314 	info->rx_seg_capa.offset_allowed = 1;
315 	info->rx_seg_capa.offset_align_log2 = 0;
316 	info->rx_offload_capa = (mlx5_get_rx_port_offloads() |
317 				 info->rx_queue_offload_capa);
318 	info->tx_offload_capa = mlx5_get_tx_port_offloads(dev);
319 	info->if_index = mlx5_ifindex(dev);
320 	info->reta_size = priv->reta_idx_n ?
321 		priv->reta_idx_n : config->ind_table_max_size;
322 	info->hash_key_size = MLX5_RSS_HASH_KEY_LEN;
323 	info->speed_capa = priv->link_speed_capa;
324 	info->flow_type_rss_offloads = ~MLX5_RSS_HF_MASK;
325 	mlx5_set_default_params(dev, info);
326 	mlx5_set_txlimit_params(dev, info);
327 	info->switch_info.name = dev->data->name;
328 	info->switch_info.domain_id = priv->domain_id;
329 	info->switch_info.port_id = priv->representor_id;
330 	if (priv->representor) {
331 		uint16_t port_id;
332 
333 		if (priv->pf_bond >= 0) {
334 			/*
335 			 * Switch port ID is opaque value with driver defined
336 			 * format. Push the PF index in bonding configurations
337 			 * in upper four bits of port ID. If we get too many
338 			 * representors (more than 4K) or PFs (more than 15)
339 			 * this approach must be reconsidered.
340 			 */
341 			if ((info->switch_info.port_id >>
342 				MLX5_PORT_ID_BONDING_PF_SHIFT) ||
343 			    priv->pf_bond > MLX5_PORT_ID_BONDING_PF_MASK) {
344 				DRV_LOG(ERR, "can't update switch port ID"
345 					     " for bonding device");
346 				MLX5_ASSERT(false);
347 				return -ENODEV;
348 			}
349 			info->switch_info.port_id |=
350 				priv->pf_bond << MLX5_PORT_ID_BONDING_PF_SHIFT;
351 		}
352 		MLX5_ETH_FOREACH_DEV(port_id, priv->pci_dev) {
353 			struct mlx5_priv *opriv =
354 				rte_eth_devices[port_id].data->dev_private;
355 
356 			if (!opriv ||
357 			    opriv->representor ||
358 			    opriv->sh != priv->sh ||
359 			    opriv->domain_id != priv->domain_id)
360 				continue;
361 			/*
362 			 * Override switch name with that of the master
363 			 * device.
364 			 */
365 			info->switch_info.name = opriv->dev_data->name;
366 			break;
367 		}
368 	}
369 	return 0;
370 }
371 
372 /**
373  * Get firmware version of a device.
374  *
375  * @param dev
376  *   Ethernet device port.
377  * @param fw_ver
378  *   String output allocated by caller.
379  * @param fw_size
380  *   Size of the output string, including terminating null byte.
381  *
382  * @return
383  *   0 on success, or the size of the non truncated string if too big.
384  */
385 int
386 mlx5_fw_version_get(struct rte_eth_dev *dev, char *fw_ver, size_t fw_size)
387 {
388 	struct mlx5_priv *priv = dev->data->dev_private;
389 	struct mlx5_dev_attr *attr = &priv->sh->device_attr;
390 	size_t size = strnlen(attr->fw_ver, sizeof(attr->fw_ver)) + 1;
391 
392 	if (fw_size < size)
393 		return size;
394 	if (fw_ver != NULL)
395 		strlcpy(fw_ver, attr->fw_ver, fw_size);
396 	return 0;
397 }
398 
399 /**
400  * Get supported packet types.
401  *
402  * @param dev
403  *   Pointer to Ethernet device structure.
404  *
405  * @return
406  *   A pointer to the supported Packet types array.
407  */
408 const uint32_t *
409 mlx5_dev_supported_ptypes_get(struct rte_eth_dev *dev)
410 {
411 	static const uint32_t ptypes[] = {
412 		/* refers to rxq_cq_to_pkt_type() */
413 		RTE_PTYPE_L2_ETHER,
414 		RTE_PTYPE_L3_IPV4_EXT_UNKNOWN,
415 		RTE_PTYPE_L3_IPV6_EXT_UNKNOWN,
416 		RTE_PTYPE_L4_NONFRAG,
417 		RTE_PTYPE_L4_FRAG,
418 		RTE_PTYPE_L4_TCP,
419 		RTE_PTYPE_L4_UDP,
420 		RTE_PTYPE_INNER_L3_IPV4_EXT_UNKNOWN,
421 		RTE_PTYPE_INNER_L3_IPV6_EXT_UNKNOWN,
422 		RTE_PTYPE_INNER_L4_NONFRAG,
423 		RTE_PTYPE_INNER_L4_FRAG,
424 		RTE_PTYPE_INNER_L4_TCP,
425 		RTE_PTYPE_INNER_L4_UDP,
426 		RTE_PTYPE_UNKNOWN
427 	};
428 
429 	if (dev->rx_pkt_burst == mlx5_rx_burst ||
430 	    dev->rx_pkt_burst == mlx5_rx_burst_mprq ||
431 	    dev->rx_pkt_burst == mlx5_rx_burst_vec ||
432 	    dev->rx_pkt_burst == mlx5_rx_burst_mprq_vec)
433 		return ptypes;
434 	return NULL;
435 }
436 
437 /**
438  * DPDK callback to change the MTU.
439  *
440  * @param dev
441  *   Pointer to Ethernet device structure.
442  * @param in_mtu
443  *   New MTU.
444  *
445  * @return
446  *   0 on success, a negative errno value otherwise and rte_errno is set.
447  */
448 int
449 mlx5_dev_set_mtu(struct rte_eth_dev *dev, uint16_t mtu)
450 {
451 	struct mlx5_priv *priv = dev->data->dev_private;
452 	uint16_t kern_mtu = 0;
453 	int ret;
454 
455 	ret = mlx5_get_mtu(dev, &kern_mtu);
456 	if (ret)
457 		return ret;
458 	/* Set kernel interface MTU first. */
459 	ret = mlx5_set_mtu(dev, mtu);
460 	if (ret)
461 		return ret;
462 	ret = mlx5_get_mtu(dev, &kern_mtu);
463 	if (ret)
464 		return ret;
465 	if (kern_mtu == mtu) {
466 		priv->mtu = mtu;
467 		DRV_LOG(DEBUG, "port %u adapter MTU set to %u",
468 			dev->data->port_id, mtu);
469 		return 0;
470 	}
471 	rte_errno = EAGAIN;
472 	return -rte_errno;
473 }
474 
475 /**
476  * Configure the RX function to use.
477  *
478  * @param dev
479  *   Pointer to private data structure.
480  *
481  * @return
482  *   Pointer to selected Rx burst function.
483  */
484 eth_rx_burst_t
485 mlx5_select_rx_function(struct rte_eth_dev *dev)
486 {
487 	eth_rx_burst_t rx_pkt_burst = mlx5_rx_burst;
488 
489 	MLX5_ASSERT(dev != NULL);
490 	if (mlx5_check_vec_rx_support(dev) > 0) {
491 		if (mlx5_mprq_enabled(dev)) {
492 			rx_pkt_burst = mlx5_rx_burst_mprq_vec;
493 			DRV_LOG(DEBUG, "port %u selected vectorized"
494 				" MPRQ Rx function", dev->data->port_id);
495 		} else {
496 			rx_pkt_burst = mlx5_rx_burst_vec;
497 			DRV_LOG(DEBUG, "port %u selected vectorized"
498 				" SPRQ Rx function", dev->data->port_id);
499 		}
500 	} else if (mlx5_mprq_enabled(dev)) {
501 		rx_pkt_burst = mlx5_rx_burst_mprq;
502 		DRV_LOG(DEBUG, "port %u selected MPRQ Rx function",
503 			dev->data->port_id);
504 	} else {
505 		DRV_LOG(DEBUG, "port %u selected SPRQ Rx function",
506 			dev->data->port_id);
507 	}
508 	return rx_pkt_burst;
509 }
510 
511 /**
512  * Get the E-Switch parameters by port id.
513  *
514  * @param[in] port
515  *   Device port id.
516  * @param[in] valid
517  *   Device port id is valid, skip check. This flag is useful
518  *   when trials are performed from probing and device is not
519  *   flagged as valid yet (in attaching process).
520  * @param[out] es_domain_id
521  *   E-Switch domain id.
522  * @param[out] es_port_id
523  *   The port id of the port in the E-Switch.
524  *
525  * @return
526  *   pointer to device private data structure containing data needed
527  *   on success, NULL otherwise and rte_errno is set.
528  */
529 struct mlx5_priv *
530 mlx5_port_to_eswitch_info(uint16_t port, bool valid)
531 {
532 	struct rte_eth_dev *dev;
533 	struct mlx5_priv *priv;
534 
535 	if (port >= RTE_MAX_ETHPORTS) {
536 		rte_errno = EINVAL;
537 		return NULL;
538 	}
539 	if (!valid && !rte_eth_dev_is_valid_port(port)) {
540 		rte_errno = ENODEV;
541 		return NULL;
542 	}
543 	dev = &rte_eth_devices[port];
544 	priv = dev->data->dev_private;
545 	if (!(priv->representor || priv->master)) {
546 		rte_errno = EINVAL;
547 		return NULL;
548 	}
549 	return priv;
550 }
551 
552 /**
553  * Get the E-Switch parameters by device instance.
554  *
555  * @param[in] port
556  *   Device port id.
557  * @param[out] es_domain_id
558  *   E-Switch domain id.
559  * @param[out] es_port_id
560  *   The port id of the port in the E-Switch.
561  *
562  * @return
563  *   pointer to device private data structure containing data needed
564  *   on success, NULL otherwise and rte_errno is set.
565  */
566 struct mlx5_priv *
567 mlx5_dev_to_eswitch_info(struct rte_eth_dev *dev)
568 {
569 	struct mlx5_priv *priv;
570 
571 	priv = dev->data->dev_private;
572 	if (!(priv->representor || priv->master)) {
573 		rte_errno = EINVAL;
574 		return NULL;
575 	}
576 	return priv;
577 }
578 
579 /**
580  * DPDK callback to retrieve hairpin capabilities.
581  *
582  * @param dev
583  *   Pointer to Ethernet device structure.
584  * @param[out] cap
585  *   Storage for hairpin capability data.
586  *
587  * @return
588  *   0 on success, a negative errno value otherwise and rte_errno is set.
589  */
590 int
591 mlx5_hairpin_cap_get(struct rte_eth_dev *dev, struct rte_eth_hairpin_cap *cap)
592 {
593 	struct mlx5_priv *priv = dev->data->dev_private;
594 	struct mlx5_dev_config *config = &priv->config;
595 
596 	if (!priv->sh->devx || !config->dest_tir || !config->dv_flow_en) {
597 		rte_errno = ENOTSUP;
598 		return -rte_errno;
599 	}
600 	cap->max_nb_queues = UINT16_MAX;
601 	cap->max_rx_2_tx = 1;
602 	cap->max_tx_2_rx = 1;
603 	cap->max_nb_desc = 8192;
604 	return 0;
605 }
606