vsxb(7) DG/UX 5.4R3.00 vsxb(7)
NAME
vsxb - VME Streams Cross Bus Driver
SYNOPSIS
vsxb([vmebus])
vsxb([vmebus,]configurationnumber)
vsxb@devicecode([vmebus,]VMEaddress)
DESCRIPTION
The vsxb driver provides the interface to the VSC/3i synchronous
controller boards. To support VSC/3i synchronous controllers, you
must specify the VME streams cross bus driver (vsxb) in the system
configuration file prior to building the DG/UX kernel.
The three formats of the vsxb system file entry are as follows:
Default: vsxb([vmebus])
Shorthand: vsxb([vmebus,]configurationnumber)
Fully qualified: vsxb@devicecode([vmebus,]VMEaddress)
The vsxb requires the devicecode and VMEaddress to configure
properly. The fully qualified format is used to explicitly assign
the devicecode and VME address to the VSC/3i controller to be
configured. The default and shorthand versions of the system file
entry derive this information from the table listed below.
Configuration 0 is the default system file entry.
Configuration Device Code VME Address
0 90 E3400000
1 91 E3410000
2 92 E3420000
3 93 E3430000
4 94 E3440000
5 95 E3450000
6 96 E3460000
7 97 E3470000
8 98 E3480000
9 99 E3490000
A 9A E34A0000
B 9B E34B0000
C 9C E34C0000
D 9D E34D0000
E 9E E34E0000
F 9F E34F0000
The device code and VME address must match the jumpering on the
VSC/3i controller. vmebus is the device name of the parent VME bus
to which the VSC/3i controller is attached, such as vme(0) or vme(1).
If this parameter is omitted, a parent bus of vme(0) is assumed, and
all subsequent parameters move up one position. Thus, vsxb(vme(0),1)
is equivalent to vsxb(1). For more information concerning device
configuration, refer to "Writing a Device Driver" in Programming in
the DG/UX Kernel Environment.
Licensed material--property of copyright holder(s) 1
vsxb(7) DG/UX 5.4R3.00 vsxb(7)
For each vsxb system file entry, five i-nodes in /dev are created as
the vsxb devices are configured: one for direct vsxb access, one
clone device, and one for each of the three I/O ports on the VSC/3i.
The /dev i-nodes used for direct vsxb access have the format vsxbcc,
where cc is the assigned controller number. The controller number is
assigned according to the order that the vsxb system file entries
appear in the system file. Thus, the first vsxb entry is controller
01, the second entry is controller 02, and so on. This vsxb direct
access device is used for VSC/3i controller management such as
loading and dumping the controller. Only one open to this device is
permitted at a time.
The vsxb also creates a clone device i-node with the format vsxbscc,
where cc is the assigned controller number. The clone device can be
used for line management functions such as statistics manipulation
and line configuration. I/O messages will not be processed on a
clone device. The clone device supports multiple opens. The number
of opens supported by the clone device is a system file parameter.
The /dev i-nodes used for I/O have the format vsxbccu, where cc is a
2 digit controller number and u is the unit number. The unit number
specifies a specific communications port on the VSC/3i controller.
Line management functions that are allowed on the clone device may
also be sent on these I/O devices. Each I/O device supports only one
open at a time.
In conjunction with the vsxb system file entries, the following
system file variables are used by the vsxb at configuration time.
Alias Name System file parameter
VSXBCLONES cfvsxbtotalclones
VSXBB0CNT cfvsxbclass0buffercount
VSXBB1CNT cfvsxbclass1buffercount
VSXBB2CNT cfvsxbclass2buffercount
VSXBB3CNT cfvsxbclass3buffercount
VSXBB4CNT cfvsxbclass4buffercount
VSXBB5CNT cfvsxbclass5buffercount
VSXBB6CNT cfvsxbclass6buffercount
VSXBB7CNT cfvsxbclass7buffercount
VSXBB0SZ cfvsxbclass0buffersize
VSXBB1SZ cfvsxbclass1buffersize
VSXBB2SZ cfvsxbclass2buffersize
VSXBB3SZ cfvsxbclass3buffersize
VSXBB4SZ cfvsxbclass4buffersize
VSXBB5SZ cfvsxbclass5buffersize
VSXBB6SZ cfvsxbclass6buffersize
VSXBB7SZ cfvsxbclass7buffersize
VSXBQS cfvsxbnumberqpairs
VSXBSTRS cfvsxbnumberstreams
VSXBMBS cfvsxbnumbermblocks
VSXBBCS cfvsxbnumberbcalls
VSXBTOS cfvsxbnumbertimeouts
VSXBLOW cfvsxblowprioritypercent
Licensed material--property of copyright holder(s) 2
vsxb(7) DG/UX 5.4R3.00 vsxb(7)
VSXBMED cfvsxbmedprioritypercent
VSXBWSTR cfvsxbnumberwritexbusstructures
VSXBRSTR cfvsxbnumberreadxbusstructures
VSXBCLONES (alias for cfvsxbtotalclones) is the total number of
vsxb() clone devices that may exist per controller.
VSXBB0CNT (alias for cfvsxbclass0buffercount) is the number of
streams buffers of class0 for the onboard VSXBC environment.
VSXBB1CNT (alias for cfvsxbclass1buffercount) is the number of
streams buffers of class1 for the onboard VSXBC environment.
VSXBB2CNT (alias for cfvsxbclass2buffercount) is the number of
streams buffers of class2 for the onboard VSXBC environment.
VSXBB3CNT (alias for cfvsxbclass3buffercount) is the number of
streams buffers of class3 for the onboard VSXBC environment.
VSXBB4CNT (alias for cfvsxbclass4buffercount) is the number of
streams buffers of class4 for the onboard VSXBC environment.
VSXBB5CNT (alias for cfvsxbclass5buffercount) is the number of
streams buffers of class5 for the onboard VSXBC environment.
VSXBB6CNT (alias for cfvsxbclass6buffercount) is the number of
streams buffers of class6 for the onboard VSXBC environment.
VSXBB7CNT (alias for cfvsxbclass7buffercount) is the number of
streams buffers of class7 for the onboard VSXBC environment.
VSXBB0SZ (alias for cfvsxbclass0buffersize) is the size of
streams buffers in class0 for the onboard VSXBC environment.
VSXBB1SZ (alias for cfvsxbclass1buffersize) is the size of
streams buffers in class1 for the onboard VSXBC environment.
VSXBB2SZ (alias for cfvsxbclass2buffersize) is the size of
streams buffers in class2 for the onboard VSXBC environment.
VSXBB3SZ (alias for cfvsxbclass3buffersize) is the size of
streams buffers in class3 for the onboard VSXBC environment.
VSXBB4SZ (alias for cfvsxbclass4buffersize) is the size of
streams buffers in class4 for the onboard VSXBC environment.
VSXBB5SZ (alias for cfvsxbclass5buffersize) is the size of
streams buffers in class5 for the onboard VSXBC environment.
VSXBB6SZ (alias for cfvsxbclass6buffersize) is the size of
streams buffers in class6 for the onboard VSXBC environment.
VSXBB7SZ (alias for cfvsxbclass7buffersize) is the size of
streams buffers in class7 for the onboard VSXBC environment.
Licensed material--property of copyright holder(s) 3
vsxb(7) DG/UX 5.4R3.00 vsxb(7)
VSXBQS (alias for cfvsxbnumberqpairs) is the number of streams
queue pairs in the onboard VSXBC environment.
VSXBSTRS (alias for cfvsxbnumberstreams) is the number of streams
in the onboard VSXBC environment.
VSXBMBS (alias for cfvsxbnumbermblocks) is the number of mblocks
in the onboard VSXBC environment.
VSXBBCS (alias for cfvsxbnumberbcalls) is the number of bufcalls
allowed at one time in the onboard VSXBC environment.
VSXBTOS (alias for cfvsxbnumbertimeouts) is the number of
timeouts allowed at one time in the onboard VSXBC environment.
VSXBLOW (alias for cfvsxblowprioritypercent) is the percentage
of streams buffers permitted to be used for low priority allocb()
calls.
VSXBMED (alias for cfvsxbmedprioritypercent) is the percentage
of streams buffers permitted to be used for medium priority allocb()
calls.
VSXBWSTR (alias for cfvsxbnumberwritexbusstructures) is the
number of write side crossbus structures per communication stream.
VSXBRSTR (alias for cfvsxbnumberreadxbusstructures) is the
number of read side crossbus structures per communication stream.
The system file parameters affect all vsxb devices configured on a
system.
EXAMPLES
The following four system file entries are equivalent.
vsxb()
vsxb(0)
vsxb@90(E3400000)
vsxb@90(vme(0),E3400000)
If any one of these entries appears in the system file, the vsxb
creates the following i-node entries at configuration time:
/dev/vsxb01 vsxb access device (for VSC/3i management)
/dev/vsxbs01 vsxb clone device (for line management)
/dev/vsxb010 vsxb port A I/O device (for port A I/O)
/dev/vsxb011 vsxb port B I/O device (for port B I/O)
/dev/vsxb012 vsxb port C I/O device (for port C I/O)
SEE ALSO
iscd(7), ssid(7), vme(7), syncadm(1M), synccheck(1M), wanadm(1M).
Licensed material--property of copyright holder(s) 4
vsxb(7) DG/UX 5.4R3.00 vsxb(7)
NOTES
External Interfaces
The vsxb supports the following external interfaces:
+----------+------------+------------+
|Interface | Electrical | Physical |
+----------+------------+------------+
|RS-232 | RS-232 | DB25 |
|V.35 | V.35 | Winchester |
|RS-530 | RS-442 | DB25 |
|RS-449 | RS-422 | DB37 |
|X.21 | RS-422 | DB15 |
+----------+------------+------------+
Baud Rates
The vsxb driver supports internally generated baud rates from
2400 bps to 64000 bps. In addition to the internal baud rates
listed above, the vsxb will accept any external clock data
rate up to 64000 bps.
Buffer Restrictions
The maximum frame size can not exceed 4109 bytes.
Licensed material--property of copyright holder(s) 5