GNU Linux-libre 5.19-rc6-gnu
[releases.git] / drivers / net / wireless / microchip / wilc1000 / wlan.h
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
309 #define WILC_WID_TYPE           GENMASK(15, 12)
310 #define WILC_VMM_ENTRY_FULL_RETRY       1
311 /********************************************
312  *
313  *      Tx/Rx Queue Structure
314  *
315  ********************************************/
316 enum ip_pkt_priority {
317         AC_VO_Q = 0,
318         AC_VI_Q = 1,
319         AC_BE_Q = 2,
320         AC_BK_Q = 3
321 };
322
323 struct txq_entry_t {
324         struct list_head list;
325         int type;
326         u8 q_num;
327         int ack_idx;
328         u8 *buffer;
329         int buffer_size;
330         void *priv;
331         int status;
332         struct wilc_vif *vif;
333         void (*tx_complete_func)(void *priv, int status);
334 };
335
336 struct txq_fw_recv_queue_stat {
337         u8 acm;
338         u8 count;
339 };
340
341 struct txq_handle {
342         struct txq_entry_t txq_head;
343         u16 count;
344         struct txq_fw_recv_queue_stat fw;
345 };
346
347 struct rxq_entry_t {
348         struct list_head list;
349         u8 *buffer;
350         int buffer_size;
351 };
352
353 /********************************************
354  *
355  *      Host IF Structure
356  *
357  ********************************************/
358 struct wilc;
359 struct wilc_hif_func {
360         int (*hif_init)(struct wilc *wilc, bool resume);
361         int (*hif_deinit)(struct wilc *wilc);
362         int (*hif_read_reg)(struct wilc *wilc, u32 addr, u32 *data);
363         int (*hif_write_reg)(struct wilc *wilc, u32 addr, u32 data);
364         int (*hif_block_rx)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
365         int (*hif_block_tx)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
366         int (*hif_read_int)(struct wilc *wilc, u32 *int_status);
367         int (*hif_clear_int_ext)(struct wilc *wilc, u32 val);
368         int (*hif_read_size)(struct wilc *wilc, u32 *size);
369         int (*hif_block_tx_ext)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
370         int (*hif_block_rx_ext)(struct wilc *wilc, u32 addr, u8 *buf, u32 size);
371         int (*hif_sync_ext)(struct wilc *wilc, int nint);
372         int (*enable_interrupt)(struct wilc *nic);
373         void (*disable_interrupt)(struct wilc *nic);
374         int (*hif_reset)(struct wilc *wilc);
375 };
376
377 #define WILC_MAX_CFG_FRAME_SIZE         1468
378
379 struct tx_complete_data {
380         int size;
381         void *buff;
382         struct sk_buff *skb;
383 };
384
385 struct wilc_cfg_cmd_hdr {
386         u8 cmd_type;
387         u8 seq_no;
388         __le16 total_len;
389         __le32 driver_handler;
390 };
391
392 struct wilc_cfg_frame {
393         struct wilc_cfg_cmd_hdr hdr;
394         u8 frame[WILC_MAX_CFG_FRAME_SIZE];
395 };
396
397 struct wilc_cfg_rsp {
398         u8 type;
399         u8 seq_no;
400 };
401
402 struct wilc_vif;
403
404 int wilc_wlan_firmware_download(struct wilc *wilc, const u8 *buffer,
405                                 u32 buffer_size);
406 int wilc_wlan_start(struct wilc *wilc);
407 int wilc_wlan_stop(struct wilc *wilc, struct wilc_vif *vif);
408 int wilc_wlan_txq_add_net_pkt(struct net_device *dev,
409                               struct tx_complete_data *tx_data, u8 *buffer,
410                               u32 buffer_size,
411                               void (*tx_complete_fn)(void *, int));
412 int wilc_wlan_handle_txq(struct wilc *wl, u32 *txq_count);
413 void wilc_handle_isr(struct wilc *wilc);
414 void wilc_wlan_cleanup(struct net_device *dev);
415 int wilc_wlan_cfg_set(struct wilc_vif *vif, int start, u16 wid, u8 *buffer,
416                       u32 buffer_size, int commit, u32 drv_handler);
417 int wilc_wlan_cfg_get(struct wilc_vif *vif, int start, u16 wid, int commit,
418                       u32 drv_handler);
419 int wilc_wlan_txq_add_mgmt_pkt(struct net_device *dev, void *priv, u8 *buffer,
420                                u32 buffer_size, void (*func)(void *, int));
421 void wilc_enable_tcp_ack_filter(struct wilc_vif *vif, bool value);
422 int wilc_wlan_get_num_conn_ifcs(struct wilc *wilc);
423 netdev_tx_t wilc_mac_xmit(struct sk_buff *skb, struct net_device *dev);
424
425 void wilc_wfi_p2p_rx(struct wilc_vif *vif, u8 *buff, u32 size);
426 void host_wakeup_notify(struct wilc *wilc);
427 void host_sleep_notify(struct wilc *wilc);
428 void chip_allow_sleep(struct wilc *wilc);
429 void chip_wakeup(struct wilc *wilc);
430 int wilc_send_config_pkt(struct wilc_vif *vif, u8 mode, struct wid *wids,
431                          u32 count);
432 int wilc_wlan_init(struct net_device *dev);
433 u32 wilc_get_chipid(struct wilc *wilc, bool update);
434 #endif