Inheco ODTC

pylabrobot/thermocycling/backend.py

@@ -41,13 +41,45 @@ async def deactivate_lid(self):
     """Deactivate thermocycler lid."""
 
   @abstractmethod
-  async def run_protocol(self, protocol: Protocol, block_max_volume: float):
-    """Execute thermocycler protocol run.
+  async def run_protocol(
+    self,
+    protocol: Protocol,
+    block_max_volume: float,
+    **kwargs,
+  ):
+    """Execute thermocycler protocol run (always non-blocking).
+
+    Starts the protocol and returns an execution handle immediately. To block
+    until completion, await the handle (e.g. await handle.wait()) or use
+    wait_for_profile_completion() on the thermocycler.
 
     Args:
       protocol: Protocol object containing stages with steps and repeats.
       block_max_volume: Maximum block volume (µL) for safety.
+      **kwargs: Backend-specific options (e.g. ODTC accepts config=ODTCConfig).
+
+    Returns:
+      Execution handle (backend-specific; e.g. MethodExecution for ODTC), or
+      None for backends that do not return a handle. Caller can await
+      handle.wait() or use wait_for_profile_completion() to block until done.
+    """
+
+  async def run_stored_protocol(self, name: str, wait: bool = False, **kwargs):
+    """Execute a stored protocol by name (optional; backends that support it override).
+
+    Args:
+      name: Name of the stored protocol to run.
+      wait: If False (default), start and return an execution handle. If True,
+        block until done then return the (completed) handle.
+      **kwargs: Backend-specific options.
+
+    Returns:
+      Execution handle (backend-specific). Same as run_protocol.
+
+    Raises:
+      NotImplementedError: This backend does not support running stored protocols by name.
     """
+    raise NotImplementedError("This backend does not support running stored protocols by name.")
 
   @abstractmethod
   async def get_block_current_temperature(self) -> List[float]:

pylabrobot/thermocycling/chatterbox.py

@@ -97,7 +97,7 @@ async def deactivate_lid(self):
     print("Deactivating lid.")
     self._state.lid_target = None
 
-  async def run_protocol(self, protocol: Protocol, block_max_volume: float):
+  async def run_protocol(self, protocol: Protocol, block_max_volume: float, **kwargs):
     """Run a protocol with stages and repeats."""
     print("Running protocol:")
 

pylabrobot/thermocycling/inheco/__init__.py

@@ -0,0 +1,48 @@
+"""Inheco ODTC thermocycler implementation.
+
+Preferred: use ODTCThermocycler (owns connection params and dimensions):
+
+  tc = ODTCThermocycler(
+    name="odtc1",
+    odtc_ip="192.168.1.100",
+    variant=384,
+    child_location=Coordinate.zero(),
+  )
+
+Alternative: use generic Thermocycler with ODTCBackend (e.g. for custom backend):
+
+  backend = ODTCBackend(odtc_ip="192.168.1.100", variant=384)
+  tc = Thermocycler(
+    name="odtc1",
+    size_x=147,
+    size_y=298,
+    size_z=130,
+    backend=backend,
+    child_location=...,
+  )
+
+Variant accepts 96, 384 or device codes (960000, 384000). Use tc.run_protocol(protocol,
+block_max_volume) for in-memory protocols; tc.run_stored_protocol("my_pcr") for
+stored-by-name (ODTC only).
+"""
+
+from .odtc_backend import ODTCBackend, ODTCExecution
+from .odtc_model import ODTC_DIMENSIONS, ODTCProgress, ODTCProtocol, ProtocolList, normalize_variant
+from .odtc_thermocycler import ODTCThermocycler
+
+# Backward-compat aliases (single execution handle type)
+CommandExecution = ODTCExecution
+MethodExecution = ODTCExecution
+
+__all__ = [
+  "CommandExecution",
+  "MethodExecution",
+  "ODTCBackend",
+  "ODTC_DIMENSIONS",
+  "ODTCExecution",
+  "ODTCProgress",
+  "ODTCProtocol",
+  "ODTCThermocycler",
+  "ProtocolList",
+  "normalize_variant",
+]