LoTW-Pipeline einrichten

LoTW (Logbook of The World) ist das offizielle ARRL-System für QSO-Bestätigungen und wird für die meisten DXCC-, WAS- und WAZ-Awards akzeptiert. HAM-Tools nutzt das offizielle CLI-Tool TQSL als Subprocess — du behältst volle Kontrolle über Zertifikate und Station- Locations.

Dauer: 30 Minuten beim ersten Mal, danach laufen Uploads in Sekunden.

Voraussetzungen

• LoTW-Account bei arrl.org/logbook-of-the-world (kostenlos, Postversand-Verifizierung kann 1–2 Wochen dauern)
• HAM-Tools installiert und Lizenz aktiviert
• Internetverbindung

Phase 1 — TQSL.app installieren (einmalig)

HAM-Tools liefert TQSL nicht mit (ARRL-Lizenzgründe). Du installierst es selbst.

1. Download: lotw.arrl.org/lotw-help/installation/ → »TQSL for macOS« (aktuell 2.7.x)
2. DMG öffnen, TQSL.app in den Programme-Ordner ziehen
3. Erster Start: Gatekeeper meckert (»nicht verifizierter Entwickler«). Rechtsklick → »Öffnen« → »Trotzdem öffnen«.

tqsl 2.5+

HAM-Tools unterstützt sowohl tqsl ≥ 2.5 (Configs in ~/.tqsl/) als auch ältere Versionen (Configs in ~/Library/Application Support/TrustedQSL/). Du musst dich nicht entscheiden — der Picker findet beides.

Phase 2 — ARRL-Zertifikat anfordern + importieren

1. In TQSL.app: Callsign Certificate → Request New Callsign Certificate
2. Rufzeichen eintragen, Land/DXCC, Lizenz-Zeitraum
3. »Save Request« → erzeugt .tq5-Datei
4. Per E-Mail (verlinkt am Ende des Wizards) an ARRL einreichen
5. ARRL schickt Postkarte an deine Lizenzadresse mit Verify-Code (das ist warum das 1–2 Wochen dauern kann)
6. Nach Antwort: TQSL.app → Callsign Certificate → Load Certificate → .tq6-Datei laden, die ARRL dir mailt
7. Beim Laden vergibst du ein Cert-Passwort — merken!

Das Cert lebt jetzt im macOS-Keychain unter TrustedQSL.

Phase 3 — Station-Location in TQSL anlegen

Eine Station-Location beschreibt wo du gefunkt hast (für die LoTW-Zuordnung von DXCC-Multipliers, US-States, ITU/CQ-Zonen).

1. TQSL.app → Station → Station Locations
2. »Add« klicken
3. Wizard durchklicken:
   • Callsign: HB9HJI (dein Lizenz-Call)
   • DXCC Entity: Schweiz / dein Land
   • CQ Zone: 14 (CH), ITU Zone: 28
   • Grid Square: dein Locator (z.B. JN47PN)
   • State / County: nur bei W/VE relevant
4. Name vergeben: z.B. HB9HJI/HOME (wird in HAM-Tools angezeigt)
5. »OK«, Station ist gespeichert in ~/.tqsl/station_data.xml

Mehrere Stationen

Wenn du portabel funkst oder im Ausland, leg pro Standort eine eigene Location an: HB9HJI/JN36, HB9HJI/M-Toskana, HB9HJI/AM. HAM-Tools fragt beim Upload, welche Location verwendet werden soll.

Phase 4 — In HAM-Tools verknüpfen

Erst jetzt kommt HAM-Tools ins Spiel.

1. Einstellungen → Lookup & Upload (⌘, → Tab »Lookup & Upload«)
2. Sub-Picker oben: »LoTW« wählen
3. tqsl-Binary: Default ist /Applications/Tqsl.app/Contents/MacOS/tqsl — Auto-Detection sollte den Pfad gefunden haben. Falls leer oder die App liegt woanders: Button »📁 Suchen…« rechts neben dem Feld klicken → im Finder einfach die Tqsl.app anklicken, HAM-Tools trägt den Binary-Pfad automatisch ein. Funktioniert auch mit Homebrew-Installation (/opt/homebrew/bin/tqsl direkt auswählen).
4. Station-Location: Dropdown öffnen → du siehst die Locations aus Phase 3. Wähle deine Default-Location (z.B. HB9HJI/HOME)

Picker leer?

Wenn das Dropdown leer bleibt: Station-Location war noch nicht in TQSL angelegt. Phase 3 wirklich abgeschlossen? Liegt ~/.tqsl/station_data.xml (oder ~/Library/Application Support/TrustedQSL/station_data.xml)? Im Terminal prüfen:

cat ~/.tqsl/station_data.xml
ls -la ~/Library/Application\ Support/TrustedQSL/

Phase 5 — Auto-Upload aktivieren

Drei Toggles in der LoTW-Section:

Toggle	Effekt
»Jedes geloggte QSO automatisch hochladen«	Pro QSO ein TQSL-Aufruf — empfohlen für Daheim-Logger
»Nach erfolgreichem Upload › QSL via LoTW gesendet ‹ markieren«	QSL-Status wird automatisch gesetzt — empfehlenswert
(Master) Real-Time-Upload ganz oben	Wenn aus, ALLES pausiert (für Reisen/Portabel ohne Internet)

Phase 6 — Ersten Upload testen

1. Loggbuch → Log auswählen, mind. 1 QSO darin
2. QSO in der Tabelle markieren (oder mehrere via ⌘-Klick)
3. Rechtsklick → »LoTW: N QSOs hochladen«
4. Cert-Passwort eingeben (aus Phase 2)
5. Warte 5–30 Sekunden — Status-Spalte »LoTW« in der Tabelle zeigt Pille:

Pille	Bedeutung
🟡 Pending	Upload läuft
🟢 Sent	Erfolgreich an LoTW übergeben
🔴 Failed	tqsl gab Fehler zurück — Diagnose-Snippet im Alert
⚪ Confirmed	Gegenstation hat ihr QSO auch hochgeladen + es matched

Initial wirst du nur 🟢 Sent sehen — Confirmation kommt, wenn die Gegenstation ihrerseits uploaded.

Phase 7 — Confirmation-Sync

Nach ein paar Tagen / Wochen haben einige Gegenstationen ihre QSOs auch bei LoTW eingereicht. Hol dir die Bestätigungen:

1. Logbuch → Tab »QSL« oben
2. Button »LoTW-Bestätigungen abrufen«
3. HAM-Tools holt das LoTW-Report-XML von arrl.org, matched gegen deine QSOs auf Call+Band+Mode+Datum
4. Bestätigte QSOs werden 🟢 → ⚪ Confirmed
5. Awards-Tab zeigt die neuen Confirmed-Counter

Frequenz: 1× pro Woche reicht

LoTW pusht Bestätigungen nicht in Echtzeit. Ein wöchentlicher Sync deckt 95% ab. Wenn ein DXpedition-QSO wichtig ist (LoTW-Sync der DX-Operatoren erfolgt oft erst nach 6 Monaten), warte einfach.

Häufige Probleme

»Station Location X could not be found«
→ Tippfehler im Picker. Geh in TQSL.app → Station Locations und prüfe den exakten Namen (Groß-/Kleinschreibung zählt). Oder Picker in HAM-Tools nochmal öffnen — Dropdown zeigt die echten Namen.

Cert-Passwort wird jedes Mal abgefragt
→ Das ist Absicht (Sicherheit). Speichern ginge nur via Keychain- Item-Reuse, das machen wir nicht — du könntest sonst nicht zwischen Personal/Club/Contest-Certs trennen.

»tqsl: error: command-line option 'x' not recognized«
→ Du hast eine sehr alte TQSL-Version (< 2.5). Aktualisiere auf 2.7+.

Upload landet im »rejected«-Branch obwohl alles ok aussieht
→ Diagnose-Snippet im Fehler-Alert öffnet die rohe tqsl-Ausgabe. Häufige Ursache: Cert ist abgelaufen (LoTW-Certs gelten 3 Jahre), oder die Mode-Bezeichnung (z.B. FT8 vs. MFSK) wird von tqsl nicht akzeptiert. Manuelles tqsl im Terminal aufrufen reproduziert das.

eQSL/QRZ statt LoTW verwenden
→ siehe Einstellungen → Lookup & Upload. Jeder Service hat eigene Toggles, alle parallel möglich.

Was als Nächstes

• Erstes POTA-QSO loggen — falls noch nicht
• POTA-Modul und SOTA-Modul lesen LoTW- Confirmations automatisch für Award-Tracking
• ARRL DXCC + WAS + WAZ Awards können bei genug Confirmations direkt bei ARRL beantragt werden