Zektor HDA604 User Manual page 65

^VZ @zone,@zone,vol
^VZ @zone,+step$
^VZ @zone,-step$
^VZ @zone,@zone,?$
Response Strings:
^=VZ @zone,vol$
Where:
= One (or more) zones to be affected.
@zone
vol = Volume in 0.5dB steps with an offset of 200.
To jump immediately to a new volume, the range is 0 to 248.
To fade to a new level in a given time period the range is 10000 to 10248.
To fade to a new level at a given speed the range is 20000 to 20248.
The volume command is given in 0.5dB steps and uses an offset of 200 to indicate a attenuation of
0.0dB, 199 indicates 0.5dB of attenuation, and so forth, all way down to 1, which indicates a gain of -
99.5dB (or an attenuation of 99.5dB, depending on how you look at things).
The affect of this command, when the volume is muted, (See: "'VMZ' Audio Mute a Zone using Vol-
ume Levels" on page 69.), is dependent upon the settings of the 'MJP' and 'UVL' bits of the 'XS'
command (See: "'XS' Control Settings" on page 52).
If the 'MJP' flag is set, then sending a 'VZ' command with a '+' or '-' prefix will cause the zone to
unmute, and the volume will jump to it's previous unmuted value. Subsequent '+' or '-' commands
will increment or decrement from the new, unmuted value.
If the 'MJP' flag is cleared (reset), then sending a 'VZ' command with a '+' or '-' prefix will cause the
zone to unmute, but the volume of the zone will not be restored to the original unmuted level. The '+'
or '-' commands will increment or decrement the volume from the muted level.
If the 'UVL' flag is set, then sending a 'VZ' command without a '+' or '-' prefix will cause the zone to
unmute. It will then be set to given level of the 'VZ' command.
If the 'UVL' flag is cleared (reset), then sending a 'VZ' command without a '+' or '-' prefix will not
unmute the audio. The volume level will be changed, but the zone will remain muted. When the zone
is unmuted it will be set to this new 'VZ' setting.
When setting, raising or lowering the volume, the 'VZ' command will not allow you to go above
'maxVol' setting (See "'VMAZ' Set Zone's Maximum Volume" on page 68), or below the 'minVol'
setting (See "'VMIZ' Set Zone's Minimum Volume" on page 67), with an exception of '0', which is
always allowed).
The value 0 is special in that it indicates full attenuation, or fully muted audio.
The value returned from the VZ command will always be in the 0-248 range, regardless of the fade set-
tings. For instance if you set the volume to '10100' (fade to 100 over time), the value returned will be
100, not 10100.
'VZ' Examples
The 'VZ' command in its simplest form:
^VZ @1,200$
causes the audio on zone '1' to be set to the level '200', which is full volume, without gain.
The easiest way to use the volume on the Zektor Switch is to know that 200 is full volume, and 0 is off,
and everything step from 0 to 200 makes the audio louder by 0.5dB.
Zektor Switch Serial Protocol, Version 0.16, 5/13/16
Set the volume of a zone or zones.
Add 'step' number of 0.5dB steps to current volume.
Subtract 'step' number of 0.5dB steps from current volume.
Read current volume settings of given zone(s).
Audio Control
65