433 lines
12 KiB
Groff
433 lines
12 KiB
Groff
.\"
|
|
.\" Copyright (c) 1997, 1999 Hellmuth Michaelis. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $Id: isic.4,v 1.26 1999/12/13 22:11:55 hm Exp $
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.\" last edit-date: [Mon Dec 13 23:16:08 1999]
|
|
.\"
|
|
.Dd July 30, 1999
|
|
.Dt ISIC 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm isic
|
|
.Nd isdn4bsd Siemens ISDN Chipset device driver
|
|
.Sh FreeBSD SYNOPSIS
|
|
.Pp
|
|
.Em Note:
|
|
the keywords
|
|
.Em net
|
|
and
|
|
.Em vector isicintr
|
|
are no longer required for FreeBSD-current (FreeBSD 4.x)!
|
|
.Pp
|
|
For a Teles S0/8 or Niccy 1008 card:
|
|
.Cd options \&"TEL_S0_8\&"
|
|
.Cd "device isic0 at isa? iomem 0xd0000 net irq 5 flags 1 vector isicintr"
|
|
.Pp
|
|
For a Teles S0/16 or Creatix ISDN-S0 or Niccy 1016 card:
|
|
.Cd options \&"TEL_S0_16\&"
|
|
.Cd "device isic0 at isa? port 0xd80 iomem 0xd0000 net irq 5 flags 2 vector isicintr"
|
|
.Pp
|
|
For a Teles S0/16.3 card:
|
|
.Cd options \&"TEL_S0_16_3\&"
|
|
.Cd "device isic0 at isa? port 0xd80 net irq 5 flags 3 vector isicintr"
|
|
.Pp
|
|
For an AVM A1 or AVM Fritz!Card classic:
|
|
.Cd options \&"AVM_A1\&"
|
|
.Cd "device isic0 at isa? port 0x340 net irq 5 flags 4 vector isicintr"
|
|
.Pp
|
|
For an AVM Fritz!Card PCMCIA:
|
|
.Cd options \&"AVM_A1\&"
|
|
.Cd options \&"AVM_A1_PCMCIA\&"
|
|
.Cd "device isic0 at isa? port 0x340 net irq 5 flags 10 vector isicintr"
|
|
.Pp
|
|
For an AVM Fritz!Card PnP:
|
|
.Cd options \&"AVM_PNP\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
For a Teles S0/16.3 PnP card (PnP):
|
|
.Cd options \&"TEL_S0_16_3_P\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
For a Creatix ISDN-S0 P&P card (PnP):
|
|
.Cd options \&"CRTX_S0_P\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
For an USRobotics Sportster ISDN TA internal or Stollmann Tina-pp card:
|
|
.Cd options \&"USR_STI\&"
|
|
.Cd "device isic0 at isa? port 0x268 net irq 5 flags 7 vector isicintr"
|
|
.Pp
|
|
For an ITK micro ix1 card:
|
|
.Cd options \&"ITKIX1\&"
|
|
.Cd "device isic0 at isa? port 0x398 net irq 10 flags 18 vector isicintr"
|
|
.Pp
|
|
For a Dr. Neuhaus Niccy Go@ (PnP):
|
|
.Cd options \&"DRN_NGO\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
For a Sedlbauer Win Speed card (PnP):
|
|
.Cd options \&"SEDLBAUER\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
For a Dynalink IS64PH (PnP):
|
|
.Cd options \&"DYNALINK\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
For an ELSA QuickStep 1000pro ISA (PnP):
|
|
.Cd options \&"ELSA_QS1ISA\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
For an ELSA QuickStep 1000pro PCI:
|
|
.Cd options \&"ELSA_QS1PCI\&"
|
|
.Cd "device isic0"
|
|
.Pp
|
|
For a Siemens I-Surf 2.0 PnP:
|
|
.Cd options \&"SIEMENS_ISURF2\&"
|
|
.Cd "device isic0 at isa? port ? net irq ? vector isicintr"
|
|
.Pp
|
|
.Ar FreeBSD PnP configuration:
|
|
.Pp
|
|
To be able to use PnP cards under FreeBSD, you have to add
|
|
.Pp
|
|
.Cd controller pnp0
|
|
.Pp
|
|
to you kernel config file.
|
|
More, it is recommended to add
|
|
.Pp
|
|
.Cd options \&"USERCONFIG\&"
|
|
.Pp
|
|
to your kernel config file to be able to adjust your PnP configuration
|
|
in case of trouble.
|
|
.Pp
|
|
See also:
|
|
.Xr pnp 4
|
|
and
|
|
.Xr boot 8
|
|
.Pp
|
|
.Sh NetBSD SYNOPSIS
|
|
On the ISA bus:
|
|
.Pp
|
|
For a Teles S0/8 or Niccy 1008 card:
|
|
.Cd options \&"TEL_S0_8\&"
|
|
.Cd "isic0 at isa? iomem 0xd0000 irq 5"
|
|
.Pp
|
|
For a Teles S0/16 or Creatix ISDN-S0 or Niccy 1016 card:
|
|
.Cd options \&"TEL_S0_16\&"
|
|
.Cd "isic0 at isa? port 0xd80 iomem 0xd0000 irq 5"
|
|
.Pp
|
|
For a Teles S0/16.3 card:
|
|
.Cd options \&"TEL_S0_16_3\&"
|
|
.Cd "isic0 at isa? port 0xd80 irq 5"
|
|
.Pp
|
|
For an AVM A1 or AVM Fritz card:
|
|
.Cd options \&"AVM_A1\&"
|
|
.Cd "isic0 at isa? port 0x340 irq 5"
|
|
.Pp
|
|
For an USRobotics Sportster ISDN TA internal or Stollmann Tina-pp card:
|
|
.Cd options \&"USR_STI\&"
|
|
.Cd "isic0 at isa? port 0x268 irq 5"
|
|
.Pp
|
|
For an ITK ix1 micro card:
|
|
.Cd options \&"ITKIX1\&"
|
|
.Cd "isic0 at isa? port 0x398 irq 10"
|
|
.Pp
|
|
On the ISAPNP bus:
|
|
.Pp
|
|
For a Teles S0/16.3 PnP card
|
|
.Cd options \&"TEL_S0_16_3_P\&"
|
|
.Cd "isic* at isapnp?"
|
|
.Pp
|
|
For a Creatix ISDN-S0 P&P card
|
|
.Cd options \&"CRTX_S0_P\&"
|
|
.Cd "isic* at isapnp?"
|
|
.Pp
|
|
For a Dr. Neuhaus Niccy GO@
|
|
.Cd options \&"DRN_NGO\&"
|
|
.Cd "isic* at isapnp?"
|
|
.Pp
|
|
For an ELSA QuickStep 1000pro (ISA version):
|
|
.Cd options \&"ELSA_QS1ISA\&"
|
|
.Cd "isic* at isapnp?"
|
|
.Pp
|
|
For a Sedlbauer WinSpeed:
|
|
.Cd options \&"SEDLBAUER\&"
|
|
.Cd "isic* at isapnp?"
|
|
.Pp
|
|
For a Dynalink IS64PH:
|
|
.Cd options \&"DYNALINK\&"
|
|
.Cd "isic* at isapnp?"
|
|
.Pp
|
|
Cards on the PCI bus:
|
|
.Pp
|
|
For an ELSA QuickStep 1000pro (PCI version)
|
|
.Cd options \&"ELSA_QS1PCI\&"
|
|
.Cd "isic* at pci?"
|
|
.Pp
|
|
Cards on the PCMCIA or PCCARD bus:
|
|
.Pp
|
|
For an AVM Fritz!Card PCMCIA
|
|
.Cd options \&"AVM_A1_PCMCIA\&"
|
|
.Cd "isic* at pcmcia? function ?"
|
|
.Pp
|
|
For an ELSA MicroLink ISDN/MC
|
|
.Cd options \&"ELSA_ISDNMC\&"
|
|
.Cd "isic* at pcmcia? function ?"
|
|
.Pp
|
|
For an ELSA MicroLink MC/all
|
|
.Cd options \&"ELSA_MCALL\&"
|
|
.Cd "isic* at pcmcia? function ?"
|
|
.Pp
|
|
Cards on the Amiga Zorro bus:
|
|
.Pp
|
|
For a BSC/ITH ISDN Master, ITH ISDN MasterII or VMC ISDN Blaster
|
|
.Cd "aster* at zbus?"
|
|
.Cd "isic* at aster? port ?"
|
|
.Pp
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
driver provides D-channel layer 1 supports as specified in ITU Recommendation
|
|
I.430 and layer 1 support for the B-channel.
|
|
.Pp
|
|
The driver supports several 8 and 16bit passive ISDN cards from various
|
|
manufacturers which are all based upon the popular Siemens ISDN chipset
|
|
consisting of the ISDN Subscriber Access Controller ISAC (such as the
|
|
PEB2085 or PSB 2186) and the High-Level Serial Communications Controller
|
|
Extended HSCX (such as the SAB82525 or PSB21525). The newer IPAC chip
|
|
(which integrates an ISAC and a HSCX in one chip, with the added benefit
|
|
of larger FIFO buffers) is also supported.
|
|
.Pp
|
|
.Sh SUPPORTED CARDS
|
|
.Pp
|
|
.Bl -tag -width Ds -compact -offset
|
|
.It Ar Teles S0/8, Dr. Neuhaus Niccy 1008, Creatix ISDN-S0/8
|
|
.Pp
|
|
The required (optional for NetBSD)
|
|
.Em flag
|
|
value is 1.
|
|
.Pp
|
|
Notice that this cards must not have a
|
|
.Em port
|
|
value in the config line.
|
|
.Pp
|
|
Valid interrupts are 2, 3, 4, 5, 6 and 7.
|
|
.Pp
|
|
The i/o ports are memory mapped and the memory start address may
|
|
be in the range 0xA0000 to 0xDF000 and uses 4kB of memory.
|
|
.Pp
|
|
.It Ar Teles S0/16, Creatix ISDN-S0, Dr. Neuhaus Niccy 1016
|
|
.Pp
|
|
The required (optional under NetBSD)
|
|
.Em flag
|
|
value is 2.
|
|
.Pp
|
|
These boards have a jumper which specifies an i/o base address of either
|
|
0xd80, 0xe80 or 0xf80.
|
|
The remaining necessary configuration values are then
|
|
programmed at run time by accessing this i/o port.
|
|
.Pp
|
|
Valid interrupts are 2, 3, 4, 5, 10, 11, 12 or 15.
|
|
.Pp
|
|
Valid memory start
|
|
addresses are 0xC0000, 0xC2000, 0xC4000, 0xC6000, 0xC8000, 0xCA000, 0xCC000,
|
|
0xCE000, 0xD0000, 0xD2000, 0xD4000, 0xD6000, 0xD8000, 0xDA000, 0xDC000 and
|
|
0xDE000.
|
|
.Pp
|
|
Notice: Although the Jumpers are labeled 0xd80, 0xe80 or 0xf80, they
|
|
also require i/o space at addresses 0x180, 0x280 or 0x380.
|
|
.Pp
|
|
.It Ar Teles S0/16.3
|
|
.Pp
|
|
The required (optional under NetBSD)
|
|
.Em flag
|
|
value is 3.
|
|
.Pp
|
|
This card is completely i/o mapped and must not have an
|
|
.Em iomem
|
|
statement in the config line.
|
|
.Pp
|
|
Valid interrupts are 2, 5, 9, 10, 12 or 15.
|
|
.Pp
|
|
Notice: Although the switch positions are labeled 0x180, 0x280 and 0x380,
|
|
the card is to be configured at 0xd80, 0xe80 or 0xf80 respectively!
|
|
.Pp
|
|
.It Ar AVM A1, AVM Fritz!Card
|
|
.Pp
|
|
The required (optional under NetBSD)
|
|
.Em flag
|
|
value is 4.
|
|
.Pp
|
|
These boards have a jumper which specifies an i/o base address of either
|
|
0x200, 0x240, 0x300 or 0x340.
|
|
.Pp
|
|
Valid interrupt configurations are 3, 4, 5, 6, 7, 10, 11, 12 or 15.
|
|
.Pp
|
|
Older Versions of the AVM A1 also require setting of an IRQ jumper, newer
|
|
versions of this and the Fritz!Card only have an i/o base jumper and the
|
|
interrupt is setup at runtime by reprogramming a register.
|
|
.Pp
|
|
This card is completely i/o mapped and must not have an
|
|
.Em iomem
|
|
statement in the config line.
|
|
.Pp
|
|
.It Ar Teles S0/16.3 PnP
|
|
.Pp
|
|
Possible i/o port values are 0x580, 0x500 and 0x680.
|
|
Possible interrupt configurations are 3, 5, 7, 10, 11 and 12.
|
|
.Pp
|
|
The the card is auto-configured by the PnP kernel subsystem.
|
|
.Pp
|
|
.It Ar Creatix ISDN-S0 P&P
|
|
.Pp
|
|
Valid i/o port values are 0x120, 0x180 and 0x100.
|
|
.Pp
|
|
Valid interrupt configurations are 3, 5, 7, 10, 11 and 12.
|
|
.Pp
|
|
The card is auto-configured by the PnP kernel subsystem.
|
|
.Pp
|
|
.It Ar "3Com USRobotics Sportster ISDN TA intern and Stollmann Tina pp"
|
|
.Pp
|
|
The required (optional for NetBSD)
|
|
.Em flag
|
|
value is 7.
|
|
.Pp
|
|
Valid i/o port values are 0x200, 0x208, 0x210, 0x218, 0x220, 0x228, 0x230,
|
|
0x238, 0x240, 0x248, 0x250, 0x258, 0x260, 0x268, 0x270 and 0x278.
|
|
.Pp
|
|
Valid interrupt configurations are 5, 7, 10, 11, 12, 14, 15.
|
|
.Pp
|
|
Notice: this card has a strange address decoding scheme resulting in 64
|
|
windows of some bytes length.
|
|
Anyway, support for this card is good because
|
|
the manufacturer gave out technical docs for this card!
|
|
.Pp
|
|
.Pp
|
|
.It Ar "Dr. Neuhaus Niccy Go@"
|
|
.Pp
|
|
Valid i/o port values must be in the range 0x200 ... 0x3e0.
|
|
.Pp
|
|
Valid interrupt configurations are 3, 4, 5, 9, 10, 11, 12, 15.
|
|
.Pp
|
|
The card is auto-configured by the PnP kernel subsystem.
|
|
.Pp
|
|
.It Ar "Sedlbauer Win Speed"
|
|
.Pp
|
|
Valid i/o port values must be in the range 0x100 ... 0x3f0.
|
|
(alignment 0x8,
|
|
len 0x8)
|
|
.Pp
|
|
Valid interrupt configurations are 3, 4, 5, 7, 10, 11, 12, 13, 15.
|
|
.Pp
|
|
The card is auto-configured by the PnP kernel subsystem.
|
|
.Em FreeBSD:
|
|
This card is PnP only, and so it can be configured using USERCONFIG
|
|
('man 4 pnp'). This can be done via
|
|
.Em /kernel.config
|
|
\&. For example:
|
|
.Pp
|
|
.Cd USERCONFIG
|
|
.Cd pnp 1 0 os enable port0 0x270 irq0 10
|
|
.Cd quit
|
|
.Pp
|
|
.Pp
|
|
.It Ar "ELSA QuickStep 1000pro (ISA)"
|
|
.Pp
|
|
I/O port in the range 0x160 ... 0x360 (occupies 8 bytes).
|
|
.Pp
|
|
Valid interrupt configurations are 3, 4, 5, 7, 10, 11, 12, 15.
|
|
.Pp
|
|
The card is auto-configured by the PnP kernel subsystem.
|
|
.Pp
|
|
.Pp
|
|
.It Ar "ELSA QuickStep 1000pro-PCI"
|
|
.Pp
|
|
The card is auto-configured by the PCI kernel subsystem.
|
|
.Pp
|
|
.Pp
|
|
.It Ar "ITK ix1 micro"
|
|
.Pp
|
|
The required (optional under NetBSD)
|
|
.Em flag
|
|
value is 18.
|
|
.Pp
|
|
Valid i/o port values must be in the range (<unknown>).
|
|
.Pp
|
|
Valid interrupt configurations are (<unknown>).
|
|
.Pp
|
|
.It Ar "BSC ISDN Master"
|
|
.It Ar "ITH ISDN MasterII"
|
|
.It Ar "VMC ISDN Blaster"
|
|
.Pp
|
|
The card addresses are auto-configured by the Zorro bus kernel subsystem.
|
|
The ISDN functions of the boards are at known (to the driver) relative
|
|
addresses.
|
|
.Pp
|
|
Note that currently, you have to jumper the card interupt for
|
|
.Em IPL 2
|
|
instead of IPL 6 (which is used by most AmigaOS software).
|
|
.Pp
|
|
Note that the ITH ISDN MasterII doesn't work in the DraCo Zorro bus.
|
|
This
|
|
is no NetBSD problem, but general.
|
|
.El
|
|
.Pp
|
|
.Sh CAVEATS
|
|
Note that all of the boards with I/O ports actually use several ranges
|
|
of port addresses; Teles happen to refer to the 0xd80 range in their
|
|
documentation (the board also uses 0x180 etc.), while AVM happen to refer
|
|
to the 0x200 range in their documentation (the board also uses 0x600 etc.)
|
|
The driver matches the manufacturers' description for the purposes of
|
|
configuration, but of course makes use of all the ports in order to
|
|
operate the card.
|
|
.Pp
|
|
.Sh BUGS
|
|
Since there is no hardware documentation available from several manufacturers
|
|
for their boards, it is likely that there are many, many bugs left.
|
|
|
|
.Sh STANDARDS
|
|
CCITT Recommendation I.430
|
|
|
|
.Sh SEE ALSO
|
|
.Xr i4bq921 4
|
|
.Xr i4bq931 4
|
|
|
|
.Sh AUTHOR
|
|
The
|
|
.Nm
|
|
driver and this manpage were written by
|
|
.An Hellmuth Michaelis Aq hm@kts.org .
|
|
It is based on earlier work of
|
|
.An Arne Helme ,
|
|
.An Andrew Gordon
|
|
and
|
|
.An Gary Jennejohn .
|
|
.Pp
|
|
The complete porting to and maintenance of NetBSD was done by
|
|
.An Martin Husemann Aq martin@rumolt.teuto.de .
|
|
.Pp
|
|
The NetBSD/Amiga ISDN Blaster/Master/MasterII driver was written by
|
|
.An Ignatios Souvatzis Aq is@netbsd.org .
|