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