[Asterisk-doc] docs modules.xml,1.3,1.4

[marlow]

Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16181

Modified Files:
	modules.xml 
Log Message:


capi.conf description
Index: modules.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/modules.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** modules.xml	13 Aug 2004 01:44:12 -0000	1.3
--- modules.xml	15 Aug 2004 05:08:15 -0000	1.4
***************
*** 344,348 ****
  			<sect3>
  				<title>capi.conf</title>
! 				<para/>
  			</sect3>
  		</sect2>
--- 344,441 ----
  			<sect3>
  				<title>capi.conf</title>
! 				<para>
! 				The configuration of capi based devices is pretty simple. First of all do vi have the <varname>[general]</varname>
! 				section.
! 				<informalexample>
! 				<programlisting>
! 				[general]
! 				nationalprefix=0
! 				internationalprefix=00
! 				rxgain=0.8
! 				txgain=0.8
! 				</programlisting>
! 				</informalexample>
! 				<varname>nationalprefix</varname> and <varname>internationalprefix</varname> define, which prefix 
! 				Asterisk should add in front of the caller-id on incoming calls. ISDN works that way, that the caller-id
! 				is transferred without prefix and there is a special indicator, that tells on call setup, what kind of
! 				call we are talking about. Since Asterisk doesn't differ and the prefix can be different from country to
! 				country (international is "011" in the U.S., but "00" in most european countries) this can be set here.
! 				<varname>rxgain</varname> and <varname>txgain</varname> do explain themselfes. 
! 				</para>
! 				<para>
! 				Next up is the <varname>[interfaces]</varname> section. This section defines, which capi interfaces
! 				you want to add to Asterisk and which numbers are available. ISDN can be configured two ways, Point
! 				to Multi-Point (PMP) or Point to Point (PP). Here is a typical PMP setup:
! 				<informalexample>
! 				<programlisting>
! 				[interfaces]
! 				msn=2043986,2043987
! 				incomingmsn=*
! 				controller=1
! 				devices=2
! 				softdtmf=1
! 				accountcode=
! 				context=default
! 				callgroup=1
! 				;mode=immidiate
! 				;deflect=12345678
! 				;echosquelch=1
! 				;echocancel=yes
! 				;echotail=64
! 				</programlisting>
! 				</informalexample>
! 				<varname>msn</varname> specifies which MSNs (or DIDs) you want to use for outgoing calls. There is
! 				a limitation of up to 5 MSNs, but usually it is enough to specify one of them. You can set the MSN
! 				you want to show on outgoing calls by setting the <varname>${CALLERIDNUM}</varname> variable in your
! 				dialplan. On <varname>incomingmsn</varname> you can specify, which MSNs Asterisk should react on. A
! 				"*" tells Asterisk to react on any call, no matter what MSN it has.
! 				</para>
! 				<para>
! 				With <varname>controller</varname> you specify what controller you are configuring. You can have more
! 				than one controller in your system and all can be configured individually. <varname>devices</varname>
! 				tells chan_capi how many b-channels your ISDN card can handle. <varname>softdtmf=1</varname> will use 
! 				Asterisk's dsp functions to detect and generate the DTMF tones. <varname>softdtmf=0</varname> will
! 				use your capi controller to do the detection/generation. Unless you have an active card you should use
! 				<varname>softdtmf=1</varname>.
! 				</para>
! 				<para>
! 				<varname>accountcode</varname> is for billing purposes and <varname>context</varname> defines which
! 				context chan_capi should send incomming calls from the ISDN card to. <varname>callgroup</varname>
! 				defines which callgroup the controller is a member of. You can have several controllers in the same
! 				callgroup, that then would react the same way. If <varname>mode</varname> is set to immidiate, the
! 				ISDN card answers the call immidiatly and passes it on to Asterisk. The default behavior would be,
! 				that you need to answer the call in your dialplan.
! 				</para>
! 				<para>
! 				<varname>deflect</varname> defines a phoneno. that you automatically want to deflect calls to, if
! 				both b-channels on your ISDN card are busy. Deflect on busy has to be enabled during compile,
! 				if you want that feature to work.
! 				</para>
! 				<para>
! 				<varname>echosquelch</varname>, <varname>echocancel</varname> and <varname>echotail</varname> are
! 				values, that you normally not need to change. If you are dealing with echo issues, it might be an
! 				idea to try test different values here.
! 				</para>
! 				<para>
! 				The typical PP setup would look like this:
! 				<informalexample>
! 				<programlisting>
! 				[interfaces]
! 				isdnmode=ptp
! 				msn=20439
! 				controller=1
! 				devices=30
! 				softdtmf=0
! 				accountcode=
! 				context=default
! 				callgroup=1
! 				</programlisting>
! 				</informalexample>
! 				The options for a Point to Point setup are basically the same as for the PMP setup. <varname>msn</varname>
! 				now only holds the prefix of your msn, the suffix will be transferred to Asterisk as extension.
! 				<varname>isdnmode=ptp</varname> tells chan_capi, that the card is to be run in Point to Point mode (Default
! 				would be Point to Multi-Point mode). All other values are to be configured the same way with Point to
! 				Multi-Point mode.
! 				</para>
  			</sect3>
  		</sect2>