Template:Control4:V174

Linn DS Series V172 9th January 2024 (for C4 OS 3.20 onwards)

• It can be downloaded from

• GITHUB if you have given permission as a Collaborator
• Linn Docs NOTES section or downloaded from >HERE< until available in Composer Pro
  
• Linn Resources and DS products(Retailer only website, listed under any Linn DS/DSM product)

• OS 3.20 onwards compatible
• This is compatible with Kustom DSM
• Requires Linn DS firmware Davaar 100 or higher

Added:

> Documentation updates

> Self selection of streaming services to be used

Requirements

• Gateway API Server

○ Kazoo Server 4.11.27+

or

○ Linn DS with Davaar 4.100+ with CI Gateway enabled. For more information then click HERE

Note

Using the CI Gateway disables the Create/Recall Playlist option.

Variable summary (also listed in each Module Documentation section)

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.

• If you wish to update your Control4 from an earlier "Linn DS Series" driver, then we would recommend a fresh Project is created with V171
• Or if you already have the "Linn DS Network (32 Players) + Pins" or "Linn DS Network (32 Players)":

IMPORTANT NOTICE

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

To do this:

- Remove any instances of the Linn DS Network or Linn DS Network + Pins driver in the system (these are replaced by the new Linn Songcast Network driver).

- For off-line drivers, that you have downloaded from above:

- In the top menu select Driver > Add or Update Driver or Agent

* Add each of the .c4z files one at a time

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

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

- Update each driver either by using the Driver->Manage Drivers and Agents dialog, or by right-clicking on an instance of it in your project hierarchy, selecting “Update Driver” and choosing the driver file you have downloaded.

NOTE: It is important for the smooth installation of media player drivers that the network driver is added prior to the player drivers. The configuration of the player drivers cannot be completed without the network driver being in place and communicating correctly with a Linn CI-Gateway.

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.

- From the "Connect to Project" dialog that Composer shows when selecting a local system, right-click on your controller and select Terminal.

- Type the following commands at the terminal prompt (shown in grey):

~# cd /mnt/internal/c4z

/mnt/internal/c4z# rm -r comms_ip_linn*

/mnt/internal/c4z# rm -r mediaservice_ip_linn*

/mnt/internal/c4z# reboot

The terminal window will lose connection after the reboot and you can close it.

- Close all open instances of Composer.

- Re-open Composer and 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.

---RECOMMEND USING KAZOO SERVER V4.11.27 or system that do not have Products providing Gateway API ---

--Or

---CI GATEWAY on newer products. For more information then click HERE