Overview

The Brooktrout Fax Diagnostic Tool (FDTool) is a tool created by Dialogic to work with Brooktrout devices and test the device being used.  This is made to take the place of the faxing software, FaxMaker, and test the fax device and the lines with software created for these devices.  This article explains the process of downloading and using the FDTool.  

Solution

Follow the steps below for using the FDtool:

1. Stop all of the GFI FaxMaker services
2. Download the file:
   
   
   1. Note: It is necessary to use the correct Diagnostic which correlates to the driver version in use. If you are unsure of your FaxMaker version follow the steps in the Finding your FaxMaker Version article.
      
      
      • • For FaxMaker version 20.0, download this file.  
        • For FaxMaker version 20.1, download this file.  
        • For FaxMaker version 20.2, download this file. 
        • For FaxMaker version 20.3, download this file. 
        • Any prior version of FaxMaker would not be supported and FaxMaker would need to be upgraded to version 20.  
        
3. Extract the downloaded zip file to an accessible location
4. Run FDtool.exe
5. If it fails with the missing MFC140.DLL, please install Visual C++ Redistributable for Visual Studio 2015's vc_redist.x86.exe
6. When the program is opened, there should be several buttons at the top.  Click the Configure button first to open the Brooktrout configuration tool
7. Click Advanced in the bottom right corner
8. If an analog card is in use, click Apply, then close the configuration tool and it should navigate back to the diagnostic tool
9. If a digital card is in use, apply the appropriate telephony settings with the card (If unsure, it may be necessary to contact the telco provider). Click Apply, then close the configuration tool and it should navigate back to the diagnostic tool.
10. Select the card to test from the drop-down and press Initialize.
    
    NOTE: The FDTool has a limitation where it will not load more than 8 lines. 
11. The status for the lines should change to Waiting for call.
12. Click Tools, then select Debug (ignore the warning).
13. To test sending, type a number into the Dialstring field and press Dial (It may be necessary to hit Enter after entering the number). 
14. Test receiving by calling one of the internal fax lines from a fax machine
15. Upon completion of testing, be sure to close the fdtool as if left open the fax lines will be in use (connected to the fdtool) and FaxMaker will not be able to connect to them.  

1. Zip up the folder ..\fdtool-...\logs\
2. Open ..\fdtool-...\config\ and find btcall.cfg and callctrl.cfg and add them to logs.zip
3. Email the numbers used to test and logs.zip back to GFI
   • If using an SR140, please also run Wireshark during an attempt to re-create the issue, and provide a .pcap capture file for review. This .pcap capture file should be included in the logs.zip file.
     • The Wireshark Utility can be found at http://www.wireshark.org/
     • ​How to use Wireshark to capture network traffic

1. Open C:\Program Files\GFI\FaxMaker\Brooktrout\TR1034\boston\config, by default
2. Back up btcall.cfg and callctrl.cfg
3. Open ..\fdtool-...\config\
4. Find btcall.cfg and callctrl.cfg and copy them to Program Files\GFI\FaxMaker\Brooktrout\TR1034\boston\config\
5. Be sure to edit the btcall.cfg file to show the absolute path of the callctrl.cfg file found under the brooktrout directory once copied (not the FDTool Diag directory). To modify this file, open it with notepad and edit.
6. Start the GFI FaxMaker services and test