cz(4) [netbsd man page]

CZ(4)							   BSD Kernel Interfaces Manual 						     CZ(4)

NAME

     cz -- Cyclades-Z series multi-port serial adapter device driver

SYNOPSIS

     cz* at pci? dev ? function ?

DESCRIPTION

     The cz device driver supports the Cyclades-Z series of multi-port serial adapters.  The Cyclades-Z is an intelligent serial controller com-
     prising:

	   o   PLX9060ES PCI bus interface

	   o   Xilinx XC5204 FPGA

	   o   IDT R3052 MIPS CPU

     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.

     The Cyclades-Z comes in three basic flavors:

	   o   Cyclades-8Zo rev. 1 -- This is an older 8-port board with no FPGA.  The serial ports are provided by an octopus cable.

	   o   Cyclades-8Zo rev. 2 -- This is the newer 8-port board.  The serial ports are provided by an octopus cable.

	   o   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 communi-
	       cate with the UARTs in those boxes).

     The Cyclades-Z has several features to improve performance under high serial I/O load:

	   o   The board may operate in interrupt-driven mode or polled mode to reduce interrupt load.

	   o   Each channel has a large input and output buffer.

	   o   Each channel may be programmed to generate an interrupt based on reception of a specific character, e.g. a PPP End-Of-Frame charac-
	       ter.

	   o   The MIPS CPU on the board performs all flow-control handling.

FILES

     /dev/ttyCZnnnn -- dial-in (normal) TTY device
     /dev/dtyCZnnnn -- dial-out TTY device

SEE ALSO

     pci(4), termios(4), tty(4)

HISTORY

     The cz driver first appeared in NetBSD 1.5.

AUTHORS

     The cz driver was written by Jason R. Thorpe <thorpej@zembu.com> and
     Bill Studenmund <wrstuden@zembu.com> of Zembu Labs, Inc.

BUGS

     The cz driver does not currently implement communication via host RAM.  While this may improve performance by reducing the number of PCI mem-
     ory space read/write cycles, it is not straightforward to implement with the current bus_dma(9) API.

     Interrupt mode has not been tested.

     There is no support for reading or writing the EEPROM connected to the PLX PCI bus controller.

BSD
								   May 17, 2000 							       BSD

Info::Layer1::Cyclades(3pm)				User Contributed Perl Documentation			       Info::Layer1::Cyclades(3pm)

NAME

       SNMP::Info::Layer1::Cyclades - SNMP Interface to Cyclades terminal servers

AUTHOR

       Eric Miller

SYNOPSIS

	   #Let SNMP::Info determine the correct subclass for you.

	   my $cyclades = new SNMP::Info(
			       AutoSpecify => 1,
			       Debug	   => 1,
			       # These arguments are passed directly to SNMP::Session
			       DestHost    => 'myswitch',
			       Community   => 'public',
			       Version	   => 2
			       )

	   or die "Can't connect to DestHost.
";

	   my $class = $cyclades->class();
	   print "SNMP::Info determined this device to fall under subclass : $class
";

DESCRIPTION

       Provides abstraction to the configuration information obtainable from a Cyclades device through SNMP.

       For speed or debugging purposes you can call the subclass directly, but not after determining a more specific class using the method above.

       my $cyclades = new SNMP::Info::Layer1::Cyclades(...);

   Inherited Classes
       SNMP::Info::Layer1

   Required MIBs
       CYCLADES-ACS-SYS-MIB
       CYCLADES-ACS-CONF-MIB
       CYCLADES-ACS-INFO-MIB

   Inherited MIBs
       See "Required MIBs" in SNMP::Info::Layer1 for its MIB requirements.

GLOBALS

       These are methods that return scalar value from SNMP

       $cyclades->os_ver()
	   ("cyACSversion")

       $cyclades->serial()
	   ("cyACSDevId")

       $cyclades->root_ip()
	   ("cyEthIPaddr")

       $cyclades->ps1_status()
	   ("cyACSPw1")

       $cyclades->ps2_status()
	   ("cyACSPw2")

   Overrides
       $cyclades->layers()
	   Returns 01000001.  These devices don't have a FDB and we probably don't want to poll for an ARP cache so turn off reported Layer 2 and
	   Layer 3.

       $cyclades->vendor()
	   Returns 'cyclades'

       $cyclades->os()
	   Returns 'cyclades'

       $cyclades->model()
	   Returns lower case ("cyACSpname")

   Globals imported from SNMP::Info::Layer1
       See "GLOBALS" in SNMP::Info::Layer1 for details.

TABLE METHODS

       These are methods that return tables of information in the form of a reference to a hash.

   Overrides
       $cyclades->i_index()
	   Returns reference to map of IIDs to Interface index.

	   Extended to include serial ports.  Serial ports are indexed with the alternative labeling system for the serial port, the listening
	   socket port "cySPortSocketPort" to avoid conflicts with "ifIndex".

       $cyclades->interfaces()
	   Returns reference to map of IIDs to physical ports.	Extended to include serial ports, "cyISPortTty".

       $cyclades->i_speed()
	   Returns interface speed.  Extended to include serial ports, "cyISPortSpeed".

       $cyclades->i_up()
	   Returns link status for each port.  Extended to include serial ports, "cyISPortSigCD".

       $cyclades->i_description()
	   Returns description of each port.  Extended to include serial ports, "cyISPortName".

       $cyclades->i_name()
	   Returns name of each port.  Extended to include serial ports, "cyISPortName".

   Table Methods imported from SNMP::Info::Layer1
       See "TABLE METHODS" in SNMP::Info::Layer1 for details.

perl v5.12.4							    2011-09-28					       Info::Layer1::Cyclades(3pm)