Documentazione utente
Riferimento per interfaccia, configurazione e procedure d'uso
| Documento | Manuale modulo BLE GATT FemtoBench |
|---|---|
| Versione | 1.0.11 |
| Lingua | Italiano |
| Aggiornamento | 22 settembre 2026 |
| Stato | Edizione aggiornata |
Il modulo BLE GATT 1.0.11 richiede FemtoBench 0.1.24 o successivo.
Il modulo BLE GATT collega le associazioni FemtoBench a servizi, caratteristiche e descrittori GATT esposti dal dispositivo sotto test.
La configurazione segue tre livelli: la risorsa identifica il canale BLE del banco, il prodotto specifica come riconoscere il DUT e la destinazione collega un’associazione alla caratteristica GATT.
Il modulo usa un componente locale per verificare le funzionalità e la sicurezza dell’adattatore Bluetooth. Dopo aver installato o aggiornato BLE GATT, apri Opzioni > Moduli, premi … nella colonna Strumenti del canale BLE del modulo BLE GATT e premi Verifica funzionalità BLE…. Se la finestra segnala che l’installazione Linux è incompleta, premi Copia comando di installazione Linux, incolla il comando in un terminale ed eseguilo con autorizzazione amministrativa. Il comando installa la copia inclusa nel modulo appena caricato; FemtoBench continua a funzionare come utente normale. Il rilevamento si aggiorna automaticamente, senza riavviare l’applicazione.
Ripeti questa verifica dopo ogni aggiornamento del modulo: se il componente locale non corrisponde alla nuova versione, la finestra indica di reinstallarlo. Il controllo preliminare prima di una sequenza BLE riporta la stessa istruzione e permette di riprovare senza registrare un’esecuzione fallita. Il componente osserva solo i metadati necessari a verificare la sicurezza e non registra chiavi o contenuto dei pacchetti.
La risorsa BLE si aggiunge nella schermata Configurazioni banco e si seleziona nella tabella Risorse. Il pannello Dettagli risorsa espone il nome dell’istanza e la descrizione del canale. Questo modulo non dichiara campi di identità hardware a livello banco: rilevamento e timeout appartengono alla configurazione del prodotto.
La tabella mostra anche Descrizione e Modificabile dall’operatore. I parametri delegati compaiono in Configurazione stazione, dove una postazione autorizzata può impostare un override locale senza modificare la configurazione portabile.
| Campo | Descrizione |
|---|---|
| Nome | Nome dell’istanza BLE disponibile sul banco. |
In Opzioni > Moduli, apri gli strumenti del canale BLE di BLE GATT e premi Verifica funzionalità BLE…. Gli strumenti sono riservati all’amministratore; l’operatore vede il pulsante disabilitato. La finestra mostra, per ogni adattatore, Bluetooth Low Energy, ruolo central, cifratura, LE Secure Connections e disponibilità della verifica di sicurezza. Ogni voce riporta Supportata, Non supportata o Sconosciuta, con un indicatore grafico. L’adattatore predefinito è quello utilizzato per scansione e comunicazione.
Il rilevamento avviene automaticamente solo quando il modulo è installato e caricato e si aggiorna durante la sessione. La verifica mostra i risultati già raccolti; non avvia una prova sul DUT. Un adattatore spento o un permesso mancante non dimostrano che una funzionalità sia assente: alcune informazioni rimangono sconosciute finché l’adattatore non viene attivato e i permessi resi disponibili.
La disponibilità locale è un prerequisito: per confermare che DUT e banco comunichino con le impostazioni richieste serve una prova di associazione.
Nella schermata Prodotti, selezionando un banco associato al prodotto, il pannello di configurazione risorsa permette di impostare i parametri BLE usati per individuare e interrogare il DUT.
| Campo | Descrizione |
|---|---|
| Nome dispositivo | Nome DUT annunciato, utile quando l’indirizzo non è stabile. |
| UUID servizio annunciato | UUID servizio opzionale usato come filtro di rilevamento. |
| Timeout scansione (ms) | Tempo massimo di rilevamento BLE, intervallo 100..120000 ms. |
| Timeout connessione (ms) | Tempo massimo di connessione BLE, intervallo 100..120000 ms. |
| Timeout operazione (ms) | Timeout predefinito per letture/scritture GATT, intervallo 100..120000 ms. |
| Richiedi connessione cifrata | Impedisce l’accesso GATT finché non è confermata la cifratura. |
| Richiedi LE Secure Connections | Richiede anche il pairing Secure Connections; seleziona e blocca il requisito di cifratura. |
| Timeout sicurezza (ms) | Parametro avanzato per l’attesa del pairing e della verifica di sicurezza, intervallo 1000..120000 ms. |
Le caselle di sicurezza sono modificabili solo quando il supporto necessario è stato verificato sull’adattatore locale. Il tooltip spiega perché una casella è disabilitata. Un requisito già salvato resta selezionato anche su un PC che non può soddisfarlo: non viene eliminato automaticamente e l’esecuzione viene rifiutata con un messaggio esplicativo.
Lasciare Richiedi connessione cifrata deselezionato non forza un canale in chiaro: il DUT può comunque richiedere la cifratura. Secure Connections non significa necessariamente autenticazione con PIN o protezione MITM; anche Just Works può usare Secure Connections. Su Linux, quando la cifratura è richiesta, il modulo rileva il DUT con una scansione BLE e poi avvia il pairing tramite un agente dedicato, prima di aprire il collegamento Qt. Un dispositivo Just Works può così comunicare senza conferma manuale e senza creare un bond permanente; il desktop può comunque mostrare le normali notifiche di connessione e disconnessione. Per DUT che richiedono un PIN, esegui il pairing dalle impostazioni Bluetooth del sistema.
Su Linux un pairing creato prima dell’avvio del monitor può avere una provenienza non verificabile. Se il prodotto richiede Secure Connections, rinnova il pairing dalle impostazioni del sistema mentre FemtoBench è aperto. Non vengono rimossi automaticamente pairing o chiavi del sistema.
I parametri del prodotto costituiscono i valori predefiniti. Quando il progettista li rende modificabili dall’operatore, un override della postazione può sostituirli localmente. Questa separazione permette allo stesso adattatore BLE di collaudare dispositivi con nomi e servizi differenti.
La finestra si apre da Profili di comunicazione > Dettagli associazione > Configura… quando l’associazione usa il modulo BLE GATT.
| Campo | Descrizione |
|---|---|
| UUID servizio | UUID del servizio GATT pubblicato dal dispositivo. |
| UUID caratteristica | UUID della caratteristica usata dall’associazione. |
| UUID descrittore | UUID opzionale del descrittore, se l’associazione punta a un descrittore. |
| Campo | Descrizione |
|---|---|
| Operazione | Operazione consentita: Lettura, Scrittura o Lettura/Scrittura. |
| Strategia di lettura | Strategia di lettura: Polling, Notifica o Indicazione. |
| Modalità di scrittura | Scrittura con risposta o senza risposta. |
| Criterio valore di scrittura | Indica se lo step deve fornire un valore di scrittura. |
| Valore di scrittura predefinito | Valore predefinito usato se lo step non fornisce un valore. |
| Sottoscrivi alla connessione | Attiva la sottoscrizione all’apertura della connessione, quando applicabile. |
| Campo | Descrizione |
|---|---|
| Codifica | Regola di conversione tra byte grezzi e valore logico. |
| Ordine byte | Ordinamento byte per valori numerici multibyte: Little Endian o Big Endian. |
| Offset valore | Offset del valore nel payload della caratteristica. |
| Lunghezza valore | Numero di byte da leggere per il valore; 0 indica lunghezza automatica. |
OK valida UUID, operazione e codifica e salva la destinazione. Annulla chiude la finestra conservando la configurazione precedente.
L’associazione battery.level usa il servizio Battery
Service 0000180f-0000-1000-8000-00805f9b34fb e la
caratteristica Battery Level
00002a19-0000-1000-8000-00805f9b34fb. L’operazione è
Lettura, la strategia è Polling e la
codifica UInt8. Uno step legge il valore e lo confronta
con la soglia minima prevista dal collaudo.
Prima di creare la sequenza, Prova associazione… conferma rilevamento, connessione, presenza del servizio e conversione dei byte.
Su Linux e su Windows 11, Mantieni connessione durante
l’esecuzione permette a più passi di usare lo stesso
collegamento sicuro. La sequenza deve iniziare con un’associazione
Connetti, passando il MAC del dispositivo nel valore
dell’azione. Per esempio, ${test.unitId} recupera la
matricola inserita nella stazione quando coincide con il MAC. Il modulo
verifica il formato prima di tentare la connessione.
Sottoscrivi abilita le notifiche della caratteristica indicata. Disconnetti chiude il collegamento; la fine dell’esecuzione lo rilascia comunque. Attendi disconnessione aspetta invece che sia il dispositivo a chiudere il collegamento, per esempio durante un riavvio. Non dimostra da sola che il comando precedente sia riuscito. Su Windows la sessione usa un processo di supporto di Windows PowerShell che resta attivo per tutta l’esecuzione; la connessione completa di accoppiamento richiede alcuni secondi e il passo Connetti ha un timeout configurabile nel passo stesso. Le normali associazioni mantengono il comportamento esistente.
Per una scrittura con risposta asincrona, impostare UUID servizio risposta e UUID caratteristica risposta. Il modulo sottoscrive la risposta prima di scrivere, anche se appartiene a un servizio diverso. Nel passo della sequenza, Pattern risposta seleziona con un’espressione regolare la notifica terminale; la validazione Risposta azione la confronta con il valore atteso. Una risposta intermedia di avvio o la conferma del trasporto non equivalgono al completamento. Il significato delle risposte dipende dalla sequenza, non dal modulo.
Dopo una disconnessione inattesa, ripartire dal passo di connessione. Il modulo non ripete automaticamente comandi che potrebbero azionare il dispositivo. Le impostazioni di cifratura e LE Secure Connections restano obbligatorie quando richieste dal prodotto.
Un errore di autenticazione non indica necessariamente che il Bluetooth del computer sia spento o che serva un PIN. Verificare anche la modalità operativa del dispositivo e la compatibilità con la sicurezza prevista dal collaudo. Il messaggio distingue rifiuto, annullamento, timeout e associazione già in corso; il Registro di comunicazione contiene i dettagli diagnostici restituiti dal sistema.
L’operazione Attendi notifica usa una connessione mantenuta durante l’esecuzione. Indicare servizio e caratteristica che notificano gli eventi; non serve un valore di scrittura. Il modulo sottoscrive la caratteristica e attende una nuova notifica, senza leggere il suo ultimo valore memorizzato. Il Pattern risposta del passo seleziona l’evento e la validazione della risposta decide PASS/FAIL.
Nell’editor della sequenza, Mostra istruzione durante l’ascolto presenta l’istruzione solo dopo l’attivazione dell’ascolto. La ricezione chiude la finestra automaticamente. Timeout, disconnessione e Interrompi terminano la prova senza conferme manuali di successo. È utile, per esempio, per verificare telecomandi e pulsanti che il dispositivo espone tramite notifiche. Le sessioni mantenute sono disponibili su Linux e su Windows 11; l’upload del firmware del dispositivo è indipendente.