UniteLabs
Reference

Inheco SCILA

Connect an Inheco SCILA incubator through GroundControl, check that it answers, and read its temperature, doors, and water level from Python.

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

ItemDetail
InstrumentA SCILA, powered on, with water in its reservoir and CO2 connected if you use it
NetworkEthernet, on the same subnet as the GroundControl machine. If commands time out, see known quirks
Device SNThe node name (SCILA_ plus 6 character serial number). Read SN via Inheco software or a from a label on the device itself.
ConnectorInheco SCILA from the UniteLabs registry
Vendor softwareNone
MachineWindows, Linux, or macOS running GroundControl
AccessA tenant and the SDK installed. See Setup
The SCILA connector has no simulation mode, so every script on this page needs a connected SCILA.

Install and configure the connector

  1. In GroundControl, add a connector and pick Inheco SCILA (how to add a connector).
  2. Fill in the configuration. The fields that matter:
    FieldValue
    node_nameThe node name from the device label, e.g. SCILA_04E964. Always set it; the default is only an example
    ip_addressLeave empty. Set it to the SCILA's IP address only if the connector can't find the SCILA by name
  3. Start the connector. It resets the SCILA on every start, even when it's idle. GroundControl then shows the modules DeviceService, AccessCompartmentController, TemperatureController, GasProvider, GasBoostController, and LiquidProvider.
Drive the SCILA from one client at a time. Starting the connector resets the SCILA and takes over its events from whatever else was connected, such as a liquid handler's software.

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, Door1 to Door4.
  • The water level prints one of Empty, Low, Normal, Full, or Overfilled.

The identification, status, and door status come back as plain dicts with PascalCase keys.

Known quirks and errors

You seeIt meansDo this
Startup fails with No SCILA devices were found at allNo SCILA answered discovery: it's off, on another subnet, or the network drops broadcastsCheck 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 unreadableEvery SCILA that answers discovery is logged via connector with its name and IP addressRead 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_nameIt must be SCILA_ plus 6 characters, 0 to 9 and A to FCopy it from the label, in capitals
Commands time out with Timed out waiting for ResponseEventThe SCILA reports finished commands back to the connector, and a firewall on the GroundControl machine blocks itSet 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 4002The water reservoir is empty or nearly emptyRefill it
Error 4003The reservoir is overfilledRemove water
Error 4004The block is off its target temperatureGive it time to reach the target. If it persists, check that the doors are closed, then check the ambient temperature
Error 4005The ambient temperature is too highCheck the airflow around the SCILA
Error 4006CO2 flow is too low or too highCheck the CO2 pressure
returnCode=3002A drawer didn't open or close in timeCheck the drawer for anything blocking it
returnCode=3005A drawer is pulled outPush it back in and retry
returnCode=4The SCILA is busy with another commandWait and retry
NoPendingProcesses on resumeThe SCILA isn't pausedNothing to do
A temperature subscription ends after a commandIt 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