measure_amplitude
Measure signal amplitude on PicoScope oscilloscope channels. Use after capture to obtain voltage measurements like peak-to-peak, RMS, or mean values.
Instructions
Measure signal amplitude on a channel.
Note: This requires a recent capture. Call capture_block first.
Args: channel: Channel to measure. measurement_type: Type of amplitude measurement.
Returns: Dictionary containing amplitude in volts and measurement type.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel | Yes | ||
| measurement_type | No | peak_to_peak |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- The @mcp.tool()-decorated measure_amplitude function that defines and implements the tool's execution logic, including input validation via type hints and stubbed measurement handling.
@mcp.tool() def measure_amplitude( channel: Literal["A", "B", "C", "D"], measurement_type: Literal["peak_to_peak", "rms", "mean", "max", "min"] = "peak_to_peak", ) -> dict[str, Any]: """Measure signal amplitude on a channel. Note: This requires a recent capture. Call capture_block first. Args: channel: Channel to measure. measurement_type: Type of amplitude measurement. Returns: Dictionary containing amplitude in volts and measurement type. """ try: if not device_manager.is_connected(): return { "status": "error", "error": "No device connected", } # Check if channel is configured if channel not in device_manager.channel_configs: return { "status": "error", "error": f"Channel {channel} not configured. Configure and capture first.", } # For now, we need to guide the user to capture data first return { "status": "info", "message": "To measure amplitude: 1) Configure channel, 2) Set trigger, 3) Capture block, then extract measurements from captured data", "channel": channel, "measurement_type": measurement_type, } except Exception as e: return { "status": "error", "error": str(e), "channel": channel, } - src/picoscope_mcp/server.py:15-19 (registration)Registration of all tool groups by calling register_analysis_tools(mcp) which in turn registers the measure_amplitude tool via its decorator.
register_discovery_tools(mcp) register_configuration_tools(mcp) register_acquisition_tools(mcp) register_analysis_tools(mcp) register_advanced_tools(mcp) - src/picoscope_mcp/server.py:8-8 (registration)Import of register_analysis_tools function required for tool registration.
from .tools.analysis import register_analysis_tools