4.2 Demo Options

4.2 Demo Options

You can choose from several options when running the demo as shown in Table4-1, CSP Demo Options. The format for specifying options at the command prompt is:
cspdemo -<option> -<option> (and so on) 
For example, to run a 10-channel test in automatic mode with 5 iterations and log results in autotest.log, type:
cspdemo -c10 -i5 -lautotest.log 
Notes:
1. The order in which you specify demo options is not important.

2. In the table, N represents an integer and ( ) represents an optional value.

Table 4-1. CSP Demo Options

Demo Option

Example

Description/Value

-? -? Displays help.

-a -a
Board with analog front end in use. This value is assumed by default.

Note: The options -a, -e and -t are mutually exclusive.

-cN -c2 Specifies number of channels to use which in turn determines the demo mode.

-c1 for manual mode (one channel; default mode)
-c2 and higher for automatic mode (two or more channels)

For automatic mode, enter an even number. In this mode, channels are paired. If you enter an odd number, the demo reduces that number to an even number. For example, if you enter 7, the demo revises that number to 6.

Note: This value is ignored for the diagnostic mode. See -d option for information on setting diagnostic mode.

Note: The manual, automatic and diagnostic modes are mutually exclusive.

-d -d
Enables diagnostic mode. The default value is diagnostic mode disabled. We recommend that you turn on logging (-l) if you specify diagnostic mode to have a written record of the findings. In this mode, the demo tests all parameters available in ec_setparm( ), tests all CSP functions and runs a multi-channel test on each CSP-capable board in your system. After the tests are completed, the demo resets all values to their original setting.

Note: The manual, automatic and diagnostic modes are mutually exclusive.

Note: When running diagnostic mode on an E-1 board, you must also specify -e option.

-e -e
E-1 board in use. The protocol used is A and B bits set to 1 for off-hook and 0 for on-hook. Bits C and D are ignored. If -w option is also specified, the demo waits for a wink event, which is determined by the A bit changing state. Without -w, the phone connection occurs immediately.

Note: The options -a, -e and -t are mutually exclusive.

-hN -h-30
Specifies the speech threshold value while a prompt is playing. This option allows you to change the value in DXCH_SPEECHPLAYTHRESH, a parameter of ec_setparm( ), from the default. The default value is -40 dBm. The range is +3 to -54 dBm.

Note: You must supply the plus or minus sign with this value.
If background noise level is high and triggers the voice activity detector erroneously, you can set the speech threshold to a higher value, such as -20 dBm.

-iN -i2
Number of iterations. For a simple test, you can specify 1. For a longevity test, you can specify 2 or more. Be aware that specifying a large number can tie up your system for some time. We recommend specifying a smaller number and working upwards. The default value is one iteration.

Note: This value is ignored for the manual and diagnostic modes.

-l(filename) -ltest.log
Enables logging of results to a text file in the directory from which you ran the demo. If you don't specify a log name, the default file name is cspdemo.log. The default value is logging disabled.

Note: This option is available for automatic mode and diagnostic mode only. For manual mode, the results are displayed on the screen.

-nN -n3
Specifies the network interface channel for a T-1 or E-1 board. The default value is 1, that is, the first channel of the first board. This option allows you to route a voice channel on a CSP-enabled board to a network interface channel on a non-CSP-enabled board.

Note: This option is available for manual mode only.

-sN -s5 Enables selection of the starting voice channel. The default is that the demo runs on the first channel of the first board. You can use this option to specify any channel of any CSP-enabled board in your system. Be aware of the following usage notes:

If running in automatic mode, specify an odd number for the starting channel (channels are paired). If you enter an even number, the demo reduces it to an odd number.
This option is ignored for the diagnostic mode.
Selecting a channel on an unsupported board results in a demo failure.

-t -t
T-1 board in use. The protocol used is Ear & Mouth (E&M) where A and B bits are set to 1 for off-hook and 0 for on-hook. Bits C and D are ignored. If -w option is also specified, the demo waits for a wink event, which is determined by the A bit changing state. Without -w, the phone connection occurs immediately.

Note: The options -a, -e and -t are mutually exclusive.

-w -w
Enables wait for wink on digital boards and wait for ring on analog boards. If you enable this option, the demo does not start until it receives a wink or ring event. By default, this option is disabled.

Note: This option is available for manual mode only.

If an option is not specified when running the CSP demo, a default value applies:

analog front end (-a)
one channel, manual mode (-c1)
diagnostics (-d) is disabled
speech threshold (-h) is -40 dBm
one iteration (-i1)
logging (-l) is disabled
network interface channel is the first channel of the first board (-n1)
starting voice channel is the first channel of the first board (-s1)
wait for wink/ring (-w) is disabled

Table 4-1. **CSP Demo Options**
Demo Option	Example	Description/Value
-?	-?	Displays help.
-a	-a	Board with analog front end in use. This value is assumed by default. Note: The options -a, -e and -t are mutually exclusive.
-cN	-c2	Specifies number of channels to use which in turn determines the demo mode. -c1 for manual mode (one channel; default mode) -c2 and higher for automatic mode (two or more channels) For automatic mode, enter an even number. In this mode, channels are paired. If you enter an odd number, the demo reduces that number to an even number. For example, if you enter 7, the demo revises that number to 6. Note: This value is ignored for the diagnostic mode. See -d option for information on setting diagnostic mode. Note: The manual, automatic and diagnostic modes are mutually exclusive.
-d	-d	Enables diagnostic mode. The default value is diagnostic mode disabled. We recommend that you turn on logging (-l) if you specify diagnostic mode to have a written record of the findings. In this mode, the demo tests all parameters available in ec_setparm( ), tests all CSP functions and runs a multi-channel test on each CSP-capable board in your system. After the tests are completed, the demo resets all values to their original setting. Note: The manual, automatic and diagnostic modes are mutually exclusive. Note: When running diagnostic mode on an E-1 board, you must also specify -e option.
-e	-e	E-1 board in use. The protocol used is A and B bits set to 1 for off-hook and 0 for on-hook. Bits C and D are ignored. If -w option is also specified, the demo waits for a wink event, which is determined by the A bit changing state. Without -w, the phone connection occurs immediately. Note: The options -a, -e and -t are mutually exclusive.
-hN	-h-30	Specifies the speech threshold value while a prompt is playing. This option allows you to change the value in DXCH_SPEECHPLAYTHRESH, a parameter of ec_setparm( ), from the default. The default value is -40 dBm. The range is +3 to -54 dBm. Note: You must supply the plus or minus sign with this value. If background noise level is high and triggers the voice activity detector erroneously, you can set the speech threshold to a higher value, such as -20 dBm.
-iN	-i2	Number of iterations. For a simple test, you can specify 1. For a longevity test, you can specify 2 or more. Be aware that specifying a large number can tie up your system for some time. We recommend specifying a smaller number and working upwards. The default value is one iteration. Note: This value is ignored for the manual and diagnostic modes.
-l(filename)	-ltest.log	Enables logging of results to a text file in the directory from which you ran the demo. If you don't specify a log name, the default file name is cspdemo.log. The default value is logging disabled. Note: This option is available for automatic mode and diagnostic mode only. For manual mode, the results are displayed on the screen.
-nN	-n3	Specifies the network interface channel for a T-1 or E-1 board. The default value is 1, that is, the first channel of the first board. This option allows you to route a voice channel on a CSP-enabled board to a network interface channel on a non-CSP-enabled board. Note: This option is available for manual mode only.
-sN	-s5	Enables selection of the starting voice channel. The default is that the demo runs on the first channel of the first board. You can use this option to specify any channel of any CSP-enabled board in your system. Be aware of the following usage notes: If running in automatic mode, specify an odd number for the starting channel (channels are paired). If you enter an even number, the demo reduces it to an odd number. This option is ignored for the diagnostic mode. Selecting a channel on an unsupported board results in a demo failure.
-t	-t	T-1 board in use. The protocol used is Ear & Mouth (E&M) where A and B bits are set to 1 for off-hook and 0 for on-hook. Bits C and D are ignored. If -w option is also specified, the demo waits for a wink event, which is determined by the A bit changing state. Without -w, the phone connection occurs immediately. Note: The options -a, -e and -t are mutually exclusive.
-w	-w	Enables wait for wink on digital boards and wait for ring on analog boards. If you enable this option, the demo does not start until it receives a wink or ring event. By default, this option is disabled. Note: This option is available for manual mode only.

Click here to contact Dialogic Customer Engineering