Stabilization of frame communication layer.

[drebbe-intrepid]

This update provides much needed fixes to the communication layer, especially around binary data transfers.

[Copilot]

Pull request overview

This PR stabilizes the serial framing/communication layer (with emphasis on mixed binary + framed traffic) by introducing a dedicated frame parsing state machine and expanding test coverage around frame boundary detection and file transfers.

Changes:

• Replaced ad-hoc serial receive parsing in SerialPort with a new FrameParser state machine.
• Extended framing helpers (ResponseFrame) with start/end-of-frame detection/validation and added corresponding tests.
• Updated hardware/file-transfer tests and examples to use FreeWili as a context manager; added stress-style get_file test coverage and a binary fixture.

Reviewed changes

Copilot reviewed 27 out of 28 changed files in this pull request and generated 16 comments.

Show a summary per file

File	Description
freewili/serialport.py	Switches RX handling to FrameParser; adds verbose logging/TRACE support and adjusts send timing.
freewili/frame_parser.py	New frame parsing state machine to separate response frames vs. binary data.
freewili/framing.py	Adds start/end-of-frame detection & validation helpers used by the parser.
freewili/safe_reponse_frame_dict.py	Extracts thread-safe response-frame storage into its own module.
freewili/fw_serial.py	Improves response-frame timeout error context; tightens file download write logic.
tests/test_frame_parser.py	Adds unit tests for FrameParser behavior across framed and binary data.
tests/test_framing.py	Adds tests for framing start/end validation helpers.
tests/test_get_file.py	Refactors context usage; adds multi-download stress test and improves callback test.
tests/test_fw.py / tests/test_hw.py / tests/test_hw_io.py / tests/test_i2c.py	Refactors tests to use context manager patterns for device lifecycle.
tests/assets/invalid.fwi	Adds binary fixture for file transfer stress testing.
examples/*.py	Refactors examples to use fw = ...; with fw: pattern.
.vscode/launch.json	Adds a debug configuration for running pytest with logging enabled.

Comments suppressed due to low confidence (1)

freewili/serialport.py:275

• The serial port is now opened with exclusive=False. This can allow multiple processes/threads to open the same port simultaneously, which can cause data corruption or hard-to-debug IO errors. If the previous exclusive=True was intentional, consider keeping it as the default and making exclusivity configurable per SerialPort instance (or documenting why exclusivity must be disabled).

                            self.logger.debug(f"[{time.time() - start_time:.3f}] Opening {self._port}...")
                            serial_port = Serial(
                                self._port,
                                baudrate=self._baudrate,
                                timeout=0.001,
                                exclusive=False,
                                rtscts=False,
                                xonxoff=False,
                                dsrdtr=False,
                            )

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.