xref: /openbsd/share/man/man4/udav.4 (revision 5af055cd)
1.\"	$OpenBSD: udav.4,v 1.17 2015/07/15 18:02:15 sobrado Exp $
2.\"	$NetBSD: udav.4,v 1.1 2003/08/22 06:42:01 itojun Exp $
3.\"
4.\" Copyright (c) 2003
5.\"     Shingo WATANABE <nabe@nabechan.org>. All rights reserved.
6.\" Copyright (c) 2014
7.\"     Takayoshi SASANO <uaa@uaa.org.uk>. (RD9700 support)
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. 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 THE AUTHOR 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.Dd $Mdocdate: July 15 2015 $
34.Dt UDAV 4
35.Os
36.Sh NAME
37.Nm udav
38.Nd Davicom DM9601 10/100 USB Ethernet device
39.Sh SYNOPSIS
40.Cd "udav*  at uhub?"
41.Cd "amphy* at mii?"
42.Sh DESCRIPTION
43The
44.Nm
45driver provides support for USB
46.Tn Ethernet
47adapters based on the Davicom DM9601 USB-ether bridge chip.
48.Pp
49The
50.Nm
51driver supports the following adapters:
52.Pp
53.Bl -tag -width Dv -offset indent -compact
54.It Tn Corega FEther USB-TXC
55.It Tn HenTong WK-668
56.It Tn Konig CMP-NWUSB10
57.It Tn ShanTou ST268
58.It Tn ShanTou ZT6688
59.It Tn ShanTou ADM8515
60.El
61.Pp
62The
63.Nm
64driver also supports CoreChip RD9700.
65As many of these units ship with the same MAC address, it is
66highly recommended to use
67.Xr ifconfig 8
68.Cm lladdr
69to set the address manually, or
70.Cm lladdr random
71to assign a random address.
72.Pp
73For more information on configuring this device, see
74.Xr ifconfig 8 .
75.Sh SEE ALSO
76.Xr amphy 4 ,
77.Xr arp 4 ,
78.Xr ifmedia 4 ,
79.Xr mii 4 ,
80.Xr netintro 4 ,
81.Xr uhub 4 ,
82.Xr usb 4 ,
83.Xr hostname.if 5 ,
84.Xr ifconfig 8
85.Rs
86.%T Davicom DM9601 data sheet
87.%U http://www.davicom.com.tw/big5/download/Data%20Sheet/DM9601-DS-P01-930914.pdf
88.Re
89.Sh HISTORY
90The
91.Nm
92device driver first appeared in
93.Ox 3.7 .
94.Sh AUTHORS
95.An -nosplit
96The
97.Nm
98driver was written by
99.An Shingo WATANABE Aq Mt nabe@nabechan.org
100and ported to
101.Ox
102by
103.An Jonathan Gray Aq Mt jsg@openbsd.org .
104.Pp
105RD9700 support by
106.An Takayoshi SASANO Aq Mt uaa@uaa.org.uk .
107.Sh BUGS
108The RD9700 sometimes lacks zero-length packets to terminate
109USB transactions, which can cause USB IOERRORs.
110