pylabrobot.gyger.CertusFlex#

class pylabrobot.gyger.CertusFlex(host: str, *, head: Literal['flex5', 'flex8', 'flex4_angled', 'flex8_angled'], target: str | None = None, port: int | None = None, timeout: float = 60, poll_interval: float = 0.05, source_ip: str | None = None)#

Bases: object

CERTUS FLEX dispenser with explicit motion and pressure control.

setup() only connects and reads identity. initialize() may move axes; call it separately with the workspace clear. valves[0] is the first channel printed on the selected head (channel 1 in CERTUS CONTROL).

Parameters:
  • host (str) – Controller IP for direct UDP, or the PC running INCO server when target is set.

  • target (str | None) – Omit for direct UDP; set to a local INCO server target name to use TCP.

  • head (Literal['flex5', 'flex8', 'flex4_angled', 'flex8_angled']) – Installed head geometry, required to select the correct valve outputs.

  • port (int | None) – Override the default UDP port 1964 or INCO server TCP port 7979.

  • source_ip (str | None) – Optional local IPv4 address for the direct UDP connection.

  • timeout (float) – Maximum seconds for a command or completion wait.

  • poll_interval (float) – Seconds between state queries.

Methods

__init__(host, *, head[, target, port, ...])

Configure a disconnected dispenser.

abort()

Abort the active controlled operation and close valves without a recovery move.

clean_cycle(channels, *, prime_duration, ...)

Move to purge, repeat purge → 250 ms wait → prime, then park.

close_all()

Close all selected-head valves after any active operation finishes.

configure_channel(channel, *, calibration, ...)

Validate declared fluid/valve identity and installed head, then bind calibration.

dispense_to_well(registration, well, volume, ...)

Move to a PLR well and deliver a calibrated volume in µL.

execute_plan(plan, *[, speed, control])

Execute grouped requests and return the number of confirmed doses.

flush(channels, *, duration[, speed, control])

Flush continuously into prime waste for a controller-enforced duration in seconds.

get_faults()

Read pending native issues without acknowledging or clearing them.

get_position()

Read controller X/Y/Z positions in mm (controller coordinates).

get_pressure()

Read actual dispensing pressure in bar.

get_status()

Read dispenser, coordinator, positioning, head, and pressure states.

idle_purge(channels, *, interval, cycles, ...)

Run a finite host-scheduled purge into waste whenever the device is available.

initialize()

Start the dispenser if needed and reference the axes; this can move hardware.

load_configuration(path)

Atomically load declared channel configuration after identity and head checks.

move_to(x, y, z, *[, speed])

Move to controller coordinates in mm using a named firmware speed profile.

move_to_prime(*[, speed])

Raise Z to park, position XY at prime, then lower Z to prime.

move_to_purge(*[, speed])

Raise Z to park, position XY at purge, then lower Z to purge.

move_to_well(registration, well, *, channel)

Position a registered well under one channel using vertical clearance moves.

park(*[, speed])

Park Z first, then XY, using the controller's configured park positions.

plan_dispense(registration, steps, *[, ...])

Validate an entire plate recipe before any hardware commands.

read_plate_registration(plate, *, bounds[, ...])

Read the active controller plate definition and channel offsets without moving.

save_configuration(path)

Save declared channel identities, correction factors, and curves for this device/head.

set_pressure(pressure)

Set dispensing pressure to 0.051–1 bar, or zero to discharge.

setup()

Connect and read identity without moving or pressurizing the machine.

stop()

Disconnect; this does not abort controller motion or turn off pressure.

validate_head()

Check the installed head against the explicitly selected channel mapping.