GNU Linux-libre 4.9.283-gnu1
[releases.git] / drivers / net / wireless / intersil / p54 / lmac.h
1 /*
2  * LMAC Interface specific definitions for mac80211 Prism54 drivers
3  *
4  * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net>
5  * Copyright (c) 2007 - 2009, Christian Lamparter <chunkeey@web.de>
6  *
7  * Based on:
8  * - the islsm (softmac prism54) driver, which is:
9  *   Copyright 2004-2006 Jean-Baptiste Note <jbnote@gmail.com>, et al.
10  *
11  * - LMAC API interface header file for STLC4560 (lmac_longbow.h)
12  *   Copyright (C) 2007 Conexant Systems, Inc.
13  *
14  * This program is free software; you can redistribute it and/or modify
15  * it under the terms of the GNU General Public License version 2 as
16  * published by the Free Software Foundation.
17  */
18
19 #ifndef LMAC_H
20 #define LMAC_H
21
22 enum p54_control_frame_types {
23         P54_CONTROL_TYPE_SETUP = 0,
24         P54_CONTROL_TYPE_SCAN,
25         P54_CONTROL_TYPE_TRAP,
26         P54_CONTROL_TYPE_DCFINIT,
27         P54_CONTROL_TYPE_RX_KEYCACHE,
28         P54_CONTROL_TYPE_TIM,
29         P54_CONTROL_TYPE_PSM,
30         P54_CONTROL_TYPE_TXCANCEL,
31         P54_CONTROL_TYPE_TXDONE,
32         P54_CONTROL_TYPE_BURST,
33         P54_CONTROL_TYPE_STAT_READBACK,
34         P54_CONTROL_TYPE_BBP,
35         P54_CONTROL_TYPE_EEPROM_READBACK,
36         P54_CONTROL_TYPE_LED,
37         P54_CONTROL_TYPE_GPIO,
38         P54_CONTROL_TYPE_TIMER,
39         P54_CONTROL_TYPE_MODULATION,
40         P54_CONTROL_TYPE_SYNTH_CONFIG,
41         P54_CONTROL_TYPE_DETECTOR_VALUE,
42         P54_CONTROL_TYPE_XBOW_SYNTH_CFG,
43         P54_CONTROL_TYPE_CCE_QUIET,
44         P54_CONTROL_TYPE_PSM_STA_UNLOCK,
45         P54_CONTROL_TYPE_PCS,
46         P54_CONTROL_TYPE_BT_BALANCER = 28,
47         P54_CONTROL_TYPE_GROUP_ADDRESS_TABLE = 30,
48         P54_CONTROL_TYPE_ARPTABLE = 31,
49         P54_CONTROL_TYPE_BT_OPTIONS = 35,
50 };
51
52 #define P54_HDR_FLAG_CONTROL            BIT(15)
53 #define P54_HDR_FLAG_CONTROL_OPSET      (BIT(15) + BIT(0))
54 #define P54_HDR_FLAG_DATA_ALIGN         BIT(14)
55
56 #define P54_HDR_FLAG_DATA_OUT_PROMISC           BIT(0)
57 #define P54_HDR_FLAG_DATA_OUT_TIMESTAMP         BIT(1)
58 #define P54_HDR_FLAG_DATA_OUT_SEQNR             BIT(2)
59 #define P54_HDR_FLAG_DATA_OUT_BIT3              BIT(3)
60 #define P54_HDR_FLAG_DATA_OUT_BURST             BIT(4)
61 #define P54_HDR_FLAG_DATA_OUT_NOCANCEL          BIT(5)
62 #define P54_HDR_FLAG_DATA_OUT_CLEARTIM          BIT(6)
63 #define P54_HDR_FLAG_DATA_OUT_HITCHHIKE         BIT(7)
64 #define P54_HDR_FLAG_DATA_OUT_COMPRESS          BIT(8)
65 #define P54_HDR_FLAG_DATA_OUT_CONCAT            BIT(9)
66 #define P54_HDR_FLAG_DATA_OUT_PCS_ACCEPT        BIT(10)
67 #define P54_HDR_FLAG_DATA_OUT_WAITEOSP          BIT(11)
68
69 #define P54_HDR_FLAG_DATA_IN_FCS_GOOD           BIT(0)
70 #define P54_HDR_FLAG_DATA_IN_MATCH_MAC          BIT(1)
71 #define P54_HDR_FLAG_DATA_IN_MCBC               BIT(2)
72 #define P54_HDR_FLAG_DATA_IN_BEACON             BIT(3)
73 #define P54_HDR_FLAG_DATA_IN_MATCH_BSS          BIT(4)
74 #define P54_HDR_FLAG_DATA_IN_BCAST_BSS          BIT(5)
75 #define P54_HDR_FLAG_DATA_IN_DATA               BIT(6)
76 #define P54_HDR_FLAG_DATA_IN_TRUNCATED          BIT(7)
77 #define P54_HDR_FLAG_DATA_IN_BIT8               BIT(8)
78 #define P54_HDR_FLAG_DATA_IN_TRANSPARENT        BIT(9)
79
80 struct p54_hdr {
81         __le16 flags;
82         __le16 len;
83         __le32 req_id;
84         __le16 type;    /* enum p54_control_frame_types */
85         u8 rts_tries;
86         u8 tries;
87         u8 data[0];
88 } __packed;
89
90 #define GET_REQ_ID(skb)                                                 \
91         (((struct p54_hdr *) ((struct sk_buff *) skb)->data)->req_id)   \
92
93 #define FREE_AFTER_TX(skb)                                              \
94         ((((struct p54_hdr *) ((struct sk_buff *) skb)->data)->         \
95         flags) == cpu_to_le16(P54_HDR_FLAG_CONTROL_OPSET))
96
97 #define IS_DATA_FRAME(skb)                                              \
98         (!((((struct p54_hdr *) ((struct sk_buff *) skb)->data)->       \
99         flags) & cpu_to_le16(P54_HDR_FLAG_CONTROL)))
100
101 #define GET_HW_QUEUE(skb)                                               \
102         (((struct p54_tx_data *)((struct p54_hdr *)                     \
103         skb->data)->data)->hw_queue)
104
105 /*
106  * shared interface ID definitions
107  * The interface ID is a unique identification of a specific interface.
108  * The following values are reserved: 0x0000, 0x0002, 0x0012, 0x0014, 0x0015
109  */
110 #define IF_ID_ISL36356A                 0x0001  /* ISL36356A <-> Firmware */
111 #define IF_ID_MVC                       0x0003  /* MAC Virtual Coprocessor */
112 #define IF_ID_DEBUG                     0x0008  /* PolDebug Interface */
113 #define IF_ID_PRODUCT                   0x0009
114 #define IF_ID_OEM                       0x000a
115 #define IF_ID_PCI3877                   0x000b  /* 3877 <-> Host PCI */
116 #define IF_ID_ISL37704C                 0x000c  /* ISL37704C <-> Fw */
117 #define IF_ID_ISL39000                  0x000f  /* ISL39000 <-> Fw */
118 #define IF_ID_ISL39300A                 0x0010  /* ISL39300A <-> Fw */
119 #define IF_ID_ISL37700_UAP              0x0016  /* ISL37700 uAP Fw <-> Fw */
120 #define IF_ID_ISL39000_UAP              0x0017  /* ISL39000 uAP Fw <-> Fw */
121 #define IF_ID_LMAC                      0x001a  /* Interface exposed by LMAC */
122
123 struct exp_if {
124         __le16 role;
125         __le16 if_id;
126         __le16 variant;
127         __le16 btm_compat;
128         __le16 top_compat;
129 } __packed;
130
131 struct dep_if {
132         __le16 role;
133         __le16 if_id;
134         __le16 variant;
135 } __packed;
136
137 /* driver <-> lmac definitions */
138 struct p54_eeprom_lm86 {
139         union {
140                 struct {
141                         __le16 offset;
142                         __le16 len;
143                         u8 data[0];
144                 } __packed v1;
145                 struct {
146                         __le32 offset;
147                         __le16 len;
148                         u8 magic2;
149                         u8 pad;
150                         u8 magic[4];
151                         u8 data[0];
152                 } __packed v2;
153         }  __packed;
154 } __packed;
155
156 enum p54_rx_decrypt_status {
157         P54_DECRYPT_NONE = 0,
158         P54_DECRYPT_OK,
159         P54_DECRYPT_NOKEY,
160         P54_DECRYPT_NOMICHAEL,
161         P54_DECRYPT_NOCKIPMIC,
162         P54_DECRYPT_FAIL_WEP,
163         P54_DECRYPT_FAIL_TKIP,
164         P54_DECRYPT_FAIL_MICHAEL,
165         P54_DECRYPT_FAIL_CKIPKP,
166         P54_DECRYPT_FAIL_CKIPMIC,
167         P54_DECRYPT_FAIL_AESCCMP
168 };
169
170 struct p54_rx_data {
171         __le16 flags;
172         __le16 len;
173         __le16 freq;
174         u8 antenna;
175         u8 rate;
176         u8 rssi;
177         u8 quality;
178         u8 decrypt_status;
179         u8 rssi_raw;
180         __le32 tsf32;
181         __le32 unalloc0;
182         u8 align[0];
183 } __packed;
184
185 enum p54_trap_type {
186         P54_TRAP_SCAN = 0,
187         P54_TRAP_TIMER,
188         P54_TRAP_BEACON_TX,
189         P54_TRAP_FAA_RADIO_ON,
190         P54_TRAP_FAA_RADIO_OFF,
191         P54_TRAP_RADAR,
192         P54_TRAP_NO_BEACON,
193         P54_TRAP_TBTT,
194         P54_TRAP_SCO_ENTER,
195         P54_TRAP_SCO_EXIT
196 };
197
198 struct p54_trap {
199         __le16 event;
200         __le16 frequency;
201 } __packed;
202
203 enum p54_frame_sent_status {
204         P54_TX_OK = 0,
205         P54_TX_FAILED,
206         P54_TX_PSM,
207         P54_TX_PSM_CANCELLED = 4
208 };
209
210 struct p54_frame_sent {
211         u8 status;
212         u8 tries;
213         u8 ack_rssi;
214         u8 quality;
215         __le16 seq;
216         u8 antenna;
217         u8 padding;
218 } __packed;
219
220 enum p54_tx_data_crypt {
221         P54_CRYPTO_NONE = 0,
222         P54_CRYPTO_WEP,
223         P54_CRYPTO_TKIP,
224         P54_CRYPTO_TKIPMICHAEL,
225         P54_CRYPTO_CCX_WEPMIC,
226         P54_CRYPTO_CCX_KPMIC,
227         P54_CRYPTO_CCX_KP,
228         P54_CRYPTO_AESCCMP
229 };
230
231 enum p54_tx_data_queue {
232         P54_QUEUE_BEACON        = 0,
233         P54_QUEUE_FWSCAN        = 1,
234         P54_QUEUE_MGMT          = 2,
235         P54_QUEUE_CAB           = 3,
236         P54_QUEUE_DATA          = 4,
237
238         P54_QUEUE_AC_NUM        = 4,
239         P54_QUEUE_AC_VO         = 4,
240         P54_QUEUE_AC_VI         = 5,
241         P54_QUEUE_AC_BE         = 6,
242         P54_QUEUE_AC_BK         = 7,
243
244         /* keep last */
245         P54_QUEUE_NUM           = 8,
246 };
247
248 #define IS_QOS_QUEUE(n) (n >= P54_QUEUE_DATA)
249
250 struct p54_tx_data {
251         u8 rateset[8];
252         u8 rts_rate_idx;
253         u8 crypt_offset;
254         u8 key_type;
255         u8 key_len;
256         u8 key[16];
257         u8 hw_queue;
258         u8 backlog;
259         __le16 durations[4];
260         u8 tx_antenna;
261         union {
262                 struct {
263                         u8 cts_rate;
264                         __le16 output_power;
265                 } __packed longbow;
266                 struct {
267                         u8 output_power;
268                         u8 cts_rate;
269                         u8 unalloc;
270                 } __packed normal;
271         } __packed;
272         u8 unalloc2[2];
273         u8 align[0];
274 } __packed;
275
276 /* unit is ms */
277 #define P54_TX_FRAME_LIFETIME 2000
278 #define P54_TX_TIMEOUT 4000
279 #define P54_STATISTICS_UPDATE 5000
280
281 #define P54_FILTER_TYPE_NONE            0
282 #define P54_FILTER_TYPE_STATION         BIT(0)
283 #define P54_FILTER_TYPE_IBSS            BIT(1)
284 #define P54_FILTER_TYPE_AP              BIT(2)
285 #define P54_FILTER_TYPE_TRANSPARENT     BIT(3)
286 #define P54_FILTER_TYPE_PROMISCUOUS     BIT(4)
287 #define P54_FILTER_TYPE_HIBERNATE       BIT(5)
288 #define P54_FILTER_TYPE_NOACK           BIT(6)
289 #define P54_FILTER_TYPE_RX_DISABLED     BIT(7)
290
291 struct p54_setup_mac {
292         __le16 mac_mode;
293         u8 mac_addr[ETH_ALEN];
294         u8 bssid[ETH_ALEN];
295         u8 rx_antenna;
296         u8 rx_align;
297         union {
298                 struct {
299                         __le32 basic_rate_mask;
300                         u8 rts_rates[8];
301                         __le32 rx_addr;
302                         __le16 max_rx;
303                         __le16 rxhw;
304                         __le16 wakeup_timer;
305                         __le16 unalloc0;
306                 } __packed v1;
307                 struct {
308                         __le32 rx_addr;
309                         __le16 max_rx;
310                         __le16 rxhw;
311                         __le16 timer;
312                         __le16 truncate;
313                         __le32 basic_rate_mask;
314                         u8 sbss_offset;
315                         u8 mcast_window;
316                         u8 rx_rssi_threshold;
317                         u8 rx_ed_threshold;
318                         __le32 ref_clock;
319                         __le16 lpf_bandwidth;
320                         __le16 osc_start_delay;
321                 } __packed v2;
322         } __packed;
323 } __packed;
324
325 #define P54_SETUP_V1_LEN 40
326 #define P54_SETUP_V2_LEN (sizeof(struct p54_setup_mac))
327
328 #define P54_SCAN_EXIT   BIT(0)
329 #define P54_SCAN_TRAP   BIT(1)
330 #define P54_SCAN_ACTIVE BIT(2)
331 #define P54_SCAN_FILTER BIT(3)
332
333 struct p54_scan_head {
334         __le16 mode;
335         __le16 dwell;
336         u8 scan_params[20];
337         __le16 freq;
338 } __packed;
339
340 struct p54_pa_curve_data_sample {
341         u8 rf_power;
342         u8 pa_detector;
343         u8 data_barker;
344         u8 data_bpsk;
345         u8 data_qpsk;
346         u8 data_16qam;
347         u8 data_64qam;
348         u8 padding;
349 } __packed;
350
351 struct p54_scan_body {
352         u8 pa_points_per_curve;
353         u8 val_barker;
354         u8 val_bpsk;
355         u8 val_qpsk;
356         u8 val_16qam;
357         u8 val_64qam;
358         struct p54_pa_curve_data_sample curve_data[8];
359         u8 dup_bpsk;
360         u8 dup_qpsk;
361         u8 dup_16qam;
362         u8 dup_64qam;
363 } __packed;
364
365 /*
366  * Warning: Longbow's structures are bogus.
367  */
368 struct p54_channel_output_limit_longbow {
369         __le16 rf_power_points[12];
370 } __packed;
371
372 struct p54_pa_curve_data_sample_longbow {
373         __le16 rf_power;
374         __le16 pa_detector;
375         struct {
376                 __le16 data[4];
377         } points[3] __packed;
378 } __packed;
379
380 struct p54_scan_body_longbow {
381         struct p54_channel_output_limit_longbow power_limits;
382         struct p54_pa_curve_data_sample_longbow curve_data[8];
383         __le16 unkn[6];         /* maybe more power_limits or rate_mask */
384 } __packed;
385
386 union p54_scan_body_union {
387         struct p54_scan_body normal;
388         struct p54_scan_body_longbow longbow;
389 } __packed;
390
391 struct p54_scan_tail_rate {
392         __le32 basic_rate_mask;
393         u8 rts_rates[8];
394 } __packed;
395
396 struct p54_led {
397         __le16 flags;
398         __le16 mask[2];
399         __le16 delay[2];
400 } __packed;
401
402 struct p54_edcf {
403         u8 flags;
404         u8 slottime;
405         u8 sifs;
406         u8 eofpad;
407         struct p54_edcf_queue_param queue[8];
408         u8 mapping[4];
409         __le16 frameburst;
410         __le16 round_trip_delay;
411 } __packed;
412
413 struct p54_statistics {
414         __le32 rx_success;
415         __le32 rx_bad_fcs;
416         __le32 rx_abort;
417         __le32 rx_abort_phy;
418         __le32 rts_success;
419         __le32 rts_fail;
420         __le32 tsf32;
421         __le32 airtime;
422         __le32 noise;
423         __le32 sample_noise[8];
424         __le32 sample_cca;
425         __le32 sample_tx;
426 } __packed;
427
428 struct p54_xbow_synth {
429         __le16 magic1;
430         __le16 magic2;
431         __le16 freq;
432         u32 padding[5];
433 } __packed;
434
435 struct p54_timer {
436         __le32 interval;
437 } __packed;
438
439 struct p54_keycache {
440         u8 entry;
441         u8 key_id;
442         u8 mac[ETH_ALEN];
443         u8 padding[2];
444         u8 key_type;
445         u8 key_len;
446         u8 key[24];
447 } __packed;
448
449 struct p54_burst {
450         u8 flags;
451         u8 queue;
452         u8 backlog;
453         u8 pad;
454         __le16 durations[32];
455 } __packed;
456
457 struct p54_psm_interval {
458         __le16 interval;
459         __le16 periods;
460 } __packed;
461
462 #define P54_PSM_CAM                     0
463 #define P54_PSM                         BIT(0)
464 #define P54_PSM_DTIM                    BIT(1)
465 #define P54_PSM_MCBC                    BIT(2)
466 #define P54_PSM_CHECKSUM                BIT(3)
467 #define P54_PSM_SKIP_MORE_DATA          BIT(4)
468 #define P54_PSM_BEACON_TIMEOUT          BIT(5)
469 #define P54_PSM_HFOSLEEP                BIT(6)
470 #define P54_PSM_AUTOSWITCH_SLEEP        BIT(7)
471 #define P54_PSM_LPIT                    BIT(8)
472 #define P54_PSM_BF_UCAST_SKIP           BIT(9)
473 #define P54_PSM_BF_MCAST_SKIP           BIT(10)
474
475 struct p54_psm {
476         __le16 mode;
477         __le16 aid;
478         struct p54_psm_interval intervals[4];
479         u8 beacon_rssi_skip_max;
480         u8 rssi_delta_threshold;
481         u8 nr;
482         u8 exclude[1];
483 } __packed;
484
485 #define MC_FILTER_ADDRESS_NUM 4
486
487 struct p54_group_address_table {
488         __le16 filter_enable;
489         __le16 num_address;
490         u8 mac_list[MC_FILTER_ADDRESS_NUM][ETH_ALEN];
491 } __packed;
492
493 struct p54_txcancel {
494         __le32 req_id;
495 } __packed;
496
497 struct p54_sta_unlock {
498         u8 addr[ETH_ALEN];
499         u16 padding;
500 } __packed;
501
502 #define P54_TIM_CLEAR BIT(15)
503 struct p54_tim {
504         u8 count;
505         u8 padding[3];
506         __le16 entry[8];
507 } __packed;
508
509 struct p54_cce_quiet {
510         __le32 period;
511 } __packed;
512
513 struct p54_bt_balancer {
514         __le16 prio_thresh;
515         __le16 acl_thresh;
516 } __packed;
517
518 struct p54_arp_table {
519         __le16 filter_enable;
520         u8 ipv4_addr[4];
521 } __packed;
522
523 /* LED control */
524 int p54_set_leds(struct p54_common *priv);
525 int p54_init_leds(struct p54_common *priv);
526 void p54_unregister_leds(struct p54_common *priv);
527
528 /* xmit functions */
529 void p54_tx_80211(struct ieee80211_hw *dev,
530                   struct ieee80211_tx_control *control,
531                   struct sk_buff *skb);
532 int p54_tx_cancel(struct p54_common *priv, __le32 req_id);
533 void p54_tx(struct p54_common *priv, struct sk_buff *skb);
534
535 /* synth/phy configuration */
536 int p54_init_xbow_synth(struct p54_common *priv);
537 int p54_scan(struct p54_common *priv, u16 mode, u16 dwell);
538
539 /* MAC */
540 int p54_sta_unlock(struct p54_common *priv, u8 *addr);
541 int p54_update_beacon_tim(struct p54_common *priv, u16 aid, bool set);
542 int p54_setup_mac(struct p54_common *priv);
543 int p54_set_ps(struct p54_common *priv);
544 int p54_fetch_statistics(struct p54_common *priv);
545 int p54_set_groupfilter(struct p54_common *priv);
546
547 /* e/v DCF setup */
548 int p54_set_edcf(struct p54_common *priv);
549
550 /* cryptographic engine */
551 int p54_upload_key(struct p54_common *priv, u8 algo, int slot,
552                    u8 idx, u8 len, u8 *addr, u8* key);
553
554 /* eeprom */
555 int p54_download_eeprom(struct p54_common *priv, void *buf,
556                         u16 offset, u16 len);
557 struct p54_rssi_db_entry *p54_rssi_find(struct p54_common *p, const u16 freq);
558
559 /* utility */
560 u8 *p54_find_ie(struct sk_buff *skb, u8 ie);
561
562 #endif /* LMAC_H */