Press here to show the print version.

Version 1.5.5 (pre-release #3)
==============================

List of features:
=================

	- support for EuroISDN, DSS1
	- support for overlap sending and dial in digits
	- 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 mutex to protect data and chip access
	- direct access to D-channel and B-channels
	- 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

About the driver:
=================

The driver should at least work with:
 - FreeBSD-5.3
 - FreeBSD-5.4
 - FreeBSD-5-current
 - FreeBSD-6-current
 - FreeBSD-7-current

The driver supports generic 
IPAC / ISAC / HSCX / HFC / WINBOND / OHCI / UHCI / EHCI chips.

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

Changes since last version:
===========================

	- support for primary rate, E1 
	- speed improvements 
	- security improvements 
	- compilation fixes 
	- added support for CAPI 2.0 
	- /dev/i4b is now cloneable 
	- some code rewritten 

How to install:
===============

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

http://home.c2i.net/hselasky/isdn4bsd/privat/temporary/155/Makefile
http://home.c2i.net/hselasky/isdn4bsd/privat/temporary/new_ihfc_1_5_5.tar.bz2
http://home.c2i.net/hselasky/isdn4bsd/privat/temporary/new_ihfc_1_5_5.diff.bz2

Type "make help" for more help.

If you have 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 here is a copy of the header files, which is always installed
in /usr/include/....


How to use NT-mode:
===================

To use NT-mode you need to add 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 # 1
controller # 2
controller # n

# USB controllers start at n = 7 and decrements
# Also see "man isdnd.rc".
#
# Another way to set NT-mode is to use the new utility "isdnconfig".
# See "man isdnconfig".
#

Third party software:
=====================

The chan_capi module, http://sourceforge.net/projects/chan-capi, 
for Asterisk, http://www.asterisk.org, works. You need to download
the CVS version. No patching or additional libraries are required.

Quick install (when asked for password, just press enter):

cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/chan-capi login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/chan-capi co -P chan_capi 

cd chan_capi
gmake all install

#
# NOTE: you must have Asterisk preinstalled. See "/usr/ports/net/asterisk".
#
# One can find sample configuration files here:
#
# http://home.c2i.net/hselasky/isdn4bsd/privat/temporary/asterisk/
#

NetBSD port:
============

There is a NetBSD port of this driver that currently only supports PCI
ISDN devices, primary rate and basic rate. It is available by using
the following subversion command:

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

There is a readme file, "i4b/devfs/trunk/README.TXT", that explains
more. The directories, "devfs/trunk" are just historical, and might be
renamed. Thanks to "turbocat.net" for providing the SVN account.

Here is a tarball:

http://home.c2i.net/hselasky/isdn4bsd/privat/temporary/new_ihfc_1_5_5_NetBSD.tar.bz2


NOTES:
======

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 you only need to include 
the file "/usr/include/i4b/include/capi20.h" and make a few one-line patches. 
See "man capi" for how to resolve those one-liners. 
There is no need to install "liblinuxcapi" !

ISDN4BSD controller 0, is CAPI controller 0. If your 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 you want to stay updated on the 
I4B API.

As a consequence of the changes I have made, you 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 you need more than 8 units please edit 
that file.

The driver now supports all cards that are supported by the official version of 
I4B except active CAPI controllers and one "Frizt" card. So if you have got 
an ISDN device the chances should be good that this driver will support it.

--HPS