diff options
Diffstat (limited to 'share/man/man4/man4.i386/dgb.4')
| -rw-r--r-- | share/man/man4/man4.i386/dgb.4 | 39 |
1 files changed, 26 insertions, 13 deletions
diff --git a/share/man/man4/man4.i386/dgb.4 b/share/man/man4/man4.i386/dgb.4 index c1898aacd2ef..29003f0e3e98 100644 --- a/share/man/man4/man4.i386/dgb.4 +++ b/share/man/man4/man4.i386/dgb.4 @@ -49,14 +49,16 @@ All values are just examples. .Pp The \fBNDGBPORTS\fR option defines the total number of ports on all cards -installed in the system. When not defined the number is computed: +installed in the system. +When not defined the number is computed: .br default \fBNDGBPORTS\fR = number_of_described_DigiBoard_cards * 16 If it is less than the actual number of ports the system will be able to use only the -first \fBNDGBPORTS\fR ports. If it is greater then all ports will be usable +first \fBNDGBPORTS\fR ports. +If it is greater then all ports will be usable but some memory will be wasted. .Pp Meaning of \fBflags\fR: @@ -97,10 +99,12 @@ Input and output for each line may set to one of following baud rates; .Pp The driver doesn't use any interrupts, it is ``polling-based''. This means that it uses clock interrupts instead of interrupts generated by DigiBoard cards and -checks the state of cards 25 times per second. This is practical because the +checks the state of cards 25 times per second. +This is practical because the DigiBoard cards have large input and output buffers (more than 1Kbyte per port) and hardware that allows efficiently finding the port that needs -attention. The only problem seen with this policy is slower +attention. +The only problem seen with this policy is slower SLIP and PPP response. .Pp Each line in the kernel configuration file describes one card, not one port @@ -145,15 +149,18 @@ for all the DigiBoards installed (but not for any other card or real memory). DigiBoards with a large amount of memory (256K or 512K and perhaps even 128K) must be mapped -to memory addresses outside of the first megabyte. If the computer +to memory addresses outside of the first megabyte. +If the computer has more than 15 megabytes of memory then there is no free address space outside of the first megabyte where such DigiBoards can be mapped. In this case you may need to reduce the amount of memory in the computer. -But many machines provide a better solution. They have the ability to +But many machines provide a better solution. +They have the ability to ``turn off'' the memory in the 16th megabyte (addresses 0xF00000 - 0xFFFFFF) using the -BIOS setup. Then the DigiBoard's address space can be set to this ``hole''. +BIOS setup. +Then the DigiBoard's address space can be set to this ``hole''. .\" XXX the following should be true for all serial drivers and .\" should not be repeated in the man pages for all serial drivers. .\" It was copied from sio.4. The only changes were s/sio/dgb/g. @@ -267,12 +274,14 @@ the wrong \fBiomem\fR value is specified in the kernel config file. .El .Bl -diag .It dgb\fIX\fB: BIOS start failed -Problems with starting the on-board BIOS. Probably the memory addresses of the +Problems with starting the on-board BIOS. +Probably the memory addresses of the DigiBoard overlap with some other device or with RAM. .El .Bl -diag .It dgb\fIX\fB: BIOS download failed -Problems with the on-board BIOS. Probably the memory addresses of the +Problems with the on-board BIOS. +Probably the memory addresses of the DigiBoard overlap with some other device or with RAM. .El .Bl -diag @@ -319,12 +328,14 @@ unusable due to misconfiguration. .El .Bl -diag .It dgb\fIX\fB: port \fIY\fB: event \fIN\fB mstat \fIM\fB lstat \fIK\fB -The driver got a strange event from card. Probably this means that you have a +The driver got a strange event from card. +Probably this means that you have a newer card with an extended list of events or some other hardware problem. .El .Bl -diag .It dgb\fIX\fB: port \fIY\fB: overrun -Input buffer has filled up. Problems in polling logic of driver. +Input buffer has filled up. +Problems in polling logic of driver. .El .Bl -diag .It dgb\fIX\fB: port \fIY\fB: FEP command on disabled port @@ -357,6 +368,8 @@ There was a bug in implementation of .Xr select 2 . It is fixed now but not widely tested yet. .Pp -There is no ditty command. Most of its functions (alternate pinout, -speed up to 115200 baud, etc.) are implemented in the driver itself. Some +There is no ditty command. +Most of its functions (alternate pinout, +speed up to 115200 baud, etc.) are implemented in the driver itself. +Some other functions are missing. |