I think most of this is now in, except my example that andrew doesnt like To: freebsd-hackers@freebsd.org Subject: diff for src/share/man/man4/man4.i386/sio.4 While getting my 8 port dual multiport serial card to work (done :-) I discovered the manual sio.4 needed some minor amendements. Here are my diffs, I'd appreciate if the sio multiport folk could review it. Comments welcome. Thanks Julian H. Stacey *** old/src/share/man/man4/man4.i386/sio.4 Sat Feb 19 18:09:39 1994 --- new/src/share/man/man4/man4.i386/sio.4 Wed Mar 16 01:09:11 1994 *************** *** 80,107 **** 19200, 38400, 57600, or 115200. Your hardware may limit your baud rate choices. .Pp ! For multiport cards 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 single register. .sp ! The master device is indicated ! .Nm bitwise ! , 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 be configured in one system. It does .Nm not ! imply that the hardware can share the same physical interrupt line! .Pp In the synopsis the .Nm flags 0x401 ! means that the 4th 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 --- 80,121 ---- 19200, 38400, 57600, or 115200. Your hardware may limit your baud rate choices. .Pp ! 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 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 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 port groups to be configured in one system. It does .Nm not ! 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 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,116 **** card, this .Nm flags will be ! .Nm 0x201 . .Pp Which port is the master device depends on the card type. Consult the hardware documentation of your card. --- 124,135 ---- card, this .Nm flags will be ! .Nm 0x201 ! (assuming the control port is ! .Nm sio2 ! , (though some manufacturers use ! .Nm sio3 ! )). .Pp Which port is the master device depends on the card type. Consult the hardware documentation of your card. *************** *** 125,130 **** --- 144,161 ---- 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/sio03 clocal + to force serial ports to open for + .Nm login + & + .Nm kermit + etc. .Sh FILES .Bl -tag -width /dev/tty0? -compact .It Pa /dev/tty0? *************** *** 187,189 **** --- 218,243 ---- .Nm multiple AST/4 cards are installed in the same system. The sio driver does not support more than 1 AST/4 on one IRQ. + .Sh FURTHER EXAMPLE + Here is an example of an 8 Port Decision Computer Int. Co., Ltd (Taiwan) card, + .\" example from jhs@'s working hardware. + that has 2 groups of 4 ports, with each master port being the last of the 4 + (in contrast to the earlier example, + where the control port was the first port of the group), note also + .Nm sio0 + and + .Nm sio1 + are configured here to be compatible to the standard + PC DOS minimal 2 port addresses & IRQs. + .Cd "device sio0 at isa? port 0x3F8 tty irq 4 flags 0x0301 vector siointr" + .Cd "device sio1 at isa? port 0x2F8 tty irq 3 flags 0 vector siointr" + .Cd "device sio2 at isa? port 0x2B0 tty irq 4 flags 0x0301 vector siointr" + .Cd "device sio3 at isa? port 0x2B8 tty irq 4 flags 0x0301 vector siointr" + .Cd "device sio4 at isa? port 0x1a0 tty irq 5 flags 0x0701 vector siointr" + .Cd "device sio5 at isa? port 0x1a8 tty irq 5 flags 0x0701 vector siointr" + .Cd "device sio6 at isa? port 0x1b0 tty irq 5 flags 0x0701 vector siointr" + .Cd "device sio7 at isa? port 0x1b8 tty irq 5 flags 0x0701 vector siointr" + .br + .Nm sio1 + would probably be an ideal choice for a modem here, + as it's the only port not to have to share its IRQ.