Contest mit F1–F8 Macros

In 20 Minuten von »Contest startet in 30 Min« zu »Macros sitzen, CW fliegt per Knopfdruck, SSB-Voice ist eingespielt«.

Voraussetzungen

• CAT-Inbetriebnahme abgeschlossen (Hamlib send_morse braucht eine aktive CAT-Verbindung, SSB-PTT auch)
• Eingebautes Mikrofon oder USB-Mic für SSB-Aufnahmen
• Funkpartner oder Dummy-Load zum Testen vor dem Contest

Schritt 1 — Contest-Log anlegen

1. Hauptfenster → Sidebar → »Contest«
2. Toolbar »+ Log« → Sheet öffnet sich
3. Pflichtfelder:
   • Contest-Template: z.B. CQ-WW CW 2026 oder USKA Field Day SSB (40 Templates eingebaut, siehe Contest-Modul)
   • Category-Operator: SINGLE-OP (Solo) oder MULTI-OP-SINGLE / MULTI-OP-MULTI (siehe Multi-Op-Tutorial)
   • Power, Mode, Assisted/Non-Assisted, Bands — Cabrillo-Header- Tags, kommen direkt aus dem Template-Default, du musst nur prüfen
4. »Anlegen«

Das Log ist jetzt aktiv. Die Macro-Reihe F1–F8 erscheint unter dem QSO-Eingabe-Formular.

Schritt 2 — Mode-Indikator über den Buttons

Über der F1–F8-Reihe siehst du einen kleinen Indikator:

Anzeige	Bedeutung
🔵 CW	TRX-Mode (aus CAT) ist CW → Klicken sendet via Hamlib send_morse
🟠 SSB	TRX-Mode ist LSB/USB/AM → Klicken spielt die .m4a-Aufnahme via PTT-Toggle
⚪ nicht aktiv	Keine CAT-Verbindung oder kein Macro im Slot

Das Schöne: du musst nichts umschalten. Wenn du im Contest zwischen CW und SSB wechselst (Dual-Mode-Contests), ändert sich auch das Macro- Verhalten automatisch.

Schritt 3 — CW-Macros (sofort einsatzbereit)

Die Werks-Belegung entspricht dem N1MM-Standard und funktioniert für 80% aller Contests sofort:

Slot	Label	CW-Text
F1	CQ	CQ TEST {MyCall} {MyCall} TEST
F2	Exch	{TheirCall} {Snt} — {Snt} enthält den Rapport schon; bis 1.56 stand hier «5NN» doppelt ab 1.57
F3	TU	TU {MyCall}
F4	MyCall	{MyCall}
F5	HisCall	{TheirCall}
F6	?	?
F7	5NN	5NN
F8	AGN	AGN

Verfügbare Variablen in CW-Templates:

Variable	Ersetzung
{MyCall}	Dein Rufzeichen aus Station-Settings (oder Pro-Log-Override)
{TheirCall}	Der Inhalt des Call-Feldes im Form
{Snt}	RST gesendet (default 599 bei CW)
{Rcv}	RST empfangen (was du im Feld eingetragen hast)
{Cnt}	Laufende QSO-Nummer (Serial)
{Exch}	Contest-Austausch (z.B. CQ-Zone, Sektion)
{Ref}	Eigene Referenz des aktiven Logs (POTA-Park, SOTA-Summit, …) — im Contest leer

Schritt 4 — Macros anpassen

1. Einstellungen → Macros (⌘, → Tab »Macros«)
2. Du siehst 8 Slots als Rows
3. Pro Slot kannst du ändern:
   • Label (was auf dem Button steht)
   • CW-Text (Template mit Variablen)
   • SSB-Audio (siehe nächster Schritt)

Werks-Reset: Button »Auf Werks-Belegung zurücksetzen« unten — nimmt die N1MM-Defaults zurück (alle 8 Slots auf einmal).

Zwei Profile: Contest und Allgemein

Es gibt zwei globale 8-Slot-Sets: Contest (unter dem Contest-Formular) und Allgemein (im DX- und in allen Outdoor- Formularen, Werksbelegung mit {Ref} für POTA/SOTA & Co.). Beide haben ihren eigenen Reset. Contest-spezifische Sets pro Template gibt es nicht — bei wechselnden Contesten anpassen oder Reset.

Schritt 5 — SSB-Voice-Aufnahmen

Für SSB-Conteste ersetzt du den CW-Text durch eine Audio-Datei. macOS fragt beim ersten Mal nach Mikrofon-Berechtigung — NSMicrophoneUsageDescription in der App-Info.plist erklärt das.

1. Macro-Slot auswählen, Button »Aufnahme« (oder Mikrofon-Icon)
2. 3-2-1-Aufnahme läuft mit Sekunden-Timer
3. »Stop« → AAC/m4a-Datei wird in ~/Library/Application Support/HAM-Tools/Macros/Contest/ abgelegt (Einstellungen → Daten → Voice-Keyer öffnet den Ordner)
4. »Vorhören« (ohne PTT) zum Check
5. Bei Fehlversuch: »Neu aufnehmen« — die bisherige Aufnahme bleibt erhalten, bis die neue erfolgreich gespeichert ist

Tipp für saubere Aufnahmen:

• 2 Sekunden Vorlauf-Stille bewusst weglassen — PTT-Toggle braucht am Anfang der Aufnahme keinen Puffer
• 0.5 Sekunden Nachlauf am Ende lassen — PTT wird erst beim AudioPlayer-Ende released (onFinish-Callback)
• USB-Headset ist hörbar besser als das Mac-Mikro
• Klipping vermeiden — der TRX-Mikro-Pegel macht den Rest

Schritt 6 — TRX-Voice-Keyer (ICOM V1–V4, Yaesu V1–V5) als Alternative

Wenn dein TRX einen eingebauten Voice-Keyer hat (ICOM IC-7300, IC-7610, IC-9700, IC-705; Yaesu FT-991/A, FT-710, FTDX-10/101), kannst du die TRX-internen Slots statt der HAM-Tools-Macros nutzen.

In jedem Entry-Form (DX, Contest, POTA, SOTA, WWFF, BOTA) gibt's eine V1 / V2 / V3 / V4-Buttonreihe — sie löst die TRX-Slots über CAT aus. Bei Yaesu-Profilen erscheint seit 1.9.10 zusätzlich V5 (Yaesu hat fünf Slots, ICOM vier). Einen Stop-Knopf gibt es bewusst nicht, und Esc wirkt nur auf die HAM-Tools-Macros: Hamlibs stop_voice_mem bleibt auf den getesteten Yaesu- und ICOM-Geräten wirkungslos. Eine laufende TRX-Wiedergabe brichst du am Gerät ab.

Wann lohnt sich was?

Szenario	Empfehlung
Du hast ICOM und willst CW + SSB mischen	HAM-Tools-Macros (CW + SSB), Voice-Keyer nur als Backup
Du hast keinen Voice-Keyer-fähigen TRX	HAM-Tools SSB-Aufnahmen, kein V1–V4
Du machst nur SSB-Contest mit ICOM-IC-7610	TRX-V1–V4 (besserer Sound, weniger CPU-Last auf dem Mac)
Du machst nur CW	HAM-Tools-Macros (V1–V4 ist SSB-only)

Voice-Keyer einsprechen

Das geht über das TRX-Menü, nicht über HAM-Tools. Bei IC-7300 z.B.: Menü → MEM/CH → VOICE → REC. HAM-Tools triggert nur das Abspielen.

Schritt 7 — Im Contest

Tastatur-Workflow während des Contests — F1–F8 lösen die Slots aus, Esc stoppt, auch wenn der Cursor in einem Textfeld steht. macOS muss die F-Tasten dafür als Standard-Funktionstasten liefern (Systemeinstellungen → Tastatur → «F1, F2 usw. als Standard- Funktionstasten verwenden»), sonst hältst du zusätzlich fn.

1. F1 → CQ-Ruf raus
2. Anrufer ins Call-Feld tippen (oder Doppelklick aus Bandmap)
3. F2 → Exch raus (CQ-WW: K1AA 5NN 03, Field Day: K1AA 5NN 1A WMA)
4. Gegenstation antwortet mit seinem Austausch — tippst du ins RST/Exch-Feld
5. Return loggt das QSO
6. F3 → TU raus, neue Runde

Stop / Abbruch: Der rote Stop-Knopf oder Esc schickt bei CW Hamlib stop_morse (ob der TRX mitten im Zeichen abbricht, hängt vom Backend ab) und stoppt bei SSB die laufende Aufnahme inklusive PTT-Release. Sicherheits-Workaround: TRX-VOX ausschalten, dann sperrt der manuelle PTT-Knopf alles.

Freitext-CW: Steht der TRX im CW, erscheint rechts neben Stop ein Textfeld. Text tippen, Enter sendet ihn über send_morse, Variablen wie {TheirCall} werden auch hier ersetzt. Praktisch für alles, was nicht in einen Slot passt («QRL?», «PSE QSY 7033»).

Häufige Probleme

F1 wird gedrückt, aber kein Ton / kein Senden
→ CAT-Status grün? radio.hamlibMode muss bekannt sein. Test im CAT-Tab ob Frequenz live ist. Wenn nein → CAT-Inbetriebnahme nochmal durchgehen.

SSB-Aufnahme spielt nicht ab
→ Datei vorhanden? Schau in ~/Library/Application Support/HAM-Tools/Macros/Contest/ ob .m4a liegt. Wenn ja, ist's vermutlich PTT-Problem — TRX-Profil hat supportsPTT: false, brauchst externes Interface.

Variable {Cnt} zeigt 0
→ Serial-Counter zählt erst hoch wenn QSOs geloggt sind. Vor dem ersten QSO ist Serial logisch leer.

Mikrofon-Permission verweigert
→ Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon → HAM-Tools einschalten. Falls die App nicht in der Liste auftaucht: einmal eine Aufnahme versuchen, macOS fragt dann automatisch nach.

CW geht aber Sende-Geschwindigkeit ist zu langsam/schnell
→ Hamlib nimmt die TRX-interne WPM-Einstellung. Im TRX-Menü ändern (IC-7300: Speed-Knopf rechts oben, Yaesu FT-991A: Menü-Item Z2-15).

Nächste Schritte

• Multi-Op-Contest — Logbuch mit mehreren OPs
• Contest-Modul — Templates, Scoring, Cabrillo-Export
• Macros-Einstellungen — Settings-Übersicht
• Die Makro-Reihe gibt es auch im DX- und in den Outdoor-Formularen (Profil Allgemein, nur bei verbundenem CAT) — siehe Logbuch-Modul