# Piano di banco per single-pair Ethernet: campi e istruzioni

Versione: 2026-09-23. File associati: spe-bench-plan.csv e spe-bench-demo-plan.csv.
Apriteli come testo UTF-8 delimitato da virgole con «Da testo/CSV» in Excel o con LibreOffice. I nomi inglesi delle colonne consentono il riuso tra lingue.

Il piano comprende già gli obiettivi B01 riferimento corto, B02 cavo previsto, B03 alimentazione sulla stessa coppia e B04 variazione di avvio/carico. È una sequenza suggerita, non un'istruzione di cablaggio del produttore né una prova completata. Eliminate le condizioni non applicabili alle capacità degli apparati. Per eseguire più volte una condizione, duplicate la riga e assegnate un test_id univoco. Completate documentazione, schede reali, software e criteri prima di iniziare.

| Campo | Significato e istruzioni |
| --- | --- |
| data_kind | unperformed_plan per il piano; illustrative_plan_not_measured per l'esempio; usare measured in una registrazione separata dopo misure reali |
| test_id | ID univoco di ciascuna esecuzione, usato per collegare i log |
| document_and_revision | Revisioni dei manuali delle schede, file di progetto e documenti software effettivamente utilizzati |
| endpoint_a_hw_fw / endpoint_b_hw_fw | Revisioni hardware e versioni firmware/immagine/driver alle due estremità |
| cable_drawing_lot / planned_length_m | Disegno del cavo, connettori e lotto / lunghezza prevista in metri |
| power_route_and_class | Percorso reale di alimentazione, configurazione PSE/PD e classe di potenza; distinguere alimentazione esterna e sulla stessa coppia |
| changed_factor / held_constant | Fattore cambiato nella riga / condizioni mantenute costanti |
| acceptance_criteria_ref | Riferimento a criteri del prodotto, limiti dei componenti e condizioni di arresto stabiliti prima dell'esecuzione |
| planned_observation | Osservazioni e log previsti per la condizione |
| started_at_utc / ended_at_utc | Finestra reale di esecuzione, inclusi data, ora e fuso UTC |
| actual_tx_mode_vpp | Lettura effettiva della modalità di trasmissione (Vpp); non sostituire con un valore pianificato |
| actual_tx_count / actual_rx_count | Conteggi trasmessi/ricevuti allo stesso livello e nella stessa finestra; lasciare vuoto se non disponibili |
| counter_definition | Se i conteggi indicano frame Ethernet, messaggi applicativi o altra unità; gestione di duplicati, filtri e reset |
| link_down_count / reset_count | Interruzioni del collegamento / reset delle estremità realmente osservati nella finestra; vuoto se non osservati |
| pd_input_min_v / pd_input_max_v | Tensione minima/massima all'ingresso PD nel punto specificato, in V; indicare strumento e punto di misura in evidence_ref |
| power_setup_result / data_result | Conclusioni separate su avvio dell'alimentazione e dati applicativi, con i criteri usati; non indicare superamento per prove non eseguite |
| evidence_ref | Posizioni di log, forme d'onda, punti di misura, impostazioni di campionamento e file dei risultati con lo stesso ID |
| next_decision | Prossima azione: proseguire, cambiare un elemento nominato, interrompere il percorso o effettuare un'altra prova, con motivazione |

## Come usare il piano di esempio compilato

Il file dimostrativo presume estremità compatibili già disponibili, con collegamento iniziale di 1 m e cavo previsto di 20 m. Le lunghezze sono soltanto illustrative. Righe separate cambiano cavo, alimentazione e avvio o carico. Sostituite i campi REPLACE con informazioni reali. Verificate anche classi di potenza, negoziazione e supporto dei connettori alle due estremità; presumere compatibilità non equivale a verificarla.

Tutti i campi dell'esempio da started_at_utc a next_decision sono vuoti. Non esistono tempi, conteggi, tensioni, reset, log o conclusioni di prova reali. Dopo la preparazione, copiate il piano in un file di esecuzione separato e conservate l'originale. Distinguete i file sia nel nome sia nel valore data_kind.

## Riepilogo e diagnosi dei risultati

Confrontate prima B01/B02 con uguali finestra, carico, estremità e software. Annotate il cambio di percorso di alimentazione nel confronto B02/B03. Un indicatore acceso non basta per indicare superamento in data_result; leggete i dati applicativi e applicate i criteri dichiarati. Se le definizioni dei conteggi differiscono o un contatore si azzera, trasmessi meno ricevuti non può essere interpretato direttamente come perdita di pacchetti. Conservate i log e spiegate prima la differenza.

Quando le anomalie compaiono solo con alimentazione sulla stessa coppia, controllate le relazioni temporali tra avvio dell'alimentazione, stato PD, reset ed eventi dati prima di scegliere la prossima misura. Non deducete la caduta di tensione del cavo dal solo sintomo. Se anche il collegamento corto fallisce, risolvete prima la configurazione di riferimento. Lasciate vuoti i record non disponibili. Inserite 0 soltanto per un evento realmente assente nella finestra osservata.

Una conclusione di banco è pronta da consegnare quando ogni condizione prevista ha configurazione, criteri e riferimenti dei risultati, i fallimenti hanno un prossimo passo diagnostico eseguibile e l'ambito non provato è elencato separatamente. La tabella non determina automaticamente la compatibilità dei componenti e non sostituisce le procedure di cablaggio del produttore, la qualifica del prodotto o la verifica EMC.


## Valori originali dei CSV e significato

I file originali mantengono valori inglesi stabili. La tabella ne spiega il significato; gli identificativi dimostrativi non identificano parti o prove reali.

| Valore originale | Significato |
| --- | --- |
| `unperformed_plan` | Piano non ancora eseguito. |
| `illustrative_plan_not_measured` | Piano illustrativo privo di risultati misurati. |
| `measured` | Registrazione separata di misure reali dopo l'esecuzione. |
| `B01` | Condizione di riferimento con collegamento corto. |
| `B02` | Condizione con il cavo previsto. |
| `B03` | Condizione di alimentazione sulla stessa coppia. |
| `B04` | Condizione di variazione di avvio o carico. |
| `REPLACE: exact board manuals and matched revisions` | Inserire i manuali reali delle schede e verificare revisioni corrispondenti. |
| `REPLACE: compatible endpoint A / firmware` | Inserire estremità A e firmware reali e verificare la compatibilità. |
| `REPLACE: compatible endpoint B / firmware` | Inserire estremità B e firmware reali e verificare la compatibilità. |
| `REPLACE: actual drawing and lot` | Inserire disegno e lotto reali del cavo. |
| `REPLACE: product-specific criteria agreed before test` | Inserire i criteri specifici del prodotto stabiliti prima dell'esecuzione. |
| `original supported supply` | Usare l'alimentazione originale supportata dal produttore. |
| `same as B01` | Mantenere l'alimentazione usata per B01. |
| `compatible PoDL/SPoE only` | Usare PoDL/SPoE solo dopo aver verificato la compatibilità. |
| `validated route` | Usare il percorso di alimentazione già verificato per gli apparati. |
| `establish baseline` | Stabilire la configurazione iniziale di confronto. |
| `target cable and connector assembly` | Passare al cavo previsto con i connettori assemblati. |
| `power route` | Cambiare la configurazione di alimentazione. |
| `one declared startup or load condition` | Modificare una condizione di avvio o carico esplicitamente definita. |
| `endpoint firmware; application load` | Mantenere costanti firmware delle estremità e carico applicativo. |
| `endpoints; firmware; data load; supply` | Mantenere costanti estremità, firmware, carico dati e alimentazione. |
| `B02 cable; endpoints; firmware; data load` | Mantenere costanti cavo di B02, estremità, firmware e carico dati. |
| `validated circuit and cable` | Mantenere costanti circuito e cavo già verificati. |
| `negotiation; application data; supply state` | Osservare negoziazione, dati applicativi e stato dell'alimentazione. |
| `same-window data counters; reconnect/reset; supply readings` | Osservare contatori nella stessa finestra, riconnessioni/reset e letture dell'alimentazione. |
| `power classification/start; PD state; application data` | Osservare classificazione e avvio dell'alimentazione, stato del dispositivo alimentato e dati applicativi. |
| `startup count; recovery duration; logs/waveform` | Registrare numero di avvii, durata del ripristino e log o forme d'onda pertinenti. |