Files
Nonemm/src/Nonemm.Digital/DigitalEngine.cs
ericek111 c8de74e24a Add the digital interface, running MMTTY under Wine
MMTTY and 2Tone have no socket or pipe interface: N1MM hosts XMMT.ocx and
exchanges window messages with the engine. A Linux process cannot load that
control, so bridge/nonemm-mmtty-bridge.exe hosts it under Wine and passes
lines over its standard input and output. docs/digital-bridge.md states the
protocol and what the control needs.

The window is N1MM's: receive pane with coloured callsigns, grab list, call
stacking, twenty-four macro buttons and the engine controls. One left click
copies what is under it — a callsign to the callsign box, anything else to the
exchange box the contest keeps for that kind of value.

Config > Digital registers XMMT.ocx in the Wine prefix on its own, making the
prefix first if it is not there. The engine, the bridge and the control start
at the copies shipped beside the program.

The bridge reads the control's own events. OnTranslateMessage carries only the
messages the control has no event for, so nothing was ever decoded through it.

hamlib's data mode names read as digital modes now, and a mode typed into the
callsign box changes mode the way a frequency changes band, so a station with
no radio can reach RTTY at all.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RoGtneMQaz4M9w7Kk49AVD
2026-08-31 21:35:45 +00:00

32 lines
1.2 KiB
C#

namespace Nonemm.Digital;
/// A digital modem that decodes what is on the air and sends what is typed:
/// MMTTY or 2Tone behind the Wine bridge today, fldigi later. The window above
/// it works through this and does not know which one is running.
public interface DigitalEngine : IDisposable
{
/// The modem is running and has told us its version.
bool IsConnected { get; }
bool IsTransmitting { get; }
/// Text the modem has decoded, in the pieces it arrived in: usually one
/// character. Raised on the reader thread, so a handler that touches the
/// screen has to post.
event EventHandler<string>? Received;
event EventHandler<bool>? TransmitChanged;
event EventHandler<bool>? ConnectionChanged;
/// Starts the modem and waits until it is connected. Throws if it does not
/// come up.
Task StartAsync(CancellationToken cancellation = default);
/// Puts the text in the transmit buffer, which starts the transmission.
Task SendAsync(string text, CancellationToken cancellation = default);
/// Drops whatever has not gone out yet, which is what Escape does.
Task AbortAsync(CancellationToken cancellation = default);
}