Dialogic Support Helpweb
Dialogic® DM3 & JCT Media Boards
Changing Gain Settings on HDSI boards (SR 6.0)
Reason for the issue:
Default gain limits for Dialogic HDSI boards are -9dB (min) and +3dB (max). Station gain can be manipulated within this range by using the ms_setvol( ) function, instructions for which are provided on page 171 of the MSI API Library Reference, which can be accessed at: http://www.dialogic.com/manuals/docs/msi_api_v2.pdf
However, it may be necessary to set the gain limits above or below the documented limits in cases where additional hardware is in place that raises or lowers the gain by significant amounts. Also, if the application does not use the ms_setvol( ) function and the code cannot be modified, then the alternative is to modify the Tx and Rx Base Gain parameters in the config file.
Instructions:
Several parameters must be added to the HDSI config file. The following is a description of each parameter's function:
!0x120F - Tx Gain Min commented out to ensure default values are used
!0x1210 - Tx Gain Max (in dB)
!0x120C - Tx Base Gain (in dB)
!0x120D - Tx Gain (in dB)
!0x121B - Rx Gain Min commented out to ensure default values are used
!0x121C - Rx Gain Max (in dB)
!0x1218 - Rx Base Gain (in dB)
!0x1219 - Rx Gain (in dB)
Before starting, it is recommended that Dialogic® services be stopped, and the original config/FCD files backed up.
To make the modifications, follow these steps:
Step 1:
Go to the Dialogic\data directory and use a text editor to open up the desired config file (for example us_hdsi.config).
Step 2:
Add the following section to the very end of the file:
[TSC.1-120]
!SetParm=0x120F,
SetParm=0x1210, 3
SetParm=0x120C, -3
SetParm=0x120D, -3
!SetParm=0x121B,
SetParm=0x121C, -3
SetParm=0x1218, -3
SetParm=0x1219, -3
However, it may be necessary to set the gain limits above or below the documented limits in cases where additional hardware is in place that raises or lowers the gain by significant amounts. Also, if the application does not use the ms_setvol( ) function and the code cannot be modified, then the alternative is to modify the Tx and Rx Base Gain parameters in the config file.
Instructions:
Several parameters must be added to the HDSI config file. The following is a description of each parameter's function:
!0x120F - Tx Gain Min commented out to ensure default values are used
!0x1210 - Tx Gain Max (in dB)
!0x120C - Tx Base Gain (in dB)
!0x120D - Tx Gain (in dB)
!0x121B - Rx Gain Min commented out to ensure default values are used
!0x121C - Rx Gain Max (in dB)
!0x1218 - Rx Base Gain (in dB)
!0x1219 - Rx Gain (in dB)
Before starting, it is recommended that Dialogic® services be stopped, and the original config/FCD files backed up.
To make the modifications, follow these steps:
Step 1:
Go to the Dialogic\data directory and use a text editor to open up the desired config file (for example us_hdsi.config).
Step 2:
Add the following section to the very end of the file:
[TSC.1-120]
!SetParm=0x120F,
SetParm=0x1210, 3
SetParm=0x120C, -3
SetParm=0x120D, -3
!SetParm=0x121B,
SetParm=0x121C, -3
SetParm=0x1218, -3
SetParm=0x1219, -3
Note: The TSC range depends on how many stations you want to modify. For example, if you only wanted to change the gain settings for the first 30 stations, then the first line should be entered as: [TSC.1-30]
Step 3:
Considering each parameter description noted above, change the desired parameter value to any integer between 31 and -31, and save the file.
Step 4:
Using the FCDgen.exe parser located in the Dialogic\bin directory, convert the new config file to FCD format.
Step 5:
Paste the new FCD file into the Dialogic\data directory, and start Dialogic services.
It is now possible to change the gain value for each station beyond the default limits using the ms_setvol( ) function.
Product List
Dialogic® HDSI high density station interface boards:
Glossary of Acronyms / Terms
dB = decibels
Tx = transmit
Rx = receive
Tx = transmit
Rx = receive
Related Documentation
MSI API Library Reference:
http://www.dialogic.com/manuals/docs/msi_api_v2.pdf
MSI API Programming guide:
http://www.dialogic.com/manuals/docs/msi_programming_v1.pdf
http://www.dialogic.com/manuals/docs/msi_api_v2.pdf
MSI API Programming guide:
http://www.dialogic.com/manuals/docs/msi_programming_v1.pdf
