Brian Somers ad01e0c856 Add a ``digi'' driver.
This driver supports PCI Xr-based and ISA Xem Digiboard cards.
dgm will go away soon if there are no problems reported.  For now,
configuring dgm into your kernel warns that you should be using
digi.  This driver is probably close to supporting Xi, Xe and Xeve
cards, but I wouldn't expect them to work properly (hardware
donations welcome).

The digi_* pseudo-drivers are not drivers themselves but contain
the BIOS and FEP/OS binaries for various digiboard cards and are
auto-loaded and auto-unloaded by the digi driver at initialisation
time.  They *may* be configured into the kernel, but waste a lot
of space if they are.  They're intended to be left as modules.

The digictl program is (mainly) used to re-initialise cards that
have external port modules attached such as the PC/Xem.
2001-05-02 01:08:09 +00:00

81 lines
2.0 KiB
Groff

.\" $FreeBSD$
.Dd May 1, 2001
.Dt DIGICTL 8
.Os
.Sh NAME
.Nm digictl
.Nd Control Digiboard devices
.Sh SYNOPSIS
.Nm
.Op Fl d Ar debug
.Op Fl ir
.Ar device ...
.Sh DESCRIPTION
The
.Nm
program provides control of the Digiboard installed with the given control
.Ar device
name.
A digiboard control
.Ar device
is usually of the form
.Dq /dev/digi Ns Ar N Ns No .ctl
where
.Ar N
is the card number and starts at 0 for the first attached card.
.Pp
The following flags are recognised:
.Bl -tag -width XXXX -offset XXXX
.It Fl d Ar debug
If the driver has been compiled with
.Dv DEBUG
defined, the following bits from the
.Ar debug
variable are used to enable diagnostics in the digiboard driver:
.Bl -tag -width XXXXXXXXXXXX
.It 1 ( Em INIT )
Diagnostics during card attach, detach and initialisation.
.It 2 ( Em OPEN )
Diagnostics when opening a port.
.It 4 ( Em CLOSE )
Diagnostics when closing a port.
.It 8 ( Em SET )
Diagnostics when setting tty device flags.
.It 16 ( Em INT )
Diagnostics when processing card events.
.It 32 ( Em READ )
Reports return values from port reads.
.It 64 ( Em WRITE )
Reports return values from port writes.
.It 128 ( Em RX )
Reports receive queue flow control.
.It 256 ( Em TX )
Reports transmit queue flow control.
.It 512 ( Em IRQ )
Diagnostics during interrupts (enable these with care).
.It 1024 ( Em MODEM )
Diagnostics when setting modem status flags.
.It 2048 ( Em RI )
Reports when a RING is received.
.El
.It Fl i
Display the card identification string and type id.
.It Fl r
Reinitialise the card.
For boards with external port modules, it is possible to add or remove
modules and dynamically reprobe the number of ports using this switch.
All ports on the card must be closed in order to reinitialise the card.
.Pp
It is preferable to reinitialise the card rather than reload the entire
digi module as reinitialisation only affects the specified board rather
than affecting all attached boards.
.El
.Sh BUGS
It should be possible to reinitialise a board without closing all of the
existing ports.
.Sh HISTORY
The
.Nm
command first appeared in
.Fx 5.0 .