xref: /freebsd/sys/contrib/dev/rtw88/tx.h (revision f5f40dd63bc7acbb5312b26ac1ea1103c12352a6)
1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
2 /* Copyright(c) 2018-2019  Realtek Corporation
3  */
4 
5 #ifndef __RTW_TX_H_
6 #define __RTW_TX_H_
7 
8 #define RTK_TX_MAX_AGG_NUM_MASK		0x1f
9 
10 #define RTW_TX_PROBE_TIMEOUT		msecs_to_jiffies(500)
11 
12 struct rtw_tx_desc {
13 	__le32 w0;
14 	__le32 w1;
15 	__le32 w2;
16 	__le32 w3;
17 	__le32 w4;
18 	__le32 w5;
19 	__le32 w6;
20 	__le32 w7;
21 	__le32 w8;
22 	__le32 w9;
23 } __packed;
24 
25 #define RTW_TX_DESC_W0_TXPKTSIZE GENMASK(15, 0)
26 #define RTW_TX_DESC_W0_OFFSET GENMASK(23, 16)
27 #define RTW_TX_DESC_W0_BMC BIT(24)
28 #define RTW_TX_DESC_W0_LS BIT(26)
29 #define RTW_TX_DESC_W0_DISQSELSEQ BIT(31)
30 #define RTW_TX_DESC_W1_QSEL GENMASK(12, 8)
31 #define RTW_TX_DESC_W1_RATE_ID GENMASK(20, 16)
32 #define RTW_TX_DESC_W1_SEC_TYPE GENMASK(23, 22)
33 #define RTW_TX_DESC_W1_PKT_OFFSET GENMASK(28, 24)
34 #define RTW_TX_DESC_W1_MORE_DATA BIT(29)
35 #define RTW_TX_DESC_W2_AGG_EN BIT(12)
36 #define RTW_TX_DESC_W2_SPE_RPT BIT(19)
37 #define RTW_TX_DESC_W2_AMPDU_DEN GENMASK(22, 20)
38 #define RTW_TX_DESC_W2_BT_NULL BIT(23)
39 #define RTW_TX_DESC_W3_HW_SSN_SEL GENMASK(7, 6)
40 #define RTW_TX_DESC_W3_USE_RATE BIT(8)
41 #define RTW_TX_DESC_W3_DISDATAFB BIT(10)
42 #define RTW_TX_DESC_W3_USE_RTS BIT(12)
43 #define RTW_TX_DESC_W3_NAVUSEHDR BIT(15)
44 #define RTW_TX_DESC_W3_MAX_AGG_NUM GENMASK(21, 17)
45 #define RTW_TX_DESC_W4_DATARATE GENMASK(6, 0)
46 #define RTW_TX_DESC_W4_RTSRATE GENMASK(28, 24)
47 #define RTW_TX_DESC_W5_DATA_SHORT BIT(4)
48 #define RTW_TX_DESC_W5_DATA_BW GENMASK(6, 5)
49 #define RTW_TX_DESC_W5_DATA_LDPC BIT(7)
50 #define RTW_TX_DESC_W5_DATA_STBC GENMASK(9, 8)
51 #define RTW_TX_DESC_W5_DATA_RTS_SHORT BIT(12)
52 #define RTW_TX_DESC_W6_SW_DEFINE GENMASK(11, 0)
53 #define RTW_TX_DESC_W7_TXDESC_CHECKSUM GENMASK(15, 0)
54 #define RTW_TX_DESC_W7_DMA_TXAGG_NUM GENMASK(31, 24)
55 #define RTW_TX_DESC_W8_EN_HWSEQ BIT(15)
56 #define RTW_TX_DESC_W9_SW_SEQ GENMASK(23, 12)
57 #define RTW_TX_DESC_W9_TIM_EN BIT(7)
58 #define RTW_TX_DESC_W9_TIM_OFFSET GENMASK(6, 0)
59 
60 enum rtw_tx_desc_queue_select {
61 	TX_DESC_QSEL_TID0	= 0,
62 	TX_DESC_QSEL_TID1	= 1,
63 	TX_DESC_QSEL_TID2	= 2,
64 	TX_DESC_QSEL_TID3	= 3,
65 	TX_DESC_QSEL_TID4	= 4,
66 	TX_DESC_QSEL_TID5	= 5,
67 	TX_DESC_QSEL_TID6	= 6,
68 	TX_DESC_QSEL_TID7	= 7,
69 	TX_DESC_QSEL_TID8	= 8,
70 	TX_DESC_QSEL_TID9	= 9,
71 	TX_DESC_QSEL_TID10	= 10,
72 	TX_DESC_QSEL_TID11	= 11,
73 	TX_DESC_QSEL_TID12	= 12,
74 	TX_DESC_QSEL_TID13	= 13,
75 	TX_DESC_QSEL_TID14	= 14,
76 	TX_DESC_QSEL_TID15	= 15,
77 	TX_DESC_QSEL_BEACON	= 16,
78 	TX_DESC_QSEL_HIGH	= 17,
79 	TX_DESC_QSEL_MGMT	= 18,
80 	TX_DESC_QSEL_H2C	= 19,
81 };
82 
83 enum rtw_rsvd_packet_type;
84 
85 void rtw_tx(struct rtw_dev *rtwdev,
86 	    struct ieee80211_tx_control *control,
87 	    struct sk_buff *skb);
88 void rtw_txq_init(struct rtw_dev *rtwdev, struct ieee80211_txq *txq);
89 void rtw_txq_cleanup(struct rtw_dev *rtwdev, struct ieee80211_txq *txq);
90 void rtw_tx_work(struct work_struct *w);
91 void __rtw_tx_work(struct rtw_dev *rtwdev);
92 void rtw_tx_pkt_info_update(struct rtw_dev *rtwdev,
93 			    struct rtw_tx_pkt_info *pkt_info,
94 			    struct ieee80211_sta *sta,
95 			    struct sk_buff *skb);
96 void rtw_tx_fill_tx_desc(struct rtw_tx_pkt_info *pkt_info, struct sk_buff *skb);
97 void rtw_tx_report_enqueue(struct rtw_dev *rtwdev, struct sk_buff *skb, u8 sn);
98 void rtw_tx_report_handle(struct rtw_dev *rtwdev, struct sk_buff *skb, int src);
99 void rtw_tx_rsvd_page_pkt_info_update(struct rtw_dev *rtwdev,
100 				      struct rtw_tx_pkt_info *pkt_info,
101 				      struct sk_buff *skb,
102 				      enum rtw_rsvd_packet_type type);
103 struct sk_buff *
104 rtw_tx_write_data_rsvd_page_get(struct rtw_dev *rtwdev,
105 				struct rtw_tx_pkt_info *pkt_info,
106 				u8 *buf, u32 size);
107 struct sk_buff *
108 rtw_tx_write_data_h2c_get(struct rtw_dev *rtwdev,
109 			  struct rtw_tx_pkt_info *pkt_info,
110 			  u8 *buf, u32 size);
111 
112 enum rtw_tx_queue_type rtw_tx_ac_to_hwq(enum ieee80211_ac_numbers ac);
113 enum rtw_tx_queue_type rtw_tx_queue_mapping(struct sk_buff *skb);
114 
115 static inline
116 void fill_txdesc_checksum_common(u8 *txdesc, size_t words)
117 {
118 	__le16 chksum = 0;
119 	__le16 *data = (__le16 *)(txdesc);
120 	struct rtw_tx_desc *tx_desc = (struct rtw_tx_desc *)txdesc;
121 
122 	le32p_replace_bits(&tx_desc->w7, 0, RTW_TX_DESC_W7_TXDESC_CHECKSUM);
123 
124 	while (words--)
125 		chksum ^= *data++;
126 
127 	le32p_replace_bits(&tx_desc->w7, __le16_to_cpu(chksum),
128 			   RTW_TX_DESC_W7_TXDESC_CHECKSUM);
129 }
130 
131 static inline void rtw_tx_fill_txdesc_checksum(struct rtw_dev *rtwdev,
132 					       struct rtw_tx_pkt_info *pkt_info,
133 					       u8 *txdesc)
134 {
135 	const struct rtw_chip_info *chip = rtwdev->chip;
136 
137 	chip->ops->fill_txdesc_checksum(rtwdev, pkt_info, txdesc);
138 }
139 
140 #endif
141