Description:

This driver controls the Nuvo Grand Concerto multiple audio zone controller. This driver provides basic control of all zones supported by this receiver (up to 20).

Quirks and Limitations:

None known.

Connection Details:

The parameters are 57600 baud, 8 bits, one stop bit, no parity, no handshaking. If connecting to a standard PC port, you will need a null-modem.

Driver Fields:

This section lists the fields that the driver makes available, their types, minimum and maximum values, etc...

Name	Type	R/W	Description/Limits
ZxPower	Boolean	R/W	Read or set the power state for Zone X.
ZxSourceSelect	String	R/W	Read or set the source selected for Zone X. Valid choices are Source1 to Source6.
ZxVolume	Int	R/W	Read or set the volume for Zone X. Range of values is from -79 (minimum) to 0 (maximum).
ZxMute	Boolean	R/W	Read or set the mute for Zone X.
ZxDoNotDisturb	Boolean	R/W	Read or set the Do Not Disturb for Zone X.
PartyMode	String	W	Set the source for all zones. Valid choices are Source1 to Source6. NOTE: This is different than the Party Mode functionality provided by the Grand Concerto front panel.
AllZonePower	String	W	Set all zones on or off. Valid values are AllZonesOff, and AllZonesOn.
SourceMessage	String	W	Write a line of text to all zones tuned to a particular source. Format of message is described below.
TrackStatus	String	W	Update the track status for a source. This makes use of the progress bar on zone displays. Format of message is described below.
PagingMode	Boolean	W	Set the paging mode for the Grand Concerto.

User Events

This driver supports user events for the following actions:

• Pressing the Play/Pause button on a zone keypad
• Pressing the Prev button on a zone keypad
• Pressing the Next button on a zone keypad
• Running an IR macro

When one of the above events happen, a user-generated event occurs which can be trapped and acted upon. Here is the format of the event:

Event Type: Button
Event Data: ZxxSy<ButtonName>

xx: zone num, from 01 to 20
y: Source num, from 1 to 6
<ButtonName>: Any of the following: PREV, NEXT, PLAYPAUSE, MACRO

Note: If button name is "MACRO", then the number of which macro was used follows the name. So, MACRO5 indicates the 5th macro on the drop down list was run. Since the length of that string can be variable, it'd be best to just convert the remainder of the string beyond "MACRO" into a number.

SourceMessage

Using this field, you can write text to a specific line on every zone tuned to a particular source. This is useful for displaying an album name or song title. Note: This only works with non-Nuvo sources.

The message written to the field must conform to the following format:

s,n,message

s = source number (1 to 6)
n = line number on zone display (1 to 4)
message = text to display
Ex: Writing 2,3,Hello would put the text Hello on the 3rd line of every zone display that is listening to source 2.

TrackStatus

Use this field to update certain parameters about a source, such as its play mode and song time progress. The message written to the field must conform to the following format:

s,x,y,z

s = source number (1 to 6)
x = total length of song, in seconds
y = current track time in seconds
z = playmode, with the following possible values:

0 = Normal
1 = Idle
2 = Playing
3 = Paused
4 = Fast Forward
5 = Rewind
6 = Play Shuffle
7 = Play Repeat
8 = Play Shuffle Repeat

Ex: Writing 3,3600,1800,3 would cause all of the zones listening to source 3 to show that the 6-minute long song is halfway finished, and currently paused.