Integración domótica HamQSL, gratuita y de código abierto
Propagación de radio HF y VHF para radioaficionados: flujo solar, índice K, bandas (N0NBH).
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
La propagación de radio HF y VHF en Gladys, para radioaficionados: los datos solares y terrestres y el estado de las bandas que Paul Herrman, N0NBH, publica en hamqsl.com: las cifras del famoso «solar banner» que aparece en tantas webs de radioaficionados.
Qué ofrece
- Un dispositivo «Propagación HF (HamQSL)»: flujo solar (SFI), número de manchas solares, índices K y A, clase de rayos X, velocidad del viento solar, Bz, ruido de fondo, campo geomagnético, el estado de cada grupo de bandas HF de día y de noche (80-40 m, 30-20 m, 17-15 m, 12-10 m: Mala, Regular o Buena), las aperturas VHF por aurora y por esporádica E (Es), y la hora de la última actualización de N0NBH.
- Un widget para el panel, la tabla de bandas: los índices principales en recuadros y, debajo, cada banda de día y de noche con un punto de color.
- Tres desencadenantes de escena: una banda pasa a buena, una tormenta geomagnética, una fulguración solar de clase M o X.
- Una acción de escena: el boletín de propagación en un solo texto, para enviarlo por mensaje o leerlo en voz alta.
Nada que comprar y ninguna cuenta: el feed es público. La integración solo lo lee.
Requisitos
- Gladys Assistant 5.1.0 o posterior (widgets, desencadenantes y acciones de escena).
- Acceso a internet desde Gladys hacia
www.hamqsl.com(HTTPS).
La integración se instala desde GitHub: Integraciones → Instalar desde GitHub, dirección
https://github.com/guim31/gladys-hamqsl.
Configuración
| Parámetro | Valor por defecto | Para qué sirve |
|---|---|---|
| Frecuencia de actualización | 1 hora | Cada cuánto se lee el feed: 30 minutos, 1, 2 o 3 horas. N0NBH lo actualiza aproximadamente una vez por hora y pide no leerlo con más frecuencia que cada 30 minutos. |
| Idioma de los textos | Francés | Nombres de las funciones (al crearlas) y textos enviados a las escenas y al dispositivo (campo geomagnético, boletín). |
Guarde y, a continuación, abra la pestaña Descubrir y cree el dispositivo. Sus valores llegan de inmediato.
Los nombres de las funciones quedan fijados al crear el dispositivo: cambie el idioma antes de crearlo, o elimine el dispositivo y vuelva a crearlo.
Dispositivo
Todas las funciones son de solo lectura y conservan su historial, salvo los textos.
| Función | Tipo en Gladys | Valores |
|---|---|---|
| Flujo solar (SFI) | Contador | Flujo solar en 10,7 cm, en unidades de flujo solar. Por encima de 100 se abren las bandas altas; por encima de 150 son excelentes. |
| Número de manchas solares | Contador | El número diario de manchas solares. |
| Índice K | Contador | De 0 a 9, planetario, cada 3 horas. 4 = activo, 5 o más = tormenta (G1 a G5). |
| Índice A | Contador | De 0 a 400, la media diaria de la actividad geomagnética. |
| Clase de rayos X | Texto | A, B, C, M o X y un número (B6.3): el flujo de rayos X del Sol. M y X perturban la HF en la cara iluminada. |
| Viento solar (km/s) | Velocidad | En km/s (la unidad va en el nombre: Gladys no tiene unidad km/s). |
| Bz (nT) | Contador | La componente norte-sur del campo magnético interplanetario, redondeada al nanotesla. Un Bz muy negativo favorece las tormentas y las auroras. |
| 80-40 m día … 12-10 m noche | Intensidad de la señal | 0 Mala, 1 Regular, 2 Buena. El panel las muestra como barras de antena (ninguna, 3 o 5 barras). |
| Ruido de fondo | Texto | El nivel de ruido esperado en HF, tal como lo escribe N0NBH (S1-S2). |
| Campo geomagnético | Texto | Tranquilo, inestable, activo, tormenta menor o mayor… en el idioma elegido. |
| Aurora VHF, Es Europa 6 m / 4 m / 2 m, Es Norteamérica 2 m | Estado de la entrada | 1 cuando N0NBH anuncia la apertura, 0 cuando la banda está cerrada. |
| Actualización N0NBH | Texto | Fecha y hora de los datos, en la zona horaria de Gladys. |
Un valor que N0NBH no publica («No Report») se omite: la función conserva su valor anterior, nunca un 0 falso. Es la propia integración la que actualiza el dispositivo; Gladys no lo consulta.
El índice K y las auroras figuran aquí tal como los da HamQSL, para la radio. Para seguir las auroras (previsión del Kp, alertas de aurora), consulte la integración gladys-astronomy, basada en los datos de la NOAA.
Widget del panel
Estado de las bandas HF: cuatro recuadros (flujo solar, índice K, índice A, rayos X) y, debajo, una línea por grupo de bandas y periodo, primero el día, con un punto verde (Buena), naranja (Regular) o rojo (Mala). El pie indica la fuente y la hora de la actualización de N0NBH, y un botón abre hamqsl.com.
Añádalo desde el editor del panel: Nuevo widget → HamQSL → Estado de las bandas HF. No tiene ningún parámetro.
Desencadenantes de escena
HamQSL: una banda pasa a buena. Un grupo de bandas pasa de Mala o Regular a Buena. Filtros: las
bandas (vacío = cualquiera) y día o noche (vacío = ambos). Variables: banda (80m_40m…), periodo (day,
night), banda y periodo en palabras, condición anterior, flujo solar, índice K y un resumen («Banda
30-20 m buena de día (SFI 115, K 2, A 19)»).
HamQSL: tormenta geomagnética. El índice K alcanza 4 o más, y luego cada vez que sube más durante el mismo episodio; el episodio termina cuando K baja de 4. Una tormenta que sube de K 5 a K 7 se dispara dos veces (K 5 y luego K 7); K 6 → 5 → 6 se dispara una sola vez. Filtro: los valores de K (K 4 = campo activo, K 5 a 9 = tormentas G1 a G5); para que solo se le avise de las tormentas, elija de K 5 a K 9. Variables: índice K, índice A, escala NOAA (G0 a G5), campo geomagnético en palabras, resumen.
HamQSL: fulguración solar M o X. La clase de rayos X sube a M o X (C → M, M → X, o de nuevo M tras una
lectura más tranquila). Filtro: la clase. Variables: clase (M, X), nivel (M2.1), resumen.
La primera lectura tras la instalación sirve de punto de partida: no dispara nada. Las referencias se guardan en el volumen de datos de la integración, de modo que un reinicio ni vuelve a disparar ni pasa por alto lo que haya cambiado entretanto.
Acción de escena
HamQSL: leer el boletín de propagación. Salidas:
text: por ejemplo «Propagación HF (N0NBH, 7:42): SFI 115, K 2, A 19, rayos X B6.3. Día: buena en 30-20 m, regular en 80-40 m y 17-15 m, mala en 12-10 m. Noche: buena en 80-40 m y 30-20 m, regular en 17-15 m, mala en 12-10 m.»;solar_flux,sunspots,k_index,a_index(números, vacíos cuando N0NBH no tiene valor) yxray(texto).
El feed solo se vuelve a leer si la última lectura es más antigua que la frecuencia de actualización. El botón Leer el feed ahora de la página de configuración da al instante los índices y las bandas buenas.
Ejemplos de escenas
- Boletín matinal: todos los días a las 7:30, «HamQSL: leer el boletín de propagación» y, a
continuación, enviar la salida
textpor Telegram o hacer que la lea un altavoz. - Los diez metros están abiertos: desencadenante «una banda pasa a buena», banda 12-10 m, día → notificación «¡10 m está abierta, hora de llamar CQ!» con la variable de resumen.
- Aviso de tormenta: desencadenante «tormenta geomagnética», de K 6 a K 9 → mensaje con el resumen, y un recordatorio para mirar hacia el norte por la noche si vive en una latitud alta.
- Apagón en el aire: desencadenante «fulguración solar M o X», clase X → una notificación que explica por qué las bandas HF se han quedado en silencio en la cara diurna.
Fuente de datos y condiciones de uso
Los datos proceden del feed XML público de N0NBH, https://www.hamqsl.com/solarxml.php, leído sin cuenta
ni clave, con un User-Agent que identifica esta integración. N0NBH lo actualiza aproximadamente una vez
por hora y pide leerlo como mucho cada 30 a 60 minutos: la integración lo lee cada hora por defecto, y
nunca con más frecuencia que cada 30 minutos (las acciones reutilizan la última lectura cuando es
suficientemente reciente).
Datos solares y terrestres por cortesía de Paul Herrman, N0NBH: hamqsl.com/solar.html. Gracias a él por este servicio, ofrecido a toda la comunidad de radioaficionados desde hace años.
El estado de las bandas es un modelo global que N0NBH calcula a partir de los índices: no se mide en su ubicación, ni para un trayecto concreto. Sin afiliación con HamQSL ni con N0NBH.
Solución de problemas
- «Feed de HamQSL inaccesible» en la página de configuración: Gladys no consigue llegar a
www.hamqsl.com. Compruebe el acceso a internet de Gladys; los últimos valores se conservan y la integración lo vuelve a intentar en cada intervalo. - «El feed de HamQSL no se ha actualizado desde hace N h»: el feed responde, pero N0NBH no lo ha actualizado desde hace más de 6 horas. No tiene que hacer nada: normalmente se restablece solo.
- Una función no muestra ningún valor: N0NBH publica «No Report» para ella (a veces el flujo solar, la E esporádica de Norteamérica…). Vuelve con el siguiente informe.
- Los nombres de las funciones están en el idioma equivocado: quedan fijados al crearlas. Cambie el idioma, elimine el dispositivo y vuelva a crearlo desde la pestaña Descubrir.
- Más detalles: los registros de la integración (Integraciones → HamQSL → Registros). Ponga la
variable de entorno
LOG_LEVELendebugpara ver cada lectura.
Límites
- El estado de las bandas es el del modelo global de N0NBH, actualizado cada hora: una apertura breve, una condición local o un trayecto concreto no aparecen en él.
- La clase de rayos X es el flujo en el momento de la lectura: una fulguración breve entre dos lecturas puede pasar desapercibida.
- El índice K es el planetario, cada 3 horas; para las previsiones de auroras, consulte gladys-astronomy.
- Solo los cuatro grupos HF y los cinco fenómenos VHF del feed: ni MUF (siempre «NoRpt» en el feed), ni foF2.
Parámetros de configuración
Estos son los parámetros que HamQSL te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Propagación HF | section | No | Lee el feed público de datos solares de N0NBH (HamQSL), sin cuenta: flujo solar, manchas, índices K y A, rayos X, viento solar y el estado de las bandas HF de día y de noche. Guarde y cree el dispositivo en la pestaña Descubrir. |
| Fuente | section | No | Datos solares y terrestres por cortesía de Paul Herrman, N0NBH (hamqsl.com). N0NBH calcula el estado de las bandas para todo el globo, no para su ubicación. Sin afiliación con HamQSL. |
| Frecuencia de actualización | select | No | N0NBH actualiza el feed aproximadamente una vez por hora y pide no leerlo con más frecuencia que cada 30 minutos. |
| Idioma de los textos | select | No | Nombres de las funciones (al crearlas) y textos enviados a las escenas. |
Cómo instalar HamQSL en Gladys
- En Gladys, abre Integraciones: HamQSL aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-hamqsl:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-hamqsl.
HamQSL requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
HamQSL es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación