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