<p>Kevin Harwell <strong>submitted</strong> this change.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/18491">View Change</a></p><div style="white-space:pre-wrap">Approvals:
Kevin Harwell: Looks good to me, but someone else must approve; Approved for Submit
George Joseph: Looks good to me, approved
</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">chan_dahdi: Document dial resource options.<br><br>Documents the Dial syntax for DAHDI, namely the channel group,<br>distinctive ring, answer confirmation, and digital call options<br>that are specified in the resource itself.<br><br>ASTERISK-24827 #close<br><br>Change-Id: Ib95e78497fb00dc5cbfde1c93a69f034bfd08c30<br>---<br>M apps/app_dial.c<br>M channels/chan_dahdi.c<br>2 files changed, 54 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/apps/app_dial.c b/apps/app_dial.c</span><br><span>index 7ea23f3..3cf2343 100644</span><br><span>--- a/apps/app_dial.c</span><br><span>+++ b/apps/app_dial.c</span><br><span>@@ -86,6 +86,7 @@</span><br><span> <para>If you need more than one enter them as</span><br><span> Technology2/Resource2&Technology3/Resource3&.....</para></span><br><span> </argument></span><br><span style="color: hsl(120, 100%, 40%);">+ <xi:include xpointer="xpointer(/docs/info[@name='Dial_Resource'])" /></span><br><span> </parameter></span><br><span> <parameter name="timeout" required="false"></span><br><span> <para>Specifies the number of seconds we attempt to dial the specified devices.</para></span><br><span>diff --git a/channels/chan_dahdi.c b/channels/chan_dahdi.c</span><br><span>index 26bb290..616e317 100644</span><br><span>--- a/channels/chan_dahdi.c</span><br><span>+++ b/channels/chan_dahdi.c</span><br><span>@@ -234,6 +234,59 @@</span><br><span> </enum></span><br><span> </enumlist></span><br><span> </info></span><br><span style="color: hsl(120, 100%, 40%);">+ <info name="Dial_Resource" language="en_US" tech="DAHDI"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>DAHDI allows several modifiers to be specified as part of the resource.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>The general syntax is :</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para><literal>Dial(DAHDI/pseudo[/extension])</literal></para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para><literal>Dial(DAHDI/<channel#>[c|r<cadance#>|d][/extension])</literal></para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para><literal>Dial(DAHDI/(g|G|r|R)<group#(0-63)>[c|r<cadance#>|d][/extension])</literal></para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>The following modifiers may be used before the channel number:</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <enumlist></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="g"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Search forward, dialing on first available channel in group (lowest to highest).</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="G"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Search backward, dialing on first available channel in group (highest to lowest).</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="r"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Round robin search forward, picking up from where last left off (lowest to highest).</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="R"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Round robin search backward, picking up from where last left off (highest to lowest).</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ </enumlist></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>The following modifiers may be used after the channel number:</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <enumlist></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="c"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Wait for DTMF digit <literal>#</literal> before providing answer supervision.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>This can be useful on outbound calls via FXO ports, as otherwise</span><br><span style="color: hsl(120, 100%, 40%);">+ they would indicate answer immediately.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="d"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Force bearer capability for ISDN/SS7 call to digital.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="i"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>ISDN span channel restriction.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Used by CC to ensure that the CC recall goes out the same span.</span><br><span style="color: hsl(120, 100%, 40%);">+ Also to make ISDN channel names dialable when the sequence number</span><br><span style="color: hsl(120, 100%, 40%);">+ is stripped off. (Used by DTMF attended transfer feature.)</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="r"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>Specifies the distinctive ring cadence number to use immediately after</span><br><span style="color: hsl(120, 100%, 40%);">+ specifying this option. There are 4 default built-in cadences, and up to 24</span><br><span style="color: hsl(120, 100%, 40%);">+ total cadences may be configured.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ </enumlist></span><br><span style="color: hsl(120, 100%, 40%);">+ <example title="Dial 555-1212 on first available channel in group 1, searching from highest to lowest"></span><br><span style="color: hsl(120, 100%, 40%);">+ same => n,Dial(DAHDI/g1/5551212)</span><br><span style="color: hsl(120, 100%, 40%);">+ </example></span><br><span style="color: hsl(120, 100%, 40%);">+ <example title="Ringing FXS channel 4 with ring cadence 2"></span><br><span style="color: hsl(120, 100%, 40%);">+ same => n,Dial(DAHDI/4r2)</span><br><span style="color: hsl(120, 100%, 40%);">+ </example></span><br><span style="color: hsl(120, 100%, 40%);">+ <example title="Dial 555-1212 on channel 3 and require answer confirmation"></span><br><span style="color: hsl(120, 100%, 40%);">+ same => n,Dial(DAHDI/3c/5551212)</span><br><span style="color: hsl(120, 100%, 40%);">+ </example></span><br><span style="color: hsl(120, 100%, 40%);">+ </info></span><br><span> <manager name="DAHDITransfer" language="en_US"></span><br><span> <synopsis></span><br><span> Transfer DAHDI Channel.</span><br><span></span><br></pre><div style="white-space:pre-wrap"></div><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/18491">change 18491</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/c/asterisk/+/18491"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 18 </div>
<div style="display:none"> Gerrit-Change-Id: Ib95e78497fb00dc5cbfde1c93a69f034bfd08c30 </div>
<div style="display:none"> Gerrit-Change-Number: 18491 </div>
<div style="display:none"> Gerrit-PatchSet: 2 </div>
<div style="display:none"> Gerrit-Owner: N A <mail@interlinked.x10host.com> </div>
<div style="display:none"> Gerrit-Reviewer: Friendly Automation </div>
<div style="display:none"> Gerrit-Reviewer: George Joseph <gjoseph@digium.com> </div>
<div style="display:none"> Gerrit-Reviewer: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>