fix(api): Fix liquidProbe error message after blowout

[SyntaxColoring]

Overview

This is the error message fix part of RQA-3171.

Test Plan and Hands on Testing

from opentrons import protocol_api


requirements = {"robotType": "Flex", "apiLevel": "2.20"}


def run(protocol: protocol_api.ProtocolContext):
    reservoir = protocol.load_labware("agilent_1_reservoir_290ml", "A1")
    tip_rack = protocol.load_labware("opentrons_flex_96_filtertiprack_1000ul", "A2")

    pipette = protocol.load_instrument(
        "flex_1channel_1000", mount="left", tip_racks=[tip_rack]
    )

    trashbin = protocol.load_trash_bin("A3")

    # disable liquid presence detection on the pipette
    pipette.liquid_presence_detection = False

    # dry aspirate to prove it is off
    protocol.comment(f"Reservoir in {reservoir.parent} is to have NO liquid")
    pipette.pick_up_tip()
    pipette.aspirate(1000, reservoir["A1"])

    pipette.blow_out(trashbin)

    protocol.comment(f"Current volume in pipette: {pipette.current_volume}")  # prints 0

    is_liquid_in_reservoir = pipette.detect_liquid_presence(reservoir["A1"])
    protocol.comment(f"Is there liquid in the reservoir? {is_liquid_in_reservoir}")

pipenv run opentrons_simulate rqa_3171.py

Before:

ProtocolCommandFailedError [line 37]: Error 4000 GENERAL_ERROR (ProtocolCommandFailedError): TipNotEmptyError: This operation requires a tip with no liquid in it.

After:

ProtocolCommandFailedError [line 37]: Error 4000 GENERAL_ERROR (ProtocolCommandFailedError): PipetteNotReadyToAspirateError: The pipette cannot probe liquid because of a previous blow out. Run a prepareToAspirate command in a safe place to reset the plunger.

Changelog

When we're not ready to do a liquidProbe, be a little bit finer-grained about why we're not ready. Give the "missing tip" case and "plunger not ready" case their own error messages.

Review requests

See comments below.

Risk assessment

Low.

[SyntaxColoring]

Documentation correction, no behavioral change.

[sfoster1]

nit re: error message wording

[sfoster1]

Excellent, thank you!