• 6.3.1. Protocol Modules
• 6.3.2. Country Dependent Parameter (.cdp) Files
• 6.3.3. Parameter (.prm) Files (Springware only)
• Using .prm Files on Linux
• Using (.prm) Files on Windows

6.3. Protocol Components

Each protocol requires specific firmware parameter file(s) to be downloaded to the voice and network boards. The following files are included on the Global Call Protocols CD:

• protocol modules
• country dependent parameters (.cdp) files
• standard voice and network firmware parameter (.prm) files for the country

6.3.1. Protocol Modules

These files contain protocol specific information and are dynamically linked to the application as needed.

PDK protocols are supported on both DM3 and Springware boards. For DM3 boards, the protocol modules are .hot and .qs files. For Springware boards, the protocol module is a protocol state information (.psi) file, a binary file that is interpreted by the PDK run-time component (PDKRT).

ICAPI protocols are supported on Springware boards only. The protocol modules for Linux are .so files. The protocol modules for Windows are .dll files.

6.3.2. Country Dependent Parameter (.cdp) Files

These files contain country specific and protocol specific parameters for use by Global Call. Country dependent parameter (.cdp) files may be customized. Descriptions of the country dependent parameters most likely to be modified for a protocol are provided in the Global Call Country Dependent Parameters (CDP) Reference.

For ICAPI protocols, the special parameter @0 identifies the protocol to be run. This parameter specifies the name of the protocol module (ignoring the filename extension and without the path) to be run by the application. Two variations of the same protocol can be run if two .cdp files point to the same protocol module filename after @0.

The .cdp file should be located only under the installation directory:

• For Linux: /usr/dialogic/cfg
• For Windows: x:\Program Files\Dialogic\cfg
  where x is a drive name.

6.3.3. Parameter (.prm) Files (Springware only)

For some protocols, certain parameters must be specified in the firmware parameter (.prm) file to ensure proper operation of the protocol. Refer to the Global Call Country Dependent Parameters (CDP) Reference for any required settings.

The .prm files are located:

• For Linux: /usr/dialogic/data
• For Windows: x:\Program Files\Dialogic\data
  where x is a drive name.

The following paragraphs describe configuration steps required when using .prm files on Linux and Windows.

Using .prm Files on Linux

When the Global Call Protocols package is installed on your system, the cc_nn0.prm file is installed. The cc_nn0.prm file contains both the voice and network parameters required by the Global Call API.

You must set the Country parameter for Linux in the /usr/dialogic/cfg/dialogic.cfg file for each board to specify the cc_nn0.prm file as shown below:

     ParameterFile = cc_nn0.prm

where:

• cc is the country code
• nn is the number of time slots per trunk

For some protocols, different firmware parameters may be needed to support different variants of the protocol. See the Global Call Country Dependent Parameters (CDP) Reference for specific instructions regarding parameter selection. To use parameter values in the cc_nn0.prm file that differ from the default values, you must set the ParamFeature parameter in the /usr/dialogic/cfg/dialogic.cfg file for each board so as to specify the protocol variant to use.

Using (.prm) Files on Windows

When the Global Call Protocols package is installed on your system, the cc_nn0.prm file is installed. The cc_nn0.prm file contains both the voice and network parameters required by the Global Call API.

Use the Intel® Dialogic® Configuration Manager (DCM) utility to configure each board in your system:

1. Select the board to be configured.
2. Select the Country tab.
3. Select the country name from the pull down menu.
4. Use the Edit window to change parameter values for the board and country selected.

For some protocols, different firmware parameters may be needed to support different variants of the protocol. See the Global Call Country Dependent Parameters (CDP) Reference for specific instructions regarding parameter selection. To use parameter values in the cc_nn0.prm file that differ from the default values, use the DCM to set the firmware parameters to the desired value.

Click here to contact Telecom Support Resources