Merge pull request #366 from PepperDash/feature/cisco-external-sources

Add External Source API to VideoCodec

PepperDashEssentials/Room/Types/EssentialsHuddleVtc1Room.cs

@@ -50,6 +50,19 @@ namespace PepperDash.Essentials
 
         //************************
 
+		public override string SourceListKey
+		{
+			get
+			{
+				return _SourceListKey;
+			}
+			set
+			{
+				_SourceListKey = value;
+				SetCodecExternalSources();
+				
+			}
+		}
 
         protected override Func<bool> OnFeedbackFunc
         {
@@ -206,6 +219,8 @@ namespace PepperDash.Essentials
 
                 VideoCodec = DeviceManager.GetDeviceForKey(PropertiesConfig.VideoCodecKey) as
                     PepperDash.Essentials.Devices.Common.VideoCodec.VideoCodecBase;
+				
+
                 if (VideoCodec == null)
                     throw new ArgumentNullException("codec cannot be null");
 				
@@ -298,6 +313,7 @@ namespace PepperDash.Essentials
 
 
                 VideoCodec.CallStatusChange += (o, a) => this.InCallFeedback.FireUpdate();
+				VideoCodec.IsReadyChange += (o, a) => this.SetCodecExternalSources(); 
 
                 if (AudioCodec != null)
                     AudioCodec.CallStatusChange += (o, a) => this.InCallFeedback.FireUpdate();
@@ -350,7 +366,6 @@ namespace PepperDash.Essentials
             return base.CustomActivate();
         }
 
-
         /// <summary>
         /// 
         /// </summary>
@@ -672,6 +687,42 @@ namespace PepperDash.Essentials
 				(room as EssentialsHuddleSpaceRoom).RunRouteAction("roomOff");
 		}
 
+
+		/// <summary>
+		/// Setup the external sources for the Cisco Touch 10 devices that support IHasExternalSourceSwitch
+		/// </summary>
+		private void SetCodecExternalSources()
+		{
+			var videoCodecWithExternalSwitching = VideoCodec as IHasExternalSourceSwitching;
+
+			if (videoCodecWithExternalSwitching == null)
+			{
+				return;
+			}
+			else
+			{
+				string codecTieLine = "";
+				codecTieLine = ConfigReader.ConfigObject.TieLines.SingleOrDefault(x => x.DestinationKey == VideoCodec.Key).DestinationPort;
+				videoCodecWithExternalSwitching.ClearExternalSources();
+				videoCodecWithExternalSwitching.RunRouteAction = RunRouteAction;
+				var srcList = ConfigReader.ConfigObject.SourceLists.SingleOrDefault(x => x.Key == SourceListKey).Value.OrderBy(kv => kv.Value.Order); ;
+
+				foreach (var kvp in srcList)
+				{
+					var srcConfig = kvp.Value;
+
+					if (kvp.Key != DefaultCodecRouteString && kvp.Key != "roomOff")
+					{
+
+						videoCodecWithExternalSwitching.AddExternalSource(codecTieLine, kvp.Key, srcConfig.PreferredName, PepperDash.Essentials.Devices.Common.VideoCodec.Cisco.eExternalSourceType.desktop);
+						videoCodecWithExternalSwitching.SetExternalSourceState(kvp.Key, PepperDash.Essentials.Devices.Common.VideoCodec.Cisco.eExternalSourceMode.Ready);
+
+
+					}
+				}
+			}
+		}
+		
         #region IPrivacy Members
 
 

PepperDashEssentials/UIDrivers/EssentialsHuddleVTC/EssentialsHuddleVtc1PanelAvFunctionsDriver.cs

@@ -1050,10 +1050,13 @@ namespace PepperDash.Essentials
 					
 			var inCall = CurrentRoom.InCallFeedback.BoolValue;
 			var config = ConfigReader.ConfigObject.SourceLists;
+			
+			
 			if (config.ContainsKey(_CurrentRoom.SourceListKey))
 			{
 				var srcList = config[_CurrentRoom.SourceListKey].OrderBy(kv => kv.Value.Order);
 				
+
 				// Setup sources list			
 				SourceStagingSrl.Clear();
 				uint i = 1; // counter for UI list
@@ -1076,6 +1079,8 @@ namespace PepperDash.Essentials
 						b => { if (!b) UiSelectSource(routeKey); });
 					SourceStagingSrl.AddItem(item); // add to the SRL
 					item.RegisterForSourceChange(_CurrentRoom);
+					Debug.Console(1, "**** KEY {0}", kvp.Key);
+					
 				}
 				SourceStagingSrl.Count = (ushort)(i - 1);
 			}

essentials-framework/Essentials Core/PepperDashEssentialsBase/Room/EssentialsRoomBase.cs

@@ -51,7 +51,19 @@ namespace PepperDash.Essentials.Core
         /// <summary>
         /// The config name of the source list
         /// </summary>
-        public string SourceListKey { get; set; }
+		/// 
+		protected string _SourceListKey;
+        public virtual string SourceListKey {
+			get
+			{
+				return _SourceListKey;
+			}
+			set
+			{
+				_SourceListKey = value; 
+
+			}
+		}
 
         /// <summary>
         /// Timer used for informing the UIs of a shutdown

essentials-framework/Essentials Devices Common/Essentials Devices Common/Codec/IHasExternalSourceSwitching.cs

@@ -0,0 +1,20 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using Crestron.SimplSharp;
+using PepperDash.Essentials.Core;
+using PepperDash.Essentials.Devices.Common.VideoCodec.Cisco;
+
+namespace PepperDash.Essentials.Devices.Common.Codec
+{
+	public interface IHasExternalSourceSwitching
+	{
+		bool ExternalSourceListEnabled { get; }
+		void AddExternalSource(string connectorId, string key, string name, eExternalSourceType type);
+		void SetExternalSourceState(string key, eExternalSourceMode mode);
+		void ClearExternalSources();
+		Action<string, string> RunRouteAction { set;}
+	}
+
+}

essentials-framework/Essentials Devices Common/Essentials Devices Common/Essentials Devices Common.csproj

@@ -112,6 +112,7 @@
     <Compile Include="Codec\eCodecCallStatus.cs" />
     <Compile Include="Codec\eMeetingPrivacy.cs" />
     <Compile Include="Codec\iCodecAudio.cs" />
+    <Compile Include="Codec\IHasExternalSourceSwitching.cs" />
     <Compile Include="ImageProcessors\TVOneCorio.cs" />
     <Compile Include="ImageProcessors\TVOneCorioPropertiesConfig.cs" />
     <Compile Include="Power Controllers\Digitallogger.cs" />

essentials-framework/Essentials Devices Common/Essentials Devices Common/VideoCodec/CiscoCodec/CiscoSparkCodec.cs

@@ -15,16 +15,17 @@ using PepperDash.Essentials.Core.Config;
 using PepperDash.Essentials.Core.Routing;
 using PepperDash.Essentials.Devices.Common.Cameras;
 using PepperDash.Essentials.Devices.Common.Codec;
-using PepperDash.Essentials.Core;
 using PepperDash.Essentials.Devices.Common.VideoCodec;
 
 namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
 {
     enum eCommandType { SessionStart, SessionEnd, Command, GetStatus, GetConfiguration };
+	public enum eExternalSourceType {camera, desktop, document_camera, mediaplayer, PC, whiteboard, other}
+	public enum eExternalSourceMode {Ready, NotReady, Hidden, Error} 
 
     public class CiscoSparkCodec : VideoCodecBase, IHasCallHistory, IHasCallFavorites, IHasDirectory,
         IHasScheduleAwareness, IOccupancyStatusProvider, IHasCodecLayouts, IHasCodecSelfView,
-        ICommunicationMonitor, IRouting, IHasCodecCameras, IHasCameraAutoMode, IHasCodecRoomPresets
+        ICommunicationMonitor, IRouting, IHasCodecCameras, IHasCameraAutoMode, IHasCodecRoomPresets, IHasExternalSourceSwitching
     {
         public event EventHandler<DirectoryEventArgs> DirectoryResultReturned;
 
@@ -348,6 +349,7 @@ namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
 
             CallHistory = new CodecCallHistory();
 
+			
             if (props.Favorites != null)
             {
                 CallFavorites = new CodecCallFavorites();
@@ -398,6 +400,11 @@ namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
             SetUpCameras();
 
 			CreateOsdSource();
+
+			if (props.ExternalSourceListEnabled != null)
+			{
+				ExternalSourceListEnabled = props.ExternalSourceListEnabled;
+			}
         }
 
         /// <summary>
@@ -472,7 +479,8 @@ namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
                 prefix + "/Bookings" + Delimiter +
                 prefix + "/Event/CallDisconnect" + Delimiter + 
                 prefix + "/Event/Bookings" + Delimiter +
-                prefix + "/Event/CameraPresetListUpdated" + Delimiter;
+                prefix + "/Event/CameraPresetListUpdated" + Delimiter +
+				prefix + "/Event/UserInterface/Presentation/ExternalSource/Selected/SourceIdentifier" + Delimiter;
 
             return base.CustomActivate();
         }
@@ -630,6 +638,7 @@ namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
                 }
             }
 			
+                
         }
 
         public void SendText(string command)
@@ -853,6 +862,18 @@ namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
 					{
 						GetBookings(null);
 					}
+					
+					else if (response.IndexOf("\"UserInterface\":{") > -1 || response.IndexOf("\"UserInterface\": {") > -1) // External Source Trigger
+					{
+						CiscoCodecEvents.RootObject eventReceived = new CiscoCodecEvents.RootObject();
+                        JsonConvert.PopulateObject(response, eventReceived);
+						Debug.Console(2, this, "*** Got an External Source Selection {0} {1}", eventReceived, eventReceived.Event.UserInterface, eventReceived.Event.UserInterface.Presentation.ExternalSource.Selected.SourceIdentifier.Value);
+
+						if (RunRouteAction != null)
+						{
+							RunRouteAction(eventReceived.Event.UserInterface.Presentation.ExternalSource.Selected.SourceIdentifier.Value, null);
+						}
+					}
                 }
                 else if (response.IndexOf("\"CommandResponse\":{") > -1 || response.IndexOf("\"CommandResponse\": {") > -1)
                 {
@@ -1802,9 +1823,76 @@ namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
             SendText(string.Format("xCommand Call FarEndControl RoomPreset Activate CallId: {0} PresetId: {1}", GetCallId(), preset));
         }
 
-    }
 
-    /// <summary>
+		#region IHasExternalSourceSwitching Members
+
+		/// <summary>
+		/// Weather the Cisco supports External Source Lists or not 
+		/// </summary>
+		public bool ExternalSourceListEnabled
+		{
+			get;
+			private set; 
+		}
+
+		/// <summary>
+		/// Adds an external source to the Cisco 
+		/// </summary>
+		/// <param name="connectorId"></param>
+		/// <param name="key"></param>
+		/// <param name="name"></param>
+		public void AddExternalSource(string connectorId, string key, string name, eExternalSourceType type)
+		{
+			int id = 2;
+			if (connectorId.ToLower() == "hdmiin3")
+			{
+				id = 3;
+			}
+			SendText(string.Format("xCommand UserInterface Presentation ExternalSource Add ConnectorId: {0} SourceIdentifier: \"{1}\" Name: \"{2}\" Type: {3}", id, key, name, type.ToString()));
+			// SendText(string.Format("xCommand UserInterface Presentation ExternalSource State Set SourceIdentifier: \"{0}\" State: Ready", key));
+			Debug.Console(2, this, "Adding ExternalSource {0} {1}", connectorId, name);
+
+		}
+
+
+		/// <summary>
+		/// Sets the state of the External Source 
+		/// </summary>
+		/// <param name="key"></param>
+		/// <param name="mode"></param>
+		public void SetExternalSourceState(string key, eExternalSourceMode mode)
+		{
+			SendText(string.Format("xCommand UserInterface Presentation ExternalSource State Set SourceIdentifier: \"{0}\" State: {1}", key, mode.ToString()));
+		}
+		/// <summary>
+		/// Clears all external sources on the codec
+		/// </summary>
+		public void ClearExternalSources()
+		{
+			SendText("xCommand UserInterface Presentation ExternalSource RemoveAll");
+			
+		}
+
+		/// <summary>
+		/// Action that will run when the External Source is selected. 
+		/// </summary>
+		public Action<string, string> RunRouteAction { private get;  set; }
+				
+
+
+
+
+
+		#endregion
+		#region ExternalDevices 
+
+
+		
+		#endregion
+	}
+
+
+	/// <summary>
     /// Represents a codec command that might need to have a friendly label applied for UI feedback purposes
     /// </summary>
     public class CodecCommandWithLabel

essentials-framework/Essentials Devices Common/Essentials Devices Common/VideoCodec/CiscoCodec/CiscoSparkCodecPropertiesConfig.cs

@@ -31,6 +31,9 @@ namespace PepperDash.Essentials.Devices.Common.Codec
         [JsonProperty("sharing")]
         public SharingProperties Sharing { get; set; }
 
+		[JsonProperty("externalSourceListEnabled")]
+		public bool ExternalSourceListEnabled { get; set; }
+
         /// <summary>
         /// Optionsal property to set the limit of any phonebook queries for directory or searching
         /// </summary>

essentials-framework/Essentials Devices Common/Essentials Devices Common/VideoCodec/CiscoCodec/xEvent.cs

@@ -127,10 +127,35 @@ namespace PepperDash.Essentials.Devices.Common.VideoCodec.Cisco
             public RequestedURI RequestedURI { get; set; }
             public PeopleCountAverage PeopleCountAverage { get; set; }
         }
-
+		public class UserInterface
+		{
+			public string id { get; set; }
+			public Presentation Presentation { get; set; }
+		}
+		public class Presentation
+		{
+			public string id { get; set; }
+			public ExternalSource ExternalSource { get; set; }
+		}
+		public class ExternalSource
+		{
+			public string id { get; set; }
+			public Selected Selected { get; set; }
+		}
+		public class Selected
+		{
+			public string id { get; set; }
+			public SourceIdentifier SourceIdentifier { get; set; }
+		}
+		public class SourceIdentifier
+		{
+			public string id { get; set; }
+			public string Value { get; set; }
+		}
         public class Event
         {
             public CallDisconnect CallDisconnect { get; set; }
+			public UserInterface UserInterface { get; set; }
         }
 
         public class RootObject