Supported Hardware
CopiaFacts currently supports BRI, Analog, E1-PRI and T1 Diva Server boards, as well as SoftIP and HMP.
Copia no longer has the ability to test support for Diva ISDN boards and we expect to lose the ability to test support for Analog boards during 2025.
Diva Server boards (formerly Dialogic, formerly Eicon) are now a Sangoma product. For more information on Diva Server boards visit the Diva web pages here.
See also the Fax Header Lines topic.
Installation
Use the Diva installer to install and configure the board and service options. The necessary 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 v9.1 requires release 8.5 rev 14 or later of the Diva Server software. Earlier CopiaFacts versions may be available to support earlier Diva drivers on older hardware or operating systems. See further details in the Diva Server Version History topic.
Three interface DLLs are supplied for Diva boards:
•CF9EN.DLL is used with Diva Software 8.5 rev 9 or later (the current Diva release is 8.5 rev 16). 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.
•CF9EN55.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.
•CF9EN50.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 CF9EN50 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.
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 Diva 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
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.
