feat: Refactor routing signal types and enhance web API for routing devices

- Renamed `UsbOutput` to `Usb` in `eRoutingSignalType.cs`.
- Removed unused `UsbInput` and `SecondaryAudio` signal types.
- Added new HTTP route for retrieving routing devices and tielines in `EssentialsWebApi.cs`.
- Implemented `GetRoutingDevicesAndTieLinesHandler` to handle requests for routing devices and tielines, including detailed port information.
- Updated `GenericSink` to remove `SecondaryAudio` from input port signal types.
- Created `ICurrentSourcesMessenger` to manage current source information and status updates.
- Introduced `IDeviceInfoProviderMessenger` for device information communication with debounce functionality.
- Updated `MobileControlSystemController` to use new messenger classes for current sources and device info.
- Added console commands for listing tielines and visualizing routes in `ControlSystem.cs`.
- Implemented methods for visualizing routes and current routes, including filtering options.

src/PepperDash.Essentials.Core/Routing/RouteDescriptorCollection.cs

@@ -11,6 +11,9 @@ namespace PepperDash.Essentials.Core;
 /// </summary>
 public class RouteDescriptorCollection
 {
+    /// <summary>
+    /// The static default collection of RouteDescriptors.  This is typically used for global routing management across the system, but additional collections could be used for specific purposes if desired.
+    /// </summary>
     public static RouteDescriptorCollection DefaultCollection
     {
         get
@@ -24,6 +27,12 @@ public class RouteDescriptorCollection
 
     private readonly List<RouteDescriptor> RouteDescriptors = new List<RouteDescriptor>();
 
+    /// <summary>
+    /// Gets an enumerable collection of all RouteDescriptors in this collection.
+    /// </summary>
+    public IEnumerable<RouteDescriptor> Descriptors => RouteDescriptors.AsReadOnly();
+
+
     /// <summary>
     /// Adds a RouteDescriptor to the list.  If an existing RouteDescriptor for the
     /// destination exists already, it will not be added - in order to preserve
@@ -37,13 +46,29 @@ public class RouteDescriptorCollection
             return;
         }
 
-        if (RouteDescriptors.Any(t => t.Destination == descriptor.Destination)
-            && RouteDescriptors.Any(t => t.Destination == descriptor.Destination && t.InputPort != null && descriptor.InputPort != null && t.InputPort.Key == descriptor.InputPort.Key))
+        // Check if a route already exists with the same source, destination, input port, AND signal type
+        var existingRoute = RouteDescriptors.FirstOrDefault(t =>
+            t.Source == descriptor.Source &&
+            t.Destination == descriptor.Destination &&
+            t.SignalType == descriptor.SignalType &&
+            ((t.InputPort == null && descriptor.InputPort == null) ||
+             (t.InputPort != null && descriptor.InputPort != null && t.InputPort.Key == descriptor.InputPort.Key)));
+
+        if (existingRoute != null)
         {
-            Debug.LogMessage(LogEventLevel.Debug, descriptor.Destination,
-                "Route to [{0}] already exists in global routes table", descriptor?.Source?.Key);
+            Debug.LogMessage(LogEventLevel.Information, descriptor.Destination,
+                "Route from {0} to {1}:{2} ({3}) already exists in this collection",
+                descriptor?.Source?.Key,
+                descriptor?.Destination?.Key,
+                descriptor?.InputPort?.Key ?? "auto",
+                descriptor?.SignalType);
             return;
         }
+        Debug.LogMessage(LogEventLevel.Verbose, "Adding route descriptor: {0} -> {1}:{2} ({3})",
+            descriptor?.Source?.Key,
+            descriptor?.Destination?.Key,
+            descriptor?.InputPort?.Key ?? "auto",
+            descriptor?.SignalType);
         RouteDescriptors.Add(descriptor);
     }
 
@@ -58,6 +83,12 @@ public class RouteDescriptorCollection
         return RouteDescriptors.FirstOrDefault(rd => rd.Destination == destination);
     }
 
+    /// <summary>
+    /// Gets the route descriptor for a specific destination and input port
+    /// </summary>
+    /// <param name="destination">The destination device</param>
+    /// <param name="inputPortKey">The input port key</param>
+    /// <returns>The matching RouteDescriptor or null if not found</returns>
     public RouteDescriptor GetRouteDescriptorForDestinationAndInputPort(IRoutingInputs destination, string inputPortKey)
     {
         Debug.LogMessage(LogEventLevel.Information, "Getting route descriptor for '{destination}':'{inputPortKey}'", destination?.Key ?? null, string.IsNullOrEmpty(inputPortKey) ? "auto" : inputPortKey);
@@ -68,11 +99,14 @@ public class RouteDescriptorCollection
     /// Returns the RouteDescriptor for a given destination AND removes it from collection.
     /// Returns null if no route with the provided destination exists.
     /// </summary>
+    /// <param name="destination">The destination device</param>
+    /// <param name="inputPortKey">The input port key (optional)</param>
+    /// <returns>The matching RouteDescriptor or null if not found</returns>
     public RouteDescriptor RemoveRouteDescriptor(IRoutingInputs destination, string inputPortKey = "")
     {
         Debug.LogMessage(LogEventLevel.Information, "Removing route descriptor for '{destination}':'{inputPortKey}'", destination.Key ?? null, string.IsNullOrEmpty(inputPortKey) ? "auto" : inputPortKey);
 
-        var descr = string.IsNullOrEmpty(inputPortKey) 
+        var descr = string.IsNullOrEmpty(inputPortKey)
             ? GetRouteDescriptorForDestination(destination)
             : GetRouteDescriptorForDestinationAndInputPort(destination, inputPortKey);
         if (descr != null)
@@ -82,67 +116,4 @@ public class RouteDescriptorCollection
 
         return descr;
     }
-}
-
-/*/// <summary>
-/// A collection of RouteDescriptors - typically the static DefaultCollection is used
-/// </summary>
-public class RouteDescriptorCollection<TInputSelector, TOutputSelector>
-	{
-		public static RouteDescriptorCollection<TInputSelector, TOutputSelector> DefaultCollection
-		{
-			get
-			{
-				if (_DefaultCollection == null)
-					_DefaultCollection = new RouteDescriptorCollection<TInputSelector, TOutputSelector>();
-				return _DefaultCollection;
-			}
-		}
-		private static RouteDescriptorCollection<TInputSelector, TOutputSelector> _DefaultCollection;
-
-		private readonly List<RouteDescriptor> RouteDescriptors = new List<RouteDescriptor>();
-
-		/// <summary>
-		/// Adds a RouteDescriptor to the list.  If an existing RouteDescriptor for the
-		/// destination exists already, it will not be added - in order to preserve
-		/// proper route releasing.
-		/// </summary>
-		/// <param name="descriptor"></param>
-  /// <summary>
-  /// AddRouteDescriptor method
-  /// </summary>
-		public void AddRouteDescriptor(RouteDescriptor descriptor)
-		{
-			if (RouteDescriptors.Any(t => t.Destination == descriptor.Destination))
-			{
-				Debug.LogMessage(LogEventLevel.Debug, descriptor.Destination, 
-					"Route to [{0}] already exists in global routes table", descriptor.Source.Key);
-				return;
-			}
-			RouteDescriptors.Add(descriptor);
-		}
-
-		/// <summary>
-		/// Gets the RouteDescriptor for a destination
-		/// </summary>
-		/// <returns>null if no RouteDescriptor for a destination exists</returns>
-  /// <summary>
-  /// GetRouteDescriptorForDestination method
-  /// </summary>
-		public RouteDescriptor GetRouteDescriptorForDestination(IRoutingInputs<TInputSelector> destination)
-		{
-			return RouteDescriptors.FirstOrDefault(rd => rd.Destination == destination);
-		}
-
-		/// <summary>
-		/// Returns the RouteDescriptor for a given destination AND removes it from collection.
-		/// Returns null if no route with the provided destination exists.
-		/// </summary>
-		public RouteDescriptor RemoveRouteDescriptor(IRoutingInputs<TInputSelector> destination)
-		{
-			var descr = GetRouteDescriptorForDestination(destination);
-			if (descr != null)
-				RouteDescriptors.Remove(descr);
-			return descr;
-		}
-	}*/
+}