View source for Crestron:Phase1 driver

=Phase1 - V1.0.14 - 2023 March 30th=
:
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.99.491 - 30th March 2023), has added support for the <b>‘CI Gateway’</b> component, 
::Gateway API, to the products can be found [[#Products_providing_Gateway_API| <B><U>HERE</U></B>]] 
:*Series4 Processor support
:*This works with other non-Crestron control points. That is, and 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 update 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 setup 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. 
::*Works in collaboration 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.27_win.exe Kazoo Server 4.11.27+] <font style="color:red"><b>OR</b></font>
:::&#x25CB; Linn DS/DSM with Davaar 4.99.491+ 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.

==Example Touchpanel==
[[File:CrestronV14 Now Playin.png|500px|centre]]
 
: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 and Qobuz coming soon…)

==Crestron Linn 4-Series Driver video Demonstration==
{{border| {{Video:Crestron_LinnV1.0.14}}|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-V1.0.14}}

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