La página Diagnóstico y la API JSON
Todo lo que la estación sabe de sí misma, en una única página que se actualiza sola en /diagnostics, y los endpoints legibles por máquina que hay detrás de ella y de las demás páginas, para sus propios scripts y su propia monitorización.
La página se recarga sola cada dos segundos: cada recarga toma una nueva instantánea de las lecturas de la estación. No es una grabación continua. El enlace Datos JSON sin procesar de la parte superior ofrece el mismo contenido como un único documento: /api/status. Algunas filas solo aparecen cuando tienen algo que decir: si falta una fila de aviso, es que no ha ocurrido nada.
1. Estación
| Fila | Qué observar |
|---|---|
| Estación | El número local 8xxx, marcado como remoto cuando procede del archivo de configuración y como cuando es el 8000 predeterminado (capítulo 6). |
| Placa | La revisión de PCB y el PCB-Id, decodificados a partir de los puentes de la propia placa. |
| Firmware | La versión y la revisión exacta del código fuente, y si la imagen está confirmado o en prueba (capítulo 5). |
| ID del procesador | La clave de registro: indíquela al vincular la placa a una cuenta en la red de detección de rayos. Está grabada en el silicio; nunca cambia. |
| MAC | Se deriva del ID del procesador: es la dirección que debe buscar en la lista de clientes del router. |
| Detector | armado es lo normal; estabilizando corresponde a los primeros momentos tras el arranque o un reajuste. Desde el firmware v450, el detector también permanece desarmado durante la comprobación de retardo del arranque; durante ella no se envían informes de rayos. |
| Red de detección de rayos | Se muestra cuando el registro está habilitado: estación N una vez registrada y, si no, sin registrar, con una nota sobre el estado del registro. Las notas se explican en el capítulo 7. |
| Tiempo de actividad · Último reinicio | El tiempo de actividad por sí solo dice poco; la causa del reinicio (power-on, reset pin, software, watchdog, brownout …) indica si el último arranque fue previsto. Lo deseable es ver watchdog armado. |
| Boot journal | Qué imágenes se ejecutaron, durante cuánto tiempo y por qué se detuvo cada una, con las más recientes primero: el historial propio de la estación a través de los reinicios (capítulo 7). |
| Veredicto | La respuesta de estado en una línea: en palabras desde el firmware v440 (en buen estado, con problemas, arrancando, con los motivos que haya) y como código corto antes. Todos los estados y motivos, en ambas formas: capítulo 7. |
| MCU | Temperatura y tensión de alimentación del procesador. |
2. GNSS
Estado del posicionamiento, satélites en uso, posición y altitud (con el motivo cuando aún no hay altitud) y la sincronización del 1PPS. Filas que merecen una segunda mirada:
- Antena (en los receptores que lo informan): correcto, CORTOCIRCUITO o CIRCUITO ABIERTO, y si la alimentación de la antena está activado. CIRCUITO ABIERTO es normal con la antena pasiva estándar; solo CORTOCIRCUITO es un fallo. Si utiliza una antena externa con amplificador (antena activa), CIRCUITO ABIERTO significa que no recibe alimentación: revise su cable y su conector. Con la detección de circuito abierto desactivada (el valor predeterminado), la fila añade que «correcto» solo significa que no hay cortocircuito (capítulo 3).
- Etapa de entrada: los valores de AGC, ruido e interferencias intencionales del receptor. cerca del máximo significa que se recibe muy poca señal; por sí solo no identifica una interferencia. interferencia señala una lectura elevada de interferencias intencionales. La página GPS también distingue una medición de interferencias intencionales de no medido cuando el receptor no proporciona ninguna lectura.
- Temporizador, medido y Baudios, detectados: el temporizador de la estación contado frente al 1PPS y la velocidad a la que se encontró el receptor.
- Resincronizaciones del búfer circular / Resincronizaciones de UART: intervalos que el lector no pudo justificar. No es pérdida de datos: el simple hecho de servir esta página puede provocar una. (El contador que sí indica muestras perdidas es Adelantamientos del búfer circular, en la sección Detector, y debería marcar cero).
- Receiver TX queue (cuando se informa): bytes en cola, uso actual y uso máximo de la cola de mensajes salientes del receptor.
- Mensajes / errores y Capturas con marca de tiempo: cuánto ha transmitido el receptor y cuántas capturas obtuvieron una marca de tiempo disciplinada por satélite.
3. Detector
Desde el firmware v450, /api/status también incluye chain_delay, los resultados por entrada de la comprobación de retardo. Su state y sus máscaras de entrada distinguen entre una corrección medida, una alternativa de respaldo (una corrección nominal antes del firmware v482; desde v482 esa entrada usa el bypass) y la ausencia de un filtro en funcionamiento. También informa del estado de los reintentos automáticos de retardo, los intentos restantes y la espera antes de otra comprobación (capítulo 4). Los demás retardos de ruta son diagnósticos, no correcciones de la marca de tiempo.
Las lecturas en tiempo real de la cadena de medición: si el convertidor está funcionando, el canal y la ganancia total, la polaridad de cada entrada, los recuentos y tasas de disparos (por segundo y en 60 segundos), el estado de interferencia, el umbral en cuentas y en milivoltios, el código de ganancia, el ruido y la línea base, el mínimo y el máximo de la ventana, el rechazo y el seguimiento de tonos, y una familia de contadores que deberían mantenerse en cero o cerca de cero en un funcionamiento normal: adelantamientos del búfer circular, ventanas tardías, avances del lector, descartes de marca de tiempo, ventanas no utilizables y reinicios de ADC. Cada aviso se explica en el capítulo 7.
Hay otras lecturas disponibles en el JSON (/api/status): gain_writes, los cambios de ganancia que gain_auto ha aplicado desde el arranque (capítulo 6); gain_holds, los aumentos que ha dejado en espera después de que una subida volviera a bajar de inmediato; band_rejects, las partes de señales capturadas descartadas por el veto de banda, que permanece en 0 mientras band_pct está desactivado; hp_active, la frecuencia de corte del paso alto del detector realmente vigente, en Hz, o 0 mientras el filtro está desactivado (hp_hz a 0, o más de dos entradas habilitadas; capítulo 6); y, desde el firmware v482, clip_captures: para cada una de las entradas 1–4, cuántas capturas alcanzaron el límite del convertidor (recortadas). Un bucle de ganancia que ha convergido deja de escribir: un gain_writes que sigue subiendo es señal de oscilación; uno estable, señal de buen funcionamiento.
4. Participación en redes
Dentro de la sección Detector, la fila Red de detección de rayos permite al propietario de la estación elegir activar o desactivar. Muestra desactivado, activado o activado · aún sin colector cuando el registro no ha proporcionado un destino utilizable. Desde el firmware v482, la fila Denko indica siempre activa y no tiene botón: la estación siempre informa a Denko. Ambas redes están seleccionadas de forma predeterminada; una elección existente de abandonar la red opcional sigue vigente. La misma selección está disponible en la página de estación de Aurora y en el panel para el propietario de la estación o un administrador autorizado. Las elecciones locales se guardan en la placa; desde el firmware v482, un nuevo guardado del propietario en el panel se aplica en la siguiente consulta de configuración, aunque el valor seleccionado no haya cambiado, y una comprobación automática sin cambios conserva una elección local posterior. La fila Denko también muestra su destino y el número de paquetes. El firmware anterior a v482 también ofrece desactivar en la fila Denko y no toma la elección del panel. Los mensajes de fallo se explican en el capítulo 7.
5. Entradas del amplificador
Los resultados del último análisis de entradas (iniciado desde la página En tiempo real): el desplazamiento de cada entrada en mV y su ruido en cuentas, con las entradas desactivadas marcadas y el canal activo señalado. Es el diagnóstico que distingue un cielo tranquilo de una entrada sin componentes: síntomas idénticos, solución completamente distinta. Hasta el primer análisis, la sección indica nunca analizadas y remite al botón Analizar entradas de la página En tiempo real.
6. Configuración remota
Si la configuración remota funciona: consultas y fallos, cuántas claves aplicó el archivo y si hay una copia Guardado en flash (sin ella, un reinicio restablece los valores predeterminados). A continuación, cada ajuste, su valor actual y su procedencia (remoto o ): la misma lista que en el capítulo 6, sección 3.
7. Actualización de firmware
Lo que han encontrado las comprobaciones automáticas de actualización (capítulo 5): Comprobaciones del manifiesto cuenta las comprobaciones, cuántas tuvieron éxito o fallaron y hace cuánto se ejecutó la última; Último resultado y Resultados anteriores explican con palabras por qué cada comprobación inició o no una actualización. Se conservan a través de los reinicios, de modo que una placa que se ha reiniciado sigue indicando lo que ocurrió antes. Todos los resultados se enumeran en el capítulo 7. En una placa con la actualización automática desactivada, el resultado indica no habilitado (fw_seq es 0).
8. Red
El estado del enlace, la dirección y el prefijo con la puerta de enlace, el estado de DHCP y las concesiones obtenidas (explicados en el capítulo 7), la revisión del controlador Ethernet, los colectores que la estación ha aprendido con los contadores de paquetes de cada uno, y recuentos de tráfico de bajo nivel (tramas, respuestas ARP y ping, páginas servidas). Desde el firmware v482, Ethernet RX resets cuenta cuántas veces la estación ha reiniciado su receptor Ethernet tras un error de recepción o datos entrantes dañados; se recupera sola, y solo merece la pena informar de un recuento que crezca rápidamente. Un valor de Paquetes enviados que sube de forma constante durante una tormenta indica que la estación está enviando paquetes. No demuestra que el servicio receptor los haya aceptado ni que haya localizado rayos. La fila también informa de los paquetes retenido por send_gap y de los que hayan fallado.
9. Los endpoints JSON
Todas las páginas se basan en una pequeña API JSON, y puede usar los mismos endpoints desde sus propios scripts. Anteponga la dirección de la estación a cada uno, por ejemplo http://192.168.1.57/api/status. La tabla distingue las lecturas (GET) de las acciones (POST). Tras una acción, compruebe la respuesta de la estación y su estado actual.
| Endpoint | Método | Qué devuelve / hace |
|---|---|---|
/api/status | GET | Todo lo que aparece en la página Diagnóstico, más la configuración completa con la procedencia de cada clave. |
/api/gnss | GET | Satélites, DOP, PPS, identidad y capacidades del receptor: todo lo que aparece en la página GPS. |
/chain.json | GET | La lista de etapas de la cadena de señal, cada valor con su origen (capítulo 2). |
/api/scope | GET | Una instantánea continua de las entradas (la trama de la vista En tiempo real). |
/api/channels | GET | Una instantánea alineada de los cuatro canales; las entradas desactivadas no llevan muestras. |
/api/trig · /api/event | GET | La última ventana que el detector capturó y envió, con su historial previo al disparo. |
/api/captures · /api/capture/N | GET | La lista del historial de capturas (las últimas 32 capturas) y la forma de onda completa de una captura. |
/api/resp | GET | Resultados del último barrido de respuesta y de la última comprobación de ganancias y, desde el firmware v482, la temporización de la ganancia (capítulo 4). |
/api/alias | GET | Resultado del último análisis de alias. |
/api/delay | GET | Resultados por entrada de la comprobación de retardo: detección del filtro, retardos de ruta medidos y si una alternativa nominal proporciona la corrección. Desde el firmware v450 (capítulo 4). |
/api/sweep | POST | Solicita una captura de diagnóstico común de las cuatro entradas. m= selecciona qué entradas habilitadas mostrar; una máscara a cero u omitida usa las entradas habilitadas. |
/api/scan | POST | Inicia el análisis de entradas de los cuatro canales; los resultados aparecen en /api/status. Un análisis pausa la detección. |
/api/resp · /api/gaincheck · /api/alias | POST | Inician el barrido, la comprobación de ganancias y el análisis de alias. Los botones de la página Pruebas los utilizan. Desde el firmware v482, /api/resp también acepta clear=… para borrar los resultados guardados sin iniciar una prueba; esto requiere iniciar sesión (capítulo 4). |
/api/delay | POST | Pone en cola una nueva comprobación de retardo en las cuatro entradas. La detección se pausa durante la comprobación y se reanuda tras la estabilización. Consulte periódicamente con GET para saber cuándo termina; una solicitud aceptada no es una medición completada. Desde el firmware v450. |
/api/cfg | POST | Un parche de configuración en tiempo de ejecución (capítulo 6). |
/api/channels · /api/polarity | POST | Guardan la máscara local de entradas habilitadas (mask 0..15; 0 sigue a la flota) y la máscara de polaridad por entrada. |
/api/networks | POST | Cambia la participación en redes: líneas bo 0|1 (la red de detección de rayos). Desde el firmware v482, Denko está siempre activa y una línea denko 0 no la desactiva; el firmware anterior también acepta denko 0|1. |
/api/ota | POST | Busca una actualización de firmware ahora en lugar de esperar a la siguiente comprobación programada. No cambia nada de lo que se puede instalar, y se rechaza mientras la actualización automática está desactivada (fw_seq 0), mientras la imagen está en prueba, mientras hay una comprobación pendiente, mientras el actualizador de recuperación está ocupado o en los 60 segundos siguientes a la última solicitud aceptada. |
/api/reboot | POST | Solicita un reinicio. Durante una prueba de actualización, el reinicio espera a la confirmación o al plazo límite de la prueba. |
Los controles de inicio de sesión también usan GET /auth/state y POST /auth/login, /auth/session y /auth/logout. Use la ventana de inicio de sesión de la estación como se describe en el capítulo 6. La conversión de firmware usa POST /api/stockprepare, GET /api/stockready, POST /api/stock y POST /api/stockcommit; para estas acciones, siga el procedimiento de la página Firmware.
Las ventanas de muestras son cadenas hexadecimales, tres caracteres por cada muestra de 12 bits. Una cuenta equivale a unos 0.79 mV en el convertidor; divida por la ganancia para referir un valor a la antena.