SXXXXXXX_PyBusMonitor1553/doc/UDP1553_parity_report.md

Report di parità UDP1553 — GrifoScope C++ vs Python BusMonitor

Scopo

• Documentare le differenze rilevanti e le azioni applicate per rendere il parser Python compatibile con l'implementazione C++ (GrifoScope).

Riferimenti C++ analizzati

• cpp/GrifoScope/GrifoSdkEif/pub/TH/udp1553_types.h
  • costanti: k_marker_1553=0x1553, k_marker_end_1553=0x5315, k_ctrl_marker_begin=0x3C3C, k_ctrl_marker_end=0x3E3E
• cpp/GrifoScope/GrifoSdkEif/dev/Portable/ext/b1553_udp.cpp
  • funzione: processMessages(...) — logica di parsing dei blocchi messaggio
  • comportamento reply builder e validazioni (~CW, 0x3E3E)

Correzioni principali applicate in Python

1. Word-count (wc) handling

   • C++: se wc==0 -> wc=32; poi se SA==0 o SA==31 -> wc=0 (mode codes)
   • Python: replicato esattamente (wc==0 -> 32; SA 0|31 -> wc=0)

2. TR bit semantics e presenza dati

   • C++: tr==1 indica che il RT è il trasmettitore (RT->BC). Per i pacchetti BC (OTYPE_BC): wcin = tr ? 0 : wc (cioè se tr==1 non ci sono dati nel blocco BC)
   • Per i pacchetti di reply (OTYPE_RT) il reply include i dati quando tr==1.
   • Python: implementata la stessa logica; il numero di parole dati presenti (wcin) dipende da udp_header.otype e dal tr_bit.

3. Validazione terminatori

   • C++ controlla che dopo i dati vi siano ~(cw.raw) e il marker k_ctrl_marker_end (0x3E3E).
   • Python: ora legge e confronta inv_cw e ctrl_marker, logga mismatch in logger.debug se non corrispondono.

4. Creazione oggetti Message

   • Python ora istanzia gli oggetti messaggio solo quando è presente il payload dati effettivo. Questo rispetta il fatto che le richieste BC->RT (tr==1) non contengono payload nel frame iniziale.

File modificati

• pybusmonitor1553/core/dispatcher.py
  • parse_packet() aggiornato per rispecchiare la logica C++ (wc, wcin, tr semantics, validate ~CW+0x3E3E)

Prossimi passi

• Eseguire tools/verify_all_messages.py per validare che i messaggi A/B vengono impacchettati/parsi come GrifoScope.
• Se emergono discrepanze residue, applicare patch mirate a: lib1553/MessageBase.pack() o tools/network_sniffer.py.

Note

• Ho mantenuto endianness e uso di ctypes già presenti nel progetto.
• I log di debug mostrano mismatch di marker/CW ma non interrompono il parsing; possiamo rendere il comportamento più rigido se necessario.

Creato automaticamente il: 2025-12-15