Difference between revisions of "Nuvo"

From HSYCO
Jump to navigation Jump to search
 
(21 intermediate revisions by the same user not shown)
Line 94: Line 94:
  
 
|system.version
 
|system.version
|firmware id
+
|style="white-space:nowrap"|<firmware id>
 
|R
 
|R
 
|version information of the firmware installed on the MPU
 
|version information of the firmware installed on the MPU
 
|-  
 
|-  
  
|rowspan="3" |system.mute
+
|rowspan="3" |system.power
 
|1
 
|1
 
|R
 
|R
Line 110: Line 110:
 
|W
 
|W
 
|turn the system off. An “off” value is equivalent to 0
 
|turn the system off. An “off” value is equivalent to 0
 +
|-
 +
 +
|rowspan="4"|system.mute
 +
|rowspan="2"|1
 +
|R
 +
|system muted
 +
|-
 +
|W
 +
|mute all zones. An “on” value is equivalent to 1
 +
|-
 +
|rowspan="2"|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
 +
|-
 +
 +
|rowspan="4"|system.page
 +
|rowspan="2"|1
 +
|R
 +
|page mode is on
 +
|-
 +
|W
 +
|enter page mode. An “on” value is equivalent to 1
 +
|-
 +
|rowspan="2"|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
 +
|-
 +
 +
|rowspan="4"|z<n>.power
 +
|rowspan="2"|1
 +
|R
 +
|zone <n> is on
 +
|-
 +
|W
 +
|turn zone <n> on. An “on” value is equivalent to 1
 +
|-
 +
|rowspan="2"|0
 +
|R
 +
|zone <n> is off
 +
|-
 +
|W
 +
|turn zone <n> off. An “off” value is equivalent to 0
 +
|-
 +
 +
|rowspan="3"|z<n>.source
 +
|rowspan="2"|<nowiki><s></nowiki>
 +
|R
 +
|zone <n> audio source is <nowiki><s></nowiki> (from 1 to 6)
 +
|-
 +
|W
 +
|set zone <n> to source <s>
 +
|-
 +
|next
 +
|W
 +
|set zone <n> to the next source
 +
|-
 +
 +
|rowspan="9"|z<n>.volume
 +
|rowspan="2"|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>
 +
|-
 +
|rowspan="2"|<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>
 +
|-
 +
 +
|rowspan="2"|z<n>.mute
 +
|1
 +
|R
 +
|zone <n> volume is muted
 +
|-
 +
|0
 +
|W
 +
|mute zone <n>. An “on” value is equivalent to 1
 +
|-
 +
 +
|rowspan="4"|z<n>.dnd
 +
|rowspan="2"|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
 +
|-
 +
|rowspan="2"|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
 +
|-
 +
 +
|rowspan="6"|z<n>.lock
 +
|rowspan="2"|1
 +
|R
 +
|zone <n> is locked
 +
|-
 +
|W
 +
|enable lock mode for zone <n>. An “on” value is equivalent to 1
 +
|-
 +
|rowspan="2"|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
 +
|-
 +
 +
|rowspan="6"|z<n>.button
 +
|rowspan="2"|prev
 +
|R
 +
|the PREV [ << ] button has been pressed on the Control Pad for zone <n>
 +
|-
 +
|W
 +
|simulate zone PREV [ << ] button on Control Pad
 +
|-
 +
|rowspan="2"|next
 +
|R
 +
|the NEXT [ << ] button has been pressed on the Control Pad for zone <n>
 +
|-
 +
|W
 +
|simulate zone NEXT [ << ] button on Control Pad
 +
|-
 +
|rowspan="2"|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
 +
|-
 +
 +
|rowspan="2"|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
 +
|<time>
 +
|R
 +
|length of the song in 10th seconds. Only updated when the song starts playing
 +
|-
 +
 +
|s<n>.time
 +
|<time>
 +
|R
 +
|current run time of the song in 10th seconds. Only updated when the song starts playing
 +
|-
 +
 +
|rowspan="9"|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
 
|-
 
|-
  
Line 128: Line 430:
 
!colspan="2"|Set to
 
!colspan="2"|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 ===
 
=== USER Commands ===
Line 136: Line 520:
 
!Action
 
!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.<s>
 +
|select source <s> (1 to 6) for this zone
 +
|-
 +
 
|}
 
|}
  

Latest revision as of 14:06, 29 April 2014

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:

UI Object nuvo.png

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:

UI Object nuvomini.png

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.