xref: /freebsd/share/man/man4/miibus.4 (revision 0b3105a37d7adcadcb720112fed4dc4e8040be99)
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 hme 4
81Sun HME Ethernet
82.It Xr jme 4
83JMicron JMC250 Gigabit/JMC260 Fast Ethernet
84.It Xr lge 4
85Level 1 LXT1001 NetCellerator Gigabit Ethernet
86.It Xr msk 4
87Marvell/SysKonnect Yukon II Gigabit Ethernet
88.It Xr nfe 4
89NVIDIA nForce MCP Networking Adapter
90.It Xr nge 4
91National Semiconductor DP83820/DP83821 Gigabit Ethernet
92.It Xr pcn 4
93AMD Am79C97x PCI 10/100
94.It Xr re 4
95RealTek 8139C+/8169/8169S/8110S
96.It Xr rl 4
97RealTek 8129/8139
98.It Xr rue 4
99RealTek RTL8150 USB To Fast Ethernet
100.It Xr sf 4
101Adaptec AIC-6915
102.It Xr sge 4
103Silicon Integrated Systems SiS190/191 Ethernet
104.It Xr sis 4
105Silicon Integrated Systems SiS 900/SiS 7016
106.It Xr sk 4
107SysKonnect SK-984x and SK-982x Gigabit Ethernet
108.It Xr smsc 4
109SMSC LAN9xxx USB Fast Ethernet
110.It Xr ste 4
111Sundance ST201 (D-Link DFE-550TX)
112.It Xr stge 4
113Sundance/Tamarack TC9021 Gigabit Ethernet
114.It Xr tl 4
115Texas Instruments ThunderLAN
116.It Xr tx 4
117SMC EtherPower II (83c170)
118.It Xr udav 4
119Davicom DM9601 USB Ethernet
120.It Xr ure 4
121RealTek RTL8152 USB To Fast Ethernet
122.It Xr vge 4
123VIA VT612x PCI Gigabit Ethernet
124.It Xr vr 4
125VIA Rhine, Rhine II
126.It Xr vte 4
127DM&P Vortex86 RDC R6040 Fast Ethernet
128.It Xr wb 4
129Winbond W89C840F
130.It Xr xl 4
1313Com 3c90x
132.El
133.Sh COMPATIBILITY
134The implementation of
135.Nm
136was originally intended to have similar API interfaces
137to
138.Bsx 3.0
139and
140.Nx ,
141but as a result are not well behaved newbus device drivers.
142.Sh SEE ALSO
143.Xr ae 4 ,
144.Xr age 4 ,
145.Xr alc 4 ,
146.Xr ale 4 ,
147.Xr arp 4 ,
148.Xr aue 4 ,
149.Xr axe 4 ,
150.Xr axge 4 ,
151.Xr bce 4 ,
152.Xr bfe 4 ,
153.Xr bge 4 ,
154.Xr cas 4 ,
155.Xr dc 4 ,
156.Xr ed 4 ,
157.Xr et 4 ,
158.Xr fxp 4 ,
159.Xr gem 4 ,
160.Xr hme 4 ,
161.Xr jme 4 ,
162.Xr lge 4 ,
163.Xr msk 4 ,
164.Xr netintro 4 ,
165.Xr nfe 4 ,
166.Xr nge 4 ,
167.Xr pcn 4 ,
168.Xr re 4 ,
169.Xr rgephy 4 ,
170.Xr rl 4 ,
171.Xr rue 4 ,
172.Xr sf 4 ,
173.Xr sge 4 ,
174.Xr sis 4 ,
175.Xr sk 4 ,
176.Xr smsc 4 ,
177.Xr ste 4 ,
178.Xr stge 4 ,
179.Xr tl 4 ,
180.Xr tx 4 ,
181.Xr udav 4 ,
182.Xr ure 4 ,
183.Xr vge 4 ,
184.Xr vr 4 ,
185.Xr vte 4 ,
186.Xr wb 4 ,
187.Xr xl 4
188.Sh STANDARDS
189More information on MII can be found in the IEEE 802.3 Standard.
190.Sh HISTORY
191The
192.Nm
193driver first appeared in
194.Fx 3.3 .
195.Sh AUTHORS
196This manual page was written by
197.An Tom Rhodes Aq Mt trhodes@FreeBSD.org .
198