2 .\" Copyright (c) 1997, 2002 Hellmuth Michaelis. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 .\" last edit-date: [Sun Jul 28 20:14:24 2002]
34 .Nd isdn4bsd Siemens ISDN Chipset device driver
40 driver provides D-channel layer 1 supports as specified in ITU Recommendation
41 I.430 and layer 1 support for the B-channel.
43 The driver supports several 8 and 16bit passive ISA, ISA PnP and PCI
44 ISDN cards from various manufacturers which are all based upon the
45 popular Siemens ISDN chipset consisting of the ISDN Subscriber Access
46 Controller ISAC (such as the PEB2085 or PSB 2186) and the High-Level
47 Serial Communications Controller Extended HSCX (such as the SAB82525
49 The newer IPAC chip (which integrates an ISAC and a HSCX in one chip,
50 with the added benefit of larger FIFO buffers) is also supported.
51 .Sh SUPPORTED CARDS: ISA bus, NON-PnP
52 .Bl -tag -width Ds -compact
53 .It Ar Teles S0/8, Dr. Neuhaus Niccy 1008, Creatix ISDN-S0/8
55 The required entry in the kernel config file is:
56 .Bd -literal -offset indent
64 .Bd -literal -offset indent
66 hint.isic.0.maddr="0xd0000"
71 Notice that this cards must not have a
75 Valid values for hint.isic.N.irq are 2, 3, 4, 5, 6 and 7.
77 The i/o ports are memory mapped and the memory start address (hint.isic.N.maddr)
78 may be in the range 0xA0000 to 0xDF000 and use a region of 4kB of memory.
80 .It Ar Teles S0/16, Creatix ISDN-S0, Dr. Neuhaus Niccy 1016
82 The required entry in the kernel config file is:
83 .Bd -literal -offset indent
91 .Bd -literal -offset indent
93 hint.isic.0.port="0xd80"
94 hint.isic.0.maddr="0xd0000"
99 These boards have a jumper which specifies an i/o base address
100 (hint.isic.N.port) of either 0xd80, 0xe80 or 0xf80.
101 The remaining necessary configuration values are then
102 programmed at run time by accessing this i/o port.
104 Valid interrupts (hint.isic.N.irq) are 2, 3, 4, 5, 10, 11, 12 or 15.
106 Valid memory start addresses (hint.isic.N.maddr) are
107 0xC0000, 0xC2000, 0xC4000, 0xC6000, 0xC8000, 0xCA000, 0xCC000, 0xCE000,
108 0xD0000, 0xD2000, 0xD4000, 0xD6000, 0xD8000, 0xDA000, 0xDC000 and
111 Notice: Although the jumpers are labeled 0xd80, 0xe80 or 0xf80, they
112 also require i/o space at addresses 0x180, 0x280 or 0x380.
116 The required entry in the kernel config file is:
117 .Bd -literal -offset indent
121 The required entry in
125 .Bd -literal -offset indent
127 hint.isic.0.port="0xd80"
129 hint.isic.0.flags="3"
132 This card is completely i/o mapped and must not have an
134 statement in the hints file.
136 Valid interrupts (hint.isic.N.irq) are 2, 5, 9, 10, 12 or 15.
138 These boards have a jumper which specifies an i/o base address
139 (hint.isic.N.port) of either 0xd80, 0xe80 or 0xf80.
141 Notice: Although the switch positions are labeled 0x180, 0x280 and 0x380,
142 the card is to be configured at 0xd80, 0xe80 or 0xf80 respectively!
144 .It Ar AVM A1 and AVM Fritz!Card
146 The required entry in the kernel config file is:
147 .Bd -literal -offset indent
151 The required entry in
155 .Bd -literal -offset indent
157 hint.isic.0.port="0x340"
159 hint.isic.0.flags="4"
162 These boards have a jumper which specifies an i/o base address (hint.isic.N.port)
163 of either 0x200, 0x240, 0x300 or 0x340.
165 Valid interrupt (hint.isic.N.irq) values are 3, 4, 5, 6, 7, 10, 11, 12 or 15.
167 Older Versions of the AVM A1 also require setting of an IRQ jumper, newer
168 versions of this and the Fritz!Card only have an i/o base jumper and the
169 interrupt is setup at runtime by reprogramming a register.
171 .It Ar USRobotics Sportster ISDN TA intern and Stollmann Tina pp
173 The required entry in the kernel config file is:
174 .Bd -literal -offset indent
178 The required entry in
182 .Bd -literal -offset indent
184 hint.isic.0.port="0x268"
186 hint.isic.0.flags="7"
189 Valid i/o port values (hint.isic.N.port) are 0x200, 0x208, 0x210, 0x218,
190 0x220, 0x228, 0x230, 0x238, 0x240, 0x248, 0x250, 0x258, 0x260, 0x268,
193 Valid interrupt (hint.isic.N.irq) values are 5, 7, 10, 11, 12, 14, 15.
195 Notice: this card has a strange address decoding scheme resulting in
196 occupying 64 windows of some bytes length over the whole i/o address
199 .It Ar ITK ix1 Micro ( < V.3, non-PnP version )
201 The required entry in the kernel config file is:
202 .Bd -literal -offset indent
206 The required entry in
210 .Bd -literal -offset indent
212 hint.isic.0.port="0x398"
214 hint.isic.0.flags="18"
217 Valid i/o port values must be in the range (<unknown>).
219 Valid interrupt configurations are (<unknown>).
221 .It Ar ELSA MicroLink ISDN/PCC-16 and ELSA PCFpro
223 The required entry in the kernel config file is:
224 .Bd -literal -offset indent
228 The required entry in
232 .Bd -literal -offset indent
234 hint.isic.0.port="0x360"
236 hint.isic.0.flags="20"
239 Valid i/o port (hint.isic.N.port) values are 0x160, 0x170, 0x260 and 0x360.
241 Valid interrupt (hint.isic.N.irq) values are 2, 3, 5, 10, 11 and 15.
243 The LED's are not supported and are off.
246 .Sh SUPPORTED CARDS: ISA bus, PnP (Plug 'n Pray)
247 .Bl -tag -width Ds -compact
248 .It Ar Teles S0/16.3 PnP
250 The required entry in the kernel config file is:
251 .Bd -literal -offset indent
252 options TEL_S0_16_3_P
255 .It Ar Creatix ISDN-S0 P&P
257 The required entry in the kernel config file is:
258 .Bd -literal -offset indent
262 .It Ar "Dr. Neuhaus Niccy Go@"
264 The required entry in the kernel config file is:
265 .Bd -literal -offset indent
269 .It Ar "Sedlbauer Win Speed"
271 The required entry in the kernel config file is:
272 .Bd -literal -offset indent
276 .It Ar "Dynalink IS64PH"
278 The required entry in the kernel config file is:
279 .Bd -literal -offset indent
283 .It Ar "ELSA QuickStep 1000pro ISA"
285 The required entry in the kernel config file is:
286 .Bd -literal -offset indent
290 The LED's are not supported and are off.
292 .It Ar "Siemens I-Surf 2.0"
294 The required entry in the kernel config file is:
295 .Bd -literal -offset indent
296 options SIEMENS_ISURF2
299 .It Ar "Asuscom ISDNlink 128K ISA"
301 The required entry in the kernel config file is:
302 .Bd -literal -offset indent
306 .It Ar "Eicon Diehl DIVA 2.0 and 2.02"
308 The required entry in the kernel config file is:
309 .Bd -literal -offset indent
313 .It Ar "Compaq Microcom 610 ISDN card (Compaq series PSB2222I)"
315 The required entry in the kernel config file is:
316 .Bd -literal -offset indent
321 .Sh SUPPORTED CARDS: PCI bus
322 .Bl -tag -width Ds -compact
323 .It Ar "ELSA QuickStep 1000pro-PCI"
325 The required entry in the kernel config file is:
326 .Bd -literal -offset indent
330 The LED's are not supported and are off.
334 Note that all of ISA boards with i/o ports actually use several ranges
335 of port addresses; Teles happen to refer to the 0xd80 range in their
336 documentation (the board also uses 0x180 etc.), while AVM happen to refer
337 to the 0x200 range in their documentation (the board also uses 0x600 etc.)
338 The driver matches the manufacturers' description for the purposes of
339 configuration, but of course makes use of all the ports in order to
345 CCITT Recommendation I.430
350 driver and this manpage were written by
351 .An Hellmuth Michaelis Aq hm@FreeBSD.org .
352 It is based on earlier work of
356 .An Gary Jennejohn Aq gj@FreeBSD.org .
358 Since there is no hardware documentation available from the manufacturers
359 of several boards, it is likely that there are many bugs left.