diff options
| -rw-r--r-- | share/man/man4/cz.4 | 129 |
1 files changed, 129 insertions, 0 deletions
diff --git a/share/man/man4/cz.4 b/share/man/man4/cz.4 new file mode 100644 index 00000000000..1bc95d911e0 --- /dev/null +++ b/share/man/man4/cz.4 @@ -0,0 +1,129 @@ +.\" $OpenBSD: cz.4,v 1.1 2001/06/21 13:37:58 nate Exp $ +.\" $NetBSD: cz.4,v 1.3 2001/06/12 14:46:11 wiz Exp $ +.\" +.\" Copyright (c) 2000 Zembu Labs, Inc. +.\" All rights reserved. +.\" +.\" Author: Jason R. Thorpe <thorpej@zembu.com> +.\" +.\" 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 Zembu Labs, Inc. +.\" 4. Neither the name of Zembu Labs nor the names of its employees may +.\" be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY ZEMBU LABS, INC. ``AS IS'' AND ANY EXPRESS +.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WAR- +.\" RANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DIS- +.\" CLAIMED. IN NO EVENT SHALL ZEMBU LABS 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 May 17, 2000 +.Dt CZ 4 +.Os +.Sh NAME +.Nm cz +.Nd Cyclades-Z series multi-port serial adapter device driver +.Sh SYNOPSIS +.Cd "cz* at pci? dev ? function ?" +.Sh DESCRIPTION +The +.Nm +device driver supports the Cyclades-Z series of multi-port serial adapters. +The Cyclades-Z is an intelligent serial controller comprising: +.Bl -bullet -offset indent +.It +PLX9060ES PCI bus interface +.It +Xilinx XC5204 FPGA +.It +IDT R3052 MIPS CPU +.El +.Pp +The MIPS CPU runs firmware provided by the device driver. Communication +with the MIPS is performed by modifying data structures located in board +local RAM or host RAM. +.Pp +The Cyclades-Z comes in three basic flavors: +.Bl -bullet -offset indent +.It +Cyclades-8Zo rev. 1 -- This is an older 8-port board with no FPGA. The +serial ports are provided by an octopus cable. +.It +Cyclades-8Zo rev. 2 -- This is the newer 8-port board. The serial ports +are provided by an octopus cable. +.It +Cyclades-Ze -- This is the expandable version of the Cyclades-Z. It uses +an HD-50 SCSI cable to connect the board to a 1U rack mountable serial +expansion box. Each box has 16 RJ45 serial ports, and up to 4 boxes may +be chained together, for a total of 64 ports. Boxes 3 and 4 require their +own external power supply, otherwise the firmware will refuse to start +(as it cannot communicate with the UARTs in those boxes). +.El +.Pp +The Cyclades-Z has several features to improve performance under +high serial I/O load: +.Bl -bullet -offset indent +.It +The board may operate in interrupt-driven mode or polled mode to reduce +interrupt load. +.It +Each channel has a large input and output buffer. +.It +Each channel may be programmed to generate an interrupt based on +reception of a specific character, e.g. a PPP End-Of-Frame character. +.It +The MIPS CPU on the board performs all flow-control handling. +.El +.Sh FILES +.Bl -tag -width Pa -compact +.It Pa /dev/ttyZ?? -- dial-in (normal) TTY device +.It Pa /dev/cuaZ?? -- dial-out TTY device +.El +.\" .Sh DIAGNOSTICS +.\" XXX too be done. +.Sh SEE ALSO +.Xr pci 4 , +.Xr tty 4 , +.Xr termios 4 +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 1.5 . +.Sh BUGS +The +.Nm +driver does not currently implement communication via host RAM. While +this may improve performance by reducing the number of PCI memory +space read/write cycles, it is not straightforward to implement with +the current +.Xr bus_dma 9 +API. +.Pp +Interrupt mode has not been tested. +.Pp +There is no support for reading or writing the EEPROM connected to +the PLX PCI bus controller. +.Sh AUTHOR +The +.Nm +driver was written by +.An Jason R. Thorpe Aq thorpej@zembu.com +and +.An Bill Studenmund Aq wrstuden@zembu.com +of Zembu Labs, Inc. |