4 voicenumber, 5 dialvoice, 6 voicehangup – Campbell Scientific COM320 Voice Communications Modem User Manual

Page 21: 7 voicesetup

Advertising
background image

COM320 Voice Communications Modem

5.2.4 VoiceNumber

The VoiceNumber instruction returns the accumulated touch tone digits that
are received prior to the receipt of a # or * key. The example voice
callback/callin program uses no VoiceNumber instructions; however, this
instruction may be useful for phone transfer of long numbers such as for
passwords, etc.

5.2.5 DialVoice

The DialVoice instruction is used to define the dialing string for a COM320
voice modem, usually for voice callback. If the DialVoice instruction is set
equal to a variable, a True will be returned if the communication attempt was
successful or a False will be returned if it failed. VoiceHangup is used after a
communication attempt to hang up the voice modem. The DialString is the
telephone number and any other codes used to dial the modem. The DialString
can be a variable. A comma in the DialString inserts a 2 second pause.

5.2.6 VoiceHangup

The VoiceHangup instruction is used most often with the DialVoice instruction
to hang up the modem after communication. The VoiceHangup instruction is
not needed if the voice commands are enclosed within the VoiceBeg /
EndVoice instructions.

5.2.7 VoiceSetup

The VoiceSetup instruction controls the hang up of the COM320 voice
modem. It also allows you to specify certain handset key functions.

The HangUpKey parameter specifies the key that, when pressed, will
disconnect the COM320.

The ExitSubKey parameter specifies the key that will exit a subroutine if the
datalogger is running one. The ContinueKey parameter specifies the key that
will begin announcing the next VoiceSpeak phrase.

The SecsOnLine parameter specifies the maximum number of seconds that the
COM320 will be off-hook before it is hung up by the datalogger.

The UseTimeout parameter determines whether or not the datalogger will hang
up the COM320 after the timeout in the VoiceKey instruction expires. If this
parameter is set to True, the timeout will be used. If False, the timeout will not
be used.

The CallOut parameter is a Boolean value that indicates the COM320 mode.
When the value returned in this parameter is True the datalogger has called
out. When the value is False the datalogger has received an incoming call.

If the same ASCII character is used for HangUpKey and ExitSubKey, the
datalogger will exit a subroutine if it is in one, otherwise, it will hang up the
COM320. When the specified ContinueKey is pressed, the COM320 will skip
the current VoiceSpeak string and move to the next one. If any other key is
pressed, the COM320 will skip to the next group of VoiceSpeak instructions.

15

Advertising