Sonos Zone Controller

Current version: 1.1.0
Date: 03/05/2020

FUNCTIONS
The functions of this Quick App are:

Allowing to control Sonos Player from Home Center 3. It does support basic and advanced functions:

• Basic Transport Control
  • Initiate playback
  • Toogle, Pause or Stop playback
  • Skip to the previous or Next track
• Basic Rendering Control
  • Get player volume and mute state
  • Set player volume to a specific level and unmute the player if muted
  • Increase or decrease player volume
  • Get or Set or Toggle player mute state (Mute or unmute the player)
  • Get or Set or Toggle player loudness state
•  Device Properties
  • Get or Set group LED state
• Restart the QA Device
• Enable Debug Mode

See Changelog / Manual for basic and advanced available actions

Examples:

• Set player volume to a specific level and unmute the player if muted.
  fibaro.call(ID_QUICKAPP, "setVolume", 10, "MASTER")
• Increase or decrease player volume.
  fibaro.call(ID_QUICKAPP, "setRelativeVolume", -5, "MASTER")
• Initiate playback.
  fibaro.call(ID_QUICKAPP, "play")
  

PREREQUISITES

• Fibaro Home Center 3 with firmware 5.030.45 or greater
• One or more Sonos devices

INSTALLATION AND SETUP
How to configurate the Quick App:

Fibaro Quick Apps manual: https://manuals.fibaro.com/home-center-3/ (see installing a quick APP)

Uploading file:

1. Open the Configuration Interface.
2. Go to Settings > Devices.
3. Click 
4. Choose Other Device
5. Choose Upload File
6. Choose file from your computer > SonosZoneController.fqa

Define variables:

1. Go to  > Devices
2. Choose Other Device
3. Open QA
4. Choose Varibles tab
5. Update the variables
   1. IP Address (ex: 192.168.1.200)
   2. TCP Port (1400 is the default port)
   3. Polling (Main polling setted to 10 seconds by default)
6. Save

Notes: notifications can be sent in case of configuration problems or communication errors with the device

ADDITIONAL DEVICES
Not required

DISCLAIMER
This software is provided by copyright owner "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the author and distributor be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

Fibar Group S.A. and their employees are not responsible for support of the Sonos Zone Controller Quick App.Please contact the author Jean-Christophe Vermandé (Krikroff), on the Fibaro Forum, for any questions or support required.

Fibaro Main Forum: https://forum.fibaro.com/profile/523-krikroff/
Non official French Forum: https://www.domotique-fibaro.fr/profile/3-krikroff/

LEGAL NOTICE
Sonos® is the trading name of Sonos Inc. in Santa Barbara, U.S.A. (Sonos legal terms)

PACKAGE CONTENT

• Sonos Zone Controller QuickApp (fqa)
• Changelog EN
• User Manual / Install EN
• Icon

RELEASE NOTES

Version 1.1.0

• Support for TuneIn "My radio stations" (with auto configuration up to 6 radios)
• Deletion of the variable variable "isConfigured" used by internal FTI Configuration
• Minor bug fixes (No route to host cause wrong configuration status)
• Tested with Sonos Software Version:55.1-74250 and 56.0-76060
• Performance improvement

Version 1.0.3

• Fix a problem with internal zoneGroups and ZoneGroupMembers parsing (Thanks to jgab, Alan Klepacz and robw)

Version 1.0.2

• Minor bug fixes (Thanks to Macschimmi, Bodyart, minsad79) 

Version 1.0.0

• Based on my HC2 virtual Device and completely rewriten for HC3 v5.030.45 or highter
• Very low latency and more robust device (commands execution, processing)
• Easy installation with auto configuration assist
• Support standard capabilities (AVTransport, RenderingControl)
• Displaying information on the currently playing or media loaded
• Fully controllable from the LUA scenarios (see available command list)

ROADMAP

• Performance improvement when initiating a playback
• Improved track information
• Support for saved playlists (saved queue list)
• Support for PlayMode
• Support for Queue fonctionnalities
• Support for LineIn and TV source (if supporteed by device)
• Support for multi-devices in group used for triggering in scene and prepare for group-ungroup
• Support for EQ (treble & bass)
• Support for Group
• Support for TTS (TextToSpeech)