Software Trigger; Table 56: Spectrum Api: External Trigger And Mask Related Software Register And Available Settings; Table 57: Spectrum Api: Channel Trigger And Mask Related Software Register And Available Settings; Table 58: Spectrum Api: Software Register And Register Setting For Software Trigger - Spectrum M2p.59 Series Hardware Manual

Software trigger

The table below shows the relating register for the general AND mask and the possible constants that can be written to it.

Table 56: Spectrum API: external trigger AND mask related software register and available settings

Register
SPC_TRIG_AVAILANDMASK
SPC_TRIG_ANDMASK
SPC_TMASK_NONE
SPC_TMASK_EXT0
SPC_TMASK_EXT1
SPC_TMASK_EXT2
SPC_TMASK_EXT3
The following example shows, how to setup the AND mask, for an external trigger. As an example a simple high level detection has been
chosen. When multiple external triggers shall be combined by AND, both of the external sources must be included in the AND mask register,
similar to the OR mask example shown before. The explanation and a detailed description of the different trigger modes for the external
trigger inputs will be shown in the dedicated passage within this chapter.
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_ORMASK, SPC_TMASK_NONE);
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_ANDMASK, SPC_TMASK_EXT0); // Enable external trigger within the AND mask
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_EXT0_LEVEL0, 2000);
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_EXT0_MODE, SPC_TM_HIGH);
The table below is showing the constants for the channel AND mask (A/D cards only) and all the constants for the different channels.

Table 57: Spectrum API: channel trigger AND mask related software register and available settings

Register
SPC_TRIG_CH_AVAILANDASK0
SPC_TRIG_CH_ANDMASK0
SPC_TMASK0_CH0
SPC_TMASK0_CH1
SPC_TMASK0_CH2
SPC_TMASK0_CH3
SPC_TMASK0_CH4
SPC_TMASK0_CH5
SPC_TMASK0_CH6
SPC_TMASK0_CH7
The following example shows, how to setup the AND mask for a channel trigger. As an example a simple level detection has been chosen.
The explanation and a detailed description of the different trigger modes for the channel trigger modes will be shown in the dedicated pas-
sage within this chapter.
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_ORMASK, SPC_TMASK_NONE);
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_CH_ANDMASK0, SPC_TMASK_CH0);// Enable channel0 trigger within AND mask
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_CH0_LEVEL0, 0);
spcm_dwSetParam_i32 (hDrv, SPC_TRIG_CH0_MODE, SPC_TM_HIGH);
Software trigger
The software trigger is the easiest way of triggering any Spectrum
board. The acquisition or replay of data will start immediately af-
ter the card is started and the trigger engine is armed. The result-
ing delay upon start includes the time the board needs for its
setup and the time for recording the pre-trigger area (for acquisi-
tion cards).
For enabling the software trigger one simply has to include the
software event within the trigger OR mask, as the following table is showing:

Table 58: Spectrum API: software register and register setting for software trigger

Register
SPC_TRIG_ORMASK
SPC_TMASK_SOFTWARE
100
Value Direction Description
40420 read Bitmask, in which all bits of the below mentioned sources for the AND mask are set, if available.
40430 read/write Defines the events included within the trigger AND mask of the card.
0 No trigger source selected
2h Enables the external (analog) trigger 0 for the AND mask. The card will trigger if the programmed condition for this
input is valid.
4h Enables the X1 (logic) trigger for the AND mask. The card will trigger if the programmed condition for this input is
valid.
8h Enables the X2 (logic) trigger for the AND mask. The card will trigger if the programmed condition for this input is
valid.
10h Enables the X3 (logic) trigger for the AND mask. The card will trigger if the programmed condition for this input is
valid.
Value Direction Description
40470 read Bitmask, in which all bits of the below mentioned sources/channels (0...7) for the channel AND mask
are set, if available.
40480 read/write Includes the analog or digital channels (0...7) within the channel trigger AND mask of the card.
00000001h Enables channel0 for recognition within the channel OR mask.
00000002h Enables channel1 for recognition within the channel OR mask.
00000004h Enables channel2 for recognition within the channel OR mask.
00000008h Enables channel3 for recognition within the channel OR mask.
00000010h Enables channel4 for recognition within the channel OR mask.
00000020h Enables channel5 for recognition within the channel OR mask.
00000040h Enables channel6 for recognition within the channel OR mask.
00000080h Enables channel7 for recognition within the channel OR mask.
Value Direction Description
40410 read/write Defines the events included within the trigger OR mask of the card.
1h Sets the trigger mode to software, so that the recording/replay starts immediately.
(c) Spectrum Instrumentation GmbH
Trigger modes and appendant registers
// disable default software trigger
// Trigger level is 2.0 V (2000 mV)
// Setting up external trigger for HIGH level
// disable default software trigger
// channel level to detect is zero level
// Setting up ch0 trigger for HIGH levels