1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
2 /* Copyright (c) 2021, Microsoft Corporation. */
10 #include "hw_channel.h"
12 /* Microsoft Azure Network Adapter (MANA)'s definitions
14 * Structures labeled with "HW DATA" are exchanged with the hardware. All of
15 * them are naturally aligned and hence don't need __packed.
18 /* MANA protocol version */
19 #define MANA_MAJOR_VERSION 0
20 #define MANA_MINOR_VERSION 1
21 #define MANA_MICRO_VERSION 1
23 typedef u64 mana_handle_t;
24 #define INVALID_MANA_HANDLE ((mana_handle_t)-1)
27 TRI_STATE_UNKNOWN = -1,
32 /* Number of entries for hardware indirection table must be in power of 2 */
33 #define MANA_INDIRECT_TABLE_SIZE 64
34 #define MANA_INDIRECT_TABLE_MASK (MANA_INDIRECT_TABLE_SIZE - 1)
36 /* The Toeplitz hash key's length in bytes: should be multiple of 8 */
37 #define MANA_HASH_KEY_SIZE 40
39 #define COMP_ENTRY_SIZE 64
41 #define RX_BUFFERS_PER_QUEUE 512
42 #define MANA_RX_DATA_ALIGN 64
44 #define MAX_SEND_BUFFERS_PER_QUEUE 256
46 #define EQ_SIZE (8 * PAGE_SIZE)
47 #define LOG2_EQ_THROTTLE 3
49 #define MAX_PORTS_IN_MANA_DEV 256
51 /* Update this count whenever the respective structures are changed */
52 #define MANA_STATS_RX_COUNT 5
53 #define MANA_STATS_TX_COUNT 11
55 struct mana_stats_rx {
61 struct u64_stats_sync syncp;
64 struct mana_stats_tx {
70 u64 tso_inner_packets;
76 struct u64_stats_sync syncp;
80 struct gdma_queue *gdma_sq;
93 struct net_device *ndev;
95 /* The SKBs are sent to the HW and we are waiting for the CQEs. */
96 struct sk_buff_head pending_skbs;
97 struct netdev_queue *net_txq;
99 atomic_t pending_sends;
101 struct mana_stats_tx stats;
104 /* skb data and frags dma mappings */
105 struct mana_skb_head {
106 dma_addr_t dma_handle[MAX_SKB_FRAGS + 1];
108 u32 size[MAX_SKB_FRAGS + 1];
111 #define MANA_HEADROOM sizeof(struct mana_skb_head)
113 enum mana_tx_pkt_format {
114 MANA_SHORT_PKT_FMT = 0,
115 MANA_LONG_PKT_FMT = 1,
118 struct mana_tx_short_oob {
120 u32 is_outer_ipv4 : 1;
121 u32 is_outer_ipv6 : 1;
122 u32 comp_iphdr_csum : 1;
123 u32 comp_tcp_csum : 1;
124 u32 comp_udp_csum : 1;
125 u32 supress_txcqe_gen : 1;
128 u32 trans_off : 10; /* Transport header offset */
130 u32 short_vp_offset : 8;
133 struct mana_tx_long_oob {
135 u32 inner_is_ipv6 : 1;
136 u32 inner_tcp_opt : 1;
137 u32 inject_vlan_pri_tag : 1;
139 u32 pcp : 3; /* 802.1Q */
140 u32 dei : 1; /* 802.1Q */
141 u32 vlan_id : 12; /* 802.1Q */
143 u32 inner_frame_offset : 10;
144 u32 inner_ip_rel_offset : 6;
145 u32 long_vp_offset : 12;
153 struct mana_tx_short_oob s_oob;
154 struct mana_tx_long_oob l_oob;
165 CQE_RX_COALESCED_4 = 2,
166 CQE_RX_OBJECT_FENCE = 3,
167 CQE_RX_TRUNCATED = 4,
171 CQE_TX_MTU_DROP = 34,
172 CQE_TX_INVALID_OOB = 35,
173 CQE_TX_INVALID_ETH_TYPE = 36,
174 CQE_TX_HDR_PROCESSING_ERROR = 37,
175 CQE_TX_VF_DISABLED = 38,
176 CQE_TX_VPORT_IDX_OUT_OF_RANGE = 39,
177 CQE_TX_VPORT_DISABLED = 40,
178 CQE_TX_VLAN_TAGGING_VIOLATION = 41,
181 #define MANA_CQE_COMPLETION 1
183 struct mana_cqe_header {
189 /* NDIS HASH Types */
190 #define NDIS_HASH_IPV4 BIT(0)
191 #define NDIS_HASH_TCP_IPV4 BIT(1)
192 #define NDIS_HASH_UDP_IPV4 BIT(2)
193 #define NDIS_HASH_IPV6 BIT(3)
194 #define NDIS_HASH_TCP_IPV6 BIT(4)
195 #define NDIS_HASH_UDP_IPV6 BIT(5)
196 #define NDIS_HASH_IPV6_EX BIT(6)
197 #define NDIS_HASH_TCP_IPV6_EX BIT(7)
198 #define NDIS_HASH_UDP_IPV6_EX BIT(8)
200 #define MANA_HASH_L3 (NDIS_HASH_IPV4 | NDIS_HASH_IPV6 | NDIS_HASH_IPV6_EX)
201 #define MANA_HASH_L4 \
202 (NDIS_HASH_TCP_IPV4 | NDIS_HASH_UDP_IPV4 | NDIS_HASH_TCP_IPV6 | \
203 NDIS_HASH_UDP_IPV6 | NDIS_HASH_TCP_IPV6_EX | NDIS_HASH_UDP_IPV6_EX)
205 struct mana_rxcomp_perpkt_info {
212 #define MANA_RXCOMP_OOB_NUM_PPI 4
214 /* Receive completion OOB */
215 struct mana_rxcomp_oob {
216 struct mana_cqe_header cqe_hdr;
219 u32 rx_vlantag_present : 1;
220 u32 rx_outer_iphdr_csum_succeed : 1;
221 u32 rx_outer_iphdr_csum_fail : 1;
224 u32 rx_iphdr_csum_succeed : 1;
225 u32 rx_iphdr_csum_fail : 1;
226 u32 rx_tcp_csum_succeed : 1;
227 u32 rx_tcp_csum_fail : 1;
228 u32 rx_udp_csum_succeed : 1;
229 u32 rx_udp_csum_fail : 1;
232 struct mana_rxcomp_perpkt_info ppi[MANA_RXCOMP_OOB_NUM_PPI];
237 struct mana_tx_comp_oob {
238 struct mana_cqe_header cqe_hdr;
242 u32 tx_sgl_offset : 5;
243 u32 tx_wqe_offset : 27;
250 #define CQE_POLLING_BUFFER 512
253 struct gdma_queue *gdma_cq;
255 /* Cache the CQ id (used to verify if each CQE comes to the right CQ. */
258 /* Type of the CQ: TX or RX */
259 enum mana_cq_type type;
261 /* Pointer to the mana_rxq that is pushing RX CQEs to the queue.
262 * Only and must be non-NULL if type is MANA_CQ_TYPE_RX.
264 struct mana_rxq *rxq;
266 /* Pointer to the mana_txq that is pushing TX CQEs to the queue.
267 * Only and must be non-NULL if type is MANA_CQ_TYPE_TX.
269 struct mana_txq *txq;
271 /* Buffer which the CQ handler can copy the CQE's into. */
272 struct gdma_comp gdma_comp_buf[CQE_POLLING_BUFFER];
275 struct napi_struct napi;
280 struct mana_recv_buf_oob {
281 /* A valid GDMA work request representing the data buffer. */
282 struct gdma_wqe_request wqe_req;
285 bool from_pool; /* allocated from a page pool */
287 /* SGL of the buffer going to be sent has part of the work request. */
289 struct gdma_sge sgl[MAX_RX_WQE_SGL_ENTRIES];
291 /* Required to store the result of mana_gd_post_work_request.
292 * gdma_posted_wqe_info.wqe_size_in_bu is required for progressing the
293 * work queue when the WQE is consumed.
295 struct gdma_posted_wqe_info wqe_inf;
298 #define MANA_RXBUF_PAD (SKB_DATA_ALIGN(sizeof(struct skb_shared_info)) \
301 #define MANA_XDP_MTU_MAX (PAGE_SIZE - MANA_RXBUF_PAD - XDP_PACKET_HEADROOM)
304 struct gdma_queue *gdma_rq;
305 /* Cache the gdma receive queue id */
308 /* Index of RQ in the vPort, not gdma receive queue id */
317 struct mana_cq rx_cq;
319 struct completion fence_event;
321 struct net_device *ndev;
323 /* Total number of receive buffers to be allocated */
328 struct mana_stats_rx stats;
330 struct bpf_prog __rcu *bpf_prog;
331 struct xdp_rxq_info xdp_rxq;
332 void *xdp_save_va; /* for reusing */
334 int xdp_rc; /* XDP redirect return code */
336 struct page_pool *page_pool;
338 /* MUST BE THE LAST MEMBER:
339 * Each receive buffer has an associated mana_recv_buf_oob.
341 struct mana_recv_buf_oob rx_oobs[];
347 struct mana_cq tx_cq;
349 mana_handle_t tx_object;
352 struct mana_ethtool_stats {
356 u64 hc_tx_ucast_pkts;
357 u64 hc_tx_ucast_bytes;
358 u64 hc_tx_bcast_pkts;
359 u64 hc_tx_bcast_bytes;
360 u64 hc_tx_mcast_pkts;
361 u64 hc_tx_mcast_bytes;
363 u64 tx_cqe_unknown_type;
364 u64 rx_coalesced_err;
365 u64 rx_cqe_unknown_type;
368 struct mana_context {
369 struct gdma_dev *gdma_dev;
375 struct net_device *ports[MAX_PORTS_IN_MANA_DEV];
378 struct mana_port_context {
379 struct mana_context *ac;
380 struct net_device *ndev;
382 u8 mac_addr[ETH_ALEN];
384 enum TRI_STATE rss_state;
386 mana_handle_t default_rxobj;
387 bool tx_shortform_allowed;
390 struct mana_tx_qp *tx_qp;
392 /* Indirection Table for RX & TX. The values are queue indexes */
393 u32 indir_table[MANA_INDIRECT_TABLE_SIZE];
395 /* Indirection table containing RxObject Handles */
396 mana_handle_t rxobj_table[MANA_INDIRECT_TABLE_SIZE];
398 /* Hash key used by the NIC */
399 u8 hashkey[MANA_HASH_KEY_SIZE];
401 /* This points to an array of num_queues of RQ pointers. */
402 struct mana_rxq **rxqs;
404 /* pre-allocated rx buffer array */
409 u32 rxbpre_alloc_size;
412 struct bpf_prog *bpf_prog;
414 /* Create num_queues EQs, SQs, SQ-CQs, RQs and RQ-CQs, respectively. */
415 unsigned int max_queues;
416 unsigned int num_queues;
418 mana_handle_t port_handle;
419 mana_handle_t pf_filter_handle;
421 /* Mutex for sharing access to vport_use_count */
422 struct mutex vport_mutex;
428 bool port_st_save; /* Saved port state */
430 struct mana_ethtool_stats eth_stats;
433 netdev_tx_t mana_start_xmit(struct sk_buff *skb, struct net_device *ndev);
434 int mana_config_rss(struct mana_port_context *ac, enum TRI_STATE rx,
435 bool update_hash, bool update_tab);
437 int mana_alloc_queues(struct net_device *ndev);
438 int mana_attach(struct net_device *ndev);
439 int mana_detach(struct net_device *ndev, bool from_close);
441 int mana_probe(struct gdma_dev *gd, bool resuming);
442 void mana_remove(struct gdma_dev *gd, bool suspending);
444 void mana_xdp_tx(struct sk_buff *skb, struct net_device *ndev);
445 int mana_xdp_xmit(struct net_device *ndev, int n, struct xdp_frame **frames,
447 u32 mana_run_xdp(struct net_device *ndev, struct mana_rxq *rxq,
448 struct xdp_buff *xdp, void *buf_va, uint pkt_len);
449 struct bpf_prog *mana_xdp_get(struct mana_port_context *apc);
450 void mana_chn_setxdp(struct mana_port_context *apc, struct bpf_prog *prog);
451 int mana_bpf(struct net_device *ndev, struct netdev_bpf *bpf);
452 void mana_query_gf_stats(struct mana_port_context *apc);
454 extern const struct ethtool_ops mana_ethtool_ops;
456 /* A CQ can be created not associated with any EQ */
457 #define GDMA_CQ_NO_EQ 0xffff
459 struct mana_obj_spec {
467 enum mana_command_code {
468 MANA_QUERY_DEV_CONFIG = 0x20001,
469 MANA_QUERY_GF_STAT = 0x20002,
470 MANA_CONFIG_VPORT_TX = 0x20003,
471 MANA_CREATE_WQ_OBJ = 0x20004,
472 MANA_DESTROY_WQ_OBJ = 0x20005,
473 MANA_FENCE_RQ = 0x20006,
474 MANA_CONFIG_VPORT_RX = 0x20007,
475 MANA_QUERY_VPORT_CONFIG = 0x20008,
477 /* Privileged commands for the PF mode */
478 MANA_REGISTER_FILTER = 0x28000,
479 MANA_DEREGISTER_FILTER = 0x28001,
480 MANA_REGISTER_HW_PORT = 0x28003,
481 MANA_DEREGISTER_HW_PORT = 0x28004,
484 /* Query Device Configuration */
485 struct mana_query_device_cfg_req {
486 struct gdma_req_hdr hdr;
488 /* MANA Nic Driver Capability flags */
489 u64 mn_drv_cap_flags1;
490 u64 mn_drv_cap_flags2;
491 u64 mn_drv_cap_flags3;
492 u64 mn_drv_cap_flags4;
501 struct mana_query_device_cfg_resp {
502 struct gdma_resp_hdr hdr;
519 /* Query vPort Configuration */
520 struct mana_query_vport_cfg_req {
521 struct gdma_req_hdr hdr;
525 struct mana_query_vport_cfg_resp {
526 struct gdma_resp_hdr hdr;
529 u32 num_indirection_ent;
536 /* Configure vPort */
537 struct mana_config_vport_req {
538 struct gdma_req_hdr hdr;
544 struct mana_config_vport_resp {
545 struct gdma_resp_hdr hdr;
547 u8 short_form_allowed;
551 /* Create WQ Object */
552 struct mana_create_wqobj_req {
553 struct gdma_req_hdr hdr;
561 u32 cq_moderation_ctx_id;
565 struct mana_create_wqobj_resp {
566 struct gdma_resp_hdr hdr;
569 mana_handle_t wq_obj;
572 /* Destroy WQ Object */
573 struct mana_destroy_wqobj_req {
574 struct gdma_req_hdr hdr;
577 mana_handle_t wq_obj_handle;
580 struct mana_destroy_wqobj_resp {
581 struct gdma_resp_hdr hdr;
585 struct mana_fence_rq_req {
586 struct gdma_req_hdr hdr;
587 mana_handle_t wq_obj_handle;
590 struct mana_fence_rq_resp {
591 struct gdma_resp_hdr hdr;
595 struct mana_query_gf_stat_req {
596 struct gdma_req_hdr hdr;
600 struct mana_query_gf_stat_resp {
601 struct gdma_resp_hdr hdr;
603 /* rx errors/discards */
604 u64 discard_rx_nowqe;
605 u64 err_rx_vport_disabled;
606 /* rx bytes/packets */
608 u64 hc_rx_ucast_pkts;
609 u64 hc_rx_ucast_bytes;
610 u64 hc_rx_bcast_pkts;
611 u64 hc_rx_bcast_bytes;
612 u64 hc_rx_mcast_pkts;
613 u64 hc_rx_mcast_bytes;
615 u64 err_tx_gf_disabled;
616 u64 err_tx_vport_disabled;
617 u64 err_tx_inval_vport_offset_pkt;
618 u64 err_tx_vlan_enforcement;
619 u64 err_tx_ethtype_enforcement;
620 u64 err_tx_SA_enforecement;
621 u64 err_tx_SQPDID_enforcement;
622 u64 err_tx_CQPDID_enforcement;
623 u64 err_tx_mtu_violation;
624 u64 err_tx_inval_oob;
625 /* tx bytes/packets */
627 u64 hc_tx_ucast_pkts;
628 u64 hc_tx_ucast_bytes;
629 u64 hc_tx_bcast_pkts;
630 u64 hc_tx_bcast_bytes;
631 u64 hc_tx_mcast_pkts;
632 u64 hc_tx_mcast_bytes;
637 /* Configure vPort Rx Steering */
638 struct mana_cfg_rx_steer_req_v2 {
639 struct gdma_req_hdr hdr;
641 u16 num_indir_entries;
642 u16 indir_tab_offset;
645 u8 update_default_rxobj;
649 mana_handle_t default_rxobj;
650 u8 hashkey[MANA_HASH_KEY_SIZE];
651 u8 cqe_coalescing_enable;
655 struct mana_cfg_rx_steer_resp {
656 struct gdma_resp_hdr hdr;
659 /* Register HW vPort */
660 struct mana_register_hw_vport_req {
661 struct gdma_req_hdr hdr;
663 u8 is_pf_default_vport;
665 u8 allow_all_ether_types;
671 struct mana_register_hw_vport_resp {
672 struct gdma_resp_hdr hdr;
673 mana_handle_t hw_vport_handle;
676 /* Deregister HW vPort */
677 struct mana_deregister_hw_vport_req {
678 struct gdma_req_hdr hdr;
679 mana_handle_t hw_vport_handle;
682 struct mana_deregister_hw_vport_resp {
683 struct gdma_resp_hdr hdr;
686 /* Register filter */
687 struct mana_register_filter_req {
688 struct gdma_req_hdr hdr;
701 struct mana_register_filter_resp {
702 struct gdma_resp_hdr hdr;
703 mana_handle_t filter_handle;
706 /* Deregister filter */
707 struct mana_deregister_filter_req {
708 struct gdma_req_hdr hdr;
709 mana_handle_t filter_handle;
712 struct mana_deregister_filter_resp {
713 struct gdma_resp_hdr hdr;
716 /* Requested GF stats Flags */
717 /* Rx discards/Errors */
718 #define STATISTICS_FLAGS_RX_DISCARDS_NO_WQE 0x0000000000000001
719 #define STATISTICS_FLAGS_RX_ERRORS_VPORT_DISABLED 0x0000000000000002
721 #define STATISTICS_FLAGS_HC_RX_BYTES 0x0000000000000004
722 #define STATISTICS_FLAGS_HC_RX_UCAST_PACKETS 0x0000000000000008
723 #define STATISTICS_FLAGS_HC_RX_UCAST_BYTES 0x0000000000000010
724 #define STATISTICS_FLAGS_HC_RX_MCAST_PACKETS 0x0000000000000020
725 #define STATISTICS_FLAGS_HC_RX_MCAST_BYTES 0x0000000000000040
726 #define STATISTICS_FLAGS_HC_RX_BCAST_PACKETS 0x0000000000000080
727 #define STATISTICS_FLAGS_HC_RX_BCAST_BYTES 0x0000000000000100
729 #define STATISTICS_FLAGS_TX_ERRORS_GF_DISABLED 0x0000000000000200
730 #define STATISTICS_FLAGS_TX_ERRORS_VPORT_DISABLED 0x0000000000000400
731 #define STATISTICS_FLAGS_TX_ERRORS_INVAL_VPORT_OFFSET_PACKETS \
733 #define STATISTICS_FLAGS_TX_ERRORS_VLAN_ENFORCEMENT 0x0000000000001000
734 #define STATISTICS_FLAGS_TX_ERRORS_ETH_TYPE_ENFORCEMENT \
736 #define STATISTICS_FLAGS_TX_ERRORS_SA_ENFORCEMENT 0x0000000000004000
737 #define STATISTICS_FLAGS_TX_ERRORS_SQPDID_ENFORCEMENT 0x0000000000008000
738 #define STATISTICS_FLAGS_TX_ERRORS_CQPDID_ENFORCEMENT 0x0000000000010000
739 #define STATISTICS_FLAGS_TX_ERRORS_MTU_VIOLATION 0x0000000000020000
740 #define STATISTICS_FLAGS_TX_ERRORS_INVALID_OOB 0x0000000000040000
742 #define STATISTICS_FLAGS_HC_TX_BYTES 0x0000000000080000
743 #define STATISTICS_FLAGS_HC_TX_UCAST_PACKETS 0x0000000000100000
744 #define STATISTICS_FLAGS_HC_TX_UCAST_BYTES 0x0000000000200000
745 #define STATISTICS_FLAGS_HC_TX_MCAST_PACKETS 0x0000000000400000
746 #define STATISTICS_FLAGS_HC_TX_MCAST_BYTES 0x0000000000800000
747 #define STATISTICS_FLAGS_HC_TX_BCAST_PACKETS 0x0000000001000000
748 #define STATISTICS_FLAGS_HC_TX_BCAST_BYTES 0x0000000002000000
750 #define STATISTICS_FLAGS_TX_ERRORS_GDMA_ERROR 0x0000000004000000
752 #define MANA_MAX_NUM_QUEUES 64
754 #define MANA_SHORT_VPORT_OFFSET_MAX ((1U << 8) - 1)
756 struct mana_tx_package {
757 struct gdma_wqe_request wqe_req;
758 struct gdma_sge sgl_array[5];
759 struct gdma_sge *sgl_ptr;
761 struct mana_tx_oob tx_oob;
763 struct gdma_posted_wqe_info wqe_info;
766 int mana_create_wq_obj(struct mana_port_context *apc,
768 u32 wq_type, struct mana_obj_spec *wq_spec,
769 struct mana_obj_spec *cq_spec,
770 mana_handle_t *wq_obj);
772 void mana_destroy_wq_obj(struct mana_port_context *apc, u32 wq_type,
773 mana_handle_t wq_obj);
775 int mana_cfg_vport(struct mana_port_context *apc, u32 protection_dom_id,
777 void mana_uncfg_vport(struct mana_port_context *apc);