xref: /freebsd/share/man/man4/mos.4 (revision 7cc42f6d25ef2e19059d088fa7d4853fe9afefb5)
1.\"
2.\" Copyright (c) 2011 Rick van der Zwet <info@rickvanderzwet.nl>
3.\"
4.\" Permission to use, copy, modify, and distribute this software for any
5.\" purpose with or without fee is hereby granted, provided that the above
6.\" copyright notice and this permission notice appear in all copies.
7.\"
8.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15.\"
16.\" $FreeBSD$
17.\"
18.Dd November 24, 2015
19.Dt MOS 4
20.Os
21.Sh NAME
22.Nm mos
23.Nd Moschip MCS7730/MCS7830/MCS7832 USB Ethernet driver
24.Sh SYNOPSIS
25To compile this driver into the kernel,
26place the following lines in your
27kernel configuration file:
28.Bd -ragged -offset indent
29.Cd "device uhci"
30.Cd "device ohci"
31.Cd "device ehci"
32.Cd "device usb"
33.Cd "device miibus"
34.Cd "device uether"
35.Cd "device mos"
36.Ed
37.Pp
38Alternatively, to load the driver as a
39module at boot time, place the following line in
40.Xr loader.conf 5 :
41.Bd -literal -offset indent
42if_mos_load="YES"
43.Ed
44.Sh DESCRIPTION
45The
46.Nm
47driver provides support for USB Ethernet adapters based on the
48Moschip MCS7730/MCS7830/MCS7832 chipset.
49.Pp
50The adapters that contain the Moschip MCS7730/MCS7830/MCS7832 chipset
51will operate at 100Base-TX and full-duplex.
52.Pp
53The Moschip contains a 10/100
54Ethernet MAC with MII interface and is designed to work with both
55Ethernet and HomePNA transceivers.
56Although designed to interface with
57100Mbps peripherals, this only works with USB 2.0. The existing USB 1.0
58standard specifies a maximum transfer speed of 12Mbps.
59USB 1.0 Users should therefore not expect to actually achieve 100Mbps speeds
60with these devices.
61.Pp
62The Moschip supports a 64-bit multicast hash table, single perfect
63filter entry for the station address and promiscuous mode.
64Packets are
65received and transmitted over separate USB bulk transfer endpoints.
66.Pp
67For more information on configuring this device, see
68.Xr ifconfig 8 .
69.Sh HARDWARE
70Adapters supported by the
71.Nm
72driver include:
73.Pp
74.Bl -bullet -compact
75.It
76Sitecom LN030
77.El
78.Sh SEE ALSO
79.Xr altq 4 ,
80.Xr arp 4 ,
81.Xr miibus 4 ,
82.Xr netintro 4 ,
83.Xr ng_ether 4 ,
84.Xr ifconfig 8
85.Rs
86.%T ADMtek AN986 data sheet
87.%O http://www.moschip.com/data/products/MCS7830/Data%20Sheet_7830.pdf
88.Re
89.Sh HISTORY
90The
91.Nm
92device driver first appeared in
93.Fx 8.2 .
94.Sh AUTHORS
95The
96.Nm
97driver was written by
98.An Rick van der Zwet info@rickvanderzwet.nl .
99