]>
Commit | Line | Data |
---|---|---|
2be7d22f VK |
1 | /* |
2 | * Copyright (c) 2012 Qualcomm Atheros, Inc. | |
3 | * | |
4 | * Permission to use, copy, modify, and/or distribute this software for any | |
5 | * purpose with or without fee is hereby granted, provided that the above | |
6 | * copyright notice and this permission notice appear in all copies. | |
7 | * | |
8 | * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | |
9 | * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | |
10 | * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | |
11 | * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | |
12 | * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | |
13 | * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | |
14 | * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | |
15 | */ | |
16 | ||
17 | #ifndef __WIL6210_H__ | |
18 | #define __WIL6210_H__ | |
19 | ||
20 | #include <linux/netdevice.h> | |
21 | #include <linux/wireless.h> | |
22 | #include <net/cfg80211.h> | |
23 | ||
2be7d22f VK |
24 | #define WIL_NAME "wil6210" |
25 | ||
26 | /** | |
27 | * extract bits [@b0:@b1] (inclusive) from the value @x | |
28 | * it should be @b0 <= @b1, or result is incorrect | |
29 | */ | |
30 | static inline u32 WIL_GET_BITS(u32 x, int b0, int b1) | |
31 | { | |
32 | return (x >> b0) & ((1 << (b1 - b0 + 1)) - 1); | |
33 | } | |
34 | ||
35 | #define WIL6210_MEM_SIZE (2*1024*1024UL) | |
36 | ||
e0287c4a VK |
37 | #define WIL6210_RX_RING_SIZE (128) |
38 | #define WIL6210_TX_RING_SIZE (128) | |
39 | #define WIL6210_MAX_TX_RINGS (24) /* HW limit */ | |
40 | #define WIL6210_MAX_CID (8) /* HW limit */ | |
41 | #define WIL6210_NAPI_BUDGET (16) /* arbitrary */ | |
83982cbe | 42 | #define WIL6210_ITR_TRSH (10000) /* arbitrary - about 15 IRQs/msec */ |
2be7d22f VK |
43 | |
44 | /* Hardware definitions begin */ | |
45 | ||
46 | /* | |
47 | * Mapping | |
48 | * RGF File | Host addr | FW addr | |
49 | * | | | |
50 | * user_rgf | 0x000000 | 0x880000 | |
51 | * dma_rgf | 0x001000 | 0x881000 | |
52 | * pcie_rgf | 0x002000 | 0x882000 | |
53 | * | | | |
54 | */ | |
55 | ||
56 | /* Where various structures placed in host address space */ | |
57 | #define WIL6210_FW_HOST_OFF (0x880000UL) | |
58 | ||
59 | #define HOSTADDR(fwaddr) (fwaddr - WIL6210_FW_HOST_OFF) | |
60 | ||
61 | /* | |
62 | * Interrupt control registers block | |
63 | * | |
64 | * each interrupt controlled by the same bit in all registers | |
65 | */ | |
66 | struct RGF_ICR { | |
67 | u32 ICC; /* Cause Control, RW: 0 - W1C, 1 - COR */ | |
68 | u32 ICR; /* Cause, W1C/COR depending on ICC */ | |
69 | u32 ICM; /* Cause masked (ICR & ~IMV), W1C/COR depending on ICC */ | |
70 | u32 ICS; /* Cause Set, WO */ | |
71 | u32 IMV; /* Mask, RW+S/C */ | |
72 | u32 IMS; /* Mask Set, write 1 to set */ | |
73 | u32 IMC; /* Mask Clear, write 1 to clear */ | |
74 | } __packed; | |
75 | ||
76 | /* registers - FW addresses */ | |
77 | #define RGF_USER_USER_SCRATCH_PAD (0x8802bc) | |
78 | #define RGF_USER_USER_ICR (0x880b4c) /* struct RGF_ICR */ | |
79 | #define BIT_USER_USER_ICR_SW_INT_2 BIT(18) | |
80 | #define RGF_USER_CLKS_CTL_SW_RST_MASK_0 (0x880b14) | |
81 | #define RGF_USER_MAC_CPU_0 (0x8801fc) | |
82 | #define RGF_USER_USER_CPU_0 (0x8801e0) | |
83 | #define RGF_USER_CLKS_CTL_SW_RST_VEC_0 (0x880b04) | |
84 | #define RGF_USER_CLKS_CTL_SW_RST_VEC_1 (0x880b08) | |
85 | #define RGF_USER_CLKS_CTL_SW_RST_VEC_2 (0x880b0c) | |
86 | #define RGF_USER_CLKS_CTL_SW_RST_VEC_3 (0x880b10) | |
87 | ||
88 | #define RGF_DMA_PSEUDO_CAUSE (0x881c68) | |
89 | #define RGF_DMA_PSEUDO_CAUSE_MASK_SW (0x881c6c) | |
90 | #define RGF_DMA_PSEUDO_CAUSE_MASK_FW (0x881c70) | |
91 | #define BIT_DMA_PSEUDO_CAUSE_RX BIT(0) | |
92 | #define BIT_DMA_PSEUDO_CAUSE_TX BIT(1) | |
93 | #define BIT_DMA_PSEUDO_CAUSE_MISC BIT(2) | |
94 | ||
95 | #define RGF_DMA_EP_TX_ICR (0x881bb4) /* struct RGF_ICR */ | |
96 | #define BIT_DMA_EP_TX_ICR_TX_DONE BIT(0) | |
97 | #define BIT_DMA_EP_TX_ICR_TX_DONE_N(n) BIT(n+1) /* n = [0..23] */ | |
98 | #define RGF_DMA_EP_RX_ICR (0x881bd0) /* struct RGF_ICR */ | |
99 | #define BIT_DMA_EP_RX_ICR_RX_DONE BIT(0) | |
100 | #define RGF_DMA_EP_MISC_ICR (0x881bec) /* struct RGF_ICR */ | |
101 | #define BIT_DMA_EP_MISC_ICR_RX_HTRSH BIT(0) | |
102 | #define BIT_DMA_EP_MISC_ICR_TX_NO_ACT BIT(1) | |
7269494e | 103 | #define BIT_DMA_EP_MISC_ICR_FW_INT(n) BIT(28+n) /* n = [0..3] */ |
2be7d22f VK |
104 | |
105 | /* Interrupt moderation control */ | |
106 | #define RGF_DMA_ITR_CNT_TRSH (0x881c5c) | |
107 | #define RGF_DMA_ITR_CNT_DATA (0x881c60) | |
108 | #define RGF_DMA_ITR_CNT_CRL (0x881C64) | |
109 | #define BIT_DMA_ITR_CNT_CRL_EN BIT(0) | |
110 | #define BIT_DMA_ITR_CNT_CRL_EXT_TICK BIT(1) | |
111 | #define BIT_DMA_ITR_CNT_CRL_FOREVER BIT(2) | |
112 | #define BIT_DMA_ITR_CNT_CRL_CLR BIT(3) | |
113 | #define BIT_DMA_ITR_CNT_CRL_REACH_TRSH BIT(4) | |
114 | ||
115 | /* popular locations */ | |
116 | #define HOST_MBOX HOSTADDR(RGF_USER_USER_SCRATCH_PAD) | |
117 | #define HOST_SW_INT (HOSTADDR(RGF_USER_USER_ICR) + \ | |
118 | offsetof(struct RGF_ICR, ICS)) | |
119 | #define SW_INT_MBOX BIT_USER_USER_ICR_SW_INT_2 | |
120 | ||
121 | /* ISR register bits */ | |
7269494e VK |
122 | #define ISR_MISC_FW_READY BIT_DMA_EP_MISC_ICR_FW_INT(0) |
123 | #define ISR_MISC_MBOX_EVT BIT_DMA_EP_MISC_ICR_FW_INT(1) | |
124 | #define ISR_MISC_FW_ERROR BIT_DMA_EP_MISC_ICR_FW_INT(3) | |
2be7d22f VK |
125 | |
126 | /* Hardware definitions end */ | |
127 | ||
128 | struct wil6210_mbox_ring { | |
129 | u32 base; | |
130 | u16 entry_size; /* max. size of mbox entry, incl. all headers */ | |
131 | u16 size; | |
132 | u32 tail; | |
133 | u32 head; | |
134 | } __packed; | |
135 | ||
136 | struct wil6210_mbox_ring_desc { | |
137 | __le32 sync; | |
138 | __le32 addr; | |
139 | } __packed; | |
140 | ||
141 | /* at HOST_OFF_WIL6210_MBOX_CTL */ | |
142 | struct wil6210_mbox_ctl { | |
143 | struct wil6210_mbox_ring tx; | |
144 | struct wil6210_mbox_ring rx; | |
145 | } __packed; | |
146 | ||
147 | struct wil6210_mbox_hdr { | |
148 | __le16 seq; | |
149 | __le16 len; /* payload, bytes after this header */ | |
150 | __le16 type; | |
151 | u8 flags; | |
152 | u8 reserved; | |
153 | } __packed; | |
154 | ||
155 | #define WIL_MBOX_HDR_TYPE_WMI (0) | |
156 | ||
157 | /* max. value for wil6210_mbox_hdr.len */ | |
158 | #define MAX_MBOXITEM_SIZE (240) | |
159 | ||
f988b23f VK |
160 | /** |
161 | * struct wil6210_mbox_hdr_wmi - WMI header | |
162 | * | |
163 | * @mid: MAC ID | |
164 | * 00 - default, created by FW | |
165 | * 01..0f - WiFi ports, driver to create | |
166 | * 10..fe - debug | |
167 | * ff - broadcast | |
168 | * @id: command/event ID | |
169 | * @timestamp: FW fills for events, free-running msec timer | |
170 | */ | |
2be7d22f | 171 | struct wil6210_mbox_hdr_wmi { |
f988b23f VK |
172 | u8 mid; |
173 | u8 reserved; | |
2be7d22f | 174 | __le16 id; |
f988b23f | 175 | __le32 timestamp; |
2be7d22f VK |
176 | } __packed; |
177 | ||
178 | struct pending_wmi_event { | |
179 | struct list_head list; | |
180 | struct { | |
181 | struct wil6210_mbox_hdr hdr; | |
182 | struct wil6210_mbox_hdr_wmi wmi; | |
183 | u8 data[0]; | |
184 | } __packed event; | |
185 | }; | |
186 | ||
f88f113a VK |
187 | /** |
188 | * struct wil_ctx - software context for Vring descriptor | |
189 | */ | |
190 | struct wil_ctx { | |
191 | struct sk_buff *skb; | |
192 | u8 mapped_as_page:1; | |
193 | }; | |
194 | ||
2be7d22f VK |
195 | union vring_desc; |
196 | ||
197 | struct vring { | |
198 | dma_addr_t pa; | |
199 | volatile union vring_desc *va; /* vring_desc[size], WriteBack by DMA */ | |
200 | u16 size; /* number of vring_desc elements */ | |
201 | u32 swtail; | |
202 | u32 swhead; | |
203 | u32 hwtail; /* write here to inform hw */ | |
f88f113a | 204 | struct wil_ctx *ctx; /* ctx[size] - software context */ |
2be7d22f VK |
205 | }; |
206 | ||
207 | enum { /* for wil6210_priv.status */ | |
208 | wil_status_fwready = 0, | |
b338f74e | 209 | wil_status_fwconnecting, |
2be7d22f VK |
210 | wil_status_fwconnected, |
211 | wil_status_dontscan, | |
55f7acdd | 212 | wil_status_reset_done, |
2be7d22f VK |
213 | wil_status_irqen, /* FIXME: interrupts enabled - for debug */ |
214 | }; | |
215 | ||
216 | struct pci_dev; | |
217 | ||
218 | struct wil6210_stats { | |
219 | u64 tsf; | |
220 | u32 snr; | |
221 | u16 last_mcs_rx; | |
222 | u16 bf_mcs; /* last BF, used for Tx */ | |
223 | u16 my_rx_sector; | |
224 | u16 my_tx_sector; | |
225 | u16 peer_rx_sector; | |
226 | u16 peer_tx_sector; | |
227 | }; | |
228 | ||
229 | struct wil6210_priv { | |
230 | struct pci_dev *pdev; | |
231 | int n_msi; | |
232 | struct wireless_dev *wdev; | |
233 | void __iomem *csr; | |
234 | ulong status; | |
b8023177 VK |
235 | u32 fw_version; |
236 | u8 n_mids; /* number of additional MIDs as reported by FW */ | |
2be7d22f VK |
237 | /* profile */ |
238 | u32 monitor_flags; | |
239 | u32 secure_pcp; /* create secure PCP? */ | |
240 | int sinfo_gen; | |
241 | /* cached ISR registers */ | |
242 | u32 isr_misc; | |
243 | /* mailbox related */ | |
244 | struct mutex wmi_mutex; | |
245 | struct wil6210_mbox_ctl mbox_ctl; | |
246 | struct completion wmi_ready; | |
247 | u16 wmi_seq; | |
248 | u16 reply_id; /**< wait for this WMI event */ | |
249 | void *reply_buf; | |
250 | u16 reply_size; | |
251 | struct workqueue_struct *wmi_wq; /* for deferred calls */ | |
252 | struct work_struct wmi_event_worker; | |
253 | struct workqueue_struct *wmi_wq_conn; /* for connect worker */ | |
d81079f1 | 254 | struct work_struct connect_worker; |
2be7d22f VK |
255 | struct work_struct disconnect_worker; |
256 | struct timer_list connect_timer; | |
257 | int pending_connect_cid; | |
258 | struct list_head pending_wmi_ev; | |
259 | /* | |
260 | * protect pending_wmi_ev | |
261 | * - fill in IRQ from wil6210_irq_misc, | |
262 | * - consumed in thread by wmi_event_worker | |
263 | */ | |
264 | spinlock_t wmi_ev_lock; | |
e0287c4a VK |
265 | struct napi_struct napi_rx; |
266 | struct napi_struct napi_tx; | |
2be7d22f VK |
267 | /* DMA related */ |
268 | struct vring vring_rx; | |
269 | struct vring vring_tx[WIL6210_MAX_TX_RINGS]; | |
270 | u8 dst_addr[WIL6210_MAX_TX_RINGS][ETH_ALEN]; | |
271 | /* scan */ | |
272 | struct cfg80211_scan_request *scan_request; | |
273 | ||
274 | struct mutex mutex; /* for wil6210_priv access in wil_{up|down} */ | |
275 | /* statistics */ | |
276 | struct wil6210_stats stats; | |
277 | /* debugfs */ | |
278 | struct dentry *debug; | |
279 | struct debugfs_blob_wrapper fw_code_blob; | |
280 | struct debugfs_blob_wrapper fw_data_blob; | |
281 | struct debugfs_blob_wrapper fw_peri_blob; | |
282 | struct debugfs_blob_wrapper uc_code_blob; | |
283 | struct debugfs_blob_wrapper uc_data_blob; | |
284 | struct debugfs_blob_wrapper rgf_blob; | |
285 | }; | |
286 | ||
287 | #define wil_to_wiphy(i) (i->wdev->wiphy) | |
288 | #define wil_to_dev(i) (wiphy_dev(wil_to_wiphy(i))) | |
289 | #define wiphy_to_wil(w) (struct wil6210_priv *)(wiphy_priv(w)) | |
290 | #define wil_to_wdev(i) (i->wdev) | |
291 | #define wdev_to_wil(w) (struct wil6210_priv *)(wdev_priv(w)) | |
292 | #define wil_to_ndev(i) (wil_to_wdev(i)->netdev) | |
293 | #define ndev_to_wil(n) (wdev_to_wil(n->ieee80211_ptr)) | |
294 | ||
98658095 VK |
295 | int wil_dbg_trace(struct wil6210_priv *wil, const char *fmt, ...); |
296 | int wil_err(struct wil6210_priv *wil, const char *fmt, ...); | |
297 | int wil_info(struct wil6210_priv *wil, const char *fmt, ...); | |
298 | #define wil_dbg(wil, fmt, arg...) do { \ | |
299 | netdev_dbg(wil_to_ndev(wil), fmt, ##arg); \ | |
300 | wil_dbg_trace(wil, fmt, ##arg); \ | |
301 | } while (0) | |
2be7d22f | 302 | |
7743882d VK |
303 | #define wil_dbg_irq(wil, fmt, arg...) wil_dbg(wil, "DBG[ IRQ]" fmt, ##arg) |
304 | #define wil_dbg_txrx(wil, fmt, arg...) wil_dbg(wil, "DBG[TXRX]" fmt, ##arg) | |
305 | #define wil_dbg_wmi(wil, fmt, arg...) wil_dbg(wil, "DBG[ WMI]" fmt, ##arg) | |
306 | #define wil_dbg_misc(wil, fmt, arg...) wil_dbg(wil, "DBG[MISC]" fmt, ##arg) | |
2be7d22f | 307 | |
7743882d | 308 | #define wil_hex_dump_txrx(prefix_str, prefix_type, rowsize, \ |
2be7d22f | 309 | groupsize, buf, len, ascii) \ |
3b0378a8 | 310 | print_hex_dump_debug("DBG[TXRX]" prefix_str,\ |
2be7d22f VK |
311 | prefix_type, rowsize, \ |
312 | groupsize, buf, len, ascii) | |
313 | ||
7743882d | 314 | #define wil_hex_dump_wmi(prefix_str, prefix_type, rowsize, \ |
2be7d22f | 315 | groupsize, buf, len, ascii) \ |
3b0378a8 | 316 | print_hex_dump_debug("DBG[ WMI]" prefix_str,\ |
2be7d22f VK |
317 | prefix_type, rowsize, \ |
318 | groupsize, buf, len, ascii) | |
319 | ||
320 | void wil_memcpy_fromio_32(void *dst, const volatile void __iomem *src, | |
321 | size_t count); | |
322 | void wil_memcpy_toio_32(volatile void __iomem *dst, const void *src, | |
323 | size_t count); | |
324 | ||
325 | void *wil_if_alloc(struct device *dev, void __iomem *csr); | |
326 | void wil_if_free(struct wil6210_priv *wil); | |
327 | int wil_if_add(struct wil6210_priv *wil); | |
328 | void wil_if_remove(struct wil6210_priv *wil); | |
329 | int wil_priv_init(struct wil6210_priv *wil); | |
330 | void wil_priv_deinit(struct wil6210_priv *wil); | |
331 | int wil_reset(struct wil6210_priv *wil); | |
332 | void wil_link_on(struct wil6210_priv *wil); | |
333 | void wil_link_off(struct wil6210_priv *wil); | |
334 | int wil_up(struct wil6210_priv *wil); | |
335 | int wil_down(struct wil6210_priv *wil); | |
336 | void wil_mbox_ring_le2cpus(struct wil6210_mbox_ring *r); | |
337 | ||
338 | void __iomem *wmi_buffer(struct wil6210_priv *wil, __le32 ptr); | |
339 | void __iomem *wmi_addr(struct wil6210_priv *wil, u32 ptr); | |
340 | int wmi_read_hdr(struct wil6210_priv *wil, __le32 ptr, | |
341 | struct wil6210_mbox_hdr *hdr); | |
342 | int wmi_send(struct wil6210_priv *wil, u16 cmdid, void *buf, u16 len); | |
343 | void wmi_recv_cmd(struct wil6210_priv *wil); | |
344 | int wmi_call(struct wil6210_priv *wil, u16 cmdid, void *buf, u16 len, | |
345 | u16 reply_id, void *reply, u8 reply_size, int to_msec); | |
2be7d22f VK |
346 | void wmi_event_worker(struct work_struct *work); |
347 | void wmi_event_flush(struct wil6210_priv *wil); | |
348 | int wmi_set_ssid(struct wil6210_priv *wil, u8 ssid_len, const void *ssid); | |
349 | int wmi_get_ssid(struct wil6210_priv *wil, u8 *ssid_len, void *ssid); | |
350 | int wmi_set_channel(struct wil6210_priv *wil, int channel); | |
351 | int wmi_get_channel(struct wil6210_priv *wil, int *channel); | |
2be7d22f VK |
352 | int wmi_del_cipher_key(struct wil6210_priv *wil, u8 key_index, |
353 | const void *mac_addr); | |
354 | int wmi_add_cipher_key(struct wil6210_priv *wil, u8 key_index, | |
355 | const void *mac_addr, int key_len, const void *key); | |
356 | int wmi_echo(struct wil6210_priv *wil); | |
357 | int wmi_set_ie(struct wil6210_priv *wil, u8 type, u16 ie_len, const void *ie); | |
47e19af9 | 358 | int wmi_rx_chain_add(struct wil6210_priv *wil, struct vring *vring); |
b8023177 | 359 | int wmi_p2p_cfg(struct wil6210_priv *wil, int channel); |
1a2780e0 | 360 | int wmi_get_temperature(struct wil6210_priv *wil, u32 *t_m, u32 *t_r); |
2be7d22f VK |
361 | |
362 | int wil6210_init_irq(struct wil6210_priv *wil, int irq); | |
363 | void wil6210_fini_irq(struct wil6210_priv *wil, int irq); | |
364 | void wil6210_disable_irq(struct wil6210_priv *wil); | |
365 | void wil6210_enable_irq(struct wil6210_priv *wil); | |
366 | ||
367 | int wil6210_debugfs_init(struct wil6210_priv *wil); | |
368 | void wil6210_debugfs_remove(struct wil6210_priv *wil); | |
369 | ||
370 | struct wireless_dev *wil_cfg80211_init(struct device *dev); | |
371 | void wil_wdev_free(struct wil6210_priv *wil); | |
372 | ||
373 | int wmi_set_mac_address(struct wil6210_priv *wil, void *addr); | |
b8023177 VK |
374 | int wmi_pcp_start(struct wil6210_priv *wil, int bi, u8 wmi_nettype, u8 chan); |
375 | int wmi_pcp_stop(struct wil6210_priv *wil); | |
2be7d22f VK |
376 | void wil6210_disconnect(struct wil6210_priv *wil, void *bssid); |
377 | ||
378 | int wil_rx_init(struct wil6210_priv *wil); | |
379 | void wil_rx_fini(struct wil6210_priv *wil); | |
380 | ||
381 | /* TX API */ | |
382 | int wil_vring_init_tx(struct wil6210_priv *wil, int id, int size, | |
383 | int cid, int tid); | |
384 | void wil_vring_fini_tx(struct wil6210_priv *wil, int id); | |
385 | ||
386 | netdev_tx_t wil_start_xmit(struct sk_buff *skb, struct net_device *ndev); | |
e0287c4a VK |
387 | int wil_tx_complete(struct wil6210_priv *wil, int ringid); |
388 | void wil6210_unmask_irq_tx(struct wil6210_priv *wil); | |
2be7d22f VK |
389 | |
390 | /* RX API */ | |
e0287c4a VK |
391 | void wil_rx_handle(struct wil6210_priv *wil, int *quota); |
392 | void wil6210_unmask_irq_rx(struct wil6210_priv *wil); | |
2be7d22f VK |
393 | |
394 | int wil_iftype_nl2wmi(enum nl80211_iftype type); | |
395 | ||
396 | #endif /* __WIL6210_H__ */ |