Crestron:Phase2 driver

From LinnDocs
Jump to: navigation, search

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