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 */