7log

7log ist ein kommandozeilenorientiertes Logbuchprogramm für Linux. Es ist in leichgwichtiges kleines Programm, das auch auf kleinen Displays zum Einsatz kommen kann oder einfach per Terminal von einem Remote-Standort zu benutzen ist.

Die Anfänge stammen aus dem Wunsch ein kleines Logbuchprogramm für den Satellitenbetrieb mit gqrx_settrx [Sendeempfangs-Synchronisierung für QO100 in Funkamateur 12/2019. Aktualisiert fuer Python3] 1 zur Verfügung zu haben. gqrx_settrx hatte ich geschrieben um für QO-100 die Sende-Empfangsfrequenzen zu synchroniseren. Aus dem Programm heraus sollt es eine einfache Möglichkeit geben die QSOs zu loggen und dabei die aktuelle Frequenzen zu übernehmen.

Das Programm basiert auf rigctld aus dem Packet hamblib. Die hamlib muss installiert und für jedes Funkgerät muss ein rigtctld Prozess mit den passenden Parametern gestartet werden.

Das 7log basiert auf Python 3. Spezielle Pakete müssen nicht installiert werden.

Nach dem entpacken mit tar xzvf 7log_<version>.tgz befinden sich alle benötigten Dateien im Zielverzeichnis. Danach sollte ein symbolischer Link auf die 7log.py-Datei aus /usr/bin angelegt werden. Weiter Programme aus dieser Serie wie z.B. gqrx_settrx1 erwarten 7log an der Position. Der Link kann mit sudo ln -s <Pfad zu 7log.py> /usr/bin/7log angelegt werden.

Im entpackten Verzeichnis befindet sich im Unterverzeichnis config_template Dateien für die Präfixdatenbank und die Relaislisten. Sie können für erste Versuche in das lokale benutzerabhängige Konfigurationverzeichnis ~/.config/7log/ kopiert werden. Es ist zu empfehlen sie im Anschluss aus den später genannten Internetquellen zu aktualisieren.

ein anderer Speicherort für die Datenbank angegeben werden. Der Standard für den Speicherort ist in ~/.config/7log/7log.sqlite

Danach kann ein QSO gelogged werden. Jedes QSO beginnt mit dem Erkennen eines neuen Rufzeichens. Dieses schließt das Loggen des vorherigen QSOs ab, wenn alle benötigen Parameter vorhanden sind. D.h. es muss zumindest ein Call, die Frequenz und die Betriebsart (mode) angegeben sein. Wenn konfiguriert werden Frequenz und Mode vom Funkgerät abgefragt. Erfolgt keien Angabe der von Frequenz und Mode werden sie vom vorherigen QSO übernommen. Dieses gilt auch für den Repeater solange sich das Band nicht geändert hat.

Das Verhalten im Contestmodus unterscheidet sich hier und ist später beschrieben.

Datumsangaben müssen im ISO-Format 2021-12-31 angeben werden. Zeiten im Format 10:33[:ss] in UTC angegeben werden.

Wird kein RST angegeben, ist 59(9) die Standardvorbelegung. Es können auch alle Parameter für ein QSO mit einem Aufruf angegeben werden. Zu empfehlen ist mit Cursor Up in der bash einfach das letzte Kommando erneut anzuzeihen und dieses um die gewünschten Werte zu erweitern. Das ist in der Regel schneller als 7log erneut einzugeben.

Ist der Transceiver über die Hamlib angeschlossen oder belegt das aufrufende Programm die Frequenz über eine Umgebungsvariable vor (z.B.von gqrx_settrx), brauchen diese Werte nicht eingeben zu werden. Sonst wird die Betriebsart und die Frequenz vom vorherigem QSO übernommen und braucht nur bei einem Wechsel des Bandes oder der Betriebsart neu eingegeben zu werden.

Ist der Transceiver über die CAT/CI–Schnittstelle mit dem Computer verbunden und sind die qrz.com-Zugungsdaten gesetzt erfolgt der Eintrag eines QSOs in der Regel mit nur einem Aufruf

Die restliche Werte werden automatisch vom Funkgerät, qrz.com und aus der Relaisdatenbank übernommen.

Normalerweise erkennt 7log die Eingaben anhand von regulären Ausdrücken. Diese funktionieren aber bei einigen Sonderrufzeichen wie ON75AB nicht. Dann kann das Call über --call <call> oder per c:<call> angegeben werden.

Alle nicht erkannten Parameter werden in das Info/Kommetarfeld übernommen. Diese Werte können auch direkt mit

Da bei der Angabe von – Parametern, ist die Reihenfolge nicht mehr beliebig ist, besteht auch die Möglichkeit für bestimmte Felder diese durch eine Vorsatz genauer anzugeben. Das ist z.B. sinnvoll, wenn ich ein FT8 QSO loggen, will bei dem der Rapport nicht rst ist.

Ein nachträgliches Editieren ist durch den –update Befehl mit Angabe der internen QSO-Nummber möglich.

bei der Verwendung des nicht Standard-Funkgeräts kann für ein QSO das verwendeten Funkgerät angegeben werden.

Dieses ermöglicht die Angabe der verwendeten Station im Logfile und wird benötigt um z.B. einen speziellen Rotor anzusprechen.

Bei –update in Kombination mit –rig wird nur der angegeben Parameter in das Datenbankfeld übernommen. Es findet keine Anpassung des Antennenattributes statt.

Als weitere Funktion besteht die Möglichkeit den Standort einer Station aus dem Locator im Browser über openstreetmap anzuzeigen. Dazu muss ein Firefox oder ein chromium installiert sein. Starten Sie den Browser bevor sie diese Funktion verwenden.

Verwendung verschiedener Session

Möchte ich QSOs für einen Contest erfassen und gleichzeitig ein QSOs auf einer Ortsfrequenz loggen besteht die Möglichkeit in verschiedenen Session zu arbeiten. Dazu verwendet die Software eine Session ID. Diese ID wird in der folgenden Reihenfolge ermittelt.

Zuordnung der Frequenz zu einer Station

fragt für die aktuelle Frequenz des TRX ab welche Stationen dort vermerkt, sind, so dass nicht auf die Nennung des Rufzeichens gewartet werden muss.

Wird der TRX auf 432.210 gestellt, erfolgt die Ausgabe der Station und der erfassten Antennenrichtung, sowie der Zeitpunkt an dem der Marker gesetzt wurde.

Stationsdaten von qrz.com

Wird beim Loggen kein Namen angegeben, versucht 7log den Namen über qrz.com zu ermitteln. Die Information wird in der Datenbank abgelegt, so dass bei einem weiteren QSO nicht erneut bei qrz.com angefragt wird.

Mit einem bezahlten Accout bei qrz.com gibt es mehr Daten, sonst werden nur die einfachen Daten ausgegeben.

Länderinformationen CQ und ITU-Zone

Die CQ und ITU Zone der Gegenstation werden in die Datenbank unter dst_cqzone und dst_ituzone eingetragen. Dazu werden die Datenbanken von cqrlog AreaOK1RR.tbl und Contry.tab verwendet. Diese müssen in das Konfigurationsverzeichnis von 7log kopiert werden. Über 7log --area <call> kann die Information für ein beliebies Call abgefragt werden. Die Ausgabe ermittelt auch den Ländernamen zu dem Call. Sollte das Call einen Präfix haben, wie z.B. PA/DG7BBP, dann werden die Länderinformationen zu dem Präfix ausgegeben. Aktuelle Daten werden von durch OK2CGR bereit gestellt.

DX-Cluster Informationen

Mit 7log --grabcluster können die Daten eines Telnet DX-Clusters in die Datenbank übernommen werden. In der Datenbank werden die DX-Spots der letzten Stunde gespeichert. Dazu müssen in der Konfugartion hostname, port und login callsign angegeben sein.

Auf diese Daten kann mit 7log --who [<frequency>] [--rig <rigname>] zugegriffen. Für die aktuelle Frequenz (+/- 500Hz) des Transceivers oder der angegebenen Frequenz werden die gespotten Stationen ausgegeben.

Die gesammelten Informationen der letzten Stunde lassen sich pro Band mit 7log --dxcluster <band> abfragen. Die Bandangabe muss dabei z.b: in der Form 20m oder 70cm erfolgen.

Das aktuelle QSO kann mit 7log --spotqso "<comment>" an den DX-Cluster gesendet werden. Dabei werden Frequenz und Rufzeichen der Gegenstation uebernommen. Läuft der grabcluster-Prozess, so erfolgt das senden über diese Verbindung. Sonst wird eine Verbindung direkt aus der aufgerufenen Instanz erstellt die Verbindnung zum Cluster sofort wieder abgebaut.

Nachträgliches Erfassen von QSOs

QSO können auch die Angabe von Zeit und Datum später erfasst werden, z.b. weil man nur ein Papierlogbuch bei einer SOTA-Aktivität dabei hatte. Hier sollte vorher der eigene Standort und ggf. das eigene callsign z.B. um /P mit den folgenden Befehlen angepasst werden.

Im Anschluss können die QSOs erfasst werden. Hier gelten die normalen Eingaberegeln. Die Reihenfolge darf beliebig gewählt werden und es wird versucht anhand des Inhalts der einzelnen Parameter die Daten dem richtigen Attribut zuzuordnen.

Repeater

7log unterstuetzt Repeater-Datenbanken in Form der von DARC OV A23. für ICOM-Transceiver bereitgestellten Dateien. Diese Dateien müssen in ./config/7log/repeater kopiert werden. Achten sie darauf, dass jeweils nur die aktuelle Version der DV und FM-Liste eingespielt werden.

eine nach Entfernung sortierte Liste der Umsetzer ausgegeben werden. Die Eingabe der Frequenz muss in der gewohnten Form mit mit . als Dezimalpunkt und der Einheit erfolgen. Z.B. 438.875MHz.

Wird die Frequenz angeben wird als Ausgangspunkt der Stationslocator verwendet. Bei Eingabe des Locators werden alle Repeater in der Nähe des eingegeben Locators ausgegeben. Der maximale Radius sind hier 120km.

Beim Loggen eines QSOs wird auf Frequenzen > 29Mhz versucht das Feld für den Repeater automatisch auszufüllen, wenn der Repeater nicht mit r: oder –repeater angegeben wird. Dazu wird der nächste auf der angegeben Frequenz liegende Repeater verwendet.

Ist in der Repeaterliste kein Treffer vorhanden wird der Repeater vom vorherigen nur dann übernommen, wenn sich das Band nicht geändert hat. Dieses erspart beim Betrieb über einen Satelliten oder Lineartransponder die dauernde Eingabe der Umsetzers. Satelliten müssen in AMSAT-Bezeichnung eingeben werden z.B.: QO-100, damit bei der ADIF-Ausgabe die Felder passend belegt werden.

Die manuelle Eingabe eines Umsetzers erfolgt mit -r DB0WU, –repeater QO-100 oder r:DB0HFT.

Repeater-Namen, die eine Satelliten-Namen wie AO-91 oder QO-100 entsprechen werden beim ADIF-Export als Satelliten QSO betrachtet.

Rotorsteuerung

der Rotor in die gewünschte Richung per Angabe des Locators oder der Richtung in Grad gedreht werden.

ADIF-Export

LOTW scheint bestimmte Spezifikationen anders zu interpretieren, daher gibt es für LOTW eine eigenen Export mit:

Cloudlog export

QSOs können nach Cloudlog exportiert werden. Dazu werden die Adif-Daten mit der QSO API von cloudlog übertragen. dazu müssen die passenden cloudlog- Klonfigurationseinstellungen vorgenommen werden. Cloudlog besitzt eine Überprüfung für doppelte QSOs, daher kann ein QSO auch in verschiedenen Übertragungen enthalten sein.

Import

7log kann adif-Daten und Daten aus einer zweiten 7log Instanz importieren.Befehle hierfür sind:

Stationskonfiguration

Die Stationsbeschreibung erlaubt unterschiedliche Antennen für verschiedene Bänder, so dass in der QSL-Karte nur die 2m Antennen, aber nicht alle KW-Antennen für ein 2m QSO aufgeführt sind. Darüber hinaus sind in der Konfigurationsdatei die Adressen für die Trasnceiver und Rotorsteuerung über die hamblib-Prozesse rigctld bzw. rotctld einzutragen.

    {"ic705home": {"rigdesc": "IC 705 controlled by Raspberry PI",
                   "antenna": {"default": "Dipol 2 * 7m with BX 1200 tuner",
                               "2m": "X-5000",
                               "70cm": "X-5000"},
                   "rigctldhost": "localhost:4532",
                   "rotctldhost": "localhost:4533",
                   "freqoffset": 0.0},
    
    "QO100": {"rigdesc": "IC910 with Raspi and GQRX Upconverter: MKUUP2424B(4W out) Downconverter: AMSAT DL",
              "antenna": {"default": "1m offset dish 4 turns helix"},
              "rigctldhost": "",
              "freqoffset": 0.0},
    "ic705portable": {"rigdesc": "IC 705 controlled by Raspberry PI",
                      "antenna": {"default": "Triple leg for 20m -10m",
                              "40m": "Groundplane",
                              "80m": "Groundplane"},
                      "rigctldhost": "localhost:4532",
                      "freqoffset": 0.0},
    "23cm": {"rigdesc": "IC 705 + db6nt 13mk2 + PA 40W",
                        "antenna": {"default": "Flexa FX2317"},
                        "rigctldhost": "localhost:4532",
                        "rotctldhost": "localhost:4533",
                        "freqoffset": 1152.0e6}
    }

Contest-Modus

Im Contest-Modus muss die Eingabe eines QSOs immer in einer kompletten Zeile erfolgen. Sobald alle notwendigen Eingaben vorhanden sind, wird das QSO gespeichert und die nächste laufenden Nummer ausgegeben.

Für die Verwendung des Contestmodus muss zuerst ein Contest angelegt werden. Dieses erfolgt über

Es gibt Standard-Contestvorlagen, diese werden aus dem Programmverzeichnis aus der Datei contest.json gelesen.

~/.config/7log/contesttemplates.json abgelegt werden. Die die dort definierten Contestvorlagen überschreiben ggf. die Vorlage aus dem Programmverzeichnis, wenn sie unter demselben Namen abgelegt sind.

Contest-Vorlagen werden in einer JSON-Datei definiert. Die Standardconteste sind wie folgt definiert:

    {"DARC-XMAS-DL": {"number_per_band": false,
                      "number_scheme": "$(DOK)",
                      "required_attrs": ["src_call", 
                                        "dst_call",
                                        "band",
                                        "rst_send",
                                        "rst_received"],
                      "unique_station_attrs": ["src_call",
                                              "dst_call",
                                              "band"]},
     "DARC-XMAS-FOREIGN": {"number_per_band":false,
                           "number_scheme": "$(NUM)",
                           "required_attrs": ["src_call",
                                              "dst_call",
                                              "band",
                                              "rst_send",
                                              "rst_received"],
                           "unique_station_attrs": ["src_call",
                                                    "dst_call",
                                                    "band"]},
     "DARC-10M-DL": {"number_per_band": false,
                     "number_scheme": "$(NUM)$(DOK)",
                     "required_attrs": ["src_call",
                                        "dst_call",
                                        "band",
                                        "rst_send",
                                        "rst_received"],
                     "unique_station_attrs": ["src_call",
                                              "dst_call",
                                              "band"]},
     "DARC-10M-FOREIGN": {"number_per_band": false,
                          "number_scheme": "$(NUM)",
                          "required_attrs": ["src_call",
                                             "dst_call",
                                             "band",
                                             "rst_send",
                                             "rst_received"],
                          "unique_station_attrs": ["src_call",
                                                   "dst_call",
                                                   "band"]},
     "IARU-Region1-Fielday": {"number_per_band": false,
                           "number_scheme": "$(NUM)",
                           "required_attrs": ["src_call",
                                              "dst_call",
                                              "band",
                                              "rst_send",
                                              "rst_received"],
                           "unique_station_attrs": ["src_call",
                                                    "dst_call",
                                                    "band"]},
     "DARC-VUHF": {"number_per_band": true,
                   "number_scheme": "$(NUM)",
                   "required_attrs": ["src_call",
                                      "dst_call",
                                      "band",
                                      "rst_send",
                                      "rst_received",
                                      "dst_locator",
                                      "src_locator"],
                   "unique_station_attrs": ["src_call",
                                            "dst_call",
                                            "band"]}
    }

Eine besondere Bedeutung haben die $(<var>)-Felder. $(NUM) wird durch die laufende Nummer ersetzt. Andere Variablen werden als statisch für den Contest angesehen und bei der Neuanlage des Contests abgefragt, wie z.B. $(DOK).

Diese schaltet die aktuelle Session in den Contestmode. Wenn der Contestmode wieder aufgehoben werden soll, dann kann dieses mit dem einem leeren Contestname "" erfolgen.

Dabei werden nur die Nummern für die Bänder ausgegeben auf den schon ein QSO geführt wurde.

Zurzeit wird nur ein Contestexport im EDI Format für V/U/SHF-Conteste unterstützt.

edi template ist eine Datei mit den Basisdaten für den Auswerter des Contest enthalten. Darin sind Platzhalter für bestimmte Werte enthalten, die durch 7log ersetzt werden. Es bietet sich an die Namen z.b. nach Standort und CALL anzulegen. z.B. DG7BPP_JO43KB.editmpl

file_prefix wird verwendet um die erzeugten Dateinamen zu bilden. Der Dateinamen setzt sich aus <file_prefix>_<band>.edi zusammen. Es wird für jedes Band des Contests eine eigene Datei erzeugt.

Technische Hinweise

Die Daten sind in einer sqlite3-Datenbank gespeichert. Eigene Auswertungen können so einfach vorgenommen werden.

Für die Übergabe der Frequenz von einem aufrufenden Porgramm können die Umgebungsvariablen DG7BBP_LOG_QRG_RX und DG7BBP_LOG_QRG gesetzt werden.

Zusammearbeit mit anderen Programmen

7log wird auch von 7ft8alarm.py unterstützt und ermöglich hier WSJTX das direkte loggen in die 7log-Datenbank.

Rechtliches

Das Programm darf von Funkamateuren für den privaten Einsatz frei verwendet werden. Eine kommerzielle Nutzung ist ausgeschlossen.

Die Verwendung des Programms erfolgt auf eigene Gefahr. Der Autor übernimmt keine Haftung für irgendwelche Schäden, die durch die Verwendung des Programms entstehen.

7log - A command line logbook