Skip to content

Tools: serial-to-udp.py, the reference bridge for a receiver on a USB port - #302

Merged
chriskinal merged 1 commit into
developfrom
tools/serial-to-udp
Oct 10, 2026
Merged

chriskinal merged 1 commit into
developfrom
tools/serial-to-udp

Conversation

@chriskinal

Copy link
Copy Markdown
Collaborator

Phase 0's second script (Plans/GPS_RECEIVER_SENTENCES_PLAN.md): the reference implementation of the bridge contract, for a bench or a contributor's laptop with a receiver on a USB port and no AiO board.

  • Receiver → app: each whole line ($…*hh and Unicore #…*crc, CR LF kept) is sent as one UDP datagram to the app's GPS port the moment it is complete. Nothing batched, nothing cut; binary bytes between lines (UBX, echoed RTCM) are dropped and counted.
  • App → receiver: every datagram arriving on UDP 2233 (the forwarded RTCM) is written to the port unchanged.
  • --to 192.168.5.255:9999 for an app on another host, --no-rtcm for one-way, --baud.
  • Two threads, pyserial as the one dependency, works on macOS, Linux and Windows port names.

The line framer is checked against split lines, binary between lines and an overlong line. Not run against a receiver here; the first user with a USB receiver is the test. Docs/GPS_RECEIVERS.md has the recipe, so the Septentrio ask on the open issue now has a path for USB users: run this beside Tools/nmea-capture.py and send the capture.

🤖 Generated with Claude Code

… port

Phase 0's second script. Reads the serial port, sends each whole line
($…*hh and Unicore #…*crc, with its CR LF) as one datagram to the app's
GPS port as soon as it is complete, and writes every datagram that
arrives on UDP 2233 (the forwarded RTCM) to the port unchanged: the
bridge contract in Docs/GPS_RECEIVERS.md. Binary bytes between lines
are dropped and counted. pyserial is its one dependency.

For contributors with a Septentrio or other receiver on a laptop: run
it beside nmea-capture.py and send the capture.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@chriskinal
chriskinal merged commit dfb073b into develop Oct 10, 2026
4 checks passed
@chriskinal
chriskinal deleted the tools/serial-to-udp branch October 12, 2026 21:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant