API Command Reference
Appendix A
A-34
NetScan User’s Manual
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. ESE conditions, in
turn, determine which Event Status Register (ESR) conditions are enabled to generate the Event Status Register
Bit (ESB) in the Status Byte (STB) Register. Multiple ESR bits can be enabled simultaneously 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.
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).
N008
: Device Dependent Error. This condition is set when a conflict in programmed parameters is detected.
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 command.
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, “N0 X”
‘ Clear the Event Status Enable (ESE) Register
PRINT#1, “N? X”
‘ Read the Event Status Enable (ESE) Register
LINE INPUT #1, N$
PRINT N$
‘ Computer screen shows
N000
PRINT#1, “N1N2X”
‘ Set enable ESB setting on pre-trigger count satisfied or
acquisition complete
PRINT#1, “N? X”
‘ Read the Event Status Enable (ESE) Register
LINE INPUT #1, N$
PRINT N$
‘ Computer screen shows
N003
Summary of Contents for OMB-NETSCAN 1500
Page 6: ...iv NetScan User s Manual...
Page 18: ...1 12 Configuring and Starting NetScan NetScan User s Manual Notes...
Page 38: ...3 8 General Information and Specifications NetScan User s Manual Notes...
Page 82: ...4 44 ChartView Software Reference NetScan User s Manual Notes...
Page 118: ...6 20 Calibration NetScan User s Manual...
Page 140: ...A ii NetScan User s Manual...
Page 192: ...API Command Reference Appendix A A 52 NetScan User s Manual Notes...
Page 237: ...Appendix D Registers Data Formats Queries NetScan User s Manual D 13...
Page 244: ...NetScan Program Examples Appendix E E 2 NetScan User s Manual...
Page 248: ...ASCII Code Summary Appendix F F 4 NetScan User s Manual Notes...
Page 250: ...NetScan Error Messages Appendix G G 2 NetScan User s Manual Notes...
Page 252: ...Abbreviations Appendix H H 2 NetScan User s Manual Notes...
Page 254: ...NetScan User s Manual...