xref: /netbsd/share/man/man4/tcom.4 (revision bf9ec67e)
1.\"     $NetBSD: tcom.4,v 1.5 2001/09/22 16:36:22 wiz Exp $
2.\"
3.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Eric S. Hvozda.
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. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgement:
19.\"        This product includes software developed by the NetBSD
20.\"        Foundation, Inc. and its contributors.
21.\" 4. Neither the name of The NetBSD Foundation nor the names of its
22.\"    contributors may be used to endorse or promote products derived
23.\"    from this software without specific prior written permission.
24.\"
25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.\"
38.\" Copyright (c) 1990, 1991 The Regents of the University of California.
39.\" All rights reserved.
40.\"
41.\" This code is derived from software contributed to Berkeley by
42.\" the Systems Programming Group of the University of Utah Computer
43.\" Science Department.
44.\" Redistribution and use in source and binary forms, with or without
45.\" modification, are permitted provided that the following conditions
46.\" are met:
47.\" 1. Redistributions of source code must retain the above copyright
48.\"    notice, this list of conditions and the following disclaimer.
49.\" 2. Redistributions in binary form must reproduce the above copyright
50.\"    notice, this list of conditions and the following disclaimer in the
51.\"    documentation and/or other materials provided with the distribution.
52.\" 3. All advertising materials mentioning features or use of this software
53.\"    must display the following acknowledgement:
54.\"	This product includes software developed by the University of
55.\"	California, Berkeley and its contributors.
56.\" 4. Neither the name of the University nor the names of its contributors
57.\"    may be used to endorse or promote products derived from this software
58.\"    without specific prior written permission.
59.\"
60.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
61.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
62.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
63.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
64.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
65.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
66.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
67.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
68.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
69.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
70.\" SUCH DAMAGE.
71.\"
72.\"     from: @(#)dca.4	5.2 (Berkeley) 3/27/91
73.\"	from: Id: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
74.\"
75.Dd May 20, 1998
76.Dt TCOM 4
77.Os
78.Sh NAME
79.Nm tcom
80.Nd
81multiplexing serial communications interface
82.Sh SYNOPSIS
83For 4-port TC-400 series boards:
84.Pp
85.Cd "tcom0 at isa? port 0x100 irq 5"
86.Cd "com2 at tcom? slave ?"
87.Cd "com3 at tcom? slave ?"
88.Cd "com4 at tcom? slave ?"
89.Cd "com5 at tcom? slave ?"
90.Pp
91For 8-port TC-800 series boards:
92.Pp
93.Cd "tcom0 at isa? port 0x100 irq 5"
94.Cd "com2 at tcom? slave ?"
95.Cd "com3 at tcom? slave ?"
96.Cd "com4 at tcom? slave ?"
97.Cd "com5 at tcom? slave ?"
98.Cd "com6 at tcom? slave ?"
99.Cd "com7 at tcom? slave ?"
100.Cd "com8 at tcom? slave ?"
101.Cd "com9 at tcom? slave ?"
102.Sh DESCRIPTION
103The
104.Nm tcom
105driver provides support for the Byte Runner Technologies TC-400
106and TC-800 series boards that multiplex together up to four or eight
107.Tn EIA
108.Tn RS-232C
109.Pf ( Tn CCITT
110.Tn V.28 )
111communications interfaces.
112.Pp
113Each
114.Nm
115device is the master device for up to eight
116.Nm com
117devices.  The kernel configuration specifies these
118.Nm com
119devices as slave devices of the
120.Nm
121device, as shown in the synopsis.  The slave ID given for each
122.Nm com
123device determines which bit in the interrupt multiplexing register is
124tested to find interrupts for that device.
125The
126.Tn port
127specification for the
128.Nm
129device is used to compute the base addresses for the
130.Nm com
131subdevices and the port for the interrupt multiplexing register.
132.Pp
133Not all possible configuration options are currently supported (for
134example, speeds beyond 115200 baud are not currently supported).
135.Sh FILES
136.Bl -tag -width Pa
137.It Pa /dev/tty??
138.El
139.Sh SEE ALSO
140.Xr com 4
141.Sh HISTORY
142The
143.Nm
144driver was written by Jukka Marin.
145