Undalogic logoUndalogic
Loading Light/Dark Toggle

Documentation

Basic Command Structure

Understanding the command structure for controlling the miniSMU MS01

The miniSMU MS01 uses a command-based interface for operation, following SCPI (Standard Commands for Programmable Instruments) conventions. This section explains the command structure and provides an overview of the available commands.

Command Syntax Overview

Commands are sent to the device through the software interface. The general structure of commands follows this pattern: COMMAND[:SUBCOMMAND] [PARAMETER]

For queries that request information from the device, append a question mark to the command: COMMAND[:SUBCOMMAND]?

Command Structure Elements

Common Command Reference

The following table provides a reference for the most frequently used commands:

CommandFunctionExampleResponse
*IDN?Returns device identification*IDN?Undalogic Ltd, miniSMU MS01, SN12345, v1.0, FW2.3
*RSTReboots the device*RSTDevice restarts

System Commands

System commands control device-wide settings and status:

CommandFunctionExampleNotes
SYST:TIME <time>Sets system timeSYST:TIME 1751312870064UNIX Time in milliseconds
SYST:WIFI DISDisables WiFiSYST:WIFI DISWiFi off
SYST:WIFI ENAEnables WiFiSYST:WIFI ENAWiFi on
SYST:WIFI:AUTO?Queries autoconnectSYST:WIFI:AUTO?0 or 1
SYST:WIFI:AUTO DISDisables autoconnectSYST:WIFI:AUTO DISNo auto-connect
SYST:WIFI:AUTO ENAEnables autoconnectSYST:WIFI:AUTO ENAAuto-connect enabled
SYST:WIFI:SCAN?Scans for networksSYST:WIFI:SCAN?Network list in JSON format
SYST:WIFI?Queries WiFi statusSYST:WIFI?Connection status in JSON format
SYST:WIFI:SSID "<name>"Sets WiFi SSIDSYST:WIFI:SSID "Home_Network"SSID set
SYST:WIFI:PASS "<password>"Sets WiFi passwordSYST:WIFI:PASS "SecurePass123"Password set
SYST:WIFI:SSID?Queries WiFi SSIDSYST:WIFI:SSID?Current SSID
SYST:TEMP?Queries temperaturesSYST:TEMP?Temperature values (ADC, Ch 1, Ch 2)

Source and Output Commands

These commands control the output settings for each channel. Replace x with the channel number (1 or 2):

CommandFunctionExampleNotes
SOURx:CURR:PROT <value>Sets current limitSOUR1:CURR:PROT 0.1100 mA limit on CH1
SOURx:CURR <value>Sets current outputSOUR2:CURR 0.0110 mA on CH2
SOURx:VOLT:PROT <value>Sets voltage limitSOUR1:VOLT:PROT 55V limit on CH1
SOURx:VOLT <value>Sets voltage outputSOUR2:VOLT 3.33.3V on CH2
SOURx:FIMV ENAForce I, Measure VSOUR1:FIMV ENAFIMV mode
SOURx:FVMI ENAForce V, Measure ISOUR2:FVMI ENAFVMI mode
SOURx:DATA:STREAM ON/OFFToggle streamingSOUR1:DATA:STREAM ONStreaming on
OUTPx ON/OFFToggle outputOUTP1 ONOutput enabled

Measurement Commands

These commands perform measurements. Replace x with the channel number (1 or 2):

CommandFunctionExampleNotes
MEASx:VOLT:CURR?Measures V and IMEAS1:VOLT:CURR?Both readings
MEASx:VOLT?Measures voltageMEAS2:VOLT?Voltage value
MEASx:CURR?Measures currentMEAS1:CURR?Current value
MEASx:OSR <value>Sets measurement oversamplingMEAS2:OSR 10210 oversampling (Valid from 0-15)

Data Streaming Commands

For continuous data acquisition:

CommandFunctionExampleNotes
SOURx:DATA:STREAM ONEnables streamingSOUR1:DATA:STREAM ONStreaming started
SOURx:DATA:STREAM OFFDisables streamingSOUR1:DATA:STREAM OFFStreaming stopped
SOURx:DATA:SRATE <rate>Sets target sample rateSOUR1:DATA:SRATE 500500 Hz sampling

Data is sent in batches with a CSV format with the following structure:

1,1751313180797,3.713e-02,-7.441e-10,0

Data Format Fields

FieldExampleDescription
Channel Number1The miniSMU channel (1 or 2)
UNIX Timestamp1751313180797Measurement timestamp in milliseconds
Voltage3.713e-02Voltage measurement in volts (V)
Current-7.441e-10Current measurement in amperes (A)
Range0Current range identifier (debug only)

Command Separators and Terminators

  • Commands are typically terminated with a newline character \n
  • Command responses are typically terminated with a newline character

Command Execution Notes

  • Commands are executed in sequence as received
  • Some commands may take time to complete (e.g., WiFi scanning)
  • Setting commands generally respond with OK as an acknowledgment
  • Query commands will always return a response

Error Messages

If a command encounters an error, the device may return an error message:

  • Syntax errors (SOUR:VOLT example): Invalid SOUR:VOLT command
  • Unknown command: Invalid input format

Software Interface

While you can use these commands directly in advanced programming scenarios, the miniSMU software provides a graphical interface that issues these commands behind the scenes. The software interface includes:

  • Input fields for setting voltage and current values
  • Buttons for enabling/disabling outputs
  • Displays for measurement readings
  • Configuration panels for protection settings
  • Data visualisation for streaming measurements

Understanding the command structure is particularly valuable when:

  • Creating automated test sequences
  • Developing custom software interfaces
  • Troubleshooting device behavior
  • Performing advanced operations not covered in the basic software interface

The next sections will cover more specific operations using these commands, including device identification, configuring outputs, and performing measurements.