blob: ce7115e7f4cec44ac4545f189eff9706083888b5 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001$Id: README.act2000,v 1.3 2000/08/06 09:22:51 armin Exp $
2
3This document describes the ACT2000 driver for the
4IBM Active 2000 ISDN card.
5
6There are 3 Types of this card available. A ISA-, MCA-, and PCMCIA-Bus
7Version. Currently, only the ISA-Bus version of the card is supported.
8However MCA and PCMCIA will follow soon.
9
10The ISA-Bus Version uses 8 IO-ports. The base port address has to be set
11manually using the DIP switches.
12
13Setting up the DIP switches for the IBM Active 2000 ISDN card:
14
15 Note: S5 and S6 always set off!
16
17 S1 S2 S3 S4 Base-port
18 on on on on 0x0200 (Factory default)
19 off on on on 0x0240
20 on off on on 0x0280
21 off off on on 0x02c0
22 on on off on 0x0300
23 off on off on 0x0340
24 on off off on 0x0380
25 on on on off 0xcfe0
26 off on on off 0xcfa0
27 on off on off 0xcf60
28 off off on off 0xcf20
29 on on off off 0xcee0
30 off on off off 0xcea0
31 on off off off 0xce60
32 off off off off Card disabled
33
34IRQ is configured by software. Possible values are:
35
36 3, 5, 7, 10, 11, 12, 15 and none (polled mode)
37
38
39The ACT2000 driver may either be built into the kernel or as a module.
40Initialization depends on how the driver is built:
41
42Driver built into the kernel:
43
44 The ACT2000 driver can be configured using the commandline-feature while
45 loading the kernel with LILO or LOADLIN. It accepts the following syntax:
46
47 act2000=b,p,i[,idstring]
48
49 where
50
51 b = Bus-Type (1=ISA, 2=MCA, 3=PCMCIA)
52 p = portbase (-1 means autoprobe)
53 i = Interrupt (-1 means use next free IRQ, 0 means polled mode)
54
55 The idstring is an arbitrary string used for referencing the card
56 by the actctrl tool later.
57
58 Defaults used, when no parameters given at all:
59
60 1,-1,-1,""
61
62 which means: Autoprobe for an ISA card, use next free IRQ, let the
63 ISDN linklevel fill the IdString (usually "line0" for the first card).
64
65 If you like to use more than one card, you can use the program
66 "actctrl" from the utility-package to configure additional cards.
67
68 Using the "actctrl"-utility, portbase and irq can also be changed
69 during runtime. The D-channel protocol is configured by the "dproto"
70 option of the "actctrl"-utility after loading the firmware into the
71 card's memory using the "actctrl"-utility.
72
73Driver built as module:
74
75 The module act2000.o can be configured during modprobe (insmod) by
76 appending its parameters to the modprobe resp. insmod commandline.
77 The following syntax is accepted:
78
79 act_bus=b act_port=p act_irq=i act_id=idstring
80
81 where b, p, i and idstring have the same meanings as the parameters
82 described for the builtin version above.
83
84 Using the "actctrl"-utility, the same features apply to the modularized
85 version as to the kernel-builtin one. (i.e. loading of firmware and
86 configuring the D-channel protocol)
87
88Loading the firmware into the card:
89
90 The firmware is supplied together with the isdn4k-utils package. It
91 can be found in the subdirectory act2000/firmware/
92
93 Assuming you have installed the utility-package correctly, the firmware
94 will be downloaded into the card using the following command:
95
96 actctrl -d idstring load /etc/isdn/bip11.btl
97
98 where idstring is the Name of the card, given during insmod-time or
99 (for kernel-builtin driver) on the kernel commandline. If only one
100 ISDN card is used, the -d isdstrin may be omitted.
101
102 For further documentation (adding more IBM Active 2000 cards), refer to
103 the manpage actctrl.8 which is included in the isdn4k-utils package.
104