.. _scpi-status: STATus Subsystem ---------------- Status commands let you determine the condition of the |product_type| at any time, grouping together multiple feedback parameters into one returned value. \*CLS ^^^^^ This command clears all status register (:ref:`ESR `, :ref:`STB ` and error queue). :Command Syntax: ``*CLS`` :Parameters: None :Examples: ``*CLS`` :Return Param: None :\*RST Value: N/A .. _scpi-status-ese: \*ESE? ^^^^^^ This command programs the Event Status Enable Register (ESE). The programming determines which events of the :ref:`Event Status Register (ESR) ` set the Event Status Bit (ESB) of the Status Byte Register (STB). A "1" in the bit position enables the corresponding event. All of the enabled events of the ESE are logically OR’d to cause the ESB of the STB to be set. :Command Syntax: ``*ESE `` :Parameters: Register Bit Position :Examples: ``*ESE 255`` :Query Syntax: ``*ESE?`` :Return Param: :\*RST Value: N/A .. _scpi-status-esr: \*ESR? ^^^^^^ This query reads the Event Status Register (ESR). After reading the ESR, the register is cleared. The bit configuration of the ESR is the same as the Event Status Enable Register (*ESE). The return parameter is weighted as shown in table below. The Power On Bit (PON) is set every time the |product_type| is reset. It can be used to detect a power outage or |product_type| reset. :Command Syntax: ``*ESR?`` :Parameters: None :Examples: ``*ESR?`` :Return Param: :\*RST Value: N/A **Event Status Register** .. list-table:: :header-rows: 1 :widths: 10 10 10 25 * - Bit - Weight - Abbreviation - Description * - 0 - 1 - OPC - Operation Complete * - 1 - 2 - NU - Not Used * - 2 - 4 - QYE - Query Error * - 3 - 8 - DDE - Device Dependent Error * - 4 - 16 - EXE - Execution Error * - 5 - 32 - CME - Command Error * - 6 - 64 - NU - Not Used * - 7 - 128 - PON - Power On Event, 1 after power on .. _scpi-status-idn: \*IDN? ^^^^^^ This query requests |product_type| to identify itself, returning a string composed of three fields separated by commas. :Query Syntax: ``*IDN?`` :Examples: ``*IDN?`` :Return Param: Company Name, |product_type| Model, Serial Number, Firmware Version :Return Example: Magna-Power Electronics Inc., ARx16.75-1000-14, 1201-0001, 0.029 :\*RST Value: N/A .. _scpi-status-opc: \*OPC ^^^^^ .. note:: This command is only available with the IEEE-488 GPIB (+GPIB) option. This command clears the operation complete bit found in the event status register (:ref:`ESR `). Should be used in application programming when delay exists between sending a SCPI command and the execution of the command. When all commands have completed, the OPC bits gets set back to 1. :Query Syntax: ``*OPC?`` :Examples: ``*OPC`` :Return Param: :\*RST Value: N/A .. _scpi-status-rst: \*RST ^^^^^ This command resets the various settings and functions in the |product_type| to their factory default state. This command is commonly used in initialization routines to restore the |product_type| to a known configuration. Factory default settings for each command are indicated in the description for respective SCPI commands. SCPI commands with *RST Value indicated as *N/A* either are not affected by the *RST or do not have a parameter that can be changed. :Command Syntax: ``*RST`` :Parameters: None :Examples: ``*RST`` :\*RST Value: N/A .. _scpi-status-sre: \*SRE ^^^^^ This command sets the Service Request Enable Register (SRE). This register, defined in the table “Service Request Enable Register”, determines which bits from the Status Byte Register (see *STB for its bit configuration) are allowed to set the Service Request (RQS) Bit. A 1 in any SRE bit position enables the corresponding Status Byte Register bit. All Status Byte Register enabled bits are then logically OR’d and placed in bit 6 of the Status Byte Register. When *SRE is cleared (by programming it with 0), the power supply cannot generate a service request to the controller. :Command Syntax: ``*SRE`` :Parameters: Register Bit Position :Examples: ``*SRE 20`` :Query Syntax: ``*SRE?`` :Return Param: :\*RST Value: N/A **Service Request Enable Register** .. list-table:: :header-rows: 1 :widths: 10 10 10 25 * - Bit - Weight - Abbreviation - Description * - 0 - 1 - NU - Not Used * - 1 - 2 - NU - Not Used * - 2 - 4 - NU - Not Used * - 3 - 8 - QUES - Questionable Status Bit * - 4 - 16 - MAV - Message Available Bit * - 5 - 32 - ESB - Event Status Bit * - 6 - 64 - RQS - Request Service Bit * - 7 - 128 - NU - Not Used .. _scpi-status-stb: \*STB ^^^^^ This query gets the Status Byte (STB). Registers are cleared only when the signals feeding it are cleared. :Command Syntax: ``*STB?`` :Parameters: None :Examples: ``*STB?`` :Return Param: :\*RST Value: N/A .. _scpi-stat-oper-cond: STATus:OPERation:CONDition? ^^^^^^^^^^^^^^^^^^^^^^^^^^^ This query returns the value of the Operation Register which is a read-only register that holds the real-time (unlatched) condition of the operational status of the power supply. The bit configuration of the Operation Register is shown in :numref:`tbl-scpi-stat-oper-cond`. :Query Syntax: ``STATus:OPERation:CONDition?`` :Examples: ``STAT:OPER:COND?``, ``STATUS:OPERATION:CONDITION?`` :Return Param: (Register value) .. _tbl-scpi-stat-oper-cond: .. csv-table:: Bit configuration of the Operation Register :file: ../_common-magnadc/_tables/scpi-stat-oper-cond.csv :header-rows: 1 :widths: 15 15 15 55 :class: table-models .. _scpi-stat-ques-cond: STATus:QUEStionable:CONDition? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This query returns the value of the Questionable Register. The Questionable Register is a readonly register that holds the real-time (unlatched) condition of the questionable status of the power supply. The bit configuration of the Questionable Register is shown in :numref:`tbl-scpi-stat-ques-cond`. :Query Syntax: ``STATus:QUEStionable:CONDition?`` :Examples: ``STAT:QUES:COND?``, ``STATUS:QUESTIONABLE:CONDITION?``, ``SOUR:PER MAX`` :Return Param: (Register value) .. _tbl-scpi-stat-ques-cond: .. csv-table:: Bit configuration of the Questionable Register :file: ../_common-magnadc/_tables/scpi-stat-ques-cond.csv :header-rows: 1 :widths: 15 15 15 55 :class: table-models