Difference between revisions of "Crestron:Phase2 driver"

From LinnDocs
Jump to: navigation, search
m (Phase2 - V2.0.8 - 2023 July 3rd)
m (Capabilities)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
=Phase2 - V2.0.8 -  3rd July 2023=
 
=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.   
+
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   
 
Both support options have shared basic functionality   
Line 7: Line 7:
  
 
:*Supports the Davaar firmware release, (currently release 4.101.504 - 27th June 2023), has added support for the <b>‘CI Gateway’</b> component,  
 
:*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| <B><U>HERE</U></B>]]  
+
::Gateway API, to the products can be found [[#Products providing Gateway API - Davaar 100 onwards| <B><U>HERE</U></B>]]  
 
:*Series4 Processor support
 
:*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
+
:*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.
 
:* 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)
 
::*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)
Line 17: Line 17:
 
::* Room selection - each Crestron Control Point has an actively selected room within the house that can be changed via the Crestron Control Point itself.
 
::* 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.  
 
::* 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;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
 
:::&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:
+
::* 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;Standby control - each room can be  toggled between standby states
 
:::&rarr;Volume control - step up/down, set absolute, mute toggle
 
:::&rarr;Volume control - step up/down, set absolute, mute toggle
Line 25: Line 25:
 
:::&rarr;Transport control over any active playlist - play, pause, play/pause toggle, skip previous, skip next
 
:::&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;Source selection - capable of selecting any visible external source and Spotify connect
:::&rarr; Metadata - retrieves basic metadata for currently playing item including artwork
+
:::&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.  
+
:::&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; airable radio station menu selection
:::&rarr; TIdal menu selection
+
:::&rarr; Tidal menu selection
:::&rarr; Qobus menu selection
+
:::&rarr; Qobuz menu selection
::*Works in collaboration with other non-Crestron control points such as Linn Kazoo or LinnApp and any changes will be updated and shown.  
+
::*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.  
 
::*Capable of running direct macro commands to devices for control of volume, source, etc.  
  
Line 46: Line 46:
  
 
==Example Touchpanel==
 
==Example Touchpanel==
[[File:CrestronV2-0-8_Home.png|500px|centre]]
+
[[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.  
+
: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.  
 
:Optional modules can be added as needed to allow for browsing of 3rd party services through the Crestron system itself.  
 
:Currently available:
 
:Currently available:

Latest revision as of 07:59, 22 February 2024

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 ‘CI Gateway’ component,
Gateway API, to the products can be found HERE
  • 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.
→This will be reflected in the room selection menu and automatically updated whenever a change in grouping occurs.
→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:
→Standby control - each room can be toggled between standby states
→Volume control - step up/down, set absolute, mute toggle
→Toggle shuffle and repeat states for appropriate sources
→Transport control over any active playlist - play, pause, play/pause toggle, skip previous, skip next
→Source selection - capable of selecting any visible external source and Spotify connect
→ Metadata - retrieves basic metadata for currently playing item, including artwork
→ 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.
→ airable radio station menu selection
→ Tidal menu selection
→ 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:



Requirements

• Gateway API Server
Kazoo Server 4.11.29+ OR
○ Linn DS/DSM with Davaar 4.101.504+ and CI gateway 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 "CI Gateway" option.
Linn DS/DSMs with CI Gateway embedded in their Davaar Firmware

Example Touchpanel

CrestronV2-0-8 Home.png
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

Crestron Install v14 Video.png

Download

Crestron Linn DSM 4-Series Driver

Crestron Linn DSM Setup guide document

Download.pngCrestron V2.0.8 Setup guide document

Driver V2.0.8 3rd July 2023

Download.png V2.0.8 3rd July 2023

THIS IS A PREVIEW RELEASE THAT REQUIRES DS FIRMWARE DAVAAR 99 OR LATER

Setting up the CI Gateway for Crestron use

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
  1. Go into Manage System and select a Linn DS/DSM with the embedded Gateway
  2. Go into Advanced
  3. And turn ON the "CI Gateway" option
  4. 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.
MS CI Gateway.png
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


Change streaming service account logins

Gateway Embedded Settings.png
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
Kazoo Server Gateway.png