ath.4 (70c8948af87c1be7c79025e9ee904180f84741dc) ath.4 (37c8ee8847faa53432809cae2ecc11b80c4eab2f)
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

--- 14 unchanged lines hidden (view full) ---

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.\"/
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

--- 14 unchanged lines hidden (view full) ---

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 June 16, 2020
31.Dd August 7, 2023
32.Dt ATH 4
33.Os
34.Sh NAME
35.Nm ath
36.Nd "Atheros IEEE 802.11 wireless network driver"
37.Sh SYNOPSIS
38To compile this driver into the kernel,
39place the following lines in your
40kernel configuration file:
41.Bd -ragged -offset indent
42.Cd "device ath"
32.Dt ATH 4
33.Os
34.Sh NAME
35.Nm ath
36.Nd "Atheros IEEE 802.11 wireless network driver"
37.Sh SYNOPSIS
38To compile this driver into the kernel,
39place the following lines in your
40kernel configuration file:
41.Bd -ragged -offset indent
42.Cd "device ath"
43.Cd "device ath_pci"
44.Cd "device ath_hal"
45.Cd "device ath_rate_sample"
46.Cd "device wlan"
47.Ed
48.Pp
49Alternatively, to load the driver as a
50module at boot time, place the following line in
51.Xr loader.conf 5 :
52.Bd -literal -offset indent
53if_ath_load="YES"
43.Cd "device ath_hal"
44.Cd "device ath_rate_sample"
45.Cd "device wlan"
46.Ed
47.Pp
48Alternatively, to load the driver as a
49module at boot time, place the following line in
50.Xr loader.conf 5 :
51.Bd -literal -offset indent
52if_ath_load="YES"
54if_ath_pci_load="YES"
55.Ed
56.Sh DESCRIPTION
57The
58.Nm
59driver provides support for wireless network adapters based on
60the Atheros AR5210, AR5211, AR5212, AR5416 and AR9300 programming APIs.
61These APIs are used by a wide variety of chips; most all chips with
62a PCI, PCIe and/or CardBus interface are supported.
63.Pp
64Supported features include 802.11 and 802.3 frames, power management, BSS,
65IBSS, MBSS, WDS/DWDS TDMA, and host-based access point operation modes.
66All host/device interaction is via DMA.
67.Pp
53.Ed
54.Sh DESCRIPTION
55The
56.Nm
57driver provides support for wireless network adapters based on
58the Atheros AR5210, AR5211, AR5212, AR5416 and AR9300 programming APIs.
59These APIs are used by a wide variety of chips; most all chips with
60a PCI, PCIe and/or CardBus interface are supported.
61.Pp
62Supported features include 802.11 and 802.3 frames, power management, BSS,
63IBSS, MBSS, WDS/DWDS TDMA, and host-based access point operation modes.
64All host/device interaction is via DMA.
65.Pp
68Please note that from FreeBSD-9.0, the
69.Nm
70driver does not include the PCI/PCIe bus glue.
71The same driver supports multiple underlying bus types, including PCI/PCIe,
72but also embedded (AHB) and USB in the future.
73.Pp
74To enable use for PCI/PCIe systems, see the
75.Xr ath_pci 4
76driver.
77For embedded systems which use the AHB to connect the wireless MAC, see the
78.Xr ath_ahb 4
79driver.
80.Pp
81The
82.Nm
83driver encapsulates all IP and ARP traffic as 802.11 frames, however
84it can receive either 802.11 or 802.3 frames.
85Transmit speed and operating mode is selectable
86and depends on the specific chipset.
87AR5210-based devices support 802.11a operation with transmit speeds
88of 6 Mbps, 9 Mbps, 12 Mbps, 18 Mbps, 24 Mbps, 36 Mbps, 48 Mbps, and 54 Mbps.

--- 213 unchanged lines hidden ---
66The
67.Nm
68driver encapsulates all IP and ARP traffic as 802.11 frames, however
69it can receive either 802.11 or 802.3 frames.
70Transmit speed and operating mode is selectable
71and depends on the specific chipset.
72AR5210-based devices support 802.11a operation with transmit speeds
73of 6 Mbps, 9 Mbps, 12 Mbps, 18 Mbps, 24 Mbps, 36 Mbps, 48 Mbps, and 54 Mbps.

--- 213 unchanged lines hidden ---