Control 4 Linn DS Driver

The Control4 drivers do not look for Linn DS/DSM players by their names but for capabilities. That is, searches for UPnP services of the Linn DS/DSM products and adjusts accordingly.

Kazoo Server can be downloaded from Linn.co.uk > Software & Apps

This allows new firmware features and new product support WITHOUT the need for any Control4 driver updates.

IMPORTANT NOTICE

If you are installing Linn Network, DS or Kustom drivers into a system that already contains versions of these drivers older than version 147 you must update all of these existing drivers to the latest version as the connections and internal communication protocols have changed. To do this:

- Download the latest online version of the drivers by going to the Search tab, unticking “Local”, finding the driver and then right-clicking and selecting “Download Driver”.

- Update each driver by right-clicking on an instance of it in your project hierarchy, selecting “Update Driver” and choosing the driver file you have downloaded.

If a simple update does not appear to have resulted in a working system, you may need to reinstall the drivers:

- Delete all instances of all Linn drivers in your project

- Re-install the drivers and their connections. The previous stages are necessary to ensure that you get the latest version of the driver when you do this install; just deleting and re-installing can end up with an older version that has been cached on the Director.

Linn DS/Control4 driver versions

Setting up the CI Gateway for Control4 use

<1--

A Crestron (driver V1.0.2 onwards) or Control (driver V171 onwards) system, requires a Gateway to interpret between control system and Linn DS control. In earlier versions of drivers, this was solely using Linn Kazoo Server with Gateway enabled.

But with update is Linn DS/DSM firmware - Davaar 100 or higher, and updated hardware, allows the Gateway interface to be embedded into these Linn products, removing the requirement of Linn Kazoo Server. Products with updated hardware are listed >HERE<

To enable the embedded CI Gateway

Go into Manage System and select a Linn DS/DSM with the embedded Gateway
Go into Advanced
And turn ON the "CI Gateway" option
If the CI Gateway was previously turned off, and you have turned it on, then you will need to reboot/power cycle your Linn DS/DSM to provide this service.

Note

On reboot, the "CI Gateway" service is available approx 3 minutes after a power cycle/reboot.
If the CI Gateway is not shown, then either the Linn DS/DSM does not have the hardware to support this option, or it does not have Davaar97 or higher version.

Products providing Gateway API - Davaar 100 onwards

▼ Gateway API

Klimax DSM /3 (2020 Variant)

Kustom DSM

Majik DSM /4 (2020 Variant)

Selekt DSM /0

Selekt DSM /0 Classic Hub

Selekt DSM /1 Classic Hub

Selekt DSM /1 Edition Hub

Series 3

Change streaming service account logins

On CI Gateway you will require to enter the Usernames and Password for the streaming services used.

To enter these Service Usernames etc, you need to know the IP address of the Linn DS/DSM and go into port 4100

That is: for Kustom DSM on IP address 192.168.1.49 then go into https://192.168.1.49:4100 into a web browser.

This will open the page on the right. You can now go into each section and either enter the Username and password for each Linn DS/DSM or global username and password for each service.

No CI Gateway then getting Kazoo Server Gateway enabled

If you do not have any of the products listed in the Products providing Gateway API in the system, then you will still require a PC/MAC or QNAP running.

For Crestron Linn-Lite, Crestron Linn DSM 4-Series driver or Control4 V171 and above then this requires Kazoo Server V4.11.27

To enable the CI Gateway, go to Kazoo Server setting and enable Gateway API

--->

Linn CI Gateway

The CI Gateway is a piece of software that is required for Linn’s Custom Installation options – Crestron and Control4

This software discovers ALL all devices on a local network and then offers an API to retrieve information and control functionality for any Linn DS/DSM device on the same network. There are two ways of running the CI Gateway:

1. It can be run on certain Linn DS/DSM devices by enabling it in the system configuration (see below for supporting products).

2. Alternatively, if no suitable device is available then Kazoo Server can be used running on a PC, Mac or QNAP device. The CI Gateway is bundled alongside this media server software, and it simply needs to be installed on a suitable device on the local network. This is enabled through the Kazoo Server’s options.

Only ONE instance of the CI Gateway is required (i.e. no need to enable it on multiple devices). This single instance will allow control of ALL Linn DS products in the system. That is, this single instance will allow control of both older Linn DS products that cannot run CI-Gateway, and new Linn products that can run CI-Gateway.

Enabling the CI Gateway on a Linn DSM device.

The CI Gateway is available on any of the following Linn products:

▼ Gateway API

Klimax DSM /3 (2020 Variant)

Kustom DSM

Majik DSM /4 (2020 Variant)

Selekt DSM /0

Selekt DSM /0 Classic Hub

Selekt DSM /1 Classic Hub

Selekt DSM /1 Edition Hub

Series 3

To enable it:

1. Go to the ⁣Manage Systems page and login with your Linn Account.

2. Go into the options for one of your devices that is capable of running the CI Gateway.

3. Go into the Advanced tab and turn on the CI Gateway option. If your device is one of the above products and this option is not visible, then it could have outdated firmware – ensure it is updated and try again.

4. If the device is on, then you will be prompted to reboot the device. Once fully rebooted, the CI Gateway will then be enabled.

Accessing the CI Gateway Configuration

You can check that the CI Gateway is operating by accessing the configuration options page for it. For a CI Gateway running on a Linn DS/DSM device, it can be accessed through a web browser. You need to know the IP address of the device, and then it can be accessed through an HTTPS request on port 4100.

For example: https://192.168.1.49:4100

Note: if you know the MAC address of the Linn DSM running the CI-Gateway you can use its Device name derived from the IP address instead. For Linn DS with Mac address 00:26:0f:22:43:f7, take the last 6 characters and fit into avahi-linn-xxxxxx.linn.co.uk. To get into the CI-Gateway now, use https://avahi-linn-2243f7.linn.co.uk:4100

This will open the page below where options and configuration for the CI Gateway are located.

Centre

For a CI Gateway running on Kazoo Server, find the options page for Kazoo Server (for Windows, right-click on the icon in the system tray and click Configure Kazoo Server). You will then find an option for Gateway API. Clicking this option will give you the same configuration page.

Logging into streaming service accounts

It is possible to access third-party streaming services through the CI Gateway. You will see several of these on the configuration page. Some service such as TIDAL and Qobuz require logins for individual devices, but you can log in for all using the options at the top. Ensure these are configured before using any custom installation support.

Note: There is no need to log into Airable radio. Any Linn DS/DSM that is associated with a linn account has access to this server. If you are having difficulties, ensure that every DS/DSM is associated with a Linn account.

Accessing the CI Gateway Documentation (Advanced)

The CI Gateway is open to use by anyone! If you would like to write your own software that features control over Linn DS/DSM devices, then you are free to do so. There is documentation (under API Documentation in gateway options) that provides information about the API endpoints and allows you to try out its functionality. To use it in your own program, simply set up a WebSockets connection with port 8088 for CI Gateway running on a Linn DSM (or port 4100 for Kazoo Server) and send JSON messages across the connection using the format demonstrated in the documentation.

The first set of tabs (Session->Queue) are legacy endpoints that remain for older Custom Installation support. The session endpoints are the exception; these are shared between all support (the first step to using the CI Gateway is creating a session). Reworked API endpoints have been created more recently under the API V2 tabs of the documentation UI. These beta API endpoints allow for simplified and more intuitive communication, but may be subject to small changes.

Troubleshooting:

I cannot get any of the Linn DS/Streamer services to appear in Navigator

* The Service will only appear if you have the Linn DS connected to an Audio End-Point.

If you are using this with a Matrix Switch then the Linn DS MUST be connected to Audio End-Point 2

* After installing the updated drivers, you will need to unbind and then rebind all the audio and video RoomControl connections to get the Streaming service to appear.

Sometimes my Control4 system operation slows down for a few minutes then works OK

This will be due to Control4 processor checking that all expected LInn DS players are alive. If one or more have been powered down or disconnected from the Network the Control4 will periodically interrogate the network for this/these missing Linn DS products.

In Tidal, I press the "Genres" button and Tidal stops working.

You are using an older verison of CI Gateway/Kazoo Server.

CI Gateway: Make sure you are using a Linn DS/DSM with Davaar100+ firmware

Or if you are using Kazoo Server check you are using V4.11.27+

I cannot control airable and/or Tidal on the Control4 touchpanel

Suspect that you are using Control4 driver V171, you are using an older verison of CI Gateway/Kazoo Server that is not compatible with V171.

CI Gateway: Make sure you are using a Linn DS/DSM with Davaar100+ firmware

Or if you are using Kazoo Server check you are using V4.11.27+

Variable Summary
	Linn Network
	The driver has the following read-only variables in addition to the standard variables defined by Control4:
	Variable	Purpose
	CONNECT_STATE	Indicates the state of the connection from the driver to the Kazoo server gateway:
		0	Not connected.
		1	Connecting.
		2	Connected.
		32767	Fully initialised and operational.

Linn DS Series
The driver has the following read-only variables in addition to the standard variables defined by Control4:
Variable	Purpose
INPUT_NUMBER	Indicates which input is currently supplying audio to the room output:
	-2	Songcast from a remote streamer.
	-1	The local streamer.(Playlist/Radio)
	0	Nothing
	1..32	External input 1..32; see Properties to determine which input number corresponds to which input device.
	Note that it is not guaranteed that the input number is 0 when the room is off, so programming should not rely on this nor on receiving a change in this value when the room switches on.

SOURCE_NAME	The name of the currently playing source. Names are as defined on the DS using Konfig.
PAUSED	true if playback is paused, else false.
PLAYING	true if playback active, else false.
STOPPED	true if playback stopped, else false.
PLAY_STATUS	One of the following values:

		PLAYBACK_STATE_IDLE	Playback has stopped.
		PLAYBACK_STATE_PAUSED	Playback is paused.
		PLAYBACK_STATE_PLAYING	Playback is active.

Kustom DSM
The driver has the following read-only variables in addition to the standard variables defined by Control4:
Variable	Purpose
ZONE_N_INPUT_NUMBER	Indicates which input is currently supplying audio to zone N:
	-2	Songcast from a remote streamer.
	-1	The local streamer.(Playlist/Radio)
	0	Nothing
	1..4	External input 1..4; see Properties to determine which input number corresponds to which input device.
	Note that it is not guaranteed that the input number is 0 when the room is off, so programming should not rely on this nor on receiving a change in this value when the room switches on.

ZONE_N_SOURCE_NAME	The name of the currently playing source in zone N. Names are as defined on the Kustom using Konfig.
STREAMER_N_PAUSED	true if playback on streamer N is paused, else false.
STREAMER_N_PLAYING	true if playback on streamer N active, else false.
STREAMER_N_STOPPED	true if playback on streamer N stopped, else false.
STREAMER_N_PLAY_STATUS	A string value giving playback state on streamer N:

		PLAYBACK_STATE_IDLE	Playback has stopped.
		PLAYBACK_STATE_PAUSED	Playback is paused.
		PLAYBACK_STATE_PLAYING	Playback is active.

Template:FAQ:Control4 Driver

Control 4 Linn DS Driver

Linn DS/Control4 driver versions

Linn DS Series V171 25th March 2023 (for C4 OS 3.20 onwards)

Linn DS Series V168 5th Oct 2022 (for C4 OS 3.20 onwards)

Linn DS Series V167 Beta 23rd Dec 2021 (for C4 OS 3.20 onwards)

Linn DS Series V166 Certified & released 14th Oct 2021 (for C4 OS 3.20 onwards)

Linn DS Series V161 Certified & released 29th January 2021 (for C4 OS 3.20 onwards)

Linn DS Series V160 Certified, January 2021 (for C4 OS 3.20 onwards)

Linn DS Series V157 Certified November 2020 (for C4 OS 3.20 onwards)

Linn DS Series V156 October 2020 (for C4 OS 3.20 onwards)

Linn DS Series V154 Certification June 2020

Linn DS Series V146 December 2019

Linn DS Series V129 Certified February 2019