Supported Hardware

CopiaFacts currently supports BRI, Analog, E1-PRI and T1 Diva Server boards, as well as SoftIP and HMP. Color fax is not yet supported.

For more information on Diva Server boards visit the Dialogic Diva web pages here.

See also the Fax Header Lines topic.

Installation

Use the Dialogic Diva installer to install and configure the board and service options. The necessary Dialogic Diva software is supplied with the boards.

If you change your hardware configuration by adding or removing boards, you must re-run the Diva Configuration Manager to reflect the changes that have been made.

When upgrading from Diva drivers 8.5.11 or earlier to 8.5.12 or later, a complete uninstall and re-install may be needed.  Please read the README file unpacked by the first installer stage, before continuing with the Diva install.
If you need to uninstall/reinstall Diva drivers, be sure to use the Diva Configurator first to save your Diva configuration.  This can then be restored later.

Diva Versions

CopiaFacts requires release 8.2 or later of the Dialogic Diva Server software.

Three interface DLLs are supplied for Diva boards:

CF8EN.DLL is used with Diva Software 8.5 rev 9 or later (the current Diva release is 8.5 rev 14).  It is built with Diva SDK 5.5.5 and requires DSSDK.DLL 5.5.3.x,  5.5.4.x, or 5.5.5.x.  Note that 8.5 rev 13 is the last version to support Windows XP, and Dialogic have announced that 8.5 rev 14 will be the last to support Windows Server 2003.

CF8EN55.DLL is used with Diva Software 8.5 rev 7 or later (if DSSDK.DLL 5.5.3.x or 5.5.4.x is not present).  It is built with Diva SDK 5.5.1 and requires DSSDK.DLL 5.5.x.x.

CF8EN50.DLL is used with Diva Software prior to 8.5 rev 7.  It is built with Diva SDK 5.0 and requires DSSDK.DLL 4.0.x.x, 4.5.x.x or 5.0.x.x.

From COPIAFACTS version 8.049, these DLLs are selected automatically.  It is no longer necessary to rename CF8EN50 as was the case with earlier releases, and you must not do so.

Note that most Diva Server 'version 2' and earlier boards (but not all, see the version history below) require Diva Server software 8.2 or earlier and cannot be combined in the same machine with later boards which require Diva Server software 8.3 or later.

CopiaFacts version 7 uses F7EN.DLL for Diva Software releases 8.2 to 8.5 rev 9).  However the SIP/HMP features which require SDK 5.5 are not available.  CopiaFacts version 7 has not been tested with Diva Software 8.5 rev 10 or later but we would expect it to work.

Diva Server Software and SDK Version History

Diva Server version history    
Diva Software and Software Development Kit Versions
===================================================

The following information is taken from README.TXT files in
Eicon and Dialogic software and SDK releases (E&OE):


Diva Software versions 7.5 to 8.5 ship with the following SDK versions:
=======================================================================

  8.5.14 ships with DSSDK.DLL 5.5.5.3576 2015.06.09
  8.5.13 ships with DSSDK.DLL 5.5.5.3574 2014.01.04
  8.5.11 ships with DSSDK.DLL 5.5.4.3550 2012.04.11
  8.5.10 ships with DSSDK.DLL 5.5.2.3080 2011.06.15
  8.5.9  ships with DSSDK.DLL 5.5.1.2553 2010.07.02
  8.5.7  ships with DSSDK.DLL 5.5.0.1645 2009.08.31
  8.5.6  ships with DSSDK.DLL 5.0.2.1335 2009.03.24
  8.5.4  ships with DSSDK.DLL 5.0.2.1310 2008.11.17
  8.5.2  ships with DSSDK.DLL 5.0.1.1297 2008.07.24
  8.5    ships with DSSDK.DLL 5.0.0.1259 2008.02.01
 
  8.3    ships with DSSDK.DLL 4.5.0.858  2007.03.22
  8.2    ships with DSSDK.DLL 4.0.0.600  2006.07.18
  8.0    ships with DSSDK.DLL 3.5.0.421  2005.11.22
  7.7    ships with DSSDK.DLL 3.6.1.503  2005.05.26
  7.5    ships with DSSDK.DLL 3.4.0.266  2004.09.22
 
Diva SDKs ship with the following LIB/DLL versions:
===================================================

  5.5.5 ships with DSSDK.DLL 5.5.5.3576 2015.04.07
  5.5.4 ships with DSSDK.DLL 5.5.4.3556 2012.05.24
  5.5.3 ships with DSSDK.DLL 5.5.3.3112 2012.01.05
  5.5.2 ships with DSSDK.DLL 5.5.2.3074 2011.01.22
  5.5.1 ships with DSSDK.DLL 5.5.1.2553 2010.04.20
  5.5   ships with DSSDK.DLL 5.5.0.1634 2009.08.05
  5.0.1 ships with DSSDK.DLL 5.0.1.1297 2008.07.24
  5.0   ships with DSSDK.DLL 5.0.0.1256 2007.10.26
  4.5   ships with DSSDK.DLL 4.5.0.858  2007.03.22
  4.0   ships with DSSDK.DLL 4.0.0.600  2006.06.09
  3.5   ships with DSSDK.DLL 3.5.0.393  2005.03.29
  3.4   ships with DSSDK.DLL 3.4.0.262  2004.09.07
  3.1   ships with DSSDK.DLL 3.1.0.171  2003.10.15

Diva SDK documented requirements for Diva Software:
===================================================

 5.5.4  requires 8.5.9 or later, and if used, HMP 3.0.289 or later
 5.5.3  requires 8.5.9 or later, and if used, HMP 3.0.289 or later
 5.5.2  requires 8.5.9 or later, and if used, HMP 3.0.289 or later
 5.5.1  requires 8.5   or later, and if used, HMP 3.0.157 or later
 5.5    requires 8.5   or later, and if used, HMP 3.0.157 or later
 5.0.1  requires 8.3   or later, and if used, HMP 3.0.157 or later
 5.0    requires 8.3   or later, and if used, HMP 3.0.157 or later
 4.5    requires 8.2   or later (on earlier versions, some features may not be available)
 4.0    requires 8.0   or later (on earlier versions, some features may not be available)
 3.5    requires 7.5   or later (on earlier versions, some features may not be available)
 3.4    requires 7.0   or later (some new features require 7.5 or later)
 3.1    requires 6.2   or later
 
CopiaFacts usage of DIVA SDKs:
==============================

CopiaFacts v8.2 and 8.1:
  CF8EN.DLL   is built with SDK 5.5.4 library and headers 2012.05.24
  CF8EN55.DLL is built with SDK 5.5.1 library and headers 2010.04.20
  CF8EN50.DLL is built with SDK 5.0   library and headers 2007.10.26

CopiaFacts v8:
  CF8EN.DLL   is built with SDK 5.5.1 library and headers 2010.04.20
  CF8EN50.DLL is built with SDK 5.0   library and headers 2007.10.26
 
CopiaFacts v7:  
  F7EN.DLL    is built with SDK 5.0   library and headers 2007.10.26
 
CopiaFacts version checking:
============================

CopiaFacts v8.x (selects DLL based on DSSDK.DLL version number found):
 CF8EN.DLL    requires SDK 5.5.x.x
 CF8EN50.DLL  requires SDK 4.0.x.x or 4.5.x.x or 5.0.x.x

CopiaFacts v7:  
 F7EN.DLL     requires SDK 4.0.x.x or 4.5.x.x or 5.0.x.x or 5.5.x.x
 
Hardware and Software supported from 8.5 forward:
=================================================

 Generation 4 hardware:

 - Diva V-2PRI/E1/T1                // added in 8.5
 - Diva V-4PRI/E1/T1                // added in 8.5
 - Diva V-1PRI/T1-24 PCIe HS        // added in 8.5.6
 - Diva V-1PRI/E1-30 PCIe HS        // added in 8.5.6
 - Diva V-2PRI/T1-48 PCIe HS        // added in 8.5.6
 - Diva V-2PRI/E1-60 PCIe HS        // added in 8.5.6
 - Diva V-4PRI/T1-96 PCIe HS        // added in 8.5.6
 - Diva V-4PRI/E1-120 PCIe HS       // added in 8.5.6
 - Diva V-4PRI/T1-96 PCIe FS        // added in 8.5.7
 - Diva V-4PRI/E1-120 PCIe FS       // added in 8.5.7
 - Diva V-8PRI/T1-192 PCIe FS       // added in 8.5.7
 - Diva V-8PRI/E1-240 PCIe FS       // added in 8.5.7

 Generation 3 hardware:

 - Diva PRI/E1/T1-CTI PCIe
 - Diva PRI/E1-30 PCIe
 - Diva V-PRI/E1-30 PCIe
 - Diva PRI/T1-24 PCIe
 - Diva V-PRI/T1-24 PCIe
 - Diva PRI/E1/T1-CTI
 - Diva PRI/E1/T1-8
 - Diva PRI/T1-24
 - Diva PRI/E1-30
 - Diva V-PRI/T1-24
 - Diva V-PRI/E1-30
 - Diva Analog-4P
 - Diva Analog-8P
 - Diva Analog-2P
 - Diva PRI/E1-30 PCIe
 - Diva PRI/T1-24 PCIe
 - Diva PRI E1/T1-CTI PCIe
 - Diva V-PRI/E1-30 PCIe
 - Diva V-PRI/T1-24 PCIe

 Generation 2 hardware:

 - Diva 4BRI-8 PCIe
 - Diva BRI-2 PCIe
 - Diva BRI-CTI
 - Diva BRI-2FX
 - Diva BRI-2                  
 - Diva 4BRI-8

 Supported Operating Systems

 - Windows XP                       // dropped in 8.5.14
 - Windows XP x64                   // dropped in 8.5.14
 - Windows Server 2003              // will drop after 8.5.14
 - Windows Server 2003 x64          // will drop after 8.5.14
 - Windows Vista                    // added in 8.5
 - Windows Vista x64                // added in 8.5
 - Windows Server 2008              // added in 8.5
 - Windows Server 2008 x64          // added in 8.5
 - Windows 7                        // added in 8.5.7
 - Windows 7 x64                    // added in 8.5.7
 - Windows Server 2008 R2 x64       // added in 8.5.7
 - Windows Server 2012 R2 x64       // added in 8.5.13

Hardware supported up to 8.3:
=============================

 Generation 4 hardware:

 - Diva Server V-2PRI/E1/T1         // added in 8.0
 - Diva Server V-4PRI/E1/T1         // added in 8.0

 Generation 3 hardware:

 - Diva Server PRI/E1/T1-CTI
 - Diva Server PRI/E1/T1-8
 - Diva Server PRI/T1-24
 - Diva Server PRI/E1-30
 - Diva Server V-PRI/T1-24
 - Diva Server V-PRI/E1-30
 - Diva Server Analog-4P            // added in 7.7
 - Diva Server V-Analog-4P          // added in 7.7
 - Diva Server Analog-8P            // added in 7.7
 - Diva Server V-Analog-8P          // added in 7.7
 - Diva Server Analog-2P            // added in 8.3
 - Diva Server PRI/E1-30 PCIe       // added in 8.3
 - Diva Server PRI/T1-24 PCIe       // added in 8.3
 - Diva Server PRI E1/T1-CTI PCIe   // added in 8.3
 - Diva Server V-PRI/E1-30 PCIe     // added in 8.3
 - Diva Server V-PRI/T1-24 PCIe     // added in 8.3

 Generation 2 Hardware:
 
 - Diva Server 2FX
 - Diva Server BRI-2M 2.0
 - Diva Server V-BRI-2
 - Diva Server 4BRI-8M 2.0
 - Diva Server V-4BRI-8
 - Diva Server PRI-0M 2.0
 - Diva Server PRI-4M 2.0
 - Diva Server PRI-8M 2.0
 - Diva Server PRI-30M 2.0
 - Diva Server T1/PRI
 - Diva Server T1/PRI-4M
 - Diva Server T1/PRI-8M
 - Diva Server T1/PRI-24M

Configuration

Remember to configure the incoming call filter either to accept all calls or to accept a specific range of dialed numbers as required.

If you have multiple Diva Server boards and machines in a hunt group of incoming lines, be sure to set the 'Device Mode' in the Dialogic configuration to 'Hunt Group' instead of to 'Standard'.  This ensures that the board will be disabled while CopiaFacts is not running and incoming calls will therefore be passed to another span.

Inbound Calls

Dialogic Diva hardware is configured to permit or deny inbound calls on a whole device (board), not on individual channels. CopiaFacts allows inbound calls on each device if one or more lines on the device is configured for inbound calls. You can also use the environment variable EICON_NO_INBOUND to deny inbound calls on specific devices. The value to assign is a comma-separated list of device (board) numbers. For example, assigning "1,2" prevents inbound calls on boards 1 and 2.

Baud Rate Cache for Inbound calls

Diva boards have a feature where if an incoming call from a specific number goes through at a slow speed, they store the number somewhere and do not subsequently advertise higher speeds for the next call from the same number. This improves negotiation time. So once you have been sent a fax which was received at 9600, it will stick at that baud rate for subsequent calls from the same fax number.

You can clear the stored numbers by rebooting the system.  And you can also completely suppress this feature, by storing a file named adapter.cfg in the folder:

windows\system32\drivers\DISDN

The file should contain the line:

Param FaxOptions = 0x05 W 0x0200

If there is already an adapter.cfg file in that location you can edit it to append this line (you may need an elevated Notepad on a system with UAC).  Of course this may result in transmissions from other locations taking longer to negotiate or failing, so it may be that an occasional reboot when you notice this issue is a better solution.

Cover Sheets

'ASCII cover sheets' are not supported.  To create a cover sheet containing data from variable fields, use a graphical customization template (GCT or GTT) cover sheet.

Dial Wait

See the $phone_mask topic for details of how to insert a dial wait delay for analog calls.