Changelog

Changelog#

Version 0.2.2#

  • First release published to PyPI.

  • The pyGigEVision dependency now installs from PyPI (pyGigEVision>=0.2.1) instead of a git URL; automated CI runs on push and pull request again.

  • Camera(ip=...).connect() now runs a discovery sweep to bind the host interface that actually reaches the camera, instead of trusting OS routing. On hosts with several link-local interfaces (VPN, Bluetooth, virtual adapters) the route by metric could pick a dead interface and the connect timed out. Cameras the sweep cannot see fall back to OS routing as before.

  • discover() now finds cameras on every host network interface (USB-to-GigE adapters, secondary NICs), via the reworked multi-interface discovery in pyGigEVision. Each result carries a reachable flag and an interface_ip recording the host NIC the camera replied on.

  • Camera() now connects through the interface the camera replied on during discovery, so a host with multiple link-local NICs no longer needs manual interface selection. It also raises an actionable error when the selected camera is on no host NIC subnet, instead of failing later with a confusing OS error.

  • Added pyTelops.force_ip(camera, ip, mask, gateway=None) to re-home a wrong-subnet camera by MAC (GVCP FORCEIP).

  • Removed the host-side link-local probe that the multi-interface discovery makes redundant. Thanks to Lorenzo Capponi (LolloCappo) for the connected-socket interface-detection approach (PR #13) that informed this work.

  • Requires the updated pyGigEVision (multi-interface discovery, force_ip).

  • buffer_download now detects dropped and corrupted frames and raises FrameIntegrityError by default when any frame is incomplete. This is a behavior change: pass max_dropped_frames=N to tolerate up to N incomplete frames, as older code relied on the method always returning an array.

  • buffer_download attaches a DownloadStats integrity report to cam.last_download_stats (per-frame missing packets, resend counts, throughput) so callers can inspect data quality without pixel inspection.

  • buffer_download enables GVSP packet resends during the stream and re-downloads incomplete frames from the camera buffer, controlled by the new resend and retries parameters. It no longer suppresses the pyGigEVision.gvsp packet-loss warnings.

  • Corrected the misleading packet_size=9000 guidance. Oversized requests on a non-jumbo path are now detected with a FireTestPacket path probe, and the download warns and falls back to packet_size=1500 instead of silently emitting mostly-zero frames.

  • buffer_download now auto-tunes by default: it probes once per connection whether the path carries jumbo frames and learns a download bitrate from each transfer’s completeness. Pass packet_size or bitrate_mbps to override, or set cam.auto_tune = False to disable.

  • Added tune_connection() to probe the link and sweep download settings, recommending a stable and fast configuration for the current adapter and cable. Includes an opt-in read-only NIC diagnostics pass.

  • New public names: FrameIntegrityError, DownloadStats, ConnectionReport, tune_connection.

Version 0.2.1#

  • Adopt sdypy package template conventions: hatchling build, sphinx-book-theme docs on ReadTheDocs, manual changelog, version-sync release script.

  • Add full Sphinx documentation: getting started, Camera API reference, calibration, streaming and buffer, troubleshooting.

  • Add five runnable examples in examples/: connect and grab, continuous live view, buffer recording, calibration loading, external trigger.

  • Add CONTRIBUTING.rst and this changelog. Fold the standalone troubleshooting guide into the documentation.

  • Switch lint from flake8 to ruff (strict superset, includes formatter).

  • Polish: NumPy-style docstrings and complete type hints across the Camera class and the registers, CLI, and GUI modules.

  • No public API changes; the LDAQ Telops plugin and existing user code continue to work unchanged.

Version 0.2.0#

  • Split the GigE Vision protocol layer into the standalone pyGigEVision package. pyTelops becomes the Telops vendor layer on top of it.

  • Camera re-exports GVCPClient and GVCPError from pyGigEVision for back-compatibility.

  • 127 unit tests plus 57 hardware tests.

Version 0.1.0#

  • Initial Telops camera driver: discovery, control, live streaming, onboard buffer recording and download, calibration loading, NUC, diagnostics.