MelexisIO SCPI Commands
Loading...
Searching...
No Matches
IEEE Mandated Commands

This document describes the SCPI command interface implemented in commands_scpi.c for SCPI (Standard Commands for Programmable Instruments) compliance and system-level queries on the Melexis IO STM32 platform.

Overview

The commands_scpi.c file provides handlers for the core SCPI and IEEE 488.2-mandated commands, as well as required SCPI system and status queries. These commands are essential for instrument identification, status reporting, error handling, and basic system control, ensuring compatibility with SCPI-based test and measurement environments.

Supported Commands

IEEE Mandated Commands (SCPI std V1999.0 4.1.1)

Command Pattern Handler Description
*CLS CMD_Stub Clear Status
*ESE CMD_Stub Event Status Enable
*ESE? CMD_StubQ Query Event Status Enable
*ESR? CMD_StubQ Query Event Status Register
*IDN? CMD_IDN System ID Query
*OPC CMD_Stub Operation Complete
*OPC? CMD_StubQ Query Operation Complete
*RST CMD_RST Reset Device
*SRE CMD_Stub Service Request Enable
*SRE? CMD_StubQ Query Service Request Enable
*STB? CMD_StubQ Query Status Byte
*TST? CMD_StubQ Self-Test Query
*WAI CMD_Stub Wait-to-Continue

Required SCPI Commands (SCPI std V1999.0 4.2.1)

Command Pattern Handler Description
:SYSTem:ERRor? CMD_StubQ Query system error
:SYSTem:ERRor:NEXT? CMD_StubQ Query next system error
:SYSTem:ERRor:COUNt? CMD_StubQ Query error count
:SYSTem:VERSion? CMD_Version Query SCPI version
:STATus:OPERation? CMD_StubQ Query operation status
:STATus:OPERation:EVENt? CMD_StubQ Query operation event
:STATus:OPERation:CONDition? CMD_StubQ Query operation condition
:STATus:OPERation:ENABle CMD_Stub Set operation enable
:STATus:OPERation:ENABle? CMD_StubQ Query operation enable
:STATus:QUEStionable? CMD_StubQ Query questionable status
:STATus:QUEStionable:EVENt? CMD_StubQ Query questionable event
:STATus:QUEStionable:CONDition? CMD_StubQ Query questionable condition
:STATus:QUEStionable:ENABle CMD_Stub Set questionable enable
:STATus:QUEStionable:ENABle? CMD_StubQ Query questionable enable
:STATus:PRESet CMD_Stub Preset status

Custom/Meta

Command Pattern Handler Description
?SCPI NULL System commands group/help

Handler Functions

  • CMD_Stub: Placeholder for unimplemented or NOP commands.
  • CMD_StubQ: Returns a default value (typically 0) for query commands.
  • CMD_Version: Prints the SCPI version (e.g., 1999.0).
  • CMD_IDN: Returns instrument identification string (manufacturer, model, serial, firmware, options).
  • CMD_RST: Performs a system reset with user feedback.

Examples

Query Device Identification

Command sent:

*IDN?\n

Response:

Melexis,IO-STM32,123456,1.0
(OK)>

Reset Device

Command sent:

*RST\n

Response:

(OK)>

Query System Error

Command sent:

:SYSTem:ERRor?\n

Response:

0,"No error"
(OK)>

Query SCPI Version

Command sent:

:SYSTem:VERSion?\n

Response:

SCPI V1999.0
(OK)>

Error Example (Unknown Command)

Command sent:

*FOO\n

Response:

ERR: unknown command
(Some error)>

Notes

  • Most status and error commands are stubs and return default values for SCPI compliance.
  • The command interface is extensible; additional SCPI commands can be added as needed.
  • All commands are case-insensitive.