Changes between Version 12 and Version 13 of About/MadWifi

Author:
mrenzmann (IP: 194.45.26.221)
Timestamp:
09/20/07 16:18:17 (9 months ago)
Comment:

Adjusted for new website layout.

Legend:

Unmodified
Added
Removed
Modified

  • About/MadWifi

    v12 v13  
    1   = General Information = 
    2            
    3   MadWifi is short for ''Multiband Atheros Driver for Wireless Fidelity''. In other words: this project provides a Linux kernel device driver for Atheros-based Wireless LAN devices. The driver works such that your WLAN card will appear as a normal network interface in the system. Additionally there is support for the Wireless Extensions API. This allows you to configure the device using common wireless tools (ifconfig, iwconfig and friends). 
    4            
    5   Some of the driver's key [wiki:Deprecated/ngFeatures features] are: 
    6            
    7    * Operational Modes:   
    8     * sta     -- Station, a.k.a. infrastructure or managed.  This device acting as typical WLAN client station.  This is the default mode if not otherwise specified. 
    9     * ap      -- Access Point, a.k.a. master.  This device acts as the Access Point for other WLAN client stations. 
    10     * adhoc   -- Ad-hoc. a.k.a. IBSS mode.  This device is in a peer-to-peer(s) WLAN without the need for an Access Point. 
    11     * ahdemo  -- Ad-hoc Demo.  This is an older, non-802.11 compliant, proprietary ad-hoc mode.   
    12     * monitor -- Monitor.  This device can be used to "sniff" raw 802.11 frames. 
    13     * wds     -- Wireless Distribution System.  This device can be used to create large wireless networks by linking several Access Points together. 
    14    * WDS support for transparent bridging over WLAN links. 
    15    * Supports Wireless Extensions API. 
    16    * One driver for miniPCI and cardbus devices. USB devices are not yet supported. 
    17    * Most of the current Atheros WLAN chipsets are supported. 
    18    * Supports WEP and WPA/802.11i. 
    19    * Support for 802.1x authentication in AP mode. 
    20            
    21   == Requirements == 
    22            
    23    * Linux Kernel 2.4.23+ and 2.6.x series (Others may work, but are unsupported) 
    24    * Crypto AP support in kernel (option CONFIG_CRYPTO) 
    25    * Sysctl support in kernel (option CONFIG_SYSCTL) 
    26    * Wireless Extensions support in kernel (v14+ required, v17+ recommended; option CONFIG_NET_RADIO) 
    27    * Same GCC version used to compile the kernel (otherwise, "Invalid module format" errors may occur) 
    28           
    29   == How can I get it? == 
    30            
    31   A detailed description of how and where to get MadWifi is available on the [wiki:UserDocs/GettingMadwifi GettingMadwifi] page. If not done yet, be sure to check that your system meets all requirements as described in the previous section. 
    32            
    33   == Where can I get help? == 
    34            
    35   The [wiki:Support] section gives detailed information on the various ways to get help in case you get stuck with MadWifi. 
    36            
    37    == How to submit bug reports / patches / feature requests  == 
    38            
    39   We have a [http://madwifi.org/report ticket system] that is used to keep track on any reported bugs, patches or feature requests. The TracTickets page will tell you how to use it. 
    40            
    41   If you plan to submit a patch you should also have a look on our [wiki:DevDocs/PreparePatches guide] - it has important information for you. 
    42            
    43   == How to contribute == 
    44            
    45   As any other open source project we're glad about any help we can get. Read more about how you can contribute [wiki:Contribute here]. 
      1 [[PageOutline(2-5)]] 
      2  
      3 = !MadWifi = 
      4  
      5 !MadWifi is short for ''Multiband Atheros Driver for Wireless Fidelity''. In other words: it is a Linux kernel device driver for Atheros-based Wireless LAN devices. The driver works such that your WLAN card will appear as a normal network interface in the system. Additionally there is support for the [http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html#wext Wireless Extensions] API. This allows you to configure most aspects of the device using common wireless tools (ifconfig, iwconfig and friends). 
      6  
      7 == License == 
      8  
      9 This driver is provided under a [source:trunk/COPYRIGHT dual license], three-clause BSD and GPL v2. The binary HAL, however, is distributed under a [source:trunk/hal/COPYRIGHT proprietary license] and as closed-source only and thus will taint the kernel. 
      10  
      11 == Features == 
      12  
      13 !MadWifi is one of the most advanced drivers for WLAN devices on for Linux today, with a wide set of features. 
      14  
      15 === Hardware === 
      16  
      17 !MadWifi supports PCI, MiniPCI and Cardbus devices, USB devices are not yet supported. 
      18  
      19 Almost all of the currently available [wiki:Chipsets Atheros WLAN chipsets] are supported, including the "System on Chip" designs. The [wiki:Compatibility compatibility list] provides information about devices that users reported (mis)success for. 
      20  
      21 === Operational Modes === 
      22  
      23 The following operational modes are supported: 
      24  
      25  sta:: 
      26    Station, a.k.a. infrastructure or managed.  This device acting as typical WLAN client station.  This is the default mode if not otherwise specified. 
      27  
      28  ap:: 
      29    Access Point, a.k.a. master.  This device acts as the Access Point for other WLAN client stations. 
      30  
      31  adhoc:: 
      32    Ad-hoc. a.k.a. IBSS mode.  This device is in a peer-to-peer(s) WLAN without the need for an Access Point. 
      33  
      34  ahdemo:: 
      35    Ad-hoc Demo. This is an older, non-802.11 compliant, proprietary ad-hoc mode.   
      36  
      37  monitor:: 
      38    Monitor.  This device can be used to "sniff" raw 802.11 frames. 
      39  
      40  wds:: 
      41    Wireless Distribution System.  This device can be used to create large wireless networks by linking several Access Points together. 
      42  
      43 === Encryption === 
      44  
      45  WEP:: 
      46    Wired Equivalent Privacy, with 40/64 bit and 104/128 bit keys; supported in modes: sta, ap, adhoc 
      47  
      48  WPA:: 
      49    !WiFi Protected Access; supported in modes: sta (through [http://hostap.epitest.fi/wpa_supplicant/ wpa_supplicant]), ap (through [http://hostap.epitest.fi/hostapd/ hostapd]) 
      50  
      51  WPA2/IEEE 802.11i:: 
      52    !WiFi Protected Access 2; supported in modes: sta (through [http://hostap.epitest.fi/wpa_supplicant/ wpa_supplicant]), ap (through [http://hostap.epitest.fi/hostapd/ hostapd]) 
      53  
      54  IEEE 802.1X:: 
      55    Port-based Network Access Control; supported in modes: ap 
      56  
      57 === Multi-BSSID === 
      58  
      59 !MadWifi allows to run several virtual Access Points on a single card, by introducing the so called [wiki:VAP Virtual Access Points] (VAP). VAPs sit on top of a base device (usually called ''wifi0''), representing virtual WLAN devices that (despite their name) can be used in different other modes. That way a single WLAN card can connect to an Access Point while at the same time acting as Access Point for other stations. Other combinations of operational modes are possible as well. 
      60  
      61 To manipulate VAPs, !MadWifi comes with a tool called ''wlanconfig'' which is used to create and destroy VAPS with various different modes.  
      62  
      63 === Super A/G === 
      64  
      65 Atheros has introduced a set of (proprietary) features that have been designed to increase throughput and achievable distance, including frame aggregation, jumbo frames, on-the-fly data compression and channel bonding. Please refer to [wiki:ChipsetFeatures/SuperAG this page] for details. 
      66  
      67 !MadWifi supports almost all these extensions to the standard. 
      68  
      69 === ... and more === 
      70  
      71 Some other interesting features are: 
      72  
      73  4-address header support:: 
      74    Support for transparent bridging of ethernet segments; [wiki:ChipsetFeatures/4AddressHeaders read more] 
      75  
      76  Seamless Roaming:: 
      77    Switch seamlessly to another Access Point if the current link gets weak; [wiki:ChipsetFeatures/Roaming read more] 
      78   
      79  Wi-Fi Multimedia:: 
      80    Quality of Service extensions for WLAN (IEEE 802.11e); [wiki:ChipsetFeatures/WMM read more] 
      81  
      82  Transmit Power Control (TPC):: 
      83    Automatic adjustment of transmit power (IEEE 802.11h); [wiki:ChipsetFeatures/TPC read more] 
      84  
      85  Dynamic Frequency Selection (DFS):: 
      86    Automatically avoids channels that are used by radar and similar applications (IEEE 802.11h); [wiki:ChipsetFeatures/DFS read more] 
      87  
      88  Background Scanning:: 
      89    Scanning other channels without loosing data; [wiki:ChipsetFeatures/BackgroundScanning read more] 
      90  
      91 == Status == 
      92  
      93 !MadWifi has been declared legacy, in response to our commitment to [wiki:About/ath5k ath5k]. In the long run ath5k will replace !MadWifi. For the time being !MadWifi will still be supported, bugs will get fixed and HAL updates will be applied where possible. But it becomes unlikely that we'll see new features or go through major changes on that codebase. 
      94  
      95 The driver is mature and stable, though, and works well for most users. For now you should choose !MadWifi if you depend on solid WLAN support. But we also encourage all interested users to give ath5k a try.