41bbd45191
part manual pages - long overdue ...
362 lines
9.6 KiB
Groff
362 lines
9.6 KiB
Groff
.\"
|
|
.\" Copyright (c) 1997, 2002 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.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.\" last edit-date: [Sun Jul 28 20:14:24 2002]
|
|
.\"
|
|
.Dd July 28, 2002
|
|
.Dt ISIC 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm isic
|
|
.Nd isdn4bsd Siemens ISDN Chipset device driver
|
|
.Sh SYNOPSIS
|
|
.Cd "device isic"
|
|
.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 ISA, ISA PnP and PCI
|
|
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.
|
|
.Sh SUPPORTED CARDS: ISA bus, NON-PnP
|
|
.Bl -tag -width Ds -compact
|
|
.It Ar Teles S0/8, Dr. Neuhaus Niccy 1008, Creatix ISDN-S0/8
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options TEL_S0_8
|
|
.Ed
|
|
.Pp
|
|
The required entry in
|
|
.Xr device.hints 5
|
|
file is:
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
hint.isic.0.at="isa"
|
|
hint.isic.0.maddr="0xd0000"
|
|
hint.isic.0.irq="5"
|
|
hint.isic.0.flags="1"
|
|
.Ed
|
|
.Pp
|
|
Notice that this cards must not have a
|
|
.Em port
|
|
value.
|
|
.Pp
|
|
Valid values for hint.isic.N.irq are 2, 3, 4, 5, 6 and 7.
|
|
.Pp
|
|
The i/o ports are memory mapped and the memory start address (hint.isic.N.maddr)
|
|
may be in the range 0xA0000 to 0xDF000 and use a region of 4kB of memory.
|
|
.Pp
|
|
.It Ar Teles S0/16, Creatix ISDN-S0, Dr. Neuhaus Niccy 1016
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options TEL_S0_16
|
|
.Ed
|
|
.Pp
|
|
The required entry in
|
|
.Xr device.hints 5
|
|
file is:
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
hint.isic.0.at="isa"
|
|
hint.isic.0.port="0xd80"
|
|
hint.isic.0.maddr="0xd0000"
|
|
hint.isic.0.irq="5"
|
|
hint.isic.0.flags="2"
|
|
.Ed
|
|
.Pp
|
|
These boards have a jumper which specifies an i/o base address
|
|
(hint.isic.N.port) 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 (hint.isic.N.irq) are 2, 3, 4, 5, 10, 11, 12 or 15.
|
|
.Pp
|
|
Valid memory start addresses (hint.isic.N.maddr) 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 entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options TEL_S0_16_3
|
|
.Ed
|
|
.Pp
|
|
The required entry in
|
|
.Xr device.hints 5
|
|
file is:
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
hint.isic.0.at="isa"
|
|
hint.isic.0.port="0xd80"
|
|
hint.isic.0.irq="5"
|
|
hint.isic.0.flags="3"
|
|
.Ed
|
|
.Pp
|
|
This card is completely i/o mapped and must not have an
|
|
.Em maddr
|
|
statement in the hints file.
|
|
.Pp
|
|
Valid interrupts (hint.isic.N.irq) are 2, 5, 9, 10, 12 or 15.
|
|
.Pp
|
|
These boards have a jumper which specifies an i/o base address
|
|
(hint.isic.N.port) of either 0xd80, 0xe80 or 0xf80.
|
|
.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 and AVM Fritz!Card
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options AVM_A1
|
|
.Ed
|
|
.Pp
|
|
The required entry in
|
|
.Xr device.hints 5
|
|
file is:
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
hint.isic.0.at="isa"
|
|
hint.isic.0.port="0x340"
|
|
hint.isic.0.irq="5"
|
|
hint.isic.0.flags="4"
|
|
.Ed
|
|
.Pp
|
|
These boards have a jumper which specifies an i/o base address (hint.isic.N.port)
|
|
of either 0x200, 0x240, 0x300 or 0x340.
|
|
.Pp
|
|
Valid interrupt (hint.isic.N.irq) values 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
|
|
.It Ar USRobotics Sportster ISDN TA intern and Stollmann Tina pp
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options USR_STI
|
|
.Ed
|
|
.Pp
|
|
The required entry in
|
|
.Xr device.hints 5
|
|
file is:
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
hint.isic.0.at="isa"
|
|
hint.isic.0.port="0x268"
|
|
hint.isic.0.irq="5"
|
|
hint.isic.0.flags="7"
|
|
.Ed
|
|
.Pp
|
|
Valid i/o port values (hint.isic.N.port) are 0x200, 0x208, 0x210, 0x218,
|
|
0x220, 0x228, 0x230, 0x238, 0x240, 0x248, 0x250, 0x258, 0x260, 0x268,
|
|
0x270 and 0x278.
|
|
.Pp
|
|
Valid interrupt (hint.isic.N.irq) values are 5, 7, 10, 11, 12, 14, 15.
|
|
.Pp
|
|
Notice: this card has a strange address decoding scheme resulting in
|
|
occupying 64 windows of some bytes length over the whole i/o address
|
|
range.
|
|
.Pp
|
|
.It Ar ITK ix1 Micro ( < V.3, non-PnP version )
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options ITKIX1
|
|
.Ed
|
|
.Pp
|
|
The required entry in
|
|
.Xr device.hints 5
|
|
file is:
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
hint.isic.0.at="isa"
|
|
hint.isic.0.port="0x398"
|
|
hint.isic.0.irq="10"
|
|
hint.isic.0.flags="18"
|
|
.Ed
|
|
.Pp
|
|
Valid i/o port values must be in the range (<unknown>).
|
|
.Pp
|
|
Valid interrupt configurations are (<unknown>).
|
|
.Pp
|
|
.It Ar ELSA MicroLink ISDN/PCC-16 and ELSA PCFpro
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options ELSA_PCC16
|
|
.Ed
|
|
.Pp
|
|
The required entry in
|
|
.Xr device.hints 5
|
|
file is:
|
|
.Pp
|
|
.Bd -literal -offset indent
|
|
hint.isic.0.at="isa"
|
|
hint.isic.0.port="0x360"
|
|
hint.isic.0.irq="10"
|
|
hint.isic.0.flags="20"
|
|
.Ed
|
|
.Pp
|
|
Valid i/o port (hint.isic.N.port) values are 0x160, 0x170, 0x260 and 0x360.
|
|
.Pp
|
|
Valid interrupt (hint.isic.N.irq) values are 2, 3, 5, 10, 11 and 15.
|
|
.Pp
|
|
The LED's are not supported and are off.
|
|
.Pp
|
|
.El
|
|
.Sh SUPPORTED CARDS: ISA bus, PnP (Plug 'n Pray)
|
|
.Bl -tag -width Ds -compact
|
|
.It Ar Teles S0/16.3 PnP
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options TEL_S0_16_3_P
|
|
.Ed
|
|
.Pp
|
|
.It Ar Creatix ISDN-S0 P&P
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options CRTX_S0_P
|
|
.Ed
|
|
.Pp
|
|
.It Ar "Dr. Neuhaus Niccy Go@"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options DRN_NGO
|
|
.Ed
|
|
.Pp
|
|
.It Ar "Sedlbauer Win Speed"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options SEDLBAUER
|
|
.Ed
|
|
.Pp
|
|
.It Ar "Dynalink IS64PH"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options DYNALINK
|
|
.Ed
|
|
.Pp
|
|
.It Ar "ELSA QuickStep 1000pro ISA"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options ELSA_QS1ISA
|
|
.Ed
|
|
.Pp
|
|
The LED's are not supported and are off.
|
|
.Pp
|
|
.It Ar "Siemens I-Surf 2.0"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options SIEMENS_ISURF2
|
|
.Ed
|
|
.Pp
|
|
.It Ar "Asuscom ISDNlink 128K ISA"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options ASUSCOM_IPAC
|
|
.Ed
|
|
.Pp
|
|
.It Ar "Eicon Diehl DIVA 2.0 and 2.02"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options EICON_DIVA
|
|
.Ed
|
|
.Pp
|
|
.It Ar "Compaq Microcom 610 ISDN card (Compaq series PSB2222I)"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options COMPAQ_M610
|
|
.Ed
|
|
.Pp
|
|
.El
|
|
.Sh SUPPORTED CARDS: PCI bus
|
|
.Bl -tag -width Ds -compact
|
|
.It Ar "ELSA QuickStep 1000pro-PCI"
|
|
.Pp
|
|
The required entry in the kernel config file is:
|
|
.Bd -literal -offset indent
|
|
options ELSA_QS1PCI
|
|
.Ed
|
|
.Pp
|
|
The LED's are not supported and are off.
|
|
.Pp
|
|
.El
|
|
.Sh CAVEATS
|
|
Note that all of ISA 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.
|
|
.Sh BUGS
|
|
Since there is no hardware documentation available from the manufacturers
|
|
of several boards, it is likely that there are many bugs left.
|
|
.Sh STANDARDS
|
|
CCITT Recommendation I.430
|
|
.Sh SEE ALSO
|
|
.Xr i4bq921 4 ,
|
|
.Xr i4bq931 4
|
|
.Sh AUTHORS
|
|
.An -nosplit
|
|
The
|
|
.Nm
|
|
driver and this manpage were written by
|
|
.An Hellmuth Michaelis Aq hm@freebsd.org .
|
|
It is based on earlier work of
|
|
.An Arne Helme ,
|
|
.An Andrew Gordon
|
|
and
|
|
.An Gary Jennejohn Aq gj@freebsd.org .
|
|
|
|
|