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 (14 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} 5NN {Snt}
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)

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).

Contest-spezifische Sets speichern?

Aktuell gibt's nur ein globales 8-Slot-Set. Bei wechselnden Conteste musst du anpassen oder Reset machen. Multi-Set-Storage steht auf der Roadmap.

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 ~/Documents/HAM-Tools/Macros/Contest/ abgelegt
4. »Vorhören« (ohne PTT) zum Check
5. Bei Fehlversuch: »Löschen« → erneut aufnehmen

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 — ICOM Voice-Keyer V1–V4 als Alternative

Wenn du einen ICOM mit eingebautem Voice-Keyer hast (IC-7300, IC-7610, IC-9700 etc.), 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 / Stop-Buttonreihe — sie löst die TRX-Slots über CAT aus.

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:

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: Bei CW gibt's keinen Hard-Stop (Morse fliegt durch). Bei SSB stoppt klicken auf irgendeinen anderen Macro-Button die laufende Aufnahme via PTT-Release. Sicherheits-Workaround: TRX-VOX ausschalten, dann sperrt manueller PTT-Knopf alles.

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 ~/Documents/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