#VLS - Voice Line Select

This action command can be used to select which devices are routed through the modem.

Parameters:
n = 0, 1, 2, 3, or 4 [This is the device position number (not device number) as reflected in response to #VLS=?]

Default:
0

Result Codes:
OK - If n = 0, 1, 2, 3, or 4

VCON - If device selected does not connect to the telephone line. (A speaker is such a device, but a telephone line with speaker ON is not such a device, and generates OK.)

ERROR - If n does not equal 0, 1, 2, 3, or 4, or if already off-hook.

Command Options:

#VLS? - This query returns the current setting of the #VLS command as an ASCII decimal value in result code format.

#VLS=? - This query request a report of the device types available for selection. The response is a series of numbers separated by commas, and each number indicates a device position number. Currently, device position numbers do happen to correspond to device type numbers, but this correlation is not required (0's could be placed in the first few device position number locations to correspond to multiple telephone line connections).

#VLS=0 - The default option on the modem. This command instructs the modem that when entering any of the three voice operating submodes (Online Command, Transmit, or Receive), that the telephone line interface should be routed through the modem. The OK response is sent to the DTE, and any previous connection is lost (the modem ends up on-hook as a result of issuing this command to connect to the telephone line).

#VLS=1 - This command instructs the modem to route only the handset through the modem. This setting can be chosen before recording a greeting message.

#VLS=2 - This command instructs the modem to route only the speaker through the modem. This setting can be chosen before playing back any message. The modem immediately switches to Online Voice Command Mode, and the VCON response is generated for completeness. However, since this is an output only device, nothing of consequence can happen until the DTE sends the #VTX command.

#VLS=3 - This command instructs the modem that only the auxiliary input device (microphone) should be routed through the modem. This setting can be chosen before recording a greeting message.

#VLS=4 - This command is the same as #VLS=0, except that the modem enables the internal speaker as well as the telephone line/handset circuit.

Device Types Supported by #VLS

ASCII                                                                              

Digit   Device Type and Considerations                                             

0       Telephone Line with Telephone handset - This is the default device         

        selected. In this configuration, the user can pick up a handset which is    

        connected to the same telephone line as the modem, and record both sides of 

        a conversation with a remote station. The modem currently supports one      

        telephone line/handset, which is in the first position of the #VLS=?        

        response.                                                                   

        Note: The modem can interface to multiple telephone lines by having 0s in  

        multiple positions in the #VLS? response.                                   



1       Transmit/Receive Device (other than telephone line) - This is a handset,   

        headset, or speakerphone powered directly by the modem. When such a device  

        is selected, the modem immediately enters Online Voice Command Mode, DTMF   

        monitoring is enabled if applicable, and the VCON response is sent. The     

        modem supports one such device as the second device listed in the #VLS=?    

        response.                                                                   


2       Transmit Only Device - Normally, this is the onboard speaker. When such a  

        device is selected, the modem immediately enters Online Voice Command Mode, 

        and the VCON response is sent. The modem supports selection of the internal 

        speaker as the third device listed in #VLS=? response.                      


3       Receive Only Device - Normally, this is a microphone. When such a device is 

        selected, the modem immediately enters Online Voice Command Mode, DTMF      

        monitoring is enabled if applicable, and the VCON response is sent. The     

        modem supports one microphone as the fourth element returned in the #VLS=?  

        response.                                                                   


4       Telephone line with Speaker ON and handset - This device type can be used  

        to allow the DTE to select the telephone line/handset (if picked up) with   

        the modem speaker also turned ON. This can be used by the DTE to allow the  

        user to monitor an incoming message as it is recorded.

Click here to return to the Contents page.