6.0.1

Welcome to the v6.0.1 release of the Opentrons App! This hot fix is focused on fixing bugs in the 6.0.0 release.

This release also includes updates to the robot server. The app will require that you update your OT-2 before running protocols with this version of the app.

Technical Change Log

Opentrons App

Bug Fixes

• The app's "Override Path to Python" advanced setting now works properly on Windows
• It's once again possible to save changes made to pipette settings

OT-2 Robot Server

Bug Fixes

• Protocol uploads to the OT-2 work again when the robot's "Use older protocol analysis method" advanced setting is enabled.

Please note: the 6.0.0 release fixed various protocol analysis bugs. If you have been using the "Use older protocol analysis method" setting, we recommend you turn it off. You might no longer need it, and your protocols will upload to your OT-2 faster with the setting disabled!

6.0.0

Welcome to the v6.0.0 release of the Opentrons App! This release focuses on a visual redesign of the app that offers more ways to manage protocols even when you're not connected to a robot.

This release also includes updates to the robot operating system, so be sure to update any OT-2s before running protocols with this version of the app.

Technical Change Log

New Features

• Updated design: A more polished and modern design, built around the new, always-accessible Protocols, Labware, and Devices sections.
• Protocols section
  • Import multiple protocols and manage them all in one place.
  • In-app protocol analysis lets you import Python and JSON protocol files without connecting to a robot.
  • View deck setup, required hardware, and protocol metadata — before, during, or after a run.
• Labware section
  • Browse labware definitions from the Opentrons Labware Library right in the app.
  • Import custom labware and manage it alongside standard labware.
• Devices section
  • New view for currently available and recently connected robots.
  • See recently run protocols on a robot, including those run from other computers.
  • Run a protocol directly from the robot details page.
  • Easily change a robot's name from the new robot settings page.

Improved features

• Labware Position Check
  • When re-running a protocol, the app will now automatically recommend stored Labware Offset data (from the last 20 runs on that robot) that applies to the same labware and deck slot.
  • When running Labware Position Check, you will see live offset values as you jog the pipette.

5.0.2

Welcome to the v5.0.2 release of the Opentrons OT-2 software! This release is a complete refactor of how the OT-2 communicates with the Opentrons app and features a number of changes to how protocols are loaded and stored on the robot.

Technical change log

New Features

A modern, http-based interface has replaced the RPC endpoints for communicating with the Opentrons App
More thorough information about a protocol is returned to the Opentrons App to enable the display of live protocol status
The most recent protocol analysis and run are stored on the robot to enable easy, quick re-running via the Opentrons App
A new way to use labware offsets in Jupyter notebook and SSH sessions

5.0.1 to 5.0.2

The 5.0.2 hotfix release contains three fixes in the Opentrons App:

1. If you use load_labware_from_definition in your Python protocol, you are now able to use Labware Position Check.
2. User-defined labware labels, if present, are now displayed in "Labware Setup"
3. Certain types of protocol upload failures will now show an error message instead of silently failing.

As well as three related fixes in the robot software:

1. The robot now understands how to use labware loaded via load_labware_from_definition during Labware Position Check.
2. User-defined labware labels are now returned to the Opentrons App from protocol analyses and runs.
3. Protocol file uploads now permit uppercase .json and .py extensions.

5.0.0 to 5.0.1

The 5.0.1 hotfix release contains a small fix to the Labware Position Check to appropriately handle protocols that load pipettes, but never pick up tips with that pipette.

Known Issues

Your last run protocol will not be saved through robot reboots

4.7.0

Version 4.7.0 of the Opentrons App and OT-2 Software is a release focused on stability and behind-the-scenes improvements to our software.

Technical change log

Opentrons App

There are no Opentrons App changes for this release.

OT-2 Software

Bug Fixes

• feat(api,robot-server): upgrade fastapi and pydantic deps
• fix(api): thermocycler error handling
• revert(robot-server): revert attach pipette code back to using the mount
• refactor(api): lock reads to pipettes in the hardware controller
• fix(robot-server): avoid LabwareDefinition type in cal models

4.6.2

Version 4.6.2 of the Opentrons App and OT-2 Software is a release focused on stability and behind-the-scenes improvements to our software as well as a useful experimental command line utility.

Technical change log

Opentrons App

This is a quiet release on the app front as we make some behind-the-scenes improvements to how the app is built, so we don't have any changes to report here.

OT-2 Software

New Features

• The opentrons_simulate command-line application can now estimate protocol duration using the -e option. This feature is experimental, but very cool!

Bug Fixes

• If a protocol is canceled mid-run while there is a tip on a pipette, the tip will be dropped prior to resetting the plunger to avoid contaminating the pipette internals with liquids.
• Fixed a movement planning issue that could cause multi-channel pipettes to collide with the deck when changing pipettes.
• Fixed an issue that could cause the protocol to proceed before an awaited temperature module target was actually hit.
• Fixed a few issues with the faster protocol analysis method added in the 4.5.0 release.
• Fixed type annotations of the ProtocolContext classes.

4.6.1 to 4.6.2

The 4.6.2 hotfix release contains a small bug fix for an issue where the OT-2's max speed settings within a protocol will be ignored.

4.6.0 to 4.6.1

The 4.6.1 hotfix release contains a small configuration change to fix an issue with installing the opentrons PyPI package on computers running Python 3.8 and later. It does not affect the software running on your OT-2.

Known Issues

In 4.6.2 and previous releases, the OT-2 will only use TLS 1.0 for WPA2 Enterprise association. Some RADIUS servers have disabled this version of TLS; it must be enabled to connect the OT-2 to a RADIUS-secured network.

Since version 4.5.0, if a thermocycler encounters an error, the robot will be unable to recognize the error state. If your thermocycler starts blinking its yellow LED, you should cancel your protocol. See issue 8393 for more details.

4.5.0

Version 4.5.0 of the Opentrons App and OT-2 Software is focused on quality-of-life improvements and fixes.

Technical change log

Opentrons App

New Features

• Protocol uploads have been made substantially faster! (See OT-2 section below for more details.)

Bug Fixes

• Fixed issues with the run timer reading 00:00 in the middle of a paused protocol (#7740)

OT-2 Software

New Features

• The OT-2 now uses a faster analysis method on protocol upload
  • Thanks to everyone who beta tested this feature over the last few months!
  • You may revert to the old analysis method with the Use Older Protocol Analysis Method in your OT-2's advanced settings
  • If you encounter any issues (e.g. protocol run errors not caught during upload) please reach out to Opentrons Support or open an issue in GitHub so we can continue to improve this feature

Bug Fixes

• Fixed a regression that prevented use of OT-2 Modules in Jupyter notebook (#8009)
• Fixed an uncaught import error on macOS and Windows (#8154, thanks to Maksim Rakitin for the fix!)
• Fixed a crash caused by invalid calibration data (#7962)

Known Issues

In 4.5.0 and previous releases, the OT-2 will only use TLS 1.0 for WPA2 Enterprise association. Some RADIUS servers have disabled this version of TLS; it must be enabled to connect the OT-2 to a RADIUS-secured network.

4.4.0

Version 4.4.0 of the Opentrons App and OT-2 Software is a release focused on stability and behind-the-scenes improvements to our software.

Technical change log

Opentrons App

This is a quiet release on the app front as we make some behind-the-scenes improvements to how the app is built, so we don't have any changes to report here.

OT-2 Software

New Features

• Triggering a move_to to a labware will now count the labware as "used" in the protocol, allowing it to show up in the calibration list (#7812)
• Various documentation and error message improvements

Bug Fixes

• A new Protocol API version was added - 2.11 - to ensure that liquid handling commands like aspirate and dispense will rejected if the source or destination labware is a tip rack (thanks to @andeecode for reporting #7552!)
• The robot's built-in HTTP server now sends the correct headers for CORS (thanks to Benedict Diederich for reporting #7599!)
• Added guards to prevent resumptions from a delay overriding higher priority pauses (#7773)
• Fixed several memory leaks in module handling that could lead to spurious error logs and other issues (#7641 and #7690)

Known Issues

In 4.4.0 and previous releases, the OT-2 will only use TLS 1.0 for WPA2 Enterprise association. Some RADIUS servers have disabled this version of TLS; it must be enabled to connect the OT-2 to a RADIUS-secured network.

4.3.1

Version 4.3.1 of the Opentrons App and OT-2 Software brings a major new feature: the ability to use multiple modules of the same type in a protocol. For instance, you can use two Opentrons Temperature modules in a protocol at the same time. There are also several bug fixes.

Technical change log

Opentrons App

New Features

• Support for 2 Temperature Modules or 2 Magnetic Modules
• The USB port to which each module is attached is now displayed in the protocol info screen

Bugfixes

• Fix an issue where robots would sometimes not reappear after an update when connected via USB (#7608)

OT-2 Software

New Features

• The OT-2 now supports the use of two Magnetic Modules or two Temperature Modules in the same Python API protocol. See our Help Center article on using modules of the same type for an overview of how this feature should be configured.
• New API level: 2.10. This API level contains a bugfix for an issue where pipettes would move diagonally when accessing the same well one after another (#7156). The fix is only applied when API Level 2.10 is requested in a protocol to avoid changing the behavior of existing protocols.

Bugfixes

• Fixes an issue causing slow protocol uploads in protocols using Thermocycler Modules or Temperature Modules (#7506)
• Fixes an issue where labware could not have a 0 column. You can now once again create custom labware with a column 0 (#7531)
• Fixes an issue where tip length calibration would not be applied during labware calibration, so calibrating labware would cause incorrect movement during protocol runes (#7765)

Known Issues

In 4.3.0 and previous releases, the OT-2 will only use TLS 1.0 for WPA2 Enterprise association. Some RADIUS servers have disabled this version of TLS; it must be enabled to connect the OT-2 to a RADIUS-secured network.

4.3.0 and 4.3.0-rtcfix

Version 4.3.0 was not released publicly. Most people should use a newer release instead.

v4.3.0 was released on 2021-05-06 for our factory to use to provision new OT-2 Refresh robots.

v4.3.0-rtcfix is a special release made much later, on 2022-08-09. It resolves provisioning problems at the factory. It's identical to v4.3.0, except that it uses v1.7.1 of our robot OS instead of v1.7.0.

4.2.0

Version 4.2.0 of the OT-2 and Opentrons App software.

Opentrons App

• Separated the "Pipettes and Modules" page into two separate pages
• Added in a missing prompt to use a calibration block during certain tip-length calibrations
• Removed auto-resume behavior when clicking "Back" from the protocol run cancellation confirmation alert

OT-2 Software and OS

• Upgraded to a newer version of wpa_supplicant to resolve connectivity issues with certain 802.1X networks
  • Please note that the OT-2 still cannot connect to 802.1X networks that require TLS v1.2; we're working on it
• Added a fix for incorrect pipette offset data causing differences in pipettes' Z-positioning
• Fixed pipettes not lowering enough during the "Change Pipette" flow
• Fixed a variety of bugs in how pipette settings are saved that could cause invalid configuration data

Please see the following for more information!

• Technical change log