xref: /netbsd-src/share/man/man4/mos.4 (revision 2026b7285b519b6985686c4f29b6309b5e58de6d)
1.\"	$NetBSD: mos.4,v 1.3 2024/02/04 05:43:06 mrg Exp $
2.\"
3.\" Copyright (c) 1997, 1998, 1999, 2000-2003
4.\"	Bill Paul <wpaul@windriver.com>. All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by Bill Paul.
17.\" 4. Neither the name of the author nor the names of any co-contributors
18.\"    may be used to endorse or promote products derived from this software
19.\"   without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
31.\" THE POSSIBILITY OF SUCH DAMAGE.
32.\"
33.\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/axe.4,v 1.3 2003/05/29 21:28:35 ru Exp $
34.\" $OpenBSD: mos.4,v 1.11 2014/04/08 01:18:19 brad Exp $
35.\"
36.Dd August 24, 2019
37.Dt MOS 4
38.Os
39.Sh NAME
40.Nm mos
41.Nd MosChip MCS7730/7830/7832 10/100 USB Ethernet device
42.Sh SYNOPSIS
43.Cd "mos*   at uhub?"
44.Sh DESCRIPTION
45The
46.Nm
47driver provides support for USB Ethernet adapters based on the MosChip
48MCS7730, MCS7830, and MCS7832 USB 2.0 chipsets, including the
49following:
50.Pp
51.Bl -tag -width Ds -offset indent -compact
52.It Delock 61147
53.It Sitecom LN-030
54.It Syba SY-U2LAN
55.El
56.Pp
57All adapters operate with either USB 1.x, 2.0, or 3.x controllers,
58though performance with 1.x controllers is limited since
59the USB 1.x standard specifies a maximum transfer speed of 12Mbps.
60Users with USB 1.x controllers should therefore not expect to actually
61achieve 100Mbps speeds with these devices.
62.Pp
63A 64-bit multicast hash table is supported,
64single perfect filter entry for the station address,
65all-multicast mode, and promiscuous mode.
66Packets are
67received and transmitted over separate USB bulk transfer endpoints.
68.Pp
69The
70.Nm
71driver supports the following media types:
72.Bl -tag -width "autoselect"
73.It autoselect
74Enable autoselection of the media type and options (this is the default).
75The user can manually override the autoselected mode by adding media
76options to the appropriate
77.Xr ifconfig.if 5
78file.
79.It 10baseT
80Set 10Mbps operation.
81.It 100baseTX
82Set 100Mbps (Fast Ethernet) operation.
83.El
84.Pp
85The
86.Nm
87driver supports the following media options:
88.Bl -tag -width "full-duplex"
89.It full-duplex
90Force full-duplex operation.
91.It half-duplex
92Force half-duplex operation.
93.El
94.Pp
95For more information on configuring this device, see
96.Xr ifconfig 8 .
97.Sh DIAGNOSTICS
98See
99.Xr usbnet 4
100for diagnostics.
101.Sh SEE ALSO
102.Xr arp 4 ,
103.Xr ifmedia 4 ,
104.Xr intro 4 ,
105.Xr netintro 4 ,
106.Xr usb 4 ,
107.Xr usbnet 4 ,
108.Xr ifconfig.if 5 ,
109.Xr ifconfig 8 ,
110.Xr usbnet 9
111.Rs
112.%T "MosChip India"
113.%U http://www.moschip.com
114.Re
115.Sh HISTORY
116The
117.Nm
118driver first appeared in
119.Ox 4.5 .
120It was ported to
121.Nx
122by
123.An Matthew R. Green Aq Mt mrg@eterna23.net
124and first appeared in
125.Nx 10.0 .
126.Sh AUTHORS
127.An -nosplit
128The
129.Nm
130driver was written by
131.An Johann Christian Rode Aq Mt jcrode@gmx.net .
132