Documentazione utente
Riferimento per interfaccia, configurazione e procedure d'uso
| Documento | Manuale modulo Delimited ASCII Frame FemtoBench |
|---|---|
| Revisione | 0.4 |
| Lingua | Italiano |
| Aggiornamento | 20 luglio 2026 |
| Stato | Edizione aggiornata |
Il modulo Delimited ASCII Frame 1.0.0 richiede FemtoBench 0.1.1 o successivo.
Il modulo Delimited ASCII Frame costruisce e interpreta frame ASCII strutturati con delimitatori, checksum e terminatori configurabili dal modulo.
Il modulo gestisce trasporti Serial, UDP e BLE. Le regole di framing restano uniformi, mentre la risorsa definisce il mezzo fisico e il target descrive il comando applicativo.
La risorsa si aggiunge nella schermata Bench Configurations. Per il canale Serial, Resource Details espone Port, cioè la porta fisica della postazione. UDP e BLE non dichiarano campi di identità a livello banco; i rispettivi endpoint e le regole di framing appartengono al prodotto.
Per ogni parametro configurabile, Operator editable consente al progettista del banco di delegare un eventuale override a Station Configuration. L’override vale soltanto sulla postazione corrente.
Il campo Port è una casella combinata editabile: propone le porte seriali rilevate dal sistema, ma accetta anche un nome o percorso inserito manualmente. Il pulsante di aggiornamento a fianco ripete l’enumerazione, utile dopo aver collegato o scollegato un adattatore USB-seriale senza chiudere la schermata.
| Campo | Descrizione |
|---|---|
| Name | Nome dell’istanza Delimited ASCII Frame disponibile sul banco. |
| Port | Porta seriale fisica, ad esempio COM3 o
/dev/ttyUSB0. |
Nella schermata Products, selezionando il banco associato, il pannello di configurazione risorsa espone trasporto e framing usati dal DUT.
| Campo | Descrizione |
|---|---|
| Baudrate | Velocità seriale. Valori predefiniti: 9600, 19200, 38400, 57600, 115200; sono ammessi valori personalizzati. |
| Data Bits | Numero bit dati: 5, 6, 7 o 8. |
| Parity | Parità: None, Even o Odd. |
| Stop Bits | Numero bit stop: 1 o 2. |
| Response Timeout (ms) | Timeout attesa risposta, intervallo 0..60000 ms. |
| Open Settle (ms) | Ritardo dopo apertura porta prima della richiesta. |
| Pre-TX Drain Timeout (ms) | Tempo massimo per svuotare input seriale pendente prima della trasmissione. |
| Pre-TX Quiet (ms) | Intervallo di quiete usato durante lo svuotamento input. |
| Sync Line On Open | Invia una riga terminata vuota dopo l’apertura e svuota nuovamente l’input. |
| Campo | Descrizione |
|---|---|
| Remote Host | Nome host o indirizzo IP del dispositivo. |
| Remote Port | Porta UDP remota, intervallo 1..65535. |
| Local Port | Porta UDP locale, intervallo 0..65535; 0 usa assegnazione automatica. |
| Response Timeout (ms) | Timeout attesa risposta, intervallo 0..60000 ms. |
| Campo | Descrizione |
|---|---|
| Device Name | Nome DUT annunciato in advertising. |
| Advertised Service UUID | UUID servizio opzionale usato come filtro di discovery. |
| Scan Timeout (ms) | Tempo massimo di discovery BLE, intervallo 100..120000 ms. |
| Connect Timeout (ms) | Tempo massimo di connessione BLE, intervallo 100..120000 ms. |
| Operation Timeout (ms) | Timeout operazioni BLE GATT, intervallo 100..120000 ms. |
| Service UUID | Servizio GATT che contiene le caratteristiche del frame ASCII. |
| Write Characteristic UUID | Caratteristica GATT usata per scrivere i frame richiesta. |
| Read Characteristic UUID | Caratteristica GATT usata per leggere i frame risposta; vuoto usa la stessa caratteristica di scrittura. |
| Write Mode | Modalità scrittura GATT: With Response o Without Response. |
| Response Timeout (ms) | Timeout attesa risposta BLE dopo scrittura richiesta, intervallo 100..120000 ms. |
Questi campi sono comuni ai canali Serial, UDP e BLE.
| Campo | Descrizione |
|---|---|
| Frame Start | Marker ASCII opzionale all’inizio del frame. Default
$. |
| Field Separator | Separatore ASCII tra header e campi. Default ,. |
| Checksum Delimiter | Marker ASCII opzionale prima del checksum. Vuoto disabilita il checksum. |
| Checksum Type | Algoritmo checksum: None, XOR8, SUM8, CRC16 CCITT, CRC16 Modbus o CRC32. |
| Checksum Encoding | Rappresentazione testuale checksum: Hex upper 2, Hex lower 2, Hex upper 4, Hex upper 8 o Decimal. |
| Terminator | Terminatore frame: CRLF, LF, CR o None. |
Per il canale Serial, Port resta identificativo del banco; gli altri parametri seriali, timeout e framing sono configurabili per il prodotto. Per canali UDP e BLE, i campi di endpoint, discovery, caratteristiche GATT e framing sono configurabili per il prodotto.
Il dialog si apre da Communication Profiles > Binding Details > Configure quando il binding usa il modulo Delimited ASCII Frame.
| Campo | Descrizione |
|---|---|
| Header | Header del frame o token comando inviato prima del payload. |
| Token Pattern | Espressione regolare che valida token richiesta e valore di scrittura. |
| Payload Tokens | Token separati da virgola aggiunti dopo l’header. |
| Write Value Policy | Indica se lo step deve fornire un valore per la richiesta. |
| Default Write Value | Valore predefinito usato se lo step non fornisce un valore. |
| Campo | Descrizione |
|---|---|
| Type | Regola di match della risposta: Echo, Payload o Custom. |
| Payload Value Index | Indice del token payload da cui estrarre il valore. |
| Response Header | Header risposta atteso; vuoto usa l’header richiesta. |
| Response Payload Tokens | Token payload richiesti nella risposta custom. |
| Expected Payload Prefix | Prefisso payload opzionale richiesto prima del valore estratto. |
| Extract Payload Value | Estrae il valore dal payload quando la risposta custom lo prevede. |
La riga Preview mostra il frame generato con delimitatori, checksum e terminatore correnti. OK salva un target valido; Cancel chiude il dialog senza applicare modifiche.
Con frame start $, separatore ,, checksum
XOR8 preceduto da * e terminatore CRLF, il binding
device.temperature usa header READ e token
TEMP. La risposta di tipo Payload estrae
il token all’indice configurato. Il valore risultante viene convertito
nel tipo del binding e confrontato con l’intervallo ammesso dalla
sequenza.
Per la diagnostica si verifica prima la Preview, poi si usa Test binding per controllare frame TX, frame RX, checksum e token estratto.