Asterisk With NVFaxDetect

Originally Created by: kbmetz

1. Login to the FreePBX interface of the appropriate Asterisk box. Click on the Setup tab along the top and then select the Inbound Routes selection on the left navbar. Once this page opens, it will default to Add Incoming Route.

2. Complete the Add Incoming Route window as follows:
DID Number: <Enter the DID number you created in Step 1>
Fax Extension: <Change this to "system">
Fax Email: <Enter FAX recipient's e-mail address here>
Fax Detection type: <Change to "NVFax">
Pause after answer: <Change to "20">
Set Destination: <Select "Core:" and then the recipient's voice extension number>

3. Click Submit and then click the Red Reload Bar along the top. Asterisk will restart.

4. SSH into the Asterisk box you're configuring. Type the following commands:

• asterisk -r
  • CLI> set verbose 10
  • CLI> show application nvfaxdetect

YOU ARE FINISHED IF YOU SEE A CLI MESSAGE SAYING:
This application listens for fax tones (on IAX and SIP channels too)
for waitdur seconds of time. In addition, it can be interrupted by digits,
or non-silence. Audio is only monitored in the receive direction. If
digits interrupt, they must be the start of a valid extension unless the
option is included to ignore. If fax is detected, it will jump to the
'fax' extension. If a period of non-silence greater than 'mindur' ms,
yet less than 'maxdur' ms is followed by silence at least 'sildur' ms
then the app is aborted and processing jumps to the 'talk' extension.
If all undetected, control will continue at the next priority.
waitdur: Maximum number of seconds to wait (default=4)
options:
'n': Attempt on-hook if unanswered (default=no)
'x': DTMF digits terminate without extension (default=no)
'd': Ignore DTMF digit detection (default=no)
'f': Ignore fax detection (default=no)
't': Ignore talk detection (default=no)
sildur: Silence ms after mindur/maxdur before aborting (default=1000)
mindur: Minimum non-silence ms needed (default=100)
maxdur: Maximum non-silence ms allowed (default=0/forever)
Returns -1 on hangup, and 0 on successful completion with no exit conditions.

IF, INSTEAD, YOU RECEIVE A MESSAGE SAYING THAT NVFAXDETECT ISN'T INSTALLED, YOU MUST COMPLETE THE FOLLOWING STEPS:

1. cd /usr/src
2. wget http://www.soft-switch.org/downloads/spandsp/spandsp-0.0.2pre25/spandsp-0.0.2pre25.tar.gz
3. tar zxf spandsp-0.0.2pre25.tar.gz
4. cd spandsp-0.0.2
5. ./configure --prefix=/usr && make && make install
6. yum -y install ghostscript
7. amportal stop (Hurry! Asterisk will be down until you complete!)
8. cd /usr/src/asterisk/apps
9. wget http://nerdvittles.com/aah2/app_nv_faxdetect.c
10. wget http://www.soft-switch.org/downloads/spandsp/spandsp-0.0.2pre25/asterisk-1.2.x/app_rxfax.c
11. wget http://www.soft-switch.org/downloads/spandsp/spandsp-0.0.2pre25/asterisk-1.2.x/app_txfax.c
12. wget http://aussievoip.com/makefile.patch
13. patch < makefile.patch
14. cd ..
15. make
16. make install
17. amportal start

NOW, SEE IF NVFAXDETECT IS INSTALLED:

• asterisk -r
  • CLI> set verbose 10
  • CLI> show application nvfaxdetect

IF YOU NOW SEE THE APPLICATION INSTALLED, YOU SHOULD BE GOOD TO GO!

Links to related pages

• The Last Frontier: Handling Incoming Faxes with Asterisk (Nerd Vittles)
• NVFaxDetect page at voip-info.org
• Asterisk fax page at voip-info.org