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:
| Command | Function | Example | Response |
|---|---|---|---|
*IDN? | Returns device identification | *IDN? | Undalogic Ltd, miniSMU MS01, SN12345, v1.0, FW2.3 |
*RST | Reboots the device | *RST | Device restarts |
System Commands
System commands control device-wide settings and status:
| Command | Function | Example | Notes |
|---|---|---|---|
SYST:TIME <time> | Sets system time | SYST:TIME 1751312870064 | UNIX Time in milliseconds |
SYST:WIFI DIS | Disables WiFi | SYST:WIFI DIS | WiFi off |
SYST:WIFI ENA | Enables WiFi | SYST:WIFI ENA | WiFi on |
SYST:WIFI:AUTO? | Queries autoconnect | SYST:WIFI:AUTO? | 0 or 1 |
SYST:WIFI:AUTO DIS | Disables autoconnect | SYST:WIFI:AUTO DIS | No auto-connect |
SYST:WIFI:AUTO ENA | Enables autoconnect | SYST:WIFI:AUTO ENA | Auto-connect enabled |
SYST:WIFI:SCAN? | Scans for networks | SYST:WIFI:SCAN? | Network list in JSON format |
SYST:WIFI? | Queries WiFi status | SYST:WIFI? | Connection status in JSON format |
SYST:WIFI:SSID "<name>" | Sets WiFi SSID | SYST:WIFI:SSID "Home_Network" | SSID set |
SYST:WIFI:PASS "<password>" | Sets WiFi password | SYST:WIFI:PASS "SecurePass123" | Password set |
SYST:WIFI:SSID? | Queries WiFi SSID | SYST:WIFI:SSID? | Current SSID |
SYST:TEMP? | Queries temperatures | SYST: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):
| Command | Function | Example | Notes |
|---|---|---|---|
SOURx:CURR:PROT <value> | Sets current limit | SOUR1:CURR:PROT 0.1 | 100 mA limit on CH1 |
SOURx:CURR <value> | Sets current output | SOUR2:CURR 0.01 | 10 mA on CH2 |
SOURx:VOLT:PROT <value> | Sets voltage limit | SOUR1:VOLT:PROT 5 | 5V limit on CH1 |
SOURx:VOLT <value> | Sets voltage output | SOUR2:VOLT 3.3 | 3.3V on CH2 |
SOURx:FIMV ENA | Force I, Measure V | SOUR1:FIMV ENA | FIMV mode |
SOURx:FVMI ENA | Force V, Measure I | SOUR2:FVMI ENA | FVMI mode |
SOURx:DATA:STREAM ON/OFF | Toggle streaming | SOUR1:DATA:STREAM ON | Streaming on |
OUTPx ON/OFF | Toggle output | OUTP1 ON | Output enabled |
Measurement Commands
These commands perform measurements. Replace x with the channel number (1 or 2):
| Command | Function | Example | Notes |
|---|---|---|---|
MEASx:VOLT:CURR? | Measures V and I | MEAS1:VOLT:CURR? | Both readings |
MEASx:VOLT? | Measures voltage | MEAS2:VOLT? | Voltage value |
MEASx:CURR? | Measures current | MEAS1:CURR? | Current value |
MEASx:OSR <value> | Sets measurement oversampling | MEAS2:OSR 10 | 210 oversampling (Valid from 0-15) |
Data Streaming Commands
For continuous data acquisition:
| Command | Function | Example | Notes |
|---|---|---|---|
SOURx:DATA:STREAM ON | Enables streaming | SOUR1:DATA:STREAM ON | Streaming started |
SOURx:DATA:STREAM OFF | Disables streaming | SOUR1:DATA:STREAM OFF | Streaming stopped |
SOURx:DATA:SRATE <rate> | Sets target sample rate | SOUR1:DATA:SRATE 500 | 500 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
| Field | Example | Description |
|---|---|---|
| Channel Number | 1 | The miniSMU channel (1 or 2) |
| UNIX Timestamp | 1751313180797 | Measurement timestamp in milliseconds |
| Voltage | 3.713e-02 | Voltage measurement in volts (V) |
| Current | -7.441e-10 | Current measurement in amperes (A) |
| Range | 0 | Current 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
OKas 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.