## Host AP driver for Intersil Prism2/2.5/3, hostapd, and WPA Supplicant

### Introduction

This project includes three main components:

- Host AP - Linux driver for Prism2/2.5/3
- hostapd - user space daemon for access points, including, e.g., IEEE 802.1X/WPA/EAP Authenticator for number of Linux and BSD drivers, RADIUS client, integrated EAP server, and RADIUS authentication server
- wpa_supplicant user space IEEE 802.1X/WPA supplicant (wireless client) for number of Linux, BSD, and Windows drivers

Host AP is a Linux driver for wireless LAN cards based on Intersil's Prism2/2.5/3 chipset. The driver supports a so called Host AP mode, i.e., it takes care of IEEE 802.11 management functions in the host computer and acts as an access point. This does not require any special firmware for the wireless LAN card. In addition to this, it has support for normal station operations in BSS and possible also in IBSS. WPA and RSN (WPA2) is supported when used with accompanied tools, wpa_supplicant (WPA/RSN Supplicant) and hostapd (WPA/RSN Authenticator). All these programs have been designed for both desktop/laptop computers and embedded systems.

Intersil's station firmware for Prism2 chipset supports a so called Host AP mode in which the firmware takes care of time critical tasks like beacon sending and frame acknowledging, but leaves other management tasks to host computer driver. This driver implements basic functionality needed to initialize and configure Prism2-based cards, to send and receive frames, and to gather statistics. In addition, it includes an implementation of following IEEE 802.11 functions: authentication (and deauthentication), association (reassociation, and disassociation), data transmission between two wireless stations, power saving (PS) mode signaling and frame buffering for PS stations. The driver has also various features for development debugging and for researching IEEE 802.11 environments like access to hardware configuration records, I/O registers, and frames with 802.11 headers.

When used with a user space daemon, the combination of the Host AP driver and hostapd daemon includes additional features. These include support for IEEE 802.1X and dynamic WEP rekeying, RADIUS Accounting, RADIUS-based ACL for IEEE 802.11 authentication, minimal IAPP (IEEE 802.11f), WPA, IEEE 802.11i/RSN/WPA2.

Linux Wireless LAN Howto has some useful information about wireless LAN support in Linux. In addition, it includes information about which cards are Prism2-based (and can thus be used in Host AP mode).

### WPA/RSN Supplicant (wpa_supplicant)

More information is available on wpa_supplicant's own page.

Supported WPA/IEEE 802.11i features:

- WPA-PSK ("WPA-Personal")
- WPA with EAP (e.g., with RADIUS authentication server) ("WPA-Enterprise")
- key management for CCMP, TKIP, WEP104, WEP40
- WPA and full IEEE 802.11i/RSN/WPA2
- RSN: PMKSA caching, pre-authentication

Supported drivers:

- Linux drivers that support Linux Wireless Extensions v19 or newer with WPA/WPA2 extensions
- Host AP driver for Prism2/2.5/3
- Linuxant DriverLoader with Windows NDIS driver supporting WPA
- Agere Systems Inc. Linux Driver (Hermes-I/Hermes-II chipset)
- madwifi (Atheros ar521x)
- ATMEL AT76C5XXx
- Linux ndiswrapper with Windows NDIS driver
- Broadcom wl.o driver
- Intel ipw2100 and ipw2200
- Wired Ethernet drivers
- BSD net80211 layer (e.g., Atheros driver) (FreeBSD 6-CURRENT)
- Windows NDIS drivers (Windows; at least XP and 2000, others not tested)

### WPA/RSN/EAP Authenticator (hostapd)

More information is available on hostapd's own page.

Supported WPA/IEEE 802.11i features:

- WPA-PSK ("WPA-Personal")
- WPA with EAP (e.g., with RADIUS authentication server) ("WPA-Enterprise")
- key management for CCMP, TKIP, WEP104, WEP40
- WPA and full IEEE 802.11i/RSN/WPA2
- RSN: PMKSA caching, pre-authentication

Supported drivers:

- Host AP driver for Prism2/2.5/3
- madwifi (Atheros ar521x)
- Prism54.org (PrismGT)
- BSD net80211 layer (e.g., Atheros driver) (FreeBSD 6-CURRENT)

### Download

Host AP driver
Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen.
Copyright (c) 2002-2007, Jouni Malinen and contributors.
Author: Jouni Malinen <j@w1.fi>

Host AP utils
Copyright (c) 2002-2005, Jouni Malinen <j@w1.fi> and contributors.

hostapd
Copyright (c) 2002-2009, Jouni Malinen <j@w1.fi> and contributors.

wpa_supplicant
Copyright (c) 2003-2009, Jouni Malinen <j@w1.fi> and contributors.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. See COPYING for more details. hostapd and wpa_supplicant are alternatively available under BSD license.

Please see README for updated documentation of the driver. Please also check FAQ before sending problem reports.

Note! Host AP driver was added into the main kernel tree in Linux v2.6.14. The version in the kernel tree should be used instead of this external hostap-driver package. The external releases are only for older kernel versions and all the future development will be in the main kernel tree.

- Release graph
- Latest stable release:
  - hostapd-0.6.9.tar.gz
  - wpa_supplicant-0.6.9.tar.gz (source code for all versions)
  - wpa_supplicant-0.6.9.exe (binary installer for Windows)
  - wpa_supplicant-windows-bin-0.6.9.zip (binaries for Windows)
  - wpa_gui-qt433-windows-dll.zip (Qt4 libraries from wpa_gui/Windows)
- Latest development release:
  - hostapd-0.7.0.tar.gz
  - wpa_supplicant-0.7.0.tar.gz (source code for all versions)
  - wpa_supplicant-0.7.0.exe (binary installer for Windows)
  - wpa_supplicant-windows-bin-0.7.0.zip (binaries for Windows)
- ChangeLog:
  - hostapd: [development branch] [stable branch]
  - wpa_supplicant: [development branch] [stable branch]
- Old releases
- Mailing list
- New mailing list archives
- Old mailing list archives
- Search mailing list archives
- Web interface to GIT repository (0.6.x and newer)
- Web interface to CVS repository (0.5.x and older)
- Snapshot releases from all active branches
- GIT and read-only anonymous CVS access (pserver)
- Host AP related links
- Bug and feature request tracking

### Wireless Tools for Linux

Please, note that you will need quite recent version of Wireless Tools to use some features of the Host AP driver. Using the latest version of the tools is recommended. Some features might also require latest beta version.

### Feedback, comments, mailing list

Any comments, reports on success/failure, ideas for further improvement, feature requests, etc. are welcome at j@w1.fi. Please note, that I often receive more email than I have time to answer. Unfortunately, some messages may not get a reply, but I'll try to go through my mail whenever time permits.

There is also a mailing list for Host AP related messages. Since this list has a broader audience, your likelyhood of getting responses is higher. This list is recommended for general questions about Host AP driver and its development. In addition, I will send release notes to it whenever a new version is available.

The mailing list information and web archive is at http://lists.shmoo.com/mailman/listinfo/hostap. Messages to hostap@shmoo.com will be delivered to the subscribers. Please note, that due to large number of spam and virus messages sent to the list address, the list is configured to accept messages only from subscribed addresses. Messages from unsubscribed addresses may be accepted manually, but their delivery will be delayed.

If you want to make sure your bug report of feature request does not get lost, please report it through the bug tracking system as a new bug/feature request.

Last modified: Sat Nov 21 22:43:15 EET 2009