Commit 5e837f1039 for asterisk.org
commit 5e837f1039907acce0277e549641ee9c1d917b07
Author: Sean Bright <sean@seanbright.com>
Date: Wed Apr 8 15:40:50 2026 +0000
func_talkdetect.c: Clarify dsp_talking_threshold documentation.
Fixes: #1761
diff --git a/funcs/func_talkdetect.c b/funcs/func_talkdetect.c
index ffa2cfa2a9..63433b7617 100644
--- a/funcs/func_talkdetect.c
+++ b/funcs/func_talkdetect.c
@@ -86,13 +86,14 @@
<para>The function has two parameters that can optionally be passed
when <literal>set</literal> on a channel: <replaceable>dsp_talking_threshold</replaceable>
and <replaceable>dsp_silence_threshold</replaceable>.</para>
- <para><replaceable>dsp_talking_threshold</replaceable> is the time in milliseconds of sound
- above what the dsp has established as base line silence for a user
- before a user is considered to be talking. By default, the value of
- <replaceable>silencethreshold</replaceable> from <filename>dsp.conf</filename>
- is used. If this value is set too tight events may be
- falsely triggered by variants in room noise.</para>
- <para>Valid values are 1 through 2^31.</para>
+ <para><replaceable>dsp_talking_threshold</replaceable> is the minimum
+ average magnitude per sample in a frame for the DSP to consider
+ talking/noise present. A value below this level is considered silence.
+ If this value is set too low, events may be falsely triggered by
+ variants in room noise.</para>
+ <para>Valid values are 1 through 32768. The default value is 256, unless
+ overriden by the <replaceable>silencethreshold</replaceable> setting in
+ <filename>dsp.conf</filename>.</para>
<para><replaceable>dsp_silence_threshold</replaceable> is the time in milliseconds of sound
falling within what the dsp has established as baseline silence before
a user is considered be silent. If this value is set too low events