xref: /freebsd/share/man/man4/uchcom.4 (revision b32d5fae5fbd0fad29ef1840d63da557c2df10b3)
1b32d5faeSChristian Brueffer.\" $NetBSD: uchcom.4,v 1.1 2007/09/03 18:02:17 tshiozak Exp $
2b32d5faeSChristian Brueffer.\"
3b32d5faeSChristian Brueffer.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
4b32d5faeSChristian Brueffer.\" All rights reserved.
5b32d5faeSChristian Brueffer.\"
6b32d5faeSChristian Brueffer.\" This code is derived from software contributed to The NetBSD Foundation
7b32d5faeSChristian Brueffer.\" by Takuya SHIOZAKI (tshiozak@netbsd.org).
8b32d5faeSChristian Brueffer.\"
9b32d5faeSChristian Brueffer.\" Redistribution and use in source and binary forms, with or without
10b32d5faeSChristian Brueffer.\" modification, are permitted provided that the following conditions
11b32d5faeSChristian Brueffer.\" are met:
12b32d5faeSChristian Brueffer.\" 1. Redistributions of source code must retain the above copyright
13b32d5faeSChristian Brueffer.\"    notice, this list of conditions and the following disclaimer.
14b32d5faeSChristian Brueffer.\" 2. Redistributions in binary form must reproduce the above copyright
15b32d5faeSChristian Brueffer.\"    notice, this list of conditions and the following disclaimer in the
16b32d5faeSChristian Brueffer.\"    documentation and/or other materials provided with the distribution.
17b32d5faeSChristian Brueffer.\" 3. All advertising materials mentioning features or use of this software
18b32d5faeSChristian Brueffer.\"    must display the following acknowledgement:
19b32d5faeSChristian Brueffer.\"        This product includes software developed by the NetBSD
20b32d5faeSChristian Brueffer.\"        Foundation, Inc. and its contributors.
21b32d5faeSChristian Brueffer.\" 4. Neither the name of The NetBSD Foundation nor the names of its
22b32d5faeSChristian Brueffer.\"    contributors may be used to endorse or promote products derived
23b32d5faeSChristian Brueffer.\"    from this software without specific prior written permission.
24b32d5faeSChristian Brueffer.\"
25b32d5faeSChristian Brueffer.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26b32d5faeSChristian Brueffer.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27b32d5faeSChristian Brueffer.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28b32d5faeSChristian Brueffer.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29b32d5faeSChristian Brueffer.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30b32d5faeSChristian Brueffer.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31b32d5faeSChristian Brueffer.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32b32d5faeSChristian Brueffer.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33b32d5faeSChristian Brueffer.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34b32d5faeSChristian Brueffer.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35b32d5faeSChristian Brueffer.\" POSSIBILITY OF SUCH DAMAGE.
36b32d5faeSChristian Brueffer.\"
37b32d5faeSChristian Brueffer.\" $FreeBSD$
38b32d5faeSChristian Brueffer.\"
39b32d5faeSChristian Brueffer.Dd March 1, 2008
40b32d5faeSChristian Brueffer.Dt UCHCOM 4
41b32d5faeSChristian Brueffer.Os
42b32d5faeSChristian Brueffer.Sh NAME
43b32d5faeSChristian Brueffer.Nm uchcom
44b32d5faeSChristian Brueffer.Nd WinChipHead CH341/CH340 serial adapter driver
45b32d5faeSChristian Brueffer.Sh SYNOPSIS
46b32d5faeSChristian BruefferTo compile this driver into the kernel,
47b32d5faeSChristian Bruefferplace the following lines in your
48b32d5faeSChristian Bruefferkernel configuration file:
49b32d5faeSChristian Brueffer.Bd -ragged -offset indent
50b32d5faeSChristian Brueffer.Cd "device uchcom"
51b32d5faeSChristian Brueffer.Cd "device ucom"
52b32d5faeSChristian Brueffer.Ed
53b32d5faeSChristian Brueffer.\".Pp
54b32d5faeSChristian Brueffer.\"Alternatively, to load the driver as a
55b32d5faeSChristian Brueffer.\"module at boot time, place the following line in
56b32d5faeSChristian Brueffer.\".Xr loader.conf 5 :
57b32d5faeSChristian Brueffer.\".Bd -literal -offset indent
58b32d5faeSChristian Brueffer.\"uchcom_load="YES"
59b32d5faeSChristian Brueffer.\".Ed
60b32d5faeSChristian Brueffer.Sh DESCRIPTION
61b32d5faeSChristian BruefferThe
62b32d5faeSChristian Brueffer.Nm
63b32d5faeSChristian Bruefferdriver provides support for the WinChipHead CH341/CH340 USB-to-RS-232
64b32d5faeSChristian BruefferBridge chip.
65b32d5faeSChristian Brueffer.Pp
66b32d5faeSChristian BruefferThe device is accessed through the
67b32d5faeSChristian Brueffer.Xr ucom 4
68b32d5faeSChristian Bruefferdriver which makes it behave like a
69b32d5faeSChristian Brueffer.Xr tty 4 .
70b32d5faeSChristian Brueffer.Sh HARDWARE
71b32d5faeSChristian BruefferThe
72b32d5faeSChristian Brueffer.Nm
73b32d5faeSChristian Bruefferdriver supports the following adapters:
74b32d5faeSChristian Brueffer.Pp
75b32d5faeSChristian Brueffer.Bl -bullet -compact
76b32d5faeSChristian Brueffer.It
77b32d5faeSChristian BruefferHL USB-RS232
78b32d5faeSChristian Brueffer.El
79b32d5faeSChristian Brueffer.Sh SEE ALSO
80b32d5faeSChristian Brueffer.Xr tty 4 ,
81b32d5faeSChristian Brueffer.Xr ucom 4 ,
82b32d5faeSChristian Brueffer.Xr usb 4
83b32d5faeSChristian Brueffer.Sh HISTORY
84b32d5faeSChristian BruefferThe
85b32d5faeSChristian Brueffer.Nm
86b32d5faeSChristian Bruefferdriver first appeared in
87b32d5faeSChristian Brueffer.Nx .
88b32d5faeSChristian BruefferThe first
89b32d5faeSChristian Brueffer.Fx
90b32d5faeSChristian Bruefferrelease to include it was
91b32d5faeSChristian Brueffer.Fx 7.0 .
92b32d5faeSChristian Brueffer.Sh BUGS
93b32d5faeSChristian BruefferActually, this chip seems unable to drive other than 8 data bits and
94b32d5faeSChristian Brueffer1 stop bit line.
95