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:
objectCERTUS 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 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.
Read pending native issues without acknowledging or clearing them.
Read controller X/Y/Z positions in mm (controller coordinates).
Read actual dispensing pressure in bar.
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.
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.
Check the installed head against the explicitly selected channel mapping.