|
Vx/IP-MPSerial &
Vx/IPUniversalSerial Features Summary
copyright (c)1996
Compware Corp
Vx/IP-MPSerial &
Vx/IP-UnivSerial are vxWorks device driver packages for the SBS/Greenspring
IP-MultiProtocol Serial (IP-MPSER) and IP-UniversalSerial (IP-USER)
Industry Pack devices.
The two packages being
quite similar, this document will address both while noting specific
differences.
The main differences
in hardware features concern: IP-DMA capability of the IP-MPSER, lacking in
the IP-USER; more complete clocking options available with the IP-MPSER,
though both provide the capability of installing two oscillators; and
additional handshaking/flow-control signals available with the IP-MPSER. Compware
Corp. is able to supply the IP-MPSER and IP-UnivSer Industry Pack's
installed and tested with custom oscillators.
Vx/IP-MPSER/USER
supports up to (8) Industry Packs (may be configured for more IP's).
Industry Packs may be installed on a Motorola MVME162 or GreenSpring VME
Industry Pack carrier. A number of utilities and test application modules
(which are used with the Vx/IP-MPSER/USER driver) are provided in source
form. All software modules are written in ANSI "C".
Both the IPMPSER and
IPUSER Industry Packs use the Zilog Universal Serial z16c30 chip; each IP
contains (1) z16C30 for 2 channels of serial i/o. Vx/IP-MPSER/USER
distinguishes the 2 Industry Pack types. With Vx/IP-MPSER/USER, non-DMA
asynchronous/isochronous i/o is supported at baud rates up to 625
Kbaud(25MHz 68040) or 900 Kbaud(32MHz 68040). Utilizing IP-DMA (MVME162
only), IP-MPSER has demonstrated operation at up to 10-Mbit rates.
Optional extensions to
support a variety of synchronous protocols include SDLC, and BiSync, with
support for additional standard and custom protocols planned.
A hardware-independent
"portOptions" structure is available to specify asynchronous,
isochronous and synchronous options for the receiver and transmitter of
each channel.Baud rate, line drivers (232/422), parity options, data bits,
stop bits and other parameters may be specified. Options may be
"split" (dissimilar) for receiver and transmitter of a port if
desired. Utilities and internal defaults make specification of ordinary
(including split) serial port asynchronous and isochronous configurations
exceedingly straightforward.
The lines DCD, RTS ,
CTS, and DTR are available for flow control or general input/output usage.
If flow control is selected (in "portOptions") selected lines
will be dedicated as such. Flow control options may be split between the
receiver and transmitter of a serial port. Lines not dedicated to flow
control may be used as incoming or outgoing general control lines. DTR and
RTS are driven- DCD and CTS are received. These lines are brought to the
Industry Pack I/O header and may be rerouted using terminal blocks, null
modems or similar equipment.
Vx/IPMPSER/USER
provided initialization entry points:
zUSerDrv initialize
and install driver in vxWorks.
zUSerPackRegister
locate and verify IPMPSER or IPUSER hardware, register pack number.
zUSerDevCreate create
another IPMPSER/USER device, mapped to a particular channel (A/B) on a
particular IP. Serial port, DMA and other internal driver options are
specified.
Vx/IPMPSER/USER
supported i/o operations:
open provide process
handle for IPMPSER/USER device.
read return some
number of available bytes from receiver of IPMPSER/USER device.
write write bytes to
internal transmit buffer of IPMPSER/USER device.
close release process
handle of IPMPSER/USER device.
Vx/IPMPSER/USER
supported control operations (ioctls):
IPDRV_INFO return
general information block for IPMPSER/USER driver
IPPACK_INFO return
information block for IP/MPSER(USER) Industry Pack
IPDEV_INFO return
information block for IPMPSER device
FIORCVERR return most
recent receiver errors- parity error, framing error
FIOBAUDRATE change
transmitter and receiver serial port baud rate
FIOSETRPORT change
receiver serial port options
FIOSETXPORT change
transmitter serial port options
FIONREAD return number
of bytes of receiver data currently buffered
FIONWRITE return
number of bytes of space in transmitter buffer
FIOWFLUSH flush all
internally buffered transmitter data
FIORFLUSH flush all
internally buffered receiver data
FIOFLUSH flush all
internally buffered receiver and transmitter data
FIOSETPORT change
transmitter and receiver serial port options
FIOGETRPORT report
receiver serial port options
FIOGETXPORT report
transmitter serial port options
FIOWEMPTY wait for all
transmitter data to be sent on serial lines
FIOOUTLINESWRITE
change setting of outgoing general lines
FIOOUTLINESREAD report
last written setting of outgoing general lines
FIOINLINESREAD report
instantaneous state of incoming general lines
FIOINTLINESWAIT wait
for transitions of incoming general lines
FIOTESTCLOCK measure
frequency of incoming/outgoing or internal clocks
FIOCHANGECREATEOPTIONS
change DMA and other driver internal options
Vx/IPMPSER/USER
integration support features:
zUSerShow display
registered packs and devices with general driver information
zUSerPackShow display
information for a single IPMPSER/USER Industry Pack
zUSerDevShow display
information for a single IP/MPSER/USER device
The module
"zUSerUtils.c" provides basic support utilities for Vx/IP-MPSER/USER.
Utilities:
basicPortOptions,
isocPortOptions, loopPortOptions, basicCreateOptions, and DMACreateOptions
are available for serial port configuration and configuration of DMA and
other driver internal options.
The testClock utility
invokes the ioctl FIOTESTCLOCK to measure clocking frequencies. Eight test
applications are also provided in source form.
|
