PREV TOC HOME INDEX NEXT


4.14.1. Modify the Embedded H.323 IP Stack Configuration File (config.val)

The config.val configuration file, located in \Program Files\Dialogic\bin\ , is used to configure the embedded H.323 stack on DM3 IPLink T-1 and E-1 NIC boards. By default, the system software assigns the same config.val file to all the boards in the system. To configure the H.323 stack differently on each board, use the default file to create a unique *.val file for each board in your system (for example, config_1.val). Once the config.val file is updated, following the procedures described in Section 4.14.2, Run the Embedded H.323 Stack Configuration Utility (IPTConf.exe). Modifiable config.val components include the following:

CAUTION

Do not change any settings in the config.val file, except for those explained here. The H.323 stack will not function properly if other changes are made.

Describe Coder Capabilities

Each supported coder's capabilities are described in the config.val file. You may adjust certain Rx parameters for each coder. These capabilities are broadcast during the capability exchange at call setup. For a list of supported coders, refer to the release guide supplied with your IntelŪ DialogicŪ release.

Note: The Fast Start Element broadcasts maximum capability. The actual capabilities are defined in detail in the Slow Start section of the config.val. A maximum of 40 coder capabilities may be defined.

G.711 muLaw

You may set the maximum frame size that this coder can receive. It can be set for either 30, 20, or 10 milliseconds. The larger frame size also allows the smaller frame sizes, that is, the default 30 milliseconds frame size also allows the 20 milliseconds and 10 milliseconds frame sizes. The line to be changed is highlighted in the code fragment below: 

4  capabilityTable = 0
5   * = 0 #Sequence
6    capabilityTableEntryNumber = 1 # INTEGER [1..65535]
6    capability = 0
7     receiveAudioCapability = 0
8      g711Ulaw64k = 30 # INTEGER [1..256]

Values:

G.723.1

You may designate the number of frames per packet that the coder can receive, and enable or disable silence suppression (VAD). The lines to be changed are highlighted in the code fragment below: 

5   * = 0 #Sequence
6    capabilityTableEntryNumber = 2 # INTEGER [1..65535]
6    capability = 0
7     receiveAudioCapability = 0
8      g7231 = 0
9       maxA1-sduAudioFrames = 3 # INTEGER [1..256]
9       silenceSuppression = 1 # INTEGER [1..256]

Values:

Note: The capabilityTableEntryNumber 1must be sequential starting from 1. If you make any changes, make sure that the numbers are correct. In addition, the capabilityDescriptors section must contain the same number of capabilities. Comment out non-applicable lines: 
4  capabilityDescriptors = 0
5   * = 0 #Sequence
6    capabilityDescriptorNumber = 0 #INTEGER [1..255]
6    simultaneousCapabilities = 0
7     * = 0
8      * = 1 # INTEGER [1..65535] 
8      * = 2 # INTEGER [1..65535] 
#8      * = 3 # INTEGER [1..65535] 
#8      * = 4 # INTEGER [1..65535]

G.711 Alaw

You may set the maximum frame size that this coder can receive. It can be set for either 30, 20, or 10 milliseconds. The larger frame size also allows the smaller frame sizes, that is, the default 30 millisecond frame size also allows the 20 millisecond and 10 millisecond frame sizes. The line to be changed is highlighted in the code fragment below: 

4  capabilityTable = 0
5   * = 0 #Sequence
6    capabilityTableEntryNumber = 3 # INTEGER [1..65535]
6    capability = 0
7     receiveAudioCapability = 0
8      g711Alaw64k = 30 # INTEGER [1..256]

Values:

GSM

You may designate the number of frames per packet that the coder can receive, and enable or disable silence suppression (VAD). The lines to be changed are highlighted in the code fragment below: 

# Standard GSM Full Rate
5     * = 0
6      capabilityTableEntryNumber = 4
6      capability = 0
7       receiveAndTransmitAudioCapability = 0
8        gsmFullRate = 0
9         audioUnitSize = 99 
9         comfortNoise = 1 
9         scrambled = 0

Values:

GSM-EFR

You may designate the number of frames per packet that the coder can receive, and enable or disable silence suppression (VAD). The lines to be changed are highlighted in the code fragment below: 

# Standard GSM Full Rate
5     * = 0
6      capabilityTableEntryNumber = 5
6      capability = 0
7       receiveAndTransmitAudioCapability = 0
8        gsmFullRate = 0
9         audioUnitSize = 93 
9         comfortNoise = 1 
9         scrambled = 0

Values:

G.729

Standard G.729 coder support includes G.729 without Annex A and B, Annex A only, Annex B only, and Annex A + B. Each configuration is listed in the config.val as a separate coder. The Fast Start Element reports a maximum coder capability of 4 frames per packet. The exact configuration is defined in the Slow Start section (G.729 channels) of the config.val as either 3 or 4 frames per packet. You may change this setting, keeping in mind that a maximum of 40 coder definitions may appear. For each number of frames per packet to be added, copy an existing section and paste it into the config.val. Change the coder name (line 2) and the number of frames per packet (line 5). The lines to be changed are highlighted in the code fragment below: 

# G.729  channels

3   * = 0
4    name = 'g729VD3'
4    dataType = 0
5     audioData = 0
6      g729 = 3

3   * = 0
4    name = 'g729VD4'
4    dataType = 0
5     audioData = 0
6      g729 = 4
3   * = 0
4    name = 'g729VD2'
4    dataType = 0
5     audioData = 0
6      g729 = 2

Enable Gatekeeper Registration

A gatekeeper serves as a directory of Internet addresses and telephone numbers. The IPLink platform can be configured to register with a gatekeeper. By default, the IPLink platform is configured for no gatekeeper as shown in the following fragment from the config.val file: 

1 RAS = 0
2 responseTimeOut = 1
#2 gatekeeper = 1
2 manualRAS = 1
#2  manual Discovery = 0
#3   defaultGatekeeper = 0
#4    ipAddres = 0
#5     ip = <200.202.200.200>
#5     port = 1719

To register with a gatekeeper, comment line 4 (of this section of code). It should appear as follows: 

1 RAS = 0
2 responseTimeOut = 1
#2 gatekeeper = 1
#2 manualRAS = 1
#2  manual Discovery = 0
#3   defaultGatekeeper = 0
#4    ipAddres = 0
#5     ip = <200.202.200.200>
#5     port = 1719

In addition, you must either insert a specific gatekeeper IP address, or enable discovery (broadcasting a request for a gatekeeper).

If you know the IP address of the gatekeeper you want to register with, uncomment lines 5 - 9 and insert the correct IP address in line 8. It should appear as follows: 

1 RAS = 0
2 responseTimeOut = 1
#2 gatekeeper = 1
#2 manualRAS = 1
2  manual Discovery = 0
3   defaultGatekeeper = 0
4    ipAddres = 0
5     ip = <insert IP address of gatekeeper here>
5     port = 1719

Broadcast General Requests For a Gatekeeper

Applications built using a DM3 IPLink T-1 or E-1 board or a DM/IP040-LSI board can broadcast a general request for a gatekeeper. If you want to broadcast a general request for a gatekeeper, you can choose to either:

To broadcast to a Multicast address, there is no need to change the default settings: 

#Not applicable when manualDiscovery is enabled !
2  rasMulticastAddress = 0
3   ipAddress = 0
4    ip = <224.0.1.41>
4    port = 1718
#Broadcast address
#4   ip = <255.255.255.255>
#4   port = 1718
#station ras port (reply from gatekeeper)
2  rasPort = 1719

To broadcast to all gatekeepers, comment lines 4 and 5 and uncomment lines 7 and 8 as shown below: 

#Not applicable when manualDiscovery is enabled !
2  rasMulticastAddress = 0
3   ipAddress = 0
#4    ip = <224.0.1.41>
#4    port = 1718
#Broadcast address
4   ip = <255.255.255.255>
4   port = 1718
#station ras port (reply from gatekeeper)
2  rasPort = 1719

Identify the Gateway

The gateway may identify itself by name and/or by phone number. If you wish to identify your gateway by only one characteristic, comment out the pair of lines that are not used (lines 7 and 8 or lines 9 and10): 

2  registrationInfo = 0
3   terminalType = 0
4    mc           = 0
4    undefinedNode = 0
4    terminal = 0
4    vendor = 0
5     vendor = 0
6      t35CountryCode  =  181  #USA
# 88 Israel
6      t35Extension    = 11
6      manufacturerCode  = 11
5     productId = 'IPLink'
5      versionId = 'Dialogic Corp.'
3   terminalAlias = 0
4    * = 0
5     h323-ID = "Insert Gateway Name Here"
4    * = 0
5     e164 = 'Insert Gateway Phone Number Here'!
Note: The config.val syntax requires that the gateway name string be contained within double quotes and the gateway phone number string be contained within single quotes, followed by an exclamation point.

Supply Vendor Specific Information

Vendor specific information can be sent during call setup. Upon receiving a call offering event, this information can be retrieved by the application using the TSC_MsgGetCallInfo command with CallInfo_VendorInfo as the information (Direct Interface) or gc_Extension( ) function with IPPARM_VENDOR_PRODUCT_ID as the information (Global Call). The event is defined as:

Typedef struct {
Uint32 CountryCode;
Uing32 Ext;
Uint16 ManufacturerCode;
Char ProductId[64]
char VersionId[32];
}NetTSC_VendorInfo_t;

Change the information in the highlighted rows according to the vendor specific information to be sent. 

2  registrationInfo = 0
3   terminalType = 0
4    mc           = 0
4    undefinedNode = 0
4    terminal = 0
4    vendor = 0
5     vendor = 0
6      t35CountryCode  =  181  #USA
# 88 Israel
6      t35Extension    = 11
6      manufacturerCode  = 11
5     productId = 'IPLink'
5      versionId = 'Dialogic Corp.'
3   terminalAlias = 0
4    * = 0
5     h323-ID = "Insert Gateway Name Here"
4    * = 0
5     e164 = 'Insert Gateway Phone Number Here'!

Disable H.245 Tunneling

H.245 Tunneling is enabled by default. To disable, comment out the line in the config.val as illustrated below: 

1 Q931 = 0
2  responseTimeOut = 50
2  connectTimeOut = 500
2  callSignalingPort = 1720
#2  h245Tunneling = 0
2  maxCalls = 60
#2  notEstablishControl = 0
2  manualAccept = 1
PREV TOC HOME INDEX NEXT

Click here to contact Telecom Support Resources

Copyright 2002, Intel Corporation
All rights reserved
This page generated September, 2002