# 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](01_Introduzione_e_Overview.md)
- Scopo del progetto
- Architettura generale
- Componenti principali
- Requisiti di sistema
- Flusso di utilizzo tipico
- Vantaggi e limitazioni

### [02 - Architettura Software e Moduli](02_Architettura_Software_e_Moduli.md)
- Struttura delle directory
- Moduli core (leo_grifo_*)
- Dipendenze e interfacce
- Diagramma delle relazioni
- API comuni

### [03 - Script Principale GRIFO_M_PBIT.py](03_Script_Principale_GRIFO_M_PBIT.md)
- Struttura del codice
- Flusso di esecuzione
- Funzioni principali
- Gestione degli stati
- Ciclo di vita del test

### [04 - Sistema di Test - Workflow e Logica](04_Sistema_Test_Workflow_Logica.md)
- 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](05_Modalita_Esecuzione.md)
- Modalità Hardware (--target)
- Modalità Simulazione (--simulate)
- Sistema Mock e Test Senza Hardware
- Parametri di configurazione
- Launcher scripts

### [06 - Interfaccia Grafica (GUI Real-Time)](06_Interfaccia_Grafica_GUI.md)
- Architettura GUI
- Aggiornamenti thread-safe
- Visualizzazione live dei risultati
- Tabella run e statistiche
- Tooltip e interazioni

### [07 - Output e Report](07_Output_Report.md)
- Report PDF (struttura e formato)
- File CSV statistiche
- File JSON dati completi
- Naming convention e organizzazione
- Esempi di output

### [08 - Configurazione e Personalizzazione](08_Configurazione_Personalizzazione.md)
- File di configurazione
- Scenari personalizzati
- Known failures
- Parametri di test
- Customizzazione scenari

### [09 - Integrazione Hardware](09_Integrazione_Hardware.md)
- Interfaccia 1553 (SWIG bindings)
- Controllo seriale
- Power control (BrainBox)
- Gestione errori hardware
- Protocolli di comunicazione

### [10 - Best Practices e Troubleshooting](10_Best_Practices.md)
- Guida all'uso
- Problemi comuni e soluzioni
- Log e debugging
- Manutenzione
- FAQ

---

## 📖 Come Usare Questa Documentazione

### Per Nuovi Utenti
1. Inizia da [Capitolo 01](01_Introduzione_e_Overview.md) per comprendere l'architettura generale
2. Prosegui con [Capitolo 05](05_Modalita_Esecuzione.md) per eseguire il primo test
3. Consulta [Capitolo 10](10_Best_Practices_Troubleshooting.md) per problemi comuni

### Per Sviluppatori
1. Leggi [Capitolo 02](02_Architettura_Software_e_Moduli.md) per capire la struttura del codice
2. Approfondisci [Capitolo 03](03_Script_Principale_GRIFO_M_PBIT.md) per il workflow interno
3. Consulta [Capitolo 09](09_Integrazione_Hardware.md) per interfacce hardware

### Per Test Engineers
1. Inizia da [Capitolo 04](04_Sistema_Test_Workflow_Logica.md) per capire i test
2. Leggi [Capitolo 08](08_Configurazione_Personalizzazione.md) per personalizzare scenari
3. Consulta [Capitolo 07](07_Output_Report.md) per interpretare i risultati

---

## 🔄 Stato Documentazione

| Capitolo | Stato | Data Completamento |
|----------|-------|-------------------|
| 01 - Introduzione | ✅ Completato | 04/02/2026 |
| 02 - Architettura | ✅ Completato | 05/02/2026 |
| 03 - Script Principale | ✅ Completato | 05/02/2026 |
| 04 - Workflow Test | ✅ Completato | 05/02/2026 |
| 05 - Modalità Esecuzione | ✅ Completato | 05/02/2026 |
| 06 - GUI | ✅ Completato | 05/02/2026 |
| 07 - Output | ✅ Completato | 05/02/2026 |
| 08 - Configurazione | ✅ Completato | 05/02/2026 |
| 09 - Hardware | ✅ Completato | 05/02/2026 |
| 10 - Best Practices | ✅ Completato | 05/02/2026 |

---

## 📝 Convenzioni del Documento

- **Codice inline**: `variabile` o `funzione()`
- **Blocchi codice**: 
  ```python
  # 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**: 05 Febbraio 2026
