Zektor Palladia™ 8X8 - Manual (Page 53)

HDA800(V2) Serial Protocol, Version 1.3, 9/12/13 53
Audio Control
^VZ @ zone,@zone,vol Set the volume of a zone or zones.
^VZ @ zone,+step$ Add ‘step’ number of 0.5dB steps to current volume.
^VZ @ zone,-step$ Subtract ‘step’ number of 0.5dB steps from current volume.
^VZ ?$ In polled mode, reads current settings of all volume changes.
^VZ @ zone,@zone,?$ Read current volume settings of given zone(s).
Response Strings:
^=VZ @ zone,vol$
Where:
@ zone = One (or more) zones to be affected.
vol = Volume in 0.5dB steps with an offset of 200.
To jump immediatly 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).
Using the ‘+’ or ‘-’ modifiers to adjust the current volume level will disable the mute command.
(See“‘VMZ’ Mute a Zone using Volume Control” on page 57.) The current volume level used will
be the value heard by the user (volume - mute attenutation). In other words, when adjusting the volume
using +/- values, the volume will go up or down from the current value being heard by the user, regard-
less of the mute setting. The mute setting will be cancelled (unmuted), but will not have an affect on
the volume level. The VMZ response will be sent to the controller to indicate mute was cancelled,
along with the VZ response to indicate the new unmuted volume level.
Setting the volume without using the ‘+’ or ‘-’ modifiers will not have an affect on the mute 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 55), or below the ‘minVol’
setting (See “‘VMIZ’ Set Zone’s Minimum Volume” on page 54), 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 ‘10200’ (fade to 200 over time), the value returned will be
200, not 10200.
‘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.
The easiest way to use the volume on the HDA800(V2) 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.
(Or perhaps an even easier way is to use the VPZ command instead of the VZ command. The VPZ com-
mand allows the volume to be set using a number between 0 and 100 regardless of the minimum and
maximum volume settings. See “‘VPZ’ Set Zone’s Volume as a Percentage” on page 55)
If you really need to set the volume in actual dBs, you can adjust to an absolute volume, in decibels, by
taking the gain in decibels, multiply by 2 (to account for 0.5dB steps), add 200 and use that as the vol-
ume level.