EDC15 ECU Editor

Software para edição e análise de centralinas EDC15, desenvolvido em Python.

Funcionalidades Principais

• Visualização Multi-formato:

  • Vista de Mapas 2D/3D para análise visual de dados
  • Vista Hexadecimal para edição de baixo nível
  • Vista de Gráficos para análise de tendências
  • Ferramentas de zoom e navegação

• Edição de Mapas:

  • Edição direta de valores nos mapas
  • Suporte para múltiplos formatos de dados
  • Funcionalidade de desfazer/refazer
  • Validação de dados em tempo real
  • Suporte para diferentes tipos de mapas:
    • Mapas de Combustível
    • Mapas de Pressão
    • Mapas de Timing
    • Outros mapas específicos EDC15

• Análise de Dados:

  • Comparação de mapas
  • Visualização de diferenças
  • Análise gráfica de dados
  • Ferramentas de medição e estatísticas
  • Exportação de dados para análise externa

• Gestão de Ficheiros:

  • Backup automático dos ficheiros originais
  • Suporte para ficheiros binários (.BIN)
  • Sistema de salvaguarda de alterações
  • Validação de checksums
  • Verificação de integridade do ficheiro

Requisitos

• Python 3.9 ou superior
• Dependências principais:
  • PySide6 >= 6.5.0 (Interface gráfica)
  • NumPy >= 1.24.0 (Processamento numérico)
  • Matplotlib >= 3.7.0 (Visualização de gráficos)
  • Pandas >= 2.0.0 (Manipulação de dados)
  • Construct >= 2.10.0 (Parsing binário)
  • Hexdump >= 3.3 (Visualização hexadecimal)

Instalação

1. Criar ambiente virtual:

python -m venv venv

2. Ativar ambiente virtual:

• Windows:

venv\Scripts\activate

3. Instalar dependências:

pip install -r requirements.txt

Estrutura do Projeto

• src/ - Código fonte principal
  • core/ - Módulos principais para processamento de dados e lógica de negócio
    • edc15_definitions.py - Definições e estruturas de dados EDC15
    • edc15_maps.py - Implementação de mapas base
    • edc15p_maps.py - Mapas específicos EDC15P
    • file_handler.py - Gestão de ficheiros
    • file_comparison.py - Sistema de comparação
    • command.py - Sistema de comandos
    • project_manager.py - Gestão de projetos
  • gui/ - Interface gráfica e componentes visuais
    • main_window.py - Janela principal
    • map_viewer.py - Visualizador de mapas
    • hex_viewer.py - Editor hexadecimal
    • graph_viewer.py - Visualizador de gráficos
    • map_tools.py - Ferramentas de edição
    • map_comparison.py - Interface de comparação
    • map_selection_dialog.py - Seleção de mapas
    • map_manager_dialog.py - Gestão de mapas
  • main.py - Ponto de entrada da aplicação

Como Usar

1. Execute o programa:

python src/main.py

2. Funcionalidades disponíveis:
   • Abrir ficheiro binário (.BIN)
   • Selecionar e editar mapas
   • Visualizar dados em diferentes formatos
   • Comparar mapas
   • Guardar alterações
   • Exportar dados
   • Análise de checksums

Características Técnicas

• Suporte para múltiplos tipos de dados (float32, int16, etc.)
• Sistema de validação de checksums EDC15
• Backup automático antes de modificações
• Interface gráfica moderna com Qt6
• Processamento otimizado de dados com NumPy
• Visualização avançada com Matplotlib

Notas de Segurança

• É criado automaticamente um backup do ficheiro original antes de qualquer modificação
• Recomenda-se sempre verificar as alterações antes de gravar
• Utilize sempre uma cópia de segurança do ficheiro original
• Validação de checksums antes e depois das modificações
• Sistema de recuperação em caso de corrupção de dados

Contribuições

Contribuições são bem-vindas! Por favor, siga as boas práticas de desenvolvimento e documente todas as alterações.

Limitações Conhecidas

• Suporte atual apenas para EDC15 e EDC15P
• Alguns mapas específicos podem requerer validação manual
• Requer conhecimento técnico para edição segura