129 lines
4.4 KiB
Groff
129 lines
4.4 KiB
Groff
.\" $NetBSD: magma.4,v 1.5 2001/04/11 19:11:29 wiz Exp $
|
|
.\"
|
|
.\" Copyright (c) 1998 Iain Hibbert
|
|
.\" All rights reserved.
|
|
.\" 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 Iain Hibbert
|
|
.\" 4. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
|
|
.\"
|
|
.Dd April 21, 1998
|
|
.Dt MAGMA 4 sparc
|
|
.Sh NAME
|
|
.Nm magma
|
|
.Nd
|
|
Magma Sp Serial/Parallel board device driver
|
|
.Sh SYNOPSIS
|
|
.Cd "magma* at sbus? slot ? offset ?"
|
|
.Cd "mtty* at magma?"
|
|
.Cd "mbpp* at magma?"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
driver provides an interface to Magma LC2+1Sp, 2+1Sp, 4+1Sp, 8+2Sp,
|
|
4Sp, 8Sp, 12Sp, 16Sp, 1P and 2P boards.
|
|
These boards are based around the Cirrus Logic CD1400 serial/parallel
|
|
communications engine and the Cirrus Logic CD1190 parallel
|
|
communications engine.
|
|
.Pp
|
|
The device minor numbers for this driver are encoded as follows:
|
|
.Pp
|
|
.Bd -literal
|
|
+---+---+---+---+---+---+---+---+
|
|
| 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
|
|
+---+---+---+---+---+---+---+---+
|
|
| | | | | | | |
|
|
| | | | +---+---+---+---> port number
|
|
| | | |
|
|
| | | +-------------------> dialout (on tty ports)
|
|
| | |
|
|
| | +-----------------------> unused
|
|
| |
|
|
+---+---------------------------> card number
|
|
.Ed
|
|
.Pp
|
|
Up to four cards are supported in the system.
|
|
.Pp
|
|
All tty ports have full automatic hardware (RTS/CTS) flow control available
|
|
and a 12 byte FIFO on the chip in each direction so errors should be minimal.
|
|
.Sh DIAGNOSTICS
|
|
.Bl -diag
|
|
.It "mtty%d%x: ring buffer overflow"
|
|
Incoming characters have been discarded due to a buffer overflow.
|
|
This is caused by the process in control of the device not reading
|
|
characters fast enough.
|
|
.Pp
|
|
If need be you can make the ring buffer bigger by changing the
|
|
.Dv MAGMA_RBUF_SIZE
|
|
#define to something bigger, but it should be a multiple
|
|
of two.
|
|
.It "mtty%d%x: fifo overflow"
|
|
Incoming characters have been discarded due to a CD1400 channel overrun.
|
|
This is caused by interrupts not being serviced sufficiently quickly
|
|
to prevent the 12 byte receive FIFO on a serial channel from overflowing.
|
|
.Pp
|
|
Reducing the value of either the
|
|
.Dv MTTY_RX_FIFO_THRESHOLD
|
|
or
|
|
.Dv MTTY_RX_DTR_THRESHOLD
|
|
#define's to something smaller may help slow machines avoid this problem.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width /dev/bpp[0-3][0-1] -compact
|
|
.It Pa /dev/tty[0-3][0-a]
|
|
Serial ports
|
|
.It Pa /dev/bpp[0-3][0-1]
|
|
Parallel ports
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr read 2 ,
|
|
.Xr termios 4 ,
|
|
.Xr tty 4
|
|
.Sh AUTHORS
|
|
The driver was written by Iain Hibbert
|
|
.Aq plunky@skate.demon.co.uk
|
|
.Sh HISTORY
|
|
The driver was loosely based upon the
|
|
.Xr cy 4
|
|
Cyclades Cyclom device driver written
|
|
by Andrew Herbert and Timo Rossi.
|
|
.Sh TO DO
|
|
CD1190 parallel support.
|
|
.Pp
|
|
.Qq bpp
|
|
input.
|
|
.Pp
|
|
Dialout (cua) devices are not yet supported.
|
|
.Pp
|
|
.Qq mdmbuf
|
|
is unsupported (see
|
|
.Xr tty 4
|
|
and
|
|
.Xr termios 4 ) .
|
|
.Pp
|
|
Automatic XON/XOFF handshaking could be implemented fairly easily.
|
|
.Pp
|
|
It would be good if the tty port waited for the FIFO to empty before allowing
|
|
a close, so that I could turn off the channel interrupts at that time.
|
|
It can be done.
|