Heos

From HSYCO
Jump to navigation Jump to search

Heos by Denon comprises a set of HiFi audio systems integrated with HSYCO via WiFi or Ethernet connection. A single HEOS I/O Server controls all the devices connected to the local network.

The driver has been tested on firmware version 1.289.95 of the HEOS devices.

Communication

Just make sure the Heos devices are connected to the same local network as HSYCO server is.

HSYCO Configuration

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

High Availability

  • User: username for the HEOS account (optional)
  • Password: password for the HEOS account (if User is provided)
  • Shutdown when inactive: defaults to false.

Options

ID Default Values Description
startupevents false true generate IO events also during the driver’s start-up phase
false start generating events only after HSYCO is aligned with the current status of the system

Datapoints

In the following table, replace <name> with the name assigned to each player. Names are transformed to lowercase and spaces are replaced by '-'. For instance, if the name assigned to a player is "Example Name", the <name> part of the corresponding datapoints will be "example-name". The same applies to <group_name> placeholders.

ID Value R/W Description
connection online R connection established
offline R HSYCO can't connect to the device
<name>.model <model_name> R reports the model name of this player, e.g. "HEOS 3"
<name>.version <version_number> R reports the version number of this player, e.g. "1.289.95"
<name>.state play R the audio stream is playing
W start playing
pause R the audio stream is paused
W pause the audio stream
stop R the audio stream is stopped
W stop the audio stream
<name>.song <title> R reports the title of the song currently playing
<name>.album <album_name> R reports the name of the album currently playing
<name>.artist <artist_name> R reports the name of the artist currently playing
<name>.image_url <url> R reports the URL of the artwork of the track currently playing
<name>.image_url <url> R reports the URL of the artwork of the track currently playing
<name>.volume 0% ... 100% R the volume is set to the reported value
W set the volume to the specified value
+<n> W increase the volume of the specified value (e.g. "+10")
-<n> W decrease the volume of the specified value (e.g. "-10")
<name>.mute 1 R the audio is muted
W mute the audio
0 R the audio is not muted
W unmute the audio
flip W invert the mute state
<name>.progress 0% ... 100% R the progress of the currently playing track reached the reported value
<name>.qid <queue_id> R reports the queue position of the current track
W play the track at the specified queue position
<name>.qid.remove <queue_id> W remove from the queue the specified element
all W clear the queue
<name>.sid <source_id> R reports the source id currently set on the player
<name>.mid <media_id> R reports the media id currently set on the player
<name>.next W play next track in the queue
<name>.previous W play previous track in the queue
<name>.repeat on_one R the player is set on repeat mode on the current track
W enable repeat mode on the current track
on_all R the player is set on repeat mode on the current queue
W enable repeat mode on the current queue
off R repeat mode is off
W disable repeat mode
<name>.shuffle on R shuffle mode is on
W set shuffle mode on
off R shuffle mode is off
W set shuffle mode off
<name>.type song R the player is currently playing a song
station R the player is currently playing a radio station
group.<group_name>.volume 0% ... 100% R the volume is set to the reported value
W set the volume to the specified value
+<n> W increase the volume of the specified value (e.g. "+10")
-<n> W decrease the volume of the specified value (e.g. "-10")
group.<group_name>.mute 1 R the audio is muted
W mute the audio
0 R the audio is not muted
W unmute the audio
flip W invert the mute state
group.create <players_list> W group the listed players. The value is a list of names of players separated by ';' (e.g. "player1;plarer2"). The first player in the list becomes the group leader
<group_leader_name> W remove the group whose leader player is the specified one
<name>.play.song <song_id> W play the track with the specified song ID
<name>.play.station <station_id> W play the radio station with the specified station ID

Song and station IDs
To get the ID of a song or a radio station refer to Heos Utility

User Interface

UISET Actions

ID Attribute Set to
connection visible true when datapoint connection = offline
false when datapoint connection = online
<name>.state.play visible true when datapoint <name>.state = play
false otherwise
<name>.state.pause visible true when datapoint <name>.state = pause
false otherwise
<name>.state.stop visible true when datapoint <name>.state = stop
false otherwise
<name>.volume value the current volume's value (0 ... 100)
<name>.mute.0 visible true when datapoint mute = 0
false when datapoint mute = 1
<name>.mute.1 visible true when datapoint mute = 1
false when datapoint mute = 0
<name>.repeat.off visible true when datapoint <name>.repeat = off
false otherwise
<name>.repeat.on_all visible true when datapoint <name>.repeat = on_all
false otherwise
<name>.repeat.on_one visible true when datapoint <name>.repeat = on_one
false otherwise
<name>.shuffle.off visible true when datapoint <name>.shuffle = off
false when datapoint <name>.shuffle = on
<name>.shuffle.on visible true when datapoint <name>.shuffle = on
false when datapoint <name>.shuffle = off
<name>.progress value the current track progress value (0% ... 100%)
<name>.qid value the queue position of the current track
<name>.song value the title of the song currently playing
<name>.album value the title of the album currently playing
<name>.artist value the title of the artist currently playing
<name>.queue values list of qids of queued tracks
labels list of qid, title, artist and album of queued tracks

USER Commands

Use the IDs and values listed in the datapoints table respectively as name and param for USER objects to perform the corresponding actions.

Release Notes

3.5.0

  • initial release


Heos and Denon are registered trademarks of D&M Holdings, Inc.