feat(elecraft): a K3/K4 console — power, volume, S-meter, SWR, MOX, tune

The Elecraft backend already existed; what was missing was somewhere to
operate the radio from. This adds the panel, on the Kenwood-dialect
client the K3 already speaks, in a tab of its own beside the Yaesu and
Icom consoles.

Scope is the six controls asked for and nothing else. Every extra command
added without a radio to test it against is a control that may or may not
do what its label says, and a K3 exposes dozens.

No K3 was available while writing this, so the two halves are treated
differently. The setters are the commands the reference documents
unambiguously and whose effect is visible and reversible (PC, AG,
TX/RX). The meters are the opposite: their scaling differs by model and
firmware, so the raw answers are logged next to the power setting, the
panel says the scaling is provisional, and an unmeasured SWR shows as
'—' rather than as a perfect 1.0 — a good match on an antenna nobody
measured is the reading that costs a radio.

ATU tune sends SWT20 (the K3 front-panel tap) and logs exactly what it
sent, so a wrong mapping names itself instead of leaving an operator
guessing which button OpsLog pressed.
This commit is contained in:
2026-08-24 14:09:28 +02:00
parent 1b63483596
commit 60dad353ce
11 changed files with 669 additions and 6 deletions
+175
View File
@@ -0,0 +1,175 @@
import { useEffect, useRef, useState } from 'react';
import { Radio, Power, Activity, AudioLines, SlidersHorizontal } from 'lucide-react';
import {
GetKenwoodState, RefreshKenwood, SetKenwoodPower, SetKenwoodAFGain, SetKenwoodTX, TuneKenwoodATU,
GetCATState,
} from '../../wailsjs/go/main/App';
import { cn } from '@/lib/utils';
import { useI18n } from '@/lib/i18n';
import { sMeterRST } from '@/lib/rst';
import { MeterBar } from '@/components/MeterBar';
type KenwoodState = {
available: boolean; model?: string; elecraft: boolean; mode?: string;
transmitting: boolean; split: boolean; split_tx_hz?: number;
s_meter: number; s_meter_raw: number;
power_meter: number; swr: number; swr_raw: number;
rf_power: number; af_gain: number;
meters_provisional: boolean;
};
const ZERO: KenwoodState = {
available: false, elecraft: false, transmitting: false, split: false,
s_meter: 0, s_meter_raw: 0, power_meter: 0, swr: 0, swr_raw: 0,
rf_power: 0, af_gain: 0, meters_provisional: true,
};
// Raw S-meter → S units. The K3 answers 0-21 across S0…S9+60; S9 is taken at
// raw 9 and each step above it as 6 dB. PROVISIONAL, like the rest of the
// scaling: the raw value is on screen and in the log, so a real radio settles
// it rather than this comment.
const S9_RAW = 9;
const DB_PER_RAW = 6;
function sParts(rawV: number): { s: number; over: number; label: string } {
if (rawV >= S9_RAW) {
const over = Math.max(0, Math.round((rawV - S9_RAW) * DB_PER_RAW));
return { s: 9, over, label: over > 0 ? `S9+${over}` : 'S9' };
}
const s = Math.max(0, Math.min(9, rawV));
return { s, over: 0, label: `S${s}` };
}
// Segment colour, printed the way a radio's own meter is: green up to S9, amber
// through the S9+ range, red once the signal would be reported as 59+20 or more.
function sSegColor(frac: number) {
if (frac > 0.78) return '#dc2626';
if (frac > 0.55) return '#f59e0b';
return '#16a34a';
}
export function ElecraftPanel({ onReportRST }: { onReportRST?: (rst: string) => void }) {
const { t } = useI18n();
const [st, setSt] = useState<KenwoodState>(ZERO);
const [freqHz, setFreqHz] = useState(0);
const [err, setErr] = useState('');
// Optimistic overlay: a slider must follow the finger, not the poll. Dropped
// once the radio has had time to answer with the value it actually took.
const [local, setLocal] = useState<{ rf_power?: number; af_gain?: number }>({});
const localAtRef = useRef(0);
useEffect(() => {
let alive = true;
const tick = async () => {
try {
const s = (await GetKenwoodState()) as KenwoodState;
const c = (await GetCATState()) as any;
if (!alive) return;
setSt(s);
setFreqHz(c?.split && c?.freq_rx_hz > 0 ? c.freq_rx_hz : (c?.freq_hz ?? 0));
if (Date.now() - localAtRef.current > 1200) setLocal({});
setErr('');
} catch (e: any) {
if (alive) setErr(String(e?.message ?? e));
}
};
tick();
const id = window.setInterval(tick, 500);
return () => { alive = false; window.clearInterval(id); };
}, []);
const view = { ...st, ...local };
const off = !st.available;
const put = (patch: typeof local, run: () => Promise<any>) => {
setLocal((p) => ({ ...p, ...patch }));
localAtRef.current = Date.now();
run().catch((e) => setErr(String(e?.message ?? e)));
};
return (
<section className="flex flex-col gap-2 h-full min-h-0 bg-card overflow-auto">
{/* Header */}
<div className="flex items-center gap-2 px-3 py-1.5 bg-muted/40 border-b border-border shrink-0">
<Radio className="size-4 text-primary shrink-0" />
<span className="text-xs font-semibold uppercase tracking-wider text-muted-foreground">
{st.elecraft ? 'Elecraft' : 'Kenwood'}
</span>
<span className="text-xs font-mono text-foreground/80">{st.model}</span>
<span className={cn('size-2 rounded-full', off ? 'bg-muted-foreground/40' : 'bg-success')} />
<div className="flex-1" />
<span className="font-mono text-sm tabular-nums">{freqHz > 0 ? (freqHz / 1e6).toFixed(6) : '—'}</span>
<button type="button" className="text-[11px] text-muted-foreground hover:text-foreground"
onClick={() => RefreshKenwood().catch(() => {})} title={t('k3.refreshHint')}>
<SlidersHorizontal className="size-3.5" />
</button>
</div>
{off && <div className="px-3 text-xs text-muted-foreground">{t('k3.waiting')}</div>}
{!!err && <div className="px-3 text-[11px] text-danger">{err}</div>}
{/* Meters */}
<div className="grid grid-cols-3 gap-2 px-3">
<MeterBar label="S-METER" value={view.transmitting ? 0 : view.s_meter} lo={0} hi={100}
accent="#16a34a" segColor={sSegColor}
display={view.transmitting ? '—' : sParts(view.s_meter_raw).label}
onClick={() => {
if (view.transmitting || !onReportRST) return;
const sp = sParts(view.s_meter_raw);
onReportRST(sMeterRST(sp.s, sp.over, view.mode));
}}
title={t('k3.sMeterHint', { raw: String(view.s_meter_raw) })} />
<MeterBar label="PWR" value={view.transmitting ? view.power_meter : 0} lo={0} hi={100} accent="#0ea5e9" />
{/* 0 means "not measured", and it must not render as a perfect 1.0:
a match that looks ideal on an antenna nobody has measured is the one
reading that can cost a radio. */}
<MeterBar label="SWR" value={view.transmitting && view.swr > 0 ? view.swr : 1} lo={1} hi={4}
accent="#f59e0b"
display={view.transmitting && view.swr > 0 ? view.swr.toFixed(1) : '—'} />
</div>
{view.meters_provisional && (
<p className="px-3 text-[10px] text-muted-foreground">{t('k3.provisional')}</p>
)}
{/* MOX + TUNE */}
<div className="flex items-center gap-2 px-3">
<button type="button" disabled={off}
onClick={() => SetKenwoodTX(!view.transmitting).catch((e) => setErr(String(e?.message ?? e)))}
className={cn('flex-1 px-3 py-2.5 rounded-lg text-sm font-extrabold tracking-wide border-2 transition-all disabled:opacity-30',
view.transmitting
? 'bg-danger text-danger-foreground border-danger shadow-[0_0_14px] shadow-danger/50'
: 'bg-card text-danger border-danger hover:bg-danger-muted')}>
<Power className="size-4 inline mr-1 -mt-0.5" /> MOX
</button>
<button type="button" disabled={off}
onClick={() => TuneKenwoodATU().catch((e) => setErr(String(e?.message ?? e)))}
title={t('k3.tuneHint')}
className="flex-1 px-3 py-2.5 rounded-lg text-sm font-extrabold tracking-wide border-2 border-warning text-warning bg-card hover:bg-warning-muted transition-all disabled:opacity-30">
<Activity className="size-4 inline mr-1 -mt-0.5" /> TUNE
</button>
</div>
{/* Power + volume */}
<div className="px-3 pb-3 space-y-2">
<label className="flex items-center gap-2 text-xs">
<span className="w-16 shrink-0 text-muted-foreground">{t('k3.power')}</span>
<input type="range" min={0} max={110} step={1} disabled={off}
value={view.rf_power ?? 0}
onChange={(e) => put({ rf_power: Number(e.target.value) }, () => SetKenwoodPower(Number(e.target.value)))}
className="flex-1 accent-primary" />
<span className="w-12 text-right font-mono tabular-nums">{view.rf_power ?? 0} W</span>
</label>
<label className="flex items-center gap-2 text-xs">
<span className="w-16 shrink-0 text-muted-foreground flex items-center gap-1">
<AudioLines className="size-3.5" /> {t('k3.volume')}
</span>
<input type="range" min={0} max={100} step={1} disabled={off}
value={view.af_gain ?? 0}
onChange={(e) => put({ af_gain: Number(e.target.value) }, () => SetKenwoodAFGain(Number(e.target.value)))}
className="flex-1 accent-primary" />
<span className="w-12 text-right font-mono tabular-nums">{view.af_gain ?? 0}</span>
</label>
</div>
</section>
);
}