*ESE
Syntax
*ESE <enable_value>
*ESE?
Description
This command enables bits in the enable register for the Standard Event Register group. The selected bits are then reported to bit 5 of the Status Byte Register.
For more information on the SCPI Status System for the Agilent 34980A, see Status System Introduction. |
Parameters
Name |
Type |
Range of Values |
Default Value |
<enable_value> |
Numeric |
A decimal value which corresponds to the binary-weighted sum of the bits in the register (see table below). |
This is a required parameter |
Remarks
The following table lists the bit definitions for the Standard Event Register.
Bit Number |
Decimal Value |
Definition |
0 Operation Complete |
1 |
All commands prior to and including *OPC have been executed. |
1 Not Used |
Not Used |
"0" is returned. |
2 Query Error |
4 |
The instrument tried to read the output buffer but it was empty. Or, a new command line was received before a previous query has been read. Or, both the input and output buffers are full. |
3 Device Error |
8 |
A self-test or calibration error occurred (an error in the -300 range or any positive error has been generated). For a complete listing of the error messages, see SCPI Error Messages. |
4 Execution Error |
16 |
An execution error occurred (an error in the -200 range has been generated). |
5 Command Error |
32 |
A command syntax error occurred (an error in the -100 range has been generated). |
6 Not Used |
Not Used |
"0" is returned. |
7 Power On |
128 |
Power has been turned off and on since the last time the event register was read or cleared. |
Use the <enable_value> parameter to specify which bits will be enabled. The decimal value specified corresponds to the binary-weighted sum of the bits you wish to enable in the register. For example, to enable bit 2 (decimal value = 4), bit 3 (decimal value = 8), and bit 7 (decimal value = 128), the corresponding decimal value would be 140 (4 + 8 + 128).
The *CLS (clear status) command will not clear the enable register but it does clear all bits in the event register.
An Instrument Preset (SYSTem:PRESet command) does not clear the bits in the Status Byte enable register.
Return Format
The query command reads the enable register and returns a decimal value which corresponds to the binary-weighted sum of all bits set in the register. For example, if bit 3 (decimal value = 8) and bit 7 (decimal value = 128) are enabled, the query command will return "+136".
Examples
The following command enables bit 4 (decimal value = 16) in the enable register. If an Execution Error occurs, this condition will be reported to the Status Byte Register (bit 5 will be set high).
*ESE 16
The following query returns which bits are enabled in the register.
*ESE?
Typical Response: +16