Labs · Optics and microscopy

PerkinElmer Opera Phenix (PhenixImager SiLA 2 feature)

PerkinElmer Opera Phenix (PhenixImager SiLA 2 feature), adapted from anguyen-23/sila-testing. It reads IsConnected, DeviceState, StagePosition, PlateDetected and 6 more; runs phenix_connect, phenix_disconnect, phenix_stagein, phenix_stageout and 5 more. phenix_connect: open the RCI connection to the named Phenix host and return the device name. A hardware driver: the market serves its fake backend, so no instrument is needed.

hardwareRisk R2licence not assertedcontract_checkedserved on the fake backend
openai4s lab add labs/anguyen-23__sila-testing

Install

Three ways to run this device. Each one serves its fake backend: no instrument, no simulator install and no upstream checkout.

OpenAI4S (one command)

shell
openai4s lab add labs/anguyen-23__sila-testing

Installs the device into the OpenAI4S Lab on its fake backend and starts it. First time? See setup below.

Or, in the workbench, open the Lab tab → Market → Install.

Standalone MHS endpoint

shell
git clone --depth 1 https://github.com/PKU-YuanGroup/OpenMHS.git && cd OpenMHS
PYTHONPATH=MHS/sdk/src python3 -m mhs serve labs/anguyen-23__sila-testing --port 7400
# in a second terminal, from the same directory:
PYTHONPATH=MHS/sdk/src python3 -m mhs describe --endpoint http://127.0.0.1:7400

Serves the device as an MHS endpoint on port 7400 from an OpenMHS clone (Python 3.10 or later, standard library only); describe prints what it offers.

Any MCP host (Claude Desktop, Cursor, …)

mcp configuration
{
  "mcpServers": {
    "sila-testing": {
      "command": "python3",
      "args": [
        "-m",
        "mhs",
        "serve",
        "labs/anguyen-23__sila-testing",
        "--mcp"
      ],
      "env": {
        "PYTHONPATH": "/path/to/OpenMHS/MHS/sdk/src"
      }
    }
  }
}

Add this server to the host's MCP configuration and replace /path/to/OpenMHS with the path of your OpenMHS clone. The host starts the server and talks to it on stdin and stdout.

What it does

Measures

  • IsConnected
  • DeviceState
  • StagePosition
  • PlateDetected
  • AvailableProtocols
  • DeviceDescription
  • execution_known
  • execution_uuid
  • acquisition_progress
  • last_progress_info

Adjusts

Nothing declared.

Actions

phenix_connect
Open the RCI connection to the named Phenix host and return the device name.
phenix_disconnect
Close the RCI connection.
phenix_stagein
Move the stage from Transfer to Operate (RCI LOAD); a plate must already be on the stage.
phenix_stageout
Move the stage from Operate to Transfer (RCI EJECT) so the plate can be removed.
phenix_stop
Stop the running acquisition protocol (RCI STOP); the e-stop of this package.
phenix_goidle
Return the device to Idle (RCI IDLE).
phenix_gostandby
Put the device into Standby for DurationSeconds before it wakes up (RCI STANDBY).
phenix_runacquisitionprotocol
Run a named acquisition protocol on the plate; progress per well; ejects when done.
phenix_displayicon
Publish the instrument icon PNG as an artifact (a UI icon, not an acquired image).

Names as the driver declares them. Units, limits and the safety declaration are in the package's REFERENCE.md.

First-time setup

The OpenAI4S workbench with the OpenMHS lab, from a source checkout:

shell
# OpenAI4S workbench with the OpenMHS lab (source checkout)
git clone --recursive https://github.com/PKU-YuanGroup/OpenAI4S.git
cd OpenAI4S && ./setup.sh && source .venv/bin/activate
openai4s lab add labs/anguyen-23__sila-testing
openai4s serve        # open the Lab tab

The standalone endpoint and the MCP server need only an OpenMHS clone and Python 3.10 or later. More in the market's getting-started guide and on the OpenAI4S host page.

Source and evidence

Pinned commit
0b572380e069
Licence
NOASSERTION
Stars
0
Evidence
contract_checked on the fake backend
Backends
fake, hardware

The upstream repository asserts no licence (NOASSERTION); check it before you redistribute the upstream code.

The driver package MHS/drivers/labs/anguyen-23__sila-testing wraps the upstream code at the pinned commit. Its REFERENCE.md documents the full contract: every value, action, unit, limit and the safety declaration.