Inheco SCILA
This page gets you from an unboxed SCILA to a first temperature reading from Python. Inheco's manual covers gas setup, water, drawer inserts, and safety.
What you need
| Item | Detail |
|---|---|
| Instrument | A SCILA, powered on, with water in its reservoir and CO2 connected if you use it |
| Network | Ethernet, on the same subnet as the GroundControl machine. If commands time out, see known quirks |
| Device SN | The node name (SCILA_ plus 6 character serial number). Read SN via Inheco software or a from a label on the device itself. |
| Connector | Inheco SCILA from the UniteLabs registry |
| Vendor software | None |
| 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 SCILA (how to add a connector).
- Fill in the configuration. The fields that matter:
Field Value node_nameThe node name from the device label, e.g. SCILA_04E964. Always set it; the default is only an exampleip_addressLeave empty. Set it to the SCILA's IP address only if the connector can't find the SCILA by name - Start the connector. It resets the SCILA on every start, even when it's
idle. GroundControl then shows the modulesDeviceService,AccessCompartmentController,TemperatureController,GasProvider,GasBoostController, andLiquidProvider.
First successful test
Read the device identity, its state, the block temperature, which doors are open, and the water level. This example does not move or change state of the device.
from unitelabs.sdk import AsyncApiClient
client = AsyncApiClient()
scila = await client.get_service_by_name(name="Inheco SCILA")
print(await scila.device_service.get_identification())
status = await scila.device_service.subscribe_status()
async with status:
print(await anext(status))
current = await scila.temperature_controller.subscribe_current()
async with current:
print(await anext(current)) # °C
doors = await scila.access_compartment_controller.subscribe_status()
async with doors:
print(await anext(doors))
print(await scila.liquid_provider.get_liquid_level())
Expected:
- The identification prints the device name, serial number, and firmware version.
- The status prints
{'State': 'idle', 'IsLocked': ...}. - The block temperature prints in °C.
- The door status prints a value per door,
Door1toDoor4. - The water level prints one of
Empty,Low,Normal,Full, orOverfilled.
The identification, status, and door status come back as plain dicts with PascalCase keys.
Known quirks and errors
| You see | It means | Do this |
|---|---|---|
Startup fails with No SCILA devices were found at all | No SCILA answered discovery: it's off, on another subnet, or the network drops broadcasts | Check power and cabling, and that both are on the same subnet. Then set ip_address |
You don't know the node_name, or the label is unreadable | Every SCILA that answers discovery is logged via connector with its name and IP address | Read the connector log at INFO level for Broadcast discovered: SCILA_04E964 … at 192.168.1.100, and copy the name into node_name. If several SCILAs are listed, use the one at the IP address you expect |
The configuration is rejected on node_name | It must be SCILA_ plus 6 characters, 0 to 9 and A to F | Copy it from the label, in capitals |
Commands time out with Timed out waiting for ResponseEvent | The SCILA reports finished commands back to the connector, and a firewall on the GroundControl machine blocks it | Set event_listener_port to a fixed port, e.g. 8090, and allow inbound TCP on it. On Windows the connector adds this rule itself when it runs with admin rights |
Error 4001 or Error 4002 | The water reservoir is empty or nearly empty | Refill it |
Error 4003 | The reservoir is overfilled | Remove water |
Error 4004 | The block is off its target temperature | Give it time to reach the target. If it persists, check that the doors are closed, then check the ambient temperature |
Error 4005 | The ambient temperature is too high | Check the airflow around the SCILA |
Error 4006 | CO2 flow is too low or too high | Check the CO2 pressure |
returnCode=3002 | A drawer didn't open or close in time | Check the drawer for anything blocking it |
returnCode=3005 | A drawer is pulled out | Push it back in and retry |
returnCode=4 | The SCILA is busy with another command | Wait and retry |
NoPendingProcesses on resume | The SCILA isn't paused | Nothing to do |
| A temperature subscription ends after a command | It stops when the SCILA finishes a command with a warning (returnCode=12) | Open a new subscription |
More snippets
Open and close a drawer: doors are numbered 1 to 4, and only a single door can be open at a
time. Opening a second door closes the first.
await scila.access_compartment_controller.open(door_id=2)
await scila.access_compartment_controller.close()
Hold a temperature: start accepts 15 to 45 °C. stop switches control off and sets the
target back to 37 °C.
await scila.temperature_controller.start(target=37)
await scila.temperature_controller.stop()
CO2 boost: SCILA gas boost has two modes, automatic and manual boost.
gas_boost_controller.activate() and deactivate() switch the SCILA's automatic boost on and off. This is a permanent setting that survives a power cycle.
For a manual boost, deactivate the automatic boost first so the two don't compete for the valve. Then call gas_boost_controller.start(duration=...) with 120 to 600 seconds. The valve closes after the set time, or earlier if stop() was called. Call activate() again afterwards to enable automatic boost mode. You can use get_is_active() to check the state of automatic boost setting.
Connector reference
Browse the connected instrument's modules and actions in GroundControl, or list them in Python with
print(scila.temperature_controller.actions.keys()).
Vendor documentation
Gas setup, water, drawer inserts, and safety are in Inheco's SCILA manual.
Last updated
Inheco Thermoshake
Connect an Inheco Thermoshake through its TEC controller and GroundControl, check that it answers, and read its temperature from Python.
Inheco ODTC
Connect an Inheco ODTC thermal cycler through GroundControl, check that it answers, and read its temperatures and stored methods from Python.