sysmocom
/
asterisk
11
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

chan_dahdi: Document dial resource options. 

Documents the Dial syntax for DAHDI, namely the channel group,
distinctive ring, answer confirmation, and digital call options
that are specified in the resource itself.

ASTERISK-24827 #close

Change-Id: Ib95e78497fb00dc5cbfde1c93a69f034bfd08c30
This commit is contained in:
Naveen Albert 2022-03-27 12:33:39 +00:00 committed by Kevin Harwell
parent 3dc982bdcc
commit e5dc9e0979
2 changed files with 54 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
apps/app_dial.c
View File

@ -86,6 +86,7 @@
<para>If you need more than one enter them as
Technology2/Resource2&amp;Technology3/Resource3&amp;.....</para>
</argument>
<xi:include xpointer="xpointer(/docs/info[@name='Dial_Resource'])" />
</parameter>
<parameter name="timeout" required="false">
<para>Specifies the number of seconds we attempt to dial the specified devices.</para>

53
channels/chan_dahdi.c
View File

@ -234,6 +234,59 @@
</enum>
</enumlist>
</info>
<info name="Dial_Resource" language="en_US" tech="DAHDI">
<para>DAHDI allows several modifiers to be specified as part of the resource.</para>
<para>The general syntax is :</para>
<para><literal>Dial(DAHDI/pseudo[/extension])</literal></para>
<para><literal>Dial(DAHDI/&lt;channel#&gt;[c|r&lt;cadance#&gt;|d][/extension])</literal></para>
<para><literal>Dial(DAHDI/(g|G|r|R)&lt;group#(0-63)&gt;[c|r&lt;cadance#&gt;|d][/extension])</literal></para>
<para>The following modifiers may be used before the channel number:</para>
<enumlist>
<enum name="g">
<para>Search forward, dialing on first available channel in group (lowest to highest).</para>
</enum>
<enum name="G">
<para>Search backward, dialing on first available channel in group (highest to lowest).</para>
</enum>
<enum name="r">
<para>Round robin search forward, picking up from where last left off (lowest to highest).</para>
</enum>
<enum name="R">
<para>Round robin search backward, picking up from where last left off (highest to lowest).</para>
</enum>
</enumlist>
<para>The following modifiers may be used after the channel number:</para>
<enumlist>
<enum name="c">
<para>Wait for DTMF digit <literal>#</literal> before providing answer supervision.</para>
<para>This can be useful on outbound calls via FXO ports, as otherwise
they would indicate answer immediately.</para>
</enum>
<enum name="d">
<para>Force bearer capability for ISDN/SS7 call to digital.</para>
</enum>
<enum name="i">
<para>ISDN span channel restriction.</para>
<para>Used by CC to ensure that the CC recall goes out the same span.
Also to make ISDN channel names dialable when the sequence number
is stripped off. (Used by DTMF attended transfer feature.)</para>
</enum>
<enum name="r">
<para>Specifies the distinctive ring cadence number to use immediately after
specifying this option. There are 4 default built-in cadences, and up to 24
total cadences may be configured.</para>
</enum>
</enumlist>
<example title="Dial 555-1212 on first available channel in group 1, searching from highest to lowest">
same => n,Dial(DAHDI/g1/5551212)
</example>
<example title="Ringing FXS channel 4 with ring cadence 2">
same => n,Dial(DAHDI/4r2)
</example>
<example title="Dial 555-1212 on channel 3 and require answer confirmation">
same => n,Dial(DAHDI/3c/5551212)
</example>
</info>
<manager name="DAHDITransfer" language="en_US">
<synopsis>
Transfer DAHDI Channel.