 | Copia can no longer test any CopiaFacts releases with Brooktrout boards. |
For a new install, install the Brooktrout software using the appropriate IFFBOSTONxx.EXE installer (which will run BOSTON.MSI) before installing your boards.
If you already have an earlier Boston release installed, uninstall it first, and then reboot. If you already have boards installed, make sure that they are detected in Windows Device Manager before running CONFIGTOOL (from Start/Programs/Brooktrout/Brooktrout Configuration Manager).
If your boards are not enabled in Device Manager, right-click and select 'update the drivers'. Later Windows releases may find plug-and-play drivers automatically; if not, navigate in the New Hardware Wizard to the drivers\pnp folder in the folder where you installed the Brooktrout software, for example:
c:\program files\Brooktrout\driver\pnp
After you install the board drivers enabled in Device Manager, you can run the Brooktrout CONFIGTOOL program. Make sure that the 'Boston Host Service' is set to start automatically, either in the Windows Services manager or from Options/Preferences in CONFIGTOOL
See also the Fax Header Lines topic.
BTCALL.CFG
We strongly recommend adding or editing a max_timeout parameter in the Brooktrout configuration file BTCALL.CFG. This value should cause any Brooktrout API call to return after the specified period. Values under 1000 are interpreted as seconds; values of 1000 or more as milliseconds. You need to choose a value large enough for the longest and slowest fax you expect to send or receive, for example 600 for ten minutes. The default value of zero implies 'no limit' and can result in a stuck channel. You should also make max_pagelist large enough for the maximum number of pages you expect to send or receive. If you leave it at the default of 30, faxes will page counts higher than this will be reported as 30-page faxes.
To find the location of BTCALL.CFG, (re-)start COPIAFACTS with 'Debug Configuration and Startup' set. This will record the full pathname of this file in the trace.
Note that the Trufax boards do not all support MMR compression (T.6). Only MH and MR are supported by the Trufax 100 and 200. The Trufax models 250 and 450 also support MMR. From build 8.2.0.59 onwards, the COPIAFACTS engine will convert MMR files on the fly if the board in use by the CopiaFacts channel does not have MMR capability.
If you are using CopiaFacts printer drivers for document conversion, the default output compression is MH, which is supported by all Brooktrout boards.
If you are using the built-in document converters for PDF, HTML or Image documents with hardware which does not support its default MMR compression, you can avoid an unnecessary re-compression by using the FAXMH or FAXMR keyword to set an appropriate format: For example:
$image_options 0 FAXMH ; default MH encoding for built-in converter
or for individual user profiles or even individual FS files:
$var_def IMAGE_OPTIONS FAXMH
Older Trufax models (no longer supported by CopiaFacts v8.2 and later) only supported MH compression.
Debugging
The Brooktrout debugging is enabled by means of the Brooktrout CONFIGTOOL program, on the BTCall Parameters page. You can also set the debug filename on this screen. The CopiaFacts 'Debug Low-Level Voice/Fax' option does not embed any Brooktrout debug lines in the CopiaFacts trace as is the case with some other board interfaces.
Dial Wait
See the $phone_mask topic for details of how to insert a dial wait delay for analog calls.
