digi.4 (129238) | digi.4 (141846) |
---|---|
1.\" Copyright (c) 1990, 1991 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" the Systems Programming Group of the University of Utah Computer 6.\" Science Department. 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 21 unchanged lines hidden (view full) --- 30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91 36.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp 37.\" from: sio.4,v 1.15 1994/12/06 20:14:30 bde Exp | 1.\" Copyright (c) 1990, 1991 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" the Systems Programming Group of the University of Utah Computer 6.\" Science Department. 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 21 unchanged lines hidden (view full) --- 30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91 36.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp 37.\" from: sio.4,v 1.15 1994/12/06 20:14:30 bde Exp |
38.\" $FreeBSD: head/share/man/man4/digi.4 129238 2004-05-14 20:07:49Z simon $ | 38.\" $FreeBSD: head/share/man/man4/digi.4 141846 2005-02-13 22:25:33Z ru $ |
39.\" 40.Dd December 7, 2003 41.Dt DIGI 4 42.Os 43.Sh NAME 44.Nm digi 45.Nd DigiBoard intelligent serial cards driver 46.Sh SYNOPSIS --- 20 unchanged lines hidden (view full) --- 67but some memory will be wasted. 68.Pp 69Meaning of 70.Cm flags : 71.Bl -tag -width indent -compact 72.It 0x0001 73use alternate pinout (exchange DCD and DSR lines) 74.It 0x0002 | 39.\" 40.Dd December 7, 2003 41.Dt DIGI 4 42.Os 43.Sh NAME 44.Nm digi 45.Nd DigiBoard intelligent serial cards driver 46.Sh SYNOPSIS --- 20 unchanged lines hidden (view full) --- 67but some memory will be wasted. 68.Pp 69Meaning of 70.Cm flags : 71.Bl -tag -width indent -compact 72.It 0x0001 73use alternate pinout (exchange DCD and DSR lines) 74.It 0x0002 |
75don't use 8K window mode of PC/Xe | 75do not use 8K window mode of PC/Xe |
76.El 77.Pp 78Device numbering: 79.Bd -literal -compact 800b\fICC\fPmmmmmmmm\fIOLIPPPPP\fP 81 \fBCC\fPard number 82 \fRmmmmmmmm\fPajor number 83 call\fBO\fPut --- 11 unchanged lines hidden (view full) --- 95.Pf ( Tn CCITT 96.Tn V.24 ) 97standard. 98.Pp 99Input and output for each line may set to one of following baud rates; 10050, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, 10119200, 38400, 57600, or for newer versions of cards 115200. 102.Pp | 76.El 77.Pp 78Device numbering: 79.Bd -literal -compact 800b\fICC\fPmmmmmmmm\fIOLIPPPPP\fP 81 \fBCC\fPard number 82 \fRmmmmmmmm\fPajor number 83 call\fBO\fPut --- 11 unchanged lines hidden (view full) --- 95.Pf ( Tn CCITT 96.Tn V.24 ) 97standard. 98.Pp 99Input and output for each line may set to one of following baud rates; 10050, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, 10119200, 38400, 57600, or for newer versions of cards 115200. 102.Pp |
103The driver doesn't use any interrupts, it is | 103The driver does not use any interrupts, it is |
104.Dq polling-based . 105This means that 106it uses clock interrupts instead of interrupts generated by DigiBoard cards and 107checks the state of cards 25 times per second. 108This is practical because the 109DigiBoard cards have large input and output buffers (more than 1Kbyte per 110port) and hardware that allows efficiently finding the port that needs 111attention. --- 9 unchanged lines hidden (view full) --- 121.Cm flags 122keyword may be used on each 123.Dq Li "device dgb" 124line in the kernel configuration file 125to change the pinout of the interface or to use new PC/Xe cards 126which can work with an 8K memory window in compatibility mode 127(with a 64K memory window). 128Note | 104.Dq polling-based . 105This means that 106it uses clock interrupts instead of interrupts generated by DigiBoard cards and 107checks the state of cards 25 times per second. 108This is practical because the 109DigiBoard cards have large input and output buffers (more than 1Kbyte per 110port) and hardware that allows efficiently finding the port that needs 111attention. --- 9 unchanged lines hidden (view full) --- 121.Cm flags 122keyword may be used on each 123.Dq Li "device dgb" 124line in the kernel configuration file 125to change the pinout of the interface or to use new PC/Xe cards 126which can work with an 8K memory window in compatibility mode 127(with a 64K memory window). 128Note |
129that using 8K memory window doesn't mean shorter input/output buffers, it means | 129that using 8K memory window does not mean shorter input/output buffers, it means |
130only that all buffers will be mapped to the same memory address and switched as 131needed. 132.Pp 133The 134.Cm port 135value must be the same 136as the 137port --- 94 unchanged lines hidden (view full) --- 232but other setups may benefit from changing some of the default 233initial state and locking the state. 234In particular, the initial states for non (POSIX) standard flags 235should be set to suit the devices attached and may need to be 236locked to prevent buggy programs from changing them. 237E.g., 238.Dv CRTSCTS 239should be locked on for devices that support | 130only that all buffers will be mapped to the same memory address and switched as 131needed. 132.Pp 133The 134.Cm port 135value must be the same 136as the 137port --- 94 unchanged lines hidden (view full) --- 232but other setups may benefit from changing some of the default 233initial state and locking the state. 234In particular, the initial states for non (POSIX) standard flags 235should be set to suit the devices attached and may need to be 236locked to prevent buggy programs from changing them. 237E.g., 238.Dv CRTSCTS 239should be locked on for devices that support |
240RTS/CTS handshaking at all times and off for devices that don't | 240RTS/CTS handshaking at all times and off for devices that do not |
241support it at all. 242.Dv CLOCAL 243should be locked on for devices | 241support it at all. 242.Dv CLOCAL 243should be locked on for devices |
244that don't support carrier. | 244that do not support carrier. |
245.Dv HUPCL | 245.Dv HUPCL |
246may be locked off if you don't | 246may be locked off if you do not |
247want to hang up for some reason. 248In general, very bad things happen 249if something is locked to the wrong state, and things should not 250be locked for devices that support more than one setting. 251The 252.Dv CLOCAL 253flag on callin ports should be locked off for logins 254to avoid certain security holes, but this needs to be done by --- 128 unchanged lines hidden --- | 247want to hang up for some reason. 248In general, very bad things happen 249if something is locked to the wrong state, and things should not 250be locked for devices that support more than one setting. 251The 252.Dv CLOCAL 253flag on callin ports should be locked off for logins 254to avoid certain security holes, but this needs to be done by --- 128 unchanged lines hidden --- |