User guide

47
Brooktrout configuration files
This section explains the following configuration files for Dialogic Brooktrout TR1034 boards, TruFax boards, and
SR140 software.
Configuration
file
Description
btcall The user-defined configuration file that contains configuration parameters for the API and driver.
callctrl The call control configuration file is an ASCII file that contains general PCM configuration
parameters for all telephony hardware units and static telephony connections to be formed for all
modules. It contains the IP interface parameters for Fax over IP (SIP or H323).
The configuration files can be found in the following locations:
In Unix, /usr/sys/boston
In Windows, %ProgramFiles%\Brooktrout\config
Important
To configure TR1034 boards, TruFax boards or SR140 software on Windows, we recommend that you use
Brooktrout Configuration Tool instead of modifying the configuration files manually. For this, run the
configtool.exe program located in the %ProgramFiles%\Brooktrout\bin directory. If you need to change
boards or add a new one, run vsi-boston-config.exe under \VSI-FAX\FaxServer\lbin\ in the installation
directory.
To modify your fax configuration on Unix/Linux platforms, refer to Modifying the Brooktrout board or SR140
configuration on Unix/Linux (page 45).
Configuration File: btcall.cfg
The btcall.cfg file, the user-defined configuration file, contains parameters that set values such as direct memory
access (DMA) transfer size or number of direct inward dialing (DID) digits. The parameters in the table below apply to
all the supported TR1034 or TruFax boards and to SR140 software in VSI-FAX.
Keywords define the parameters and may be listed in any order and are case insensitive. Only one keyword per line
is permitted. Keywords must be separated from their values-a decimal integer, a hexadecimal integer, or a character
string by one or more spaces. Commas, colons, and dashes are not valid keyword separators. The default value is
automatically supplied for each missing keyword; keywords that do not match any of the valid keywords are ignored.
If a keyword appears more than once, the last occurrence is the one that will take effect.
The API treats any line that begins with the # character as a comment and ignores that line. All character strings that
represent filenames must consist of printable ASCII characters. Do not include whitespace characters such as space
and tabs. If no fax product is listed in the description, the keyword applies to all fax products.
Keyword Description