JW-Serial

Estado actual: este README describe JW-Serial v1.2.0, incluyendo funciones virtuales por bloques, filtros de tramas, parser clave:valor, autoescalado vertical por tramo visible, escalas Y1/Y2 alineadas, capturas automáticas, plantillas, sesión persistente y flujo de release para Windows.

JW-Serial es una aplicación de escritorio para Windows orientada a lectura, visualización y documentación de datos por puerto serial. Está pensada para trabajar con microcontroladores, sensores, tarjetas electrónicas y sistemas embebidos durante pruebas cortas o sesiones largas de varias horas.

La aplicación combina un plotter en tiempo real, monitor serial, capturas PNG automáticas, exportación CSV, plantillas de configuración y registro de sesión.

Características Principales

• Lectura de datos por puerto serial y monitor serial integrado.
• Parser flexible para tramas numéricas CSV/TSV y tramas clave:valor.
• Filtros de tramas para aceptar solo ciertos textos/prefijos o rechazar líneas específicas.
• Plotter en tiempo real con múltiples gráficos.
• Variables físicas y virtuales configurables con nombre, color, estilo y grosor.
• Constructor visual de funciones por bloques para crear variables calculadas sin escribir sintaxis manual.
• Funciones con operadores, constantes y ventanas como actual, inicial, mínimo, máximo, promedio y |Max-Min|.
• Funciones calculadas sobre el historial completo de datos, no solo desde el momento en que se crean.
• Asignación de señales por drag and drop hacia X, Y1 o Y2.
• Menú contextual por gráfico para asignar, quitar y configurar señales rápidamente.
• Ejes X, Y1 y Y2 con modo automático y manual.
• Escalas canónicas para ejes y grillas legibles.
• Autoescalado Y1/Y2 sobre el tramo visible cuando X está en modo manual.
• Escala Y2 alineada visualmente con Y1 para evitar grillas superpuestas confusas.
• Capturas PNG manuales y automáticas de cada plot.
• Capturas funcionando incluso con la ventana minimizada.
• Nombres de captura con lote, prefijo, subcarpeta y contador anticolisión.
• Registro session_log.csv para documentar sesiones de prueba.
• Marcadores de eventos durante la adquisición.
• Cálculo de métricas de recepción desde el software: SPS, periodo y jitter.
• Modo claro y modo oscuro.
• Plantillas internas de configuración.
• Restauración configurable de la última sesión.
• Guardado y carga de configuración por archivo JSON.
• Exportación CSV de datos capturados.
• Instalador y versión portable para Windows.

Descarga

En la sección de releases de GitHub se publican dos opciones:

• JW-Serial-Setup-1.2.0-x64.exe: instalador para Windows.
• JW-Serial-Portable-1.2.0-x64.exe: versión portable, no requiere instalación.

Para la mayoría de usuarios, la versión portable es suficiente: descarga el ejecutable, ábrelo y conecta tu dispositivo serial.

Uso Rápido

1. Conecta tu placa o dispositivo serial al PC.
2. Abre JW-Serial.
3. Pulsa Refrescar para listar puertos disponibles.
4. Selecciona el puerto y el baudrate.
5. Pulsa Conectar.
6. Arrastra variables hacia un plot.
7. Asigna cada variable a X, Y1 o Y2.
8. Usa Capturar plots para guardar evidencia visual.
9. Usa CSV si necesitas exportar datos.

Formato Serial Soportado

JW-Serial espera líneas de texto separadas por salto de línea. Cada línea debe contener valores numéricos separados por coma o tabulador.

Ejemplo con coma:

12.3,45.6,78.9
12.4,45.8,78.7

Ejemplo con tabulador:

12.3	45.6	78.9
12.4	45.8	78.7

La aplicación detecta automáticamente si la trama usa coma o tabulador.

También puede leer tramas con pares clave:valor, separadas por coma. Esto permite trabajar con mensajes más descriptivos sin cambiar el firmware a un formato puramente numérico.

Ejemplo:

LORA_ADC:1409.96,RSSI:-29,SNR:12,FREQ:916.000

En este caso, JW-Serial detecta variables como LORA_ADC, RSSI, SNR y FREQ, y las deja disponibles para graficar, exportar o usar dentro de funciones virtuales.

Filtro de Tramas

Desde Configuración puedes definir filtros de lectura para evitar que líneas auxiliares contaminen el plotter.

Modos disponibles:

• Sin filtro: procesa todas las tramas que pueda interpretar.
• Aceptar solo: procesa únicamente las líneas que coincidan con los textos definidos.
• Rechazar solo: ignora las líneas que coincidan con los textos definidos y procesa el resto.

Ejemplo práctico:

Aceptar solo: LORA_
Rechazar solo: +EVT:

Esto es útil cuando el monitor recibe datos mezclados, por ejemplo tramas útiles LORA_ADC:... junto a mensajes automáticos del módulo como +EVT:RXP2P:....

Timestamp en X

Por defecto, JW-Serial puede usar el índice de muestra como eje X. Si tu firmware envía un timestamp como primer valor, puedes activar Incluye timestamp en X desde Configuración.

Ejemplo:

1250,3.31,7.52,0.14
1262,3.32,7.51,0.16

En ese caso, el primer valor puede usarse como X y los demás valores como variables.

Interfaz

La ventana principal está organizada en dos zonas: panel lateral y área principal.

Panel Lateral

Incluye:

• Estado de conexión.
• Selector de tema claro/oscuro.
• Puerto y baudrate.
• Botones de conexión.
• Métricas de recepción:
  • SPS calculados por el software.
  • Tiempo promedio entre muestras.
  • Jitter aproximado.
• Lista de variables detectadas.
• Acciones rápidas:
  • Configuración.
  • Pausar.
  • Limpiar buffer.
  • Exportar CSV.
  • Evento.
  • Capturar plots.
  • Configuración de capturas.
  • Guardar y cargar configuración.

Área Principal

Incluye:

• Vista Plotter.
• Vista Monitor.
• Botones para agregar o quitar plots.
• Gráficos con título, leyenda, ejes, grilla y controles de escala.

Plots y Asignación de Ejes

Cada plot puede trabajar con:

• Una variable en X.
• Una o más variables en Y1.
• Una o más variables en Y2.

Puedes asignar variables de varias formas:

• Arrastrando desde la lista de variables del panel lateral hacia el eje correspondiente.
• Soltando sobre el área del plot para que JW-Serial pregunte dónde asignarla.
• Usando el menú contextual del gráfico con click derecho.

En el menú contextual, las variables pueden arrastrarse hacia las zonas X, Y1 o Y2, lo que permite reasignar señales rápidamente sin recorrer toda la pantalla.

Curvas de Referencia

Desde el menú contextual de cada plot puedes activar curvas de referencia por señal:

• Promedio.
• Mínimo.
• Máximo.

La ventana de cálculo puede definirse por cantidad de muestras o por segundos.

Ejes y Escalas

JW-Serial usa pasos de escala legibles y consistentes, por ejemplo:

0.05, 0.1, 0.5, 1, 5, 10, 50, 100, 500

Los ejes pueden trabajar en modo automático o manual. En modo manual puedes desplazar la vista con la rueda del mouse o arrastrando sobre la zona correspondiente.

Cuando X está en modo manual y Y1/Y2 permanecen en automático, el autoescalado vertical se calcula sobre el tramo visible. Así puedes hacer zoom o desplazarte en X sin que valores antiguos, fuera de pantalla, sigan forzando la escala vertical.

Si Y2 está activo, su escala se adapta para quedar alineada visualmente con Y1 usando pasos canónicos. Esto evita que las subdivisiones de ambas grillas se superpongan con separaciones extrañas.

Capturas

JW-Serial puede guardar una imagen PNG de cada plot. Las capturas incluyen:

• Título del plot.
• Leyenda.
• Ejes.
• Grilla.
• Curvas visibles.

Las capturas pueden ser:

• Manuales, con Capturar plots.
• Manuales, desde la ventana Capturas con Capturar ahora.
• Automáticas, usando un intervalo configurable.

El botón Capturar plots también muestra el tiempo restante para la siguiente captura automática. Si las capturas automáticas están activadas pero el puerto está desconectado, la intención del usuario se conserva y el sistema espera hasta que el puerto vuelva a estar conectado.

Carpeta de Capturas

Desde Configurar capturas puedes:

• Elegir carpeta de salida.
• Abrir la carpeta configurada.
• Activar o desactivar capturas automáticas.
• Definir intervalo en minutos.
• Definir un identificador de tarjeta o lote.
• Usar ese identificador como prefijo.
• Guardar dentro de una subcarpeta con ese identificador.

Ejemplo usando subcarpeta:

Capturas/PCB_0116/Plot01_260510-120203-00.png
Capturas/PCB_0116/Plot02_260510-120204-00.png

Ejemplo usando prefijo:

PCB_0116_Plot01_260510-120203-00.png
PCB_0116_Plot02_260510-120204-00.png

Formato del nombre:

PlotXX_AAMMDD-HHMMSS-NN.png

Donde:

• XX: número de plot con dos dígitos.
• AAMMDD: fecha.
• HHMMSS: hora.
• NN: contador para evitar sobrescrituras si hay más de una captura en el mismo segundo.

Registro de Sesión

Cuando se usa identificador y subcarpeta, JW-Serial crea un archivo:

session_log.csv

Ese archivo registra eventos importantes de la sesión, como:

• Conexión.
• Desconexión.
• Capturas manuales.
• Capturas automáticas.
• Eventos agregados por el usuario.
• Métricas de recepción.

Esto ayuda a documentar pruebas largas y asociar capturas con momentos concretos.

Eventos

El botón Evento permite anotar sucesos durante una prueba.

Ejemplos:

Inicio de prueba
Se conectó carga
Lectura estabilizada
Se movió sensor
Fin de prueba

Los eventos se guardan en session_log.csv cuando la sesión está configurada con subcarpeta de lote.

Funciones Virtuales

La sección Funciones permite crear variables calculadas a partir de las variables reales recibidas por serial. Estas funciones aparecen como variables virtuales y se pueden arrastrar al plotter igual que cualquier señal física.

El editor usa bloques visuales para evitar errores de sintaxis. Puedes arrastrar:

• Operadores: suma, resta, multiplicación, división, potencia y valor absoluto.
• Ventanas: valor actual, valor inicial, mínimo, máximo, promedio y |Max-Min|.
• Constantes numéricas.
• Variables físicas detectadas desde la trama serial.

Ejemplo de validación de estabilidad:

abs(max([uV], 200s) - min([uV], 200s))

Ese cálculo genera una variable virtual con la diferencia absoluta entre el máximo y el mínimo de uV en una ventana de 200 segundos.

Las funciones recalculan el historial completo disponible, por lo que si creas una función después de haber adquirido datos, JW-Serial completa la curva desde el inicio del registro siempre que existan muestras suficientes.

Plantillas

Las plantillas guardan configuraciones reutilizables dentro de la app.

Pueden incluir:

• Configuración serial.
• Baudrate.
• Puerto seleccionado.
• Configuración de canales.
• Colores y nombres de variables.
• Plots creados.
• Asignaciones de ejes.
• Configuración de capturas.

No guardan:

• Datos recibidos.
• Buffer de muestras.
• Historial del monitor.

Las plantillas se guardan internamente en el perfil de usuario de Electron. En Windows, normalmente se ubican dentro del espacio de datos de la aplicación:

C:\Users\<usuario>\AppData\Roaming\JW-Serial

La ventana de plantillas muestra las plantillas existentes, por lo que no necesitas recordar los nombres exactos. Las acciones Guardar como y Eliminar piden confirmación antes de modificar una plantilla.

Configuración JSON

Además de las plantillas internas, JW-Serial permite guardar y cargar configuración como archivo .json.

Esto es útil para:

• Respaldar configuraciones.
• Compartir configuraciones entre PCs.
• Guardar una configuración junto con la documentación de un proyecto.

Modo Claro y Oscuro

JW-Serial incluye modo claro y modo oscuro. El modo oscuro está pensado para sesiones largas, pruebas nocturnas o ambientes de baja luz. El modo claro es útil para oficina, capturas limpias y documentación.

Recomendaciones Para Pruebas Largas

• Usa un identificador de lote, por ejemplo PCB_0116.
• Activa Guardar en subcarpeta.
• Activa capturas automáticas.
• Define un intervalo adecuado, por ejemplo 10 o 15 minutos.
• Agrega eventos cuando ocurra algo relevante.
• Al finalizar, revisa la carpeta del lote y el session_log.csv.

Desarrollo

Instalar dependencias:

npm install

Ejecutar en modo desarrollo:

npm run dev

Compilar renderer:

npm run build

Generar instalador y portable para Windows:

npm run dist:win

Los archivos generados se ubican en:

release/

Licencia

Este proyecto usa licencia MIT. Consulta el archivo LICENSE.

Notas de Release

El archivo RELEASE_NOTES_1.2.0.md contiene el texto preparado para pegar en New release de GitHub. Para publicar la versión usa el tag v1.2.0, el título JW-Serial v1.2.0 y adjunta el instalador/portable generados.