Nuvo

NuVo Grand Concerto and Essentia E6G are multi-source, multi-zone audio distribution systems that may be integrated to work with external control systems and servers. The central unit is called Main Processor Unit (MPU).

It provides power supply, source audio routing to the zones, amplified stereo audio output for each zone and centralized control and interface for all zones.

Communication

Employ a DE-9 (often called DB-9) male-female RS-232 straight cable to connect the RS-232 MPU port to the serial port on HSYCO SERVER.

You can also define and connect to more than one NUVO MPU to control multiple systems.

RS-232 parameters:

Baud rate	57600
Data bits	8
Stop bit	1
Parity	none
Flow control	none

Nuvo Configuration

On the NUVO device, a number of contiguous sources starting from the source 1 must be configured.

One of the areas 17 to 20 must be reserved for communication with HSYCO.

HSYCO Configuration

Add a Nuvo I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

• Comm ID: select the comm port connected to the panel.

High Availability

• Shutdown when inactive: defaults to true.

Options

ID	Default	Values	Description
gui	true	true	enable support for the UI object, UISET actions and USER commands
		false	disable UI support
menuzone	20	17 ... 20	defines which virtual zone will be used to access the menu system
menulines	10		the number of menu item lines

Datapoints

ID	Value	R/W	Description
connection	online	R	connection established to the MPU
	offline	R	HSYCO can't connect to the MPU
system.version	<firmware id>	R	version information of the firmware installed on the MPU
system.power	1	R	at least one zone is on
	0	R	the ALLOFF command has been sent and all zones are off
		W	turn the system off. An “off” value is equivalent to 0
system.mute	1	R	system muted
		W	mute all zones. An “on” value is equivalent to 1
	0	R	system un-muted
		W	return all zones to the volume level as set before the system mute command was sent. An “off” value is equivalent to 0
system.page	1	R	page mode is on
		W	enter page mode. An “on” value is equivalent to 1
	0	R	page mode is off
		W	turn page mode off. An “off” value is equivalent to 0
system.message	<text>	W	send a text message to all Control Pads, up to 50 characters
system.response	<text>	R	the native protocol response message. This event is generated only if the message is ignored or not recognized by the driver
system.command	<text>	W	send a native protocol command to the MPU. Do not include the leading “*” character and trailing carriage return in the text value when setting this IO variable
z<n>.name	<name>	R	zone <n> name
z<n>.power	1	R	zone <n> is on
		W	turn zone <n> on. An “on” value is equivalent to 1
	0	R	zone <n> is off
		W	turn zone <n> off. An “off” value is equivalent to 0
z<n>.source	<s>	R	zone <n> audio source is <s> (from 1 to 6)
		W	set zone <n> to source
	next	W	set zone <n> to the next source
z<n>.volume	off	R	zone <n> volume is muted
		W	mute zone <n>. A 0 value is also interpreted as mute
	on	W	un-mute zone <n>
	<x%>	R	zone <n> volume level is 1% to 100%
		W	set zone <n> volume level to X%
	<x>	W	set the zone <n> volume level. <x> is a number between 0 and 100. Decimal numbers are accepted and truncated
	<x>/<y>	W	set the zone <n> volume level. <x>/<y> is a fractional number between 0 and 100. Decimal numbers are accepted and truncated
	up	W	increase volume (by one step) for zone <n>
	down	W	decrease volume (by one step) for zone <n>
z<n>.mute	1	R	zone <n> volume is muted
	0	W	mute zone <n>. An “on” value is equivalent to 1
z<n>.dnd	1	R	Do not disturb (DND) mode is on for zone <n>
		W	enable do not disturb mode for zone <n>. An “on” value is equivalent to 1
	0	R	Do not disturb (DND) mode is off for zone <n>
		W	disable do not disturb mode for zone <n>. An “off” value is equivalent to 0
z<n>.lock	1	R	zone <n> is locked
		W	enable lock mode for zone <n>. An “on” value is equivalent to 1
	0	R	zone <n> is not locked
		W	disable lock mode for zone <n>. An “off” value is equivalent to 0
	on	W	lock zone <n>
	<xxxx>	W	unlock zone <n>. <xxxx> is the four digit unlock code
z<n>.button	prev	R	the PREV [ << ] button has been pressed on the Control Pad for zone <n>
		W	simulate zone PREV [ << ] button on Control Pad
	next	R	the NEXT [ << ] button has been pressed on the Control Pad for zone <n>
		W	simulate zone NEXT [ << ] button on Control Pad
	playpause	R	the PLAY/PAUSE [ << ] button has been pressed on the Control Pad for zone <n>
		W	simulate zone PLAY/PAUSE [ << ] button on Control Pad
z<n>.macro	<m>	R	the IR macro number <m> is exectued
z<n>.party	1	W	make zone <n> the party host
	0	W	release party host mode for zone <n>
z<n>.playlist	<x>	W	select a favorite playlist for zone <n>. The <x> value should be 1 to 12
z<n>.bright	<x>	W	set the Control Pad display’s brightness for zone <n>. The <x> value should be 1 (min) to 7 (max)
s<n>.name	<name>	R	source <n> name
s<n>.displine.1	<text>	R	the display line 1 text for source <n>
s<n>.displine.2	<text>	R	the display line 2 text for source <n>
s<n>.displine.3	<text>	R	the display line 3 text for source <n>
s<n>.displine.4	<text>	R	the display line 4 text for source <n>
s<n>.lenght		R	length of the song in 10th seconds. Only updated when the song starts playing
s<n>.time		R	current run time of the song in 10th seconds. Only updated when the song starts playing
s<n>.status	normal	R	normal mode for not NuVo Net sources
	idle	R	idle mode for not NuVo Net sources
	play	R	playing
	pause	R	paused
	ffd	R	fast forward
	rew	R	rewind
	playshuffle	R	playing, shuffle mode
	playrepeat	R	playing, repeat mode
	playshufflerepeat	R	playing, shuffle/repeat mode

User Interface

Nuvo Object

The user interface for the Nuvo multi-room system:

The Nuvo object is listed in the Project Editor’s new object list only when at least one Nuvo I/O Server is defined.

Parameters

• server id: the server ID
• zone number: zone number of the Nuvo multi-room system
• position: the object's position. Use the pixels or rows and columns coordinates format

Syntax

(nuvo <server id>; <zone number>; <position>)

E.g.

(nuvo serverid; 1; x10y20)

NuvoMini Object

The user interface for the Nuvo multi-room system:

The NuvoMini object is listed in the Project Editor’s new object list only when at least one Nuvo I/O Server is defined.

Parameters

• server id: the server ID
• zone number: zone number of the Nuvo multi-room system
• position: the object's position. Use the pixels or rows and columns coordinates format

Syntax

(nuvomini <server id>; <zone number>; <position>)

E.g.

(nuvomini serverid; 1; x10y20)

UISET Actions

ID	Attribute	Set to
z<n>.zonedisplay	visible	true when the menu display for the zone is not active, false otherwise
z<n>.name	value	the zone name, retrieved from the MPU configuration
z<n>.source	value	the source number followed by the source name, as set in the MPU
z<n>.volume.status	value	invisible: zone off; MUTE: muted; <x%>: volume level, 1% to 100%
z<n>.displine.1	value	the line 1 of the source display, for the source currently in use by this zone
z<n>.displine.2	value	the line 2 of the source display, for the source currently in use by this zone
z<n>.displine.3	value	the line 3 of the source display, for the source currently in use by this zone
z<n>.displine.4	value	the line 4 of the source display, for the source currently in use by this zone
z<n>.status	value	ON: generic on for not NuVo Net sources; OFF: off; PAUSE: paused; PLAY: playing; PLAY [SH]: playing, shuffle mode; PLAY [REP]: playing, repeat mode; PLAY [SH][REP]: playing, shuffle repeat mode; FAST FORWARD: fast forward mode; REWIND: rewind mode
z<n>.menudisplay	visible	true when the menu display for the zone is active
menu.wait	visible	true when the NuVo MPU takes some time to retrieve a menu (this can happen when retrieving long lists of songs from the iPod, for example)
menu.name	value	menu title
menu.line.<n>	value	the menu items’ text lines. <n> starts from 1, up to the number of menu display lines as set in the options (default is 10)
menu.line.header	value	this object shows a few dots (....) when you can scroll up the menu. Place this object above the first menu line
menu.line.footer	value	this object shows a few dots (....) when you can scroll down the menu. Place this object below the last menu line
z<n>.volume	value	0: mute or zone off; <x%>: volume level, 1% to 100%

USER Commands

Name	Param	Action
z<n>	power	zone power on/off button
z<n>	menu	simulate MENU button on Control Pad
z<n>	up	simulate UP button on Control Pad (increment volume level in approx. 5% steps, or move up one line in the menu)
z<n>	down	simulate DOWN button on Control Pad (decrement volume level in approx. 5% steps, or move down one line in the menu)
z<n>	playpause	simulate zone PLAY/PAUSE button on Control Pad
z<n>	ok	simulate zone OK button on Control Pad
z<n>	prev	simulate zone PREV [ << ] button on Control Pad
z<n>	next	simulate zone NEXT [ >> ] button on Control Pad
z<n>	source	cycle zone sources
z<n>	source.	select source (1 to 6) for this zone

Release Notes

3.2.1

• log more verbose in case of failure of initial reading

3.0.1

• various bug fixes
• adds support for z<n>.volume.status text field
• adds support for z<n>.volume.up and <ioserver_id>.z<n>.volume.down (user) buttons

3.0.0

• full integration in HSYCO 3.0.0

---

NuVo is a registered trademark of NuVo Technologies Inc.