MirOS Manual: magma(4)

MAGMA(4)               BSD Programmer's Manual (SPARC)                MAGMA(4)

NAME

     magma - Magma Sp Serial/Parallel board device driver

SYNOPSIS

     magma? at sbus? slot ? offset ?
     mtty? at magma?
     mbpp? at magma?

DESCRIPTION

     This driver provides an interface to Magma LC2+1Sp, 2+1Sp, 4+1Sp, 8+2Sp,
     4Sp, 8Sp, 12Sp, 16Sp, 1P, 2P, and 2+1HS boards. These boards are based
     around the Cirrus Logic CD1400 serial/parallel communications engine and
     the Cirrus Logic CD1190 parallel communications engine.

     The device minor numbers for this driver are encoded as follows:

         +---+---+---+---+---+---+---+---+
         | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
         +---+---+---+---+---+---+---+---+
           |   |   |   |   |   |   |   |
           |   |   |   |   +---+---+---+---> port number
           |   |   |   |
           |   |   |   +-------------------> dial-out (on tty ports)
           |   |   |
           |   |   +-----------------------> unused
           |   |
           +---+---------------------------> card number

     Up to four cards are supported in the system.

     All tty ports have full automatic hardware (RTS/CTS) flow control avail-
     able and a 12 byte FIFO on the chip in each direction so errors should be
     minimal.

FILES

     /dev/tty[0-3][0-a]  Serial ports
     /dev/bpp[0-3][0-1]  Parallel ports

DIAGNOSTICS

     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. If need be you can make the
     ring buffer bigger by changing the MAGMA_RBUF_SIZE #define to something
     bigger, but it should be a multiple of two.

     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. Reducing the value of either the
     MTTY_RX_FIFO_THRESHOLD or MTTY_RX_DTR_THRESHOLD #define's to something
     smaller may help slow machines avoid this problem.

SEE ALSO

     intro(4), sbus(4), tty(4)

HISTORY

     The driver was loosely based upon the cy(4) Cyclades Cyclom device driver
     written by Andrew Herbert and Timo Rossi.

AUTHORS

     The driver was written by Iain Hibbert <plunky@skate.demon.co.uk>

TODO

     CD1190 parallel support.
     bpp input.

     Dial-out (cua) devices are not yet supported.

     mdmbuf is unsupported.

     Automatic XON/XOFF handshaking could be implemented fairly easily.

     It would be good if the tty port waited for the FIFO to empty before al-
     lowing a close, so that I could turn off the channel interrupts at that
     time. It can be done.

MirOS BSD #10-current           April 21, 1998                               1

Generated on 2013-09-18 04:33:42 by $MirOS: src/scripts/roff2htm,v 1.77 2013/01/01 20:49:09 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2013 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.