Heos
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](#note1 s) |
| <name>.play.station | <station-id> | W | play the radio station with the specified station ID |
Note 1
To get the ID of a song or a radio station refer to Heos Utility
User Interface
UISET Actions
| ID | Attribute | ||
|---|---|---|---|
| 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 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.