| si.4 (56467) | si.4 (57676) |
|---|---|
| 1.\" $FreeBSD: head/share/man/man4/si.4 56467 2000-01-23 16:13:26Z asmodai $ | 1.\" $FreeBSD: head/share/man/man4/si.4 57676 2000-03-01 14:50:24Z sheldonh $ |
| 2.Dd September 16, 1995 3.Os FreeBSD 4.Dt SI 4 5.Sh NAME 6.Nm si 7.Nd Driver for Specialix International SI/XIO or SX intelligent serial card. 8.Sh SYNOPSIS 9.Cd "device si" --- 9 unchanged lines hidden (view full) --- 19an ISA, EISA or PCI slot and provides intelligence and buffering/processing 20capabilities, as well as an external bus in the form of a 37 pin cable. 21.Pp 22On this cable, "modules" are connected. The "SI" module comes in a 4 and 8 23port version. The "XIO" and "SX" modules come only in 248 port versions. 25.Pp 26The host adapter polls and transfers data between the modules and the rest | 2.Dd September 16, 1995 3.Os FreeBSD 4.Dt SI 4 5.Sh NAME 6.Nm si 7.Nd Driver for Specialix International SI/XIO or SX intelligent serial card. 8.Sh SYNOPSIS 9.Cd "device si" --- 9 unchanged lines hidden (view full) --- 19an ISA, EISA or PCI slot and provides intelligence and buffering/processing 20capabilities, as well as an external bus in the form of a 37 pin cable. 21.Pp 22On this cable, "modules" are connected. The "SI" module comes in a 4 and 8 23port version. The "XIO" and "SX" modules come only in 248 port versions. 25.Pp 26The host adapter polls and transfers data between the modules and the rest |
| 27of the machine. The Host adapter provides a 256 byte transmit and 256 byte | 27of the machine. 28The Host adapter provides a 256 byte transmit and 256 byte |
| 28receive FIFO for each of the 32 ports that it can maintain. 29.Pp 30The XIO modules can operate each of their 8 ports at 115,200 baud. | 29receive FIFO for each of the 32 ports that it can maintain. 30.Pp 31The XIO modules can operate each of their 8 ports at 115,200 baud. |
| 31The SI version can run at 57,600 baud. The SX modules can operate each of their | 32The SI version can run at 57,600 baud. 33The SX modules can operate each of their |
| 328 ports at up to 921,600 baud. 33.Pp | 348 ports at up to 921,600 baud. 35.Pp |
| 34SX modules are only supported when connected to an SX host card. SI or | 36SX modules are only supported when connected to an SX host card. 37SI or |
| 35XIO modules are supported on any host card. 36.Pp 37The host adapter uses a shared memory block in the traditional ISA bus 38"hole" between 0xA0000 and 0xEFFFF. The adapter can be configured outside 39range, but requires the memory range to be explicitly non-cached. The 40driver does not yet support this mode of operation. 41.Pp | 38XIO modules are supported on any host card. 39.Pp 40The host adapter uses a shared memory block in the traditional ISA bus 41"hole" between 0xA0000 and 0xEFFFF. The adapter can be configured outside 42range, but requires the memory range to be explicitly non-cached. The 43driver does not yet support this mode of operation. 44.Pp |
| 42SX ISA Host cards have an 8/16 bit mode switch or jumper on them. This switch | 45SX ISA Host cards have an 8/16 bit mode switch or jumper on them. 46This switch |
| 43or jumper MUST be set for 8 bit mode. 44.Pp 45The ISA adapters can use Irq's 11, 12 or 15 (and 9 and 10 in the case of 46SX host cards). 47.Pp 48The si device driver may have some of it's configuration settings changed 49at run-time with the 50.Xr sicontrol 8 51utility. 52.Pp 53The si device driver also responds to the 54.Xr comcontrol 8 55utility for configuring drain-on-close timeouts. 56.Pp 57The driver also defines 3 sysctl variables that can be manipulated: | 47or jumper MUST be set for 8 bit mode. 48.Pp 49The ISA adapters can use Irq's 11, 12 or 15 (and 9 and 10 in the case of 50SX host cards). 51.Pp 52The si device driver may have some of it's configuration settings changed 53at run-time with the 54.Xr sicontrol 8 55utility. 56.Pp 57The si device driver also responds to the 58.Xr comcontrol 8 59utility for configuring drain-on-close timeouts. 60.Pp 61The driver also defines 3 sysctl variables that can be manipulated: |
| 58machdep.si_debug sets the debug level for the whole driver. It depends | 62machdep.si_debug sets the debug level for the whole driver. 63It depends |
| 59on the driver being compiled with SI_DEBUG. machdep.si_pollrate 60sets how often per second the driver polls for lost interrupts. 61machdep.si_realpoll sets whether or not the card will treat the 62poll intervals as if they were interrupts. 63.Pp 64An open on a /dev device node controlled by the si driver obeys the same 65semantics as the 66.Xr sio 4 67driver. It fully supports the usual semantics of the cua ports, and the 68"initial termios" and "locked termios" settings. In summary, an open on a 69tty port will block until DCD is raised, unless O_NONBLOCK is specified. 70CLOCAL is honored. An open on a cua port will always succeed, but DCD 71transitions will be honored after DCD rises for the first time. 72.Pp 73Up to four SI/XIO host cards may be controlled by the si driver. 74Due to the lack of available interrupts, only 3 ISA SI/XIO host cards can be 75used at once. 76.Pp 77The lowest 5 bits of the minor device number are used to select the port | 64on the driver being compiled with SI_DEBUG. machdep.si_pollrate 65sets how often per second the driver polls for lost interrupts. 66machdep.si_realpoll sets whether or not the card will treat the 67poll intervals as if they were interrupts. 68.Pp 69An open on a /dev device node controlled by the si driver obeys the same 70semantics as the 71.Xr sio 4 72driver. It fully supports the usual semantics of the cua ports, and the 73"initial termios" and "locked termios" settings. In summary, an open on a 74tty port will block until DCD is raised, unless O_NONBLOCK is specified. 75CLOCAL is honored. An open on a cua port will always succeed, but DCD 76transitions will be honored after DCD rises for the first time. 77.Pp 78Up to four SI/XIO host cards may be controlled by the si driver. 79Due to the lack of available interrupts, only 3 ISA SI/XIO host cards can be 80used at once. 81.Pp 82The lowest 5 bits of the minor device number are used to select the port |
| 78number on the module cluster. The next 2 bits select which of 4 host adapter | 83number on the module cluster. 84The next 2 bits select which of 4 host adapter |
| 79cards. This allows a maximum of 128 ports on this driver. 80.Pp 81Bit 7 is used to differentiate a tty/dialin port (bit 7=0) and a 82cua/callout port (bit 7=1). 83.Pp 84Bit 8 through 15 (on 85.Tn FreeBSD ) 86are unavailable as they are a shadow of the --- 77 unchanged lines hidden --- | 85cards. This allows a maximum of 128 ports on this driver. 86.Pp 87Bit 7 is used to differentiate a tty/dialin port (bit 7=0) and a 88cua/callout port (bit 7=1). 89.Pp 90Bit 8 through 15 (on 91.Tn FreeBSD ) 92are unavailable as they are a shadow of the --- 77 unchanged lines hidden --- |