pylabrobot.formulatrix.mantis.driver.simulator.MantisSimulationPlateClamp.lock#

async MantisSimulationPlateClamp.lock(*, level: int | None = None) → None#

On board 12, release the clamp, lock it at level and wait until it reads clamping done; if it does not, it is released again before raising. On a pressure-board output, switch the valve on and start the pump if it is off; a failure or cancellation releases the valve and restores a pump this clamp started before raising.

On board 12 clamping done is the lock’s timer running out; it does not tell a plate is held.

Parameters:

level (int | None) – one of levels, 1 the weakest. default_lock_level when None. None only on a pressure-board output, which has no levels.

Raises:
  • MantisConfigurationError – if no levels are declared; nothing is sent.

  • ValueError – if level is not in levels, or is given on a pressure-board output; nothing is sent.

  • PlateClampError – at once, after the release, if it reads a state in CLAMPING_FAILED, or the valve does not read back on.

  • MantisTimeoutError – if it does not read clamping done within CLAMP_WAIT_TRIES times CLAMPING_TIMEOUT, polled every CLAMP_STATE_POLL_INTERVAL.

Return type:

None