Aller au contenu principal

Intégration domotique HamQSL, gratuite et open source

Intégration HamQSL pour Gladys Assistant

Propagation radio HF et VHF pour radioamateurs : flux solaire, indice K, état des bandes (N0NBH).

Voir sur GitHubToutes les intégrations

La propagation radio HF et VHF dans Gladys, pour les radioamateurs : les données solaires et terrestres et l'état des bandes que Paul Herrman, N0NBH, publie sur hamqsl.com — les chiffres du fameux « bandeau solaire » qu'on voit sur tant de sites de radioamateurs.

Ce que vous obtenez​

  • Un appareil « Propagation HF (HamQSL) » : flux solaire (SFI), nombre de taches solaires, indices K et A, classe des rayons X, vitesse du vent solaire, Bz, bruit de fond, champ géomagnétique, l'état de chaque groupe de bandes HF de jour et de nuit (80-40 m, 30-20 m, 17-15 m, 12-10 m : mauvaise, moyenne ou bonne), les ouvertures VHF par aurore et sporadique E (Es), et l'heure de la dernière mise à jour de N0NBH.
  • Un widget de tableau de bord, le tableau des bandes : les principaux indices en tuiles, puis chaque bande de jour et de nuit avec une pastille de couleur.
  • Trois déclencheurs de scène : une bande devient bonne, un orage géomagnétique, une éruption solaire de classe M ou X.
  • Une action de scène : le bulletin de propagation en un texte, à envoyer par message ou à lire à voix haute.

Rien à acheter, aucun compte : le flux est public. L'intégration ne fait que le lire.

Prérequis​

  • Gladys Assistant 5.1.0 ou plus récent (widgets, déclencheurs et actions de scène).
  • Un accès internet de Gladys vers www.hamqsl.com (HTTPS).

L'intégration s'installe depuis GitHub : Intégrations → Installer depuis GitHub, adresse https://github.com/guim31/gladys-hamqsl.

Configuration​

RéglagePar défautRôle
Fréquence de mise à jour1 heureRythme de lecture du flux : 30 minutes, 1, 2 ou 3 heures. N0NBH le met à jour environ une fois par heure et demande de ne pas le lire plus souvent que toutes les 30 minutes.
Langue des textesFrançaisNoms des fonctionnalités (à leur création) et textes envoyés aux scènes et à l'appareil (champ géomagnétique, bulletin).

Enregistrez, puis ouvrez l'onglet Découverte et créez l'appareil. Ses valeurs arrivent aussitôt.

Les noms des fonctionnalités sont figés à la création de l'appareil : changez la langue avant de le créer, ou supprimez-le et créez-le de nouveau.

Appareil​

Toutes les fonctionnalités sont en lecture seule et gardent leur historique, sauf les textes.

FonctionnalitéType dans GladysValeurs
Flux solaire (SFI)CompteurFlux solaire à 10,7 cm, en unités de flux solaire. Au-dessus de 100 les bandes hautes s'ouvrent ; au-dessus de 150 elles sont excellentes.
Nombre de taches solairesCompteurLe nombre de taches solaires du jour.
Indice KCompteur0 à 9, planétaire, toutes les 3 heures. 4 = actif, 5 et plus = orage (G1 à G5).
Indice ACompteur0 à 400, la moyenne quotidienne de l'activité géomagnétique.
Classe des rayons XTexteA, B, C, M ou X et un nombre (B6.3) : le flux de rayons X du Soleil. M et X perturbent la HF sur la face éclairée.
Vent solaire (km/s)VitesseEn km/s (l'unité est dans le nom : Gladys n'a pas d'unité km/s).
Bz (nT)CompteurLa composante nord-sud du champ magnétique interplanétaire, arrondie au nanotesla. Un Bz très négatif favorise orages et aurores.
80-40 m jour … 12-10 m nuitIntensité du signal0 mauvaise, 1 moyenne, 2 bonne. Le tableau de bord les affiche en barres d'antenne (aucune, 3 ou 5 barres).
Bruit de fondTexteLe niveau de bruit attendu en HF, tel que l'écrit N0NBH (S1-S2).
Champ géomagnétiqueTexteCalme, agité, actif, orage mineur ou majeur… dans la langue choisie.
Aurore VHF, Es Europe 6 m / 4 m / 2 m, Es Amérique du Nord 2 mÉtat de l'entrée1 quand N0NBH annonce l'ouverture, 0 quand la bande est fermée.
Mise à jour N0NBHTexteDate et heure des données, dans le fuseau horaire de Gladys.

Une valeur que N0NBH ne publie pas (« No Report ») est laissée de côté : la fonctionnalité garde sa valeur précédente, jamais un faux 0. L'appareil est rafraîchi par l'intégration elle-même ; Gladys ne l'interroge pas.

L'indice K et les aurores sont ici tels que les donne HamQSL, pour la radio. Pour observer les aurores (prévision du Kp, alertes aurores), voir l'intégration gladys-astronomy, fondée sur les données de la NOAA.

Widget de tableau de bord​

État des bandes HF : quatre tuiles (flux solaire, indice K, indice A, rayons X), puis une ligne par groupe de bandes et par période, le jour d'abord, avec une pastille verte (bonne), orange (moyenne) ou rouge (mauvaise). Le pied donne la source et l'heure de la mise à jour de N0NBH, et un bouton ouvre hamqsl.com.

Ajoutez-le depuis l'éditeur du tableau de bord : Ajouter un widget → HamQSL → État des bandes HF. Il n'a aucun réglage.

Déclencheurs de scène​

HamQSL : une bande devient bonne. Un groupe de bandes passe de mauvaise ou moyenne à bonne. Filtres : les bandes (vide = toutes) et jour ou nuit (vide = les deux). Variables : bande (80m_40m…), période (day, night), bande et période en clair, condition précédente, flux solaire, indice K, et un résumé (« Bande 30-20 m bonne de jour (SFI 115, K 2, A 19) »).

HamQSL : orage géomagnétique. L'indice K atteint 4 ou plus, puis chaque fois qu'il monte plus haut pendant le même épisode ; l'épisode se termine quand K redescend sous 4. Un orage qui monte de K 5 à K 7 déclenche deux fois (K 5, puis K 7) ; K 6 → 5 → 6 déclenche une fois. Filtre : les valeurs de K (K 4 = champ actif, K 5 à 9 = orages G1 à G5) ; pour n'être prévenu que des orages, choisissez K 5 à K 9. Variables : indice K, indice A, échelle NOAA (G0 à G5), champ géomagnétique en clair, résumé.

HamQSL : éruption solaire M ou X. La classe des rayons X monte à M ou X (C → M, M → X, ou de nouveau M après une lecture plus calme). Filtre : la classe. Variables : classe (M, X), niveau (M2.1), résumé.

La première lecture après l'installation sert de point de départ : elle ne déclenche rien. Les références sont gardées dans le volume de données de l'intégration : un redémarrage ne redéclenche rien et ne manque pas ce qui a changé entre-temps.

Action de scène​

HamQSL : lire le bulletin de propagation. Sorties :

  • text : par exemple « Propagation HF (N0NBH, 07:42) : SFI 115, K 2, A 19, rayons X B6.3. Jour : bonne sur 30-20 m, moyenne sur 80-40 m et 17-15 m, mauvaise sur 12-10 m. Nuit : bonne sur 80-40 m et 30-20 m, moyenne sur 17-15 m, mauvaise sur 12-10 m. » ;
  • solar_flux, sunspots, k_index, a_index (nombres, vides quand N0NBH n'a pas de valeur) et xray (texte).

Le flux n'est relu que si la dernière lecture est plus ancienne que la fréquence de mise à jour. Le bouton Lire le flux maintenant de la page de configuration donne aussitôt les indices et les bandes bonnes.

Exemples de scènes​

  • Bulletin du matin : chaque jour à 7 h 30, « HamQSL : lire le bulletin de propagation », puis envoyer la sortie text par Telegram, ou la faire lire par une enceinte.
  • Le 10 mètres est ouvert : déclencheur « une bande devient bonne », bande 12-10 m, jour → notification « Le 10 m est ouvert, à vos micros ! » avec la variable résumé.
  • Alerte orage : déclencheur « orage géomagnétique », K 6 à K 9 → message avec le résumé, et un rappel de regarder vers le nord la nuit si vous habitez à haute latitude.
  • Black-out sur l'air : déclencheur « éruption solaire M ou X », classe X → une notification qui explique pourquoi les bandes HF se sont tues côté jour.

Source des données et politique d'usage​

Les données viennent du flux XML public de N0NBH, https://www.hamqsl.com/solarxml.php, lu sans compte ni clé, avec un User-Agent qui nomme cette intégration. N0NBH le met à jour environ une fois par heure et demande de le lire au plus toutes les 30 à 60 minutes : l'intégration le lit toutes les heures par défaut, et jamais plus souvent que toutes les 30 minutes (les actions réutilisent la dernière lecture quand elle est assez récente).

Données solaires et terrestres offertes par Paul Herrman, N0NBH : hamqsl.com/solar.html. Merci à lui pour ce service, offert depuis des années à toute la communauté radioamateur.

L'état des bandes est un modèle global calculé par N0NBH à partir des indices : il n'est mesuré ni à votre position, ni pour une liaison donnée. Non affiliée à HamQSL ni à N0NBH.

Dépannage​

  • « Flux HamQSL injoignable » dans la page de configuration : Gladys n'arrive pas à joindre www.hamqsl.com. Vérifiez l'accès internet de Gladys ; les dernières valeurs sont gardées, et l'intégration réessaie à chaque intervalle.
  • « Le flux HamQSL n'a pas été mis à jour depuis N h » : le flux répond, mais N0NBH ne l'a pas mis à jour depuis plus de 6 heures. Rien à faire de votre côté : il revient en général de lui-même.
  • Une fonctionnalité n'a pas de valeur : N0NBH publie « No Report » pour elle (le flux solaire parfois, le sporadique E d'Amérique du Nord…). Elle revient avec le bulletin suivant.
  • Les noms des fonctionnalités ne sont pas dans la bonne langue : ils sont figés à la création. Changez la langue, supprimez l'appareil et créez-le de nouveau depuis l'onglet Découverte.
  • Plus de détails : les journaux de l'intégration (Intégrations → HamQSL → journaux). Réglez la variable d'environnement LOG_LEVEL sur debug pour voir chaque lecture.

Limites​

  • Les conditions sont celles du modèle global de N0NBH, mis à jour toutes les heures : une ouverture brève, une condition locale ou une liaison donnée n'y figurent pas.
  • La classe des rayons X est le flux au moment de la lecture : une éruption brève entre deux lectures peut passer inaperçue.
  • L'indice K est l'indice planétaire, toutes les 3 heures ; pour la prévision des aurores, voir gladys-astronomy.
  • Seuls les quatre groupes HF et les cinq phénomènes VHF du flux : pas de MUF (toujours « NoRpt » dans le flux), pas de foF2.

Paramètres de configuration​

Voici les paramètres demandés par HamQSL dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Propagation HFsectionNonLit le flux public de données solaires de N0NBH (HamQSL), sans compte : flux solaire, taches, indices K et A, rayons X, vent solaire et l'état des bandes HF de jour et de nuit. Enregistrez, puis créez l'appareil dans l'onglet Découverte.
SourcesectionNonDonnées solaires et terrestres offertes par Paul Herrman, N0NBH (hamqsl.com). L'état des bandes est calculé par N0NBH pour le globe entier, pas pour votre position. Non affiliée à HamQSL.
Fréquence de mise à jourselectNonN0NBH met le flux à jour environ une fois par heure, et demande de ne pas le lire plus souvent que toutes les 30 minutes.
Langue des textesselectNonNoms des fonctionnalités (à leur création) et textes envoyés aux scènes.

Comment installer HamQSL dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : HamQSL apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-hamqsl:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-hamqsl.

HamQSL nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

HamQSL est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le