xref: /linux/drivers/net/wireless/microchip/wilc1000/wlan.h (revision a1ff5a7d78a036d6c2178ee5acd6ba4946243800)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Copyright (c) 2012 - 2018 Microchip Technology Inc., and its subsidiaries.
4  * All rights reserved.
5  */
6 
7 #ifndef WILC_WLAN_H
8 #define WILC_WLAN_H
9 
10 #include <linux/types.h>
11 #include <linux/bitfield.h>
12 
13 /********************************************
14  *
15  *      Mac eth header length
16  *
17  ********************************************/
18 #define MAX_MAC_HDR_LEN			26 /* QOS_MAC_HDR_LEN */
19 #define SUB_MSDU_HEADER_LENGTH		14
20 #define SNAP_HDR_LEN			8
21 #define ETHERNET_HDR_LEN		14
22 #define WORD_ALIGNMENT_PAD		0
23 
24 #define ETH_ETHERNET_HDR_OFFSET		(MAX_MAC_HDR_LEN + \
25 					 SUB_MSDU_HEADER_LENGTH + \
26 					 SNAP_HDR_LEN - \
27 					 ETHERNET_HDR_LEN + \
28 					 WORD_ALIGNMENT_PAD)
29 
30 #define HOST_HDR_OFFSET			4
31 #define ETHERNET_HDR_LEN		14
32 #define IP_HDR_LEN			20
33 #define IP_HDR_OFFSET			ETHERNET_HDR_LEN
34 #define UDP_HDR_OFFSET			(IP_HDR_LEN + IP_HDR_OFFSET)
35 #define UDP_HDR_LEN			8
36 #define UDP_DATA_OFFSET			(UDP_HDR_OFFSET + UDP_HDR_LEN)
37 #define ETH_CONFIG_PKT_HDR_LEN		UDP_DATA_OFFSET
38 
39 #define ETH_CONFIG_PKT_HDR_OFFSET	(ETH_ETHERNET_HDR_OFFSET + \
40 					 ETH_CONFIG_PKT_HDR_LEN)
41 
42 /********************************************
43  *
44  *      Register Defines
45  *
46  ********************************************/
47 #define WILC_PERIPH_REG_BASE		0x1000
48 #define WILC_CHANGING_VIR_IF		0x108c
49 #define WILC_CHIPID			WILC_PERIPH_REG_BASE
50 #define WILC_GLB_RESET_0		(WILC_PERIPH_REG_BASE + 0x400)
51 #define WILC_PIN_MUX_0			(WILC_PERIPH_REG_BASE + 0x408)
52 #define WILC_HOST_TX_CTRL		(WILC_PERIPH_REG_BASE + 0x6c)
53 #define WILC_HOST_RX_CTRL_0		(WILC_PERIPH_REG_BASE + 0x70)
54 #define WILC_HOST_RX_CTRL_1		(WILC_PERIPH_REG_BASE + 0x74)
55 #define WILC_HOST_VMM_CTL		(WILC_PERIPH_REG_BASE + 0x78)
56 #define WILC_HOST_RX_CTRL		(WILC_PERIPH_REG_BASE + 0x80)
57 #define WILC_HOST_RX_EXTRA_SIZE		(WILC_PERIPH_REG_BASE + 0x84)
58 #define WILC_HOST_TX_CTRL_1		(WILC_PERIPH_REG_BASE + 0x88)
59 #define WILC_INTR_REG_BASE		(WILC_PERIPH_REG_BASE + 0xa00)
60 #define WILC_INTR_ENABLE		WILC_INTR_REG_BASE
61 #define WILC_INTR2_ENABLE		(WILC_INTR_REG_BASE + 4)
62 
63 #define WILC_INTR_POLARITY		(WILC_INTR_REG_BASE + 0x10)
64 #define WILC_INTR_TYPE			(WILC_INTR_REG_BASE + 0x20)
65 #define WILC_INTR_CLEAR			(WILC_INTR_REG_BASE + 0x30)
66 #define WILC_INTR_STATUS		(WILC_INTR_REG_BASE + 0x40)
67 
68 #define WILC_RF_REVISION_ID		0x13f4
69 
70 #define WILC_VMM_TBL_SIZE		64
71 #define WILC_VMM_TX_TBL_BASE		0x150400
72 #define WILC_VMM_RX_TBL_BASE		0x150500
73 
74 #define WILC_VMM_BASE			0x150000
75 #define WILC_VMM_CORE_CTL		WILC_VMM_BASE
76 #define WILC_VMM_TBL_CTL		(WILC_VMM_BASE + 0x4)
77 #define WILC_VMM_TBL_ENTRY		(WILC_VMM_BASE + 0x8)
78 #define WILC_VMM_TBL0_SIZE		(WILC_VMM_BASE + 0xc)
79 #define WILC_VMM_TO_HOST_SIZE		(WILC_VMM_BASE + 0x10)
80 #define WILC_VMM_CORE_CFG		(WILC_VMM_BASE + 0x14)
81 #define WILC_VMM_TBL_ACTIVE		(WILC_VMM_BASE + 040)
82 #define WILC_VMM_TBL_STATUS		(WILC_VMM_BASE + 0x44)
83 
84 #define WILC_SPI_REG_BASE		0xe800
85 #define WILC_SPI_CTL			WILC_SPI_REG_BASE
86 #define WILC_SPI_MASTER_DMA_ADDR	(WILC_SPI_REG_BASE + 0x4)
87 #define WILC_SPI_MASTER_DMA_COUNT	(WILC_SPI_REG_BASE + 0x8)
88 #define WILC_SPI_SLAVE_DMA_ADDR		(WILC_SPI_REG_BASE + 0xc)
89 #define WILC_SPI_SLAVE_DMA_COUNT	(WILC_SPI_REG_BASE + 0x10)
90 #define WILC_SPI_TX_MODE		(WILC_SPI_REG_BASE + 0x20)
91 #define WILC_SPI_PROTOCOL_CONFIG	(WILC_SPI_REG_BASE + 0x24)
92 #define WILC_SPI_INTR_CTL		(WILC_SPI_REG_BASE + 0x2c)
93 #define WILC_SPI_INT_STATUS		(WILC_SPI_REG_BASE + 0x40)
94 #define WILC_SPI_INT_CLEAR		(WILC_SPI_REG_BASE + 0x44)
95 
96 #define WILC_SPI_WAKEUP_REG		0x1
97 #define WILC_SPI_WAKEUP_BIT		BIT(1)
98 
99 #define WILC_SPI_CLK_STATUS_REG        0x0f
100 #define WILC_SPI_CLK_STATUS_BIT        BIT(2)
101 #define WILC_SPI_HOST_TO_FW_REG		0x0b
102 #define WILC_SPI_HOST_TO_FW_BIT		BIT(0)
103 
104 #define WILC_SPI_FW_TO_HOST_REG		0x10
105 #define WILC_SPI_FW_TO_HOST_BIT		BIT(0)
106 
107 #define WILC_SPI_PROTOCOL_OFFSET	(WILC_SPI_PROTOCOL_CONFIG - \
108 					 WILC_SPI_REG_BASE)
109 
110 #define WILC_SPI_CLOCKLESS_ADDR_LIMIT	0x30
111 
112 /* Functions IO enables bits */
113 #define WILC_SDIO_CCCR_IO_EN_FUNC1	BIT(1)
114 
115 /* Function/Interrupt enables bits */
116 #define WILC_SDIO_CCCR_IEN_MASTER	BIT(0)
117 #define WILC_SDIO_CCCR_IEN_FUNC1	BIT(1)
118 
119 /* Abort CCCR register bits */
120 #define WILC_SDIO_CCCR_ABORT_RESET	BIT(3)
121 
122 /* Vendor specific CCCR registers */
123 #define WILC_SDIO_WAKEUP_REG		0xf0
124 #define WILC_SDIO_WAKEUP_BIT		BIT(0)
125 
126 #define WILC_SDIO_CLK_STATUS_REG	0xf1
127 #define WILC_SDIO_CLK_STATUS_BIT	BIT(0)
128 
129 #define WILC_SDIO_INTERRUPT_DATA_SZ_REG	0xf2 /* Read size (2 bytes) */
130 
131 #define WILC_SDIO_VMM_TBL_CTRL_REG	0xf6
132 #define WILC_SDIO_IRQ_FLAG_REG		0xf7
133 #define WILC_SDIO_IRQ_CLEAR_FLAG_REG	0xf8
134 
135 #define WILC_SDIO_HOST_TO_FW_REG	0xfa
136 #define WILC_SDIO_HOST_TO_FW_BIT	BIT(0)
137 
138 #define WILC_SDIO_FW_TO_HOST_REG	0xfc
139 #define WILC_SDIO_FW_TO_HOST_BIT	BIT(0)
140 
141 /* Function 1 specific FBR register */
142 #define WILC_SDIO_FBR_CSA_REG		0x10C /* CSA pointer (3 bytes) */
143 #define WILC_SDIO_FBR_DATA_REG		0x10F
144 
145 #define WILC_SDIO_F1_DATA_REG		0x0
146 #define WILC_SDIO_EXT_IRQ_FLAG_REG	0x4
147 
148 #define WILC_AHB_DATA_MEM_BASE		0x30000
149 #define WILC_AHB_SHARE_MEM_BASE		0xd0000
150 
151 #define WILC_VMM_TBL_RX_SHADOW_BASE	WILC_AHB_SHARE_MEM_BASE
152 #define WILC_VMM_TBL_RX_SHADOW_SIZE	256
153 
154 #define WILC_FW_HOST_COMM		0x13c0
155 #define WILC_GP_REG_0			0x149c
156 #define WILC_GP_REG_1			0x14a0
157 
158 #define GLOBAL_MODE_CONTROL		0x1614
159 #define PWR_SEQ_MISC_CTRL		0x3008
160 
161 #define WILC_GLOBAL_MODE_ENABLE_WIFI	BIT(0)
162 #define WILC_PWR_SEQ_ENABLE_WIFI_SLEEP	BIT(28)
163 
164 #define WILC_HAVE_SDIO_IRQ_GPIO		BIT(0)
165 #define WILC_HAVE_USE_PMU		BIT(1)
166 #define WILC_HAVE_SLEEP_CLK_SRC_RTC	BIT(2)
167 #define WILC_HAVE_SLEEP_CLK_SRC_XO	BIT(3)
168 #define WILC_HAVE_EXT_PA_INV_TX_RX	BIT(4)
169 #define WILC_HAVE_LEGACY_RF_SETTINGS	BIT(5)
170 #define WILC_HAVE_XTAL_24		BIT(6)
171 #define WILC_HAVE_DISABLE_WILC_UART	BIT(7)
172 #define WILC_HAVE_USE_IRQ_AS_HOST_WAKE	BIT(8)
173 
174 #define WILC_CORTUS_INTERRUPT_BASE	0x10A8
175 #define WILC_CORTUS_INTERRUPT_1		(WILC_CORTUS_INTERRUPT_BASE + 0x4)
176 #define WILC_CORTUS_INTERRUPT_2		(WILC_CORTUS_INTERRUPT_BASE + 0x8)
177 
178 /* tx control register 1 to 4 for RX */
179 #define WILC_REG_4_TO_1_RX		0x1e1c
180 
181 /* tx control register 1 to 4 for TX Bank_0 */
182 #define WILC_REG_4_TO_1_TX_BANK0	0x1e9c
183 
184 #define WILC_CORTUS_RESET_MUX_SEL	0x1118
185 #define WILC_CORTUS_BOOT_REGISTER	0xc0000
186 
187 #define WILC_CORTUS_BOOT_FROM_IRAM	0x71
188 
189 #define WILC_1000_BASE_ID		0x100000
190 
191 #define WILC_1000_BASE_ID_2A		0x1002A0
192 #define WILC_1000_BASE_ID_2A_REV1	(WILC_1000_BASE_ID_2A + 1)
193 
194 #define WILC_1000_BASE_ID_2B		0x1002B0
195 #define WILC_1000_BASE_ID_2B_REV1	(WILC_1000_BASE_ID_2B + 1)
196 #define WILC_1000_BASE_ID_2B_REV2	(WILC_1000_BASE_ID_2B + 2)
197 
198 #define WILC_CHIP_REV_FIELD		GENMASK(11, 0)
199 
200 /********************************************
201  *
202  *      Wlan Defines
203  *
204  ********************************************/
205 #define WILC_CFG_PKT		1
206 #define WILC_NET_PKT		0
207 #define WILC_MGMT_PKT		2
208 
209 #define WILC_CFG_SET		1
210 #define WILC_CFG_QUERY		0
211 
212 #define WILC_CFG_RSP		1
213 #define WILC_CFG_RSP_STATUS	2
214 #define WILC_CFG_RSP_SCAN	3
215 
216 #define WILC_ABORT_REQ_BIT		BIT(31)
217 
218 #define WILC_RX_BUFF_SIZE	(96 * 1024)
219 #define WILC_TX_BUFF_SIZE	(64 * 1024)
220 
221 #define NQUEUES			4
222 #define AC_BUFFER_SIZE		1000
223 
224 #define VO_AC_COUNT_FIELD		GENMASK(31, 25)
225 #define VO_AC_ACM_STAT_FIELD		BIT(24)
226 #define VI_AC_COUNT_FIELD		GENMASK(23, 17)
227 #define VI_AC_ACM_STAT_FIELD		BIT(16)
228 #define BE_AC_COUNT_FIELD		GENMASK(15, 9)
229 #define BE_AC_ACM_STAT_FIELD		BIT(8)
230 #define BK_AC_COUNT_FIELD		GENMASK(7, 3)
231 #define BK_AC_ACM_STAT_FIELD		BIT(1)
232 
233 #define WILC_PKT_HDR_CONFIG_FIELD	BIT(31)
234 #define WILC_PKT_HDR_OFFSET_FIELD	GENMASK(30, 22)
235 #define WILC_PKT_HDR_TOTAL_LEN_FIELD	GENMASK(21, 11)
236 #define WILC_PKT_HDR_LEN_FIELD		GENMASK(10, 0)
237 
238 #define WILC_INTERRUPT_DATA_SIZE	GENMASK(14, 0)
239 
240 #define WILC_VMM_BUFFER_SIZE		GENMASK(9, 0)
241 
242 #define WILC_VMM_HDR_TYPE		BIT(31)
243 #define WILC_VMM_HDR_MGMT_FIELD		BIT(30)
244 #define WILC_VMM_HDR_PKT_SIZE		GENMASK(29, 15)
245 #define WILC_VMM_HDR_BUFF_SIZE		GENMASK(14, 0)
246 
247 #define WILC_VMM_ENTRY_COUNT		GENMASK(8, 3)
248 #define WILC_VMM_ENTRY_AVAILABLE	BIT(2)
249 /*******************************************/
250 /*        E0 and later Interrupt flags.    */
251 /*******************************************/
252 /*******************************************/
253 /*        E0 and later Interrupt flags.    */
254 /*           IRQ Status word               */
255 /* 15:0 = DMA count in words.              */
256 /* 16: INT0 flag                           */
257 /* 17: INT1 flag                           */
258 /* 18: INT2 flag                           */
259 /* 19: INT3 flag                           */
260 /* 20: INT4 flag                           */
261 /* 21: INT5 flag                           */
262 /*******************************************/
263 #define IRG_FLAGS_OFFSET	16
264 #define IRQ_DMA_WD_CNT_MASK	GENMASK(IRG_FLAGS_OFFSET - 1, 0)
265 #define INT_0			BIT(IRG_FLAGS_OFFSET)
266 #define INT_1			BIT(IRG_FLAGS_OFFSET + 1)
267 #define INT_2			BIT(IRG_FLAGS_OFFSET + 2)
268 #define INT_3			BIT(IRG_FLAGS_OFFSET + 3)
269 #define INT_4			BIT(IRG_FLAGS_OFFSET + 4)
270 #define INT_5			BIT(IRG_FLAGS_OFFSET + 5)
271 #define MAX_NUM_INT		5
272 #define IRG_FLAGS_MASK		GENMASK(IRG_FLAGS_OFFSET + MAX_NUM_INT, \
273 					IRG_FLAGS_OFFSET)
274 
275 /*******************************************/
276 /*        E0 and later Interrupt flags.    */
277 /*           IRQ Clear word                */
278 /* 0: Clear INT0                           */
279 /* 1: Clear INT1                           */
280 /* 2: Clear INT2                           */
281 /* 3: Clear INT3                           */
282 /* 4: Clear INT4                           */
283 /* 5: Clear INT5                           */
284 /* 6: Select VMM table 1                   */
285 /* 7: Select VMM table 2                   */
286 /* 8: Enable VMM                           */
287 /*******************************************/
288 #define CLR_INT0		BIT(0)
289 #define CLR_INT1		BIT(1)
290 #define CLR_INT2		BIT(2)
291 #define CLR_INT3		BIT(3)
292 #define CLR_INT4		BIT(4)
293 #define CLR_INT5		BIT(5)
294 #define SEL_VMM_TBL0		BIT(6)
295 #define SEL_VMM_TBL1		BIT(7)
296 #define EN_VMM			BIT(8)
297 
298 #define DATA_INT_EXT		INT_0
299 #define ALL_INT_EXT		DATA_INT_EXT
300 #define NUM_INT_EXT		1
301 #define UNHANDLED_IRQ_MASK	GENMASK(MAX_NUM_INT - 1, NUM_INT_EXT)
302 
303 #define DATA_INT_CLR		CLR_INT0
304 
305 #define ENABLE_RX_VMM		(SEL_VMM_TBL1 | EN_VMM)
306 #define ENABLE_TX_VMM		(SEL_VMM_TBL0 | EN_VMM)
307 /* time for expiring the completion of cfg packets */
308 #define WILC_CFG_PKTS_TIMEOUT	msecs_to_jiffies(3000)
309 
310 #define IS_MANAGMEMENT		0x100
311 #define IS_MANAGMEMENT_CALLBACK	0x080
312 #define IS_MGMT_STATUS_SUCCES	0x040
313 #define IS_MGMT_AUTH_PKT       0x010
314 
315 #define WILC_WID_TYPE		GENMASK(15, 12)
316 #define WILC_VMM_ENTRY_FULL_RETRY	1
317 /********************************************
318  *
319  *      Tx/Rx Queue Structure
320  *
321  ********************************************/
322 enum ip_pkt_priority {
323 	AC_VO_Q = 0,
324 	AC_VI_Q = 1,
325 	AC_BE_Q = 2,
326 	AC_BK_Q = 3
327 };
328 
329 struct txq_entry_t {
330 	struct list_head list;
331 	int type;
332 	u8 q_num;
333 	int ack_idx;
334 	u8 *buffer;
335 	int buffer_size;
336 	void *priv;
337 	int status;
338 	struct wilc_vif *vif;
339 	void (*tx_complete_func)(void *priv, int status);
340 };
341 
342 struct txq_fw_recv_queue_stat {
343 	u8 acm;
344 	u8 count;
345 };
346 
347 struct txq_handle {
348 	struct txq_entry_t txq_head;
349 	u16 count;
350 	struct txq_fw_recv_queue_stat fw;
351 };
352 
353 struct rxq_entry_t {
354 	struct list_head list;
355 	u8 *buffer;
356 	int buffer_size;
357 };
358 
359 /********************************************
360  *
361  *      Host IF Structure
362  *
363  ********************************************/
364 struct wilc;
365 struct wilc_hif_func {
366 	int (*hif_init)(struct wilc *wilc, bool resume);
367 	int (*hif_deinit)(struct wilc *wilc);
368 	int (*hif_read_reg)(struct wilc *wilc, u32 addr, u32 *data);
369 	int (*hif_write_reg)(struct wilc *wilc, u32 addr, u32 data);
370 	int (*hif_block_rx)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
371 	int (*hif_block_tx)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
372 	int (*hif_read_int)(struct wilc *wilc, u32 *int_status);
373 	int (*hif_clear_int_ext)(struct wilc *wilc, u32 val);
374 	int (*hif_read_size)(struct wilc *wilc, u32 *size);
375 	int (*hif_block_tx_ext)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
376 	int (*hif_block_rx_ext)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
377 	int (*hif_sync_ext)(struct wilc *wilc, int nint);
378 	int (*enable_interrupt)(struct wilc *nic);
379 	void (*disable_interrupt)(struct wilc *nic);
380 	int (*hif_reset)(struct wilc *wilc);
381 	bool (*hif_is_init)(struct wilc *wilc);
382 };
383 
384 #define WILC_MAX_CFG_FRAME_SIZE		1468
385 
386 struct tx_complete_data {
387 	int size;
388 	void *buff;
389 	struct sk_buff *skb;
390 };
391 
392 struct wilc_cfg_cmd_hdr {
393 	u8 cmd_type;
394 	u8 seq_no;
395 	__le16 total_len;
396 	__le32 driver_handler;
397 };
398 
399 struct wilc_cfg_frame {
400 	struct wilc_cfg_cmd_hdr hdr;
401 	u8 frame[WILC_MAX_CFG_FRAME_SIZE];
402 };
403 
404 struct wilc_cfg_rsp {
405 	u8 type;
406 	u8 seq_no;
407 };
408 
409 struct wilc_vif;
410 
is_wilc1000(u32 id)411 static inline bool is_wilc1000(u32 id)
412 {
413 	return (id & (~WILC_CHIP_REV_FIELD)) == WILC_1000_BASE_ID;
414 }
415 
416 int wilc_wlan_firmware_download(struct wilc *wilc, const u8 *buffer,
417 				u32 buffer_size);
418 int wilc_wlan_start(struct wilc *wilc);
419 int wilc_wlan_stop(struct wilc *wilc, struct wilc_vif *vif);
420 int wilc_wlan_txq_add_net_pkt(struct net_device *dev,
421 			      struct tx_complete_data *tx_data, u8 *buffer,
422 			      u32 buffer_size,
423 			      void (*tx_complete_fn)(void *, int));
424 int wilc_wlan_handle_txq(struct wilc *wl, u32 *txq_count);
425 void wilc_handle_isr(struct wilc *wilc);
426 void wilc_wlan_cleanup(struct net_device *dev);
427 int wilc_wlan_cfg_set(struct wilc_vif *vif, int start, u16 wid, u8 *buffer,
428 		      u32 buffer_size, int commit, u32 drv_handler);
429 int wilc_wlan_cfg_get(struct wilc_vif *vif, int start, u16 wid, int commit,
430 		      u32 drv_handler);
431 int wilc_wlan_txq_add_mgmt_pkt(struct net_device *dev, void *priv, u8 *buffer,
432 			       u32 buffer_size, void (*func)(void *, int));
433 void wilc_enable_tcp_ack_filter(struct wilc_vif *vif, bool value);
434 int wilc_wlan_get_num_conn_ifcs(struct wilc *wilc);
435 netdev_tx_t wilc_mac_xmit(struct sk_buff *skb, struct net_device *dev);
436 
437 void wilc_wfi_p2p_rx(struct wilc_vif *vif, u8 *buff, u32 size);
438 bool wilc_wfi_mgmt_frame_rx(struct wilc_vif *vif, u8 *buff, u32 size);
439 void host_wakeup_notify(struct wilc *wilc);
440 void host_sleep_notify(struct wilc *wilc);
441 void chip_allow_sleep(struct wilc *wilc);
442 void chip_wakeup(struct wilc *wilc);
443 int wilc_send_config_pkt(struct wilc_vif *vif, u8 mode, struct wid *wids,
444 			 u32 count);
445 int wilc_wlan_init(struct net_device *dev);
446 u32 wilc_get_chipid(struct wilc *wilc, bool update);
447 int wilc_load_mac_from_nv(struct wilc *wilc);
448 #endif
449