Universal Serial Monitor

About the Project

The Universal Serial Monitor is a robust, lightweight, and cross-platform desktop application designed to facilitate the monitoring, logging, and analysis of serial data from embedded devices (ESP32, Arduino, Raspberry Pi, STM32). It was developed to support air quality monitoring research at the Federal University of Ceará (UFC).

Unlike standard serial monitors, this tool provides real-time stability metrics, automatic error detection (panics, resets), and persistent logging without requiring a heavy IDE installation.

Key Features

📊 Real-time Metrics: Monitors connection stability (jitter), idle time, and average message intervals.

💾 Dual Logging: Saves raw serial output to .txt and structured metrics to .csv automatically.

📈 Plotting: Integrated graphing tool to visualize stability and error accumulation over time.

🔍 Smart Filters: Automatically detects and counts keywords like "Panic", "Error", "Boot", and allows custom filters.

📡 TX Capability: Send commands to your device via serial interface.

🎨 Customization: Supports Dark Mode and English/Portuguese languages.

Quick Start Tutorial

1. Installation

No Python installation is required. Download the standalone executable directly:

⬇ Download Latest Version (.exe)

Hosted on GitHub. Safe to run.

2. Basic Usage

Connect: Plug your device (e.g., ESP32) into the USB port.
Select Port: Click the refresh button ↻ inside the app and select the COM port.
Baud Rate: Select or type your Baud Rate (default: 115200).
Start: Click Start. The RX LED will blink green indicating data reception.

3. Analyzing Data

Logs: Files are automatically saved in the configured folder with timestamps.
Charts: Click 📈 Charts to view the stability graph and error history generated from the CSV data.

Repository Structure

File organization for developers:

C:.
│   .gitignore                  # Git configuration files
│   LICENSE                     # GNU GPLv3 License text
│   monitor_config.json         # Stores user preferences
│   README.html                 # This project site
│   requirements.txt            # Project Dependencies
│   Universal Serial Monitor.py # Source code (Python)
│   Universal Serial Monitor.spec # PyInstaller spec
│   Universal Serial Monitor.exe  # 🚀 EXECUTABLE FILE

Sobre o Projeto

O Monitor Serial Universal é uma aplicação desktop robusta, leve e multiplataforma, projetada para facilitar o monitoramento, registro e análise de dados seriais de dispositivos embarcados (ESP32, Arduino, Raspberry Pi, STM32). Foi desenvolvido para apoiar pesquisas de monitoramento da qualidade do ar na Universidade Federal do Ceará (UFC).

Diferente de monitores seriais padrão, esta ferramenta fornece métricas de estabilidade em tempo real, detecção automática de erros (panics, resets) e registro persistente em arquivos, sem a necessidade de instalar uma IDE pesada.

Funcionalidades Principais

📊 Métricas em Tempo Real: Monitora estabilidade da conexão (jitter), tempo ocioso e intervalo médio entre mensagens.

💾 Log Duplo: Salva saída serial bruta em .txt e métricas estruturadas em .csv automaticamente.

📈 Gráficos: Ferramenta de plotagem integrada para visualizar estabilidade e acúmulo de erros ao longo do tempo.

🔍 Filtros Inteligentes: Detecta e conta automaticamente palavras-chave como "Panic", "Error", "Boot", permitindo filtros personalizados.

📡 Capacidade TX: Envie comandos para seu dispositivo via interface serial.

🎨 Personalização: Suporte a Modo Escuro (Dark Mode) e idiomas Inglês/Português.

Tutorial Rápido

1. Instalação

Nenhuma instalação de Python é necessária. Baixe o executável autônomo diretamente:

⬇ Baixar Última Versão (.exe)

Hospedado no GitHub. Seguro para executar.

2. Uso Básico

Conectar: Conecte seu dispositivo (ex: ESP32) na porta USB.
Selecionar Porta: Clique no botão de atualizar ↻ dentro do app e selecione a porta COM.
Baud Rate: Selecione ou digite a taxa de transmissão (padrão: 115200).
Iniciar: Clique em Iniciar. O LED RX piscará em verde indicando recebimento de dados.

3. Analisando Dados

Logs: Os arquivos são salvos automaticamente na pasta configurada com data e hora.
Gráficos: Clique em 📈 Gráficos para visualizar a estabilidade e histórico de erros gerados a partir do CSV.

Estrutura do Repositório

Organização dos arquivos para desenvolvedores:

C:.
│   .gitignore                  # Arquivos de configuração do Git
│   LICENSE                     # Texto da Licença GNU GPLv3
│   monitor_config.json         # Preferências do usuário
│   README.html                 # Este site do projeto
│   requirements.txt            # Dependências do Projeto
│   Universal Serial Monitor.py # Código fonte (Python)
│   Universal Serial Monitor.spec # Especificação do PyInstaller
│   Universal Serial Monitor.exe  # 🚀 ARQUIVO EXECUTÁVEL