1 /* SPDX-License-Identifier: BSD-3-Clause-Clear */
2 /*
3  * Copyright (c) 2018-2021 The Linux Foundation. All rights reserved.
4  * Copyright (c) 2021-2023 Qualcomm Innovation Center, Inc. All rights reserved.
5  */
6 #ifndef ATH12K_RX_DESC_H
7 #define ATH12K_RX_DESC_H
8 
9 enum rx_desc_decap_type {
10 	RX_DESC_DECAP_TYPE_RAW,
11 	RX_DESC_DECAP_TYPE_NATIVE_WIFI,
12 	RX_DESC_DECAP_TYPE_ETHERNET2_DIX,
13 	RX_DESC_DECAP_TYPE_8023,
14 };
15 
16 enum rx_desc_decrypt_status_code {
17 	RX_DESC_DECRYPT_STATUS_CODE_OK,
18 	RX_DESC_DECRYPT_STATUS_CODE_UNPROTECTED_FRAME,
19 	RX_DESC_DECRYPT_STATUS_CODE_DATA_ERR,
20 	RX_DESC_DECRYPT_STATUS_CODE_KEY_INVALID,
21 	RX_DESC_DECRYPT_STATUS_CODE_PEER_ENTRY_INVALID,
22 	RX_DESC_DECRYPT_STATUS_CODE_OTHER,
23 };
24 
25 #define RX_MPDU_START_INFO0_REO_DEST_IND		GENMASK(4, 0)
26 #define RX_MPDU_START_INFO0_LMAC_PEER_ID_MSB		GENMASK(6, 5)
27 #define RX_MPDU_START_INFO0_FLOW_ID_TOEPLITZ		BIT(7)
28 #define RX_MPDU_START_INFO0_PKT_SEL_FP_UCAST_DATA	BIT(8)
29 #define RX_MPDU_START_INFO0_PKT_SEL_FP_MCAST_DATA	BIT(9)
30 #define RX_MPDU_START_INFO0_PKT_SEL_FP_CTRL_BAR		BIT(10)
31 #define RX_MPDU_START_INFO0_RXDMA0_SRC_RING_SEL		GENMASK(13, 11)
32 #define RX_MPDU_START_INFO0_RXDMA0_DST_RING_SEL		GENMASK(16, 14)
33 #define RX_MPDU_START_INFO0_MCAST_ECHO_DROP_EN		BIT(17)
34 #define RX_MPDU_START_INFO0_WDS_LEARN_DETECT_EN		BIT(18)
35 #define RX_MPDU_START_INFO0_INTRA_BSS_CHECK_EN		BIT(19)
36 #define RX_MPDU_START_INFO0_USE_PPE			BIT(20)
37 #define RX_MPDU_START_INFO0_PPE_ROUTING_EN		BIT(21)
38 
39 #define RX_MPDU_START_INFO1_REO_QUEUE_DESC_HI		GENMASK(7, 0)
40 #define RX_MPDU_START_INFO1_RECV_QUEUE_NUM		GENMASK(23, 8)
41 #define RX_MPDU_START_INFO1_PRE_DELIM_ERR_WARN		BIT(24)
42 #define RX_MPDU_START_INFO1_FIRST_DELIM_ERR		BIT(25)
43 
44 #define RX_MPDU_START_INFO2_EPD_EN			BIT(0)
45 #define RX_MPDU_START_INFO2_ALL_FRAME_ENCPD		BIT(1)
46 #define RX_MPDU_START_INFO2_ENC_TYPE			GENMASK(5, 2)
47 #define RX_MPDU_START_INFO2_VAR_WEP_KEY_WIDTH		GENMASK(7, 6)
48 #define RX_MPDU_START_INFO2_MESH_STA			GENMASK(9, 8)
49 #define RX_MPDU_START_INFO2_BSSID_HIT			BIT(10)
50 #define RX_MPDU_START_INFO2_BSSID_NUM			GENMASK(14, 11)
51 #define RX_MPDU_START_INFO2_TID				GENMASK(18, 15)
52 
53 #define RX_MPDU_START_INFO3_RXPCU_MPDU_FLTR		GENMASK(1, 0)
54 #define RX_MPDU_START_INFO3_SW_FRAME_GRP_ID		GENMASK(8, 2)
55 #define RX_MPDU_START_INFO3_NDP_FRAME			BIT(9)
56 #define RX_MPDU_START_INFO3_PHY_ERR			BIT(10)
57 #define RX_MPDU_START_INFO3_PHY_ERR_MPDU_HDR		BIT(11)
58 #define RX_MPDU_START_INFO3_PROTO_VER_ERR		BIT(12)
59 #define RX_MPDU_START_INFO3_AST_LOOKUP_VALID		BIT(13)
60 #define RX_MPDU_START_INFO3_RANGING			BIT(14)
61 
62 #define RX_MPDU_START_INFO4_MPDU_FCTRL_VALID		BIT(0)
63 #define RX_MPDU_START_INFO4_MPDU_DUR_VALID		BIT(1)
64 #define RX_MPDU_START_INFO4_MAC_ADDR1_VALID		BIT(2)
65 #define RX_MPDU_START_INFO4_MAC_ADDR2_VALID		BIT(3)
66 #define RX_MPDU_START_INFO4_MAC_ADDR3_VALID		BIT(4)
67 #define RX_MPDU_START_INFO4_MAC_ADDR4_VALID		BIT(5)
68 #define RX_MPDU_START_INFO4_MPDU_SEQ_CTRL_VALID		BIT(6)
69 #define RX_MPDU_START_INFO4_MPDU_QOS_CTRL_VALID		BIT(7)
70 #define RX_MPDU_START_INFO4_MPDU_HT_CTRL_VALID		BIT(8)
71 #define RX_MPDU_START_INFO4_ENCRYPT_INFO_VALID		BIT(9)
72 #define RX_MPDU_START_INFO4_MPDU_FRAG_NUMBER		GENMASK(13, 10)
73 #define RX_MPDU_START_INFO4_MORE_FRAG_FLAG		BIT(14)
74 #define RX_MPDU_START_INFO4_FROM_DS			BIT(16)
75 #define RX_MPDU_START_INFO4_TO_DS			BIT(17)
76 #define RX_MPDU_START_INFO4_ENCRYPTED			BIT(18)
77 #define RX_MPDU_START_INFO4_MPDU_RETRY			BIT(19)
78 #define RX_MPDU_START_INFO4_MPDU_SEQ_NUM		GENMASK(31, 20)
79 
80 #define RX_MPDU_START_INFO5_KEY_ID			GENMASK(7, 0)
81 #define RX_MPDU_START_INFO5_NEW_PEER_ENTRY		BIT(8)
82 #define RX_MPDU_START_INFO5_DECRYPT_NEEDED		BIT(9)
83 #define RX_MPDU_START_INFO5_DECAP_TYPE			GENMASK(11, 10)
84 #define RX_MPDU_START_INFO5_VLAN_TAG_C_PADDING		BIT(12)
85 #define RX_MPDU_START_INFO5_VLAN_TAG_S_PADDING		BIT(13)
86 #define RX_MPDU_START_INFO5_STRIP_VLAN_TAG_C		BIT(14)
87 #define RX_MPDU_START_INFO5_STRIP_VLAN_TAG_S		BIT(15)
88 #define RX_MPDU_START_INFO5_PRE_DELIM_COUNT		GENMASK(27, 16)
89 #define RX_MPDU_START_INFO5_AMPDU_FLAG			BIT(28)
90 #define RX_MPDU_START_INFO5_BAR_FRAME			BIT(29)
91 #define RX_MPDU_START_INFO5_RAW_MPDU			BIT(30)
92 
93 #define RX_MPDU_START_INFO6_MPDU_LEN			GENMASK(13, 0)
94 #define RX_MPDU_START_INFO6_FIRST_MPDU			BIT(14)
95 #define RX_MPDU_START_INFO6_MCAST_BCAST			BIT(15)
96 #define RX_MPDU_START_INFO6_AST_IDX_NOT_FOUND		BIT(16)
97 #define RX_MPDU_START_INFO6_AST_IDX_TIMEOUT		BIT(17)
98 #define RX_MPDU_START_INFO6_POWER_MGMT			BIT(18)
99 #define RX_MPDU_START_INFO6_NON_QOS			BIT(19)
100 #define RX_MPDU_START_INFO6_NULL_DATA			BIT(20)
101 #define RX_MPDU_START_INFO6_MGMT_TYPE			BIT(21)
102 #define RX_MPDU_START_INFO6_CTRL_TYPE			BIT(22)
103 #define RX_MPDU_START_INFO6_MORE_DATA			BIT(23)
104 #define RX_MPDU_START_INFO6_EOSP			BIT(24)
105 #define RX_MPDU_START_INFO6_FRAGMENT			BIT(25)
106 #define RX_MPDU_START_INFO6_ORDER			BIT(26)
107 #define RX_MPDU_START_INFO6_UAPSD_TRIGGER		BIT(27)
108 #define RX_MPDU_START_INFO6_ENCRYPT_REQUIRED		BIT(28)
109 #define RX_MPDU_START_INFO6_DIRECTED			BIT(29)
110 #define RX_MPDU_START_INFO6_AMSDU_PRESENT		BIT(30)
111 
112 #define RX_MPDU_START_INFO7_VDEV_ID			GENMASK(7, 0)
113 #define RX_MPDU_START_INFO7_SERVICE_CODE		GENMASK(16, 8)
114 #define RX_MPDU_START_INFO7_PRIORITY_VALID		BIT(17)
115 #define RX_MPDU_START_INFO7_SRC_INFO			GENMASK(29, 18)
116 
117 #define RX_MPDU_START_INFO8_AUTH_TO_SEND_WDS		BIT(0)
118 
119 struct rx_mpdu_start_qcn9274 {
120 	__le32 info0;
121 	__le32 reo_queue_desc_lo;
122 	__le32 info1;
123 	__le32 pn[4];
124 	__le32 info2;
125 	__le32 peer_meta_data;
126 	__le16 info3;
127 	__le16 phy_ppdu_id;
128 	__le16 ast_index;
129 	__le16 sw_peer_id;
130 	__le32 info4;
131 	__le32 info5;
132 	__le32 info6;
133 	__le16 frame_ctrl;
134 	__le16 duration;
135 	u8 addr1[ETH_ALEN];
136 	u8 addr2[ETH_ALEN];
137 	u8 addr3[ETH_ALEN];
138 	__le16 seq_ctrl;
139 	u8 addr4[ETH_ALEN];
140 	__le16 qos_ctrl;
141 	__le32 ht_ctrl;
142 	__le32 info7;
143 	u8 multi_link_addr1[ETH_ALEN];
144 	u8 multi_link_addr2[ETH_ALEN];
145 	__le32 info8;
146 	__le32 res0;
147 	__le32 res1;
148 } __packed;
149 
150 /* rx_mpdu_start
151  *
152  * reo_destination_indication
153  *		The id of the reo exit ring where the msdu frame shall push
154  *		after (MPDU level) reordering has finished. Values are defined
155  *		in enum %HAL_RX_MSDU_DESC_REO_DEST_IND_.
156  *
157  * lmac_peer_id_msb
158  *
159  *		If use_flow_id_toeplitz_clfy is set and lmac_peer_id_'sb
160  *		is 2'b00, Rx OLE uses a REO destination indicati'n of {1'b1,
161  *		hash[3:0]} using the chosen Toeplitz hash from Common Parser
162  *		if flow search fails.
163  *		If use_flow_id_toeplitz_clfy is set and lmac_peer_id_msb
164  *		's not 2'b00, Rx OLE uses a REO destination indication of
165  *		{lmac_peer_id_msb, hash[2:0]} using the chosen Toeplitz
166  *		hash from Common Parser if flow search fails.
167  *
168  * use_flow_id_toeplitz_clfy
169  *		Indication to Rx OLE to enable REO destination routing based
170  *		on the chosen Toeplitz hash from Common Parser, in case
171  *		flow search fails
172  *
173  * pkt_selection_fp_ucast_data
174  *		Filter pass Unicast data frame (matching rxpcu_filter_pass
175  *		and sw_frame_group_Unicast_data) routing selection
176  *
177  * pkt_selection_fp_mcast_data
178  *		Filter pass Multicast data frame (matching rxpcu_filter_pass
179  *		and sw_frame_group_Multicast_data) routing selection
180  *
181  * pkt_selection_fp_ctrl_bar
182  *		Filter pass BAR frame (matching rxpcu_filter_pass
183  *		and sw_frame_group_ctrl_1000) routing selection
184  *
185  * rxdma0_src_ring_selection
186  *		Field only valid when for the received frame type the corresponding
187  *		pkt_selection_fp_... bit is set
188  *
189  * rxdma0_dst_ring_selection
190  *		Field only valid when for the received frame type the corresponding
191  *		pkt_selection_fp_... bit is set
192  *
193  * mcast_echo_drop_enable
194  *		If set, for multicast packets, multicast echo check (i.e.
195  *		SA search with mcast_echo_check = 1) shall be performed
196  *		by RXOLE, and any multicast echo packets should be indicated
197  *		 to RXDMA for release to WBM
198  *
199  * wds_learning_detect_en
200  *		If set, WDS learning detection based on SA search and notification
201  *		to FW (using RXDMA0 status ring) is enabled and the "timestamp"
202  *		field in address search failure cache-only entry should
203  *		be used to avoid multiple WDS learning notifications.
204  *
205  * intrabss_check_en
206  *		If set, intra-BSS routing detection is enabled
207  *
208  * use_ppe
209  *		Indicates to RXDMA to ignore the REO_destination_indication
210  *		and use a programmed value corresponding to the REO2PPE
211  *		ring
212  *		This override to REO2PPE for packets requiring multiple
213  *		buffers shall be disabled based on an RXDMA configuration,
214  *		as PPE may not support such packets.
215  *
216  *		Supported only in full AP chips, not in client/soft
217  *		chips
218  *
219  * ppe_routing_enable
220  *		Global enable/disable bit for routing to PPE, used to disable
221  *		PPE routing even if RXOLE CCE or flow search indicate 'Use_PPE'
222  *		This is set by SW for peers which are being handled by a
223  *		host SW/accelerator subsystem that also handles packet
224  *		buffer management for WiFi-to-PPE routing.
225  *
226  *		This is cleared by SW for peers which are being handled
227  *		by a different subsystem, completely disabling WiFi-to-PPE
228  *		routing for such peers.
229  *
230  * rx_reo_queue_desc_addr_lo
231  *		Address (lower 32 bits) of the REO queue descriptor.
232  *
233  * rx_reo_queue_desc_addr_hi
234  *		Address (upper 8 bits) of the REO queue descriptor.
235  *
236  * receive_queue_number
237  *		Indicates the MPDU queue ID to which this MPDU link
238  *		descriptor belongs.
239  *
240  * pre_delim_err_warning
241  *		Indicates that a delimiter FCS error was found in between the
242  *		previous MPDU and this MPDU. Note that this is just a warning,
243  *		and does not mean that this MPDU is corrupted in any way. If
244  *		it is, there will be other errors indicated such as FCS or
245  *		decrypt errors.
246  *
247  * first_delim_err
248  *		Indicates that the first delimiter had a FCS failure.
249  *
250  * pn
251  *		The PN number.
252  *
253  * epd_en
254  *		Field only valid when AST_based_lookup_valid == 1.
255  *		In case of ndp or phy_err or AST_based_lookup_valid == 0,
256  *		this field will be set to 0
257  *		If set to one use EPD instead of LPD
258  *		In case of ndp or phy_err, this field will never be set.
259  *
260  * all_frames_shall_be_encrypted
261  *		In case of ndp or phy_err or AST_based_lookup_valid == 0,
262  *		this field will be set to 0
263  *
264  *		When set, all frames (data only ?) shall be encrypted. If
265  *		not, RX CRYPTO shall set an error flag.
266  *
267  *
268  * encrypt_type
269  *		In case of ndp or phy_err or AST_based_lookup_valid == 0,
270  *		this field will be set to 0
271  *
272  *		Indicates type of decrypt cipher used (as defined in the
273  *		peer entry)
274  *
275  * wep_key_width_for_variable_key
276  *
277  *		Field only valid when key_type is set to wep_varied_width.
278  *
279  * mesh_sta
280  *
281  * bssid_hit
282  *		When set, the BSSID of the incoming frame matched one of
283  *		 the 8 BSSID register values
284  * bssid_number
285  *		Field only valid when bssid_hit is set.
286  *		This number indicates which one out of the 8 BSSID register
287  *		values matched the incoming frame
288  *
289  * tid
290  *		Field only valid when mpdu_qos_control_valid is set
291  *		The TID field in the QoS control field
292  *
293  * peer_meta_data
294  *		Meta data that SW has programmed in the Peer table entry
295  *		of the transmitting STA.
296  *
297  * rxpcu_mpdu_filter_in_category
298  *		Field indicates what the reason was that this mpdu frame
299  *		was allowed to come into the receive path by rxpcu. Values
300  *		are defined in enum %RX_DESC_RXPCU_FILTER_*.
301  *
302  * sw_frame_group_id
303  *		SW processes frames based on certain classifications. Values
304  *		are defined in enum %RX_DESC_SW_FRAME_GRP_ID_*.
305  *
306  * ndp_frame
307  *		When set, the received frame was an NDP frame, and thus
308  *		there will be no MPDU data.
309  * phy_err
310  *		When set, a PHY error was received before MAC received any
311  *		data, and thus there will be no MPDU data.
312  *
313  * phy_err_during_mpdu_header
314  *		When set, a PHY error was received before MAC received the
315  *		complete MPDU header which was needed for proper decoding
316  *
317  * protocol_version_err
318  *		Set when RXPCU detected a version error in the Frame control
319  *		field
320  *
321  * ast_based_lookup_valid
322  *		When set, AST based lookup for this frame has found a valid
323  *		result.
324  *
325  * ranging
326  *		When set, a ranging NDPA or a ranging NDP was received.
327  *
328  * phy_ppdu_id
329  *		A ppdu counter value that PHY increments for every PPDU
330  *		received. The counter value wraps around.
331  *
332  * ast_index
333  *
334  *		This field indicates the index of the AST entry corresponding
335  *		to this MPDU. It is provided by the GSE module instantiated
336  *		in RXPCU.
337  *		A value of 0xFFFF indicates an invalid AST index, meaning
338  *		that No AST entry was found or NO AST search was performed
339  *
340  * sw_peer_id
341  *		In case of ndp or phy_err or AST_based_lookup_valid == 0,
342  *		this field will be set to 0
343  *		This field indicates a unique peer identifier. It is set
344  *		equal to field 'sw_peer_id' from the AST entry
345  *
346  * frame_control_valid
347  *		When set, the field Mpdu_Frame_control_field has valid information
348  *
349  * frame_duration_valid
350  *		When set, the field Mpdu_duration_field has valid information
351  *
352  * mac_addr_ad1..4_valid
353  *		When set, the fields mac_addr_adx_..... have valid information
354  *
355  * mpdu_seq_ctrl_valid
356  *
357  *		When set, the fields mpdu_sequence_control_field and mpdu_sequence_number
358  *		have valid information as well as field
359  *		For MPDUs without a sequence control field, this field will
360  *		not be set.
361  *
362  * mpdu_qos_ctrl_valid, mpdu_ht_ctrl_valid
363  *
364  *		When set, the field mpdu_qos_control_field, mpdu_ht_control has valid
365  *		information, For MPDUs without a QoS,HT control field, this field
366  *		will not be set.
367  *
368  * frame_encryption_info_valid
369  *
370  *		When set, the encryption related info fields, like IV and
371  *		PN are valid
372  *		For MPDUs that are not encrypted, this will not be set.
373  *
374  * mpdu_fragment_number
375  *
376  *		Field only valid when Mpdu_sequence_control_valid is set
377  *		AND Fragment_flag is set. The fragment number from the 802.11 header
378  *
379  * more_fragment_flag
380  *
381  *		The More Fragment bit setting from the MPDU header of the
382  *		received frame
383  *
384  * fr_ds
385  *
386  *		Field only valid when Mpdu_frame_control_valid is set
387  *		Set if the from DS bit is set in the frame control.
388  *
389  * to_ds
390  *
391  *		Field only valid when Mpdu_frame_control_valid is set
392  *		Set if the to DS bit is set in the frame control.
393  *
394  * encrypted
395  *
396  *		Field only valid when Mpdu_frame_control_valid is set.
397  *		Protected bit from the frame control.
398  *
399  * mpdu_retry
400  *		Field only valid when Mpdu_frame_control_valid is set.
401  *		Retry bit from the frame control.  Only valid when first_msdu is set
402  *
403  * mpdu_sequence_number
404  *		Field only valid when Mpdu_sequence_control_valid is set.
405  *
406  *		The sequence number from the 802.11 header.
407  * key_id
408  *		The key ID octet from the IV.
409  *		Field only valid when Frame_encryption_info_valid is set
410  *
411  * new_peer_entry
412  *		Set if new RX_PEER_ENTRY TLV follows. If clear, RX_PEER_ENTRY
413  *		doesn't follow so RX DECRYPTION module either uses old peer
414  *		entry or not decrypt.
415  *
416  * decrypt_needed
417  *		When RXPCU sets bit 'ast_index_not_found or ast_index_timeout',
418  *		RXPCU will also ensure that this bit is NOT set. CRYPTO for that
419  *		reason only needs to evaluate this bit and non of the other ones
420  *
421  * decap_type
422  *		Used by the OLE during decapsulation. Values are defined in
423  *		enum %MPDU_START_DECAP_TYPE_*.
424  *
425  * rx_insert_vlan_c_tag_padding
426  * rx_insert_vlan_s_tag_padding
427  *		Insert 4 byte of all zeros as VLAN tag or double VLAN tag if
428  *		the rx payload does not have VLAN.
429  *
430  * strip_vlan_c_tag_decap
431  * strip_vlan_s_tag_decap
432  *		Strip VLAN or double VLAN during decapsulation.
433  *
434  * pre_delim_count
435  *		The number of delimiters before this MPDU. Note that this
436  *		number is cleared at PPDU start. If this MPDU is the first
437  *		received MPDU in the PPDU and this MPDU gets filtered-in,
438  *		this field will indicate the number of delimiters located
439  *		after the last MPDU in the previous PPDU.
440  *
441  *		If this MPDU is located after the first received MPDU in
442  *		an PPDU, this field will indicate the number of delimiters
443  *		located between the previous MPDU and this MPDU.
444  *
445  * ampdu_flag
446  *		Received frame was part of an A-MPDU.
447  *
448  * bar_frame
449  *		Received frame is a BAR frame
450  *
451  * raw_mpdu
452  *		Set when no 802.11 to nwifi/ethernet hdr conversion is done
453  *
454  * mpdu_length
455  *		MPDU length before decapsulation.
456  *
457  * first_mpdu
458  *		Indicates the first MSDU of the PPDU.  If both first_mpdu
459  *		and last_mpdu are set in the MSDU then this is a not an
460  *		A-MPDU frame but a stand alone MPDU.  Interior MPDU in an
461  *		A-MPDU shall have both first_mpdu and last_mpdu bits set to
462  *		0.  The PPDU start status will only be valid when this bit
463  *		is set.
464  *
465  * mcast_bcast
466  *		Multicast / broadcast indicator.  Only set when the MAC
467  *		address 1 bit 0 is set indicating mcast/bcast and the BSSID
468  *		matches one of the 4 BSSID registers. Only set when
469  *		first_msdu is set.
470  *
471  * ast_index_not_found
472  *		Only valid when first_msdu is set. Indicates no AST matching
473  *		entries within the max search count.
474  *
475  * ast_index_timeout
476  *		Only valid when first_msdu is set. Indicates an unsuccessful
477  *		search in the address search table due to timeout.
478  *
479  * power_mgmt
480  *		Power management bit set in the 802.11 header.  Only set
481  *		when first_msdu is set.
482  *
483  * non_qos
484  *		Set if packet is not a non-QoS data frame.  Only set when
485  *		first_msdu is set.
486  *
487  * null_data
488  *		Set if frame type indicates either null data or QoS null
489  *		data format.  Only set when first_msdu is set.
490  *
491  * mgmt_type
492  *		Set if packet is a management packet.  Only set when
493  *		first_msdu is set.
494  *
495  * ctrl_type
496  *		Set if packet is a control packet.  Only set when first_msdu
497  *		is set.
498  *
499  * more_data
500  *		Set if more bit in frame control is set.  Only set when
501  *		first_msdu is set.
502  *
503  * eosp
504  *		Set if the EOSP (end of service period) bit in the QoS
505  *		control field is set.  Only set when first_msdu is set.
506  *
507  *
508  * fragment_flag
509  *		Fragment indication
510  *
511  * order
512  *		Set if the order bit in the frame control is set.  Only
513  *		set when first_msdu is set.
514  *
515  * u_apsd_trigger
516  *		U-APSD trigger frame
517  *
518  * encrypt_required
519  *		Indicates that this data type frame is not encrypted even if
520  *		the policy for this MPDU requires encryption as indicated in
521  *		the peer table key type.
522  *
523  * directed
524  *		MPDU is a directed packet which means that the RA matched
525  *		our STA addresses.  In proxySTA it means that the TA matched
526  *		an entry in our address search table with the corresponding
527  *		'no_ack' bit is the address search entry cleared.
528  * amsdu_present
529  *		AMSDU present
530  *
531  * mpdu_frame_control_field
532  *		Frame control field in header. Only valid when the field is marked valid.
533  *
534  * mpdu_duration_field
535  *		Duration field in header. Only valid when the field is marked valid.
536  *
537  * mac_addr_adx
538  *		MAC addresses in the received frame. Only valid when corresponding
539  *		address valid bit is set
540  *
541  * mpdu_qos_control_field, mpdu_ht_control_field
542  *		QoS/HT control fields from header. Valid only when corresponding fields
543  *		are marked valid
544  *
545  * vdev_id
546  *		Virtual device associated with this peer
547  *		RXOLE uses this to determine intra-BSS routing.
548  *
549  * service_code
550  *		Opaque service code between PPE and Wi-Fi
551  *		This field gets passed on by REO to PPE in the EDMA descriptor
552  *		('REO_TO_PPE_RING').
553  *
554  * priority_valid
555  *		This field gets passed on by REO to PPE in the EDMA descriptor
556  *		('REO_TO_PPE_RING').
557  *
558  * src_info
559  *		Source (virtual) device/interface info. associated with
560  *		this peer
561  *		This field gets passed on by REO to PPE in the EDMA descriptor
562  *		('REO_TO_PPE_RING').
563  *
564  * multi_link_addr_ad1_ad2_valid
565  *		If set, Rx OLE shall convert Address1 and Address2 of received
566  *		data frames to multi-link addresses during decapsulation to eth/nwifi
567  *
568  * multi_link_addr_ad1,ad2
569  *		Multi-link receiver address1,2. Only valid when corresponding
570  *		valid bit is set
571  *
572  * authorize_to_send_wds
573  *		If not set, RXDMA shall perform error-routing for WDS packets
574  *		as the sender is not authorized and might misuse WDS frame
575  *		format to inject packets with arbitrary DA/SA.
576  *
577  */
578 
579 enum rx_msdu_start_pkt_type {
580 	RX_MSDU_START_PKT_TYPE_11A,
581 	RX_MSDU_START_PKT_TYPE_11B,
582 	RX_MSDU_START_PKT_TYPE_11N,
583 	RX_MSDU_START_PKT_TYPE_11AC,
584 	RX_MSDU_START_PKT_TYPE_11AX,
585 };
586 
587 enum rx_msdu_start_sgi {
588 	RX_MSDU_START_SGI_0_8_US,
589 	RX_MSDU_START_SGI_0_4_US,
590 	RX_MSDU_START_SGI_1_6_US,
591 	RX_MSDU_START_SGI_3_2_US,
592 };
593 
594 enum rx_msdu_start_recv_bw {
595 	RX_MSDU_START_RECV_BW_20MHZ,
596 	RX_MSDU_START_RECV_BW_40MHZ,
597 	RX_MSDU_START_RECV_BW_80MHZ,
598 	RX_MSDU_START_RECV_BW_160MHZ,
599 };
600 
601 enum rx_msdu_start_reception_type {
602 	RX_MSDU_START_RECEPTION_TYPE_SU,
603 	RX_MSDU_START_RECEPTION_TYPE_DL_MU_MIMO,
604 	RX_MSDU_START_RECEPTION_TYPE_DL_MU_OFDMA,
605 	RX_MSDU_START_RECEPTION_TYPE_DL_MU_OFDMA_MIMO,
606 	RX_MSDU_START_RECEPTION_TYPE_UL_MU_MIMO,
607 	RX_MSDU_START_RECEPTION_TYPE_UL_MU_OFDMA,
608 	RX_MSDU_START_RECEPTION_TYPE_UL_MU_OFDMA_MIMO,
609 };
610 
611 #define RX_MSDU_END_INFO0_RXPCU_MPDU_FITLER	GENMASK(1, 0)
612 #define RX_MSDU_END_INFO0_SW_FRAME_GRP_ID	GENMASK(8, 2)
613 
614 #define RX_MSDU_END_INFO1_REPORTED_MPDU_LENGTH	GENMASK(13, 0)
615 
616 #define RX_MSDU_END_INFO2_CCE_SUPER_RULE	GENMASK(13, 8)
617 #define RX_MSDU_END_INFO2_CCND_TRUNCATE		BIT(14)
618 #define RX_MSDU_END_INFO2_CCND_CCE_DIS		BIT(15)
619 
620 #define RX_MSDU_END_INFO3_DA_OFFSET		GENMASK(5, 0)
621 #define RX_MSDU_END_INFO3_SA_OFFSET		GENMASK(11, 6)
622 #define RX_MSDU_END_INFO3_DA_OFFSET_VALID	BIT(12)
623 #define RX_MSDU_END_INFO3_SA_OFFSET_VALID	BIT(13)
624 
625 #define RX_MSDU_END_INFO4_TCP_FLAG		GENMASK(8, 0)
626 #define RX_MSDU_END_INFO4_LRO_ELIGIBLE		BIT(9)
627 
628 #define RX_MSDU_END_INFO5_SA_IDX_TIMEOUT	BIT(0)
629 #define RX_MSDU_END_INFO5_DA_IDX_TIMEOUT	BIT(1)
630 #define RX_MSDU_END_INFO5_TO_DS			BIT(2)
631 #define RX_MSDU_END_INFO5_TID			GENMASK(6, 3)
632 #define RX_MSDU_END_INFO5_SA_IS_VALID		BIT(7)
633 #define RX_MSDU_END_INFO5_DA_IS_VALID		BIT(8)
634 #define RX_MSDU_END_INFO5_DA_IS_MCBC		BIT(9)
635 #define RX_MSDU_END_INFO5_L3_HDR_PADDING	GENMASK(11, 10)
636 #define RX_MSDU_END_INFO5_FIRST_MSDU		BIT(12)
637 #define RX_MSDU_END_INFO5_LAST_MSDU		BIT(13)
638 #define RX_MSDU_END_INFO5_FROM_DS		BIT(14)
639 #define RX_MSDU_END_INFO5_IP_CHKSUM_FAIL_COPY	BIT(15)
640 
641 #define RX_MSDU_END_INFO6_MSDU_DROP		BIT(0)
642 #define RX_MSDU_END_INFO6_REO_DEST_IND		GENMASK(5, 1)
643 #define RX_MSDU_END_INFO6_FLOW_IDX		GENMASK(25, 6)
644 #define RX_MSDU_END_INFO6_USE_PPE		BIT(26)
645 #define RX_MSDU_END_INFO6_MESH_STA		GENMASK(28, 27)
646 #define RX_MSDU_END_INFO6_VLAN_CTAG_STRIPPED	BIT(29)
647 #define RX_MSDU_END_INFO6_VLAN_STAG_STRIPPED	BIT(30)
648 #define RX_MSDU_END_INFO6_FRAGMENT_FLAG		BIT(31)
649 
650 #define RX_MSDU_END_INFO7_AGGR_COUNT		GENMASK(7, 0)
651 #define RX_MSDU_END_INFO7_FLOW_AGGR_CONTN	BIT(8)
652 #define RX_MSDU_END_INFO7_FISA_TIMEOUT		BIT(9)
653 #define RX_MSDU_END_INFO7_TCPUDP_CSUM_FAIL_CPY	BIT(10)
654 #define RX_MSDU_END_INFO7_MSDU_LIMIT_ERROR	BIT(11)
655 #define RX_MSDU_END_INFO7_FLOW_IDX_TIMEOUT	BIT(12)
656 #define RX_MSDU_END_INFO7_FLOW_IDX_INVALID	BIT(13)
657 #define RX_MSDU_END_INFO7_CCE_MATCH		BIT(14)
658 #define RX_MSDU_END_INFO7_AMSDU_PARSER_ERR	BIT(15)
659 
660 #define RX_MSDU_END_INFO8_KEY_ID		GENMASK(7, 0)
661 
662 #define RX_MSDU_END_INFO9_SERVICE_CODE		GENMASK(14, 6)
663 #define RX_MSDU_END_INFO9_PRIORITY_VALID	BIT(15)
664 #define RX_MSDU_END_INFO9_INRA_BSS		BIT(16)
665 #define RX_MSDU_END_INFO9_DEST_CHIP_ID		GENMASK(18, 17)
666 #define RX_MSDU_END_INFO9_MCAST_ECHO		BIT(19)
667 #define RX_MSDU_END_INFO9_WDS_LEARN_EVENT	BIT(20)
668 #define RX_MSDU_END_INFO9_WDS_ROAM_EVENT	BIT(21)
669 #define RX_MSDU_END_INFO9_WDS_KEEP_ALIVE_EVENT	BIT(22)
670 
671 #define RX_MSDU_END_INFO10_MSDU_LENGTH		GENMASK(13, 0)
672 #define RX_MSDU_END_INFO10_STBC			BIT(14)
673 #define RX_MSDU_END_INFO10_IPSEC_ESP		BIT(15)
674 #define RX_MSDU_END_INFO10_L3_OFFSET		GENMASK(22, 16)
675 #define RX_MSDU_END_INFO10_IPSEC_AH		BIT(23)
676 #define RX_MSDU_END_INFO10_L4_OFFSET		GENMASK(31, 24)
677 
678 #define RX_MSDU_END_INFO11_MSDU_NUMBER		GENMASK(7, 0)
679 #define RX_MSDU_END_INFO11_DECAP_FORMAT		GENMASK(9, 8)
680 #define RX_MSDU_END_INFO11_IPV4			BIT(10)
681 #define RX_MSDU_END_INFO11_IPV6			BIT(11)
682 #define RX_MSDU_END_INFO11_TCP			BIT(12)
683 #define RX_MSDU_END_INFO11_UDP			BIT(13)
684 #define RX_MSDU_END_INFO11_IP_FRAG		BIT(14)
685 #define RX_MSDU_END_INFO11_TCP_ONLY_ACK		BIT(15)
686 #define RX_MSDU_END_INFO11_DA_IS_BCAST_MCAST	BIT(16)
687 #define RX_MSDU_END_INFO11_SEL_TOEPLITZ_HASH	GENMASK(18, 17)
688 #define RX_MSDU_END_INFO11_IP_FIXED_HDR_VALID	BIT(19)
689 #define RX_MSDU_END_INFO11_IP_EXTN_HDR_VALID	BIT(20)
690 #define RX_MSDU_END_INFO11_IP_TCP_UDP_HDR_VALID	BIT(21)
691 #define RX_MSDU_END_INFO11_MESH_CTRL_PRESENT	BIT(22)
692 #define RX_MSDU_END_INFO11_LDPC			BIT(23)
693 #define RX_MSDU_END_INFO11_IP4_IP6_NXT_HDR	GENMASK(31, 24)
694 
695 #define RX_MSDU_END_INFO12_USER_RSSI		GENMASK(7, 0)
696 #define RX_MSDU_END_INFO12_PKT_TYPE		GENMASK(11, 8)
697 #define RX_MSDU_END_INFO12_SGI			GENMASK(13, 12)
698 #define RX_MSDU_END_INFO12_RATE_MCS		GENMASK(17, 14)
699 #define RX_MSDU_END_INFO12_RECV_BW		GENMASK(20, 18)
700 #define RX_MSDU_END_INFO12_RECEPTION_TYPE	GENMASK(23, 21)
701 #define RX_MSDU_END_INFO12_MIMO_SS_BITMAP	GENMASK(30, 24)
702 #define RX_MSDU_END_INFO12_MIMO_DONE_COPY	BIT(31)
703 
704 #define RX_MSDU_END_INFO13_FIRST_MPDU		BIT(0)
705 #define RX_MSDU_END_INFO13_MCAST_BCAST		BIT(2)
706 #define RX_MSDU_END_INFO13_AST_IDX_NOT_FOUND	BIT(3)
707 #define RX_MSDU_END_INFO13_AST_IDX_TIMEDOUT	BIT(4)
708 #define RX_MSDU_END_INFO13_POWER_MGMT		BIT(5)
709 #define RX_MSDU_END_INFO13_NON_QOS		BIT(6)
710 #define RX_MSDU_END_INFO13_NULL_DATA		BIT(7)
711 #define RX_MSDU_END_INFO13_MGMT_TYPE		BIT(8)
712 #define RX_MSDU_END_INFO13_CTRL_TYPE		BIT(9)
713 #define RX_MSDU_END_INFO13_MORE_DATA		BIT(10)
714 #define RX_MSDU_END_INFO13_EOSP			BIT(11)
715 #define RX_MSDU_END_INFO13_A_MSDU_ERROR		BIT(12)
716 #define RX_MSDU_END_INFO13_ORDER		BIT(14)
717 #define RX_MSDU_END_INFO13_WIFI_PARSER_ERR	BIT(15)
718 #define RX_MSDU_END_INFO13_OVERFLOW_ERR		BIT(16)
719 #define RX_MSDU_END_INFO13_MSDU_LEN_ERR		BIT(17)
720 #define RX_MSDU_END_INFO13_TCP_UDP_CKSUM_FAIL	BIT(18)
721 #define RX_MSDU_END_INFO13_IP_CKSUM_FAIL	BIT(19)
722 #define RX_MSDU_END_INFO13_SA_IDX_INVALID	BIT(20)
723 #define RX_MSDU_END_INFO13_DA_IDX_INVALID	BIT(21)
724 #define RX_MSDU_END_INFO13_AMSDU_ADDR_MISMATCH	BIT(22)
725 #define RX_MSDU_END_INFO13_RX_IN_TX_DECRYPT_BYP	BIT(23)
726 #define RX_MSDU_END_INFO13_ENCRYPT_REQUIRED	BIT(24)
727 #define RX_MSDU_END_INFO13_DIRECTED		BIT(25)
728 #define RX_MSDU_END_INFO13_BUFFER_FRAGMENT	BIT(26)
729 #define RX_MSDU_END_INFO13_MPDU_LEN_ERR		BIT(27)
730 #define RX_MSDU_END_INFO13_TKIP_MIC_ERR		BIT(28)
731 #define RX_MSDU_END_INFO13_DECRYPT_ERR		BIT(29)
732 #define RX_MSDU_END_INFO13_UNDECRYPT_FRAME_ERR	BIT(30)
733 #define RX_MSDU_END_INFO13_FCS_ERR		BIT(31)
734 
735 #define RX_MSDU_END_INFO14_DECRYPT_STATUS_CODE	GENMASK(12, 10)
736 #define RX_MSDU_END_INFO14_RX_BITMAP_NOT_UPDED	BIT(13)
737 #define RX_MSDU_END_INFO14_MSDU_DONE		BIT(31)
738 
739 struct rx_msdu_end_qcn9274 {
740 	__le16 info0;
741 	__le16 phy_ppdu_id;
742 	__le16 ip_hdr_cksum;
743 	__le16 info1;
744 	__le16 info2;
745 	__le16 cumulative_l3_checksum;
746 	__le32 rule_indication0;
747 	__le32 ipv6_options_crc;
748 	__le16 info3;
749 	__le16 l3_type;
750 	__le32 rule_indication1;
751 	__le32 tcp_seq_num;
752 	__le32 tcp_ack_num;
753 	__le16 info4;
754 	__le16 window_size;
755 	__le16 sa_sw_peer_id;
756 	__le16 info5;
757 	__le16 sa_idx;
758 	__le16 da_idx_or_sw_peer_id;
759 	__le32 info6;
760 	__le32 fse_metadata;
761 	__le16 cce_metadata;
762 	__le16 tcp_udp_cksum;
763 	__le16 info7;
764 	__le16 cumulative_ip_length;
765 	__le32 info8;
766 	__le32 info9;
767 	__le32 info10;
768 	__le32 info11;
769 	__le16 vlan_ctag_ci;
770 	__le16 vlan_stag_ci;
771 	__le32 peer_meta_data;
772 	__le32 info12;
773 	__le32 flow_id_toeplitz;
774 	__le32 ppdu_start_timestamp_63_32;
775 	__le32 phy_meta_data;
776 	__le32 ppdu_start_timestamp_31_0;
777 	__le32 toeplitz_hash_2_or_4;
778 	__le16 res0;
779 	__le16 sa_15_0;
780 	__le32 sa_47_16;
781 	__le32 info13;
782 	__le32 info14;
783 } __packed;
784 
785 /* rx_msdu_end
786  *
787  * rxpcu_mpdu_filter_in_category
788  *		Field indicates what the reason was that this mpdu frame
789  *		was allowed to come into the receive path by rxpcu. Values
790  *		are defined in enum %RX_DESC_RXPCU_FILTER_*.
791  *
792  * sw_frame_group_id
793  *		SW processes frames based on certain classifications. Values
794  *		are defined in enum %RX_DESC_SW_FRAME_GRP_ID_*.
795  *
796  * phy_ppdu_id
797  *		A ppdu counter value that PHY increments for every PPDU
798  *		received. The counter value wraps around.
799  *
800  * ip_hdr_cksum
801  *		This can include the IP header checksum or the pseudo
802  *		header checksum used by TCP/UDP checksum.
803  *
804  * reported_mpdu_length
805  *		MPDU length before decapsulation. Only valid when first_msdu is
806  *		set. This field is taken directly from the length field of the
807  *		A-MPDU delimiter or the preamble length field for non-A-MPDU
808  *		frames.
809  *
810  * cce_super_rule
811  *		Indicates the super filter rule.
812  *
813  * cce_classify_not_done_truncate
814  *		Classification failed due to truncated frame.
815  *
816  * cce_classify_not_done_cce_dis
817  *		Classification failed due to CCE global disable
818  *
819  * cumulative_l3_checksum
820  *		FISA: IP header checksum including the total MSDU length
821  *		that is part of this flow aggregated so far, reported if
822  *		'RXOLE_R0_FISA_CTRL. CHKSUM_CUM_IP_LEN_EN' is set
823  *
824  * rule_indication
825  *		Bitmap indicating which of rules have matched.
826  *
827  * ipv6_options_crc
828  *		32 bit CRC computed out of  IP v6 extension headers.
829  *
830  * da_offset
831  *		Offset into MSDU buffer for DA.
832  *
833  * sa_offset
834  *		Offset into MSDU buffer for SA.
835  *
836  * da_offset_valid
837  *		da_offset field is valid. This will be set to 0 in case
838  *		of a dynamic A-MSDU when DA is compressed.
839  *
840  * sa_offset_valid
841  *		sa_offset field is valid. This will be set to 0 in case
842  *		of a dynamic A-MSDU when SA is compressed.
843  *
844  * l3_type
845  *		The 16-bit type value indicating the type of L3 later
846  *		extracted from LLC/SNAP, set to zero if SNAP is not
847  *		available.
848  *
849  * tcp_seq_number
850  *		TCP sequence number.
851  *
852  * tcp_ack_number
853  *		TCP acknowledge number.
854  *
855  * tcp_flag
856  *		TCP flags {NS, CWR, ECE, URG, ACK, PSH, RST, SYN, FIN}.
857  *
858  * lro_eligible
859  *		Computed out of TCP and IP fields to indicate that this
860  *		MSDU is eligible for LRO.
861  *
862  * window_size
863  *		TCP receive window size.
864  *
865  * sa_sw_peer_id
866  *		sw_peer_id from the address search entry corresponding to the
867  *		source address of the MSDU.
868  *
869  * sa_idx_timeout
870  *		Indicates an unsuccessful MAC source address search due to the
871  *		expiring of the search timer.
872  *
873  * da_idx_timeout
874  *		Indicates an unsuccessful MAC destination address search due to
875  *		the expiring of the search timer.
876  *
877  * to_ds
878  *		Set if the to DS bit is set in the frame control.
879  *
880  * tid
881  *		TID field in the QoS control field
882  *
883  * sa_is_valid
884  *		Indicates that OLE found a valid SA entry.
885  *
886  * da_is_valid
887  *		Indicates that OLE found a valid DA entry.
888  *
889  * da_is_mcbc
890  *		Field Only valid if da_is_valid is set. Indicates the DA address
891  *		was a Multicast of Broadcast address.
892  *
893  * l3_header_padding
894  *		Number of bytes padded  to make sure that the L3 header will
895  *		always start of a Dword boundary.
896  *
897  * first_msdu
898  *		Indicates the first MSDU of A-MSDU. If both first_msdu and
899  *		last_msdu are set in the MSDU then this is a non-aggregated MSDU
900  *		frame: normal MPDU. Interior MSDU in an A-MSDU shall have both
901  *		first_mpdu and last_mpdu bits set to 0.
902  *
903  * last_msdu
904  *		Indicates the last MSDU of the A-MSDU. MPDU end status is only
905  *		valid when last_msdu is set.
906  *
907  * fr_ds
908  *		Set if the from DS bit is set in the frame control.
909  *
910  * ip_chksum_fail_copy
911  *		Indicates that the computed checksum did not match the
912  *		checksum in the IP header.
913  *
914  * sa_idx
915  *		The offset in the address table which matches the MAC source
916  *		address.
917  *
918  * da_idx_or_sw_peer_id
919  *		Based on a register configuration in RXOLE, this field will
920  *		contain:
921  *		The offset in the address table which matches the MAC destination
922  *		address
923  *		OR:
924  *		sw_peer_id from the address search entry corresponding to
925  *		the destination address of the MSDU
926  *
927  * msdu_drop
928  *		REO shall drop this MSDU and not forward it to any other ring.
929  *
930  *		The id of the reo exit ring where the msdu frame shall push
931  *		after (MPDU level) reordering has finished. Values are defined
932  *		in enum %HAL_RX_MSDU_DESC_REO_DEST_IND_.
933  *
934  * flow_idx
935  *		Flow table index.
936  *
937  * use_ppe
938  *		Indicates to RXDMA to ignore the REO_destination_indication
939  *		and use a programmed value corresponding to the REO2PPE
940  *		ring
941  *
942  * mesh_sta
943  *		When set, this is a Mesh (11s) STA.
944  *
945  * vlan_ctag_stripped
946  *		Set by RXOLE if it stripped 4-bytes of C-VLAN Tag from the
947  *		packet
948  *
949  * vlan_stag_stripped
950  *		Set by RXOLE if it stripped 4-bytes of S-VLAN Tag from the
951  *		packet
952  *
953  * fragment_flag
954  *		Indicates that this is an 802.11 fragment frame.  This is
955  *		set when either the more_frag bit is set in the frame control
956  *		or the fragment number is not zero.  Only set when first_msdu
957  *		is set.
958  *
959  * fse_metadata
960  *		FSE related meta data.
961  *
962  * cce_metadata
963  *		CCE related meta data.
964  *
965  * tcp_udp_chksum
966  *		The value of the computed TCP/UDP checksum.  A mode bit
967  *		selects whether this checksum is the full checksum or the
968  *		partial checksum which does not include the pseudo header.
969  *
970  * aggregation_count
971  *		Number of MSDU's aggregated so far
972  *
973  * flow_aggregation_continuation
974  *		To indicate that this MSDU can be aggregated with
975  *		the previous packet with the same flow id
976  *
977  * fisa_timeout
978  *		To indicate that the aggregation has restarted for
979  *		this flow due to timeout
980  *
981  * tcp_udp_chksum_fail
982  *		Indicates that the computed checksum (tcp_udp_chksum) did
983  *		not match the checksum in the TCP/UDP header.
984  *
985  * msdu_limit_error
986  *		Indicates that the MSDU threshold was exceeded and thus all the
987  *		rest of the MSDUs will not be scattered and will not be
988  *		decapsulated but will be DMA'ed in RAW format as a single MSDU.
989  *
990  * flow_idx_timeout
991  *		Indicates an unsuccessful flow search due to the expiring of
992  *		the search timer.
993  *
994  * flow_idx_invalid
995  *		flow id is not valid.
996  *
997  * cce_match
998  *		Indicates that this status has a corresponding MSDU that
999  *		requires FW processing. The OLE will have classification
1000  *		ring mask registers which will indicate the ring(s) for
1001  *		packets and descriptors which need FW attention.
1002  *
1003  * amsdu_parser_error
1004  *		A-MSDU could not be properly de-agregated.
1005  *
1006  * cumulative_ip_length
1007  *		Total MSDU length that is part of this flow aggregated
1008  *		so far
1009  *
1010  * key_id
1011  *		The key ID octet from the IV. Only valid when first_msdu is set.
1012  *
1013  * service_code
1014  *		Opaque service code between PPE and Wi-Fi
1015  *
1016  * priority_valid
1017  *		This field gets passed on by REO to PPE in the EDMA descriptor
1018  *
1019  * intra_bss
1020  *		This packet needs intra-BSS routing by SW as the 'vdev_id'
1021  *		for the destination is the same as 'vdev_id' (from 'RX_MPDU_PCU_START')
1022  *		that this MSDU was got in.
1023  *
1024  * dest_chip_id
1025  *		If intra_bss is set, copied by RXOLE from 'ADDR_SEARCH_ENTRY'
1026  *		to support intra-BSS routing with multi-chip multi-link
1027  *		operation. This indicates into which chip's TCL the packet should be
1028  *		queueued
1029  *
1030  * multicast_echo
1031  *		If set, this packet is a multicast echo, i.e. the DA is
1032  *		multicast and Rx OLE SA search with mcast_echo_check = 1
1033  *		passed. RXDMA should release such packets to WBM.
1034  *
1035  * wds_learning_event
1036  *		If set, this packet has an SA search failure with WDS learning
1037  *		enabled for the peer. RXOLE should route this TLV to the
1038  *		RXDMA0 status ring to notify FW.
1039  *
1040  * wds_roaming_event
1041  *		If set, this packet's SA 'Sw_peer_id' mismatches the 'Sw_peer_id'
1042  *		of the peer through which the packet was got, indicating
1043  *		the SA node has roamed. RXOLE should route this TLV to
1044  *		the RXDMA0 status ring to notify FW.
1045  *
1046  * wds_keep_alive_event
1047  *		If set, the AST timestamp for this packet's SA is older
1048  *		than the current timestamp by more than a threshold programmed
1049  *		in RXOLE. RXOLE should route this TLV to the RXDMA0 status
1050  *		ring to notify FW to keep the AST entry for the SA alive.
1051  *
1052  * msdu_length
1053  *		MSDU length in bytes after decapsulation.
1054  *		This field is still valid for MPDU frames without A-MSDU.
1055  *		It still represents MSDU length after decapsulation
1056  *
1057  * stbc
1058  *		When set, use STBC transmission rates.
1059  *
1060  * ipsec_esp
1061  *		Set if IPv4/v6 packet is using IPsec ESP.
1062  *
1063  * l3_offset
1064  *		Depending upon mode bit, this field either indicates the
1065  *		L3 offset in bytes from the start of the RX_HEADER or the IP
1066  *		offset in bytes from the start of the packet after
1067  *		decapsulation. The latter is only valid if ipv4_proto or
1068  *		ipv6_proto is set.
1069  *
1070  * ipsec_ah
1071  *		Set if IPv4/v6 packet is using IPsec AH
1072  *
1073  * l4_offset
1074  *		Depending upon mode bit, this field either indicates the
1075  *		L4 offset in bytes from the start of RX_HEADER (only valid
1076  *		if either ipv4_proto or ipv6_proto is set to 1) or indicates
1077  *		the offset in bytes to the start of TCP or UDP header from
1078  *		the start of the IP header after decapsulation (Only valid if
1079  *		tcp_proto or udp_proto is set). The value 0 indicates that
1080  *		the offset is longer than 127 bytes.
1081  *
1082  * msdu_number
1083  *		Indicates the MSDU number within a MPDU.  This value is
1084  *		reset to zero at the start of each MPDU.  If the number of
1085  *		MSDU exceeds 255 this number will wrap using modulo 256.
1086  *
1087  * decap_type
1088  *		Indicates the format after decapsulation. Values are defined in
1089  *		enum %MPDU_START_DECAP_TYPE_*.
1090  *
1091  * ipv4_proto
1092  *		Set if L2 layer indicates IPv4 protocol.
1093  *
1094  * ipv6_proto
1095  *		Set if L2 layer indicates IPv6 protocol.
1096  *
1097  * tcp_proto
1098  *		Set if the ipv4_proto or ipv6_proto are set and the IP protocol
1099  *		indicates TCP.
1100  *
1101  * udp_proto
1102  *		Set if the ipv4_proto or ipv6_proto are set and the IP protocol
1103  *		indicates UDP.
1104  *
1105  * ip_frag
1106  *		Indicates that either the IP More frag bit is set or IP frag
1107  *		number is non-zero.  If set indicates that this is a fragmented
1108  *		IP packet.
1109  *
1110  * tcp_only_ack
1111  *		Set if only the TCP Ack bit is set in the TCP flags and if
1112  *		the TCP payload is 0.
1113  *
1114  * da_is_bcast_mcast
1115  *		The destination address is broadcast or multicast.
1116  *
1117  * toeplitz_hash
1118  *		Actual chosen Hash.
1119  *		0 - Toeplitz hash of 2-tuple (IP source address, IP
1120  *		    destination address)
1121  *		1 - Toeplitz hash of 4-tuple (IP source	address,
1122  *		    IP destination address, L4 (TCP/UDP) source port,
1123  *		    L4 (TCP/UDP) destination port)
1124  *		2 - Toeplitz of flow_id
1125  *		3 - Zero is used
1126  *
1127  * ip_fixed_header_valid
1128  *		Fixed 20-byte IPv4 header or 40-byte IPv6 header parsed
1129  *		fully within first 256 bytes of the packet
1130  *
1131  * ip_extn_header_valid
1132  *		IPv6/IPv6 header, including IPv4 options and
1133  *		recognizable extension headers parsed fully within first 256
1134  *		bytes of the packet
1135  *
1136  * tcp_udp_header_valid
1137  *		Fixed 20-byte TCP (excluding TCP options) or 8-byte UDP
1138  *		header parsed fully within first 256 bytes of the packet
1139  *
1140  * mesh_control_present
1141  *		When set, this MSDU includes the 'Mesh Control' field
1142  *
1143  * ldpc
1144  *
1145  * ip4_protocol_ip6_next_header
1146  *		For IPv4, this is the 8 bit protocol field set). For IPv6 this
1147  *		is the 8 bit next_header field.
1148  *
1149  *
1150  * vlan_ctag_ci
1151  *		2 bytes of C-VLAN Tag Control Information from WHO_L2_LLC
1152  *
1153  * vlan_stag_ci
1154  *		2 bytes of S-VLAN Tag Control Information from WHO_L2_LLC
1155  *		in case of double VLAN
1156  *
1157  * peer_meta_data
1158  *		Meta data that SW has programmed in the Peer table entry
1159  *		of the transmitting STA.
1160  *
1161  * user_rssi
1162  *		RSSI for this user
1163  *
1164  * pkt_type
1165  *		Values are defined in enum %RX_MSDU_START_PKT_TYPE_*.
1166  *
1167  * sgi
1168  *		Field only valid when pkt type is HT, VHT or HE. Values are
1169  *		defined in enum %RX_MSDU_START_SGI_*.
1170  *
1171  * rate_mcs
1172  *		MCS Rate used.
1173  *
1174  * receive_bandwidth
1175  *		Full receive Bandwidth. Values are defined in enum
1176  *		%RX_MSDU_START_RECV_*.
1177  *
1178  * reception_type
1179  *		Indicates what type of reception this is and defined in enum
1180  *		%RX_MSDU_START_RECEPTION_TYPE_*.
1181  *
1182  * mimo_ss_bitmap
1183  *		Field only valid when
1184  *		Reception_type is RX_MSDU_START_RECEPTION_TYPE_DL_MU_MIMO or
1185  *		RX_MSDU_START_RECEPTION_TYPE_DL_MU_OFDMA_MIMO.
1186  *
1187  *		Bitmap, with each bit indicating if the related spatial
1188  *		stream is used for this STA
1189  *
1190  *		LSB related to SS 0
1191  *
1192  *		0 - spatial stream not used for this reception
1193  *		1 - spatial stream used for this reception
1194  *
1195  * msdu_done_copy
1196  *		If set indicates that the RX packet data, RX header data,
1197  *		RX PPDU start descriptor, RX MPDU start/end descriptor,
1198  *		RX MSDU start/end descriptors and RX Attention descriptor
1199  *		are all valid.  This bit is in the last 64-bit of the descriptor
1200  *		expected to be subscribed in future hardware.
1201  *
1202  * flow_id_toeplitz
1203  *		Toeplitz hash of 5-tuple
1204  *		{IP source address, IP destination address, IP source port, IP
1205  *		destination port, L4 protocol}  in case of non-IPSec.
1206  *
1207  *		In case of IPSec - Toeplitz hash of 4-tuple
1208  *		{IP source address, IP destination address, SPI, L4 protocol}
1209  *
1210  *		The relevant Toeplitz key registers are provided in RxOLE's
1211  *		instance of common parser module. These registers are separate
1212  *		from the Toeplitz keys used by ASE/FSE modules inside RxOLE.
1213  *		The actual value will be passed on from common parser module
1214  *		to RxOLE in one of the WHO_* TLVs.
1215  *
1216  * ppdu_start_timestamp
1217  *		Timestamp that indicates when the PPDU that contained this MPDU
1218  *		started on the medium.
1219  *
1220  * phy_meta_data
1221  *		SW programmed Meta data provided by the PHY. Can be used for SW
1222  *		to indicate the channel the device is on.
1223  *
1224  * toeplitz_hash_2_or_4
1225  *		Controlled by multiple RxOLE registers for TCP/UDP over
1226  *		IPv4/IPv6 - Either, Toeplitz hash computed over 2-tuple
1227  *		IPv4 or IPv6 src/dest addresses is reported; or, Toeplitz
1228  *		hash computed over 4-tuple IPv4 or IPv6 src/dest addresses
1229  *		and src/dest ports is reported. The Flow_id_toeplitz hash
1230  *		can also be reported here. Usually the hash reported here
1231  *		is the one used for hash-based REO routing (see use_flow_id_toeplitz_clfy
1232  *		in 'RXPT_CLASSIFY_INFO').
1233  *
1234  * sa
1235  *		Source MAC address
1236  *
1237  * first_mpdu
1238  *		Indicates the first MSDU of the PPDU.  If both first_mpdu
1239  *		and last_mpdu are set in the MSDU then this is a not an
1240  *		A-MPDU frame but a stand alone MPDU.  Interior MPDU in an
1241  *		A-MPDU shall have both first_mpdu and last_mpdu bits set to
1242  *		0.  The PPDU start status will only be valid when this bit
1243  *		is set.
1244  *
1245  * mcast_bcast
1246  *		Multicast / broadcast indicator.  Only set when the MAC
1247  *		address 1 bit 0 is set indicating mcast/bcast and the BSSID
1248  *		matches one of the 4 BSSID registers. Only set when
1249  *		first_msdu is set.
1250  *
1251  * ast_index_not_found
1252  *		Only valid when first_msdu is set. Indicates no AST matching
1253  *		entries within the max search count.
1254  *
1255  * ast_index_timeout
1256  *		Only valid when first_msdu is set. Indicates an unsuccessful
1257  *		search in the address search table due to timeout.
1258  *
1259  * power_mgmt
1260  *		Power management bit set in the 802.11 header.  Only set
1261  *		when first_msdu is set.
1262  *
1263  * non_qos
1264  *		Set if packet is not a non-QoS data frame.  Only set when
1265  *		first_msdu is set.
1266  *
1267  * null_data
1268  *		Set if frame type indicates either null data or QoS null
1269  *		data format.  Only set when first_msdu is set.
1270  *
1271  * mgmt_type
1272  *		Set if packet is a management packet.  Only set when
1273  *		first_msdu is set.
1274  *
1275  * ctrl_type
1276  *		Set if packet is a control packet.  Only set when first_msdu
1277  *		is set.
1278  *
1279  * more_data
1280  *		Set if more bit in frame control is set.  Only set when
1281  *		first_msdu is set.
1282  *
1283  * eosp
1284  *		Set if the EOSP (end of service period) bit in the QoS
1285  *		control field is set.  Only set when first_msdu is set.
1286  *
1287  * a_msdu_error
1288  *		Set if number of MSDUs in A-MSDU is above a threshold or if the
1289  *		size of the MSDU is invalid. This receive buffer will contain
1290  *		all of the remainder of MSDUs in this MPDU w/o decapsulation.
1291  *
1292  * order
1293  *		Set if the order bit in the frame control is set.  Only
1294  *		set when first_msdu is set.
1295  *
1296  * wifi_parser_error
1297  *		Indicates that the WiFi frame has one of the following errors
1298  *
1299  * overflow_err
1300  *		RXPCU Receive FIFO ran out of space to receive the full MPDU.
1301  *		Therefore this MPDU is terminated early and is thus corrupted.
1302  *
1303  *		This MPDU will not be ACKed.
1304  *
1305  *		RXPCU might still be able to correctly receive the following
1306  *		MPDUs in the PPDU if enough fifo space became available in time.
1307  *
1308  * mpdu_length_err
1309  *		Set by RXPCU if the expected MPDU length does not correspond
1310  *		with the actually received number of bytes in the MPDU.
1311  *
1312  * tcp_udp_chksum_fail
1313  *		Indicates that the computed checksum (tcp_udp_chksum) did
1314  *		not match the checksum in the TCP/UDP header.
1315  *
1316  * ip_chksum_fail
1317  *		Indicates that the computed checksum did not match the
1318  *		checksum in the IP header.
1319  *
1320  * sa_idx_invalid
1321  *		Indicates no matching entry was found in the address search
1322  *		table for the source MAC address.
1323  *
1324  * da_idx_invalid
1325  *		Indicates no matching entry was found in the address search
1326  *		table for the destination MAC address.
1327  *
1328  * amsdu_addr_mismatch
1329  *		Indicates that an A-MSDU with 'from DS = 0' had an SA mismatching
1330  *		TA or an A-MDU with 'to DS = 0' had a DA mismatching RA
1331  *
1332  * rx_in_tx_decrypt_byp
1333  *		Indicates that RX packet is not decrypted as Crypto is busy
1334  *		with TX packet processing.
1335  *
1336  * encrypt_required
1337  *		Indicates that this data type frame is not encrypted even if
1338  *		the policy for this MPDU requires encryption as indicated in
1339  *		the peer table key type.
1340  *
1341  * directed
1342  *		MPDU is a directed packet which means that the RA matched
1343  *		our STA addresses.  In proxySTA it means that the TA matched
1344  *		an entry in our address search table with the corresponding
1345  *		'no_ack' bit is the address search entry cleared.
1346  *
1347  * buffer_fragment
1348  *		Indicates that at least one of the rx buffers has been
1349  *		fragmented.  If set the FW should look at the rx_frag_info
1350  *		descriptor described below.
1351  *
1352  * mpdu_length_err
1353  *		Indicates that the MPDU was pre-maturely terminated
1354  *		resulting in a truncated MPDU.  Don't trust the MPDU length
1355  *		field.
1356  *
1357  * tkip_mic_err
1358  *		Indicates that the MPDU Michael integrity check failed
1359  *
1360  * decrypt_err
1361  *		Indicates that the MPDU decrypt integrity check failed
1362  *
1363  * fcs_err
1364  *		Indicates that the MPDU FCS check failed
1365  *
1366  * flow_idx_timeout
1367  *		Indicates an unsuccessful flow search due to the expiring of
1368  *		the search timer.
1369  *
1370  * flow_idx_invalid
1371  *		flow id is not valid.
1372  *
1373  * decrypt_status_code
1374  *		Field provides insight into the decryption performed. Values
1375  *		are defined in enum %RX_DESC_DECRYPT_STATUS_CODE_*.
1376  *
1377  * rx_bitmap_not_updated
1378  *		Frame is received, but RXPCU could not update the receive bitmap
1379  *		due to (temporary) fifo constraints.
1380  *
1381  * msdu_done
1382  *		If set indicates that the RX packet data, RX header data, RX
1383  *		PPDU start descriptor, RX MPDU start/end descriptor, RX MSDU
1384  *		start/end descriptors and RX Attention descriptor are all
1385  *		valid.  This bit must be in the last octet of the
1386  *		descriptor.
1387  *
1388  */
1389 
1390 /* TODO: Move to compact TLV approach
1391  * By default these tlv's are not aligned to 128b boundary
1392  * Need to remove unused qwords and make them compact/aligned
1393  */
1394 struct hal_rx_desc_qcn9274 {
1395 	struct rx_msdu_end_qcn9274 msdu_end;
1396 	struct rx_mpdu_start_qcn9274 mpdu_start;
1397 	u8 msdu_payload[];
1398 } __packed;
1399 
1400 #define RX_BE_PADDING0_BYTES 8
1401 #define RX_BE_PADDING1_BYTES 8
1402 
1403 #define HAL_RX_BE_PKT_HDR_TLV_LEN		112
1404 
1405 struct rx_pkt_hdr_tlv {
1406 	__le64 tag;
1407 	__le64 phy_ppdu_id;
1408 	u8 rx_pkt_hdr[HAL_RX_BE_PKT_HDR_TLV_LEN];
1409 };
1410 
1411 struct hal_rx_desc_wcn7850 {
1412 	__le64 msdu_end_tag;
1413 	struct rx_msdu_end_qcn9274 msdu_end;
1414 	u8 rx_padding0[RX_BE_PADDING0_BYTES];
1415 	__le64 mpdu_start_tag;
1416 	struct rx_mpdu_start_qcn9274 mpdu_start;
1417 	struct rx_pkt_hdr_tlv	 pkt_hdr_tlv;
1418 	u8 msdu_payload[];
1419 };
1420 
1421 struct hal_rx_desc {
1422 	union {
1423 		struct hal_rx_desc_qcn9274 qcn9274;
1424 		struct hal_rx_desc_wcn7850 wcn7850;
1425 	} u;
1426 } __packed;
1427 
1428 #define MAX_USER_POS 8
1429 #define MAX_MU_GROUP_ID 64
1430 #define MAX_MU_GROUP_SHOW 16
1431 #define MAX_MU_GROUP_LENGTH (6 * MAX_MU_GROUP_SHOW)
1432 
1433 #define HAL_RX_RU_ALLOC_TYPE_MAX 6
1434 #define RU_26  1
1435 #define RU_52  2
1436 #define RU_106 4
1437 #define RU_242 9
1438 #define RU_484 18
1439 #define RU_996 37
1440 
1441 #endif /* ATH12K_RX_DESC_H */
1442