[unix-history] / share / man / man4 / man4.i386 / sio.4

.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" the Systems Programming Group of the University of Utah Computer
.\" Science Department.
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     from: @(#)dca.4	5.2 (Berkeley) 3/27/91
.\"	from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
.\"	$Id$
.\"
.Dd August 28, 1993
.Dt SIO 4 i386
.Os FreeBSD
.Sh NAME
.Nm sio
.Nd
fast interrupt serial communications interface
.Sh SYNOPSIS
.Cd "device sio0 at isa? port" \&"IO_COM1\&" tty irq 4 vector siointr
.Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 vector siointr
.Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 vector siointr
.Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 vector siointr
.Sh DESCRIPTION
The
.Nm sio
driver provides support for NS8250-, NS16450-, and NS16550-based
.Tn EIA
.Tn RS-232C
.Pf ( Tn CCITT
.Tn V.28 )
communications interfaces.  The NS8250 and NS16450 have single character
buffers, and the NS16550 has a 16 character buffer.
.Pp
Input and output for each line may set to one of following baud rates;
50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
19200, 38400, 57600, or 115200.
.Sh FILES
.Bl -tag -width Pa
.It Pa /dev/tty00
.It Pa /dev/tty01
.El
.Sh DIAGNOSTICS
.Bl -diag
.It sio%d: silo overflow.
The single-character input
.Dq silo
has overflowed and incoming data has been lost.
.\".It com%d: weird interrupt: %x.
.\"The device has generated an unexpected interrupt
.\"with the code listed.
.El
.Sh SEE ALSO
.Xr tty 4
.Xr com 4
.Sh HISTORY
The
.Nm
driver is derived from the
.Nm HP9000/300
.Nm dca
driver and is
.Ud
.Sh BUGS
Data loss is not near as likely on busy systems as they are with the
.Xr com 4
driver but they still can occur at very high baud rates on slow systems.
.Pp
The constants which define the locations
of the various seiral ports are holdovers from
.Nm DOS .
.Pp
As usual, you get what you pay for; cheap NS16550 clones
generally don't work.
Commit	Line	Data
52ac9c69 RG	1	.\" Copyright (c) 1990, 1991 The Regents of the University of California.
	2	.\" All rights reserved.
	3	.\"
	4	.\" This code is derived from software contributed to Berkeley by
	5	.\" the Systems Programming Group of the University of Utah Computer
	6	.\" Science Department.
	7	.\" Redistribution and use in source and binary forms, with or without
	8	.\" modification, are permitted provided that the following conditions
	9	.\" are met:
	10	.\" 1. Redistributions of source code must retain the above copyright
	11	.\" notice, this list of conditions and the following disclaimer.
	12	.\" 2. Redistributions in binary form must reproduce the above copyright
	13	.\" notice, this list of conditions and the following disclaimer in the
	14	.\" documentation and/or other materials provided with the distribution.
	15	.\" 3. All advertising materials mentioning features or use of this software
	16	.\" must display the following acknowledgement:
	17	.\" This product includes software developed by the University of
	18	.\" California, Berkeley and its contributors.
	19	.\" 4. Neither the name of the University nor the names of its contributors
	20	.\" may be used to endorse or promote products derived from this software
	21	.\" without specific prior written permission.
	22	.\"
	23	.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
	24	.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	25	.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	26	.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
	27	.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	28	.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	29	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	30	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	31	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	32	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	33	.\" SUCH DAMAGE.
	34	.\"
	35	.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91
	36	.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
	37	.\" $Id$
	38	.\"
	39	.Dd August 28, 1993
	40	.Dt SIO 4 i386
	41	.Os FreeBSD
	42	.Sh NAME
	43	.Nm sio
	44	.Nd
	45	fast interrupt serial communications interface
	46	.Sh SYNOPSIS
	47	.Cd "device sio0 at isa? port" \&"IO_COM1\&" tty irq 4 vector siointr
	48	.Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 vector siointr
	49	.Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 vector siointr
	50	.Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 vector siointr
	51	.Sh DESCRIPTION
	52	The
	53	.Nm sio
	54	driver provides support for NS8250-, NS16450-, and NS16550-based
	55	.Tn EIA
	56	.Tn RS-232C
	57	.Pf ( Tn CCITT
	58	.Tn V.28 )
	59	communications interfaces. The NS8250 and NS16450 have single character
	60	buffers, and the NS16550 has a 16 character buffer.
	61	.Pp
	62	Input and output for each line may set to one of following baud rates;
	63	50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
	64	19200, 38400, 57600, or 115200.
65	.Sh FILES
66	.Bl -tag -width Pa
67	.It Pa /dev/tty00
68	.It Pa /dev/tty01
69	.El
70	.Sh DIAGNOSTICS
71	.Bl -diag
72	.It sio%d: silo overflow.
73	The single-character input
74	.Dq silo
75	has overflowed and incoming data has been lost.
76	.\".It com%d: weird interrupt: %x.
77	.\"The device has generated an unexpected interrupt
78	.\"with the code listed.
79	.El
80	.Sh SEE ALSO
81	.Xr tty 4
82	.Xr com 4
83	.Sh HISTORY
84	The
85	.Nm
86	driver is derived from the
87	.Nm HP9000/300
88	.Nm dca
89	driver and is
90	.Ud
91	.Sh BUGS
92	Data loss is not near as likely on busy systems as they are with the
93	.Xr com 4
94	driver but they still can occur at very high baud rates on slow systems.
95	.Pp
96	The constants which define the locations
97	of the various seiral ports are holdovers from
98	.Nm DOS .
99	.Pp
100	As usual, you get what you pay for; cheap NS16550 clones
101	generally don't work.