JPAM_NEO_Telemetry
La telemetría es una linea de desarrollo importante dentro de JPam_NEO. Su objetivo es poder registrar y visualizar datos reales del Timer durante las pruebas, para entender mejor que esta ocurriendo en vuelo y ayudar a validar cada nueva version.
En las primeras fases del proyecto, la telemetría se esta usando sobre todo como herramienta de diagnostico: comprobar RPM, revisar el comportamiento del governor, analizar la estabilidad de la senal y comparar lo que se programa en la app con lo que realmente ocurre en el Timer.
La herramienta tendra dos usos principales: telemetría en vivo para pruebas de laboratorio, puesta a punto y validacion, y visualizacion de logs ya creados para poder revisar vuelos o ensayos despues de realizarlos.
Con el tiempo, la idea es que esta herramienta vaya creciendo y pueda ser util en varias versiones de JPam_NEO, siempre separando claramente los datos de diagnostico de las ordenes de control del motor.
Esto no significa que todos los Timers JPam_NEO vayan a tener telemetría. Algunas versiones podrian existir en dos variantes, con y sin telemetría, y en ciertos casos podria ser necesario hardware externo al XIAO para recoger o transmitir los datos. Esa decision dependera de cada version, de su complejidad y de si la telemetría aporta una ventaja real sin complicar demasiado el sistema.
Para que sirve
- Ver datos reales recogidos durante las pruebas.
- Visualizar telemetría en vivo durante pruebas de laboratorio.
- Abrir y revisar logs guardados previamente.
- Analizar el comportamiento del motor, el ESC y el Timer.
- Comparar RPM, consigna y respuesta del sistema.
- Detectar problemas de configuracion o de comunicacion.
- Ayudar a validar nuevas versiones antes de publicarlas como estables.
Estado actual
Actualmente la telemetría ya forma parte del desarrollo de JPam_NEO_V4. Empezo como una herramienta interna para validar el governor por RPM, pero se mantiene como una herramienta de uso general para revisar vuelos y entender mejor el comportamiento del sistema.
En futuras fases se estudiara su uso en F2G_pro, V5 y otras versiones donde tenga sentido recoger datos de vuelo o diagnostico. En las versiones mas simples, la prioridad seguira siendo mantener el Timer facil de construir, configurar y usar.
La aplicacion de telemetría para Windows se publica como herramienta de apoyo y validacion. No debe entenderse todavia como un producto final ni como un manual cerrado de uso.
Descarga
Descarga el visor de telemetría para Windows en formato ZIP. Descomprime el archivo en una carpeta local y ejecuta jpam_neo_telemetry.exe.
Aviso de Windows
La descarga se distribuye en formato ZIP. Al descargarla o ejecutar la aplicacion, Windows o el navegador pueden mostrar un aviso de seguridad indicando que el archivo procede de internet.
Si aparece el aviso, revisa que el archivo se ha descargado desde esta pagina oficial antes de continuar.
Funciones principales
Esta aplicacion se divide en dos espacios de trabajo: Telemetría en vivo y Visualizador de vuelos. La primera sirve para ver y guardar datos mientras el Timer esta funcionando. La segunda sirve para abrir archivos .jpam ya guardados y revisar una sesion con calma.
Barra superior
Archivo: Agrupa las funciones relacionadas con sesiones guardadas. Desde aqui se puede abrir un archivo JPam, cerrar el archivo abierto o salir de la aplicacion.
Abrir archivo JPam: Permite seleccionar una grabacion .jpam y verla sin tener ningun Timer conectado. Al abrir el archivo, la aplicacion comprueba que el formato es valido y cambia al visualizador de vuelos.
Cerrar archivo: Cierra la grabacion abierta. No cierra la aplicacion ni afecta a una posible conexion de telemetría en vivo.
Ver: Permite cambiar entre Telemetría en vivo y Visualizador de vuelos. Esta accion no borra la sesion capturada ni desconecta el origen activo.
Herramientas: Queda reservado para ajustes generales de la aplicacion. En esta fase no es el punto principal de uso.
Ayuda: Incluye informacion de la aplicacion, version del visor y futuras ayudas de uso.
Selector de modo
Telemetría en vivo: Muestra los datos que llegan desde el Timer en tiempo real. Es el modo pensado para laboratorio, pruebas de motor, validacion de firmware y comprobacion de una configuracion antes o durante un ensayo.
Visualizador de vuelos: Abre y representa sesiones guardadas en formato .jpam. Permite revisar datos despues de la prueba, comparar lo que se esperaba con lo que realmente ocurrio y analizar el comportamiento del Timer sin tenerlo conectado.
Origen de datos
Simulador: Genera datos de ejemplo dentro de la propia aplicacion. Sirve para ver como se comporta la pantalla, comprobar la grafica y entender el flujo general sin conectar ningun hardware.
Puerto serie: Lee la telemetría conectando directamente el XIAO al ordenador por USB. Es una opcion pensada sobre todo para laboratorio, desarrollo y pruebas con el Timer sobre la mesa.
Puerto del XIAO: Aparece cuando se usa Puerto serie. Permite elegir el puerto COM donde Windows ha detectado el XIAO.
Actualizar puertos: Vuelve a buscar los puertos serie disponibles. Es util si el XIAO se ha conectado despues de abrir la aplicacion o si Windows ha cambiado el puerto asignado.
Wi-Fi: Escucha los datos enviados por el Timer a traves de la red WiFi propia del dispositivo. En V4 se usa para recibir telemetría en vivo sin cable USB durante pruebas de laboratorio o validacion. Para usar esta funcion, el XIAO genera una WiFi del tipo JPam_NEO_V4_XXXX, hay que conectar el Portatil o PC a esa WiFi, para recibir los datos.
Conexion y captura
Conectar: Abre la comunicacion con el origen seleccionado. En Puerto serie intenta abrir el puerto COM elegido. En WiFi queda a la espera de datos UDP del Timer. En Simulador inicia la generacion de datos de prueba.
Escuchar Wi-Fi: Aparece cuando el origen seleccionado es WiFi. Deja la aplicacion esperando las tramas que envie el Timer.
Iniciar simulacion: Aparece cuando se selecciona Simulador. Empieza a generar una sesion falsa para probar la visualizacion.
Desconectar / Detener simulador: Corta la comunicacion activa. La sesion capturada se conserva internamente para poder revisarla o guardarla antes de empezar otra.
Iniciar: Arma la sesion de laboratorio cuando el Timer ya esta identificado. La aplicacion no empieza a registrar datos utiles mientras el Timer este en estado seguro; el registro real comienza cuando el ciclo sale de SAFE.
Parar sesion: Detiene la captura activa sin tener que cerrar la conexion. Sirve para finalizar un ensayo y dejar la sesion lista para guardarla.
Limpiar grafica y datos: Borra la grafica y la sesion acumulada en pantalla. No esta pensado para guardar nada, sino para empezar una captura limpia.
Guardar sesion JPam: Guarda la captura en formato .jpam. El archivo conserva identidad del Timer, version de firmware, configuracion recibida, muestras, estados, errores y datos de telemetría disponibles.
Estado de conexion
Sin datos: Indica que no hay ninguna fuente activa o que todavia no se han recibido tramas.
Conectado, esperando identificacion: La comunicacion esta abierta, pero la aplicacion todavia no ha recibido una identidad valida del Timer.
Timer V4 identificado, listo para iniciar: El visor ha reconocido un Timer compatible y puede empezar una sesion.
Sesion armada, esperando arranque: La captura esta preparada, pero el Timer aun no ha iniciado el ciclo de vuelo.
Sesion de laboratorio activa: Ya se estan registrando datos utiles de la prueba.
Dispositivo no compatible: Se ha recibido identidad, pero no corresponde a una version compatible con este visor.
Estados del Timer: La barra puede mostrar fases como SEGURO, RETARDO, ACELERACION, VUELO ABIERTO, AVISO FINAL, BAJADA, PARADA RAPIDA, GOVERNOR, DEGRADADO o FALLO. Estos estados ayudan a situar cada dato dentro del ciclo real del Timer y dependera de la version del timer.
Estados degradado y fallo
DEGRADADO: Indica que el Timer ha podido continuar el ciclo, pero ya no esta trabajando en las condiciones ideales previstas. Por ejemplo, puede ocurrir si el sistema no consigue alcanzar la consigna de RPM dentro del limite de mando permitido. En ese caso, el Timer puede mantener el motor en un valor seguro o limitado, pero la telemetría debe dejar claro que el governor ya no esta corrigiendo como en funcionamiento normal.
FALLO: Indica que el firmware ha detectado una condicion mas critica y que la prueba debe considerarse no valida o detenida por seguridad. Puede aparecer por RPM demasiado bajas, RPM demasiado altas, perdida de telemetría de RPM, motor parado o configuracion invalida. En este estado, lo importante no es solo ver que ha fallado, sino poder revisar en la grafica que estaba ocurriendo justo antes del fallo.
Diferencia practica: DEGRADADO significa que el sistema ha salido del funcionamiento ideal pero puede seguir mostrando datos utiles. FALLO significa que se ha detectado una condicion que exige detener, revisar la configuracion o analizar la causa antes de repetir la prueba.
Avisos de fallo: Si el firmware informa de un fallo, la pantalla puede mostrar motivos como RPM inferiores al limite, RPM superiores al limite, perdida de telemetría RPM, motor parado o configuracion invalida.
Configuracion del vuelo
Retardo: Tiempo programado antes de que el motor empiece el ciclo despues de activar el Timer.
Vuelo: Duracion prevista del vuelo o de la prueba.
Objetivo: RPM objetivo que el sistema intenta mantener cuando trabaja en modo governor.
Motor: Valor KV configurado para el motor. Ayuda a contextualizar la respuesta esperada del conjunto motor, bateria y helice.
Polos: Numero de polos del motor configurado. Es necesario para interpretar correctamente las RPM a partir de la telemetría del ESC.
Bateria: Numero de celdas configuradas. Sirve para documentar con que alimentacion se ha realizado la prueba.
Rampa: Perfil de aceleracion usado por el Timer. Puede ser lenta, normal o rapida, segun la configuracion recibida.
Limite DShot: Limite maximo de mando permitido al ESC. Es una referencia importante para saber si el Timer ha llegado al techo de mando.
Cuadros de datos
RPM objetivo: Consigna de RPM que el Timer esta intentando mantener.
RPM medidas: RPM recibidas a partir de la telemetría DShot del ESC.
RPM opticas: RPM calculadas mediante lectura optica cuando esa informacion esta disponible. Permite comparar una medicion externa con las RPM que llegan desde el ESC.
Mando DShot: Valor de mando que el Timer esta enviando al ESC. Ayuda a ver cuanta potencia esta pidiendo el governor para sostener las RPM.
Tramas validas: Porcentaje de recepcion correcta. Sirve como referencia rapida de la calidad de la telemetría recibida.
Governor PI: Indica si el control de RPM esta activo o inactivo.
Error governor: Diferencia entre las RPM objetivo y las RPM medidas. Es una forma directa de ver cuanto se esta desviando el sistema de la consigna.
Correccion PI: Correccion calculada por el governor para compensar el error de RPM.
Punto de trabajo: Valor DShot base capturado por el firmware antes de conectar el governor. Sirve como referencia inicial sobre la que se aplican correcciones.
Termino proporcional: Parte proporcional del control PI. Solo aparece en modo Desarrollo.
Termino integral: Parte integral del control PI. Solo aparece en modo Desarrollo.
Salida PI final: Salida final calculada por el control antes de aplicarse como mando. Solo aparece en modo Desarrollo.
Grafica de RPM
RPM en tiempo real: Grafica principal durante la captura en vivo. Muestra la evolucion de la sesion mientras llegan datos.
RPM del vuelo: Grafica usada al abrir un archivo .jpam. Representa la sesion guardada completa.
RPM objetivo: Curva de referencia. Muestra la consigna que el Timer deberia seguir.
RPM medidas: Curva recibida desde DShot. Es la medida principal para evaluar el governor.
RPM opticas: Curva procedente de la medicion optica, cuando existe. Sirve como comprobacion independiente.
Leyenda de curvas: Cada nombre de la leyenda se puede activar o desactivar para mostrar u ocultar esa curva.
Zoom temporal: Permite ampliar la escala de tiempo para ver detalles de una zona concreta del vuelo.
Alejar / acercar / restablecer zoom: Botones para reducir, aumentar o volver a la vista completa de la sesion.
Cursor sobre la grafica: Al pasar el raton sobre la grafica, el visor toma la muestra mas cercana y muestra los valores exactos de ese instante.
Tiempo: Muestra el tiempo transcurrido de la muestra representada.
CRC y perdidas: En vistas avanzadas se muestran errores de comunicacion y tramas perdidas para diagnosticar la calidad de la recepcion.
Visualizador de vuelos
Archivo: Nombre del archivo .jpam abierto.
Formato: Version del formato JPam utilizado por ese archivo.
Creado por: Version del visor que genero la grabacion.
Fecha: Momento asociado a la sesion guardada.
Duracion: Tiempo total registrado en la sesion.
Muestras: Numero de muestras almacenadas.
Sesion: Selector disponible cuando un archivo contiene mas de una sesion.
Configuracion guardada: Muestra los parametros que quedaron registrados dentro del archivo. No dependen de que el Timer este conectado.
Perfiles de visualizacion
Basico: Esta pensado para lectura rapida. Prioriza RPM objetivo, RPM medidas, RPM opticas, configuracion del vuelo, estado del ciclo y avisos importantes. Oculta detalles internos para no sobrecargar al usuario.
Avanzado: Muestra todo lo anterior y anade informacion tecnica como mando DShot, calidad de recepcion, error del governor, correccion PI y punto de trabajo. Es el perfil adecuado para ajustar, diagnosticar y validar el comportamiento del sistema.
Desarrollo: Anade datos internos del control y del formato, como terminos proporcional e integral, salida PI final, secuencias, temporizacion y datos de validacion. Es una vista pensada para desarrollo interno y no tiene por que aparecer en las versiones publicas.