# Plan prób stanowiskowych Ethernetu jednoparowego: pola i instrukcje

Wersja: 2026-09-23. Pliki towarzyszące: spe-bench-plan.csv i spe-bench-demo-plan.csv.
Otwórz pliki jako tekst UTF-8 rozdzielany przecinkami, używając funkcji „Z tekstu/CSV” w Excelu lub LibreOffice. Angielskie nazwy kolumn umożliwiają ponowne użycie w różnych językach.

Plan zawiera już cele prób: B01 baza na krótkim łączu, B02 docelowy kabel, B03 zasilanie przez tę samą parę i B04 zmiana rozruchu/obciążenia. Jest to sugerowana kolejność, a nie instrukcja połączeń producenta ani wykonany test. Usuń warunki nieodpowiadające możliwościom sprzętu. Przy wielokrotnym wykonywaniu jednego warunku skopiuj wiersz i nadaj unikalny test_id. Przed rozpoczęciem pracy uzupełnij dokumentację, rzeczywiste płytki, oprogramowanie i kryteria.

| Pole | Znaczenie i instrukcja wpisu |
| --- | --- |
| data_kind | unperformed_plan dla planu; illustrative_plan_not_measured dla przykładu; po uzyskaniu rzeczywistych pomiarów użyj measured w osobnym zapisie |
| test_id | Unikalny identyfikator każdego wykonania, służący do powiązania logów |
| document_and_revision | Rewizje rzeczywiście używanych instrukcji płytek, plików projektowych i dokumentacji oprogramowania |
| endpoint_a_hw_fw / endpoint_b_hw_fw | Rewizje sprzętu i wersje firmware/obrazu systemu/sterownika na obu końcach |
| cable_drawing_lot / planned_length_m | Rysunek kabla, złącza i partia / planowana długość w metrach |
| power_route_and_class | Rzeczywisty tor zasilania, konfiguracja PSE/PD i klasa zasilania; rozróżnij zasilanie zewnętrzne i zasilanie przez tę samą parę |
| changed_factor / held_constant | Czynnik zmieniany w tym wierszu / warunki utrzymywane bez zmian |
| acceptance_criteria_ref | Odniesienie do kryteriów produktu, granicznych warunków pracy komponentów i warunków zatrzymania ustalonych przed wykonaniem |
| planned_observation | Obserwacje i logi zaplanowane dla tego warunku |
| started_at_utc / ended_at_utc | Rzeczywisty przedział wykonania, obejmujący datę, godzinę i strefę czasową UTC |
| actual_tx_mode_vpp | Rzeczywisty odczyt trybu nadawania (Vpp); nie zastępuj go wartością planowaną |
| actual_tx_count / actual_rx_count | Liczby wysłanych/odebranych jednostek na tej samej warstwie i w tym samym przedziale czasu; pozostaw puste, jeśli liczniki są niedostępne |
| counter_definition | Czy liczniki dotyczą ramek Ethernet, komunikatów aplikacji czy innej jednostki; sposób obsługi duplikatów, filtrowania i resetów |
| link_down_count / reset_count | Przerwy łącza / resety urządzeń końcowych rzeczywiście zaobserwowane w danym przedziale; pozostaw puste, jeśli nie prowadzono obserwacji |
| pd_input_min_v / pd_input_max_v | Minimalne/maksymalne napięcie wejściowe PD w określonym punkcie pomiarowym, w V; szczegóły przyrządu i punktu pomiarowego umieść w evidence_ref |
| power_setup_result / data_result | Osobne wnioski dotyczące ustanowienia zasilania i danych aplikacyjnych, wraz z zastosowanymi kryteriami; nie wpisuj wyniku pozytywnego dla niewykonanego testu |
| evidence_ref | Lokalizacje logów, przebiegów, punktów pomiarowych, ustawień próbkowania i plików wynikowych pod tym samym identyfikatorem |
| next_decision | Następne działanie: kontynuacja, zmiana wskazanego elementu, zakończenie tego podejścia lub dalszy test, wraz z podstawą decyzji |

## Jak używać wypełnionego przykładowego planu

Plik demonstracyjny zakłada istnienie kompatybilnych urządzeń końcowych, z łączem początkowym 1 m i docelowym kablem 20 m. Długości te mają wyłącznie charakter ilustracyjny. Osobne wiersze zmieniają kabel, sposób zasilania oraz rozruch lub obciążenie. Zastąp pola REPLACE rzeczywistymi informacjami. Zweryfikuj także klasy zasilania, negocjację i obsługę złączy na obu końcach; założenie kompatybilności nie jest wykonaną kontrolą.

Każde pole przykładu od started_at_utc do next_decision jest puste. Nie ma rzeczywistych czasów, liczników, napięć, resetów, logów ani wniosków z testu. Po przygotowaniu skopiuj plan do osobnego pliku wykonania i zachowaj pierwotny plan. Rozróżnij pliki zarówno nazwami, jak i wartościami data_kind.

## Podsumowanie i diagnozowanie wyników

Najpierw porównaj B01/B02 przy takim samym przedziale czasu, obciążeniu, urządzeniach końcowych i oprogramowaniu. Przy porównywaniu B02/B03 odnotuj zmianę toru zasilania. Sama świecąca kontrolka nie wystarcza do pozytywnego wyniku data_result; odczytaj dane aplikacji i zastosuj określone kryteria. Jeśli definicje liczników różnią się lub licznik został zresetowany, różnicy między liczbą wysłanych a odebranych jednostek nie można bezpośrednio uznać za utratę pakietów. Najpierw zachowaj logi i wyjaśnij różnicę.

Gdy usterki pojawiają się tylko przy zasilaniu przez tę samą parę, sprawdź zależności czasowe między ustanowieniem zasilania, stanem PD, resetami i zdarzeniami danych przed wyborem kolejnego pomiaru. Nie wnioskuj o spadku napięcia na kablu wyłącznie na podstawie tego objawu. Jeśli krótkie łącze również nie działa, najpierw rozwiąż problem konfiguracji bazowej. Niedostępne zapisy pozostaw puste. Wpisuj 0 tylko dla zdarzenia, które rzeczywiście nie wystąpiło w obserwowanym przedziale.

Wnioski z prób stanowiskowych są gotowe do przekazania, gdy każdy zaplanowany warunek ma konfigurację, kryteria i odniesienia do wyników, niepowodzenia mają wykonalny kolejny krok diagnostyczny, a nieprzetestowany zakres jest wymieniony osobno. Tabela nie określa automatycznie kompatybilności komponentów ani nie zastępuje procedur połączeń producenta, kwalifikacji produktu czy weryfikacji EMC.


## Oryginalne wartości CSV i ich znaczenie

Oryginalne pliki zachowują stałe wartości angielskie. Poniższa tabela wyjaśnia ich znaczenie; identyfikatory demonstracyjne nie oznaczają rzeczywistych części ani testów.

| Wartość oryginalna | Znaczenie |
| --- | --- |
| `unperformed_plan` | Plan, którego jeszcze nie wykonano. |
| `illustrative_plan_not_measured` | Plan ilustracyjny bez wyników pomiarów. |
| `measured` | Osobny zapis rzeczywistych pomiarów po wykonaniu. |
| `B01` | Warunek bazowy na krótkim łączu. |
| `B02` | Warunek z docelowym kablem. |
| `B03` | Warunek zasilania przez tę samą parę. |
| `B04` | Warunek zmiany rozruchu lub obciążenia. |
| `REPLACE: exact board manuals and matched revisions` | Wpisz rzeczywiste instrukcje płytek i sprawdź zgodność ich rewizji. |
| `REPLACE: compatible endpoint A / firmware` | Wpisz rzeczywiste urządzenie końcowe A i firmware oraz sprawdź kompatybilność. |
| `REPLACE: compatible endpoint B / firmware` | Wpisz rzeczywiste urządzenie końcowe B i firmware oraz sprawdź kompatybilność. |
| `REPLACE: actual drawing and lot` | Wpisz rzeczywisty rysunek kabla i partię. |
| `REPLACE: product-specific criteria agreed before test` | Wpisz kryteria właściwe dla produktu, ustalone przed wykonaniem. |
| `original supported supply` | Użyj pierwotnego sposobu zasilania obsługiwanego przez producenta. |
| `same as B01` | Zachowaj sposób zasilania użyty dla B01. |
| `compatible PoDL/SPoE only` | Używaj PoDL/SPoE dopiero po sprawdzeniu kompatybilności. |
| `validated route` | Użyj toru zasilania już zweryfikowanego dla sprzętu. |
| `establish baseline` | Ustal początkową konfigurację porównawczą. |
| `target cable and connector assembly` | Zmień na docelowy kabel i zespół złączy. |
| `power route` | Zmień sposób zasilania. |
| `one declared startup or load condition` | Zmień jeden jednoznacznie zdefiniowany warunek rozruchu lub obciążenia. |
| `endpoint firmware; application load` | Zachowaj firmware urządzeń końcowych i obciążenie aplikacji bez zmian. |
| `endpoints; firmware; data load; supply` | Zachowaj urządzenia końcowe, firmware, obciążenie danymi i zasilanie bez zmian. |
| `B02 cable; endpoints; firmware; data load` | Zachowaj kabel z B02, urządzenia końcowe, firmware i obciążenie danymi bez zmian. |
| `validated circuit and cable` | Zachowaj uprzednio zweryfikowany obwód i kabel bez zmian. |
| `negotiation; application data; supply state` | Obserwuj negocjację, dane aplikacyjne i stan zasilania. |
| `same-window data counters; reconnect/reset; supply readings` | Obserwuj liczniki danych w takim samym przedziale czasu, ponowne połączenia/resety i odczyty zasilania. |
| `power classification/start; PD state; application data` | Obserwuj klasyfikację i uruchomienie zasilania, stan urządzenia zasilanego i dane aplikacyjne. |
| `startup count; recovery duration; logs/waveform` | Zapisuj liczbę rozruchów, czas przywrócenia pracy i odpowiednie logi lub przebiegi. |