rt2x00.h revision 1ebbc48520a0853cd4d812d8342f9886b2b07b92
1/* 2 Copyright (C) 2010 Willow Garage <http://www.willowgarage.com> 3 Copyright (C) 2004 - 2010 Ivo van Doorn <IvDoorn@gmail.com> 4 Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com> 5 <http://rt2x00.serialmonkey.com> 6 7 This program is free software; you can redistribute it and/or modify 8 it under the terms of the GNU General Public License as published by 9 the Free Software Foundation; either version 2 of the License, or 10 (at your option) any later version. 11 12 This program is distributed in the hope that it will be useful, 13 but WITHOUT ANY WARRANTY; without even the implied warranty of 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 GNU General Public License for more details. 16 17 You should have received a copy of the GNU General Public License 18 along with this program; if not, write to the 19 Free Software Foundation, Inc., 20 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 21 */ 22 23/* 24 Module: rt2x00 25 Abstract: rt2x00 global information. 26 */ 27 28#ifndef RT2X00_H 29#define RT2X00_H 30 31#include <linux/bitops.h> 32#include <linux/interrupt.h> 33#include <linux/skbuff.h> 34#include <linux/workqueue.h> 35#include <linux/firmware.h> 36#include <linux/leds.h> 37#include <linux/mutex.h> 38#include <linux/etherdevice.h> 39#include <linux/input-polldev.h> 40#include <linux/kfifo.h> 41#include <linux/timer.h> 42 43#include <net/mac80211.h> 44 45#include "rt2x00debug.h" 46#include "rt2x00dump.h" 47#include "rt2x00leds.h" 48#include "rt2x00reg.h" 49#include "rt2x00queue.h" 50 51/* 52 * Module information. 53 */ 54#define DRV_VERSION "2.3.0" 55#define DRV_PROJECT "http://rt2x00.serialmonkey.com" 56 57/* 58 * Debug definitions. 59 * Debug output has to be enabled during compile time. 60 */ 61#define DEBUG_PRINTK_MSG(__dev, __kernlvl, __lvl, __msg, __args...) \ 62 printk(__kernlvl "%s -> %s: %s - " __msg, \ 63 wiphy_name((__dev)->hw->wiphy), __func__, __lvl, ##__args) 64 65#define DEBUG_PRINTK_PROBE(__kernlvl, __lvl, __msg, __args...) \ 66 printk(__kernlvl "%s -> %s: %s - " __msg, \ 67 KBUILD_MODNAME, __func__, __lvl, ##__args) 68 69#ifdef CONFIG_RT2X00_DEBUG 70#define DEBUG_PRINTK(__dev, __kernlvl, __lvl, __msg, __args...) \ 71 DEBUG_PRINTK_MSG(__dev, __kernlvl, __lvl, __msg, ##__args) 72#else 73#define DEBUG_PRINTK(__dev, __kernlvl, __lvl, __msg, __args...) \ 74 do { } while (0) 75#endif /* CONFIG_RT2X00_DEBUG */ 76 77/* 78 * Various debug levels. 79 * The debug levels PANIC and ERROR both indicate serious problems, 80 * for this reason they should never be ignored. 81 * The special ERROR_PROBE message is for messages that are generated 82 * when the rt2x00_dev is not yet initialized. 83 */ 84#define PANIC(__dev, __msg, __args...) \ 85 DEBUG_PRINTK_MSG(__dev, KERN_CRIT, "Panic", __msg, ##__args) 86#define ERROR(__dev, __msg, __args...) \ 87 DEBUG_PRINTK_MSG(__dev, KERN_ERR, "Error", __msg, ##__args) 88#define ERROR_PROBE(__msg, __args...) \ 89 DEBUG_PRINTK_PROBE(KERN_ERR, "Error", __msg, ##__args) 90#define WARNING(__dev, __msg, __args...) \ 91 DEBUG_PRINTK(__dev, KERN_WARNING, "Warning", __msg, ##__args) 92#define NOTICE(__dev, __msg, __args...) \ 93 DEBUG_PRINTK(__dev, KERN_NOTICE, "Notice", __msg, ##__args) 94#define INFO(__dev, __msg, __args...) \ 95 DEBUG_PRINTK(__dev, KERN_INFO, "Info", __msg, ##__args) 96#define DEBUG(__dev, __msg, __args...) \ 97 DEBUG_PRINTK(__dev, KERN_DEBUG, "Debug", __msg, ##__args) 98#define EEPROM(__dev, __msg, __args...) \ 99 DEBUG_PRINTK(__dev, KERN_DEBUG, "EEPROM recovery", __msg, ##__args) 100 101/* 102 * Duration calculations 103 * The rate variable passed is: 100kbs. 104 * To convert from bytes to bits we multiply size with 8, 105 * then the size is multiplied with 10 to make the 106 * real rate -> rate argument correction. 107 */ 108#define GET_DURATION(__size, __rate) (((__size) * 8 * 10) / (__rate)) 109#define GET_DURATION_RES(__size, __rate)(((__size) * 8 * 10) % (__rate)) 110 111/* 112 * Determine the number of L2 padding bytes required between the header and 113 * the payload. 114 */ 115#define L2PAD_SIZE(__hdrlen) (-(__hdrlen) & 3) 116 117/* 118 * Determine the alignment requirement, 119 * to make sure the 802.11 payload is padded to a 4-byte boundrary 120 * we must determine the address of the payload and calculate the 121 * amount of bytes needed to move the data. 122 */ 123#define ALIGN_SIZE(__skb, __header) \ 124 ( ((unsigned long)((__skb)->data + (__header))) & 3 ) 125 126/* 127 * Constants for extra TX headroom for alignment purposes. 128 */ 129#define RT2X00_ALIGN_SIZE 4 /* Only whole frame needs alignment */ 130#define RT2X00_L2PAD_SIZE 8 /* Both header & payload need alignment */ 131 132/* 133 * Standard timing and size defines. 134 * These values should follow the ieee80211 specifications. 135 */ 136#define ACK_SIZE 14 137#define IEEE80211_HEADER 24 138#define PLCP 48 139#define BEACON 100 140#define PREAMBLE 144 141#define SHORT_PREAMBLE 72 142#define SLOT_TIME 20 143#define SHORT_SLOT_TIME 9 144#define SIFS 10 145#define PIFS ( SIFS + SLOT_TIME ) 146#define SHORT_PIFS ( SIFS + SHORT_SLOT_TIME ) 147#define DIFS ( PIFS + SLOT_TIME ) 148#define SHORT_DIFS ( SHORT_PIFS + SHORT_SLOT_TIME ) 149#define EIFS ( SIFS + DIFS + \ 150 GET_DURATION(IEEE80211_HEADER + ACK_SIZE, 10) ) 151#define SHORT_EIFS ( SIFS + SHORT_DIFS + \ 152 GET_DURATION(IEEE80211_HEADER + ACK_SIZE, 10) ) 153 154/* 155 * Structure for average calculation 156 * The avg field contains the actual average value, 157 * but avg_weight is internally used during calculations 158 * to prevent rounding errors. 159 */ 160struct avg_val { 161 int avg; 162 int avg_weight; 163}; 164 165enum rt2x00_chip_intf { 166 RT2X00_CHIP_INTF_PCI, 167 RT2X00_CHIP_INTF_PCIE, 168 RT2X00_CHIP_INTF_USB, 169 RT2X00_CHIP_INTF_SOC, 170}; 171 172/* 173 * Chipset identification 174 * The chipset on the device is composed of a RT and RF chip. 175 * The chipset combination is important for determining device capabilities. 176 */ 177struct rt2x00_chip { 178 u16 rt; 179#define RT2460 0x2460 180#define RT2560 0x2560 181#define RT2570 0x2570 182#define RT2661 0x2661 183#define RT2573 0x2573 184#define RT2860 0x2860 /* 2.4GHz */ 185#define RT2872 0x2872 /* WSOC */ 186#define RT2883 0x2883 /* WSOC */ 187#define RT3070 0x3070 188#define RT3071 0x3071 189#define RT3090 0x3090 /* 2.4GHz PCIe */ 190#define RT3390 0x3390 191#define RT3572 0x3572 192#define RT3593 0x3593 193#define RT3883 0x3883 /* WSOC */ 194#define RT5390 0x5390 /* 2.4GHz */ 195 196 u16 rf; 197 u16 rev; 198 199 enum rt2x00_chip_intf intf; 200}; 201 202/* 203 * RF register values that belong to a particular channel. 204 */ 205struct rf_channel { 206 int channel; 207 u32 rf1; 208 u32 rf2; 209 u32 rf3; 210 u32 rf4; 211}; 212 213/* 214 * Channel information structure 215 */ 216struct channel_info { 217 unsigned int flags; 218#define GEOGRAPHY_ALLOWED 0x00000001 219 220 short max_power; 221 short default_power1; 222 short default_power2; 223}; 224 225/* 226 * Antenna setup values. 227 */ 228struct antenna_setup { 229 enum antenna rx; 230 enum antenna tx; 231 u8 rx_chain_num; 232 u8 tx_chain_num; 233}; 234 235/* 236 * Quality statistics about the currently active link. 237 */ 238struct link_qual { 239 /* 240 * Statistics required for Link tuning by driver 241 * The rssi value is provided by rt2x00lib during the 242 * link_tuner() callback function. 243 * The false_cca field is filled during the link_stats() 244 * callback function and could be used during the 245 * link_tuner() callback function. 246 */ 247 int rssi; 248 int false_cca; 249 250 /* 251 * VGC levels 252 * Hardware driver will tune the VGC level during each call 253 * to the link_tuner() callback function. This vgc_level is 254 * is determined based on the link quality statistics like 255 * average RSSI and the false CCA count. 256 * 257 * In some cases the drivers need to differentiate between 258 * the currently "desired" VGC level and the level configured 259 * in the hardware. The latter is important to reduce the 260 * number of BBP register reads to reduce register access 261 * overhead. For this reason we store both values here. 262 */ 263 u8 vgc_level; 264 u8 vgc_level_reg; 265 266 /* 267 * Statistics required for Signal quality calculation. 268 * These fields might be changed during the link_stats() 269 * callback function. 270 */ 271 int rx_success; 272 int rx_failed; 273 int tx_success; 274 int tx_failed; 275}; 276 277/* 278 * Antenna settings about the currently active link. 279 */ 280struct link_ant { 281 /* 282 * Antenna flags 283 */ 284 unsigned int flags; 285#define ANTENNA_RX_DIVERSITY 0x00000001 286#define ANTENNA_TX_DIVERSITY 0x00000002 287#define ANTENNA_MODE_SAMPLE 0x00000004 288 289 /* 290 * Currently active TX/RX antenna setup. 291 * When software diversity is used, this will indicate 292 * which antenna is actually used at this time. 293 */ 294 struct antenna_setup active; 295 296 /* 297 * RSSI history information for the antenna. 298 * Used to determine when to switch antenna 299 * when using software diversity. 300 */ 301 int rssi_history; 302 303 /* 304 * Current RSSI average of the currently active antenna. 305 * Similar to the avg_rssi in the link_qual structure 306 * this value is updated by using the walking average. 307 */ 308 struct avg_val rssi_ant; 309}; 310 311/* 312 * To optimize the quality of the link we need to store 313 * the quality of received frames and periodically 314 * optimize the link. 315 */ 316struct link { 317 /* 318 * Link tuner counter 319 * The number of times the link has been tuned 320 * since the radio has been switched on. 321 */ 322 u32 count; 323 324 /* 325 * Quality measurement values. 326 */ 327 struct link_qual qual; 328 329 /* 330 * TX/RX antenna setup. 331 */ 332 struct link_ant ant; 333 334 /* 335 * Currently active average RSSI value 336 */ 337 struct avg_val avg_rssi; 338 339 /* 340 * Work structure for scheduling periodic link tuning. 341 */ 342 struct delayed_work work; 343 344 /* 345 * Work structure for scheduling periodic watchdog monitoring. 346 * This work must be scheduled on the kernel workqueue, while 347 * all other work structures must be queued on the mac80211 348 * workqueue. This guarantees that the watchdog can schedule 349 * other work structures and wait for their completion in order 350 * to bring the device/driver back into the desired state. 351 */ 352 struct delayed_work watchdog_work; 353 354 /* 355 * Work structure for scheduling periodic AGC adjustments. 356 */ 357 struct delayed_work agc_work; 358}; 359 360enum rt2x00_delayed_flags { 361 DELAYED_UPDATE_BEACON, 362}; 363 364/* 365 * Interface structure 366 * Per interface configuration details, this structure 367 * is allocated as the private data for ieee80211_vif. 368 */ 369struct rt2x00_intf { 370 /* 371 * beacon->skb must be protected with the mutex. 372 */ 373 struct mutex beacon_skb_mutex; 374 375 /* 376 * Entry in the beacon queue which belongs to 377 * this interface. Each interface has its own 378 * dedicated beacon entry. 379 */ 380 struct queue_entry *beacon; 381 bool enable_beacon; 382 383 /* 384 * Actions that needed rescheduling. 385 */ 386 unsigned long delayed_flags; 387 388 /* 389 * Software sequence counter, this is only required 390 * for hardware which doesn't support hardware 391 * sequence counting. 392 */ 393 spinlock_t seqlock; 394 u16 seqno; 395}; 396 397static inline struct rt2x00_intf* vif_to_intf(struct ieee80211_vif *vif) 398{ 399 return (struct rt2x00_intf *)vif->drv_priv; 400} 401 402/** 403 * struct hw_mode_spec: Hardware specifications structure 404 * 405 * Details about the supported modes, rates and channels 406 * of a particular chipset. This is used by rt2x00lib 407 * to build the ieee80211_hw_mode array for mac80211. 408 * 409 * @supported_bands: Bitmask contained the supported bands (2.4GHz, 5.2GHz). 410 * @supported_rates: Rate types which are supported (CCK, OFDM). 411 * @num_channels: Number of supported channels. This is used as array size 412 * for @tx_power_a, @tx_power_bg and @channels. 413 * @channels: Device/chipset specific channel values (See &struct rf_channel). 414 * @channels_info: Additional information for channels (See &struct channel_info). 415 * @ht: Driver HT Capabilities (See &ieee80211_sta_ht_cap). 416 */ 417struct hw_mode_spec { 418 unsigned int supported_bands; 419#define SUPPORT_BAND_2GHZ 0x00000001 420#define SUPPORT_BAND_5GHZ 0x00000002 421 422 unsigned int supported_rates; 423#define SUPPORT_RATE_CCK 0x00000001 424#define SUPPORT_RATE_OFDM 0x00000002 425 426 unsigned int num_channels; 427 const struct rf_channel *channels; 428 const struct channel_info *channels_info; 429 430 struct ieee80211_sta_ht_cap ht; 431}; 432 433/* 434 * Configuration structure wrapper around the 435 * mac80211 configuration structure. 436 * When mac80211 configures the driver, rt2x00lib 437 * can precalculate values which are equal for all 438 * rt2x00 drivers. Those values can be stored in here. 439 */ 440struct rt2x00lib_conf { 441 struct ieee80211_conf *conf; 442 443 struct rf_channel rf; 444 struct channel_info channel; 445}; 446 447/* 448 * Configuration structure for erp settings. 449 */ 450struct rt2x00lib_erp { 451 int short_preamble; 452 int cts_protection; 453 454 u32 basic_rates; 455 456 int slot_time; 457 458 short sifs; 459 short pifs; 460 short difs; 461 short eifs; 462 463 u16 beacon_int; 464 u16 ht_opmode; 465}; 466 467/* 468 * Configuration structure for hardware encryption. 469 */ 470struct rt2x00lib_crypto { 471 enum cipher cipher; 472 473 enum set_key_cmd cmd; 474 const u8 *address; 475 476 u32 bssidx; 477 478 u8 key[16]; 479 u8 tx_mic[8]; 480 u8 rx_mic[8]; 481 482 int wcid; 483}; 484 485/* 486 * Configuration structure wrapper around the 487 * rt2x00 interface configuration handler. 488 */ 489struct rt2x00intf_conf { 490 /* 491 * Interface type 492 */ 493 enum nl80211_iftype type; 494 495 /* 496 * TSF sync value, this is dependent on the operation type. 497 */ 498 enum tsf_sync sync; 499 500 /* 501 * The MAC and BSSID addresses are simple array of bytes, 502 * these arrays are little endian, so when sending the addresses 503 * to the drivers, copy the it into a endian-signed variable. 504 * 505 * Note that all devices (except rt2500usb) have 32 bits 506 * register word sizes. This means that whatever variable we 507 * pass _must_ be a multiple of 32 bits. Otherwise the device 508 * might not accept what we are sending to it. 509 * This will also make it easier for the driver to write 510 * the data to the device. 511 */ 512 __le32 mac[2]; 513 __le32 bssid[2]; 514}; 515 516/* 517 * Private structure for storing STA details 518 * wcid: Wireless Client ID 519 */ 520struct rt2x00_sta { 521 int wcid; 522}; 523 524static inline struct rt2x00_sta* sta_to_rt2x00_sta(struct ieee80211_sta *sta) 525{ 526 return (struct rt2x00_sta *)sta->drv_priv; 527} 528 529/* 530 * rt2x00lib callback functions. 531 */ 532struct rt2x00lib_ops { 533 /* 534 * Interrupt handlers. 535 */ 536 irq_handler_t irq_handler; 537 538 /* 539 * TX status tasklet handler. 540 */ 541 void (*txstatus_tasklet) (unsigned long data); 542 void (*pretbtt_tasklet) (unsigned long data); 543 void (*tbtt_tasklet) (unsigned long data); 544 void (*rxdone_tasklet) (unsigned long data); 545 void (*autowake_tasklet) (unsigned long data); 546 547 /* 548 * Device init handlers. 549 */ 550 int (*probe_hw) (struct rt2x00_dev *rt2x00dev); 551 char *(*get_firmware_name) (struct rt2x00_dev *rt2x00dev); 552 int (*check_firmware) (struct rt2x00_dev *rt2x00dev, 553 const u8 *data, const size_t len); 554 int (*load_firmware) (struct rt2x00_dev *rt2x00dev, 555 const u8 *data, const size_t len); 556 557 /* 558 * Device initialization/deinitialization handlers. 559 */ 560 int (*initialize) (struct rt2x00_dev *rt2x00dev); 561 void (*uninitialize) (struct rt2x00_dev *rt2x00dev); 562 563 /* 564 * queue initialization handlers 565 */ 566 bool (*get_entry_state) (struct queue_entry *entry); 567 void (*clear_entry) (struct queue_entry *entry); 568 569 /* 570 * Radio control handlers. 571 */ 572 int (*set_device_state) (struct rt2x00_dev *rt2x00dev, 573 enum dev_state state); 574 int (*rfkill_poll) (struct rt2x00_dev *rt2x00dev); 575 void (*link_stats) (struct rt2x00_dev *rt2x00dev, 576 struct link_qual *qual); 577 void (*reset_tuner) (struct rt2x00_dev *rt2x00dev, 578 struct link_qual *qual); 579 void (*link_tuner) (struct rt2x00_dev *rt2x00dev, 580 struct link_qual *qual, const u32 count); 581 void (*gain_calibration) (struct rt2x00_dev *rt2x00dev); 582 583 /* 584 * Data queue handlers. 585 */ 586 void (*watchdog) (struct rt2x00_dev *rt2x00dev); 587 void (*start_queue) (struct data_queue *queue); 588 void (*kick_queue) (struct data_queue *queue); 589 void (*stop_queue) (struct data_queue *queue); 590 void (*flush_queue) (struct data_queue *queue, bool drop); 591 void (*tx_dma_done) (struct queue_entry *entry); 592 593 /* 594 * TX control handlers 595 */ 596 void (*write_tx_desc) (struct queue_entry *entry, 597 struct txentry_desc *txdesc); 598 void (*write_tx_data) (struct queue_entry *entry, 599 struct txentry_desc *txdesc); 600 void (*write_beacon) (struct queue_entry *entry, 601 struct txentry_desc *txdesc); 602 void (*clear_beacon) (struct queue_entry *entry); 603 int (*get_tx_data_len) (struct queue_entry *entry); 604 605 /* 606 * RX control handlers 607 */ 608 void (*fill_rxdone) (struct queue_entry *entry, 609 struct rxdone_entry_desc *rxdesc); 610 611 /* 612 * Configuration handlers. 613 */ 614 int (*config_shared_key) (struct rt2x00_dev *rt2x00dev, 615 struct rt2x00lib_crypto *crypto, 616 struct ieee80211_key_conf *key); 617 int (*config_pairwise_key) (struct rt2x00_dev *rt2x00dev, 618 struct rt2x00lib_crypto *crypto, 619 struct ieee80211_key_conf *key); 620 void (*config_filter) (struct rt2x00_dev *rt2x00dev, 621 const unsigned int filter_flags); 622 void (*config_intf) (struct rt2x00_dev *rt2x00dev, 623 struct rt2x00_intf *intf, 624 struct rt2x00intf_conf *conf, 625 const unsigned int flags); 626#define CONFIG_UPDATE_TYPE ( 1 << 1 ) 627#define CONFIG_UPDATE_MAC ( 1 << 2 ) 628#define CONFIG_UPDATE_BSSID ( 1 << 3 ) 629 630 void (*config_erp) (struct rt2x00_dev *rt2x00dev, 631 struct rt2x00lib_erp *erp, 632 u32 changed); 633 void (*config_ant) (struct rt2x00_dev *rt2x00dev, 634 struct antenna_setup *ant); 635 void (*config) (struct rt2x00_dev *rt2x00dev, 636 struct rt2x00lib_conf *libconf, 637 const unsigned int changed_flags); 638 int (*sta_add) (struct rt2x00_dev *rt2x00dev, 639 struct ieee80211_vif *vif, 640 struct ieee80211_sta *sta); 641 int (*sta_remove) (struct rt2x00_dev *rt2x00dev, 642 int wcid); 643}; 644 645/* 646 * rt2x00 driver callback operation structure. 647 */ 648struct rt2x00_ops { 649 const char *name; 650 const unsigned int drv_data_size; 651 const unsigned int max_sta_intf; 652 const unsigned int max_ap_intf; 653 const unsigned int eeprom_size; 654 const unsigned int rf_size; 655 const unsigned int tx_queues; 656 const unsigned int extra_tx_headroom; 657 const struct data_queue_desc *rx; 658 const struct data_queue_desc *tx; 659 const struct data_queue_desc *bcn; 660 const struct data_queue_desc *atim; 661 const struct rt2x00lib_ops *lib; 662 const void *drv; 663 const struct ieee80211_ops *hw; 664#ifdef CONFIG_RT2X00_LIB_DEBUGFS 665 const struct rt2x00debug *debugfs; 666#endif /* CONFIG_RT2X00_LIB_DEBUGFS */ 667}; 668 669/* 670 * rt2x00 state flags 671 */ 672enum rt2x00_state_flags { 673 /* 674 * Device flags 675 */ 676 DEVICE_STATE_PRESENT, 677 DEVICE_STATE_REGISTERED_HW, 678 DEVICE_STATE_INITIALIZED, 679 DEVICE_STATE_STARTED, 680 DEVICE_STATE_ENABLED_RADIO, 681 DEVICE_STATE_SCANNING, 682 683 /* 684 * Driver configuration 685 */ 686 CONFIG_CHANNEL_HT40, 687 CONFIG_POWERSAVING, 688}; 689 690/* 691 * rt2x00 capability flags 692 */ 693enum rt2x00_capability_flags { 694 /* 695 * Requirements 696 */ 697 REQUIRE_FIRMWARE, 698 REQUIRE_BEACON_GUARD, 699 REQUIRE_ATIM_QUEUE, 700 REQUIRE_DMA, 701 REQUIRE_COPY_IV, 702 REQUIRE_L2PAD, 703 REQUIRE_TXSTATUS_FIFO, 704 REQUIRE_TASKLET_CONTEXT, 705 REQUIRE_SW_SEQNO, 706 REQUIRE_HT_TX_DESC, 707 REQUIRE_PS_AUTOWAKE, 708 709 /* 710 * Capabilities 711 */ 712 CAPABILITY_HW_BUTTON, 713 CAPABILITY_HW_CRYPTO, 714 CAPABILITY_POWER_LIMIT, 715 CAPABILITY_CONTROL_FILTERS, 716 CAPABILITY_CONTROL_FILTER_PSPOLL, 717 CAPABILITY_PRE_TBTT_INTERRUPT, 718 CAPABILITY_LINK_TUNING, 719 CAPABILITY_FRAME_TYPE, 720 CAPABILITY_RF_SEQUENCE, 721 CAPABILITY_EXTERNAL_LNA_A, 722 CAPABILITY_EXTERNAL_LNA_BG, 723 CAPABILITY_DOUBLE_ANTENNA, 724 CAPABILITY_BT_COEXIST, 725}; 726 727/* 728 * rt2x00 device structure. 729 */ 730struct rt2x00_dev { 731 /* 732 * Device structure. 733 * The structure stored in here depends on the 734 * system bus (PCI or USB). 735 * When accessing this variable, the rt2x00dev_{pci,usb} 736 * macros should be used for correct typecasting. 737 */ 738 struct device *dev; 739 740 /* 741 * Callback functions. 742 */ 743 const struct rt2x00_ops *ops; 744 745 /* 746 * Driver data. 747 */ 748 void *drv_data; 749 750 /* 751 * IEEE80211 control structure. 752 */ 753 struct ieee80211_hw *hw; 754 struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS]; 755 enum ieee80211_band curr_band; 756 int curr_freq; 757 758 /* 759 * If enabled, the debugfs interface structures 760 * required for deregistration of debugfs. 761 */ 762#ifdef CONFIG_RT2X00_LIB_DEBUGFS 763 struct rt2x00debug_intf *debugfs_intf; 764#endif /* CONFIG_RT2X00_LIB_DEBUGFS */ 765 766 /* 767 * LED structure for changing the LED status 768 * by mac8011 or the kernel. 769 */ 770#ifdef CONFIG_RT2X00_LIB_LEDS 771 struct rt2x00_led led_radio; 772 struct rt2x00_led led_assoc; 773 struct rt2x00_led led_qual; 774 u16 led_mcu_reg; 775#endif /* CONFIG_RT2X00_LIB_LEDS */ 776 777 /* 778 * Device state flags. 779 * In these flags the current status is stored. 780 * Access to these flags should occur atomically. 781 */ 782 unsigned long flags; 783 784 /* 785 * Device capabiltiy flags. 786 * In these flags the device/driver capabilities are stored. 787 * Access to these flags should occur non-atomically. 788 */ 789 unsigned long cap_flags; 790 791 /* 792 * Device information, Bus IRQ and name (PCI, SoC) 793 */ 794 int irq; 795 const char *name; 796 797 /* 798 * Chipset identification. 799 */ 800 struct rt2x00_chip chip; 801 802 /* 803 * hw capability specifications. 804 */ 805 struct hw_mode_spec spec; 806 807 /* 808 * This is the default TX/RX antenna setup as indicated 809 * by the device's EEPROM. 810 */ 811 struct antenna_setup default_ant; 812 813 /* 814 * Register pointers 815 * csr.base: CSR base register address. (PCI) 816 * csr.cache: CSR cache for usb_control_msg. (USB) 817 */ 818 union csr { 819 void __iomem *base; 820 void *cache; 821 } csr; 822 823 /* 824 * Mutex to protect register accesses. 825 * For PCI and USB devices it protects against concurrent indirect 826 * register access (BBP, RF, MCU) since accessing those 827 * registers require multiple calls to the CSR registers. 828 * For USB devices it also protects the csr_cache since that 829 * field is used for normal CSR access and it cannot support 830 * multiple callers simultaneously. 831 */ 832 struct mutex csr_mutex; 833 834 /* 835 * Current packet filter configuration for the device. 836 * This contains all currently active FIF_* flags send 837 * to us by mac80211 during configure_filter(). 838 */ 839 unsigned int packet_filter; 840 841 /* 842 * Interface details: 843 * - Open ap interface count. 844 * - Open sta interface count. 845 * - Association count. 846 * - Beaconing enabled count. 847 */ 848 unsigned int intf_ap_count; 849 unsigned int intf_sta_count; 850 unsigned int intf_associated; 851 unsigned int intf_beaconing; 852 853 /* 854 * Link quality 855 */ 856 struct link link; 857 858 /* 859 * EEPROM data. 860 */ 861 __le16 *eeprom; 862 863 /* 864 * Active RF register values. 865 * These are stored here so we don't need 866 * to read the rf registers and can directly 867 * use this value instead. 868 * This field should be accessed by using 869 * rt2x00_rf_read() and rt2x00_rf_write(). 870 */ 871 u32 *rf; 872 873 /* 874 * LNA gain 875 */ 876 short lna_gain; 877 878 /* 879 * Current TX power value. 880 */ 881 u16 tx_power; 882 883 /* 884 * Current retry values. 885 */ 886 u8 short_retry; 887 u8 long_retry; 888 889 /* 890 * Rssi <-> Dbm offset 891 */ 892 u8 rssi_offset; 893 894 /* 895 * Frequency offset (for rt61pci & rt73usb). 896 */ 897 u8 freq_offset; 898 899 /* 900 * Calibration information (for rt2800usb & rt2800pci). 901 * [0] -> BW20 902 * [1] -> BW40 903 */ 904 u8 calibration[2]; 905 906 /* 907 * Association id. 908 */ 909 u16 aid; 910 911 /* 912 * Beacon interval. 913 */ 914 u16 beacon_int; 915 916 /** 917 * Timestamp of last received beacon 918 */ 919 unsigned long last_beacon; 920 921 /* 922 * Low level statistics which will have 923 * to be kept up to date while device is running. 924 */ 925 struct ieee80211_low_level_stats low_level_stats; 926 927 /** 928 * Work queue for all work which should not be placed 929 * on the mac80211 workqueue (because of dependencies 930 * between various work structures). 931 */ 932 struct workqueue_struct *workqueue; 933 934 /* 935 * Scheduled work. 936 * NOTE: intf_work will use ieee80211_iterate_active_interfaces() 937 * which means it cannot be placed on the hw->workqueue 938 * due to RTNL locking requirements. 939 */ 940 struct work_struct intf_work; 941 942 /** 943 * Scheduled work for TX/RX done handling (USB devices) 944 */ 945 struct work_struct rxdone_work; 946 struct work_struct txdone_work; 947 948 /* 949 * Powersaving work 950 */ 951 struct delayed_work autowakeup_work; 952 struct work_struct sleep_work; 953 954 /* 955 * Data queue arrays for RX, TX, Beacon and ATIM. 956 */ 957 unsigned int data_queues; 958 struct data_queue *rx; 959 struct data_queue *tx; 960 struct data_queue *bcn; 961 struct data_queue *atim; 962 963 /* 964 * Firmware image. 965 */ 966 const struct firmware *fw; 967 968 /* 969 * FIFO for storing tx status reports between isr and tasklet. 970 */ 971 DECLARE_KFIFO_PTR(txstatus_fifo, u32); 972 973 /* 974 * Timer to ensure tx status reports are read (rt2800usb). 975 */ 976 struct timer_list txstatus_timer; 977 978 /* 979 * Tasklet for processing tx status reports (rt2800pci). 980 */ 981 struct tasklet_struct txstatus_tasklet; 982 struct tasklet_struct pretbtt_tasklet; 983 struct tasklet_struct tbtt_tasklet; 984 struct tasklet_struct rxdone_tasklet; 985 struct tasklet_struct autowake_tasklet; 986 987 /* 988 * Protect the interrupt mask register. 989 */ 990 spinlock_t irqmask_lock; 991}; 992 993/* 994 * Register defines. 995 * Some registers require multiple attempts before success, 996 * in those cases REGISTER_BUSY_COUNT attempts should be 997 * taken with a REGISTER_BUSY_DELAY interval. 998 */ 999#define REGISTER_BUSY_COUNT 100 1000#define REGISTER_BUSY_DELAY 100 1001 1002/* 1003 * Generic RF access. 1004 * The RF is being accessed by word index. 1005 */ 1006static inline void rt2x00_rf_read(struct rt2x00_dev *rt2x00dev, 1007 const unsigned int word, u32 *data) 1008{ 1009 BUG_ON(word < 1 || word > rt2x00dev->ops->rf_size / sizeof(u32)); 1010 *data = rt2x00dev->rf[word - 1]; 1011} 1012 1013static inline void rt2x00_rf_write(struct rt2x00_dev *rt2x00dev, 1014 const unsigned int word, u32 data) 1015{ 1016 BUG_ON(word < 1 || word > rt2x00dev->ops->rf_size / sizeof(u32)); 1017 rt2x00dev->rf[word - 1] = data; 1018} 1019 1020/* 1021 * Generic EEPROM access. 1022 * The EEPROM is being accessed by word index. 1023 */ 1024static inline void *rt2x00_eeprom_addr(struct rt2x00_dev *rt2x00dev, 1025 const unsigned int word) 1026{ 1027 return (void *)&rt2x00dev->eeprom[word]; 1028} 1029 1030static inline void rt2x00_eeprom_read(struct rt2x00_dev *rt2x00dev, 1031 const unsigned int word, u16 *data) 1032{ 1033 *data = le16_to_cpu(rt2x00dev->eeprom[word]); 1034} 1035 1036static inline void rt2x00_eeprom_write(struct rt2x00_dev *rt2x00dev, 1037 const unsigned int word, u16 data) 1038{ 1039 rt2x00dev->eeprom[word] = cpu_to_le16(data); 1040} 1041 1042/* 1043 * Chipset handlers 1044 */ 1045static inline void rt2x00_set_chip(struct rt2x00_dev *rt2x00dev, 1046 const u16 rt, const u16 rf, const u16 rev) 1047{ 1048 rt2x00dev->chip.rt = rt; 1049 rt2x00dev->chip.rf = rf; 1050 rt2x00dev->chip.rev = rev; 1051 1052 INFO(rt2x00dev, 1053 "Chipset detected - rt: %04x, rf: %04x, rev: %04x.\n", 1054 rt2x00dev->chip.rt, rt2x00dev->chip.rf, rt2x00dev->chip.rev); 1055} 1056 1057static inline bool rt2x00_rt(struct rt2x00_dev *rt2x00dev, const u16 rt) 1058{ 1059 return (rt2x00dev->chip.rt == rt); 1060} 1061 1062static inline bool rt2x00_rf(struct rt2x00_dev *rt2x00dev, const u16 rf) 1063{ 1064 return (rt2x00dev->chip.rf == rf); 1065} 1066 1067static inline u16 rt2x00_rev(struct rt2x00_dev *rt2x00dev) 1068{ 1069 return rt2x00dev->chip.rev; 1070} 1071 1072static inline bool rt2x00_rt_rev(struct rt2x00_dev *rt2x00dev, 1073 const u16 rt, const u16 rev) 1074{ 1075 return (rt2x00_rt(rt2x00dev, rt) && rt2x00_rev(rt2x00dev) == rev); 1076} 1077 1078static inline bool rt2x00_rt_rev_lt(struct rt2x00_dev *rt2x00dev, 1079 const u16 rt, const u16 rev) 1080{ 1081 return (rt2x00_rt(rt2x00dev, rt) && rt2x00_rev(rt2x00dev) < rev); 1082} 1083 1084static inline bool rt2x00_rt_rev_gte(struct rt2x00_dev *rt2x00dev, 1085 const u16 rt, const u16 rev) 1086{ 1087 return (rt2x00_rt(rt2x00dev, rt) && rt2x00_rev(rt2x00dev) >= rev); 1088} 1089 1090static inline void rt2x00_set_chip_intf(struct rt2x00_dev *rt2x00dev, 1091 enum rt2x00_chip_intf intf) 1092{ 1093 rt2x00dev->chip.intf = intf; 1094} 1095 1096static inline bool rt2x00_intf(struct rt2x00_dev *rt2x00dev, 1097 enum rt2x00_chip_intf intf) 1098{ 1099 return (rt2x00dev->chip.intf == intf); 1100} 1101 1102static inline bool rt2x00_is_pci(struct rt2x00_dev *rt2x00dev) 1103{ 1104 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_PCI) || 1105 rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_PCIE); 1106} 1107 1108static inline bool rt2x00_is_pcie(struct rt2x00_dev *rt2x00dev) 1109{ 1110 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_PCIE); 1111} 1112 1113static inline bool rt2x00_is_usb(struct rt2x00_dev *rt2x00dev) 1114{ 1115 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_USB); 1116} 1117 1118static inline bool rt2x00_is_soc(struct rt2x00_dev *rt2x00dev) 1119{ 1120 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_SOC); 1121} 1122 1123/** 1124 * rt2x00queue_map_txskb - Map a skb into DMA for TX purposes. 1125 * @entry: Pointer to &struct queue_entry 1126 */ 1127void rt2x00queue_map_txskb(struct queue_entry *entry); 1128 1129/** 1130 * rt2x00queue_unmap_skb - Unmap a skb from DMA. 1131 * @entry: Pointer to &struct queue_entry 1132 */ 1133void rt2x00queue_unmap_skb(struct queue_entry *entry); 1134 1135/** 1136 * rt2x00queue_get_tx_queue - Convert tx queue index to queue pointer 1137 * @rt2x00dev: Pointer to &struct rt2x00_dev. 1138 * @queue: rt2x00 queue index (see &enum data_queue_qid). 1139 * 1140 * Returns NULL for non tx queues. 1141 */ 1142static inline struct data_queue * 1143rt2x00queue_get_tx_queue(struct rt2x00_dev *rt2x00dev, 1144 const enum data_queue_qid queue) 1145{ 1146 if (queue < rt2x00dev->ops->tx_queues && rt2x00dev->tx) 1147 return &rt2x00dev->tx[queue]; 1148 1149 if (queue == QID_ATIM) 1150 return rt2x00dev->atim; 1151 1152 return NULL; 1153} 1154 1155/** 1156 * rt2x00queue_get_entry - Get queue entry where the given index points to. 1157 * @queue: Pointer to &struct data_queue from where we obtain the entry. 1158 * @index: Index identifier for obtaining the correct index. 1159 */ 1160struct queue_entry *rt2x00queue_get_entry(struct data_queue *queue, 1161 enum queue_index index); 1162 1163/** 1164 * rt2x00queue_pause_queue - Pause a data queue 1165 * @queue: Pointer to &struct data_queue. 1166 * 1167 * This function will pause the data queue locally, preventing 1168 * new frames to be added to the queue (while the hardware is 1169 * still allowed to run). 1170 */ 1171void rt2x00queue_pause_queue(struct data_queue *queue); 1172 1173/** 1174 * rt2x00queue_unpause_queue - unpause a data queue 1175 * @queue: Pointer to &struct data_queue. 1176 * 1177 * This function will unpause the data queue locally, allowing 1178 * new frames to be added to the queue again. 1179 */ 1180void rt2x00queue_unpause_queue(struct data_queue *queue); 1181 1182/** 1183 * rt2x00queue_start_queue - Start a data queue 1184 * @queue: Pointer to &struct data_queue. 1185 * 1186 * This function will start handling all pending frames in the queue. 1187 */ 1188void rt2x00queue_start_queue(struct data_queue *queue); 1189 1190/** 1191 * rt2x00queue_stop_queue - Halt a data queue 1192 * @queue: Pointer to &struct data_queue. 1193 * 1194 * This function will stop all pending frames in the queue. 1195 */ 1196void rt2x00queue_stop_queue(struct data_queue *queue); 1197 1198/** 1199 * rt2x00queue_flush_queue - Flush a data queue 1200 * @queue: Pointer to &struct data_queue. 1201 * @drop: True to drop all pending frames. 1202 * 1203 * This function will flush the queue. After this call 1204 * the queue is guaranteed to be empty. 1205 */ 1206void rt2x00queue_flush_queue(struct data_queue *queue, bool drop); 1207 1208/** 1209 * rt2x00queue_start_queues - Start all data queues 1210 * @rt2x00dev: Pointer to &struct rt2x00_dev. 1211 * 1212 * This function will loop through all available queues to start them 1213 */ 1214void rt2x00queue_start_queues(struct rt2x00_dev *rt2x00dev); 1215 1216/** 1217 * rt2x00queue_stop_queues - Halt all data queues 1218 * @rt2x00dev: Pointer to &struct rt2x00_dev. 1219 * 1220 * This function will loop through all available queues to stop 1221 * any pending frames. 1222 */ 1223void rt2x00queue_stop_queues(struct rt2x00_dev *rt2x00dev); 1224 1225/** 1226 * rt2x00queue_flush_queues - Flush all data queues 1227 * @rt2x00dev: Pointer to &struct rt2x00_dev. 1228 * @drop: True to drop all pending frames. 1229 * 1230 * This function will loop through all available queues to flush 1231 * any pending frames. 1232 */ 1233void rt2x00queue_flush_queues(struct rt2x00_dev *rt2x00dev, bool drop); 1234 1235/* 1236 * Debugfs handlers. 1237 */ 1238/** 1239 * rt2x00debug_dump_frame - Dump a frame to userspace through debugfs. 1240 * @rt2x00dev: Pointer to &struct rt2x00_dev. 1241 * @type: The type of frame that is being dumped. 1242 * @skb: The skb containing the frame to be dumped. 1243 */ 1244#ifdef CONFIG_RT2X00_LIB_DEBUGFS 1245void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev, 1246 enum rt2x00_dump_type type, struct sk_buff *skb); 1247#else 1248static inline void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev, 1249 enum rt2x00_dump_type type, 1250 struct sk_buff *skb) 1251{ 1252} 1253#endif /* CONFIG_RT2X00_LIB_DEBUGFS */ 1254 1255/* 1256 * Utility functions. 1257 */ 1258u32 rt2x00lib_get_bssidx(struct rt2x00_dev *rt2x00dev, 1259 struct ieee80211_vif *vif); 1260 1261/* 1262 * Interrupt context handlers. 1263 */ 1264void rt2x00lib_beacondone(struct rt2x00_dev *rt2x00dev); 1265void rt2x00lib_pretbtt(struct rt2x00_dev *rt2x00dev); 1266void rt2x00lib_dmastart(struct queue_entry *entry); 1267void rt2x00lib_dmadone(struct queue_entry *entry); 1268void rt2x00lib_txdone(struct queue_entry *entry, 1269 struct txdone_entry_desc *txdesc); 1270void rt2x00lib_txdone_noinfo(struct queue_entry *entry, u32 status); 1271void rt2x00lib_rxdone(struct queue_entry *entry); 1272 1273/* 1274 * mac80211 handlers. 1275 */ 1276void rt2x00mac_tx(struct ieee80211_hw *hw, struct sk_buff *skb); 1277int rt2x00mac_start(struct ieee80211_hw *hw); 1278void rt2x00mac_stop(struct ieee80211_hw *hw); 1279int rt2x00mac_add_interface(struct ieee80211_hw *hw, 1280 struct ieee80211_vif *vif); 1281void rt2x00mac_remove_interface(struct ieee80211_hw *hw, 1282 struct ieee80211_vif *vif); 1283int rt2x00mac_config(struct ieee80211_hw *hw, u32 changed); 1284void rt2x00mac_configure_filter(struct ieee80211_hw *hw, 1285 unsigned int changed_flags, 1286 unsigned int *total_flags, 1287 u64 multicast); 1288int rt2x00mac_set_tim(struct ieee80211_hw *hw, struct ieee80211_sta *sta, 1289 bool set); 1290#ifdef CONFIG_RT2X00_LIB_CRYPTO 1291int rt2x00mac_set_key(struct ieee80211_hw *hw, enum set_key_cmd cmd, 1292 struct ieee80211_vif *vif, struct ieee80211_sta *sta, 1293 struct ieee80211_key_conf *key); 1294#else 1295#define rt2x00mac_set_key NULL 1296#endif /* CONFIG_RT2X00_LIB_CRYPTO */ 1297int rt2x00mac_sta_add(struct ieee80211_hw *hw, struct ieee80211_vif *vif, 1298 struct ieee80211_sta *sta); 1299int rt2x00mac_sta_remove(struct ieee80211_hw *hw, struct ieee80211_vif *vif, 1300 struct ieee80211_sta *sta); 1301void rt2x00mac_sw_scan_start(struct ieee80211_hw *hw); 1302void rt2x00mac_sw_scan_complete(struct ieee80211_hw *hw); 1303int rt2x00mac_get_stats(struct ieee80211_hw *hw, 1304 struct ieee80211_low_level_stats *stats); 1305void rt2x00mac_bss_info_changed(struct ieee80211_hw *hw, 1306 struct ieee80211_vif *vif, 1307 struct ieee80211_bss_conf *bss_conf, 1308 u32 changes); 1309int rt2x00mac_conf_tx(struct ieee80211_hw *hw, 1310 struct ieee80211_vif *vif, u16 queue, 1311 const struct ieee80211_tx_queue_params *params); 1312void rt2x00mac_rfkill_poll(struct ieee80211_hw *hw); 1313void rt2x00mac_flush(struct ieee80211_hw *hw, bool drop); 1314int rt2x00mac_set_antenna(struct ieee80211_hw *hw, u32 tx_ant, u32 rx_ant); 1315int rt2x00mac_get_antenna(struct ieee80211_hw *hw, u32 *tx_ant, u32 *rx_ant); 1316void rt2x00mac_get_ringparam(struct ieee80211_hw *hw, 1317 u32 *tx, u32 *tx_max, u32 *rx, u32 *rx_max); 1318bool rt2x00mac_tx_frames_pending(struct ieee80211_hw *hw); 1319 1320/* 1321 * Driver allocation handlers. 1322 */ 1323int rt2x00lib_probe_dev(struct rt2x00_dev *rt2x00dev); 1324void rt2x00lib_remove_dev(struct rt2x00_dev *rt2x00dev); 1325#ifdef CONFIG_PM 1326int rt2x00lib_suspend(struct rt2x00_dev *rt2x00dev, pm_message_t state); 1327int rt2x00lib_resume(struct rt2x00_dev *rt2x00dev); 1328#endif /* CONFIG_PM */ 1329 1330#endif /* RT2X00_H */ 1331