View source for Crestron:Phase2 driver

=Phase2 - V2.0.8 -  3rd July 2023=
:
There is a choice of support currently available for integrating Linn devices in a Crestron system, depending on the customer requirements and Crestron hardware available. These drivers allow for control over Linn devices by communicating with the Linn Gateway API software. This software is available embedded in Kazoo Server or through a Linn DS device with the gateway enabled through its system configuration.  

Both support options have shared basic functionality  
==Capabilities==

:*Supports the Davaar firmware release, (currently release 4.101.504 - 27th June 2023), has added support for the <b>‘CI Gateway’</b> component, 
::Gateway API, to the products can be found [[#Products providing Gateway API - Davaar 100 onwards| <B><U>HERE</U></B>]] 
:*Series4 Processor support
:*This works with other non-Crestron control points. That is, any changes by other control devices are shown in the Crestron panels
:* 20 rooms maximum by default, although this can be modified to allow for more.
::*Tested with control up to 50 DS/rooms/Streamer/Zones and with 8 Crestron control points setup (One Kustom DSM is classed as up to 12 DS with up to 8 Room + up to 4 Streamers)

==Features:==
::* Automatic discovery of a Gateway API instance within the local network and setup of a WebSockets connection.
::* Room selection - each Crestron Control Point has an actively selected room within the house that can be changed via the Crestron Control Point itself.
::* Grouping - Uses the current grouping of rooms set via Kazoo/LinnApp. 
:::&rarr;This will be reflected in the room selection menu and automatically updated whenever a change in grouping occurs. 
:::&rarr;The standby states and volumes of listening rooms can be set individually
::* For each room in the house, the user has control over the following DS functionalities:
:::&rarr;Standby control - each room can be  toggled between standby states
:::&rarr;Volume control - step up/down, set absolute, mute toggle
:::&rarr;Toggle shuffle and repeat states for appropriate sources
:::&rarr;Transport control over any active playlist - play, pause, play/pause toggle, skip previous, skip next
:::&rarr;Source selection - capable of selecting any visible external source and Spotify connect
:::&rarr; Metadata - retrieves basic metadata for currently playing item, including artwork
:::&rarr; PIN selection - as on the current physical Linn DS units, 6 customizable pins can be set up using a Linn control point (Kazoo/LinnApp) to provide easy access to a favourite radio station, playlist, or external source. The name and artwork for each pin can also be accessed via the module and displayed on a Crestron interface. 
:::&rarr; airable radio station menu selection
:::&rarr; Tidal menu selection
:::&rarr; Qobuz menu selection
::*Works together with other non-Crestron control points such as Linn Kazoo or LinnApp and any changes will be updated and shown. 
::*Capable of running direct macro commands to devices for control of volume, source, etc. 

:Both support options are designed for use in SIMPL Windows projects (not for use with Crestron Home). The two options for Crestron support with Linn devices are given below: 
<br><br>

==Requirements==
::• Gateway API Server
:::&#x25CB; [https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.11.29_win.exe Kazoo Server 4.11.29+] <font style="color:red"><b>OR</b></font>
:::&#x25CB; Linn DS/DSM with Davaar 4.101.504+ and <big><b>CI gateway</b></big> enabled.
;Note: You ONLY require one Linn DS/DSM to have the CI Gateway to be enabled in the system. This will allow Crestron to control EVERY Linn DS/DSM in the system, even one that do NOT have the "<b>CI Gateway</b>" option.
{{Hidden Slim Text Box Header|IndexText= <Big>Linn DS/DSMs with CI Gateway embedded in their Davaar Firmware</BIG>}}
{{block indent|<categorytree mode="pages" namespaces="Main Category" hideroot=on>CORE4</categorytree>  }}
{{Hidden text end}}

==Example Touchpanel==
[[File:CrestronV2-0-8_Home.png|500px|centre|link=]]
 
:New with ongoing development, only compatible with 4-series processors. If using a 4-series processor, this is the recommended option. Allows for control of basic functionality for many Linn DS devices. 
:Optional modules can be added as needed to allow for browsing of 3rd party services through the Crestron system itself. 
:Currently available:
::* Airable radio (introduced in V1.0.14),
::* TIDAL (introduced in V2.0.8),
::* Qobuz (introduced in V2.0.8), 
::* Songcast is coming in the near future.

==Crestron Linn 4-Series Driver video Demonstration==
{{border| {{Video:Crestron_LinnV2.0.8}}|width=2px| style2=padding:3px |color=#696969}}
<!--
==Products providing Gateway API==
{{block indent|<categorytree mode="all" >Gateway API</categorytree>  }}--->

==Download==
{{:Crestron:Linn_DSM_4-Series_driver_download-V2.0.8}}

==Setting up the CI Gateway for Crestron use==
{{Setup:CI-Gateway_Configuration}}