VOLUME VOL VM

Description:

      Adjusts the value of the volume in db increments.  The volume will 
      attenuate, amplify or mute the audio.  The volume level for analog and 
      SPDIF are both modified.  The valid range is -49 db to +24 db. For RD,
      valid ranges are -40 to 18.
    

Form:

      Command Handler: DCMD
      VOLUME|VOL|VM [ [VALUE] | [TYPE [CH# [VALUE]]]
      Argument List:

      TYPE           MASTER - get volume for all types (set returns error)
                     ANALOG - set/get volume for analog

      VALUE          Default range is -49 to 24
                     When TYPE=ANALOG range is -40 to 20
                     For RD valid range is -40 to 18
                     [MUTE] and [,] can also be argued:
                        [MUTE] - sets value to the minimum
                        [,]    - sets value to current config

      CH#            When TYPE=MASTER channel is not applicable (returns error)
                     When TYPE=ANALOG Valid values are 0 or 2 
                        (0 sets left and right volume for first analog pair)
                        (2 sets left and right volume for second analog pair)
    

Response:

      VOLUME RESPONSE
        Verbose- "OK\r\n" to acknowledge receipt of command, or
                 "ERROR- [Description]\r\n" if error, ending command
        Terse-   "0\r\n" to acknowledge receipt of command, or
                 "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
                 "\r\n" concludes modify responses (empty line)
    

Examples:

      Command to set the master volume:
      *.DCMD VOLUME 10
      OK

      Command to get analog volume:
      *.DCMD VOLUME ANALOG
      OK
      ANALOG_CH0=10
      ANALOG_CH1=10
      ANALOG_CH2=10
      ANALOG_CH3=10

      Command to mute the first analog pair (channel 0):
      *.DCMD VOLUME ANALOG 0 MUTE
      OK

      Check previous command, note that channel 0 and 1 (first pair) are muted:
      *.DCMD VOLUME ANALOG
      OK
      ANALOG_CH0=-40
      ANALOG_CH1=-40
      ANALOG_CH2=10
      ANALOG_CH3=10

      Command to query a single analog channel:
      *.DCMD VOLUME ANALOG 0
      OK
      ANALOG_CH0=-40
    

Notes:

      Default volume value is 0 db.
      For RD, default volume value is 18 db.
    
Created By: Adtec Digital