STATus:ALARm:ENABle
Syntax
STATus:ALARm:ENABle <enable_value>
STATus:ALARm:ENABle?
Description
This command enables bits in the enable register for the Alarm Register group. The selected bits are then reported to the Status Byte.
Used With:
34921A through 34925A Multiplexer Modules
34950A Digital I/O Module (digital input and counter channels only)
34952A Multifunction Module (digital input and totalizer channels only)
For more information on the SCPI Status System for the Agilent 34980A, see the Status System Diagram. |
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 Alarm Register.
Bit Number |
Decimal Value |
Definition | |
0 |
Alarm 1 |
1 |
Alarm occurred on Alarm 1. |
1 |
Alarm 2 |
2 |
Alarm occurred on Alarm 2. |
2 |
Alarm 3 |
4 |
Alarm occurred on Alarm 3. |
3 |
Alarm 4 |
8 |
Alarm occurred on Alarm 4. |
4 |
Queue Empty |
16 |
Alarm queue status (0 = empty, 1 = not empty). |
5 |
Queue Overflow |
32 |
Alarm data lost due to alarm queue overflow. |
6-15 |
Reserved |
Reserved |
Reserved for internal use. |
Use the <enable_value> parameter to specify which bits will be reported to the Status Byte. 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 0 (decimal value = 1), bit 1 (decimal value = 2), and bit 4 (decimal value = 16), the corresponding decimal value would be 19 (1 + 2 + 16).
The *CLS (clear status) command will not clear the enable register but it does clear all bits in the event register.
The STATus:PRESet command will clear all bits in the 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 1 (decimal value = 2) and bit 4 (decimal value = 16) are enabled, the query command will return "+18".
Examples
The following command enables bit 1 (decimal value = 2) and bit 4 (decimal value = 16) in the enable register.
STAT:ALAR:ENAB 16
The following query returns which bits are enabled in the register.
STAT:ALAR:ENAB?
Typical Response: +16