UniteLabs
Reference

Inheco Thermoshake

Connect an Inheco Thermoshake through its TEC controller and GroundControl, check that it answers, and read its temperature from Python.

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

ItemDetail
InstrumentA Thermoshake, plugged into a slot of an STC or MTC, with the controller powered on
CableThe controller's USB cable to the GroundControl machine
Controller IDThe controller's DIP switch ID, 0 to 7
ConnectorInheco TEC Controller from the UniteLabs registry
Vendor softwareNone. Close Inheco's own software, so it doesn't hold the controller
MachineWindows, Linux, or macOS running GroundControl
AccessA tenant and the SDK installed. See Setup
Each connector controls 1 slot. On an MTC, run the connector for the slot you're working with, and stop it in GroundControl before you start the connector for another slot.
The TEC Controller connector has no simulation mode, so every script on this page needs a connected Thermoshake.

Install and configure the connector

  1. In GroundControl, add a connector and pick Inheco TEC Controller (how to add a connector).
  2. Fill in the configuration. The fields that matter:
    FieldValue
    tec_dip_idThe controller's DIP switch ID, 0 to 7. Leave it at 0 unless someone changed the switches
    device_slotThe slot the Thermoshake is plugged into: 1 on an STC, 1 to 6 on an MTC
    device_typeThermoshake AC or Thermoshake, matching your model. The default is Teleshake 95 AC
  3. Start the connector. GroundControl then shows the modules SettingsService, ShakingController, and TemperatureController.

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 (STC or MTC) 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 True if it's open, False if it's closed.

Known quirks and errors

You seeIt meansDo this
The connector doesn't start and can't find a deviceNo controller with that DIP ID is on USB, or another program holds itCheck the cable and tec_dip_id, and close Inheco's software
Could not detect external device.Nothing answers in the configured slotCheck device_slot and that the Thermoshake is plugged in
Unexpected readings, or Multiple failed responsesMore than 1 connector is running for the same MTCKeep 1 connector running per MTC. If the message stays, run settings_service.reset_device()
A target is rejectedIt's outside what the device allowsRead get_minimum_temperature() and get_maximum_temperature() first
Timeout waiting for device reconnection after resetreset_device() reboots the controller, and it didn't come back in 90 sCheck 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