N2SETUP(8) BSD System Manager's Manual N2SETUP(8)NAMEn2setup - configure SDL Communications RISCom/N2 family of interfaces
SYNOPSISn2setup [-u unit-number] [input-file]
DESCRIPTION
The RICScom/N2 family of communications controllers (see also ntwo(4))
are dual channel interface controllers. There are three major variations
on the RISCom/N2 communications interface. The first is referred herein
to as a N2 card. This card has two up to T1 DSU ports. There is a single
interface version of this board where the second interface has been de-
populated. This board still appears as a dual interface board, but only
the first channel is functional. With utilities such as netstat(1) the
second channel will still appear. If there are multiple RISCom/N2 boards
in a system these non-functional channels will show up were the second
channels would appear if it were there. Since only the receivers and
transmitters are missing it is even possible to ifconfig(8) one of these
channels up.
The second version (referred herein to has a N2csu) is similar to the
standard N2 except that the second channel on the board has a built in T1
CSU.
The third version (referred herein to as a N2dds) is also similar to the
standard N2 except that the second channel on the board as a built in 56K
CSU.
The only option available is -u. The unit-number argument specifies which
ntwo(4) unit is to be operated on. The primary purpose of n2setup is to
configure the built in CSU. Since the CSU interface is the second inter-
face on the board it will be necessary to specify this flag to accomplish
this.
N2setup takes input from from stdin unless a input-file argument is sup-
plied on the command line.
INPUT GRAMMAR
Input to n2setup is made up of some number of individual statements. Each
statement consists of four parts:
1. A variable to be set. The variable name may consist of one or more
words.
2. An equal sign which separates the variable to be set from the value
to be assigned to it.
3. A value to be assigned to the variable. The value to be set may con-
sist of one or more words.
4. A semicolon which terminates the statement.
In addition a pound sign can be used to delimit the start of a comment.
From the pound sign to the next end of line is treated as comment. The
input grammar is totally case insensitive. Following are a few example
statements:
active channels = all; # all sub-channels are active
active channels=all; # spaces optional
active channels = 1,2,7,9; # sub-channels 1, 2, 7 and 9 are active
active channels=1, 2, 7, 9; # spaces optional
line build out = 22.5db; # attenuate transmit signal 22.5db
line build out = 22.5Db; # upper case
COMMMANDS SPECIFIC TO THE N2CSU
This document details the commands available to configure CSU on the var-
ious N2 boards. Determination of the correct values to use is beyond the
scope of this document. The SDL Communications document appropriate for
the particular hardware should be referenced to determine how to setup
the CSU for a particular service provider.
1. ``active channels'' This is used to setup which T1 sub-channels will
be used. No channels are selected by default which means that this
must always be specified for a N2CSU. Legal values are:
o ``all'' This will select channels 1 to 24. This results in oper-
ation at full T1 speed.
o ``1, 2, 3, ..., 24'' A comma separated listed is used when a
fraction of the full T1 channel is to be used.
2. ``line coding'' Legal values are:
o ``b8zs'' (Default value)
o ``ami''
3. ``rate multiplier'' Legal values are:
o ``56''
o ``64'' (Default value)
4. ``framing mode.'' Legal values are:
o ``d4'' (Default value)
o ``esf''
5. ``line build out'' Legal values are:
o ``0 Db'' (Default value)
o ``7.5 Db''
o ``15 Db''
o ``22.5 Db''
6. ``clock source'' Legal values are:
o ``external'' (Default value)
o ``internal''
7. ``equalizer gain limit'' Legal values are:
o ``off'' (Default value)
o ``on''
8. ``csu data polarity'' Legal values are:
o ``normal'' (Default value)
o ``invert''
9. ``ansi t1.403 messages generated'' Legal values are:
o ``no'' (Default value)
o ``yes''
10. ``ansi t1.403 c/r address bit of transmitted prms'' Legal values
are:
o ``no'' (Default value)
o ``yes''
11. ``ansi t1.403 c/r address bit of received prms'' Legal values are:
o ``no'' (Default value)
o ``yes''
12. ``fdl idle code'' Legal values are:
o ``flag'' (Default value)
o ``mark''
13. ``at&t 54016 target address match'' Legal values are:
o ``a or z'' (Default value) This value is the full string ``a or
z''.
o ``b or y'' This value is the full string ``b or y''.
COMMMANDS SPECIFIC TO THE N2DDS
1. ``clock source'' Legal values are:
o ``external'' (Default value)
o ``internal''
2. ``transmission frequency'' Legal values are:
o ``56 Kb'' (Default value)
o ``72 Kb''
COMMMANDS FOR THE STANDARD PORTS
Standard ports are DSU interfaces. They are unit 0 on all boards as well
as unit 1 on N2 cards.
1. ``transmit clock source'' Gating the receive clock to the transmit
clock is only needed with an X.21 CSU/DSU using standard cables
rather than the SDL specified cross over cables. Legal values are:
o ``transmit clock'' (Default value)
o ``receive clock''
2. ``source clock'' This is only need when two N2 ports are connected
together without a CSU/DSU. Legal values are:
o ``no'' (Default value)
o ``yes''
3. ``baud rate table entry'' This is only need when two N2 ports are
connected together without a CSU/DSU. Legal values are:
o ``0'' Selects 56000 baud. (Default value)
o ``1'' Selects 9600 baud.
o ``2'' Selects 19200 baud.
o ``3'' Selects 38400 baud.
o ``4'' Selects 65000 baud.
o ``5'' Selects 500000 baud.
o ``6'' Selects 1000000 baud.
o ``7'' Selects 1500000 baud.
COMMANDS USED WITH ALL PORTS
1. ``data carrier detect'' It is necessary to ignore DCD when X.21
modems are used. Legal values are:
o ``use dcd'' (Default value)
o ``ignore dcd''
EXAMPLES
The following is the input to configure a typical full T1 channel:
active channels = all;
line build out = 7.5db;
rate multiplier = 56;
framing mode = d4;
equalizer gain limit=on;
csu data polarity = invert; # almost always needed with d4
The following is an example of setting on a standard line to talk to a
X.21 modem:
data carrier detect = ignore dcd;
transmit clock source = receive clock;
The following is an example of setting up a N2dds CSU:
clock source = external;
transmission frequency = 64 Kb;
SEE ALSOntwo(4)ifconfig(8)netstat(1)BSDI BSD/OS July 19, 1995 4
