ISDN4BSD driver


Version 1_7_4
=============


FEATURES
========

  - support for kernel echo canceller (HFC-chips only)
  - support for EuroISDN, DSS1 (point to point and point to multipoint)
  - support for overlap sending and dial in digits
  - support for hold and retrieve in NT- and TE-mode
  - support for MCID in TE-mode
  - support for call deflection in TE-mode
  - support for line interconnect
  - support for early B-channel connection when dialing out
  - support for Basic Rate Interface, 2xB, in software and hardware
  - support for Primary Rate Interface, 30xB, in software and hardware
  - driver uses a per controller mutex to protect data and chip access
  - direct access to D-channel and B-channels through /dev/ihfcX.Y
  - full support for NT-mode in software and hardware **
  - cloneable "/dev/i4b"
  - new "CAPI 2.0" application interface
  - new "DSS1" protocol
  - support for DSS1 protocol tracing through "isdntrace"
  - support for DSS1 protocol decoding through "isdndecode"
  - backwards compatible "isdnd"
  - support for building I4B like a kernel module.

** not all hardware can run NT-mode


SUPPORTED OPERATING SYSTEMS
===========================

 - FreeBSD-6-current
 - FreeBSD-7-current
 - FreeBSD-8-current
 - FreeBSD-9-current

 - NetBSD 2.x.x
 - NetBSD 3.x.x
 - NetBSD 4.x.x
 - NetBSD 5.x.x


SUPPORTED HARDWARE
==================

 - IPAC
 - ISAC 
 - HSCX 
 - HFC (PCI and USB)
 - WINBOND (PCI and USB)

For a list of supported hardware, see "man ihfc" after install.


CHANGES SINCE LAST VERSION
==========================

 - minor code and compilation fixes
 - see svn log for more information


HOW TO INSTALL AS ROOT ON FREEBSD
=================================

Download the three files below into a new directory and type "make install".
To uninstall type "make deinstall".

MD5 (releases/FreeBSD/1_7_4/Makefile) = a2f2c986d2bb2709932650df2a38405e
MD5 (releases/FreeBSD/1_7_4/Makefile.v1) = 0f78dcddbeb854b845c31a2b74cefe05
MD5 (releases/FreeBSD/1_7_4/Makefile.v2) = de870c044ee30790d25ee319aa8baa53
MD5 (releases/FreeBSD/1_7_4/new_ihfc_1_7_4.diff.bz2) = 4059d198768f9f8dc9372dc1c54bc3c3
MD5 (releases/FreeBSD/1_7_4/new_ihfc_1_7_4.tar.bz2) = 3640949b5fac229a7c46762381a3117e


fetch http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_7_4/Makefile
fetch http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_7_4/Makefile.v1
fetch http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_7_4/Makefile.v2
fetch http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_7_4/new_ihfc_1_7_4.tar.bz2
fetch http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_7_4/new_ihfc_1_7_4.diff.bz2

Type "make help" for more help.

If one has got the source tree in a directory different from "/usr/src",
simply use "make S=/usr/mydirectory install". The only files that will
not get installed there is a copy of the header files, which are
always installed in /usr/include/....


HOW TO INSTALL AS ROOT ON NETBSD
================================

#
# Please checkout from I4B SVN and follow the instructions given by
# "i4b/trunk/i4b/README.TXT".
#

svn --username anonsvn --password anonsvn \
      checkout svn://svn.turbocat.net/i4b


HOW TO INSTALL CHAN_CAPI ON FREEBSD AND NETBSD
==============================================

#
# Dependencies:
# - Subversion must be installed, see "/usr/ports/devel/subversion"
# - Asterisk must be installed, see "/usr/ports/net/asterisk" and
#   "/usr/ports/net/asterisk16"
#

#
# Please checkout "chan_capi" from I4B SVN:
#

svn --username anonsvn --password anonsvn \
      checkout svn://svn.turbocat.net/i4b/trunk/chan_capi

#
# I4B chan_capi is installed like this:
#

cd chan_capi
gmake clean
gmake all install

#
# Example configuration files are located at 
# "chan_capi/capi.conf" and 
# "chan_capi/extensions.conf".
#


HOW TO SET NT-MODE AND OTHER PARAMETERS
=======================================

ISDN4BSD now has a new utility called "isdnconfig" that
can be used to configure I4B. See "man isdnconfig" for 
more information.

It is also possible to set NT-mode by adding the following 
lines to the "SYSTEM section" in the file "/etc/isdn/isdnd.rc":

controller 0
#
# uncomment the next line to
# enable NT-mode for controller 0:
#
# driver_type = DRVR_DSS1_NT
#
controller 63
#
# driver_type = DRVR_DSS1_NT
#


QUICK TEST
==========

One can easily test that ones setup is working by using the utility
"capitest". See "man capitest" after install for more information.


HOW TO OBTAIN THE LATEST VERSION OF ISDN4BSD 
AND CHAN_CAPI, FOR NETBSD AND FREEBSD
=============================================

#
# Dependency:
# - Subversion must be installed, see "/usr/ports/devel/subversion"
#

svn --username anonsvn --password anonsvn \
    checkout svn://svn.turbocat.net/i4b


MALLING LIST
============
freebsd-isdn@freebsd.org


NOTES
=====

The "controller" keyword in "isdnd.rc" can now take an optional unit
number.

HFC-4S/8S and HFC-E1 based cards are now booted in PCM-slave mode. Use
"isdnconfig" to set PCM-master mode for single card usage.

The ISDN4BSD CAPI library is 99% compatible with the Linux CAPI
library.

--HPS