aboutsummaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorAndrey A. Chernov <ache@FreeBSD.org>1994-03-18 13:40:01 +0000
committerAndrey A. Chernov <ache@FreeBSD.org>1994-03-18 13:40:01 +0000
commite8c3de7e2f4cf2ce250f5c7878d037d1fbb4db61 (patch)
treeea26867e474347cef7ab1032e60de41aea29e667 /share
parent8951219578058e5fab37a7ad8ec24985e3ec0b76 (diff)
downloadsrc-e8c3de7e2f4cf2ce250f5c7878d037d1fbb4db61.tar.gz
src-e8c3de7e2f4cf2ce250f5c7878d037d1fbb4db61.zip
Some changes from Julian Stacey installed
Notes
Notes: svn path=/head/; revision=1272
Diffstat (limited to 'share')
-rw-r--r--share/man/man4/man4.i386/sio.458
-rw-r--r--share/man/man4/sio.458
2 files changed, 88 insertions, 28 deletions
diff --git a/share/man/man4/man4.i386/sio.4 b/share/man/man4/man4.i386/sio.4
index fc416a91c845..e5e6caf726f9 100644
--- a/share/man/man4/man4.i386/sio.4
+++ b/share/man/man4/man4.i386/sio.4
@@ -34,7 +34,7 @@
.\"
.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91
.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
-.\" $Id: sio.4,v 1.7 1994/02/19 13:19:33 ache Exp $
+.\" $Id: sio.4,v 1.8 1994/02/19 15:50:38 ache Exp $
.\"
.Dd February 9, 1994
.Dt SIO 4 i386
@@ -80,28 +80,42 @@ Input and output for each line may set to one of following baud rates;
19200, 38400, 57600, or 115200. Your hardware may limit your baud
rate choices.
.Pp
-For multiport cards the
+The driver supports `multiport' cards.
+Multiport cards are those that have one or more groups of ports
+that share a common IRQ and Interrupt Request register set per group.
+Frequently 4 ports share 1 IRQ, some 8 port cards have 2 groups of 4 ports,
+thus using 2 IRQs.
+Some cards allow the first 2 serial ports to have seperate IRQs per port
+(as per DOS PC standard).
+.sp
+The
.Nm flags
-keyword in the kernel configuration file determines which port of
-your multiport card is the master device, and whether the
-port is part of a multiport card. The master device is the port which
-has register through which all interrupts of the card are funneled.
-All ports of a multiport card report pending interrupts using this
+keyword specifies for each
+.Nm device sio
+line in the kernel configuration file,
+whether the port is part of an IRQ sharing group, & if so,
+which port is the master device for
+the group (ie which port has the IRQ control registers).
+The master device is the port which
+has registers through which all interrupts of the port group are funneled.
+All ports of a port group report pending interrupts using this
single register.
.sp
-The master device is indicated
-.Nm bitwise
-, so all sio entries in the kernel config file that are part of a
+The master device is an integer embedded in the high byte of the
+.Nm flags
+bitfield, so all sio entries in the kernel config file that are part of a
multiport card must include the correct
.Nm flags
-specification. The bitwise assignment allows multiple multiport cards to
+specification.
+The bitwise assignment allows multiple port groups to
be configured in one system. It does
.Nm not
-imply that the hardware can share the same physical interrupt line!
+imply that more than one port group (or card) can share
+the same physical interrupt line!
.Pp
In the synopsis the
.Nm flags 0x401
-means that the 4th port (sio4) is the master
+means that the 5th port (sio4) is the master
device (so the MSB of the flags), and that the ports are part of a
multiport card (the LSB of the flags, actually only the LS
.Nm bit
@@ -110,7 +124,10 @@ F.e. if you have only two standard ports in addition to multiport
card, this
.Nm flags
will be
-.Nm 0x201 .
+.Nm 0x201
+(assuming the control port is
+.Nm sio2
+).
.Pp
Which port is the master device depends on the card type. Consult
the hardware documentation of your card.
@@ -125,6 +142,19 @@ ports. The minor number of the dialout
port is 128 higher than that of the corresponding dialin port. Use
.Xr stty 1
to enable or disable modem control as required by your setup.
+.Pp
+While testing new cards & resolving card config DIP header &
+.Nm sio flags
+settings, to avoid coms. failure from lack of full modem DC level
+settings on ports,
+you are recommended to temporarily use syntax such as:
+.Nm stty -f /dev/tty03 clocal
+or open
+.Nm /dev/cua03
+if you have bidirectional mode active
+to force serial port to open without
+.Nm O_NONBLOCK
+flag.
.Sh FILES
.Bl -tag -width /dev/tty0? -compact
.It Pa /dev/tty0?
diff --git a/share/man/man4/sio.4 b/share/man/man4/sio.4
index fc416a91c845..e5e6caf726f9 100644
--- a/share/man/man4/sio.4
+++ b/share/man/man4/sio.4
@@ -34,7 +34,7 @@
.\"
.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91
.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
-.\" $Id: sio.4,v 1.7 1994/02/19 13:19:33 ache Exp $
+.\" $Id: sio.4,v 1.8 1994/02/19 15:50:38 ache Exp $
.\"
.Dd February 9, 1994
.Dt SIO 4 i386
@@ -80,28 +80,42 @@ Input and output for each line may set to one of following baud rates;
19200, 38400, 57600, or 115200. Your hardware may limit your baud
rate choices.
.Pp
-For multiport cards the
+The driver supports `multiport' cards.
+Multiport cards are those that have one or more groups of ports
+that share a common IRQ and Interrupt Request register set per group.
+Frequently 4 ports share 1 IRQ, some 8 port cards have 2 groups of 4 ports,
+thus using 2 IRQs.
+Some cards allow the first 2 serial ports to have seperate IRQs per port
+(as per DOS PC standard).
+.sp
+The
.Nm flags
-keyword in the kernel configuration file determines which port of
-your multiport card is the master device, and whether the
-port is part of a multiport card. The master device is the port which
-has register through which all interrupts of the card are funneled.
-All ports of a multiport card report pending interrupts using this
+keyword specifies for each
+.Nm device sio
+line in the kernel configuration file,
+whether the port is part of an IRQ sharing group, & if so,
+which port is the master device for
+the group (ie which port has the IRQ control registers).
+The master device is the port which
+has registers through which all interrupts of the port group are funneled.
+All ports of a port group report pending interrupts using this
single register.
.sp
-The master device is indicated
-.Nm bitwise
-, so all sio entries in the kernel config file that are part of a
+The master device is an integer embedded in the high byte of the
+.Nm flags
+bitfield, so all sio entries in the kernel config file that are part of a
multiport card must include the correct
.Nm flags
-specification. The bitwise assignment allows multiple multiport cards to
+specification.
+The bitwise assignment allows multiple port groups to
be configured in one system. It does
.Nm not
-imply that the hardware can share the same physical interrupt line!
+imply that more than one port group (or card) can share
+the same physical interrupt line!
.Pp
In the synopsis the
.Nm flags 0x401
-means that the 4th port (sio4) is the master
+means that the 5th port (sio4) is the master
device (so the MSB of the flags), and that the ports are part of a
multiport card (the LSB of the flags, actually only the LS
.Nm bit
@@ -110,7 +124,10 @@ F.e. if you have only two standard ports in addition to multiport
card, this
.Nm flags
will be
-.Nm 0x201 .
+.Nm 0x201
+(assuming the control port is
+.Nm sio2
+).
.Pp
Which port is the master device depends on the card type. Consult
the hardware documentation of your card.
@@ -125,6 +142,19 @@ ports. The minor number of the dialout
port is 128 higher than that of the corresponding dialin port. Use
.Xr stty 1
to enable or disable modem control as required by your setup.
+.Pp
+While testing new cards & resolving card config DIP header &
+.Nm sio flags
+settings, to avoid coms. failure from lack of full modem DC level
+settings on ports,
+you are recommended to temporarily use syntax such as:
+.Nm stty -f /dev/tty03 clocal
+or open
+.Nm /dev/cua03
+if you have bidirectional mode active
+to force serial port to open without
+.Nm O_NONBLOCK
+flag.
.Sh FILES
.Bl -tag -width /dev/tty0? -compact
.It Pa /dev/tty0?