1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-29 12:03:03 +00:00
freebsd/sys/contrib/dev/ath
Sam Leffler f668bdbdb5 Version 0.9.6.1:
o support for 5112 and 2112 radios on 5212-based products
o revised interface for ah_procRxDesc needed to handle a race
  condition created with the use of self-linked rx descriptors
o support for setting the MAC address
o remove some unused methods from the public API
o revised diagnostic API (replace dump* methods with getDiagState)
o const'ify set key cache method parameters
o support for optional 32khz sleep clock
o implement ah_setSlotTime for 5211 parts
o ANI improvements for 5212 parts

Approved by:    re (scottl)
2003-11-29 01:11:48 +00:00
..
freebsd Version 0.9.6.1: 2003-11-29 01:11:48 +00:00
ah_desc.h Initial import of Atheros Hardware Access Layer (HAL) 2003-06-25 06:06:52 +00:00
ah_devid.h Version 0.9.5.17: 2003-11-01 03:19:51 +00:00
ah.h Version 0.9.6.1: 2003-11-29 01:11:48 +00:00
COPYRIGHT Initial import of Atheros Hardware Access Layer (HAL) 2003-06-25 06:06:52 +00:00
README Version 0.9.5.2: 2003-08-02 05:48:03 +00:00
version.h Version 0.9.6.1: 2003-11-29 01:11:48 +00:00

$Id: README,v 1.2 2003/07/02 01:55:27 sam Exp $


WARNING: THIS IS A BETA DISTRIBUTION.  THIS SOFTWARE HAS KNOWN PROBLEMS AND
WARNING: LIMITATIONS THAT WILL BE CORRECTED BEFORE A PRODUCTION RELEASE.
WARNING: USE AT YOUR OWN RISK!


Atheros Hardware Access Layer (HAL)
===================================

* Copyright (c) 2002, 2003 Sam Leffler.
* Copyright (c) 2002, 2003 Atheros Communications, Inc.
* All rights reserved.

Read the file COPYRIGHT for the complete copyright.

This code manages much of the chip-specific operation of the Atheros driver.
The HAL is provided in a binary-only form in order to comply with FCC
regulations.  In particular, a radio transmitter can only be operated at
power levels and on frequency channels for which it is approved.  The FCC
requires that a software-defined radio cannot be configured by a user
to operate outside the approved power levels and frequency channels.
This makes it difficult to open-source code that enforces limits on
the power levels, frequency channels and other parameters of the radio
transmitter.  See

http://ftp.fcc.gov/Bureaus/Engineering_Technology/Orders/2001/fcc01264.pdf

for the specific FCC regulation.  Because the module is provided in a
binary-only form it is marked "Proprietary"; this means when you load
it you will see messages that your system is now "tainted".

If you wish to use this driver on a platform for which an ath_hal
module is not already provided please contact the author.  Note that
this is only necessary for new _architectures_; the HAL is not tied to
any specific version of your operating system.


Atheros Hardware
================
There are currently 3 generations of Atheros 802.11 wireless devices:

5210	supports 11a only
5211	supports both 11a and 11b
5212	supports 11a, 11b, and 11g

These parts have been incorporated in a variety of retail products
including cardbus cards from DLink, Linksys, Netgear, and Proxim; and
mini-pci cards from some of these same vendors.  In addition many
laptop vendors use Atheros mini-pci cards for their builtin wireless
support.  An (incomplete) list of products that use Atheros parts is:

Netgear WAG511		D-Link DWL-AG520	Linksys WPC55AG
Netgear WAB501		D-Link DWL-AG650	Linksys WMP55AG
			D-Link DWL-AB650	Linksys WPC51AB

In general, if a device is identified as ``11a only'' it is almost
certain to contain an Atheros 5210 part in it.  All retail a+b
products use the 5211.  The latest generation of universal a+b+g
combo products use the 5212.  When in doubt check the PCI vendor
id with a tool like lspci, the Atheros vendor id is 0x168c; e.g.

   00:13.0 Ethernet controller: Unknown device 168c:0012 (rev 01)