v6.2.0

OT-2 Software Changes in 6.2.0

Welcome to the v6.2.0 release of the OT-2 software! This release focuses on adding support for the Thermocycler Module GEN2.

New Features

• Thermocycler GEN2 support
  • Lid temperature is now available when querying module status
  • Pipettes properly move to avoid the GEN2 module

Bug Fixes

• Fixed a bug that could cause hardware modules to become unresponsive

Opentrons App Changes in 6.2.0

Welcome to the v6.2.0 release of the Opentrons App! This release focuses on adding support for the Thermocycler Module GEN2.

New Features

• Thermocycler GEN2 support: analyze, upload, and run protocols that include the Thermocycler GEN2
• Added a privacy preference for sharing anonymous robot logs with Opentrons.

6.1.0

Welcome to the v6.1.0 release of the Opentrons App! This release focuses on adding support for the Opentrons Heater-Shaker Module.

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

New Features

• Heater-Shaker support
  • Access guided setup instructions for attaching the Heater-Shaker to the deck
  • Analyze, upload, and run protocols that include the Heater-Shaker
  • View the status of a Heater-Shaker connected to an OT-2 and control its heater, shaker, and labware latch
  • Update the Heater-Shaker's firmware from the module card
• Module cards now show if a Heater-Shaker or Thermocycler has an error

Improved Features

• Improvements to the run log, including properly listing labware that is on top of a module
• Clarification of what data is deleted when performing a factory reset of protocol run history

Bug Fixes

• Labware Position Check now suggests the most recent Labware Offset data
• Tip Length Calibration no longer silently fails when the chosen pipette is not attached
• Stops the update modal from staying onscreen indefinitely after a robot software update has finished
• Fixes a bug that prevented changing pipette settings when the All Pipette Config feature flag was on
• Interface fixes and improvements

OT-2 Robot Server

New Features

• Heater-Shaker support
  • The OT-2 can run JSON and Python protocols that control the Heater-Shaker Module
  • Implements restrictions on module and labware placement around the Heater-Shaker
  • When possible, the OT-2 will automatically move its pipettes or the Heater-Shaker's labware latch to shake safely and avoid crashes
  • The OT-2 can update the firmware on an attached Heater-Shaker

Bug Fixes

• Improved tip pickup and drop behavior
• Fixed issues when running Thermocycler profiles
• Fixed a bug that prevented pipetting to arbitrary deck coordinates

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.