share/man/man4/daic.4

   1 .\" $NetBSD: daic.4,v 1.9 2003/02/14 15:20:18 grant Exp $
   2 .\"
   3 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Martin Husemann <martin@NetBSD.org>.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd January 30, 1998
  31 .Dt DAIC 4
  32 .Os
  33 .Sh NAME
  34 .Nm daic
  35 .Nd isdn4bsd driver for EICON.Diehl active ISDN cards
  36 .Sh SYNOPSIS
  37 .Cd "daic0 at isa? iomem 0xd8000 irq 10"
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 driver supports the old Diehl active cards:
  42 .Em S, SX, SXn, SCOM
  43 and
  44 .Em QUADRO .
  45 .Pp
  46 For a
  47 .Em QUADRO
  48 card, the driver will detect the board type and use
  49 all four ports, each attached as a controller of its own to the
  50 isdn4bsd system, which can be listed using the daicctl utility.
  51 .Pp
  52 The
  53 .Nm
  54 driver interfaces the ISDN card to the ISDN4BSD kernel subsystem.
  55 All lower layer ISDN control is handled by the card. This should
  56 allow you to run any national ISDN protocol delivered by EICON.Diehl
  57 for your card, but the driver has only been tested with the DSS1
  58 protocol and some parts of the cards interface are ISDN protocol
  59 dependent.
  60 .Pp
  61 The
  62 .Nm
  63 driver is written to conform to the software interface documented
  64 by Diehl in their
  65 .Nm ISDN-Karten Benutzerhandbuch
  66 from 1992.
  67 .Sh MICROCODE DOWNLOAD
  68 Every active card needs its own operating software before it can
  69 work. You have to download this to the card before using it with
  70 isdn4bsd. Use the daicctl utility to do this, i.e. call
  71 .Nm "daicctl -d te_etsi.sx 1"
  72 to download the file
  73 .Nm te_etsi.sx
  74 to controller number 1. Use
  75 .Nm "daicctl -l"
  76 to list all available controllers (and ports). You have to select the
  77 correct ISDN protocol file for your ISDN interface, see the Diehl documentation
  78 for details.
  79 .Pp
  80 The cards bootstrap process involves another file, which is independent
  81 of the card type you use and the protocol you run. It is called
  82 .Nm download.bin
  83 in current versions of the Diehl software distribution and has to be
  84 copied to the kernel compile directory under
  85 .Nm dev/microcode/daic
  86 and converted into a header file used when compiling the kernel by running
  87 .Nm make
  88 in that directory. Your kernel compile will fail and remind you of this
  89 if you forget to do this. Due to copyright restrictions we cannot distribute
  90 the driver with this file integrated. But if you own a card, you do have
  91 the file (or can get it from the Diehl web server).
  92 .Sh SEE ALSO
  93 .Xr daicctl 1
  94 .Sh BUGS
  95 The driver is not yet finished.