Title: Software Error Code List Document #: DES-00280

Revision #: 05

1. PURPOSE
This purpose of this document is to describe and define the format as well as the specific error codes
produced on the T2Dx instrument.

2. SCOPE
This document applies to both the module firmware and MainController application software for the T2Dx
instrument while an assay is running. Errors occurring during daily tasks (i.e. Autotune, SelfTest or UVSoak) will
display a message box with a text explanation.

3. RESPONSIBILITIES
Function / Responsibility
Individual Contributor
Software Group The software group will maintain this document when necessary.

4. REFERENCES
Document Number Document Title
DES-00280-F1 T2Candida & T2Candida 1.1 Assay Definitions
DES-00280-F2 T2Bacteria Assay Definitions
DES-00280-F3 T2Cauris Assay Definitions
DES-00280-F4 T2Lyme Assay Definitions
DES-00280-F5 T2Carba Resistance+ Assay Definitions

5. ABBREVIATIONS AND DEFINITIONS

Term Definition
Assay A particular test panel to execute on the T2Dx Instrument
Cutoff Value A threshold value of the response where a response value above or equal to
the threshold indicates the assay detected the target and a response value
below the threshold indicates the assay did not detect the target.
PCR Polymerase chain reaction
Safe Wait A defined wait period that is allowed to elapse from the end of one task until
the beginning of the next task within a single assay. Once this period has
elapsed the result is flagged as invalid.
Threshold A defined value to determine if a target is identified to be a valid reading or
not. An “Upper Threshold” is a value in which valid readings must be below
the defined value, while a “Lower Threshold” is a value in which valid
readings must be above the defined value.

6. ERROR CODE FORMAT

Error codes produced by the T2Dx instrument during assay execution and generated from the firmware will be
displayed in the following format, AAAAA.BB.C.DDD.EE, clearly defining the error that occurred. Error codes
that are generated by the Main Controller software as a response to a firmware error will display in the
format, AAAAA.BB.C.DDD.EE. Error codes that are generated by the Main Controller software separate from
the firmware and/or outside of assay execution will display only the generic error code field, AAAAA. The field
descriptions are defined in Table 1.

Effective Date: 03/11/2019 Document Owner: Product Development Page 1 of 9

T2 Biosystems Confidential Information – Company Private

Title: Software Error Code List Document #: DES-00280
Revision #: 05

Table 1: Error Code Fields

Field Field Description
AAAAA Generic error code (3 or 5 digits)
BB Module type
C Drawer number
DDD Script name
EE Script step

6.1. Generic Error Code Definitions

The generic error code, depicted by ‘AAAAA’, is either a three or five digit code thrown by the T2Dx
software. A three digit code is related to the module firmware and is defined in Table 2. A five digit code is
related to the MainController application and is defined in Table 3.

Table 2: Module Firmware Error Codes

‘AAA’ Error Name Description
000 EC_OK = 0 No Error
001 EC_PENDING Indicate that an operation has not yet finished
002 EC_FAILED Generic failure code.
003 EC_TIMEOUT Could not complete in the allocated time
004 EC_UNSUPPORTED_BOARD Incorrect board type for application
005 EC_WRONG_CLOCK Incorrect clock value for call
006 EC_UNSUPPORTED_CHANNEL Incorrect channel value for call
007 EC_UNDEFINED Pre-initializer. The error variable has not yet been set
008 EC_BAD_ARGUMENT Bad argument passed into function
009 EC_NOT_FOUND The requested value could not be found
010 EC_RANGE Range error
Check error. A value (eg) sensor failed a check (eg with
011 EC_CHECK
another sensor)
012 EC_NULL_POINTER Null pointer found.
013 EC_NOT_IMPLEMENTED A function not yet implemented
014 EC_BLANK_MAC_ADDRESS The MAC address is not programmed in User Regs
015 EC_QUEUE_OVERFLOW Msg Queue is full
016 EC_MSG_UNKNOWN Msg not recognized
EC_INCOMPATIBLE_APP_SLAVE_V
017 Cannot run the app on this version of the slave library
ERSION
The flash user register in question isn't blank and can't be
018 EC_FLASH_NOT_BLANK
overwritten
The module/device in question has been initialized
019 EC_ALREADY_INITIALISED
already. Re-initialization will have no effect.
020 EC_NOT_INITIALISED Module not initialized
021 EC_NOT_STARTED Module not started
022 EC_STOPPING operation is stopping
023 EC_APP_NOT_INITIALISED App Msg Q not ready but a msg was received for it
024 EC_SETTINGS_LOAD_FAIL Failed to read valid settings from Flash
025 EC_SETTINGS_SAVE_FAIL Failed to write valid settings to Flash

Effective Date: 03/11/2019 Document Owner: Product Development Page 2 of 9

T2 Biosystems Confidential Information – Company Private

Title: Software Error Code List Document #: DES-00280
Revision #: 05

‘AAA’ Error Name Description

026 EC_SETTINGS_ERASE_FAIL Failed to erase Flash block
027 EC_SETTINGS_INVALID Bad Setting Value (buffer too long/short)
028 EC_BOARD_UNDEFINED Board type undefined
The flash user register in question has already been
029 EC_FLASH_COMMITTED
committed.
The user register value requested has been modified
030 EC_USERREG_MSB_SET
automatically; it's MSB has been set.
031 EC_REVERT_SETTINGS_INVALID Failed to revert to default or previous settings
032 EC_FAILED_START Failed to start the requested operation.
033 EC_LOCK_TIME_EXCEDED Maximum Interrupt lock time was exceeded
Slave Controller Errors
050 EC_CONTROLLER_ERROR = 50 Unspecified controller error
051 EC_NOT_ACTIVATED The controller in question has not been activated.
052 EC_ACTIVATION_FAILURE Module failed to activate
053 EC_ACTIVATION_CANCELLED Activation was cancelled
054 EC_NOT_READY Failed because controller was not in the ready state
055 EC_BUSY A module is busy
056 EC_DEACTIVATION The module is deactivating
057 EC_CANCELLED Operation cancelled
058 EC_OPERATION_CANCELLED Indicates that an operation cancelled successfully.
059 EC_BROKEN_VORTEXER_BELT Indicates a broken vortexer belt.
060 EC_BELT_SENSOR_TIMEOUT Belt sensor failed to ready in time.
Protocol Errors
100 EC_PROTOCOL_BASE = 100 Unused
101 EC_PROTOCOL_BAD_HEADER Bad header
102 EC_PROTOCOL_BAD_VERSION Bad or invalid msg version
103 EC_PROTOCOL_BAD_CHECK Bad check word
104 EC_PROTOCOL_BAD_CMD_ID Command Id incorrect
EC_PROTOCOL_CMD_NOT_IMPLE
105 Command Id not implemented
MENTED
ADC Errors
200 EC_ADC_BASE = 200 Unused
201 EC_ADC_UNDEFINED Not a valid device or channel
202 EC_ADC_UNINITIALISED Attempted to use before init
Development Stream Errors
EC_DEVELOPMENTSTREAM_NOT_
300 Trace Buffer not initialized (used for data sent to PEEP)
INITIALISED = 300
EC_DEVELOPMENTSTREAM_BUFF
301 Trace Buffer Full
ER_FULL
EC_DEVELOPMENTSTREAM_PBUF
302 Trace Buffer protocol error
_ERROR
EC_DEVELOPMENTSTREAM_LWIP
303 Development stream LWIP error
_ERROR
Software Timer Errors

Effective Date: 03/11/2019 Document Owner: Product Development Page 3 of 9

T2 Biosystems Confidential Information – Company Private

Title: Software Error Code List Document #: DES-00280
Revision #: 05

‘AAA’ Error Name Description

400 EC_ST_BASE = 400 Unused
401 EC_ST_NOT_RUNNING Software Timer not running
402 EC_ST_WILL_NOT_RUN Software Timer will not fire
Pipetting level following
EC_PIPETTE_CALCULATION_ERRO
410 Cannot achieve desired move
R = 410
411 EC_PIPETTE_BOTTOMING_LIMIT Desired action would crash the tip
EC_PIPETTE_INITIAL_POSITION_ER
412 Bad initial pos for level follow
ROR
413 EC_PIPETTE_VOLUME_ERROR Cannot aspirate more than the tube has
414 EC_PIPETTE_DELAYED_DISPENSE Dispense delay exceeds maximum
415 EC_PIPETTE_GEOMETRY_ERROR Tube geometry outside limits
416 EC_PIPETTE_TOP_LIMIT Move ends outside tube
Stepper Motor Profiler
420 EC_SMP_ERROR = 420 Unused
421 EC_SMP_MAX_SPEED_EXCEEDED Requested move would exceed maximum speed
422 EC_SMP_MALFORMED_SEGMENT Requested move segments impossible
423 EC_SMP_PROFILE_DISCONTINUOUS Requested move segments discontinuous
424 EC_SMP_MAX_SEGMENTS_EXCEEDED Requested move exceeds maximum segments
425 EC_SMP_MAX_PROFILES_EXCEEDED Requested move exceeds maximum profiles
426 EC_SMP_MAX_STOP_UNSUPPORTED Soft stop is only supported for 3 segment profiles
Stepper Motor Mover
440 EC_SMM_LOCATION_INVALID = 440 Unused
441 EC_SMM_MOVE_TIMEOUT Move did not complete within expected time
442 EC_SMM_COARSE_HOME_TIMEOUT Did not execute rapid return
443 EC_SMM_FINE_HOME_TIMEOUT Did not fine adjust to home position
444 EC_SMM_USER_SHUTDOWN API call to kill motor
445 EC_SMM_NO_PROFILE Move attempted before profile calculated
Robot Axis Positioner
EC_RAP_LOW_POSITION_LIMIT =
450 Desired position exceeds limit of its axis
450
451 EC_RAP_HIGH_POSITION_LIMIT Cannot go past end of axis (or pipette pump)
452 EC_RAP_POSITION_INVALID Axis has not been homed after an error
453 EC_RAP_MOVE_FEEDBACK_ERROR Encoder does not agree with move demanded
Homer Using Quadrature Encoder
EC_AXIS_HOMER_QENC_FAILED_T
455 Failed to find index position when homing
O_INDEX = 455
EC_AXIS_HOMER_QENC_FAILED_T
456 Failed to clear index position when homing
O_RESET
Homer Using Limit Switch
EC_AXIS_HOMER_LIMIT_SWITCH_
457 Failed to get back homing
FAILED_TO_RETURN
EC_AXIS_HOMER_LIMIT_SWITCH_
458 Failed to nudge into place
FAILED_TO_FINE_POS

Effective Date: 03/11/2019 Document Owner: Product Development Page 4 of 9

T2 Biosystems Confidential Information – Company Private

Title: Software Error Code List Document #: DES-00280
Revision #: 05

‘AAA’ Error Name Description

EC_AXIS_HOMER_LIMIT_SWITCH_
459 test switch failed
CHECK_FAILED
UV Lamp
460 EC_UV_LAMP_FAILED_TO_TURN_ON Lamp failed to reach brightness
461 EC_UV_LAMP_FAILED_TO_TURN_OFF Failed to turn off or sensor/adc failed
462 EC_UV_LAMP_FAILED Lamp too dim
463 EC_UV_LAMP_TIMEOUT Timed out automatically (not an error)
464 EC_UV_SENSOR_FAILED Bad value from sensor
Robotics
480 EC_ROBOT_MOVE_TIMEOUT = 480 Move did not complete in expected time
481 EC_ROBOT_MOVE_GROUP_EXCEEDED Too many moves in a group (simultaneous)
482 EC_ROBOT_TUBE_DETECT_FAIL Unused
Quadrature Encoder
490 EC_QE_READ_FAILED = 490 Failed to read the encoder
Error in the Brushless DC Motor Driver
500 EC_BLDC = 500 General Brushless DC Motor failure
501 EC_BLDC_INITIALISE BLDC driver could not initialize - invalid config
502 EC_BLDC_INVALID_DUTY_CYCLE Invalid duty cycle requested
503 EC_BLDC_NOT_INDEXED BLDC motor failed to detect encode index
504 EC_BLDC_INVALID_DIRECTION BLDC moved in an invalid direction
505 EC_BLDC_DUTY_CYLCE_LIMIT BLDC reached duty cycle limit
506 EC_BLDC_SPEED_ERROR Rotor speed went out of the allowable range
507 EC_BLDC_HALL_ERROR Invalid hall sensor reading.
508 EC_BLDC_SENSOR_ERROR Hall/encoder sensor alignment error
DC Motor Drive Errors
509 EC_DC_OPEN_TIMEOUT Drawer or door failed to completely open within timeout
510 EC_DC_CLOSE_TIMEOUT Drawer or door failed to completely close within timeout
511 EC_DC_MOTOR_INTERLOCK Motor interlock active
BLDC Spin Operation Errors
512 EC_OS_START_FAILURE Unused
513 EC_OS_BLDC_FAIL Unused
Centrifuge Specific Errors
514 EC_CE_LID_NOT_CLOSED Centrifuge spin is requested while door is not closed.
Barcode Reader
550 EC_BARCODE_QUEUE_FULL = 550 Barcode scan queue is full
551 EC_BARCODE_BUFFER_FULL Barcode input buffer is full
552 EC_BARCODE_BAD_CHECKSUM Barcode detected a bad checksum

Table 3: Main Controller Application Error Codes

‘AAAAA’ Error Name Description
20001 TipNotDetected Tip not detected
20002 TubeNotDetected Tube not detected
20003 CommandCancelled Command got cancelled

Effective Date: 03/11/2019 Document Owner: Product Development Page 5 of 9

T2 Biosystems Confidential Information – Company Private

Title: Software Error Code List Document #: DES-00280
Revision #: 05

‘AAAAA’ Error Name Description

20004 UnrecoverableError Error is unrecoverable
20005 ControlInactive Control is inactive
20006 CommunicationError Communication error
20007 InvalidValueInConfig Invalid value found in configuration
20008 MRRAutotuneSetup Error during autotune setup
20009 MRRMeasureError Error during MR measure
20010 ControlCommandFailed Control's command failed
20011 ThermocyclerBlockDisabled Thermocycler's block control is disabled
20012 TubeWellNotAvailable Tube well is not available
20013 TubeNotInTubeWell Tube is not in tubewell
20014 InvalidControlForTube Trying to load a tube in invalid control
20015 InvalidChecksumInSlaveMessage Check sum is invalid
20016 MismatchVersionInSlaveMessage Version is mismatched
20017 AspirationRetryFailed Aspiration retry failed
20018 SafeWaitViolation Safe wait time exceeded limit
20019 PrintError Print error
Temperature is not at target during script
20020 TemperatureNotAtTarget
running
20021 AutotuneNotDoneOnScheduled Autotune has not done in calibration period
Autotune has shifted by more than limit from
20022 AutotuneShiftedMoreThanThreshold
last autotune
20023 IncorrectConfigurationFileChecksum Checksum for configuration file is invalid
SNR for autotune has shifted by more than
20024 AutotuneSNRShiftedMoreThanThreshold
limit from last autotune
20025 UvLampError UV lamp error
20026 SelfTestFailed Selftest failure
20027 MeasurementError T2, SNR or Fit residual value is invalid
20028 PCRTimeoutError PCR process is taking longer
The error code indicates that due to a drawer
error, a potential collision between the
20029 DrawerAndPipettingRobotCollisionError
pipetting robot and the drawer has failed an
assay.
The pipetting robot or gripper robot can’t
20030 RobotPositionError
move to the target position.
The MR reader can’t respond within the
20031 MRReaderTimeoutError
allotted time.
The heated vortexer can’t be shared with
20032 HeatedVortexerShareError
another script.
The script has been stopped before
20033 ScriptStoppedError
completion for an unknown reason.
The error code indicates that a potential
20034 GripperRobotAndPipettingRobotCollisionError collision between the gripper robot and the
pipetting robot has failed an assay.

Effective Date: 03/11/2019 Document Owner: Product Development Page 6 of 9

T2 Biosystems Confidential Information – Company Private

Title: Software Error Code List Document #: DES-00280
Revision #: 05

6.2. Module Definitions

The module type code, depicted by ‘BB’, is always a two digit code thrown by the T2Dx software defined
in Table 4.

Table 4: Module Type

‘BB’ Robot Axis or Module

00 Unknown
01 Centrifuge
02 Drawer
03 Environmental Control
04 Gmaa
05 Incubator
06 37C Incubator (Low)
07 95C Incubator (High)
08 Gripper Robot
09 HVO1
10 HVO2
11 Pipetting Robot
12 MR Reader
13 MR Thermal Control
14 Thermocycler1Bank1
15 Thermocycler1Bank2
16 Thermocycler2Bank1
17 Thermocycler2Bank2
18 UV Control
19 Vortexer

6.3. Drawer Number Definitions

The drawer number code, depicted by ‘C’, is always a single digit code between 1 through 7 and is thrown
by the T2Dx software correlated by the drawer the assay is running in.

6.4. Script Name Definitions

The script name code, depicted by ‘DDD’, is either a two or three digit code thrown by the T2Dx software.
A two digit code is related to a commercially available or a future commercial script and is defined in
Table 5. A three digit code is related to non-commercial or internal script, contact Service & Support
Management for a list of these error codes if necessary.

Table 5: Commercial Script Name Code

‘DD’ Script name

00 Unused
01 T2Candida
02 T2Candida 1.1
03 T2Bacteria

Effective Date: 03/11/2019 Document Owner: Product Development Page 7 of 9

T2 Biosystems Confidential Information – Company Private

Title: Software Error Code List Document #: DES-00280
Revision #: 05

‘DD’ Script name

04 T2CAuris
05 T2Lyme
06 Reserved for future use
07 T2Carba Resistance+
08 Reserved for future use
09 Reserved for future use
10 Reserved for future use

6.5. Script Step Definitions

The script step, depicted by ‘EE’, is always a two digit code between 00 and 99 and is thrown by the T2Dx
software correlated to the task number the error occurred at, as defined in the assay specifications and
test definitions document. The task definitions and correlation to the task description is defined in the
documents outlined in Table 6.

Table 6: Assay Task Definitions

Panel Document
T2Candida &
DES-00280-F1
T2Candida 1.1
T2Bacteria DES-00280-F2
T2Cauris DES-00280-F3
T2Lyme DES-00280-F4
T2Carba
DES-00280-F5
Resistance+

Effective Date: 03/11/2019 Document Owner: Product Development Page 8 of 9

T2 Biosystems Confidential Information – Company Private

 Title: Software Error Code List Document #: DES-00280
Revision #: 05

7. DOCUMENT HISTORY
Revision Effective Date For released documents: Description of Change
CO #
For unreleased
documents: person who
made the change
01 02/28/2014 CO-02022 Initial release
02 01/15/2015 CO-03023 Added EC 20029 through 20033.
03 02/20/2015 CO-03138 Added EC 20034.
04 12/01/2017 CO-05156 Updated for new detailed service error
codes, to include module type, drawer,
assay, task of the error.
05 03/11/2019 CO-05413 Added additional assay codes (T2Lyme &
T2CR+), removed non-commercial assays,
and updated references to use newly
created DES-00280 FORMS.

Effective Date: 03/11/2019 Document Owner: Product Development Page 9 of 9

T2 Biosystems Confidential Information – Company Private