Using Control4®​ ​with CasaTunes

Contents

IntroductionFeatures and BenefitsPrerequisitesInstallationDownload the Control4 drivers for CasaTunesInstall the CasaTunes AV Switch and MSP Player driversConnect the outputs of the AVSwitch to your roomsConnecting the output of each player to the input on the AV Switch Configuring your CasaTunes music server as a StreamerCasaTunes AV Switch Advanced SettingsAdvanced Programming in Control4Composer Pro Properties

Introduction

Control4, a popular home automation system, can be used to control CasaTunes whole house music systems and streamers.

CasaTunes provides out­-of­--the­box support for Control4, including support for SDDP discovery and support for the latest Media Server Proxy (MSP) protocol.

The CasaTunes drivers for Control4 support all CasaTunes CT systems, legacy CasaTunes XLi/e based systems, and CasaTunes systems configured for use with third party audio matrix switches, like those from Audio Authority, ChannelVision, HAI/Leviton, Nuvo, Russound, RTI, and SpeakerCraft.

In addition, you can configure your CasaTunes CT music server to operate as a multi­stream music player. In this mode, you can use your CasaTunes streamer with any other Control4 supported AV switches, whether these are from Control4, or from other vendors whose switches are supported by Control4.

This approach provides installers with maximum flexibility, allowing installers to install a complete CasaTunes solution, or if working in a retrofit situation, it allows installers to add the powerful CasaTunes multi­stream music player to existing installations.

Integration is provided via several Control4 drivers. The ​CasaTunes AV Switch driver (CT_AVSwitch.c4i) controls the CasaTunes software or hardware matrix switch (depending on the CasaTunes hardware installed), allows switching any input to any output, powering a room on or off, and controlling the room volume.

The ​CasaTunes MSP Player​ driver (CT­MSP­PlayerX.c4z) allows you to stream disc based music, Internet radio and other Internet based music services. You can configure as many CasaTunes MSP Players as you have CasaTunes Media Player sources (as shown in CasaSetup in the Sources tab). For example, a CT­-Plus-2/3/4/5/6 music server offers 2/3/4/5/6 streams respectively. The CasaTunes MSP Player driver implements the latest Control4 MSP Proxy.

Features and Benefits

The CasaTunes solution for Control4 adds many significant new capabilities to a Control4 installation, including:

  • Allows you to play and listen to different music in each room
  • CasaTunes offers a wide selection of music, including disc based music,networked music Internet radio and music services
  • Allows you to transparently stream music from any App on one or more iOS devices to any CasaTunes room, unleashing endless music and access to unique music Apps
  • CasaTunes music servers can optionally include disc storage to store your own music collections
  • You can quickly play, create and manage your music using CasaTunes Featured Items and Playlists
  • Wakeup and sleep to your favorite tunes
  • Allows you to control CasaTunes from Control4 touch panels, remotes, and apps, as well as control CasaTunes using the native CasaTunesX App for Amazon, Android, iOS and HTML5 browsers
  • Allows you to use the Control4 Composer Pro Programming Agent to play CasaTunes Playlists, Featured Items, and run unattended CasaTunes Smart Tasks, simplifying the automation of your music listening experience

Prerequisites

  • The Control4 drivers work with Control4 versions 2.7 through 3.4.1 (or later)
  • Control4 Composer Pro 2.7 through 3.4.1 (or later)
  • CasaTunes version 5.00.231116 or later

Installation

These steps assume you have already installed your CasaTunes system and it is properly configured and running stand alone.

Download the Control4 drivers for CasaTunes

Download the CasaTunes drivers for Control4 on to the same PC you use to run Composer Pro to configure your Control4 project. The Control4 drivers for CasaTunes are available from the downloads page on the CasaTunes web site. This page can be found at:

https://www.casatunes.com/downloads

Unzip and copy the drivers in to your Control4 Drivers folder. Start Composer Pro, and if you installed the drivers correctly, Composer Pro will automatically discover the installed CasaTunes components using SDDP.

Install the CasaTunes AVSwitch and MSP Proxy drivers

CasaTunes supports the Control4 SDDP protocol, simplifying the setup and configuration of your CasaTunes components in Control4. Using SDDP, all CasaTunes devices are automatically discovered and their IP network address are automatically resolved and configured. SDDP automatically downloads the CasaTunes drivers from the Control4 online driver database.

To use the SDDP capability, select the Discovered tab in the Control4 Composer Pro application. The Discovered tab displays all the discovered CasaTunes components available. There will be an entry for the CasaTunes AV Switch as well as an entry for each CasaTunes MSP Player.

Use Control4's SDDP discovery tool to automatically discover CasaTunes AV Switch and MSP Proxy drivers to add to your project

In Composer, select the room where you would like to install the CasaTunes AV switch and double click on the discovered CasaTunes AV Switch. It will automatically add the AV switch to the selected room. You can rename the switch if desired.

Now add each CasaTunes MSP Player (Type: Media Service) to the project.

Once you have added the CasaTunes AV switch and players, the Properties tab for each driver will be updated with the IP address of your CasaTunes music server, and the CasaTunes Status should now reflect the driver is successfully ​connected

The CasaTunes AV Switch driver requires a CasaTunes music server to function. Control of all CasaTunes and third party matrices (or audio distribution systems), as well as SDDP discovery,  is provided by the CasaTunes music server.

Connect the outputs of the AVSwitch to your rooms

  • In Composer, select ​Connections​ and select the CasaTunes AV Switch
  • Connect each configured Room in the Room Control section. Connect the ​AUDIO_SELECTION​ and ​AUDIO_VOLUME​ connections with theAudio EndPoint 1​ and ​Audio Volume 1​ for the room.
  • If you are feeding a pre­amplified output from CasaTunes to an AUDIO_IN connection on another device, then select the appropriate Audio Out x​ from the Audio/Video Outputs section and connect it to the input of the device.

Connecting the output of each player to the input on the AV Switch

In Composer, select ​System Design​ and select the player to configure. The Source ID​ property specifies the number of the ​Audio In​ connection on the AV Switch you should connect this player to.

Now switch to the ​Connections​ and for each Player connect the AUDIO_OUT for the player to the appropriate input on the AV Switch.

Configuring your CasaTunes music server as a Streamer

You can configure your CasaTunes music server as a streamer which allows it to work with other 3rd party AV switches that are supported by Control4.

To configure your CasaTunes music server as a streamer:

  • In the CasaTunesX App navigate to MENU > Settings > System Setup
  • Edit Music Server Mode
  • Select Streamer

CasaTunes AV Switch Advanced Settings

Connecting External Inputs to a CasaTunes CT (Software Matrix)

If you are using a CasaTunes Music Server and the Matrix Amplifier settings is configured as a CasaTunes CT matrix (where the matrix switching is performed internally in the music server), then you can connect other third party audio or music source components using External Inputs (if available).

First make sure you have configured these external input sources for your CasaTunes CT matrix using the CasaTunesX App, by navigating to MENU > SettingsSystem SetupSources, and configuring each External Input Source. Typically, you will configure the Source Type for these sources as an Unsupported Source.

Next, configure the external inputs for the AV Switch in Composer Pro.

For example, suppose you wanted to feed the audio output of your Control4 Home Controller into a CasaTunes CT matrix external input source. To configure this, follow these steps:

  • Physically connect the ​Audio Out​ output on your Control4 Home Controller to the External Input 1 connector on your CasaTunes music server
  • Using Composer Pro, connect ​Ext Input 1​ on your CasaTunes AV Switch to the ​AUDIO OUT​ on your home controller

Now when you select to listen to music in a room from your Control4 Home Controller in a CasaTunes room, it will automatically switch the room to the associated external input source.

Wireless Speakers and Room Groups

The CasaTunes AV Switch includes several ​Var Audio Out x​ and ​Var Room x connections to support playing to wireless speakers and CasaTunes room groups. These Variable Audio Out/Rooms require you configure the connection as well as the "Var Room x Name" Property in Composer Pro.

Example: Suppose you want to add a wireless speaker called ​WIRELESS1​ in the CasaTunesX App to the area called Pool in your Composer Pro Project. To configure this:

  • In Composer Pro, select the System Design view, then select the CasaTunes AV Switch
  • Switch to the Connections view
  • Connect ​Var Room 1​ to the pool room (area)
  • Switch back to the System Design view
  • Set the property ​Var Room 1 Name​ to ​WIRELESS1

Advanced Programming in Control4

You can program CasaTunes commands using the Macro and Scheduler Agents in Control4.

Scheduling Music

You can schedule Control4 to wake up to music, by scheduling to play a CasaTunes Featured Item, CasaTunes Playlist or a playlist from a specific Music Service.

In this example, we will create a ​Daily​ scheduler event that will play the ​Easy Listening​ CasaTunes playlist using ​Player1​ every morning in the ​Master Bedroom​ at 8:00 am.

We start by creating a Scheduler Event:

  • Select ​Agents​ in Composer Pro
  • Select the ​Scheduler​ Agent​
  • Click Scheduler ​Add...
  • Fill out the Scheduler form and name it ​Daily

Next, configure the Playlist to play on Player1:

  • Select ​Programming​ in Composer Pro
  • In the ​Device Events​ list select ​Scheduler
  • Select the ​Daily​ Schedule Event we just created
  • In the Actions Window, select the room where Player1 is configured and select ​Player1
  • In the Player1 Specific Actions, select ​Device Specific Commands
  • Select ​Select Playlist​ from the pull down
  • Click on the “​...​” button to browse the available Playlists to play
  • Navigate the list and select the ​Easy Listening​ Playlist to play
  • Double click or drag the Player1 Actions to the Script window

The final step is to select the room where you want to play the Playlist using Player1:

  • In the Actions Window, select the ​Master Bedroom​ and select ​Player1
  • Select the ​Select an audio device​ option
  • Select the room where Player1 is configured and select Player1​ from the pull down
  • Double click or drag the ​Master Bedroom​ Actions to the Script window
  • Test your script by clicking on the ​Execute​ button in the Script window

Running a CasaTunes Smart Task

A CasaTunes Smart Task is a task that contains one or more actions.  Actions include; playing music, controlling rooms, controlling music, playing chimes, converting text messages into playable audio, and adding a timed or scheduled delay.  Using these basic building blocks, one can construct some very sophisticated tasks.

The first step is to create your CasaTunes Smart Tasks using the CasaTunesX App. Note: You can only run unattended tasks (or tasks that do not require user input) from Control4.

For this example, let us assume you created a TTS (text-to-speech) notification task, called "Back Door Opened" that is run to notify you when the back door has been opened. Now let's create a Macro to invoke this task. You can then trigger to run this macro when you get a security event.

Let's start by creating a Macro:

  • Select ​Agents​ in Composer Pro
  • Select the ​Macro​ Agent​
  • Click Macro ​Add...
  • Create a new Macro called Back Door Opened Notification

Next, configure the Task to run:

  • Select ​Programming​ in Composer Pro
  • In the ​Device Events​ list select ​Macros
  • Select the Back Door Open Notification macro we just created
  • In the Actions Window, he room where Player1 is configured and select ​Player1
  • In the Player1 Specific Actions, select ​Device Specific Commands
  • Select Run Task from the drop down
  • Click on the “​...​” button to browse the available Smart Tasks to run
  • Select the ​Back Door Opened​ Smart Task you created using the CasaTunesX App
  • Double click or drag the Player1 Actions to the Script window

Now to execute the CasaTunes Smart Task just execute the associated Control4 macro.

You can select any CasaTunes MSP player to run a task. The CasaTunes Task specifies the actual player to use (if any).

Composer Pro Properties

The following properties are displayed in Composer Pro in the Properties tab for the CT_AVSwitch.c4i driver:

  • IP Address (Read Only) - IP Address of the CasaTunes music server
  • Port (Read Only) - TCP Port of the CasaTunes music server
  • CasaTunes Status (Read Only) - Specifies whether the driver is connected/disconnected to the CasaTunes music server
  • Version (Read Only) - Specifies the version and release date of the CasaTunes AV Switch Proxy driver (Major.Minor.YYMMDD)
  • Polling Interval - Specifies how frequently (in seconds) the driver polls the CasaTunes music server
  • Debug Mode - Specifies where to record/display the Debug information (None, Print, Log, Print and Log)
  • Debug Level - Specifies the type of information to log
  • Volume Ramp Delay in Milliseconds - Specifies how long to wait before ramping the volume up or down
  • Var Room1 .. 5 Name - Allows you to assign wireless speakers or Room Groups as variable rooms
  • Enable CasaTunes App Control - Specifies whether the AV Switch Driver responds to matrix commands external to Control4. We recommend this is enabled by default

The following properties are displayed in Composer in the Properties tab for the CT­MSP­PlayerXX.c4z drivers:

  • IP Address (Read Only) - IP Address of the CasaTunes music server
  • Port (Read Only) - TCP Port of the CasaTunes music server
  • CasaTunes Status (Read Only) - Specifies whether the driver is connected/disconnected to the CasaTunes music server
  • Version (Read Only) - Specifies the version and release date of the CasaTunes MSP Proxy driver (Major.Minor.YYMMDD)
  • Polling Interval - Specifies how frequently (in seconds) the driver polls the CasaTunes music server
  • Debug Mode - Specifies where to record/display the Debug information (None, Print, Log, Print and Log)
  • Source ID (Read Only) - Specifies the CasaTunes Source ID assigned to this MSP Proxy driver