Mirror a radio from another computer's broadcast data

Listen for Radio broadcast data from another Nonemm or N1MM computer and
record its frequency, mode and split as this computer's own radio. No
radio is controlled. The settings are in the Configure Radios dialog.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

src/Nonemm.App/AppSession.MirrorRadio.cs

@@ -0,0 +1,80 @@
+using System.Net.Sockets;
+using Avalonia.Threading;
+using Nonemm.Core;
+using Nonemm.Network;
+using Nonemm.Session;
+
+namespace Nonemm.App;
+
+/// Records the frequency, mode and split of a radio that another computer
+/// broadcasts as this station's own, for a station whose radio port is taken.
+/// Only the log's idea of the radio changes; no radio is commanded.
+/// Config > Configure Radios.
+public sealed partial class AppSession
+{
+    private RadioMirror? mirror;
+
+    /// Starts, restarts or stops the listener, following what the settings now
+    /// say. A port that cannot be opened is reported and the listener stays off.
+    public void ApplyMirrorRadioSettings()
+    {
+        mirror?.Dispose();
+        mirror = null;
+        if (!Settings.MirrorRadioEnabled)
+        {
+            return;
+        }
+        try
+        {
+            mirror = new RadioMirror(Settings.MirrorRadioPort);
+        }
+        catch (SocketException e)
+        {
+            Reported?.Invoke(this, $"could not listen for radio data on port {Settings.MirrorRadioPort}: {e.Message}");
+            return;
+        }
+        mirror.Failed += (_, problem) => Reported?.Invoke(this, problem);
+        mirror.Received += (_, message) => Dispatcher.UIThread.Post(() => Mirror(message));
+    }
+
+    /// Sets the target position to where the message says. This computer's own
+    /// messages are skipped, because the radio data goes to this port too when
+    /// the default address is used.
+    private void Mirror(RadioBroadcast message)
+    {
+        RadioReport source = message.Radio;
+        if (message.StationName == ComputerName
+            || source.RadioNumber != Settings.MirrorRadioSource
+            || (Settings.MirrorRadioStation.Length > 0
+                && !string.Equals(message.StationName, Settings.MirrorRadioStation, StringComparison.OrdinalIgnoreCase)))
+        {
+            return;
+        }
+        OperatingPosition? position = positions.FirstOrDefault(p => p.RadioNumber == Settings.MirrorRadioTarget);
+        if (position is null || source.Frequency <= 0)
+        {
+            return;
+        }
+        Frequency frequency = Frequency.FromHertz(source.Frequency);
+        Frequency transmit = source.IsSplit ? Frequency.FromHertz(source.TransmitFrequency) : Frequency.Zero;
+        Mode? mode = MirroredMode(source.Mode);
+
+        bool frequencyChanged = frequency != position.Frequency;
+        bool modeChanged = mode is not null && mode != position.Mode;
+        bool splitChanged = transmit != position.TransmitFrequency;
+        if (!frequencyChanged && !modeChanged && !splitChanged)
+        {
+            return;
+        }
+        position.Tune(frequency, mode, transmit);
+    }
+
+    /// N1MM names reverse CW and FSK differently from our modes. Null for a
+    /// mode we have no name for, which leaves the mode where it is.
+    private static Mode? MirroredMode(string name) => name.Trim().ToUpperInvariant() switch
+    {
+        "CW-R" or "CWR" => Modes.Cw,
+        "FSK" or "RTTY-R" or "RTTYR" => Modes.Rtty,
+        var other => Modes.Parse(other),
+    };
+}

src/Nonemm.App/AppSession.cs

@@ -1018,6 +1018,7 @@ public sealed partial class AppSession : IDisposable
         announcing?.Stop();
         broadcasting?.Stop();
         data?.Dispose();
+        mirror?.Dispose();
         network?.Dispose();
         link?.Dispose();
         alternating?.Dispose();

src/Nonemm.App/Configuration/Settings.cs

@@ -148,6 +148,23 @@ public sealed record Settings
 
     public BroadcastChannel BroadcastLookup { get; init; } = new();
 
+    /// Copy the frequency, mode and split of a radio that another computer
+    /// broadcasts. The data comes one way: this station never sends anything
+    /// back to it.
+    public bool MirrorRadioEnabled { get; init; }
+
+    /// The UDP port the radio data arrives on.
+    public int MirrorRadioPort { get; init; } = BroadcastTargets.DefaultPort;
+
+    /// Only mirror the computer with this name. Empty follows any computer.
+    public string MirrorRadioStation { get; init; } = "";
+
+    /// The radio number on the computer being mirrored.
+    public int MirrorRadioSource { get; init; } = 1;
+
+    /// The radio on this computer that does the mirroring.
+    public int MirrorRadioTarget { get; init; } = 1;
+
     public IReadOnlyDictionary<BroadcastKind, BroadcastChannel> BroadcastChannels() =>
         new Dictionary<BroadcastKind, BroadcastChannel>
         {
@@ -387,7 +404,7 @@ public sealed record Settings
     /// afterwards. N1MM's "don't drop call".
     public bool DigitalRightClickKeepsCall { get; init; }
 
-    /// A grabbed call is followed by a space, which moves to the exchange and
+    /// A grabbed call is mirrored by a space, which moves to the exchange and
     /// fills the report in, the way typing one does.
     public bool DigitalGrabSendsSpace { get; init; } = true;
 
@@ -407,7 +424,7 @@ public sealed record Settings
     /// underlines the line being printed to; true scrolls old text off the top.
     public bool DigitalScrolling { get; init; } = true;
 
-    /// A click on a callsign is followed by a space, so the cursor moves to
+    /// A click on a callsign is mirrored by a space, so the cursor moves to
     /// the exchange the way it does after a grab.
     public bool DigitalClickSendsSpace { get; init; }
 

src/Nonemm.App/Dialogs/RadioDialog.axaml

@@ -28,6 +28,21 @@
     <TextBox Name="BoxPortBox" />
     <TextBlock TextWrapping="Wrap" FontSize="11" Opacity="0.75" Margin="0,8,0,0"
                Text="With a second radio the station is SO2R: both are read and both show on the bandmap, but only the one you are on drives the entry window. Ctrl+Tab moves you to the other, and Ctrl+Shift+Tab puts both in the headphones. An OTRSP box follows, routing the key and the headphones." />
+    <Separator Margin="0,10,0,4" />
+    <TextBlock TextWrapping="Wrap" FontSize="11" Opacity="0.75"
+               Text="Mirror a radio: record the frequency, mode and split of a radio on another Nonemm or N1MM computer as this computer's own, when this computer has no port to the radio. The other computer must send Radio data to this computer (Config > Broadcast Data). Nothing is sent back, and no radio is controlled." />
+    <CheckBox Name="MirrorEnabledCheck" Content="Mirror a radio from another computer" />
+    <Grid ColumnDefinitions="200,*" RowDefinitions="Auto,Auto,Auto,Auto" RowSpacing="6">
+      <TextBlock Text="UDP port to listen on" VerticalAlignment="Center" />
+      <TextBox Name="MirrorPortBox" Grid.Column="1" />
+      <TextBlock Grid.Row="1" Text="Computer name (empty: any)" VerticalAlignment="Center" />
+      <TextBox Name="MirrorStationBox" Grid.Row="1" Grid.Column="1" />
+      <TextBlock Grid.Row="2" Text="Radio on the other computer" VerticalAlignment="Center" />
+      <TextBox Name="MirrorSourceBox" Grid.Row="2" Grid.Column="1" />
+      <TextBlock Grid.Row="3" Text="Radio on this computer" VerticalAlignment="Center" />
+      <TextBox Name="MirrorTargetBox" Grid.Row="3" Grid.Column="1" />
+    </Grid>
+    <TextBlock Name="ProblemText" TextWrapping="Wrap" Foreground="OrangeRed" IsVisible="False" />
     <StackPanel Orientation="Horizontal" HorizontalAlignment="Right" Spacing="6" Margin="0,8,0,0">
       <Button Content="Cancel" Click="OnCancel" />
       <Button Content="Save" Click="OnSave" IsDefault="True" />

src/Nonemm.App/Dialogs/RadioDialog.axaml.cs

@@ -4,7 +4,7 @@ using Nonemm.App.Configuration;
 
 namespace Nonemm.App.Dialogs;
 
-/// The radios on the desk, one rigctld each.
+/// The radios on the desk, one rigctld each, and the radio mirror.
 public sealed partial class RadioDialog : Window
 {
     private const int DefaultPort = 4532;
@@ -18,6 +18,11 @@ public sealed partial class RadioDialog : Window
         Show(0, HostBox, PortBox, EnabledBox);
         Show(1, SecondHostBox, SecondPortBox, SecondEnabledBox);
         BoxPortBox.Text = settings.So2rBoxPort;
+        MirrorEnabledCheck.IsChecked = settings.MirrorRadioEnabled;
+        MirrorPortBox.Text = settings.MirrorRadioPort.ToString();
+        MirrorStationBox.Text = settings.MirrorRadioStation;
+        MirrorSourceBox.Text = settings.MirrorRadioSource.ToString();
+        MirrorTargetBox.Text = settings.MirrorRadioTarget.ToString();
     }
 
     private void Show(int at, TextBox host, TextBox port, CheckBox enabled)
@@ -30,15 +35,40 @@ public sealed partial class RadioDialog : Window
         enabled.IsChecked = radio.IsEnabled;
     }
 
-    private void OnSave(object? sender, RoutedEventArgs e) => Close(settings with
+    private void OnSave(object? sender, RoutedEventArgs e)
     {
-        Radios =
-        [
-            Read(HostBox, PortBox, EnabledBox),
-            Read(SecondHostBox, SecondPortBox, SecondEnabledBox),
-        ],
-        So2rBoxPort = (BoxPortBox.Text ?? "").Trim(),
-    });
+        List<string> problems = [];
+        if (!int.TryParse(MirrorPortBox.Text, out int mirrorPort) || mirrorPort is < 1 or > 65535)
+        {
+            problems.Add("The mirror port must be a number from 1 to 65535.");
+        }
+        bool isSourceValid = int.TryParse(MirrorSourceBox.Text, out int source) && source is 1 or 2;
+        bool isTargetValid = int.TryParse(MirrorTargetBox.Text, out int target) && target is 1 or 2;
+        if (!isSourceValid || !isTargetValid)
+        {
+            problems.Add("The mirror radio numbers must be 1 or 2.");
+        }
+        if (problems.Count > 0)
+        {
+            ProblemText.Text = string.Join("\n", problems);
+            ProblemText.IsVisible = true;
+            return;
+        }
+        Close(settings with
+        {
+            Radios =
+            [
+                Read(HostBox, PortBox, EnabledBox),
+                Read(SecondHostBox, SecondPortBox, SecondEnabledBox),
+            ],
+            So2rBoxPort = (BoxPortBox.Text ?? "").Trim(),
+            MirrorRadioEnabled = MirrorEnabledCheck.IsChecked == true,
+            MirrorRadioPort = mirrorPort,
+            MirrorRadioStation = (MirrorStationBox.Text ?? "").Trim(),
+            MirrorRadioSource = source,
+            MirrorRadioTarget = target,
+        });
+    }
 
     private static StoredRadio Read(TextBox host, TextBox port, CheckBox enabled) => new()
     {

src/Nonemm.App/Windows/EntryWindow.Menu.cs

@@ -522,6 +522,7 @@ public sealed partial class EntryWindow
         }
         session.Save(updated);
         session.ConnectRadios();
+        session.ApplyMirrorRadioSettings();
         try
         {
             session.ApplySo2rSettings();

src/Nonemm.App/Windows/EntryWindow.axaml.cs

@@ -206,6 +206,10 @@ public sealed partial class EntryWindow : Window
         {
             yield return ("data broadcast", session.ApplyBroadcastSettings);
         }
+        if (session.Settings.MirrorRadioEnabled)
+        {
+            yield return ("radio mirror", session.ApplyMirrorRadioSettings);
+        }
         // always, whatever the CW keyer is: this is also what builds the voice
         // keyer, which plays out of the sound card rather than a keying port
         yield return ("keyer", session.ApplyKeyerSettings);