intel/idpf/idpf.h

1 /* SPDX-License-Identifier: GPL-2.0-only */
25 #define GETMAXVAL(num_bits)		GENMASK((num_bits) - 1, 0)
31 #define IDPF_NUM_DFLT_MBX_Q		2	/* includes both TX and RX */
33 #define IDPF_DFLT_MBX_ID		-1
34 /* maximum number of times to try before resetting mailbox */
37 	((IDPF_CTLQ_MAX_BUF_LEN - (struct_sz)) / (chunk_sz))
64  * enum idpf_state - State machine to handle bring up
68  * @__IDPF_STATE_LAST: Must be last, used to determine size
78  * enum idpf_flags - Hard reset causes.
98  * enum idpf_cap_field - Offsets into capabilities struct for specific caps
112 	IDPF_BASE_CAPS		= -1,
128  * enum idpf_vport_state - Current vport state
140  * struct idpf_netdev_priv - Struct to store vport back pointer
148  * @stats_lock: Lock to protect stats update
162  * struct idpf_reset_reg - Reset register offsets/masks
172  * struct idpf_vport_max_q - Queue limits
173  * @max_rxq: Maximum number of RX queues supported
174  * @max_txq: Maixmum number of TX queues supported
175  * @max_bufq: In splitq, maximum number of buffer queues supported
176  * @max_complq: In splitq, maximum number of completion queues supported
186  * struct idpf_reg_ops - Device specific register operation function pointers
191  * @trigger_reset: Trigger a reset to occur
203  * struct idpf_dev_ops - Device specific operations
211  * enum idpf_vport_reset_cause - Vport soft reset causes
225  * enum idpf_vport_flags - Vport flags
226  * @IDPF_VPORT_DEL_QUEUES: To send delete queues message
227  * @IDPF_VPORT_SW_MARKER: Indicate TX pipe drain software marker packets
251  * struct idpf_vport - Handle for netdevices and queue resources
252  * @num_txq: Number of allocated TX queues
253  * @num_complq: Number of allocated completion queues
254  * @txq_desc_count: TX queue descriptor count
257  * @num_txq_grp: Number of TX queue groups
258  * @txq_grps: Array of TX queue groups
260  * @txqs: Used only in hotpath to get to the right queue very fast
262  * @num_rxq: Number of allocated RX queues
263  * @num_bufq: Number of allocated buffer queues
265  *		    to complete all buffer descriptors for all buffer queues in
267  * @num_bufqs_per_qgrp: Buffer queues per RX queue in a given grouping
269  * @num_rxq_grp: Number of RX queues in a group
271  *	      group will yield total number of RX queues.
274  * @adapter: back pointer to associated adapter
281  * @default_vport: Use this vport if one isn't specified
282  * @base_rxd: True if the driver should use base descriptors instead of flex
287  * @default_mac_addr: device will give a default MAC to use
289  * @tx_itr_profile: TX profiles for Dynamic Interrupt Moderation
355  * struct idpf_rss_data - Associated RSS data
360  * @cached_lut: Used to restore previously init RSS lut
371  * struct idpf_vport_user_config_data - User defined configuration values for
374  * @num_req_tx_qs: Number of user requested TX queues through ethtool
375  * @num_req_rx_qs: Number of user requested RX queues through ethtool
376  * @num_req_txq_desc: Number of user requested TX queue descriptors through
383  * Used to restore configuration after a reset as the vport will get wiped.
396  * enum idpf_vport_config_flags - Vport config flags
409  * @avail_rxq: Available RX queues
410  * @avail_txq: Available TX queues
411  * @avail_bufq: Available buffer queues
412  * @avail_complq: Available completion queues
414  * Maintain total queues available after allocating max queues to each vport.
424  * struct idpf_vector_info - Utility structure to pass function arguments as a
426  * @num_req_vecs: Vectors required based on the number of queues updated by the
440  * struct idpf_vector_lifo - Stack to maintain vector indexes used for vector
442  * @top: Points to stack top i.e. next available vector index
443  * @base: Always points to start of the free pool
445  * @vec_idx: Array to store all the vector indexes
450  * gives priority to default vports in a way that at least IDPF_MIN_Q_VEC
453  * vector indexes which can be allocated on-demand basis. Mailbox vector index
464  * struct idpf_vport_config - Vport configuration data
466  * @max_q: Maximum possible queues
467  * @req_qs_chunks: Queue chunk data for requested queues
468  * @mac_filter_list_lock: Lock to protect mac filters
482  * struct idpf_adapter - Device data struct generated on probe
498  * @vector_stack: Stack to store the msix vector indexes
500  * @tx_timeout_count: Number of TX timeouts that have occurred
502  * @vports: Array to store vports created by the driver
510  * @next_vport: Next free slot in pf->vport[] - 0-based!
515  * @mbx_task: Task to handle mailbox interrupts
517  * @vc_event_task: Task to handle out of band virtchnl event notifications
525  *	     to VFs but is used to initialize them
527  * @req_tx_splitq: TX split or single queue model to request
528  * @req_rx_splitq: RX split or single queue model to request
529  * @vport_ctrl_lock: Lock to protect the vport control flow
530  * @vector_lock: Lock to protect vector distribution
531  * @queue_lock: Lock to protect queue distribution
532  * @vc_buf_lock: Lock to protect virtchnl buffer
593  * idpf_is_queue_model_split - check if queue model is split
658  * idpf_get_reserved_vecs - Get reserved vectors
663 	return le16_to_cpu(adapter->caps.num_allocated_vectors);  in idpf_get_reserved_vecs()
667  * idpf_get_default_vports - Get default number of vports
672 	return le16_to_cpu(adapter->caps.default_num_vports);  in idpf_get_default_vports()
676  * idpf_get_max_vports - Get max number of vports
681 	return le16_to_cpu(adapter->caps.max_vports);  in idpf_get_max_vports()
685  * idpf_get_max_tx_bufs - Get max scatter-gather buffers supported by the device
690 	return adapter->caps.max_sg_bufs_per_tx_pkt;  in idpf_get_max_tx_bufs()
694  * idpf_get_min_tx_pkt_len - Get min packet length supported by the device
699 	u8 pkt_len = adapter->caps.min_sso_packet_len;  in idpf_get_min_tx_pkt_len()
705  * idpf_get_reg_addr - Get BAR0 register address
714 	return (void __iomem *)(adapter->hw.hw_addr + reg_offset);  in idpf_get_reg_addr()
718  * idpf_is_reset_detected - check if we were reset at some point
725 	if (!adapter->hw.arq)  in idpf_is_reset_detected()
728 	return !(readl(idpf_get_reg_addr(adapter, adapter->hw.arq->reg.len)) &  in idpf_is_reset_detected()
729 		 adapter->hw.arq->reg.len_mask);  in idpf_is_reset_detected()
733  * idpf_is_reset_in_prog - check if reset is in progress
740 	return (test_bit(IDPF_HR_RESET_IN_PROG, adapter->flags) ||  in idpf_is_reset_in_prog()
741 		test_bit(IDPF_HR_FUNC_RESET, adapter->flags) ||  in idpf_is_reset_in_prog()
742 		test_bit(IDPF_HR_DRV_LOAD, adapter->flags));  in idpf_is_reset_in_prog()
746  * idpf_netdev_to_vport - get a vport handle from a netdev
753 	return np->vport;  in idpf_netdev_to_vport()
757  * idpf_netdev_to_adapter - Get adapter handle from a netdev
764 	return np->adapter;  in idpf_netdev_to_adapter()
768  * idpf_is_feature_ena - Determine if a particular feature is enabled
769  * @vport: Vport to check
770  * @feature: Netdev flag to check
777 	return vport->netdev->features & feature;  in idpf_is_feature_ena()
781  * idpf_get_max_tx_hdr_size -- get the size of tx header
786 	return le16_to_cpu(adapter->caps.max_tx_hdr_size);  in idpf_get_max_tx_hdr_size()
790  * idpf_vport_ctrl_lock - Acquire the vport control lock
793  * This lock should be used by non-datapath code to protect against vport
800 	mutex_lock(&np->adapter->vport_ctrl_lock);  in idpf_vport_ctrl_lock()
804  * idpf_vport_ctrl_unlock - Release the vport control lock
811 	mutex_unlock(&np->adapter->vport_ctrl_lock);  in idpf_vport_ctrl_unlock()
832 			       u16 itr, bool tx);