From 968567a559710063c627b30696583908720064dd Mon Sep 17 00:00:00 2001
From: areski <areski@gmail.com>
Date: Mon, 7 Dec 2015 16:30:50 +0100
Subject: [PATCH] update documentation and add dialplan example

---
 README.md    | 44 ++++++++++++++++++++++++++++++++++++++++++++
 amd.conf.xml | 14 ++++++++++++++
 dialplan.xml | 10 ++++++++++
 mod_amd.c    |  2 +-
 4 files changed, 69 insertions(+), 1 deletion(-)
 create mode 100644 amd.conf.xml
 create mode 100644 dialplan.xml

diff --git a/README.md b/README.md
index e7e11a8..53801b2 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,7 @@ host$ make
 
 Sample Configuration
 --------------------
+
 Just put a file like this in your freeswitch installation, in **conf/autoload_configs/amd.conf.xml**
 ```xml
 <configuration name="amd.conf" description="mod_amd Configuration">
@@ -41,3 +42,46 @@ Just put a file like this in your freeswitch installation, in **conf/autoload_co
   </settings>
 </configuration>
 ```
+
+Variables
+---------
+
+After the AMD execution, the variable `amd_result` and `amd_cause` will be set.
+
+The variable `amd_result` will return one of the following results:
+
+- NOTSURE: take this value if total_analysis_time is over and decision could not be made
+- HUMAN: if a human is detected
+- MACHINE: if a human is detected
+
+
+The variable `amd_cause` will return one of the following results:
+
+- INITIALSILENCE (MACHINE)
+- SILENCEAFTERGREETING (HUMAN)
+- MAXWORDLENGTH (MACHINE)
+- MAXWORDS (MACHINE)
+- LONGGREETING (MACHINE)
+- TOOLONG (NOTSURE)
+
+
+Usage
+-----
+
+Set a Dialplan as follow:
+
+```xml
+    <extension name="amd_ext" continue="false">
+      <condition field="destination_number" expression="^5555$">
+        <action application="answer"/>
+          <action application="amd"/>
+          <action application="playback" data="/usr/local/freeswitch/sounds/en/us/callie/voicemail/8000/vm-hello.wav"/>
+          <action application="info"/>
+          <action application="hangup"/>
+      </condition>
+    </extension>
+```
+
+The originate a call that will bridge to the `amd_ext` dialplan:
+
+    originate {origination_caller_id_number='808111222',ignore_early_media=true,originate_timeout=45}sofia/gateway/mygateway/0044888888888 5555
diff --git a/amd.conf.xml b/amd.conf.xml
new file mode 100644
index 0000000..71c5a44
--- /dev/null
+++ b/amd.conf.xml
@@ -0,0 +1,14 @@
+
+<configuration name="amd.conf" description="mod_amd Configuration">
+  <settings>
+    <param name="silence_threshold" value="256"/>
+    <param name="maximum_word_length" value="5000"/>
+    <param name="maximum_number_of_words" value="3"/>
+    <param name="between_words_silence" value="50"/>
+    <param name="min_word_length" value="100"/>
+    <param name="total_analysis_time" value="5000"/>
+    <param name="after_greeting_silence" value="800"/>
+    <param name="greeting" value="1500"/>
+    <param name="initial_silence" value="2500"/>
+  </settings>
+</configuration>
diff --git a/dialplan.xml b/dialplan.xml
new file mode 100644
index 0000000..069056d
--- /dev/null
+++ b/dialplan.xml
@@ -0,0 +1,10 @@
+
+    <extension name="test_amd" continue="false">
+      <condition field="destination_number" expression="^5555$">
+        <action application="answer"/>
+          <action application="amd"/>
+          <action application="playback" data="/usr/local/freeswitch/sounds/en/us/callie/voicemail/8000/vm-hello.wav"/>
+          <action application="info"/>
+          <action application="hangup"/>
+      </condition>
+    </extension>
diff --git a/mod_amd.c b/mod_amd.c
index cccfad6..9cfe2c3 100644
--- a/mod_amd.c
+++ b/mod_amd.c
@@ -219,7 +219,7 @@ static switch_bool_t amd_handle_silence_frame(amd_vad_t *vad, const switch_frame
 			globals.after_greeting_silence);
 
 		switch_channel_set_variable(vad->channel, "amd_result", "HUMAN");
-		switch_channel_set_variable(vad->channel, "amd_cause", "HUMAN");
+		switch_channel_set_variable(vad->channel, "amd_cause", "SILENCEAFTERGREETING");
 		return SWITCH_TRUE;
 	}