Voice Software Reference - Features Guide: Generic Configuration File

1.3.1. Name
1.3.2. Ioport

1.3. Generic Configuration File

This section describes the format of the Generic Configuration file, .voxcfg, an internal file which is generated at download time. The Generic Configuration file is located in the /usr/dialogic/cfg directory. The .voxcfg file can be browsed to determine which virtual boards were assigned to a given physical board.

CAUTION

The user should not edit this file!

A board may be viewed by the system as one or more virtual boards. The Generic Configuration File is an ASCII file that contains one line for each virtual board in the system. The following number of lines are required for each board:

1 line for each two- or four-channel resource board
2 lines for each D/80SC board
4 lines for each D/160SC-LS board
6 lines for each D/240SC board
7 lines for each D/240SC-T1 or D/240PCI-T1 board
8 lines for each D/240SC-2T1 board
8 lines for each D/320SC board
9 lines for each D/300SC-E1, D/300PCI-E1, and D/300PSC-E1 board
10 lines for each D/300SC-2E1 board
20 lines for each D/600SC-2E1 board
16 lines for each D/640SC board
2 lines for each DCB/320SC board
3 lines for each DCB/640SC board
4 lines for each DCB/960SC board
1 line for each DTI/240SC, DTI/241SC, DTI/300SC, DTI/301SC board
2 lines for each DTI/480SC, DTI/481SC, DTI/600SC, DTI/601SC board
8 lines for each LSI/81SC
16 lines for each LSI/161SC board
1 line for each MSI/160SC and MSI/240SC board
1 line for each SCX/160 board

Comments are included in the configuration file by placing a pound sign (#) as the first character on each comment line. The default Generic Configuration File contains comments explaining the file format.

The following sections describe the Name and Ioport fields in the Generic Configuration file in detail.

1.3.1. Name

The Name field contains the device name that is assigned to the real or emulated D/4x board. This name is used by the dx_open( ) or dt_open( ) library function to open the device.

Names may be up to 15 characters long. Specify board names as follows:

For D/41ESC boards, specify a unique name for each board.
For D/2x and D/4x boards, specify a unique name for each board.
For DIALOG/HD voice boards, specify a unique name for each of the several emulated D/4x boards.
For DIALOG/HD network interface daughtercards, specify a unique name for each daughtercard.

Channel device names are generated automatically and named by appending "<Subdev><n>" to the associated board's device name. <Subdev> is the subdevice specified in the Subdev field of the configuration file, and <n> is the channel number starting at one. For example, the board called dxxxB1 above will have channels named dxxxB1C1, dxxxB1C2, dxxxB1C3, and dxxxB1C4 by default. The 24 trunk interface lines of the dtiB1 board will be named dtiB1T1 through dtiB1T24.

For DIALOG/HD boards, the Name field in the Generic Configuration File must not be the same as the Name field for the same device (or any other device) in the SpanCard Configuration File.

Within these rules, any name is permitted. A list of recommended entries for the Name parameter is provided in Table 1.

1.3.2. Ioport

The Ioport field is used differently for different boards.

D/21D, D/21H, D/41D, and D/41H boards do not use Ioport at all; the field must be set to zero for these boards.
For D/41EPCI boards, this field stores the thumbwheel identifier number. This is a hexadecimal number in the range 0 to 1F. Refer to the Quick Installation Card for information about setting the thumbwheel identifier number.
For DIALOG/HD boards, the Ioport for the baseboard and for any network interface daughtercard is the thumbwheel identifier number. This is a hexadecimal number in the range 0 to F. Refer to the Quick Installation Card for information about setting the thumbwheel identifier number.

Ioport

Table 1. Valid Values for Generic Configuration File

Field

Values

Comments

Name

dxxxB1
dxxxB2
dxxxB3
.
.
.

dtiB1
dtiB2
dtiB3
.
.
.

Names of the devices used by dx_open( ) and dt_open( ) to open the devices. (This field is described in detail in the accompanying text).

Nchn

2 (for D/2x boards)
4 (for all other voice boards)
24 (for T-1 interface card)
32 (for E-1 interface card)

Number of subdevices (channels) on the device. (Voice boards with more than four channels emulate multiple four-channel boards.)

Ioport

DIALOG/HD boards:

0 through F

20 through 2F

All other voice boards: 0

For a DIALOG/HD voice baseboard or network interface daughtercard, enter the thumbwheel ID number (in hexadecimal) of the board, as it was set at hardware configuration time.

For a DIALOG/HD voice daughtercard, enter the thumbwheel number plus 20H (hexadecimal).

Specify 0 for all other voice boards.

Click here to contact Dialogic Customer Engineering

Field	Values		Comments
Name	dxxxB1 dxxxB2 dxxxB3 . . .	dtiB1 dtiB2 dtiB3 . . .	Names of the devices used by dx_open( ) and dt_open( ) to open the devices. (This field is described in detail in the accompanying text).
Nchn	2 (for D/2x boards) 4 (for all other voice boards) 24 (for T-1 interface card) 32 (for E-1 interface card)		Number of subdevices (channels) on the device. (Voice boards with more than four channels emulate multiple four-channel boards.)
Ioport	DIALOG/HD boards: 0 through F 20 through 2F All other voice boards: 0		For a DIALOG/HD voice baseboard or network interface daughtercard, enter the thumbwheel ID number (in hexadecimal) of the board, as it was set at hardware configuration time. For a DIALOG/HD voice daughtercard, enter the thumbwheel number plus 20H (hexadecimal). Specify 0 for all other voice boards.