From cae4685d1454bcd5e3032eca9b2b0860e965c6ea Mon Sep 17 00:00:00 2001 From: godax84 Date: Thu, 19 Dec 2024 09:14:03 -0800 Subject: [PATCH] Carregar ficheiros para "/" --- README.md | 130 +++++++++++++++++++++++++++++++++++++++++++++++ requirements.txt | 6 +++ 2 files changed, 136 insertions(+) create mode 100644 README.md create mode 100644 requirements.txt diff --git a/README.md b/README.md new file mode 100644 index 0000000..c66da8c --- /dev/null +++ b/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 diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..2c62dca --- /dev/null +++ b/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