From: Sean Bright <sean@seanbright.com>
Date: Wed, 8 Apr 2026 15:40:50 +0000 (+0000)
Subject: func_talkdetect.c: Clarify dsp_talking_threshold documentation.
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;ds=inline;p=thirdparty%2Fasterisk.git

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