Carregar ficheiros para "/"

README.md

@@ -0,0 +1,130 @@
+# 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:
+```bash
+python -m venv venv
+```
+
+2. Ativar ambiente virtual:
+- Windows:
+```bash
+venv\Scripts\activate
+```
+
+3. Instalar dependências:
+```bash
+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:
+```bash
+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

requirements.txt

@@ -0,0 +1,6 @@
+PySide6>=6.5.0
+numpy>=1.24.0
+matplotlib>=3.7.0
+pandas>=2.0.0
+construct>=2.10.0
+hexdump>=3.3