1.10. SYSTem Subsystem

1.10.1. SYSTem:VERSion?

The SYST:VERS? query returns the firmware and hardware version of the power supply. The returned value has the form Firmware Rev. X.X, Hardware Rev. X.X.

Query Syntax:: SYSTem:VERSion?
Examples:: SYST:VERS?, SYSTEM:VERSION?
Return Param:: <Firmware Rev. XX.Y, Hardware Rev. XX.Y>

1.10.2. SYSTem:ERRor?

The SYST:ERR? query returns the error messages that have occurred in the system. The format of the return string is an error number followed by corresponding error message string. The errors are stored in a FIFO (first-in, first-out) buffer. As the errors are read, they are removed from the queue. When all errors have been read, the query returns 0, “NO ERROR.” If more errors have accumulated than the queue can hold, the last error in the queue will be -350, “Queue Overflow.” When system errors occur, the Standard Event Status Register (ESR), records the error groups as defined in Table 1.6. Table 1.7 lists system errors that are associated with SCPI syntax errors and with interface problems.

Query Syntax:: SYSTem:ERRor?
Examples:: SYST:ERR?, SYSTEM:ERROR?
Return Param:: <error number> | <error string>

Table 1.6 Standard Event Status Register Error Bits
Bit	Error Code	Error Type
5	100 through -199	Command
4	200 through -299	Execution
3	300 through -399	Device Dependent
2	400 through -499	Query

Table 1.7 Error Messages
Error	Error String	Error Description
-100	Command error	Generic command error
-102	Syntax error	Unrecognized command or data type
-108	Parameter not allowed	Too many parameters
-222	Data out of range	E.g., outside the range of this device
-350	Queue overflow	Errors lost due to too many errors in queue
-400	Query error	Generic query error

1.10.3. SYSTem:EepromLoCK

Note

The SYSTem:EepromLoCK SCPI command was first introduced in Firmware Version 9.1.

The SYSTem:EepromLoCK command controls and queries the EEPROM write lock state of the power supply. When the EEPROM is locked, all attempts to write to non-volatile memory are ignored, protecting stored settings and calibration data from modification. However, the system now maintains a RAM history of attempted writes while locked, which affects subsequent read operations.

Query Syntax:: SYSTem:EepromLoCK?
Command Syntax:: SYSTem:EepromLoCK <NR1>
Parameters:: 0 (Unlock EEPROM, allow writes) | 1 (Lock EEPROM, block writes)
Examples:: SYSTem:EepromLoCK?, SYSTem:EepromLoCK 1, SYSTem:EepromLoCK 0
Return Param:: 0 (EEPROM unlocked, writes allowed) | 1 (EEPROM locked, writes blocked)

Notes

When the EEPROM is locked, all commands and operations that attempt to write to non-volatile memory will be ignored for the physical EEPROM, but the system will keep a RAM history of these attempted writes.
When locked, subsequent reads will return the most recent value written (from RAM history) if available, otherwise the value from EEPROM.
When unlocked, reads always return the value from EEPROM (including any changes made by other means).
This behavior allows the system to appear responsive to setpoint and configuration changes even when EEPROM is locked, which is useful for testing and temporary configuration without affecting non-volatile storage.
The lock state is volatile and will be reset on power cycle unless otherwise specified.

1.10.4. SYSTem:COMMunicate:NETwork:VERSion?

This query reads the firmware and hardware versions of the Ethernet communications module.

Query Syntax:: [SYSTem][:COMMunicate]:NETwork:VERSion?
Examples:: SYST:COMM:NET:VERS?, NET:VERS?
Return Param:: <Firmware Ver. XX.Y, Hardware Rev. XX.Y>

1.10.5. SYSTem:COMMunicate:NETwork:MAC?

This query returns the MAC address of the Ethernet module. MAC address consist of two number groups: the first three bytes are known as the Organizationally Unique Identifier (OUI), which is distributed by the IEEE, and the last three bytes are the device’s unique serial number. The six bytes are separated by hyphens. The MAC address is unique to the instrument and cannot be altered by the user.

Query Syntax:: [SYSTem][:COMMunicate]:NETwork:MAC?
Examples:: SYST:COMM:NET:MAC?, NET:MAC?
Return Param:: <XX-XX-XX-YY-YY-YY>

1.10.6. SYSTem:COMMunicate:NETwork:SER

This query returns the serial number of the Ethernet module. The serial number is an integer ranging from 1 to 16777215 and cannot be altered by the user.

Query Syntax:: [SYSTem][:COMMunicate]:NETwork:SER?
Examples:: SYST:COMM:NET:SER?, NET:SER?
Return Param:: <NR1>

1.10.7. SYSTem:COMMunicate:NETwork:ADDRess

This command sets the static address of the Ethernet module of the MagnaDC power supply. In absence of a DHCP server, the address automatically selects 169.254.###.###

Command Syntax:: [SYSTem][:COMMunicate]:NETwork:ADDRess <string>
Parameters:: IP address is represented with 4 bytes each having a range of 0-255 separated by periods
Examples:: SYSTem:COMM:NET:ADDR 192.168.10.2, NET:ADDR 192.168.10.2
Query Syntax:: [SYSTem][:COMMunicate]:NETwork:ADDRess?
Return Param:: <string>

1.10.8. SYSTem:COMMunicate:NETwork:GATE

This command sets the Gateway IP address of the Ethernet module of the MagnaDC power supply. The Gateway IP defaults to 0.0.0.0 in absence of a DHCP server.

Command Syntax:: [SYSTem][:COMMunicate]:NETwork:GATE <string>
Parameters:: Gateway IP address is represented with 4 bytes each having a range of 0-255 separated by dots
Examples:: SYSTem:COMM:NET:GATE 192.168.10.2, NET:GATE 192.168.10.2
Query Syntax:: [SYSTem][:COMMunicate]:NETwork:GATE?
Return Param:: <string>

1.10.9. SYSTem:COMMunicate:NETwork:SUBNet

This command sets the subnet IP Mask address of the Ethernet module of the MagnaDC power supply. The factory subnet mask setting is 255.255.255.0.

Command Syntax:: [SYSTem][:COMMunicate]:NETwork:SUBNet <string>
Parameters:: IP mask address is represented with 4 bytes each having a range of 0-255 separated by periods.
Examples:: SYSTem:COMM:NET:SUBNet 255.255.255.128, NET: SUBNet 255.255.255.128
Query Syntax:: [SYSTem][:COMMunicate]:NETwork:SUBNet?
Return Param:: <string>

1.10.10. SYSTem:COMMunicate:NETwork:PORT

This command sets the Socket (Port) of the Ethernet module of the MagnaDC power supply. The factory default port setting is 50505. The factory recommends port values greater than 49151 to avoid conflicts with registered Ethernet port functions.

Command Syntax:: [SYSTem][:COMMunicate]:NETwork:PORT <NR1>
Parameters:: 16-bit socket number (1 to 65,535)
Examples:: SYSTem:COMM:NET: PORT 50505, NET: PORT 50505
Query Syntax:: [SYSTem][:COMMunicate]:NETwork:PORT?
Return Param:: <NR1>

1.10.11. SYSTem:COMMunicate:NETwork:HOSTname

This query reads the host name of the Ethernet communications module.

Query Syntax:: [SYSTem][:COMMunicate]:NETwork:HOSTname?
Examples:: SYST:COMM:NET:HOST?, NET:HOST?
Return Param:: <string>

1.10.12. SYSTem:COMMunicate:NETwork:DHCP

This command sets the DHCP operating mode of the Ethernet module. If DHCP is set to 1, the module will allow its IP address to be automatically set by the DHCP server on the network. If DHCP is set to 0, the module uses its static network settings; the factory default IP address is automatically selected from 169.254.###.### with subnet mask 255.255.0.0, as described in RFC 3927.

Command Syntax:: [SYSTem][:COMMunicate]:NETwork:DHCP <NR1>
Parameters:: 0 (DHCP Off) | 1 (DHCP On)
Examples:: SYST:COMM:NET:DHCP 0, NET:DHCP 1
Query Syntax:: [SYSTem][:COMMunicate]:NETwork:DHCP?
Return Param:: <NR1>

1.10.13. SYSTem:COMMunicate:GPIB:VERSion

This query is available only for units with the IEEE-488 GPIB (+GPIB) option installed. This query reads the firmware version of the GPIB communication module.

Query Syntax:: [SYSTem][:COMMunicate]:GPIB:VERSion?
Examples:: SYST:COMM:GPIB:VERS?, GPIB:VERS?
Return Param:: <Firmware Ver. XX.Y>

1.10.14. SYSTem:COMMunicate:GPIB:ADDRess

This command is available only for units with the IEEE-488 GPIB (+GPIB) option installed. This command sets the address of the GPIB module of the MagnaDC power supply. The address can be 1 to 30 where address 0 is normally assigned to the GPIB Master. The factory default address is 1.

Command Syntax:: [SYSTem][:COMMunicate]:GPIB:ADDRess <NR1>
Parameters:: 1 - 30
Examples:: SYST:COMM:GPIB:ADDR 27, GPIB:ADDR 27
Query Syntax:: [SYSTem][:COMMunicate]:GPIB:ADDR?
Return Param:: <NR1>