Thermocycler G-Codes

The Thermocycler accepts the G-code commands listed below.

Tip

These commands rarely change, but you can always check for updates in the Thermocycler's driver file.

G-Code Description
M14 Command: deactivate block
Arguments: none
Example: M14
Response: M14 OK (acknowledge only or error)
M18 Command: deactivate all
Arguments: none
Example: M18
Response: M18 OK (acknowledge only or error)
M104 Command: set plate temperature in °C
Arguments:
  • S: set temperature
  • H: hold time in seconds (optional)
  • V: liquid volume (optional)
  • R: ramp rate (optional)
Example: M104 S95 R25 sets the block temperature to 95 °C using a ramp rate of 25 °C/s.
Response: M104 OK (acknowledge only or error)
M105 Command: get plate temperature in °C
Arguments: none
Response elements:
  • T: target temperature °C
  • C: current temperature °C
Response: M105 T:none C:82.3 OK indicates there is no target temperature and the current temperature is 82.3 °C.
M108 Command: deactivate lid
Arguments: none
Response: OK (acknowledge only or error)
M115 Command: get the Thermocycler's serial number, model, and firmware version
Arguments: none
Response elements:
  • FW: firmware version
  • HW: hardware version
  • SerialNo: serial number of the module
Response: M115 FW:v1.1.1 HW: Opentrons Thermocycler Gen2 SerialNo: TCV220241202A02 OK indicates the module is on firmware version 1.1.1, the model is a Thermocycler GEN2, and the serial number is TCV220241202A02.
M119 Command: get statuses for the lid motor and seal motor
Arguments: none
Response elements:
  • Lid: lid motor status. Can be: open, closed, in between (closed and started opening or vice versa), unknown (has not been homed since boot up)
  • Seal: seal status. Can be: engaged (pushed out and pressed down), retracted (pulled into the lid), in_between (neither engaged or retracted)
Response: M119 Lid: open Seal: retracted OK indicates the lid is open and the seal is retracted.
M126 Command: open lid
Arguments: none
Response: OK (acknowledge only or error)
M127 Command: close lid
Arguments: none
Response: OK (acknowledge only or error)
M128 Command: lift plate. This command is only intended to be sent when the lid is already in the open position. The lid will open further to lift the plate, and then return to the open position.
Arguments: none
Response: OK (acknowledge only or error)
M140 Command: set lid temperature in °C
Arguments: S sets the lid temperature in °C. This parameter is optional. If not defined, the default temperature target is 105 °C.
Example: M140 S100 sets the lid temperature to 100 °C.
Response: OK (acknowledge only or error)
M141 Command: get lid temperature in °C
Arguments: none
Response elements:
  • T: the target temperature in °C
  • C: the current temperature in °C
Response: M141 T:none C:85.0 indicates there is no target temperature and the current temperature is 85 °C.
M411 Command: get error state (available in firmware v1.1.1 and later)
Arguments: none
Response: OK (acknowledge only or error)
M413 Command: clear error state (available in firmware v1.1.1 and later)
Arguments: none
Response: OK (acknowledge only or error)
M566 Command: set ramp rate in °C/s
Arguments: S sets the temperature ramp rate in °C/s (optional). If not defined, the module tries to increase the temperature as fast as possible.
Example: M566 S25 sets the ramp rate to 25 °C/s.
Response: OK (acknowledge only or error)