CasaTunes KNX Integration

Overview

All CasaTunes music servers include built-in support for KNX.  

CasaTunes’ multi-room audio support for KNX is implemented as a virtual device via the KNX driver for CasaTunes (driver) running as a daemon process on the CasaTunes music server and is automatically started when enabled.

The driver accesses the KNX bus via a KNX IP Interface, and uses KNXNet/IP Tunnelling to send and receive TP messages.

The CasaTunes driver listens for control requests sent to specific KNX Group Addresses, and sends state information when requested or when the state information has changed.

INSTALLATION NOTICE: It is recommended you install all your other hardware before installing the keypads.

SAFETY NOTICES

CasaTunes hardware is designed for professional installation only. Follow all NEC (National Electrical Code)/national wiring rules, as well as local codes. The Cat5 cables connecting between the USB6 Keypad Hub and the Keypads should not be routed outside the home (to prevent risk of lightning damage and shock) and are not meant to be connected to any other equipment, such as Ethernet switches.

The Keypads and the USB6 Keypad Hub are low-voltage devices. If you mount them in an electrical box, for safety’s sake do not bring any high voltage wiring into the same box.

Please leave the keypads and the USB6 Keypad Hub in their protective bags until you are ready to install them in the electrical box. When handling these devices, try to keep yourself grounded as much as possible to minimize the possibility of damage due to electrostatic discharge.

Please note there is a power inlet covered by a vinyl sheet, just below the USB connector on the USB6 Keypad Hub. It is not used in our current products. If it is used in the future, we will be supplying a DC power supply. The following safety notices are required by UL regarding this connector and any future CasaTunes supplied power supply.

The DC inlet on the USB6 Keypad Hub (just below the USB connector on the front of the wall plate) must only be used with an optional CasaTunes 5VDC power supply with positive center conductor.

Keypads are not designed for outdoor use.

Prerequisites

• CasaTunes v5.00.240423 or later
• A KNX IP Interface - The KNX driver for CasaTunes requires a KNX IP Interface. The driver automatically discovers all KNX IP interfaces available.  By default, CasaTunes will use the first KNX IP Interface it discovers. If you have more than one KNX IP Interface, you can configure which KNX IP interface to use.
• ETS5 or later - Used to program and configuring your KNX network

Group Address Organization

To support the large number of rooms that the KNX Driver for CasaTunes supports, CasaTunes implements a Group Addressing scheme that utilizes the Main and Middle Groups of a 3-level style Group Addressing scheme to uniquely identify each room (or zone).

The KNX Driver for CasaTunes supports up to 64 rooms (or zones). These can include CasaTunes, AirPlay or SONOS rooms and/or Room Groups.  

The Main and Middle Group Addresses are used to specify the zone.  Each Main Group address can be assigned up to 8 zones. The Sub Group Addresses (0..255) specifies the CasaTunes control or status function.

When the keypad is off, if the keypad does not display the time of day, then the keypad is not setup correctly. Check the keypad is plugged into the USB6 Keypad Hub, and verify the USB6 Keypad Hub is connected to your music server. Next, unplug the keypad and plug it back in to the Hub, and if that does not work, try unplugging and plugging back in the USB6 Keypad Hub. If you still do not see the time of day, please contact CasaTunes Support.

CasaTunes Functions

The Subgroup of the 3-level style Group Addressing scheme is used to select a CasaTunes Function.

The following CasaTunes Functions are available:

You can finely tune and configure the control and status functions to include in your KNX project via the KNX Filtering setup option below

Control Functions

Status Functions

KNX Setup using CasaTunesX

You use the CasaTunesX App to set up and configure the KNX Driver for CasaTunes (driver).  The CasaTunesX App is available on Amazon Fire tablets, Android and iOS phone and tablet devices, as well as any device that runs an HTML5 browser.

The CasaTunesX App for Amazon, Apple and Google can be downloaded from their respective stores.  To access the browser version of the CasaTunesX App, simply enter the following URL in an HTML5 browser:

http://casaserver/casatunesx

Once the CasaTunesX App is open, you can access the KNX Settings, by navigating to MENU > Settings > KNX.

Step 1: Enable KNX

The first step when configuring the KNX driver is to enable the driver.  Simply enable the driver by turning on the Enable KNX switch.  The KNX Driver Version is also displayed.  Make sure the version is greater than or equal to 24.03.28.  This is version 2 of the KNX driver and is strongly recommended.

Step 2: Enable CasaTunes Driver for KNX V1.0 Compatibility

The CasaTunes Driver for KNX has been updated to Version 2. If you previously integrated CasaTunes with KNX using the original version of the driver, you must enable the Version 1.0 Compatibility option to ensure these existing projects will continue to function properly.

If you are integrating CasaTunes into a new KNX project, or you are migrating an original integration to the new version of the CasaTunes Driver for KNX, then disable this option.

Step 3: Select the KNX IP Interface

Select the Preferred KNX IP Interface to select the KNX IP Interface to use.

Step 4: Configure the KNX Group Address for your zones

In the App you can configure the starting offset for the Main Group Address value. For example, if you configured a starting offset of 5/X/X for the Main Group Address (as shown in the figure below), then the Group Address for the first assigned zone would be 5/0/X, the second would be 5/1/X and so forth.  When adding a ninth zone, the Main Group Address is incremented, so the Group Address for the zone would be 6/0/X.  As mentioned, you can configure up to 64 zones.

Step 5: Configuring your KNX Zones

After configuring the Main Group Address offset, the next step is to assign the CasaTunes zones to be controlled via KNX. Select Zones in KNX Settings.

Rather than assume you want to control every zone via KNX (which could result in a more complex setup and potentially unnecessary KNX bus activity), you must add each zone you wish to control via KNX.

If you want to configure all your zones, simply keep selecting the Add KNX Zone button in the App and it will automatically add the next CasaTunes zone to the next available Group Address.

For each KNX zone, you can configure the following properties:

• The CasaTunes room, AirPlay or SONOS room, or room group to assign to this group address.
• The increment to use for volume up/down for this specific zone (defaults to 1)
• The Panel type (defaults to Generic). Although CasaTunes provides functions that support a variety of DPT types which allows it to support the majority of KNX panels without any custom code, there are some panels, for example the HDL Granite Display, that require special code to display strings in Unicode format and to combine all 3 meta data lines.

To remove a zone, select the delete button (trash can).

Step 6: Playing Music from KNX

The CasaTunes driver allows you to play Featured Items and/or Playlists from KNX.  Featured Items are similar to favorites and can be used to select albums, playlists and stations.

To play a Featured Item or Playlist you need to specify the index of the featured item or playlist.  You can enable Auto Discover and let CasaTunes add all your playable featured items and playlists, or you can disable Auto Discover and manually select the playable list of featured items and playlists.

We strongly recommend you manually add your playable items, because when using Auto Discover the indices of the featured items or playlists may change each time you add or delete a Featured Item or Playlist.

Select Add KNX Featured Item or Playlist to add a new playable item.  Select the delete button (trash can) to remove an item.  To select a different featured item or playlist, press the navigate into (>) button.

The number in the blue box next to each item represents the index of the playable item.  When configuring the KNX control function to play a playlist, enter the index as the value for the DPT 5.010 data type (counter pulse).

Step 7: Playing Chimes

CasaTunes supports playing custom audio files or chimes in one or more rooms.  When playing a chime in a room, the current music that is playing in a room is temporarily paused, the chime is played and when finished, the room returns to playing the music that was temporarily paused.

You can add your own custom chime files to CasaTunes, so with a control system like KNX, you can play your own custom audio in response to various events, for example, when a door is opened, a doorbell is pressed, etc.

Select Add KNX Chime to add a new chime.  Select the delete button (trash can) to remove a chime.  To select a different chime, press the navigate into (>) button.

The number in the blue box next to each item represents the index of the chime item.  When configuring the KNX control function to play a chime, enter the index as the value for the DPT 5.010 data type (counter pulse).

Step 8: Configuring CasaTunes Smart Tasks

Smart Tasks allows you to simplify and automate your music listening experience.  A Smart Task is a task which can consist of one or more actions.  These actions include playing music, controlling rooms, controlling your music, playing a chime, converting and playing Text-To-Speech, and adding a wait delay or a scheduled delay.

You can add one or more non-interactive Tasks to be run by KNX.

Select Add KNX Task to add a new task.  Select the delete button (trash can) to remove a task.  To select a different task, press the navigate into (>) button.

The number in the blue box next to each item represents the index of the task item.  When configuring the KNX control function to run a task, enter the index as the value for the DPT 5.010 data type (counter pulse).

Step 9: Filtering and Exporting

Using the CasaTunesX App you can select to filter the list of KNX Addresses.  Filtering the list of KNX Addresses has two major advantages.  

First, by filtering the status functions you can significantly reduce the KNX Bus Traffic because CasaTunes will only update the status for items that are not filtered.

Secondly, only the Group Addresses associated with the non-filtered control and status functions are exported to the CSV file.  This reduces the complexity of configuring the CasaTunes functionality for your KNX panels and other devices.

Once you have completed your KNX configuration, you can export your CasaTunes KNX Group Address information to a CSV file.  This file will contain all the Group Addresses for all your configured zones and for each zone all the Group Addresses for all the non-filtered CasaTunes control and status functions.

CasaTunes saves the exported CasaTunes group addresses in a CSV file in a special folder on your CasaTunes music server.  To access this folder from a Windows machine:

• In File Explorer select Network
• Navigate into CasaServer
• Navigate into CasaData
• Navigate into KNX
• If prompted for a username/password, enter CasaUser as the username (and no password)
• Import the CSV file “Exported CasaTunes Group Addresses.csv” in ETS 5 or later

To configure your KNX panels and devices, import the CSV file in ETS 5 or later, and link the CasaTunes Group Addresses to your panels and devices.

KNX Panel Setup

The CasaTunes Driver for KNX simplifies integration with popular KNX panels that include specific Audio or Media functions. Since there are no KNX standards for audio interfaces, selecting a CasaTunes supported KNX panel for a zone, automatically configures the driver to support the DataPoint Types (and other idiosyncrasies) used by the specific KNX panel for the various panel/device group objects.

For more detailed instructions on how to configure each panel type for use with CasaTunes, please select the panel type from the list below:

Questions, Suggestions or other Feedback

If you have any questions, suggestions or other feedback please contact support@casatunes.com