xref: /freebsd/share/man/man4/miibus.4 (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229)
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 26, 2020
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 re 4
91RealTek 8139C+/8169/8169S/8110S
92.It Xr rl 4
93RealTek 8129/8139
94.It Xr rue 4
95RealTek RTL8150 USB To Fast Ethernet
96.It Xr sge 4
97Silicon Integrated Systems SiS190/191 Ethernet
98.It Xr sis 4
99Silicon Integrated Systems SiS 900/SiS 7016
100.It Xr sk 4
101SysKonnect SK-984x and SK-982x Gigabit Ethernet
102.It Xr smsc 4
103SMSC LAN9xxx USB Fast Ethernet
104.It Xr ste 4
105Sundance ST201 (D-Link DFE-550TX)
106.It Xr stge 4
107Sundance/Tamarack TC9021 Gigabit Ethernet
108.It Xr udav 4
109Davicom DM9601 USB Ethernet
110.It Xr ure 4
111RealTek RTL8152 USB To Fast Ethernet
112.It Xr vge 4
113VIA VT612x PCI Gigabit Ethernet
114.It Xr vr 4
115VIA Rhine, Rhine II
116.It Xr vte 4
117DM&P Vortex86 RDC R6040 Fast Ethernet
118.It Xr xl 4
1193Com 3c90x
120.El
121.Sh COMPATIBILITY
122The implementation of
123.Nm
124was originally intended to have similar API interfaces
125to
126.Bsx 3.0
127and
128.Nx ,
129but as a result are not well behaved newbus device drivers.
130.Sh SEE ALSO
131.Xr ae 4 ,
132.Xr age 4 ,
133.Xr alc 4 ,
134.Xr ale 4 ,
135.Xr arp 4 ,
136.Xr aue 4 ,
137.Xr axe 4 ,
138.Xr axge 4 ,
139.Xr bce 4 ,
140.Xr bfe 4 ,
141.Xr bge 4 ,
142.Xr cas 4 ,
143.Xr dc 4 ,
144.Xr ed 4 ,
145.Xr et 4 ,
146.Xr fxp 4 ,
147.Xr gem 4 ,
148.Xr jme 4 ,
149.Xr lge 4 ,
150.Xr msk 4 ,
151.Xr netintro 4 ,
152.Xr nfe 4 ,
153.Xr nge 4 ,
154.Xr re 4 ,
155.Xr rgephy 4 ,
156.Xr rl 4 ,
157.Xr rue 4 ,
158.Xr sge 4 ,
159.Xr sis 4 ,
160.Xr sk 4 ,
161.Xr smsc 4 ,
162.Xr ste 4 ,
163.Xr stge 4 ,
164.Xr udav 4 ,
165.Xr ure 4 ,
166.Xr vge 4 ,
167.Xr vr 4 ,
168.Xr vte 4 ,
169.Xr xl 4
170.Sh STANDARDS
171More information on MII can be found in the IEEE 802.3 Standard.
172.Sh HISTORY
173The
174.Nm
175driver first appeared in
176.Fx 3.3 .
177.Sh AUTHORS
178This manual page was written by
179.An Tom Rhodes Aq Mt trhodes@FreeBSD.org .
180