4.3 KiB
4.3 KiB
GRIFO M-PBIT Test Environment - Documentazione Tecnica Completa
Versione: 1.0
Data: Febbraio 2026
Autore: Test Automation Team
Progetto: GrifoAutomaticTestEnv - Sistema di Test Automatico per Radar GRIFO
📚 Indice Documentazione
01 - Introduzione e Overview del Sistema
- Scopo del progetto
- Architettura generale
- Componenti principali
- Requisiti di sistema
- Flusso di utilizzo tipico
- Vantaggi e limitazioni
02 - Architettura Software e Moduli
- Struttura delle directory
- Moduli core (leo_grifo_*)
- Dipendenze e interfacce
- Diagramma delle relazioni
- API comuni
03 - Script Principale GRIFO_M_PBIT.py
- Struttura del codice
- Flusso di esecuzione
- Funzioni principali
- Gestione degli stati
- Ciclo di vita del test
04 - Sistema di Test - Workflow e Logica
- Ciclo di test completo
- Scenari di test (Random, Recycle, TgtGen, ecc.)
- Test B6 e B8 (messaggi 1553)
- Test seriale e messaggi terminale
- Test rilevamento target
05 - Modalità di Esecuzione
- Modalità Hardware (--target)
- Modalità Simulazione (--simulate)
- Sistema Mock e Test Senza Hardware
- Parametri di configurazione
- Launcher scripts
06 - Interfaccia Grafica (GUI Real-Time)
- Architettura GUI
- Aggiornamenti thread-safe
- Visualizzazione live dei risultati
- Tabella run e statistiche
- Tooltip e interazioni
07 - Output e Report
- Report PDF (struttura e formato)
- File CSV statistiche
- File JSON dati completi
- Naming convention e organizzazione
- Esempi di output
08 - Configurazione e Personalizzazione
- File di configurazione
- Scenari personalizzati
- Known failures
- Parametri di test
- Customizzazione scenari
09 - Integrazione Hardware
- Interfaccia 1553 (SWIG bindings)
- Controllo seriale
- Power control (BrainBox)
- Gestione errori hardware
- Protocolli di comunicazione
10 - Best Practices e Troubleshooting
- Guida all'uso
- Problemi comuni e soluzioni
- Log e debugging
- Manutenzione
- FAQ
📖 Come Usare Questa Documentazione
Per Nuovi Utenti
- Inizia da Capitolo 01 per comprendere l'architettura generale
- Prosegui con Capitolo 05 per eseguire il primo test
- Consulta Capitolo 10 per problemi comuni
Per Sviluppatori
- Leggi Capitolo 02 per capire la struttura del codice
- Approfondisci Capitolo 03 per il workflow interno
- Consulta Capitolo 09 per interfacce hardware
Per Test Engineers
- Inizia da Capitolo 04 per capire i test
- Leggi Capitolo 08 per personalizzare scenari
- Consulta Capitolo 07 per interpretare i risultati
🔄 Stato Documentazione
| Capitolo | Stato | Data Completamento |
|---|---|---|
| 01 - Introduzione | ✅ Completato | 04/02/2026 |
| 02 - Architettura | ⏳ In Sviluppo | - |
| 03 - Script Principale | ⏳ Pianificato | - |
| 04 - Workflow Test | ⏳ Pianificato | - |
| 05 - Modalità Esecuzione | ⏳ Pianificato | - |
| 06 - GUI | ⏳ Pianificato | - |
| 07 - Output | ⏳ Pianificato | - |
| 08 - Configurazione | ⏳ Pianificato | - |
| 09 - Hardware | ⏳ Pianificato | - |
| 10 - Best Practices | ⏳ Pianificato | - |
📝 Convenzioni del Documento
- Codice inline:
variabileofunzione() - Blocchi codice:
# Esempio Python - File paths:
TestEnvironment/scripts/GRIFO_M_PBIT.py - Comandi:
.\run_simulate.bat - Note importanti: ⚠️ Prefissati con icona
- Best practice: ✅ Prefissati con check
- Problemi noti: ❌ Prefissati con X
📧 Contatti e Supporto
Per domande o suggerimenti su questa documentazione:
- Team: Test Automation Team
- Repository: GrifoAutomaticTestEnv
- Documentazione aggiuntiva:
_doc/directory
Ultima revisione: 04 Febbraio 2026