updated the documentation and the sample config to meet the present

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@7446 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Christian Richter 2005-12-12 22:26:35 +00:00
parent bc50894149
commit d37857c208
2 changed files with 80 additions and 77 deletions

View File

@ -20,6 +20,7 @@
;
debug=0
; the big trace
;
; default value: [not set]
@ -40,7 +41,7 @@ trace_dir=/var/log/
;
; default value: yes
;
bridging=yes
bridging=no
; stops dialtone after getting first digit on nt Port
;
@ -68,15 +69,6 @@ l1_info_ok=yes
;
clear_l3=no
; set the method to use for channel selection:
; standard - always choose the first free channel with the lowest number
; round_robin - use the round robin algorithm to select a channel. use this
; if you want to balance your load.
;
; default value: standard
;
method=standard
;;; CRYPTION STUFF
; Wether to look for dynamic crypting attempt
@ -125,6 +117,16 @@ context=misdn
;
language=en
;
; sets the musiconhold class
;
musicclass=default
;
; Either if we should produce DTMF Tones ourselve
;
senddtmf=yes
; Prefixes for national and international, those are put before the
; oad if an according dialplan is set by the other end.
;
@ -149,11 +151,23 @@ txgain=0
;
te_choose_channel=no
; set the method to use for channel selection:
; standard - always choose the first free channel with the lowest number
; round_robin - use the round robin algorithm to select a channel. use this
; if you want to balance your load.
;
; default value: standard
;
method=standard
;
; dialplan means Type Of Number in ISDN Terms (for outgoing calls)
;
; dialplan options:
;
; 0 - unknown
; 1 - National
; 2 - International
; 1 - International
; 2 - National
; 4 - Subscriber
;
; This setting is used for outgoing calls
@ -161,6 +175,7 @@ te_choose_channel=no
; default value: 0
;
dialplan=0
localdialplan=0
; This is only for asterisk head and will result in only considering
; misdn.confs and misdn_set_opts callingpresentation informations if set to no.
@ -170,6 +185,13 @@ dialplan=0
;
use_callingpres=yes
;
; turn this to no if you don't mind correct handling of Progress Indicators
;
early_bconnect=yes
; uncomment the following to get into s extension at extension conf
; there you can use DigitTimeout if you can't or don't want to use
; isdn overlap dial.
@ -236,6 +258,17 @@ echocancelwhenbridged=no
;
echotraining=yes
;
; chan_misdns jitterbuffer, default 1000
;
jitterbuffer=1000
;
; change this threshold to enable dejitter functionality
;
jitterbuffer_upper_threshold=0
[intern]
; define your ports, e.g. 1,2 (depends on mISDN-driver loading order)
ports=1,2

View File

@ -21,13 +21,13 @@ Features:
* Data (HDLC) callthrough
* Data Calling (with app_ptyfork +pppd)
* Echo cancellation
* CallDeflection
* Some other
Supported Hardware:
-------------------
chan_misdn supports any mISDN compatible Hardware. Especially the 1-8 Port
BRI Cards available from http://shop.beronet.com
chan_misdn supports any mISDN compatible Hardware.
Overview
--------
@ -49,48 +49,28 @@ Overview
Fast Installation Guide
-----------------------
You have two options on how to install chan_misdn.
It is easy to install mISDN and mISDNuser. Using the Makefile from
channels/misdn. You just need to type:
(1) Requirements:
- mISDN and mISDNuser from jolly (see Pre-Requisites below)
Installation:
- cd <asterisk-src-dir>/channels/misdn
- edit Makefile so that MISDNUSER points to your mISDNuser directory
- run 'make'
- cd <asterisk-src-dir>
- compile and install asterisk via 'make install'
cd channels/misdn
make misdn
(2) Requirements:
- Asterisk headers and Kernel headers
Description:
The Makefile gets the newest mISDN and mISDNuser Sources from
jollys webpage and the newest release of chan_misdn from beronets
Servers. After that it compiles and installs everything (hopefully).
Installation:
- cd /usr/src
- wget http://www.beronet.com/downloads/install-misdn.tar.gz
- tar zxf install-misdn.tar.gz
- cd install-misdn
- make install
Then all the necessary files are fetched from isdn4linux.de.
Pre-Requisites
--------------
To compile and install this driver, you'll need at least one mISDN Driver, the
mISDNuser package and the Asterisk includes (which will be inside of the
sources). Chan_misdn works with both, the current release version and the
development (svn trunk) version of Asterisk.
To compile and install this driver, you'll need at least one mISDN Driver and
the mISDNuser package. Chan_misdn works with both, the current release version
and the development (svn trunk) version of Asterisk. mISDNuser and mISDN must
be fetched from cvs.isdn4linux.de (mqueue branch).
To get the mISDN stuff please follow the instructions at
http://www.isdn4linux.de. Please Note that mISDN works good for the
linux-2.6.x kernels. Some of the mISDN drivers do not compile against the
2.4.x or older kernels, you can patch them, but than you'll get mysterious
errors.
Please Note that mISDN works good for the linux-2.6.x kernels. Some of the
mISDN drivers do not compile against the 2.4.x or older kernels, you can patch
them, but than you'll get mysterious errors.
I use Kernels > 2.6.9 and it works perfect. with kernels >= 2.6.10 there is a
very litle bug in hfc_multi.c which causes the module not to compile, it can
be easily fixed by changing pci_findsubsys to pci_getsubsys in code.
Using Kernels > 2.6.9 works perfect.
Ok so far so good, now follow the compilation instructions.
@ -99,46 +79,26 @@ Ok so far so good, now follow the compilation instructions.
Compilation
-----------
!! Be aware, in the actual mISDNuser package theres a bug in the Makefile
!! the compilation stops near iapplication.h, this isn't very important
!! at this step you are ready.
The compilation of chan_misdn requires a library which will be generated under
channels/misdn/.
After you've successfully installed mISDN, mISDNuser and Asterisk, you should
modify the Makefile in the chan_misdn source path. There you can tell the
Makefile where to install the driver, sample-conf, and most important where it
can find the linux kernel includes, the mISDNuser package and the Asterisk
includes. If you use the development version of Asterisk (or at least a newer
version than release) uncomment the CCFLAGS+=-DASTERISK_STABLE, the release
version of Asterisk is at the moment v1-2 as subversion branch.
To compile this library you just need to go into this directory and type
make. Now you can go back to the asterisk source root and type make install
again, which now should compile and install chan_misdn.
Now you can type in:
make
This should compile chan_misdn.so, if there's an error check the paths in the
Makefile again.
Installation
------------
After successful compilation of chan_misdn, you should simply type in:
Chan_misdn is automatically installed by the asterisk installation process.
make install
as privileged user to put chan_misdn.so in the Asterisk modules
directory.
You should see a message like: "Successfully installed chan_misdn".
Congratulations.
Theres a sample init.d script for loading the mISDN modules (mISDN.sample),
simply copy it to /etc/init.d/ and modify it, there you can enter your cards.
There is a sample init.d script for loading the mISDN modules (mISDN.sample),
5Asimply copy it to /etc/init.d/ and modify it, there you can enter your cards.
!! Forget to use capi together with chan_misdn.
Configuration
-------------
@ -162,6 +122,11 @@ configuration file, bigger numbers will lead to more debug output. There's also
tracefile option, which takes a path+filename where debug output is written
to.
- misdn.conf: [default] section
The default section is another special section which can contain all the
options available int the usr/port sections. the user/port section inherit
their parameters from the default section.
- misdn.conf: user/port sections
The user sections have names which are unequal to "general". Those sections
contain the ports variable which mean the mISDN Ports. Here you can add
@ -205,8 +170,8 @@ The available Optchars are:
vt - txgain control
chan_misdn registers a new dial plan application "misdn_set_opt" when loaded. This
application takes the Optionsstring as argument. The Syntax is:
chan_misdn registers a new dial plan application "misdn_set_opt" when
loaded. This application takes the Optionsstring as argument. The Syntax is:
misdn_set_opt(<OPTIONSSTRING>)
@ -343,6 +308,11 @@ it, you can just change pci_find_subsys to pci_get_subsys, this works.
* asterisk >= v1-0.2 , also CVS Head
* mISDN/mISDNuser (3.0-beta) from isdn.jolly.de
- chan_misdn-0.2.1
* linux-kernel >= 2.6.8 (but at least 2.6)
* asterisk >= v1.2 , also CVS Head
* mISDN/mISDNuser (3.0) from isdn.jolly.de
Known Problems
--------------