xref: /freebsd/share/man/man4/miibus.4 (revision 9ee99cec1f36dec8f05c780f1f05f862d7c76572)
1.\" Written by Tom Rhodes for the FreeBSD Project.
2.\" Please see the /usr/src/COPYRIGHT file for copyright information.
3.\"
4.\" This document takes information from the IEEE 802.3 Standard
5.\" along with various comments from Peter Wemm, Robert Watson, and Bill Paul.
6.\" Originally this file looked much like the NetBSD mii(4) manual page, but
7.\" I doubt you would ever notice due to large differences.
8.\"
9.\" $FreeBSD$
10.\"
11.Dd December 1, 2015
12.Dt MIIBUS 4
13.Os
14.Sh NAME
15.Nm miibus
16.Nd IEEE 802.3 Media Independent Interface network bus
17.Sh SYNOPSIS
18For most network interface cards (NIC):
19.Cd "device miibus"
20.Sh DESCRIPTION
21The
22.Nm
23driver provides an interconnection between the Media Access Control (MAC)
24sublayer, the Physical Layer entities (PHY), Station Management (STA)
25entities, and the PHY Layer as defined by the IEEE 802.3 Standard.
26.Pp
27The
28.Nm
29layer allows network device drivers to share common support
30code for various external PHY devices.
31Most 10/100 network interface cards either use an MII transceiver
32or have built-in transceivers that can be programmed using an MII
33interface.
34The
35.Nm
36driver currently handles all of the media detection,
37selection, and reporting using the ifmedia interface.
38A generic driver has been included for all PHYs that are not
39handled by a specific driver, this is possible because all
4010/100 PHYs implement the same general register set along with
41their vendor specific register set.
42.Pp
43The following network device drivers use the
44.Nm
45interface:
46.Pp
47.Bl -tag -compact -width ".Xr fxp 4"
48.It Xr ae 4
49Attansic/Atheros L2 Fast Ethernet
50.It Xr age 4
51Attansic/Atheros L1 Gigabit Ethernet
52.It Xr alc 4
53Atheros AR8131/AR8132 PCIe Ethernet
54.It Xr ale 4
55Atheros AR8121/AR8113/AR8114 PCIe Ethernet
56.It Xr aue 4
57ADMtek USB Ethernet
58.It Xr axe 4
59ASIX Electronics AX88172 USB Ethernet
60.It Xr axge 4
61ASIX Electronics AX88178A/AX88179 USB Ethernet
62.It Xr bce 4
63Broadcom NetXtreme II Gigabit Ethernet
64.It Xr bfe 4
65Broadcom BCM4401 Ethernet
66.It Xr bge 4
67Broadcom BCM570xx Gigabit Ethernet
68.It Xr cas 4
69Sun Cassini/Cassini+ and National Semiconductor DP83065 Saturn
70.It Xr dc 4
71DEC/Intel 21143 and various workalikes
72.It Xr ed 4
73NE[12]000, SMC Ultra, 3c503, DS8390 cards
74.It Xr et 4
75Agere ET1310 Gigabit Ethernet
76.It Xr fxp 4
77Intel EtherExpress PRO/100B
78.It Xr gem 4
79Sun ERI, Sun GEM and Apple GMAC Ethernet
80.It Xr jme 4
81JMicron JMC250 Gigabit/JMC260 Fast Ethernet
82.It Xr lge 4
83Level 1 LXT1001 NetCellerator Gigabit Ethernet
84.It Xr msk 4
85Marvell/SysKonnect Yukon II Gigabit Ethernet
86.It Xr nfe 4
87NVIDIA nForce MCP Networking Adapter
88.It Xr nge 4
89National Semiconductor DP83820/DP83821 Gigabit Ethernet
90.It Xr pcn 4
91AMD Am79C97x PCI 10/100
92.It Xr re 4
93RealTek 8139C+/8169/8169S/8110S
94.It Xr rl 4
95RealTek 8129/8139
96.It Xr rue 4
97RealTek RTL8150 USB To Fast Ethernet
98.It Xr sf 4
99Adaptec AIC-6915
100.It Xr sge 4
101Silicon Integrated Systems SiS190/191 Ethernet
102.It Xr sis 4
103Silicon Integrated Systems SiS 900/SiS 7016
104.It Xr sk 4
105SysKonnect SK-984x and SK-982x Gigabit Ethernet
106.It Xr smsc 4
107SMSC LAN9xxx USB Fast Ethernet
108.It Xr ste 4
109Sundance ST201 (D-Link DFE-550TX)
110.It Xr stge 4
111Sundance/Tamarack TC9021 Gigabit Ethernet
112.It Xr tl 4
113Texas Instruments ThunderLAN
114.It Xr tx 4
115SMC EtherPower II (83c170)
116.It Xr udav 4
117Davicom DM9601 USB Ethernet
118.It Xr ure 4
119RealTek RTL8152 USB To Fast Ethernet
120.It Xr vge 4
121VIA VT612x PCI Gigabit Ethernet
122.It Xr vr 4
123VIA Rhine, Rhine II
124.It Xr vte 4
125DM&P Vortex86 RDC R6040 Fast Ethernet
126.It Xr wb 4
127Winbond W89C840F
128.It Xr xl 4
1293Com 3c90x
130.El
131.Sh COMPATIBILITY
132The implementation of
133.Nm
134was originally intended to have similar API interfaces
135to
136.Bsx 3.0
137and
138.Nx ,
139but as a result are not well behaved newbus device drivers.
140.Sh SEE ALSO
141.Xr ae 4 ,
142.Xr age 4 ,
143.Xr alc 4 ,
144.Xr ale 4 ,
145.Xr arp 4 ,
146.Xr aue 4 ,
147.Xr axe 4 ,
148.Xr axge 4 ,
149.Xr bce 4 ,
150.Xr bfe 4 ,
151.Xr bge 4 ,
152.Xr cas 4 ,
153.Xr dc 4 ,
154.Xr ed 4 ,
155.Xr et 4 ,
156.Xr fxp 4 ,
157.Xr gem 4 ,
158.Xr jme 4 ,
159.Xr lge 4 ,
160.Xr msk 4 ,
161.Xr netintro 4 ,
162.Xr nfe 4 ,
163.Xr nge 4 ,
164.Xr pcn 4 ,
165.Xr re 4 ,
166.Xr rgephy 4 ,
167.Xr rl 4 ,
168.Xr rue 4 ,
169.Xr sf 4 ,
170.Xr sge 4 ,
171.Xr sis 4 ,
172.Xr sk 4 ,
173.Xr smsc 4 ,
174.Xr ste 4 ,
175.Xr stge 4 ,
176.Xr tl 4 ,
177.Xr tx 4 ,
178.Xr udav 4 ,
179.Xr ure 4 ,
180.Xr vge 4 ,
181.Xr vr 4 ,
182.Xr vte 4 ,
183.Xr wb 4 ,
184.Xr xl 4
185.Sh STANDARDS
186More information on MII can be found in the IEEE 802.3 Standard.
187.Sh HISTORY
188The
189.Nm
190driver first appeared in
191.Fx 3.3 .
192.Sh AUTHORS
193This manual page was written by
194.An Tom Rhodes Aq Mt trhodes@FreeBSD.org .
195