Tecan Infinite 200 PRO plate reader backend (Infinite M Plex) #797

hazlamshamin · 2025-12-20T10:14:08Z

Add Tecan Infinite 200 PRO backend + tests.
Supports absorbance and fluorescence, including masking to read specified list of wells, up to 384-well plate.
Luminescence is experimental due to lack of glowing sample for testing.
Make USB capture decoding resilient to malformed escape sequences.

EDIT: all three modes now reflect what OEM does with 100% accuracy, and luminescence is no longer experimental ([e92c6db])

Tests: make lint, make format-check, make typecheck, make test.

Copilot

Pull request overview

This PR introduces a backend for the Tecan Infinite 200 PRO plate reader (M Plex series), adding support for absorbance and fluorescence measurements with experimental luminescence support. The implementation includes configurable well masking for reading specific wells on plates up to 384-well format.

Key changes:

New TecanInfinite200ProBackend class with USB communication and measurement decoding
Specialized decoders for absorbance, fluorescence, and luminescence measurement streams
Enhanced USB capture error handling to gracefully manage malformed escape sequences

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.

File	Description
pylabrobot/plate_reading/tecan_infinite_backend.py	Implements the complete backend with transport layer, measurement decoders, and plate reading methods for all three modes
pylabrobot/plate_reading/tecan_infinite_backend_tests.py	Comprehensive unit tests for decoders, scan geometry, and ASCII frame handling
pylabrobot/plate_reading/init.py	Exports the new backend and configuration class for public API access
pylabrobot/io/usb.py	Adds error handling to decode operations to prevent crashes from malformed USB data

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

pylabrobot/io/usb.py

Copilot · 2025-12-20T17:25:47Z

pylabrobot/plate_reading/tecan_infinite_backend.py

+  if end == -1:
+    return False, None
+  text = buffer[1:end].decode("ascii", "ignore")
+  del buffer[: end + 2]


This deletion assumes the buffer has at least end + 2 bytes, but only checks for bytes up to end. If the buffer ends exactly at ETX (index end), accessing end + 1 would be valid, but end + 2 could exceed buffer length. Add a length check before deletion.

i have pushed a new commit for extra guard for this after checking the hexdumps. additionally, there has already been guard for absorbance and fluorescence which checked that the consumed

i pushed a new commit (ca73508) for extra guard for this after checking the hexdumps. found cases where ETX arrives at end‑of‑packet (though this does not appear to change the measurement data). nonetheless the extra guard avoids consuming partial frames. also note in current code, we already validate measurement frames: ABS checks wavelength (words[1]), FI checks excitation/emission (words[1]/[2]). only LUM has no wavelength field to match.

pylabrobot/plate_reading/tecan_infinite_backend.py

pylabrobot/plate_reading/tecan/infinite_backend.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

rickwierenga

apologies for the late response, I was working on slas and then the old nimbus PR

I have two small initial questions / comments for things I think we can parameterize easily

rickwierenga · 2026-01-21T00:04:09Z

pylabrobot/plate_reading/tecan/infinite_backend.py

+      "TIME 0,LAG=0",
+      "TIME 0,READDELAY=0",
+      "GAIN 0,VALUE=100",
+      "POSITION 0,Z=20000",


"POSITION 0,Z=20000",

do you know what these units are? would be nice to parameterize them as focal_height

pylabrobot/plate_reading/tecan/infinite_backend.py

- USB._read_packet() now accepts optional size to read exact bytes from wire - USB.read() passes remaining byte count to _read_packet() when size specified - PyUSBInfiniteTransport.read() uses new size parameter instead of slicing - USBValidator.read() updated for interface consistency Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Remove InfiniteTransport protocol and PyUSBInfiniteTransport class - TecanInfinite200ProBackend creates USB instance internally as self.io - Move reset logic into backend's _recover_transport method - Simplifies the transport layer by removing unnecessary abstraction Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

rickwierenga · 2026-01-21T00:29:50Z

could you please explain what _MODE_CAPABILITY_COMMANDS are?

are they just more parameters like this?

      f"BEAM DIAMETER={self._capability_numeric('ABS', '#BEAM DIAMETER', 700)}",

that we can add as commands? why not add them?

Replace custom _u16be, _u32be, _i32be helper functions with the Reader class from io/binary using little_endian=False for big-endian parsing. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Remove redundant step_loss local variable and parameter since _end_run can access self._active_step_loss_commands directly. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Inline command lists in _configure_absorbance, _configure_fluorescence, and _configure_luminescence with direct _send_ascii calls - Refactor _cleanup_protocol to use a local helper function instead of building a commands list Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Rename: - _send_ascii -> _send_command - _frame_ascii_command -> _frame_command - _drain_ascii -> _drain - _read_ascii_response -> _read_command_response - _ascii_parser -> _parser Also update related docstrings. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tests verify that open, close, read_absorbance, read_fluorescence, and read_luminescence send the correct USB commands in the correct order. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Reduces duplication across read_absorbance, read_fluorescence, and read_luminescence methods. Also removes unused _active_mode field. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Callers now compute ordered_wells and scan_wells once and pass ordered_wells to _run_scan directly. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

The "Prepare" naming came from the device command "PREPARE REF" but didn't convey what the data actually represents. These structures contain calibration data (dark/bright references, gain values) used to convert raw measurements into calibrated values. Renamed: - _AbsorbancePrepare -> _AbsorbanceCalibration - _FluorescencePrepare -> _FluorescenceCalibration - _LuminescencePrepare -> _LuminescenceCalibration - Related functions, properties, and variables Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Use distinct variable names (cal/data) instead of reusing 'decoded' for both calibration and measurement data decoding to avoid mypy type conflicts. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

The "marker" name was misleading - it's actually the binary payload length extracted from protocol frames like "18,BIN:". The length happens to identify packet type (different packet types have characteristic sizes), but calling it "marker" obscured its true meaning. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

rickwierenga · 2026-01-21T05:09:23Z

pylabrobot/plate_reading/tecan/infinite_backend.py

+  async def _begin_run(self) -> None:
+    await self._initialize_device()
+    self._reset_stream_state()


is there a reason the device would un-initialize? every command calls _begin_run, which calls _initialize_device. but _initialize_device is already called on setup.

rickwierenga · 2026-01-24T22:28:32Z

pylabrobot/plate_reading/tecan/infinite_backend.py

+
+def _integration_value_to_seconds(value: int) -> float:
+  return value / 1_000_000.0 if value >= 1000 else value / 1000.0
+


can you explain this?

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Lazily initialize the asyncio.Lock to avoid "no current event loop" error on Python 3.9, which requires an event loop when creating locks. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

hazlamshamin added 2 commits December 20, 2025 18:04

Fix USB capture decode for malformed escape sequences

de9f0a7

Add Tecan Infinite backend and tests

1e61aae

BioCam requested review from BioCam, Copilot and rickwierenga December 20, 2025 17:24

Copilot AI reviewed Dec 20, 2025

View reviewed changes

rickwierenga and others added 6 commits December 20, 2025 12:31

Update pylabrobot/plate_reading/tecan_infinite_backend.py

f50cebe

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update pylabrobot/plate_reading/tecan_infinite_backend.py

db24038

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Guard ASCII frame parsing for incomplete trailers

ca73508

Refine Infinite backend decoders based on DLL plus refactoring

e92c6db

Add Infinite USB lifecycle cleanup and recovery

59ef4e8

Update Infinite backend decoder tests

da96aa2

rickwierenga reviewed Jan 21, 2026

View reviewed changes

rickwierenga and others added 3 commits January 20, 2026 16:10

remove tecanscanconfig in favor of infinite

9f49e31

rickwierenga mentioned this pull request Jan 21, 2026

Add binary parser #825

Merged

rickwierenga and others added 5 commits January 20, 2026 19:30

Merge branch 'main' into tecan-microplate-reader

0c442a0

Merge branch 'main' into tecan-microplate-reader

6e0119c

Merge branch 'main' into tecan-microplate-reader

14c69fa

Refactor Tecan Infinite backend to use io/binary Reader

bbc0bd9

Replace custom _u16be, _u32be, _i32be helper functions with the Reader class from io/binary using little_endian=False for big-endian parsing. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

move into tecan package

0af381d

rickwierenga mentioned this pull request Jan 21, 2026

Add size parameter to USB read methods #829

Merged

rickwierenga and others added 6 commits January 20, 2026 20:03

Merge main into tecan-microplate-reader

dc783d7

Simplify _end_run to use _active_step_loss_commands directly

0219a2c

Remove redundant step_loss local variable and parameter since _end_run can access self._active_step_loss_commands directly. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Add command verification tests for Tecan Infinite backend

4448f0a

Tests verify that open, close, read_absorbance, read_fluorescence, and read_luminescence send the correct USB commands in the correct order. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Merge branch 'main' into tecan-microplate-reader

d71ff9f

rickwierenga and others added 7 commits January 24, 2026 11:13

Extract common scan loop into _run_scan helper

9bff32c

Reduces duplication across read_absorbance, read_fluorescence, and read_luminescence methods. Also removes unused _active_mode field. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Remove duplicate well computation in _run_scan

1e89fce

Callers now compute ordered_wells and scan_wells once and pass ordered_wells to _run_scan directly. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

remove unused state from configuration

31861e3

Extract common CLEAR commands into _clear_mode_settings helper

98c6490

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Fix type checking errors in decoder _handle_bin methods

4251a5e

Use distinct variable names (cal/data) instead of reusing 'decoded' for both calibration and measurement data decoding to avoid mypy type conflicts. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

rickwierenga reviewed Jan 24, 2026

View reviewed changes

rickwierenga and others added 3 commits January 24, 2026 14:40

Remove packet logging functionality from infinite backend

3dceb24

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

type

073e45e

Fix Python 3.9 compatibility for asyncio.Lock in infinite backend

f407ae2

Lazily initialize the asyncio.Lock to avoid "no current event loop" error on Python 3.9, which requires an event loop when creating locks. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Tecan Infinite 200 PRO plate reader backend (Infinite M Plex) #797

Tecan Infinite 200 PRO plate reader backend (Infinite M Plex) #797

Uh oh!

hazlamshamin commented Dec 20, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI Dec 20, 2025

Uh oh!

hazlamshamin Dec 21, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

rickwierenga left a comment

Uh oh!

rickwierenga Jan 21, 2026

Uh oh!

Uh oh!

rickwierenga commented Jan 21, 2026

Uh oh!

rickwierenga Jan 21, 2026

Uh oh!

rickwierenga Jan 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		def _integration_value_to_seconds(value: int) -> float:
		return value / 1_000_000.0 if value >= 1000 else value / 1000.0

Tecan Infinite 200 PRO plate reader backend (Infinite M Plex) #797

Are you sure you want to change the base?

Tecan Infinite 200 PRO plate reader backend (Infinite M Plex) #797

Uh oh!

Conversation

hazlamshamin commented Dec 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI Dec 20, 2025

Choose a reason for hiding this comment

Uh oh!

hazlamshamin Dec 21, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

rickwierenga left a comment

Choose a reason for hiding this comment

Uh oh!

rickwierenga Jan 21, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

rickwierenga commented Jan 21, 2026

Uh oh!

rickwierenga Jan 21, 2026

Choose a reason for hiding this comment

Uh oh!

rickwierenga Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

hazlamshamin commented Dec 20, 2025 •

edited

Loading