1 The Linux Digiboard Driver
2 --------------------------
4 The Digiboard Driver for Linux supports the following boards:
6 DigiBoard PC/Xi, PC/Xe, PC/Xeve(which is the newer, smaller Xe with
7 a 8K window which is also known as PC/Xe(8K) and has no memory/irq
8 switches) You can use up to 4 cards with this driver and it should work
9 on other architectures than intel also.
11 In case you have problems with this version (1.6.1) of this driver, please
12 email directly to me as I made the last update. It you have a report about
13 running it on other architectures than intel, email me, so I can document
16 A version of this driver has been taken by Digiboard to make a driver
17 software package which supports also PC/Xem cards and newer PCI cards
18 but it doesn't support the old PC/Xi cards and it isn't yet ported to
19 linux-2.1.x and may not be usable on other architectures than intel now.
20 It is available from ftp.digi.com/ftp.digiboard.com. You can write me if
21 you need an patch for this driver.
23 Bernhard Kaindl (bkaindl@netway.at) 6. April 1997.
25 Configuring the Driver
26 ----------------------
28 The driver can be built direct into the kernel or as a module.
29 The pcxx driver can be configured using the command line feature while
30 loading the kernel with LILO or LOADLIN or, if built as a module,
31 with arguments to insmod and modprobe or with parameters in
32 /etc/modules.conf for modprobe and kerneld.
34 After configuring the driver you need to create the device special files
35 as described in "Device file creation:" below and set the appropriate
36 permissions for your application.
41 modprobe pcxx io=<io> \
48 or, if several cards are installed
50 modprobe pcxx io=<io-1>,<io-2>,... \
51 membase=<membase-1>,<membase-2>,... \
52 memsize=<memsize-1>,<memsize-2>,... \
53 numports=<numports-1>,<numports-2>,... \
54 altpin=<altpin-1>,<altpin-2>,... \
57 where <io-N> is the io address of the Nth card and <membase-N> is the
58 memory base address of the Nth card, etc.
60 The parameters can be specified in any order. For example, the numports
61 parameter can precede the membase parameter, or vice versa. If several
62 cards are installed the ordering within the comma separated parameter
63 lists must be consistent, of course.
65 io - I/O port address of that card.
66 membase - Memory start address of that card.
67 memsize - Memory size of that card, in kilobytes. If given, this value
68 is compared against the card to verify configuration and
69 hinder the driver from using a misconfigured card. If the parameter
70 does not match the board it is disabled with a memory size error.
71 numports - Number of ports on this card. This is the number of devices to
72 assign to this card or reserve if disabled.
73 altpin - 1: swap DCD and DSR for 8-pin RJ-45 with modems.
74 0: don't swap DCD and DSR.
75 other values count as 1.
76 verbose - 1: give nice verbose output during initialisation of the driver,
77 possibly helpful during board configuration.
78 0: normal terse output.
80 Only the parameters which differ from the defaults need to be specified.
81 If the io= parameter is not given, the default config is used. This is
83 io=0x200 membase=0xD0000 numports=16 altpin=0
85 Only applicable parameters need be specified. For example to configure
86 2 boards, first one at 0x200 with 8 ports, rest defaults, second one at
87 0x120, memory at 0xD80000, altpin enabled, rest defaults, you can do this
88 by using these parameters:
90 modprobe pcxx io=0x200,0x120 numports=8,8 membase=,0xD80000 altpin=,1
92 To disable a temporary unusable board without changing the mapping of the
93 devices following that board, you can empty the io-value for that board:
95 modprobe pcxx io=,0x120 numports=8,8 membase=,0xD80000 altpin=,1
97 The remaining board still uses ttyD8-ttyD15 and cud8-cud15.
99 Example line for /etc/modules.conf for use with kerneld and as default
100 parameters for modprobe:
102 options pcxx io=0x200 numports=8
104 For kerneld to work you will likely need to add these two lines to your
107 alias char-major-22 pcxx
108 alias char-major-23 pcxx
111 Boot-time configuration when linked into the kernel
112 ---------------------------------------------------
114 Per board to be configured, pass a digi= command-line parameter to the
115 kernel using lilo or loadlin. It consists of a string of comma separated
116 identifiers or integers. The 6 values in order are:
118 Card status: Enable - use that board
119 Disable - don't actually use that board.
121 Card type: PC/Xi - the old ones with 64/128/256/512K RAM.
122 PC/Xe - PC/Xe(old ones with 64k mem range).
123 PC/Xeve - PC/Xe(new ones with 8k mem range).
125 Note: This is for documentation only, the type is detected from the board.
127 Altpin setting: Enable - swap DCD and DSR for 8-pin RJ-45 with modems.
128 Disable - don't swap DCD and DSR.
130 Number of ports: 1 ... 16 - Number of ports on this card. This is the
131 number of devices to assign to this card.
133 I/O port address: eg. 200 - I/O Port address where the card is configured.
135 Memory base addr: eg. 80000 - Memory address where the board's memory starts.
137 This is an example for a line which you can insert into you lilo.conf:
139 append="digi=Enable,PC/Xi,Disable,4,120,D0000"
141 there is an alternate form, in which you must use decimal values only:
143 append="digi=1,0,0,16,512,851968"
145 If you don't give a digi= command line, the compiled-in defaults of
146 board 1: io=0x200, membase=0xd0000, altpin=off and numports=16 are used.
148 If you have the resources (io&mem) free for use, configure your board to
149 these settings and you should be set up fine even if yours has not got 16
153 Sources of Information
154 ----------------------
156 Web page: http://private.fuller.edu/clameter/digi.html
158 Mailing list: digiboard@list.fuller.edu
160 (Write e-mail to that address to subscribe. Common ListServ commands work.
161 Archive of messages available)
163 Christoph Lameter (clameter@fuller.edu) 16. April 1996.
168 Some tools and more detailed information can be found at
169 ftp://ftp.fuller.edu/Linux/digi
171 The "ditty" tool described in the Digiboard Manuals for other Unixes
178 Currently the Linux MAKEDEV command does not support generating the Digiboard
181 The /dev/cud devices behave like the /dev/cua devices
182 and the ttyD devices are like the /dev/ttyS devices.
184 Use the following script to generate the devices:
186 ------------------ mkdigidev begin
189 # Script to create Digiboard Devices
190 # Christoph Lameter, April 16, 1996
193 # mkdigidev [<number of devices>]
201 if [ "$BOARDS" = "" ]; then
206 while [ $boardnum -lt $BOARDS ];
208 for c in 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15;
210 name=`expr $boardnum \* 16 + $c`
211 mknod /dev/cud$name c $DIGICU_MAJOR $name
212 mknod /dev/ttyD$name c $DIGI_MAJOR $name
214 boardnum=`expr $boardnum + 1`
216 ------------------ mkdigidev end
218 or apply the following patch to /dev/MAKEDEV and do a
222 --- /dev/MAKEDEV Sun Aug 13 15:48:23 1995
223 +++ MAKEDEV Tue Apr 16 17:53:27 1996
228 - mem|tty|ttyp|cua|cub) ;;
229 + mem|tty|ttyp|cua|cub|cud) ;;
230 hd) echo hda hdb hdc hdd ;;
235 pcmcia) ;; # taken care of by its own driver
236 ttyC) echo cyclades ;;
238 *) echo "$0: don't know what \"$1\" is" >&2 ;;
243 makedev ttyC$i c $major1 `expr 32 + $i` $tty
244 makedev cub$i c $major2 `expr 32 + $i` $dialout
248 + major1=`Major ttyD` || continue
249 + major2=`Major cud` || continue
250 + for i in 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
252 + makedev ttyD$i c $major1 `expr 32 + $i` $tty
253 + makedev cud$i c $major2 `expr 32 + $i` $dialout
257 ----- End Makedev patch
259 -----------------------------------------------------------------------------
263 The ability to use the kernel's command line to pass in the configuration for
264 boards. Using LILO's APPEND command, a string of comma separated identifiers
265 or integers can be used. The 6 values in order are:
267 Enable/Disable this card,
268 Type of card: PC/Xi(0), PC/Xe(1), PC/Xeve(2), PC/Xem(3)
269 Enable/Disable alternate pin arrangement,
270 Number of ports on this card,
271 I/O Port where card is configured (in HEX if using string identifiers),
272 Base of memory window (in HEX if using string identifiers),
275 append="digi=E,PC/Xi,D,16,200,D0000"
276 append="digi=1,0,0,16,512,(whatever D0000 is in base 10 :)
278 Drivers' minor device numbers are conserved. This means that instead of
279 each board getting a block of 16 minors pre-assigned, it gets however
280 many it should, with the next card following directly behind it. A
281 system with 4 2-port PC/Xi boards will use minor numbers 0-7.
282 This conserves some memory, and removes a few hard coded constants.
285 The definition of PC/Xem as a valid board type is the BEGINNING of support
286 for this device. The driver does not currently recognise the board, nor
287 does it want to initialize it. At least not the EISA version.
289 Mike McLagan <mike.mclagan@linux.org> 5, April 1996.