ALBA EM2 four-channel electrometer — device market

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/maxiv-kitscontrols__sardana-albaem

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/maxiv-kitscontrols__sardana-albaem --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": {
    "sardana-albaem": {
      "command": "python3",
      "args": [
        "-m",
        "mhs",
        "serve",
        "labs/maxiv-kitscontrols__sardana-albaem",
        "--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

identity
acquisition_state
nb_points_ready
current_ch1
current_ch2
current_ch3
current_ch4
range_ch1
range_ch2
range_ch3
range_ch4
inversion_ch1
inversion_ch2
inversion_ch3
inversion_ch4

Adjusts

acquisition_mode
integration_time
nb_points
trigger_mode
trigger_input
trigger_polarity
trigger_precision
trigger_delay
timestamp_data

Actions

measure_current: Measure current on a declared channel and return the value with its timestamp and range.
configure_channel: Read or set the amplifier range and digital inversion of one channel
start_acquisition: Start an acquisition with the current settings
software_trigger: Send a software trigger to the electrometer
stop_acquisition: Stop the acquisition and the streaming receiver (the native stop, the safe state)

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/maxiv-kitscontrols__sardana-albaem
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

Upstream: maxiv-kitscontrols/sardana-albaem
Pinned commit: 99e701a51017
Licence: GPL-3.0
Stars: 0
Evidence: contract_checked on the fake backend
Backends: fake, hardware

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