FETCh:DTMF

FETCh:DTMF

Last updated: June 7, 2007

GPIB Command Conventions

FETCh:DTMF[:ALL]?

Function

Queries the DTMF measurement.

The measurement results return in the following order: Integrity, Number of characters, then 16 sets of 9 comma-separated values in the following order: Character n Symbol, Character n Low Tone Frequency, Character n Low Tone Frequency Error, Character n Low Tone Phase Deviation, Character n High Tone Frequency, Character n High Tone Frequency Error, Character n High Tone Phase Deviation, Character n On Time, Character n Off Time.

Query

Integrity

Number of characters

  • Range: 0 to 16

  • Resolution: 1

Character n Symbol

  • Range: 0 to 15, 9.91 E+37

    The result is a numeric real result corresponding to actual character result 0 to 9, A, B, C, D, * and # respectively.

Character n Low Tone Frequency

  • Range: 0 Hz to 999 Hz, 9.91 E+37

Character n Low Tone Frequency Error

  • Range: -99 Hz to 99 Hz, 9.91 E+37

Character n Low Tone Phase Deviation

  • Range: 0 to 9 Radians, 9.91 E+37

Character n High Tone Frequency

  • Range: 0 to 2,000 Hz, 9.91 E+37

Character n High Tone Frequency Error

  • Range: -99 to 99 Hz, 9.91 E+37

Character n High Tone Phase Deviation

  • Range: 0 to 9 Radians, 9.91 E+37

Character n On Time

  • Range: 0 to 6,000 ms, 9.91 E+37

Character n Off Time

  • Range: 0 to 6,000 ms, 9.91 E+37

Requirement

Test Application Revision: B.09 and above

Lab Application Revision: B.03 and above

Programming Example

 
OUTPUT 714;"FETCh:DTMF?" 

FETCh:DTMF:CHARacter? <num value>

Function

Queries the DTMF characters in measurement. A numeric parameter from 0 to 15 must be provided to specify the data that are returned. The range of the parameter is from 0 to 15 (inclusive). The parameter value outside the range of 0 through 15 results in illegal parameter errors.

The measurement results return 9 comma-separated values for each character in the following order: Character n Symbol, Character n Low Tone Frequency, Character n Low Tone Frequency Error, Character n Low Tone Phase Deviation, Character n High Tone Frequency, Character n High Tone Frequency Error, Character n High Tone Phase Deviation, Character n On Time, Character n Off Time.

Query

Integrity

Character n Symbol

  • Range: 0 to 15, 9.91 E+37

    The result is a numeric real result corresponding to actual character result 0 to 9, A, B, C, D, * and #  respectively.

Character n Low Tone Frequency

  • Range: 0 Hz to 999 Hz, 9.91 E+37

Character n Low Tone Frequency Error

  • Range: -99 Hz to 99 Hz, 9.91 E+37

Character n Low Tone Phase Deviation

  • Range: 0 to 9 Radians, 9.91 E+37

Character n High Tone Frequency

  • Range: 0 to 2,000 Hz, 9.91 E+37

Character n High Tone Frequency Error

  • Range: -99 to 99 Hz, 9.91 E+37

Character n High Tone Phase Deviation

  • Range: 0 to 9 Radians, 9.91 E+37

Character n On Time

  • Range: 0 to 6,000 ms, 9.91 E+37

Character n Off Time

  • Range: 0 to 6,000 ms, 9.91 E+37

Requirement

Test Application Revision: B.09 and above

Lab Application Revision: B.03 and above

Programming Example

 
OUTPUT 714;"FETCh:DTMF:CHARacter? 4" 
!Returns the 9 comma-separated values charactering the fifth character measured in the measurement.

FETCh:DTMF:COUNt[:CHARacter]?

Function

Queries the number of DTMF characters detected before the end of the gate time. If the number of detected characters is greater than 16, the result is set to 16. If no character has been detected, the result is 0.

Query

  • Range: 0 to 16

  • Resolution: 1

Requirement

Test Application Revision: B.09 and above

Lab Application Revision: B.03 and above

Programming Example

 
OUTPUT 714;"FETCh:DTMF:COUNt?" 

FETCh:DTMF:INTegrity?

Function

Queries the measurement integrity indicator for the last DTMF measurement completed.

Zero indicates a normal measurement. See Integrity Indicator for information about non-zero integrity results.

Query

Range: 1 to 25

Requirement

Test Application Revision: B.09 and above

Lab Application Revision: B.03 and above

Programming Example

 
OUTPUT 714;"FETCh:DTMF:INTegrity?" !Request measurement results.
!Query the integrity indicator for the DTMF result.