xref: /freebsd/share/man/man4/ath_hal.4 (revision 41059135ce931c0f1014a999ffabc6bc470ce856)
1.\"-
2.\" Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
3.\" All rights reserved.
4.\""
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer,
10.\"    without modification.
11.\" 2. Redistributions in binary form must reproduce at minimum a disclaimer
12.\"    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13.\"    redistribution must be conditioned upon including a substantially
14.\"    similar Disclaimer requirement for further binary redistribution.
15.\"
16.\" NO WARRANTY
17.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19.\" LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20.\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21.\" THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22.\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27.\" THE POSSIBILITY OF SUCH DAMAGES.
28.\"
29.\" $FreeBSD$
30.\"/
31.Dd July 22, 2013
32.Dt ATH_HAL 4
33.Os
34.Sh NAME
35.Nm ath_hal
36.Nd "Atheros Hardware Access Layer (HAL)"
37.Sh SYNOPSIS
38.Cd "device ath_hal"
39.Cd "options AH_SUPPORT_AR5416"
40or
41.Cd "device ath_ar5210"
42.Cd "device ath_ar5211"
43.Cd "device ath_ar5212"
44.Cd "device ath_rf2413"
45.Cd "device ath_rf2417"
46.Cd "device ath_rf2425"
47.Cd "device ath_rf5111"
48.Cd "device ath_rf5112"
49.Cd "device ath_rf5413"
50.Cd "device ath_ar5416"
51.\".Cd "device ath_ar5312"
52.\".Cd "device ath_rf2136"
53.\".Cd "device ath_rf2137"
54.Cd "device ath_ar9130"
55.Cd "device ath_ar9160"
56.Cd "device ath_ar9280"
57.Cd "device ath_ar9285"
58.Cd "device ath_ar9287"
59.Cd "device ath_ar9300"
60.Cd "options AH_SUPPORT_AR5416"
61.Sh DESCRIPTION
62The hal provides hardware support for wireless network adapters based on
63the Atheros AR5210, AR5211, AR5212, AR5213, AR2413, AR2417, AR2425,
64AR5413, AR5416, AR5418, AR5424, AR9160, AR9220, AR9280, AR9285, AR9287,
65AR9380, AR9390, AR9580, AR9590, AR9562 and QCA9565
66chips (and companion RF/baseband parts).
67This code is part of the
68.Xr ath 4
69driver but configured separately to allow fine-grained control
70over the set of chips supported.
71Selecting
72.Nm
73enables support for all PCI and Cardbus devices.
74Note this includes AR5416, AR5418, AR9130, AR9160, AR9220, AR9280, AR9285
75and AR9287 devices and must be accompanied by the
76AH_SUPPORT_AR5416
77option to enable the extended hardware descriptor format used by
78AR5416 and later devices.
79.Pp
80Some devices come in Cardbus/MiniPCI/PCI format.
81Others (for example AR2413, AR2427, AR5418, AR9280, AR9285, AR9287) come in
82PCIe, Mini-PCIe or ExpressCard format.
83.Pp
84Historically this code has been released in a binary-only form
85and packaged as a separate module.
86With the release of source code for the hal this is no longer true
87and the code is tightly integrated with the driver.
88.Sh HARDWARE
89The following cards are among those supported by the
90.Nm
91module:
92.Pp
93.Bl -column -compact "Samsung SWL-5200N" "AR5212" "Cardbus" "a/b/g"
94.It Em "Card	Chip	Bus	Standard"
95.It "Aztech WL830PC	AR5212	CardBus	b/g"
96.It "D-Link DWL-A650	AR5210	CardBus	a"
97.It "D-Link DWL-AB650	AR5211	CardBus	a/b"
98.It "D-Link DWL-A520	AR5210	PCI	a"
99.It "D-Link DWL-AG520	AR5212	PCI	a/b/g"
100.It "D-Link DWL-AG650	AR5212	CardBus	a/b/g"
101.It "D-Link DWL-G520B	AR5212	PCI	b/g"
102.It "D-Link DWL-G650B	AR5212	CardBus	b/g"
103.It "Elecom LD-WL54AG	AR5212	Cardbus	a/b/g"
104.It "Elecom LD-WL54	AR5211	Cardbus	a"
105.It "Fujitsu E5454	AR5212	Cardbus	a/b/g"
106.It "Fujitsu FMV-JW481	AR5212	Cardbus	a/b/g"
107.It "Fujitsu E5454	AR5212	Cardbus	a/b/g"
108.It "HP NC4000	AR5212	PCI	a/b/g"
109.It "I/O Data WN-AB	AR5212	CardBus	a/b"
110.It "I/O Data WN-AG	AR5212	CardBus	a/b/g"
111.It "I/O Data WN-A54	AR5212	CardBus	a"
112.It "Linksys WMP55AG	AR5212	PCI	a/b/g"
113.It "Linksys WPC51AB	AR5211	CardBus	a/b"
114.It "Linksys WPC55AG	AR5212	CardBus	a/b/g"
115.It "NEC PA-WL/54AG	AR5212	CardBus	a/b/g"
116.It "Netgear WAG311	AR5212	PCI	a/b/g"
117.It "Netgear WAB501	AR5211	CardBus	a/b"
118.It "Netgear WAG511	AR5212	CardBus	a/b/g"
119.It "Netgear WG311 (aka WG311v1)	AR5212	PCI	b/g"
120.It "Netgear WG311v2	AR5212	PCI	b/g"
121.It "Netgear WG311T	AR5212	PCI	b/g"
122.It "Netgear WG511T	AR5212	CardBus	b/g"
123.It "Orinoco 8480	AR5212	CardBus	a/b/g"
124.It "Orinoco 8470WD	AR5212	CardBus	a/b/g"
125.It "Proxim Skyline 4030	AR5210	CardBus	a"
126.It "Proxim Skyline 4032	AR5210	PCI	a"
127.It "Samsung SWL-5200N	AR5212	CardBus	a/b/g"
128.It "SMC SMC2735W	AR5210	CardBus	a"
129.It "Sony PCWA-C700	AR5212	Cardbus	a/b"
130.It "Sony PCWA-C300S	AR5212	Cardbus	b/g"
131.It "Sony PCWA-C500	AR5210	Cardbus	a"
132.It "3Com 3CRPAG175	AR5212	CardBus	a/b/g"
133.It "TP-LINK TL-WDN4800	AR9380	PCIe	a/b/g/n"
134.El
135.Sh SEE ALSO
136.Xr ath 4
137.Sh HISTORY
138The
139.Nm
140module first appeared in
141.Fx 5.2 .
142.Sh BUGS
143See
144.Xr ath 4
145for known bugs.
146