Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

rtpengine: support receiving dtmf events from rtpengine and raise an event #3470

Closed
wants to merge 13 commits into from
Closed

rtpengine: support receiving dtmf events from rtpengine and raise an event #3470

Show file tree
Hide file tree
Changes from 11 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
4b4edbc
imc: add support to modify member role
joeygo Nov 28, 2022
a6ed37c
imc: call handle_modify
joeygo Nov 28, 2022
b5e8711
imc: db_mode support
joeygo Dec 2, 2022
2505a97
Merge branch 'kamailio:master' into master
joeygo Dec 2, 2022
f9820f9
imc: destroy db only if db_mode is not 0
joeygo Dec 2, 2022
05a877c
Merge remote-tracking branch 'joeygo/master'
joeygo Dec 2, 2022
643a2d9
imc: propagate content-type header
joeygo Dec 2, 2022
48c6364
Merge branch 'kamailio:master' into master
joeygo Dec 2, 2022
3d98c7a
Merge remote-tracking branch 'joeygo/master'
Apr 16, 2023
c4b913a
Merge branch 'kamailio:master' into master
joeygo May 28, 2023
5bfc028
rtpengine: support receiving dtmf events from rtpengine and raise an …
May 28, 2023
ecfec78
Initialize uninitialized local variable
May 29, 2023
df3cce7
Pass 0 to pvar setf in case of an event raised
May 29, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
7 changes: 7 additions & 0 deletions src/modules/rtpengine/doc/rtpengine.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,13 @@
<email>rfuchs@sipwise.com</email>
</address>
</editor>
<editor>
<firstname>Joey</firstname>
<surname>Golan</surname>
<address>
<email>joeygo@gmail.com</email>
</address>
</editor>
</authorgroup>
<copyright>
<year>2003-2008</year>
Expand Down
117 changes: 116 additions & 1 deletion src/modules/rtpengine/doc/rtpengine_admin.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2188,6 +2188,78 @@ modparam("rtpengine", "mos_average_samples_B_pv", "$avp(mos_average_samples_B)")
</example>
</section>

<section id="rtpengine.p.dtmf_event_callid">
<title><varname>dtmf_event_callid</varname> (string)</title>
<para>
The name of a pseudovariable to be filled in with the callid of the triggered dtmf event.
</para>
<para>
By default, this parameter is not set.
</para>
<example>
<title>Set <varname>dtmf_event_callid</varname> parameter</title>
<programlisting format="linespecific">
...
modparam("rtpengine", "dtmf_event_callid", "$avp(dtmf_event_callid)")
...
</programlisting>
</example>
</section>

<section id="rtpengine.p.dtmf_event_source_tag">
<title><varname>dtmf_event_source_tag</varname> (string)</title>
<para>
The name of a pseudovariable to be filled in with the source tag that triggered the dtmf event.
</para>
<para>
By default, this parameter is not set.
</para>
<example>
<title>Set <varname>dtmf_event_source_tag</varname> parameter</title>
<programlisting format="linespecific">
...
modparam("rtpengine", "dtmf_event_source_tag", "$avp(dtmf_event_source_tag)")
...
</programlisting>
</example>
</section>

<section id="rtpengine.p.dtmf_event_timestamp">
<title><varname>dtmf_event_timestamp</varname> (string)</title>
<para>
The name of a pseudovariable to be filled in with the timestamp when the dtmf event was triggered.
</para>
<para>
By default, this parameter is not set.
</para>
<example>
<title>Set <varname>dtmf_event_timestamp</varname> parameter</title>
<programlisting format="linespecific">
...
modparam("rtpengine", "dtmf_event_timestamp", "$avp(dtmf_event_timestamp)")
...
</programlisting>
</example>
</section>

<section id="rtpengine.p.dtmf_event">
<title><varname>dtmf_event</varname> (string)</title>
<para>
The name of a pseudovariable to be filled in with the triggered DTMF value.
</para>
<para>
By default, this parameter is not set.
</para>
<example>
<title>Set <varname>dtmf_event</varname> parameter</title>
<programlisting format="linespecific">
...
modparam("rtpengine", "dtmf_event", "$avp(dtmf_event)")
...
</programlisting>
</example>
</section>

<section id="rtpengine.p.control_cmd_tos">
<title><varname>control_cmd_tos</varname> (integer)</title>
<para>
Expand Down Expand Up @@ -2253,7 +2325,28 @@ modparam("rtpengine", "wsapi", "lwsc")
</example>
</section>


<section id="rtpengine.p.dtmf_events_sock" xreflabel="dtmf_events_sock">
<title><varname>dtmf_events_sock</varname> (string)</title>
<para>
Definition of IPv4/IPv6 UDP socket used to receive dtmf events from RTPEngine.
</para>
<para>
DTMF events coming from RTPEngine will trigger rtpengine:dtmf-event route.
</para>
<para>
<emphasis>
Default value is <quote>NONE</quote> (disabled).
</emphasis>
</para>
<example>
<title>Set <varname>dtmf_events_sock</varname> parameter</title>
<programlisting format="linespecific">
...
modparam("rtpengine", "dtmf_events_sock", "127.0.0.1:2223")
...
</programlisting>
</example>
</section>

</section>

Expand Down Expand Up @@ -3485,4 +3578,26 @@ $ &kamcmd; rtpengine.get_hash_total

</section>

<section id="rtpengine.ex.event_routes">
<title>Event routes</title>
<section>
<title>
<function moreinfo="none">rtpengine:dtmf-event</function>
</title>
<para>
When defined, the module calls event_route[rtpengine:dtmf-event]
when a DTMF is received.
</para>
<programlisting format="linespecific">
...
event_route[rtpengine:dtmf-event] {
xlog("L_INFO", "callid: $avp(dtmf_event_callid)\n");
xlog("L_INFO", "source_tag: $avp(dtmf_event_source_tag)\n");
xlog("L_INFO", "timestamp: $avp(dtmf_event_timestamp)\n");
xlog("L_INFO", "dtmf: $avp(dtmf_event)\n");
}
...
</programlisting>
</section>
</section>
</chapter>