1.2.6. SYSTem Subsystem
1.2.6.1. SYSTem:ERRor:COUNt?
This query reads the number of errors in the error queue.
- Query Syntax:
SYSTem:ERRor:COUNt?- Examples:
SYST:ERR:COUN?- Return Parameter Format:
<NR1>
1.2.6.2. SYSTem:ERRor[:NEXT]?
The SYST:ERR? query returns the error type and message that 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 the table Error Bits table below. The Error Message table below lists system errors that are associated with SCPI syntax errors and with interface problems.
- Query Syntax:
SYSTem:ERRor[:NEXT]?- Examples:
SYST:ERR?,SYSTEM:ERROR?- Return Parameter Format:
<NR1>, <string>
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 |
Error Messages
Bit |
Error String |
Error 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 |
Value provided outside device’s range |
-350 |
Queue overflow |
Errors lost due to too many errors in queue |
-400 |
Query Error |
Generic query error |
1.2.6.3. SYSTem:REBoot
This commands reboots the system and clears any hard faults.
- Command Syntax:
SYSTem:REBoot- Examples:
SYST:REB,SYSTEM:REBOOT- *RST Value:
N/A
1.2.6.4. SYSTem:VERSion?
The SYST:VERS? query returns the Accessory’s bootloader, firmware, and hardware revision, respectively. The returned value is a comma-separated list of values.
- Query Syntax:
SYSTem:VERSion?- Examples:
SYST:VERS?,SYSTEM:VERSION?- Return Parameter Format:
<NR2>, <NR2>, <NR2>
1.2.6.5. [SYSTem][:COMMunicate]:NETwork:ADDRess
This command sets the static address of the Ethernet module of the Accessory. The factory default address setting is 192.168.1.100.
- 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 Parameter Format:
<string>
1.2.6.6. [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 default IP address is set according to .
- Command Syntax:
[SYSTem][:COMMunicate]:NETwork:DHCP <bool>- Parameters:
0 (DHCP Off) | 1 (DHCP On)
- Examples:
SYST:COMM:NET:DHCP 0,NET:DHCP 1- Query Syntax:
[SYSTem][:COMMunicate]:NETwork:DHCP?- Return Parameter Format:
<NR1>
1.2.6.7. [SYSTem][:COMMunicate]:NETwork:GATE
This command sets the Gateway IP address of the Ethernet module of the Accessory. The factory default Gateway IP setting is 192.168.1.1.
- 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 Parameter Format:
<string>
1.2.6.8. [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 Parameter Format:
<string>
1.2.6.9. [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 Parameter Format:
<string>
1.2.6.10. [SYSTem][:COMMunicate]:NETwork:PORT
This command sets the Socket (Port) of the Ethernet module of the Accessory. 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 Parameter Format:
<NR1>
1.2.6.11. [SYSTem][:COMMunicate]:NETwork:SER?
This command 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 Parameter Format:
<NR1>
1.2.6.12. [SYSTem][:COMMunicate]:NETwork:SUBNet
This command sets the subnet IP Mask address of the Ethernet module of the Accessory. 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 Parameter Format:
<string>
1.2.6.13. [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 Parameter Format:
<string> (e.g. Firmware Ver. XX.Y, Hardware Rev. XX.Y)