Inheco Thermoshake
This page gets you from an unboxed Thermoshake to a first temperature reading from Python. Inheco's manuals cover speed and temperature ranges per model, adapters, and safety.
A Thermoshake communicates via an Inheco TEC controller: either a Single TEC Control (STC) with 1 device slot or a Multi TEC Control (MTC) with slots for up to 6 devices. The controller connects to the computer over USB. The Inheco TEC Controller connector supports STC or a a single device on a MTC.
What you need
| Item | Detail |
|---|---|
| Instrument | A Thermoshake, plugged into a slot of an STC or MTC, with the controller powered on |
| Cable | The controller's USB cable to the GroundControl machine |
| Controller ID | The controller's DIP switch ID, 0 to 7 |
| Connector | Inheco TEC Controller from the UniteLabs registry |
| Vendor software | None. Close Inheco's own software, so it doesn't hold the controller |
| Machine | Windows, Linux, or macOS running GroundControl |
| Access | A tenant and the SDK installed. See Setup |
Install and configure the connector
- In GroundControl, add a connector and pick Inheco TEC Controller (how to add a connector).
- Fill in the configuration. The fields that matter:
Field Value tec_dip_idThe controller's DIP switch ID, 0to7. Leave it at0unless someone changed the switchesdevice_slotThe slot the Thermoshake is plugged into: 1on an STC,1to6on an MTCdevice_typeThermoshake ACorThermoshake, matching your model. The default isTeleshake 95 AC - Start the connector. GroundControl then shows the modules
SettingsService,ShakingController, andTemperatureController.
icon: i-heroicons-information-circle color: info
The TEC Controller connector also supports other Inheco devices such as Teleshake, Teleshake AC, Teleshake 95 AC, CPAC, CPAC 2TEC and Heated Lid. The interface of a connector is generated based on device type and can be different than for Thermoshake group described here.
::
First successful test
Read device details: the firmware version, the allowed temperature range, the current temperature, and the clamp. This test does not move or heat up the shaker.
from unitelabs.sdk import AsyncApiClient
client = AsyncApiClient()
ts = await client.get_service_by_name(name="InhecoTecController")
print(await ts.settings_service.get_device_info())
print(await ts.settings_service.get_firmware_version())
print(await ts.temperature_controller.get_minimum_temperature(),
await ts.temperature_controller.get_maximum_temperature())
current = await ts.temperature_controller.subscribe_current()
async with current:
print(await anext(current)) # °C
print(await ts.shaking_controller.get_is_clamp_open())
Expected:
- The device info names the controller type (
STCorMTC) and the slot. - The firmware version prints.
- The allowed range prints as 2 values in °C.
- The current temperature prints in °C.
- The clamp prints
Trueif it's open,Falseif it's closed.
Known quirks and errors
| You see | It means | Do this |
|---|---|---|
| The connector doesn't start and can't find a device | No controller with that DIP ID is on USB, or another program holds it | Check the cable and tec_dip_id, and close Inheco's software |
Could not detect external device. | Nothing answers in the configured slot | Check device_slot and that the Thermoshake is plugged in |
Unexpected readings, or Multiple failed responses | More than 1 connector is running for the same MTC | Keep 1 connector running per MTC. If the message stays, run settings_service.reset_device() |
| A target is rejected | It's outside what the device allows | Read get_minimum_temperature() and get_maximum_temperature() first |
Timeout waiting for device reconnection after reset | reset_device() reboots the controller, and it didn't come back in 90 s | Check the controller's power and USB, then restart the connector |
You can access all error codes of the controller with settings_service.get_error_codes().
More snippets
Heat and shake: temperature and shaking start independently.
await ts.temperature_controller.start(target=37) # °C
await ts.shaking_controller.start(target=1000) # rpm
await ts.shaking_controller.stop()
await ts.temperature_controller.stop()
The connector accepts temperature rage of 10 to 135 °C and shaking speeds of 150 to 3000 rpm. The exact range depends on the model;
check it in Inheco's manual. You can read temperature ranges for device using temperature_controller.get_minimum_temperature() and get_maximum_temperature().
Change targets while running: temperature_controller.update_target(target=...) and
shaking_controller.update_target(target=...).
Stop everything: settings_service.emergency_off() switches off all power outputs on the
controller at once.
Connector reference
Browse the connected instrument's modules and actions in GroundControl, or list them in Python with
print(ts.shaking_controller.actions.keys()).
Vendor documentation
Speed and temperature ranges per model, adapters, and safety are in Inheco's Thermoshake and TEC controller manuals.
Last updated
QInstruments ColdPlate
Get a QInstruments ColdPlate or ColdPlate slim connected through GroundControl and hold a first target temperature from Python.
Inheco SCILA
Connect an Inheco SCILA incubator through GroundControl, check that it answers, and read its temperature, doors, and water level from Python.