Press here to show the print version.

Version 1_6_1
=============


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
  - new "isdnphone" that uses a kernel soundbridge
  - new "isdntrace"
  - new "isdndecode"
  - new "isdnd"

** not all hardware can run NT-mode


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

 - FreeBSD-6-current
 - FreeBSD-7-current

 - NetBSD 2.x.x
 - NetBSD 3.x.x


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

 - IPAC
 - ISAC 
 - HSCX 
 - HFC 
 - WINBOND 
 - OHCI 
 - UHCI 
 - EHCI

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


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

 - compilation fixes
 - USB was updated
 - support for HFC-4S and HFC-8S (fully tested)
 - and more (see SVN log)


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".

http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_6_1/Makefile
http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_6_1/new_ihfc_1_6_1.tar.bz2
http://www.turbocat.net/~hselasky/isdn4bsd/releases/FreeBSD/1_6_1/new_ihfc_1_6_1.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
================================

Download the following tarball:

http://www.turbocat.net/~hselasky/isdn4bsd/releases/NetBSD/1_6_1/i4b_1_6_1.tar.bz2

Extract it using "tar -jxvf i4b_1_6_1.tar.bz2", read
"i4b_1_6_1/README.TXT" and follow the instructions.


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"
#
#
# Download the following tarball:
#

http://www.turbocat.net/~hselasky/capi4pbx/releases/chan_capi_1_6_1.tar.bz2 

# 
# Extract it using "tar -jxvf chan_capi_1_6_1.tar.bz2", and run:
#

cd chan_capi_1_6_1
gmake all install

#
# Example configuration files are located at 
# "chan_capi_1_6_1/capi.conf" and 
# "chan_capi_1_6_1/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.

All I4B header files were moved from "/usr/include/machine/" and
"/usr/src/sys/i386/include", to "/usr/include/i4b/include" and
"/sys/i4b/include", including "capi20.h".

The ISDN4BSD CAPI library is 99% compatible with the Linux CAPI
library.  To make a Linux CAPI application compile on FreeBSD one only
needs to include the file "/usr/include/i4b/include/capi20.h" and make
a few one-line patches.  See "man capi20" for how to resolve those
one-liners.  There is no need to install "liblinuxcapi" !

ISDN4BSD controller 0, is CAPI controller 0. If ones application
cannot handle that, one can add a few lines of code that switches "0"
to "MAX_CONTROLLER" in incoming frames. ISDN4BSD will accept both "0"
and "MAX_CONTROLLER" as controller "0".

See "/usr/src/usr.sbin/i4b/capitest/main.c" for an example on how to
take full advantage of the ISDN4BSD CAPI 2.0 implementation.

See "/usr/src/usr.sbin/i4b/isdntest/main.c" if one wants to stay
updated on the I4B API.

As a consequence of the changes I have made, one can now run
"isdntest" while "isdnd" is running. I have plans to make the device
allocation dynamic, so that applications can allocate devices like
"/dev/i4btelX" dynamically, without need for configuration. Until
further all the "counts" have been put in
"/sys/i4b/include/i4b_global.h". If one needs more than 8 units please
edit that file.

The driver now supports all cards that are supported by the official
version of I4B. So if one has got an ISDN device the chances should be
good that this driver will support it.

--HPS