xref: /freebsd/sys/contrib/dev/athk/ath11k/hw.h (revision 4ed5b949d5e25456124a4d280d27e9719f90e9be)
1 /* SPDX-License-Identifier: BSD-3-Clause-Clear */
2 /*
3  * Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.
4  * Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
5  */
6 
7 #ifndef ATH11K_HW_H
8 #define ATH11K_HW_H
9 
10 #include "hal.h"
11 #include "wmi.h"
12 
13 /* Target configuration defines */
14 
15 /* Num VDEVS per radio */
16 #define TARGET_NUM_VDEVS(ab)	(ab->hw_params.num_vdevs)
17 
18 #define TARGET_NUM_PEERS_PDEV(ab) (ab->hw_params.num_peers + TARGET_NUM_VDEVS(ab))
19 
20 /* Num of peers for Single Radio mode */
21 #define TARGET_NUM_PEERS_SINGLE(ab) (TARGET_NUM_PEERS_PDEV(ab))
22 
23 /* Num of peers for DBS */
24 #define TARGET_NUM_PEERS_DBS(ab) (2 * TARGET_NUM_PEERS_PDEV(ab))
25 
26 /* Num of peers for DBS_SBS */
27 #define TARGET_NUM_PEERS_DBS_SBS(ab)	(3 * TARGET_NUM_PEERS_PDEV(ab))
28 
29 /* Max num of stations (per radio) */
30 #define TARGET_NUM_STATIONS(ab)	(ab->hw_params.num_peers)
31 
32 #define TARGET_NUM_PEERS(ab, x)	TARGET_NUM_PEERS_##x(ab)
33 #define TARGET_NUM_PEER_KEYS	2
34 #define TARGET_NUM_TIDS(ab, x)	(2 * TARGET_NUM_PEERS(ab, x) +	\
35 				 4 * TARGET_NUM_VDEVS(ab) + 8)
36 
37 #define TARGET_AST_SKID_LIMIT	16
38 #define TARGET_NUM_OFFLD_PEERS	4
39 #define TARGET_NUM_OFFLD_REORDER_BUFFS 4
40 
41 #define TARGET_TX_CHAIN_MASK	(BIT(0) | BIT(1) | BIT(2) | BIT(4))
42 #define TARGET_RX_CHAIN_MASK	(BIT(0) | BIT(1) | BIT(2) | BIT(4))
43 #define TARGET_RX_TIMEOUT_LO_PRI	100
44 #define TARGET_RX_TIMEOUT_HI_PRI	40
45 
46 #define TARGET_DECAP_MODE_RAW		0
47 #define TARGET_DECAP_MODE_NATIVE_WIFI	1
48 #define TARGET_DECAP_MODE_ETH		2
49 
50 #define TARGET_SCAN_MAX_PENDING_REQS	4
51 #define TARGET_BMISS_OFFLOAD_MAX_VDEV	3
52 #define TARGET_ROAM_OFFLOAD_MAX_VDEV	3
53 #define TARGET_ROAM_OFFLOAD_MAX_AP_PROFILES	8
54 #define TARGET_GTK_OFFLOAD_MAX_VDEV	3
55 #define TARGET_NUM_MCAST_GROUPS		12
56 #define TARGET_NUM_MCAST_TABLE_ELEMS	64
57 #define TARGET_MCAST2UCAST_MODE		2
58 #define TARGET_TX_DBG_LOG_SIZE		1024
59 #define TARGET_RX_SKIP_DEFRAG_TIMEOUT_DUP_DETECTION_CHECK 1
60 #define TARGET_VOW_CONFIG		0
61 #define TARGET_NUM_MSDU_DESC		(2500)
62 #define TARGET_MAX_FRAG_ENTRIES		6
63 #define TARGET_MAX_BCN_OFFLD		16
64 #define TARGET_NUM_WDS_ENTRIES		32
65 #define TARGET_DMA_BURST_SIZE		1
66 #define TARGET_RX_BATCHMODE		1
67 #define TARGET_EMA_MAX_PROFILE_PERIOD	8
68 
69 #define ATH11K_HW_MAX_QUEUES		4
70 #define ATH11K_QUEUE_LEN		4096
71 
72 #define ATH11k_HW_RATECODE_CCK_SHORT_PREAM_MASK  0x4
73 
74 #define ATH11K_FW_DIR			"ath11k"
75 
76 #define ATH11K_BOARD_MAGIC		"QCA-ATH11K-BOARD"
77 #define ATH11K_BOARD_API2_FILE		"board-2.bin"
78 #define ATH11K_DEFAULT_BOARD_FILE	"board.bin"
79 #define ATH11K_DEFAULT_CAL_FILE		"caldata.bin"
80 #define ATH11K_AMSS_FILE		"amss.bin"
81 #define ATH11K_M3_FILE			"m3.bin"
82 #define ATH11K_REGDB_FILE_NAME		"regdb.bin"
83 
84 #if defined(__linux__)
85 #define ATH11K_CE_OFFSET(ab)	(ab->mem_ce - ab->mem)
86 #elif defined(__FreeBSD__)
87 #define ATH11K_CE_OFFSET(ab)	((char *)ab->mem_ce - (char *)ab->mem)
88 #endif
89 
90 enum ath11k_hw_rate_cck {
91 	ATH11K_HW_RATE_CCK_LP_11M = 0,
92 	ATH11K_HW_RATE_CCK_LP_5_5M,
93 	ATH11K_HW_RATE_CCK_LP_2M,
94 	ATH11K_HW_RATE_CCK_LP_1M,
95 	ATH11K_HW_RATE_CCK_SP_11M,
96 	ATH11K_HW_RATE_CCK_SP_5_5M,
97 	ATH11K_HW_RATE_CCK_SP_2M,
98 };
99 
100 enum ath11k_hw_rate_ofdm {
101 	ATH11K_HW_RATE_OFDM_48M = 0,
102 	ATH11K_HW_RATE_OFDM_24M,
103 	ATH11K_HW_RATE_OFDM_12M,
104 	ATH11K_HW_RATE_OFDM_6M,
105 	ATH11K_HW_RATE_OFDM_54M,
106 	ATH11K_HW_RATE_OFDM_36M,
107 	ATH11K_HW_RATE_OFDM_18M,
108 	ATH11K_HW_RATE_OFDM_9M,
109 };
110 
111 enum ath11k_bus {
112 	ATH11K_BUS_AHB,
113 	ATH11K_BUS_PCI,
114 };
115 
116 #define ATH11K_EXT_IRQ_GRP_NUM_MAX 11
117 
118 struct hal_rx_desc;
119 struct hal_tcl_data_cmd;
120 
121 struct ath11k_hw_ring_mask {
122 	u8 tx[ATH11K_EXT_IRQ_GRP_NUM_MAX];
123 	u8 rx_mon_status[ATH11K_EXT_IRQ_GRP_NUM_MAX];
124 	u8 rx[ATH11K_EXT_IRQ_GRP_NUM_MAX];
125 	u8 rx_err[ATH11K_EXT_IRQ_GRP_NUM_MAX];
126 	u8 rx_wbm_rel[ATH11K_EXT_IRQ_GRP_NUM_MAX];
127 	u8 reo_status[ATH11K_EXT_IRQ_GRP_NUM_MAX];
128 	u8 rxdma2host[ATH11K_EXT_IRQ_GRP_NUM_MAX];
129 	u8 host2rxdma[ATH11K_EXT_IRQ_GRP_NUM_MAX];
130 };
131 
132 struct ath11k_hw_tcl2wbm_rbm_map {
133 	u8 tcl_ring_num;
134 	u8 wbm_ring_num;
135 	u8 rbm_id;
136 };
137 
138 struct ath11k_hw_hal_params {
139 	enum hal_rx_buf_return_buf_manager rx_buf_rbm;
140 	const struct ath11k_hw_tcl2wbm_rbm_map *tcl2wbm_rbm_map;
141 	size_t num_tx_rings;
142 };
143 
144 struct ath11k_hw_params {
145 	const char *name;
146 	u16 hw_rev;
147 	u8 max_radios;
148 	u32 bdf_addr;
149 
150 	struct {
151 		const char *dir;
152 		size_t board_size;
153 		size_t cal_offset;
154 	} fw;
155 
156 	const struct ath11k_hw_ops *hw_ops;
157 	const struct ath11k_hw_ring_mask *ring_mask;
158 
159 	bool internal_sleep_clock;
160 
161 	const struct ath11k_hw_regs *regs;
162 	u32 qmi_service_ins_id;
163 	const struct ce_attr *host_ce_config;
164 	u32 ce_count;
165 	const struct ce_pipe_config *target_ce_config;
166 	u32 target_ce_count;
167 	const struct service_to_pipe *svc_to_ce_map;
168 	u32 svc_to_ce_map_len;
169 	const struct ce_ie_addr *ce_ie_addr;
170 	const struct ce_remap *ce_remap;
171 
172 	bool single_pdev_only;
173 
174 	bool rxdma1_enable;
175 	int num_rxdma_per_pdev;
176 	bool rx_mac_buf_ring;
177 	bool vdev_start_delay;
178 	bool htt_peer_map_v2;
179 
180 	struct {
181 		u8 fft_sz;
182 		u8 fft_pad_sz;
183 		u8 summary_pad_sz;
184 		u8 fft_hdr_len;
185 		u16 max_fft_bins;
186 		bool fragment_160mhz;
187 	} spectral;
188 
189 	u16 interface_modes;
190 	bool supports_monitor;
191 	bool full_monitor_mode;
192 	bool supports_shadow_regs;
193 	bool idle_ps;
194 	bool supports_sta_ps;
195 	bool coldboot_cal_mm;
196 	bool coldboot_cal_ftm;
197 	bool cbcal_restart_fw;
198 	int fw_mem_mode;
199 	u32 num_vdevs;
200 	u32 num_peers;
201 	bool supports_suspend;
202 	u32 hal_desc_sz;
203 	bool supports_regdb;
204 	bool fix_l1ss;
205 	bool credit_flow;
206 	const struct ath11k_hw_hal_params *hal_params;
207 	bool supports_dynamic_smps_6ghz;
208 	bool alloc_cacheable_memory;
209 	bool supports_rssi_stats;
210 	bool fw_wmi_diag_event;
211 	bool current_cc_support;
212 	bool dbr_debug_support;
213 	bool global_reset;
214 	const struct cfg80211_sar_capa *bios_sar_capa;
215 	bool m3_fw_support;
216 	bool fixed_bdf_addr;
217 	bool fixed_mem_region;
218 	bool static_window_map;
219 	bool hybrid_bus_type;
220 	bool fixed_fw_mem;
221 	bool support_off_channel_tx;
222 	bool supports_multi_bssid;
223 
224 	struct {
225 		u32 start;
226 		u32 end;
227 	} sram_dump;
228 
229 	bool tcl_ring_retry;
230 	u32 tx_ring_size;
231 	bool smp2p_wow_exit;
232 	bool support_fw_mac_sequence;
233 	bool support_dual_stations;
234 	bool pdev_suspend;
235 	bool cfr_support;
236 	u32 cfr_num_stream_bufs;
237 	u32 cfr_stream_buf_size;
238 };
239 
240 struct ath11k_hw_ops {
241 	u8 (*get_hw_mac_from_pdev_id)(int pdev_id);
242 	void (*wmi_init_config)(struct ath11k_base *ab,
243 				struct target_resource_config *config);
244 	int (*mac_id_to_pdev_id)(struct ath11k_hw_params *hw, int mac_id);
245 	int (*mac_id_to_srng_id)(struct ath11k_hw_params *hw, int mac_id);
246 	void (*tx_mesh_enable)(struct ath11k_base *ab,
247 			       struct hal_tcl_data_cmd *tcl_cmd);
248 	bool (*rx_desc_get_first_msdu)(struct hal_rx_desc *desc);
249 	bool (*rx_desc_get_last_msdu)(struct hal_rx_desc *desc);
250 	u8 (*rx_desc_get_l3_pad_bytes)(struct hal_rx_desc *desc);
251 	u8 *(*rx_desc_get_hdr_status)(struct hal_rx_desc *desc);
252 	bool (*rx_desc_encrypt_valid)(struct hal_rx_desc *desc);
253 	u32 (*rx_desc_get_encrypt_type)(struct hal_rx_desc *desc);
254 	u8 (*rx_desc_get_decap_type)(struct hal_rx_desc *desc);
255 	u8 (*rx_desc_get_mesh_ctl)(struct hal_rx_desc *desc);
256 	bool (*rx_desc_get_ldpc_support)(struct hal_rx_desc *desc);
257 	bool (*rx_desc_get_mpdu_seq_ctl_vld)(struct hal_rx_desc *desc);
258 	bool (*rx_desc_get_mpdu_fc_valid)(struct hal_rx_desc *desc);
259 	u16 (*rx_desc_get_mpdu_start_seq_no)(struct hal_rx_desc *desc);
260 	u16 (*rx_desc_get_msdu_len)(struct hal_rx_desc *desc);
261 	u8 (*rx_desc_get_msdu_sgi)(struct hal_rx_desc *desc);
262 	u8 (*rx_desc_get_msdu_rate_mcs)(struct hal_rx_desc *desc);
263 	u8 (*rx_desc_get_msdu_rx_bw)(struct hal_rx_desc *desc);
264 	u32 (*rx_desc_get_msdu_freq)(struct hal_rx_desc *desc);
265 	u8 (*rx_desc_get_msdu_pkt_type)(struct hal_rx_desc *desc);
266 	u8 (*rx_desc_get_msdu_nss)(struct hal_rx_desc *desc);
267 	u8 (*rx_desc_get_mpdu_tid)(struct hal_rx_desc *desc);
268 	u16 (*rx_desc_get_mpdu_peer_id)(struct hal_rx_desc *desc);
269 	void (*rx_desc_copy_attn_end_tlv)(struct hal_rx_desc *fdesc,
270 					  struct hal_rx_desc *ldesc);
271 	u32 (*rx_desc_get_mpdu_start_tag)(struct hal_rx_desc *desc);
272 	u32 (*rx_desc_get_mpdu_ppdu_id)(struct hal_rx_desc *desc);
273 	void (*rx_desc_set_msdu_len)(struct hal_rx_desc *desc, u16 len);
274 	struct rx_attention *(*rx_desc_get_attention)(struct hal_rx_desc *desc);
275 	u8 *(*rx_desc_get_msdu_payload)(struct hal_rx_desc *desc);
276 	void (*reo_setup)(struct ath11k_base *ab);
277 	u16 (*mpdu_info_get_peerid)(struct hal_rx_mpdu_info *mpdu_info);
278 	bool (*rx_desc_mac_addr2_valid)(struct hal_rx_desc *desc);
279 	u8* (*rx_desc_mpdu_start_addr2)(struct hal_rx_desc *desc);
280 	u32 (*get_ring_selector)(struct sk_buff *skb);
281 };
282 
283 extern const struct ath11k_hw_ops ipq8074_ops;
284 extern const struct ath11k_hw_ops ipq6018_ops;
285 extern const struct ath11k_hw_ops qca6390_ops;
286 extern const struct ath11k_hw_ops qcn9074_ops;
287 extern const struct ath11k_hw_ops wcn6855_ops;
288 extern const struct ath11k_hw_ops wcn6750_ops;
289 extern const struct ath11k_hw_ops ipq5018_ops;
290 
291 extern const struct ath11k_hw_ring_mask ath11k_hw_ring_mask_ipq8074;
292 extern const struct ath11k_hw_ring_mask ath11k_hw_ring_mask_qca6390;
293 extern const struct ath11k_hw_ring_mask ath11k_hw_ring_mask_qcn9074;
294 extern const struct ath11k_hw_ring_mask ath11k_hw_ring_mask_wcn6750;
295 
296 extern const struct ce_ie_addr ath11k_ce_ie_addr_ipq8074;
297 extern const struct ce_ie_addr ath11k_ce_ie_addr_ipq5018;
298 
299 extern const struct ce_remap ath11k_ce_remap_ipq5018;
300 
301 extern const struct ath11k_hw_hal_params ath11k_hw_hal_params_ipq5018;
302 extern const struct ath11k_hw_hal_params ath11k_hw_hal_params_ipq8074;
303 extern const struct ath11k_hw_hal_params ath11k_hw_hal_params_qca6390;
304 extern const struct ath11k_hw_hal_params ath11k_hw_hal_params_wcn6750;
305 
306 static inline
ath11k_hw_get_mac_from_pdev_id(struct ath11k_hw_params * hw,int pdev_idx)307 int ath11k_hw_get_mac_from_pdev_id(struct ath11k_hw_params *hw,
308 				   int pdev_idx)
309 {
310 	if (hw->hw_ops->get_hw_mac_from_pdev_id)
311 		return hw->hw_ops->get_hw_mac_from_pdev_id(pdev_idx);
312 
313 	return 0;
314 }
315 
ath11k_hw_mac_id_to_pdev_id(struct ath11k_hw_params * hw,int mac_id)316 static inline int ath11k_hw_mac_id_to_pdev_id(struct ath11k_hw_params *hw,
317 					      int mac_id)
318 {
319 	if (hw->hw_ops->mac_id_to_pdev_id)
320 		return hw->hw_ops->mac_id_to_pdev_id(hw, mac_id);
321 
322 	return 0;
323 }
324 
ath11k_hw_mac_id_to_srng_id(struct ath11k_hw_params * hw,int mac_id)325 static inline int ath11k_hw_mac_id_to_srng_id(struct ath11k_hw_params *hw,
326 					      int mac_id)
327 {
328 	if (hw->hw_ops->mac_id_to_srng_id)
329 		return hw->hw_ops->mac_id_to_srng_id(hw, mac_id);
330 
331 	return 0;
332 }
333 
334 struct ath11k_fw_ie {
335 	__le32 id;
336 	__le32 len;
337 	u8 data[];
338 };
339 
340 enum ath11k_bd_ie_board_type {
341 	ATH11K_BD_IE_BOARD_NAME = 0,
342 	ATH11K_BD_IE_BOARD_DATA = 1,
343 };
344 
345 enum ath11k_bd_ie_regdb_type {
346 	ATH11K_BD_IE_REGDB_NAME = 0,
347 	ATH11K_BD_IE_REGDB_DATA = 1,
348 };
349 
350 enum ath11k_bd_ie_type {
351 	/* contains sub IEs of enum ath11k_bd_ie_board_type */
352 	ATH11K_BD_IE_BOARD = 0,
353 	/* contains sub IEs of enum ath11k_bd_ie_regdb_type */
354 	ATH11K_BD_IE_REGDB = 1,
355 };
356 
357 struct ath11k_hw_regs {
358 	u32 hal_tcl1_ring_base_lsb;
359 	u32 hal_tcl1_ring_base_msb;
360 	u32 hal_tcl1_ring_id;
361 	u32 hal_tcl1_ring_misc;
362 	u32 hal_tcl1_ring_tp_addr_lsb;
363 	u32 hal_tcl1_ring_tp_addr_msb;
364 	u32 hal_tcl1_ring_consumer_int_setup_ix0;
365 	u32 hal_tcl1_ring_consumer_int_setup_ix1;
366 	u32 hal_tcl1_ring_msi1_base_lsb;
367 	u32 hal_tcl1_ring_msi1_base_msb;
368 	u32 hal_tcl1_ring_msi1_data;
369 	u32 hal_tcl2_ring_base_lsb;
370 	u32 hal_tcl_ring_base_lsb;
371 
372 	u32 hal_tcl_status_ring_base_lsb;
373 
374 	u32 hal_reo1_ring_base_lsb;
375 	u32 hal_reo1_ring_base_msb;
376 	u32 hal_reo1_ring_id;
377 	u32 hal_reo1_ring_misc;
378 	u32 hal_reo1_ring_hp_addr_lsb;
379 	u32 hal_reo1_ring_hp_addr_msb;
380 	u32 hal_reo1_ring_producer_int_setup;
381 	u32 hal_reo1_ring_msi1_base_lsb;
382 	u32 hal_reo1_ring_msi1_base_msb;
383 	u32 hal_reo1_ring_msi1_data;
384 	u32 hal_reo2_ring_base_lsb;
385 	u32 hal_reo1_aging_thresh_ix_0;
386 	u32 hal_reo1_aging_thresh_ix_1;
387 	u32 hal_reo1_aging_thresh_ix_2;
388 	u32 hal_reo1_aging_thresh_ix_3;
389 
390 	u32 hal_reo1_ring_hp;
391 	u32 hal_reo1_ring_tp;
392 	u32 hal_reo2_ring_hp;
393 
394 	u32 hal_reo_tcl_ring_base_lsb;
395 	u32 hal_reo_tcl_ring_hp;
396 
397 	u32 hal_reo_status_ring_base_lsb;
398 	u32 hal_reo_status_hp;
399 
400 	u32 hal_reo_cmd_ring_base_lsb;
401 	u32 hal_reo_cmd_ring_hp;
402 
403 	u32 hal_sw2reo_ring_base_lsb;
404 	u32 hal_sw2reo_ring_hp;
405 
406 	u32 hal_seq_wcss_umac_ce0_src_reg;
407 	u32 hal_seq_wcss_umac_ce0_dst_reg;
408 	u32 hal_seq_wcss_umac_ce1_src_reg;
409 	u32 hal_seq_wcss_umac_ce1_dst_reg;
410 
411 	u32 hal_wbm_idle_link_ring_base_lsb;
412 	u32 hal_wbm_idle_link_ring_misc;
413 
414 	u32 hal_wbm_release_ring_base_lsb;
415 
416 	u32 hal_wbm0_release_ring_base_lsb;
417 	u32 hal_wbm1_release_ring_base_lsb;
418 
419 	u32 pcie_qserdes_sysclk_en_sel;
420 	u32 pcie_pcs_osc_dtct_config_base;
421 
422 	u32 hal_shadow_base_addr;
423 	u32 hal_reo1_misc_ctl;
424 };
425 
426 extern const struct ath11k_hw_regs ipq8074_regs;
427 extern const struct ath11k_hw_regs qca6390_regs;
428 extern const struct ath11k_hw_regs qcn9074_regs;
429 extern const struct ath11k_hw_regs wcn6855_regs;
430 extern const struct ath11k_hw_regs wcn6750_regs;
431 extern const struct ath11k_hw_regs ipq5018_regs;
432 
ath11k_bd_ie_type_str(enum ath11k_bd_ie_type type)433 static inline const char *ath11k_bd_ie_type_str(enum ath11k_bd_ie_type type)
434 {
435 	switch (type) {
436 	case ATH11K_BD_IE_BOARD:
437 		return "board data";
438 	case ATH11K_BD_IE_REGDB:
439 		return "regdb data";
440 	}
441 
442 	return "unknown";
443 }
444 
445 extern const struct cfg80211_sar_capa ath11k_hw_sar_capa_wcn6855;
446 
447 #endif
448