Sonos
Sonos comprises a set of HiFi audio systems integrated with HSYCO via WiFi or Ethernet connection. A single SONOS I/O Server controls all the devices connected to the local network.
Contents
Communication
Just make sure the Sonos device is connected to the same local network as HSYCO server is.
HSYCO Configuration
Add a SONOS I/O Server in the I/O Servers section of the Settings and set its parameters:
High Availability
- 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 | ||
| room | <room_name> | If specified, the driver will connect to the device with the corresponding room name. If not specified this driver will look for and connect to any Sonos device on the local network |
Datapoints
| ID | Value | R/W | Description |
|---|---|---|---|
| connection | online | R | connection established |
| offline | R | HSYCO can't connect to the device | |
| <player>.state | play | R | the audio is playing |
| W | start playing | ||
| pause | R | the audio is paused | |
| W | pause the audio | ||
| stop | R | the audio is stopped | |
| W | stop the audio stream | ||
| transitioning | R | the device is transitioning between audio streams | |
| unknown | R | the current state is unknown | |
| <player>.track.number | <n> | R | the current track is the number <n> in the current queue (can be "unknown") |
| <player>.track.title | <title> | R | title of the current track (can be "unknown") |
| <player>.track.creator | <name> | R | name of the author of the current track (can be "unknown") |
| <player>.track.album | <name> | R | name of the album of the current track (can be "unknown") |
| <player>.track.albumarturi | <uri> | R | uri of the album art of the current track (can be "unknown") |
| <player>.mute | 1 | R | the audio is muted |
| W | mute the audio | ||
| 0 | R | the audio is not muted | |
| W | unmute the audio | ||
| <player>.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 | |
| -<n> | W | decrease the volume of the specified value | |
| <player>.play | <uri> | W | play the audio file located at the specified URI |
| <player>.queue | next | W | go to the next queued track |
| prev | W | go to the previous queued track | |
| <n>:<uri> | W | add to the current queue, in <n>-th position, the audio file located at the specified URI (set <n> to 0 to add it at the end of the queue) |
User Interface
UISET Actions
| ID | Attribute | Set to | |
|---|---|---|---|
| connection | visible | true | when datapoint connection = offline |
| false | when datapoint connection = online | ||
| <player>.state.play | visible | true | when datapoint <player>.state = play |
| false | otherwise | ||
| <player>.state.pause | visible | true | when datapoint <player>.state = pause |
| false | otherwise | ||
| <player>.state.transitioning | visible | true | when datapoint <player>.state = transitioning |
| false | otherwise | ||
| <player>.state.stop | visible | true | when datapoint <player>.state = stopped |
| false | otherwise | ||
| <player>.track.number | value | the current track number | |
| <player>.track.title | value | the current track's title | |
| <player>.track.creator | value | the current track's author | |
| <player>.track.album | value | the name of the current track's album | |
| <player>.mute.1 | visible | true | when datapoint <player>.mute = 1 |
| false | when datapoint <player>.mute = 0 | ||
| <player>.mute.0 | visible | true | when datapoint <player>.mute = 0 |
| false | when datapoint mute = 1 | ||
| <player>.volume | value | the current volume's value (0 ... 100) | |
USER Commands
| Name | Param | Action |
|---|---|---|
| <player>.state | play | start playing |
| pause | pause the audio | |
| stop | stop the audio stream | |
| <player>.play | <uri> | play the audio file located at the specified URI |
| <player>.volume | 0 ... 100 | set the volume to the specified value |
| +<n> | increase the volume of the specified value | |
| -<n> | decrease the volume of the specified value | |
| <player>.mute | 1 | mute the audio |
| 0 | unmute the audio | |
| <player>.queue | next | go to the next queued track |
| previous | go to the previous queued track | |
| <n>:<uri> | add to the current queue, in <n>-th position, the audio file located at the specified URI (set <n> to 0 to add it at the end of the queue) |
Release Notes
3.5.0
- initial release
Sonos is a registered trademark of Sonos, Inc.
