Das Wavelog Nutzerhandbuch
Version DARC DCLnext
Logo: Quelle https://github.com/wavelog/wavelog, Freigabe gemäß MIT Licence
Nachschlag aus dem Callbook (Update from Callbook)
Einige Felder können automatisch auch aus dem Callbook nachgeschlagen werden. Dafür kann entweder hamqth oder qrz.com verwendet werden. Ggf. sind jedoch für einige der Dienste separate Abos notwendig (z.B. bei qrz.com, um den Locator zu erfragen).
API-Schnittstellen
Allgemeines
API-Schnittstellen, Application Programming Interfaces oder Programmierschnittstellen öffnen Funktionalitäten für die vereinfachte und genormte Nutzung durch Drittanbieter-Software. Wavelog bietet einige solcher Schnittstellen an, um die Funktionen, die Wavelog bietet, anderen Programmen zur Nutzung zur Verfügung zu stellen. Hier werden einige dieser Schnittstellen kurz vorgestellt. Programmierer erhalten im Wiki des Github-Repositories von Wavelog unter https://github.com/wavelog/wavelog/wiki/API weitere technische Informationen für die Umsetzung.
Grundsätzliches zur Nutzung
Um eine API-Schnittstelle nutzen zu können, muss innerhalb von Wavelog zunächst ein entsprechender API-Schlüssel für die Anwendung erzeugt werden. Dies geschieht über das Menü mit dem eigenen Rufzeichen und den Unterpunkt “API-Schlüssel”:
Hier gibt es die Möglichkeit, entweder einen Schlüssel mit Schreib- und Leseberechtigung oder einen Schlüssel, der nur Leseberechtigung besitzt, zu erzeugen. Dies geschieht jeweils über einen der beiden Buttons am unteren Seitenrand.
Die jeweiligen Schlüssel können über den “Bearbeiten”-Button mit einer Bezeichnung versehen werden, um sie einfacher zuordnen zu können. Man kann auch grundsätzlich die Funktion des Schlüssels testen oder auch einen Schlüssel löschen.
Aus Sicherheitsgründen ist es grundsätzlich ratsam, für jede Anwendung einen eigenen Schlüssel zu erzeugen. So kann, wenn es mal nötig ist, eine einzelne Anwendung abgeschaltet werden, indem ihr Key gelöscht wird. Nutzt man nur einen Key für alles, ist bei einem Sicherheitsproblem gleich viel Arbeit durch Schlüsseltausch angesagt.
API/QSO
Die QSO-Schnittstelle dient der Einlieferung von Log-Einträgen (QSO-Logs) als ADIF-Schnipsel. Es gibt bereits einige Programme, die diese Schnittstelle nativ zum Loggen nutzen (zum Beispiel WSJT-X improved oder FLDigi).
API/get_contacts_adif
Über diesen Schnittstellenaufruf können ADIF-Exporte als JSON-eingebetteten Datenstrom abgerufen werden, um diese weiter verarbeiten zu können.
API/Radio
Diese Funktion dient der Entgegennahme von CAT-Daten wie Transceiver-Frequenz, Sendeleistung und Mode. Diese Daten können in den jeweiligen Logging-Funktionen (Echtzeit-Loggen oder zeitversetztes Loggen) als Grundlage für die QSO-Erfassung dienen.
API/logbook_check_callsign
Um die Existenz von QSOs mit einem bestimmten Rufzeichen im Logbuch ab zu prüfen, kann dieser Aufruf genutzt werden.
API/logbook_check_grid
Vergleichbar mit dem vorhergehenden Punkt, kann mittels dieser Funktion geprüft werden, ob ein bestimmtes Locator-Feld im Log existiert.
API/statistics
Um für das aktive Stationsprofil Statistiken abzurufen, kann dieser Aufruf verwendet werden Er liefert Informationen über die Anzahlen
heutiger QSOs
von QSOs im aktuellen Monat
von QSOs im aktuellen Jahr und
aller QSOs im aktiven Profil.
API/station_info
Mittels dieser Funktion können Informationen aus den vorhandenen Stationsstandorten abgerufen werden. Hierbei werden die Stations-IDs, der Name, das Locator, das Rufzeichen und die Tatsache, ob es sich um das aktive Profil handelt oder nicht, geliefert.
Abläufe im Alltag, Schritt für Schritt
Allgemeines
Dieser Abschnitt vertieft nun anhand konkreter Anwendungsfälle die Nutzung von Wavelog, um hier die Alltagsnutzung deutlicher zu machen, die über die Grundfunktionen hinaus geht.
Bereinigung/Änderung des QSL via-Eintrags
Oftmals beinhaltet der QSL via-Eintrag, insbesondere, wenn dieser aus QRZ.com oder hamqth.com gefüllt wird, Angaben, die man so nicht in den via-Eintrag der QSL-Karte drucken möchte. Leider findet man z.B. bei QRZ.com gerne beim Manager-Eintrag ganze Romane oder Angaben, die für das QSL-Routing im technischen Sinne nicht brauchbar sind. Ein Beispiel seien hier z.B. Einträge wie “eQSL or LoTW. bureau.” oder dergleichen. Diese lassen sich für ausgewählte QSOs per Masse entfernen. In der Regel wird man diesen Eintrag ja auch nur für die Karten entfernen wollen, die zum Druck in der Warteschlange stehen. Hierzu wählt man im erweiterten Log in den QSL-Filtern bei “QSL gesendet” den Eintrag “In Warteschlange” aus und setzt die Anzahl der Resultate auf einen hohen Wert, um hier alle zu druckenden QSOs angezeigt zu bekommen. Nun lässt sich die Spalte “QSL via” über einen Klick auf die Spaltenüberschrift sortieren - mehrfaches Klicken ändert jeweils die Sortierrichtung. Nun lassen sich die QSOs, deren QSL via-Eintrag geleert werden soll, per Markierung am Anfang der QSO-Zeile auswählen und per Klick auf den “Bearbeiten” button wechselt man in den “Massenbearbeitungs-Modus”:
Hier kann nun in der ersten Auswahlbox aus den zur Verfügung stehenden Optionen der Eintrag “QSL via” ausgewählt werden:
Anschließend ändert sich der Dialog kontextabhängig zur Eingabe des Managereintrags:
Hier lässt man nun den Eintrag schlicht leer und speichert ab. Das Resultat ist, dass nun für die ausgewählten QSOs der QSL via-Eintrag geleert wird und man für den QSL-Kartendruck saubere Managerdaten vorliegen hat.
Vergleichbar kann man übrigens auch vorgehen, wenn man für eine Zahl an QSOs einen identischen QSL-Manager eintragen möchte (z.B. für DXPeditionen).
Exporte von QSOs mit einzelnen Stationen
Mitglieder von DX-Clubs wie z.B. der GDXF kennen den Bedarf, zu einem Rufzeichen alle QSOs als ADIF exportieren zu wollen, um zum Beispiel über ein OQRS QSL-Karten zu beantragen. Die Erzeugung eines solchen ADIF-Files ist mit Wavelog und seiner erweiterten Suche ein Kinderspiel.
Die erweiterte Suche bietet nämlich bezogen auf das Ergebnis die Möglichkeit, die QSOs, die über die jeweilige Suche gefunden worden sind, als ADIF-Datei zu exportieren. So lässt sich also zum Beispiel mit dem Suchfilter zunächst die Liste der QSOs zu einem bestimmten Rufzeichen erzeugen:
Diese QSOs lassen sich dann per Klick auf “Export to ADIF” als ADIF-Datei auf dem lokalen Rechner abspeichern und weiterverarbeiten:
Nutzung von Wavelog als SWL
Grundsätzlich lässt sich Wavelog, auch wenn es primär für Funkamateure konzipiert ist, auch als SWL nutzen für das Logging von Verbindungen zwischen Funkamateuren. Nehmen wir mal ein Praxisbeispiel: DL1ABC arbeitet auf 40m in SSB mit DL9XYZ. Beide Stationen sind vom SWL DE9VHV zu empfangen, DL1ABC mit 59, DL9XYZ nur mit 57. Wie würde man nun dieses QSO im Wavelog eintragen? Kurzer Spoiler: Es wird in zwei Logeinträge aufgesplittet, einen für DL1ABC und einen für DL9XYZ. Im jeweiligen Logeintrag hat man nun die Möglichkeit, den Rapport für die jeweilige Station (DL1ABC = 59) einzutragen. Die Tatsache, mit welcher Gegenstation das QSO lief, wird dann im Kommentarfeld erfasst: “wkd wd DL9XYZ”. Hier können dann auch noch weitere Eintragungen vorgenommen werden. Das gleiche Spiel passiert dann für DL9XYZ in einem zweiten Logeintrag.
Diese Vorgehensweise hat mehrere Vorteile:
Für jedes Rufzeichen sind die korrekten Daten erfassbar (also Rapporte, Name, Standort etc.)
Es kann ein QSL-Label oder ein ADIF-Export für einen Druckservice für jedes Rufzeichen erzeugt werden, also im obigen Beispiel: 2 Karten
Es eröffnet sich die Möglichkeit, für jedes der Rufzeichen ein eigenes QSL-Management vorzunehmen. Bedeutet: Es können vollkommen verschiedene QSL-Vermittlungswege genutzt werden und auch der QSL-Rücklauf ist separat für jedes Rufzeichen erfassbar.
So sollten im Grunde alle Bedürfnisse auch für den SWL zu befriedigen sein.
Bekannte Fehler
Bei einem “Update from Callbook” (QRZ) wird der Locator nicht aktualisiert
Problemstellung
Der Locator der anderen Station wird bei einem “Update from Callbook” (wenn als Callbook QRZ.com eingestellt ist) nicht aktualisiert.
Lösungsansatz
Dieser Service benötigt eine aktive QRZ.com Subscription. Wenn das gewünscht ist, mindestens die XML-Subscription abschließen.
QSOs werden nicht von Clublog heruntergeladen
Problembeschreibung
Die aktuellen QSOs werden nicht heruntergeladen.
Der Cron meldet keinen Fehler, der Webserver Log meldet keinen Fehler.
Wenn manuell `index.php/clublog/download/` aufgerufen wird, kommt als Antwort `Nothing to download`, aber alle QSOs im Logbuch sind in der Clublog Spalte immer noch auf rot.
Lösungsansatz
Überprüfe, ob in der Einstellung `Ignore Clublog Upload` bei der entsprechenden Station aktiv ist. Denn dies deaktiviert auch den Upload. Und dieses wird ggf. automatisch deaktiviert bei einem fehlgeschlagenen Login bei Clublog.
Einige QSOs werden nicht zu QRZ hochgeladen
Problemstellung
Einige der QSOs, und zwar die mit einem Station Callsign mit zwei / (also zum Beispiel OZ/DO5LE/P) werden nicht zu QRZ hochgeladen
Es kommt dazu eine Fehlermeldung im Sinne von “STATUS=FAIL&RESULT=FAIL&REASON=wrong station_callsign for this logbook OZ/DO5LE/P doesnt match book callsign OZ/DO5LE&EXTENDED= Call”
Lösungsansatz
Das Problem liegt bei QRZ.com. Dort ist das Problem, zum Stand 2024-09-01 bekannt, jedoch noch nicht gelöst.
QSOs werden nicht zu LoTW hochgeladen
Problemstellung
QSOs eines QSO-Standorts werden nicht hochgeladen. QSOs anderer Standorte werden hingegen hochgeladen.
Lösungsansatz
Den betroffenen Standort einmal prüfen, ob die DXCC-Angabe erfolgt ist. LoTW verweigert die Annahme von Verbindungen, wenn kein DXCC eingetragen ist.
QSOs werden nicht zu LoTW hochgeladen, Variante 2
Problemstellung
Einzelne QSOs werden nicht hochgeladen.
Lösungsansatz
Prüfe die fraglichen QSOs, ob hier im Feld “Propagation” ein für LoTW valider Wert drin steht. QSOs, die über einen terrestrischen oder atmosphärischen Repeater bzw. Transponder geloggt sind, werden von LoTW abgewiesen!
Support
Was wäre ein Benutzerhandbuch, ohne den Hinweis, wo es weiterführenden Support gibt.
Support gibt es in der DARC-Matrix (im Matrix-Chat) einen Raum unter https://matrix.to/#/#cloudlog:darc.de, wo man sich auch mal mit Nutzern austauschen kann, Erfahrungen und Fragen loswerden kann und wo auch mal geholfen wird bei Problemen.
Zu guter Letzt können Nutzer der DCLnext-Wavelog-Instanz über die dortige “Supportanfrage” per E-Mail den Kontakt zum Supportteam der Wavelog-Instanz des DARC suchen.
Man ist also nicht ganz alleine auf dieser Welt.