ralink/rt2x00/rt2x00queue.h

1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 	Copyright (C) 2004 - 2010 Ivo van Doorn <IvDoorn@gmail.com>
42  * @QID_OTHER: None of the above (don't use, only present for completeness)
63  * @SKBDESC_DMA_MAPPED_TX: &skb_dma field has been mapped for TX
87  * @tx_rate_idx: the index of the TX rate, used for TX status reporting
88  * @tx_rate_flags: the TX rate flags, used for TX status reporting
91  *	of the scope of the skb->data pointer.
93  * @skb_dma: (PCI-only) the DMA address associated with the sk buffer.
112  * get_skb_frame_desc - Obtain the rt2x00 frame descriptor from a sk_buff.
119 	return (struct skb_frame_desc *)&IEEE80211_SKB_CB(skb)->driver_data;  in get_skb_frame_desc()
131  * @RXDONE_L2PAD: 802.11 payload has been padded to 4-byte boundary.
144  * RXDONE_SIGNAL_MASK - Define to mask off all &rxdone_entry_desc_flags flags
192  * conjunction with all of these flags but should only be set
193  * if retires > 0. The flag &TXDONE_EXCESSIVE_RETRY can only be used
214  * struct txdone_entry_desc: TX done entry descriptor
216  * Summary of information that has been read from the TX frame descriptor
219  * @flags: TX done flags (See &enum txdone_entry_desc_flags).
228  * enum txentry_desc_flags: Status flags for TX entry descriptor
231  * @ENTRY_TXD_CTS_FRAME: This frame is a CTS-to-self frame.
269  * struct txentry_desc: TX Entry descriptor
271  * Summary of information for the frame descriptor before sending a TX frame.
281  * @stbc: Use Space Time Block Coding (only available for MCS rates < 8).
282  * @ba_size: Size of the recepients RX reorder buffer - 1.
332  *	As long as this bit is set, this entry may only be touched
335  *	transfer (either TX or RX depending on the queue). The entry should
336  *	only be touched after the device has signaled it is done with it.
340  *	while transferring the data to the hardware. No TX status report will
361  * @skb: The buffer which is currently being transmitted (for TX queue),
405  *	device might be DMA'ing skbuffers. TX queues will accept skbuffers to
428  * @tx_lock: Spinlock to serialize tx operations on this queue.
447  * @priv_size: Size of per-queue_entry private data.
448  * @usb_endpoint: Device endpoint used for communication (USB only)
449  * @usb_maxpacket: Max packet size for given endpoint (USB only)
486  * queue_end - Return pointer to the last queue (HELPER MACRO).
494 	&(__dev)->rx[(__dev)->data_queues]
497  * tx_queue_end - Return pointer to the last TX queue (HELPER MACRO).
500  * Using the base tx pointer and the maximum number of available TX
502  * the end of the TX queue array.
505 	&(__dev)->tx[(__dev)->ops->tx_queues]
508  * queue_next - Return pointer to next queue in list (HELPER MACRO).
521  * queue_loop - Loop through the queues within a specific range (HELPER MACRO).
534  * queue_for_each - Loop through all queues
541 	queue_loop(__entry, (__dev)->rx, queue_end(__dev))
544  * tx_queue_for_each - Loop through the TX queues
548  * This macro will loop through all TX related queues excluding
552 	queue_loop(__entry, (__dev)->tx, tx_queue_end(__dev))
555  * txall_queue_for_each - Loop through all TX related queues
559  * This macro will loop through all TX related queues including
563 	queue_loop(__entry, (__dev)->tx, queue_end(__dev))
566  * rt2x00queue_for_each_entry - Loop through all entries in the queue
588  * rt2x00queue_empty - Check if the queue is empty.
593 	return queue->length == 0;  in rt2x00queue_empty()
597  * rt2x00queue_full - Check if the queue is full.
602 	return queue->length == queue->limit;  in rt2x00queue_full()
606  * rt2x00queue_free - Check the number of available entries in queue.
611 	return queue->limit - queue->length;  in rt2x00queue_available()
615  * rt2x00queue_threshold - Check if the queue is below threshold
620 	return rt2x00queue_available(queue) < queue->threshold;  in rt2x00queue_threshold()
623  * rt2x00queue_dma_timeout - Check if a timeout occurred for DMA transfers
628 	if (!test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))  in rt2x00queue_dma_timeout()
630 	return time_after(jiffies, entry->last_action + msecs_to_jiffies(100));  in rt2x00queue_dma_timeout()
634  * _rt2x00_desc_read - Read a word from the hardware descriptor.
644  * rt2x00_desc_read - Read a word from the hardware descriptor, this
655  * rt2x00_desc_write - write a word to the hardware descriptor, this
667  * rt2x00_desc_write - write a word to the hardware descriptor.