Difference between revisions of "Sonos"

From HSYCO
Jump to navigation Jump to search
Line 60: Line 60:
 
|-
 
|-
  
|rowspan="5" |state
+
|rowspan="5" |<player>.state
 
|playing
 
|playing
 
|R
 
|R
Line 83: Line 83:
 
|-
 
|-
  
|track.number
+
|<player>.track.number
 
|<n>
 
|<n>
 
|R
 
|R
Line 89: Line 89:
 
|-
 
|-
  
|track.title
+
|<player>.track.title
 
|<title>
 
|<title>
 
|R
 
|R
Line 96: Line 96:
 
|-
 
|-
  
|track.creator
+
|<player>.track.creator
 
|<name>
 
|<name>
 
|R
 
|R
Line 103: Line 103:
 
|-
 
|-
  
|track.album
+
|<player>.track.album
 
|<name>
 
|<name>
 
|R
 
|R
Line 110: Line 110:
 
|-
 
|-
  
|track.albumarturi
+
|<player>.track.albumarturi
 
|<uri>
 
|<uri>
 
|R
 
|R
Line 117: Line 117:
 
|-
 
|-
  
|rowspan="4" |mute
+
|rowspan="4" |<player>.mute
 
|rowspan="2" |1
 
|rowspan="2" |1
 
|R
 
|R
Line 134: Line 134:
 
|-
 
|-
  
|rowspan="4" |volume
+
|rowspan="4" |<player>.volume
 
|rowspan="2" |0 ... 100
 
|rowspan="2" |0 ... 100
 
|R
 
|R
Line 152: Line 152:
 
|-
 
|-
  
|rowspan="2" |play
+
|rowspan="2" |<player>.play
 
|
 
|
 
|W
 
|W
Line 163: Line 163:
 
|-
 
|-
  
|pause
+
|<player>.pause
 
|
 
|
 
|W
 
|W
Line 170: Line 170:
 
|-
 
|-
  
|stop
+
|<player>.stop
 
|
 
|
 
|W
 
|W
Line 177: Line 177:
 
|-
 
|-
  
|next
+
|<player>.next
 
|
 
|
 
|W
 
|W
Line 184: Line 184:
 
|-
 
|-
  
|previous
+
|<player>.previous
 
|
 
|
 
|W
 
|W
Line 191: Line 191:
 
|-
 
|-
  
|queue
+
|<player>.queue
 
|<n>:<uri>
 
|<n>:<uri>
 
|W
 
|W

Revision as of 08:21, 18 June 2015

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.

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 playing R the audio is playing
paused_playback R the audio is paused
transitioning R the device is transitioning between audio streams
stopped R the audio is stopped
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 W start playing
<uri> W play the audio file located at the specified URI
<player>.pause W pause the audio
<player>.stop W stop the current queue
<player>.next W go to the next queued track
<player>.previous W go to the previous queued track
<player>.queue <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
state.playing visible true when datapoint state = playing
false otherwise
state.paused_playback visible true when datapoint state = paused_playback
false otherwise
state.transitioning visible true when datapoint state = transitioning
false otherwise
state.stopped visible true when datapoint state = stopped
false otherwise
track.number value the current track number
track.title value the current track's title
track.creator value the current track's author
track.album value the name of the current track's album
mute.1 visible true when datapoint mute = 1
false when datapoint mute = 0
mute.0 visible true when datapoint mute = 0
false when datapoint mute = 1
volume value the current volume's value (0 ... 100)

USER Commands

Name Param Action
play start playing
<uri> play the audio file located at the specified URI
pause pause the audio
stop stop the current queue
next go to the next queued track
previous go to the previous queued track
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
mute 1 mute the audio
0 unmute the audio
queue <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.