HamQSL Smart-Home-Integration, kostenlos und Open Source
KW- und UKW-Ausbreitung für Funkamateure: solarer Flux, K-Index, Bandzustände (N0NBH, HamQSL).
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
KW- und UKW-Ausbreitung in Gladys, für Funkamateure: die Sonnen- und Erddaten und die Bandzustände, die Paul Herrman, N0NBH, auf hamqsl.com veröffentlicht – die Werte des bekannten „Solar-Banners“, das du auf so vielen Amateurfunk-Websites siehst.
Was du bekommst
- Ein Gerät „KW-Ausbreitung (HamQSL)“: solarer Flux (SFI), Sonnenfleckenzahl, K- und A-Index, Röntgenklasse, Geschwindigkeit des Sonnenwinds, Bz, Grundrauschen, Erdmagnetfeld, der Zustand jeder KW-Bandgruppe bei Tag und bei Nacht (80-40 m, 30-20 m, 17-15 m, 12-10 m: Schlecht, Mittel oder Gut), UKW-Aurora und Sporadic-E-Öffnungen (Es) sowie die Uhrzeit der letzten N0NBH-Aktualisierung.
- Ein Dashboard-Widget, die Bandtabelle: die wichtigsten Indizes als Kacheln, dann jedes Band bei Tag und bei Nacht mit einem farbigen Punkt.
- Drei Szenen-Auslöser: ein Band wird gut, ein geomagnetischer Sturm, eine Sonneneruption der Klasse M oder X.
- Eine Szenen-Aktion: der Ausbreitungsbericht als ein Text, den du als Nachricht senden oder vorlesen lassen kannst.
Nichts zu kaufen und kein Konto nötig: Der Feed ist öffentlich. Die Integration liest ihn nur.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer (Widgets, Szenen-Auslöser und -Aktionen).
- Internetzugang von Gladys zu
www.hamqsl.com(HTTPS).
Die Integration wird von GitHub installiert: Integrationen → Von GitHub installieren, Adresse
https://github.com/guim31/gladys-hamqsl.
Konfiguration
| Einstellung | Standard | Was sie bewirkt |
|---|---|---|
| Aktualisierungsintervall | 1 Stunde | Wie oft der Feed gelesen wird: 30 Minuten, 1, 2 oder 3 Stunden. N0NBH aktualisiert ihn etwa einmal pro Stunde und bittet, ihn höchstens alle 30 Minuten zu lesen. |
| Sprache der Texte | Französisch | Namen der Funktionen (bei ihrer Erstellung) und Texte, die an die Szenen und das Gerät gehen (Erdmagnetfeld, Bericht). |
Speichere, öffne dann den Tab „Entdecken“ und lege das Gerät an. Seine Werte kommen sofort an.
Die Namen der Funktionen werden beim Anlegen des Geräts festgelegt: Ändere die Sprache bevor du es anlegst, oder lösche das Gerät und lege es neu an.
Gerät
Alle Funktionen sind schreibgeschützt und speichern ihren Verlauf, außer den Texten.
| Funktion | Typ in Gladys | Werte |
|---|---|---|
| Solarflux (SFI) | Zähler | Solarflux bei 10,7 cm, in Solar Flux Units. Über 100 öffnen sich die hohen Bänder, über 150 sind sie hervorragend. |
| Sonnenfleckenzahl | Zähler | Die tägliche Sonnenfleckenzahl. |
| K-Index | Zähler | 0 bis 9, planetar, alle 3 Stunden. 4 = aktiv, ab 5 = Sturm (G1 bis G5). |
| A-Index | Zähler | 0 bis 400, der Tagesmittelwert der geomagnetischen Aktivität. |
| Röntgenklasse | Text | A, B, C, M oder X und eine Zahl (B6.3): der Röntgenfluss der Sonne. M und X stören KW auf der sonnenbeschienenen Seite. |
| Sonnenwind (km/s) | Geschwindigkeitssensor | In km/s (die Einheit steht im Namen: Gladys hat keine Einheit km/s). |
| Bz (nT) | Zähler | Die Nord-Süd-Komponente des interplanetaren Magnetfelds, auf Nanotesla gerundet. Ein stark negatives Bz begünstigt Stürme und Polarlichter. |
| 80-40 m Tag … 12-10 m Nacht | Signalstärke | 0 Schlecht, 1 Mittel, 2 Gut. Das Dashboard zeigt sie als Antennenbalken (keiner, 3 oder 5 Balken). |
| Grundrauschen | Text | Der erwartete Rauschpegel auf KW, so wie N0NBH ihn angibt (S1-S2). |
| Erdmagnetfeld | Text | Ruhig, unruhig, aktiv, leichter oder starker Sturm … in der gewählten Sprache. |
| UKW-Aurora, Es Europa 6 m / 4 m / 2 m, Es Nordamerika 2 m | Status des Eingangs | 1, wenn N0NBH die Öffnung meldet, 0, wenn das Band geschlossen ist. |
| N0NBH-Aktualisierung | Text | Datum und Uhrzeit der Daten, in der Zeitzone von Gladys. |
Einen Wert, den N0NBH nicht veröffentlicht („No Report“), lässt die Integration weg: Die Funktion behält ihren vorherigen Wert, nie eine falsche 0. Das Gerät wird von der Integration selbst aktualisiert; Gladys fragt es nicht ab.
Der K-Index und die Polarlichter stehen hier so, wie HamQSL sie liefert, für den Funkbetrieb. Für die Polarlichtbeobachtung (Kp-Vorhersage, Polarlicht-Warnungen) siehe die Integration gladys-astronomy, die auf den NOAA-Daten basiert.
Dashboard-Widget
KW-Bandzustände: vier Kacheln (solarer Flux, K-Index, A-Index, Röntgen), dann eine Zeile pro Bandgruppe und Zeitraum, zuerst der Tag, mit einem grünen (Gut), orangen (Mittel) oder roten (Schlecht) Punkt. Die Fußzeile nennt die Quelle und die Uhrzeit der N0NBH-Aktualisierung, und ein Button öffnet hamqsl.com.
Füge es im Dashboard-Editor hinzu: Neues Widget → HamQSL → KW-Bandzustände. Es hat keine Einstellung.
Szenen-Auslöser
HamQSL: ein Band wird gut. Eine Bandgruppe wechselt von Schlecht oder Mittel zu Gut. Filter: die
Bänder (leer = beliebig) und Tag oder Nacht (leer = beides). Variablen: Band (80m_40m…), Zeitraum
(day, night), Band und Zeitraum ausgeschrieben, vorheriger Zustand, solarer Flux, K-Index und
eine Zusammenfassung („Band 30-20 m tagsüber gut (SFI 115, K 2, A 19)“).
HamQSL: geomagnetischer Sturm. Der K-Index erreicht 4 oder mehr, dann jedes Mal, wenn er in derselben Episode weiter steigt; die Episode endet, wenn K unter 4 fällt. Ein Sturm, der von K 5 auf K 7 steigt, löst zweimal aus (K 5, dann K 7); K 6 → 5 → 6 löst einmal aus. Filter: die K-Werte (K 4 = aktives Feld, K 5 bis 9 = Stürme G1 bis G5); willst du nur bei Stürmen benachrichtigt werden, wähle K 5 bis K 9. Variablen: K-Index, A-Index, NOAA-Skala (G0 bis G5), Erdmagnetfeld ausgeschrieben, Zusammenfassung.
HamQSL: Sonneneruption M oder X. Die Röntgenklasse steigt auf M oder X (C → M, M → X oder
erneut M nach einer ruhigeren Messung). Filter: die Klasse. Variablen: Klasse (M, X), Stärke
(M2.1), Zusammenfassung.
Die erste Messung nach der Installation ist der Ausgangspunkt und löst nichts aus. Die Referenzwerte werden im Datenvolume der Integration gespeichert, sodass ein Neustart weder erneut auslöst noch verpasst, was sich in der Zwischenzeit geändert hat.
Szenen-Aktion
HamQSL: Ausbreitungsbericht lesen. Ausgaben:
text: zum Beispiel „KW-Ausbreitung (N0NBH, 07:42): SFI 115, K 2, A 19, Röntgen B6.3. Tag: gut auf 30-20 m, mittel auf 80-40 m und 17-15 m, schlecht auf 12-10 m. Nacht: gut auf 80-40 m und 30-20 m, mittel auf 17-15 m, schlecht auf 12-10 m.“;solar_flux,sunspots,k_index,a_index(Zahlen, leer, wenn N0NBH keinen Wert hat) undxray(Text).
Der Feed wird nur dann erneut gelesen, wenn die letzte Messung älter als das Aktualisierungsintervall ist. Der Button „Feed jetzt lesen“ auf der Konfigurationsseite zeigt sofort die Indizes und die guten Bänder.
Beispielszenen
- Morgenbericht: jeden Tag um 7:30 „HamQSL: Ausbreitungsbericht lesen“, dann die Ausgabe
textper Telegram senden oder von einem Lautsprecher vorlesen lassen. - Zehn Meter sind offen: Auslöser „ein Band wird gut“, Band 12-10 m, Tag → Benachrichtigung „10 m ist offen, Zeit für CQ!“ mit der Variable Zusammenfassung.
- Sturmwarnung: Auslöser „geomagnetischer Sturm“, K 6 bis K 9 → Nachricht mit der Zusammenfassung und dem Hinweis, nachts nach Norden zu schauen, wenn du in hohen Breiten wohnst.
- Funkstille: Auslöser „Sonneneruption M oder X“, Klasse X → eine Benachrichtigung, die erklärt, warum die KW-Bänder auf der Tagseite verstummt sind.
Datenquelle und Nutzungsbedingungen
Die Daten stammen aus dem öffentlichen XML-Feed von N0NBH, https://www.hamqsl.com/solarxml.php,
gelesen ohne Konto oder Schlüssel, mit einem User-Agent, der diese Integration nennt. N0NBH
aktualisiert ihn etwa einmal pro Stunde und bittet, ihn höchstens alle 30 bis 60 Minuten zu lesen:
Die Integration liest ihn standardmäßig jede Stunde und nie öfter als alle 30 Minuten (die Aktionen
verwenden die letzte Messung, wenn sie aktuell genug ist).
Sonnen- und Erddaten mit freundlicher Genehmigung von Paul Herrman, N0NBH: hamqsl.com/solar.html. Danke an ihn für diesen Dienst, den er seit Jahren der ganzen Amateurfunk-Community anbietet.
Die Bandzustände sind ein globales Modell, das N0NBH aus den Indizes berechnet: gemessen werden sie weder an deinem Standort noch für eine bestimmte Strecke. Nicht mit HamQSL oder N0NBH verbunden.
Fehlerbehebung
- „HamQSL-Feed nicht erreichbar“ auf der Konfigurationsseite: Gladys erreicht
www.hamqsl.comnicht. Prüfe den Internetzugang von Gladys; die letzten Werte bleiben erhalten, und die Integration versucht es bei jedem Intervall erneut. - „Der HamQSL-Feed wurde seit N h nicht aktualisiert.“: Der Feed antwortet, aber N0NBH hat ihn seit mehr als 6 Stunden nicht aktualisiert. Du musst nichts tun: Meist kommt er von selbst zurück.
- Eine Funktion zeigt keinen Wert: N0NBH veröffentlicht für sie „No Report“ (manchmal beim solaren Flux, beim E-Skip in Nordamerika …). Der Wert kommt mit dem nächsten Bericht zurück.
- Die Namen der Funktionen sind in der falschen Sprache: Diese werden beim Anlegen festgelegt. Ändere die Sprache, lösche das Gerät und lege es im Tab „Entdecken“ neu an.
- Mehr Details: die Protokolle der Integration (Integrationen → HamQSL → Protokolle). Setze die
Umgebungsvariable
LOG_LEVELaufdebug, um jede Messung zu sehen.
Grenzen
- Die Zustände stammen aus dem globalen Modell von N0NBH, stündlich aktualisiert: Eine kurze Öffnung, lokale Bedingungen oder eine bestimmte Strecke sind darin nicht enthalten.
- Die Röntgenklasse ist der Fluss zum Zeitpunkt der Messung: Eine kurze Eruption zwischen zwei Messungen kann übersehen werden.
- Der K-Index ist der planetare, alle 3 Stunden; für Polarlichtvorhersagen siehe gladys-astronomy.
- Nur die vier KW-Gruppen und die fünf UKW-Phänomene des Feeds: keine MUF (im Feed immer „NoRpt“), keine foF2.
Konfigurationseinstellungen
Diese Einstellungen fragt HamQSL in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| KW-Ausbreitung | section | Nein | Liest den öffentlichen Sonnendaten-Feed von N0NBH (HamQSL), ohne Konto: solarer Flux, Sonnenflecken, K- und A-Index, Röntgenstrahlung, Sonnenwind und die KW-Bandzustände bei Tag und Nacht. Speichere und lege dann das Gerät im Tab „Entdecken“ an. |
| Quelle | section | Nein | Sonnen- und Erddaten mit freundlicher Genehmigung von Paul Herrman, N0NBH (hamqsl.com). Die Bandzustände berechnet N0NBH für den ganzen Globus, nicht für deinen Standort. Nicht mit HamQSL verbunden. |
| Aktualisierungsintervall | select | Nein | N0NBH aktualisiert den Feed etwa einmal pro Stunde und bittet, ihn höchstens alle 30 Minuten zu lesen. |
| Sprache der Texte | select | Nein | Namen der Funktionen (bei ihrer Erstellung) und Texte, die an die Szenen gehen. |
So installierst du HamQSL in Gladys
- Öffne in Gladys Integrationen: HamQSL erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-hamqsl:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-hamqsl.
HamQSL benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
HamQSL ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation