Appendix A API Commands
ChartScan User’s Manual A-43
N - Set Event Mask
TYPE
System
EXECUTION
Deferred
SYNTAX
Nmask
Directly sets the Event Status Enable Register (ESE) where mask is in the
form of the number nnn such that 000 < nnn < 255 is summed from the
following conditions:
000 - Clear event mask
016 - Execution Error
001 - Acquisition complete
032 - Command Error
002 - Stop Event
064 - Buffer 75% Full
004 - Query Error
128 - Power On
008 - Device Dependent Error
N?
Query the Event mask.
DESCRIPTION
The Set Event Mask (N) command directly sets the Event Status Enable (ESE) Register. ES E conditions, in
turn, determine which Event Status Register (ESR) conditions are enabled to generate the Event Status Regist er
Bit (ESB) in the Serial Poll Status (SPS) Register. Multiple ESR bits can be enabled si multaneously by issuing
Set Event Mask (N) commands separately or by combining them in one command string. The programmed
Event Mask remains enabled until a Clear Event Mask (N0) command is sent or the controller sends a Power-On
Reset (*R) command. See the IEEE 488 Serial Poll Response section in Appendix C for more information.
The following list outlines the possible conditions of the ESE:
N000: Sending this command clears the entire mask of the Event Status Enable (ESE) Register to zero.
N001: Acquisition Complete. Sending this command allows the setting of the ESB if the unit has determined
that the configured acquisition has completed.
N002: Stop Event. Sending this command allows the setting of the ESB when the pre-defined stop event of a
configured acquisition has occurred.
N004: Query Error. This condition is set when an attempt is made to read data from the output queue when no
data are present or data in the output queue were lost. Data may be lost when too many data are requested to
be buffered in the queue (for example, issuing multiple commands to return data without ever reading them).
008: Device Dependent Error. This condition is set when a conflict in programmed parameters is detect ed.
This is also referred to as a conflict error.
N016: Execution Error. This condition is set when a parameter exceeds valid limits for a particular comm and.
This is also referred to as Invalid Device Dependent Command Option (IDDCO) error.
N032: Command Error. This condition is set when an illegal command is sent to the unit. This is also referred
to as Invalid Device Dependent Command (IDDC) error.
N064: Buffer 75% Full. Sending this command will allow the setting of the ESB when the unit has determined
that the acquisition buffer is at least 75% full.
N128: Power On. This condition is set whenever unit is first powered up or a *R is issued.
EXAMPLE
PRINT#1, “OUTPUT07;N0 X”
‘ Clear the Event Status Enable (ESE) Register
PRINT#1, “OUTPUT07;N? X”
‘ Read the Event Status Enable (ESE) Register
PRINT#1, “ENTER07"
‘ Computer screen shows N000
LINE INPUT #2, N$
PRINT N$
PRINT#1, “OUTPUT07;N1N2X”
‘ Set enable ESB setting on pre-trigger count satisfied or
acquisition complete
PRINT#1, “OUTPUT07;N? X”
‘ Read the Event Status Enable (ESE) Register
PRINT#1, “ENTER07"
‘ Computer screen shows N003
LINE INPUT #2, N$
PRINT N$
PRINT#1, “OUTPUT07;M32 X”
‘ Set SRQ on Event Detected (ESB). SRQ will now be
generated when pre-trigger count is satisfied or the
acquisition completes