share/man/man4/isic.4

   1 .\" $NetBSD: isic.4,v 1.14 2004/03/05 14:43:01 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1997, 2000 Hellmuth Michaelis. All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\"     $Id: isic.4,v 1.15 2005/06/23 12:47:38 peter Exp $
  27 .\"
  28 .\" $FreeBSD$
  29 .\"
  30 .\"     last edit-date: [Thu Mar 16 16:21:45 2000]
  31 .\"
  32 .Dd March 16, 2000
  33 .Dt ISIC 4
  34 .Os
  35 .Sh NAME
  36 .Nm isic
  37 .Nd isdn4bsd Siemens ISDN Chipset device driver
  38 .Sh SYNOPSIS
  39 On the ISA bus:
  40 .Pp
  41 Teles S0/8 or Niccy 1008 card:
  42 .Cd options ISICISA_TEL_S0_8
  43 .Cd "isic0 at isa? iomem 0xd0000 irq 5"
  44 .Pp
  45 Teles S0/16 or Creatix ISDN-S0 or Niccy 1016 card:
  46 .Cd options ISICISA_TEL_S0_16
  47 .Cd "isic0 at isa? port 0xd80 iomem 0xd0000 irq 5"
  48 .Pp
  49 Teles S0/16.3 card:
  50 .Cd options ISICISA_TEL_S0_16_3
  51 .Cd "isic0 at isa? port 0xd80 irq 5"
  52 .Pp
  53 AVM A1 or AVM Fritz card:
  54 .Cd options ISICISA_AVM_A1
  55 .Cd "isic0 at isa? port 0x340 irq 5"
  56 .Pp
  57 USRobotics Sportster ISDN TA internal or Stollmann Tina-pp card:
  58 .Cd options ISICISA_USR_STI
  59 .Cd "isic0 at isa? port 0x268 irq 5"
  60 .Pp
  61 ITK ix1 micro card:
  62 .Cd options ISICISA_ITKIX1
  63 .Cd "isic0 at isa? port 0x398 irq 10"
  64 .Pp
  65 On the ISAPNP bus:
  66 .Pp
  67 Teles S0/16.3 PnP card
  68 .Cd options ISICPNP_TEL_S0_16_3_P
  69 .Cd "isic* at isapnp?"
  70 .Pp
  71 Creatix ISDN-S0 P\*[Am]P card
  72 .Cd options ISICPNP_CRTX_S0_P
  73 .Cd "isic* at isapnp?"
  74 .Pp
  75 Dr. Neuhaus Niccy GO@
  76 .Cd options ISICPNP_DRN_NGO
  77 .Cd "isic* at isapnp?"
  78 .Pp
  79 ELSA QuickStep 1000pro (ISA version):
  80 .Cd options ISICPNP_ELSA_QS1ISA
  81 .Cd "isic* at isapnp?"
  82 .Pp
  83 Sedlbauer WinSpeed:
  84 .Cd options ISICPNP_SEDLBAUER
  85 .Cd "isic* at isapnp?"
  86 .Pp
  87 Dynalink IS64PH:
  88 .Cd options ISICPNP_DYNALINK
  89 .Cd "isic* at isapnp?"
  90 .Pp
  91 Cards on the PCI bus:
  92 .Pp
  93 ELSA QuickStep 1000pro (PCI version)
  94 .Cd "isic* at pci?"
  95 .Pp
  96 Cards on the PCMCIA or PCCARD bus:
  97 .Pp
  98 AVM Fritz!Card PCMCIA
  99 .Cd options ISICPCMCIA_AVM_A1
 100 .Cd "isic* at pcmcia? function ?"
 101 .Pp
 102 ELSA MicroLink ISDN/MC
 103 .Cd options ISICPCMCIA_ELSA_ISDNMC
 104 .Cd "isic* at pcmcia? function ?"
 105 .Pp
 106 ELSA MicroLink MC/all
 107 .Cd options ICISPCMCIA_ELSA_MCALL
 108 .Cd "isic* at pcmcia? function ?"
 109 .Pp
 110 Cards on the Amiga Zorro bus:
 111 .Pp
 112 BSC/ITH ISDN Master or MasterII, ITH ISDN MasterII, Individual Computers
 113 ISDN Surfer, VMC ISDN Blaster, or Zeus ISDN Link
 114 .Cd "aster* at zbus?"
 115 .Cd "isic* at aster? port ?"
 116 .Sh DESCRIPTION
 117 The
 118 .Nm
 119 driver provides D-channel layer 1 supports as specified in ITU Recommendation
 120 I.430 and layer 1 support for the B-channel.
 121 .Pp
 122 The driver supports several 8- and 16-bit passive ISDN cards from various
 123 manufacturers which are all based upon the popular Siemens ISDN chipset
 124 consisting of the ISDN Subscriber Access Controller ISAC (such as the
 125 PEB2085 or PSB 2186) and the High-Level Serial Communications Controller
 126 Extended HSCX (such as the SAB82525 or PSB21525). The newer IPAC chip
 127 (which integrates an ISAC and a HSCX in one chip, with the added benefit
 128 of larger FIFO buffers) is also supported.
 129 .Sh SUPPORTED CARDS
 130 .Bl -tag -width Ds -compact
 131 .It Ar Teles S0/8, Dr. Neuhaus Niccy 1008, Creatix ISDN-S0/8
 132 .Pp
 133 Notice that this cards must not have a
 134 .Em port
 135 value in the config line.
 136 .Pp
 137 Valid interrupts are 2, 3, 4, 5, 6 and 7.
 138 .Pp
 139 The i/o ports are memory mapped and the memory start address may
 140 be in the range 0xA0000 to 0xDF000 and uses 4kB of memory.
 141 .Pp
 142 The optional
 143 .Em flag
 144 value is 1.
 145 .Pp
 146 .It Ar Teles S0/16, Creatix ISDN-S0, Dr. Neuhaus Niccy 1016
 147 .Pp
 148 These boards have a jumper which specifies an i/o base address of either
 149 0xd80, 0xe80 or 0xf80. The remaining necessary configuration values are then
 150 programmed at run time by accessing this i/o port.
 151 .Pp
 152 Valid interrupts are 2, 3, 4, 5, 10, 11, 12 or 15.
 153 .Pp
 154 Valid memory start
 155 addresses are 0xC0000, 0xC2000, 0xC4000, 0xC6000, 0xC8000, 0xCA000, 0xCC000,
 156 0xCE000, 0xD0000, 0xD2000, 0xD4000, 0xD6000, 0xD8000, 0xDA000, 0xDC000 and
 157 0xDE000.
 158 .Pp
 159 Notice: Although the Jumpers are labeled 0xd80, 0xe80 or 0xf80, they
 160 also require i/o space at addresses 0x180, 0x280 or 0x380.
 161 .Pp
 162 The optional
 163 .Em flag
 164 value is 2.
 165 .Pp
 166 .It Ar Teles S0/16.3
 167 .Pp
 168 This card is completely i/o mapped and must not have an
 169 .Em iomem
 170 statement in the config line.
 171 .Pp
 172 Valid interrupts are 2, 5, 9, 10, 12 or 15.
 173 .Pp
 174 Notice: Although the switch positions are labeled 0x180, 0x280 and 0x380,
 175 the card is to be configured at 0xd80, 0xe80 or 0xf80 respectively!
 176 .Pp
 177 The optional
 178 .Em flag
 179 value is 3.
 180 .Pp
 181 .It Ar AVM A1, AVM Fritz!Card
 182 .Pp
 183 These boards have a jumper which specifies an i/o base address of either
 184 0x200, 0x240, 0x300 or 0x340.
 185 .Pp
 186 Valid interrupt configurations are 3, 4, 5, 6, 7, 10, 11, 12 or 15.
 187 .Pp
 188 Older Versions of the AVM A1 also require setting of an IRQ jumper, newer
 189 versions of this and the Fritz!Card only have an i/o base jumper and the
 190 interrupt is set up at runtime by reprogramming a register.
 191 .Pp
 192 This card is completely i/o mapped and must not have an
 193 .Em iomem
 194 statement in the config line.
 195 .Pp
 196 The optional
 197 .Em flag
 198 value is 4.
 199 .Pp
 200 .It Ar Teles S0/16.3 PnP
 201 .Pp
 202 Possible i/o port values are 0x580, 0x500 and 0x680.
 203 Possible interrupt configurations are 3, 5, 7, 10, 11 and 12.
 204 .Pp
 205 The card is autoconfigured by the PnP kernel subsystem.
 206 .Pp
 207 .It Ar Creatix ISDN-S0 P\*[Am]P
 208 .Pp
 209 Valid i/o port values are 0x120, 0x180 and 0x100.
 210 .Pp
 211 Valid interrupt configurations are 3, 5, 7, 10, 11 and 12.
 212 .Pp
 213 The card is autoconfigured by the PnP kernel subsystem.
 214 .Pp
 215 .It Ar "3Com USRobotics Sportster ISDN TA intern and Stollmann Tina pp"
 216 .Pp
 217 Valid i/o port values are 0x200, 0x208, 0x210, 0x218, 0x220, 0x228, 0x230,
 218 0x238, 0x240, 0x248, 0x250, 0x258, 0x260, 0x268, 0x270 and 0x278.
 219 .Pp
 220 Valid interrupt configurations are 5, 7, 10, 11, 12, 14, 15.
 221 .Pp
 222 Notice: this card has a strange address decoding scheme resulting in 64
 223 windows of some bytes length. Anyway, support for this card is good because
 224 the manufacturer gave out technical docs for this card!
 225 .Pp
 226 The optional
 227 .Em flag
 228 value is 7.
 229 .Pp
 230 .It Ar "Dr. Neuhaus Niccy Go@"
 231 .Pp
 232 Valid i/o port values must be in the range 0x200 ... 0x3e0.
 233 .Pp
 234 Valid interrupt configurations are 3, 4, 5, 9, 10, 11, 12, 15.
 235 .Pp
 236 The card is autoconfigured by the PnP kernel subsystem.
 237 .Pp
 238 .It Ar "Sedlbauer Win Speed"
 239 .Pp
 240 Valid i/o port values must be in the range 0x100 ... 0x3f0. (alignment 0x8,
 241 len 0x8)
 242 .Pp
 243 Valid interrupt configurations are 3, 4, 5, 7, 10, 11, 12, 13, 15.
 244 .Pp
 245 The card is autoconfigured by the PnP kernel subsystem.
 246 .Pp
 247 .It Ar "ELSA QuickStep 1000pro (ISA)"
 248 .Pp
 249 I/O port in the range 0x160 ... 0x360 (occupies 8 bytes).
 250 .Pp
 251 Valid interrupt configurations are 3, 4, 5, 7, 10, 11, 12, 15.
 252 .Pp
 253 The card is autoconfigured by the PnP kernel subsystem.
 254 .Pp
 255 .It Ar "ELSA QuickStep 1000pro-PCI"
 256 .Pp
 257 The card is autoconfigured by the PCI kernel subsystem.
 258 .Pp
 259 .It Ar "ITK ix1 micro"
 260 .Pp
 261 Valid i/o port values must be in the range (\*[Lt]unknown\*[Gt]).
 262 .Pp
 263 Valid interrupt configurations are (\*[Lt]unknown\*[Gt]).
 264 .Pp
 265 The optional
 266 .Em flag
 267 value is 18.
 268 .Pp
 269 .It Ar "BSC ISDN Master (2092/64)"
 270 .It Ar "BSC ISDN MasterII (2092/65)"
 271 .It Ar "ITH ISDN MasterII (5000/1)"
 272 .It Ar "VMC ISDN Blaster (5001/1)"
 273 .It Ar "Zeus ISDN Link (2189/3)"
 274 .Pp
 275 The card addresses are autoconfigured by the Zorro bus kernel subsystem.
 276 The ISDN functions of the boards are at known (to the driver) relative
 277 addresses.
 278 .Pp
 279 Note that currently, you have to jumper the card interrupt for
 280 .Em IPL 2
 281 instead of
 282 .Em IPL 6
 283 (which is used by most AmigaOS software).
 284 .Pp
 285 Note that the ITH ISDN MasterII doesn't work in the DraCo Zorro bus. This
 286 is not a
 287 .Nx Ns -specific
 288 problem, but a general one.
 289 .Pp
 290 .It Ar "Individual Computers ISDN Surfer (4626/5 serno 0)"
 291 .Pp
 292 The card addresses are autoconfigured by the Zorro bus kernel subsystem.
 293 The ISDN functions of the boards are at known (to the driver) relative
 294 addresses.
 295 .Pp
 296 The card is operated by the driver at
 297 .Em IPL 2
 298 instead of
 299 .Em IPL 6
 300 (which is used by most AmigaOS software). Because of this,
 301 if an AmigaOS driver did lock the interrupt priority level of the card, your
 302 system might hang soon after boot. In this case, boot using the boot block,
 303 or without enabling the AmigaOS driver if you use loadbsd.
 304 .El
 305 .Sh SEE ALSO
 306 .Xr isdnd 8
 307 .Sh STANDARDS
 308 CCITT Recommendation I.430
 309 .Sh AUTHORS
 310 .An -nosplit
 311 The
 312 .Nm
 313 driver and this man page were written by
 314 .An Hellmuth Michaelis Aq hm@kts.org .
 315 It is based on earlier work of
 316 .An Arne Helme ,
 317 .An Andrew Gordon
 318 and
 319 .An Gary Jennejohn .
 320 .Pp
 321 The complete porting to and maintenance of
 322 .Nx
 323 was done by
 324 .An Martin Husemann
 325 .Aq martin@NetBSD.org .
 326 .Pp
 327 The
 328 .Nx Ns / Ns amiga
 329 ISDN Blaster/Master/MasterII driver was written by
 330 .An Ignatios Souvatzis
 331 .Aq is@NetBSD.org .
 332 .Sh BUGS
 333 Note that all of the boards with I/O ports actually use several ranges
 334 of port addresses; Teles happen to refer to the 0xd80 range in their
 335 documentation (the board also uses 0x180 etc.), while AVM happen to refer
 336 to the 0x200 range in their documentation (the board also uses 0x600 etc.)
 337 The driver matches the manufacturers' description for the purposes of
 338 configuration, but of course makes use of all the ports in order to
 339 operate the card.
 340 .Pp
 341 Since there is no hardware documentation available from several manufacturers
 342 for their boards, it is likely that there are many, many bugs left.