SICONFIG(8) BSD System Manager's Manual SICONFIG(8)NAMEsiconfig - Specialix SLXOS driver configuration and debugging
SYNOPSISsiconfig device_name argument [parameter ...]
DESCRIPTION
The siconfig program manages the SLXOS driver. It requires a device_name
argument to specify a particular adapter port and a further argument to
select the particular operation. If no '/' character is found in
device_name, /dev/ is prepended.
boot [bootfile]
Initialize the SLXOS adapter and driver. The SLXOS driver is not
fully initialized at kernel bootstrap time as firmware code must
first be downloaded to the the adapter. A default set of firmware
is contained within siconfig; the optional bootfile specifies an
alternative set of firmware. All adapters are booted simultaneous-
ly, and the device_name may be replaced by '-', e.g.:
- boot
int_throttle [newvalue]
Display or set the aggregate interrupt throttle value. The maximum
number of controller interrupts per second is determined by the
formula:
controller CPU clock / (8 * int_throttle )
The default value is 25000, which with a controller clock of 25Mhz
gives a maximum interrupt rate of approximately 125 per second.
rxint_throttle [newvalue]
Display or set the receiver interrupt throttle value. This is used
to modify the aggregate rate for receiver generated interrupts. It
is initially set to 4, which gives a maximum receiver interrupt
rate of 25 per second. Reducing the value increases the maximum
receiver interrupt rate and vice versa (this is the initialization
for a counter that decrements at each int_throttle tick, when it
hits zero a receive interrupt is allowed and the counter is reset
to rxint_throttle).
To run at 57600 or 115200 the default is not fast enough, use 1 or
2 to allow the board to keep up with full speed input (flow control
will still assert but the throughput with the default rxint_throt-
tle maxes out around 50Kb).
txlowat [newvalue]
Display or set the transmitter low water mark. The port transmit
buffer must drain below this value before transmission is re-en-
abled.
ixany [on|off]
Enable or disable the effect of termios(4) use of IXANY. The con-
troller automatically handles XON/XOFF in firmware if IXON or IXOFF
(output and input flow control, respectively) are specified via
termios(4). This configuration parameter is used to enable/disable
invocation of transmit XON by an received character.
mstate
Display the state of the port's hardware control lines: DTR, RTS,
DCD and RI.
modem [on|off]
Display or set the port's soft carrier state. If modem is set to
on, an open on the port will obey the normal ``wait for DCD unless
O_NONBLOCK set'' rules. If modem is set to off the port behaves as
though DCD were continually asserted.
cookmode [on|off]
Display or set the adapter buffering mode. Setting cookmode to on
forces output to always go via the line discipline. Conversely,
setting cookmode to off cause output to be written directly to the
adapter, bypassing the line discipline code if OPOST is not set.
The SLXOS firmware can handle the simple (line discipline 0) addi-
tion of CR after LF; thus, if only OPOST and ONLCR are set, the
line discipline is also bypassed. Input is always routed via the
line discipline.
nport
Display the number of ports attached to the adapter referenced by
the specified device_name.
hwflow
hwflow rts
hwflow cts
hwflow rtscts
hwflow none
Display or set the adapter RTS/CTS flow control mode. Use of RTS
and CTS to handle flow control can be set independently of of the
state of CCTS_OFLOW and CRTS_IFLOW in termios(4). The flags from
termios and here are logically ored together to determine if H/W
flow control should be used. Note: as the default terminal adapter
is a DCE, RTS is used for output flow control and CTS for input
flow control (reverse of DTE).
ppp [on|off]
Display or set the PPP compatibility mode. PPP (and similar) upper
level protocol code requires a positive acknowledgment of success-
ful character transmission. In the case of PPP, this is done using
the side effect of a call to xxstart() after the hardware has in-
terrupted to indicate transmit buffer drain. However, the SLXOS
firmware only generates a buffer drain interrupt after the transmit
buffer has been filled (beyond a high water mark). The ppp option
invokes a soft interrupt call to the line disciple start routine
after a number ticks of the clock, as calculated from the baud rate
and the number of characters just transmitted. This ensures that
upper layers of protocol code receive their desired acknowledgment.
xpon|xpoff [string]
Display or set the XPRINT preamble and postamble strings. These
should be set to the character strings that enable and disable out-
put to the terminal's printer port. Non-printable characters may
be encoded in the same style as in unvis(1) and termcap(5) (approx-
imately a superset of C syntax). The default strings are:
xpon \033d#
xpoff \024
xpcps [chars_per_sec]
Display or set the aggregate XPRINT transmission rate.
FILES
/dev/si_control driver control interface
/dev/tty[ab]* ports
/dev/tty[ab]*_xp
XPRINT ports
SEE ALSOsi(4),
DIAGNOSTICS
Many and various.
BUGS
Watch this space.
August 4, 1995 3
