Sets the source of the specified digitizer group.
Gx3748DigitizerSetSource (nHandle, nDigitizerGroup, nChannel, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
Handle to a GX3748 board. |
nDigitizerGroup |
SHORT |
Each of the digitizer inputs has a dedicated group of input channels, specified the digitizer’s group number, number are as follows:0. GX3748_DIGITIZER_GROUP0: Group 0 input channels 0-15.1. GX3748_DIGITIZER_GROUP1: Group 1 input channels 0-15.2. GX3748_DIGITIZER_GROUP2: Group 2 input channels 0-15. |
nChannel |
SHORT |
Channel number in the group, channel numbers are 0-15:0. GX3748_GROUP_CH0: channel 0 in the group.1. GX3748_GROUP_CH1: channel 1 in the group.2. GX3748_GROUP_CH2: channel 2 in the group.3. GX3748_GROUP_CH3: channel 3 in the group.4. GX3748_GROUP_CH4: channel 4 in the group.5. GX3748_GROUP_CH5: channel 5 in the group.6. GX3748_GROUP_CH6: channel 6 in the group.7. GX3748_GROUP_CH7: channel 7 in the group.8. GX3748_GROUP_CH8: channel 8 in the group.9. GX3748_GROUP_CH9: channel 9 in the group.10. GX3748_GROUP_CH10: channel 10 in the group.11. GX3748_GROUP_CH11: channel 11 in the group.12. GX3748_GROUP_CH12: channel 12 in the group.13. GX3748_GROUP_CH13: channel 13 in the group.14. GX3748_GROUP_CH14: channel 14 in the group.15. GX3748_GROUP_CH15: channel 15 in the group. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The function sets the source of the specified digitizer group.
The Gx3748 has 3 input groups (0-2) each with 16 channels (48 total input channels). The digitizer has 3 independent inputs, all 3 has the same programmable sample period. Sample period can be set by calling Gx3748DigitizerSetSamplesPeriod() API. Each of the 3 digitizer inputs can record up 87,300 samples, the number of sample to acquired are set by calling Gx3748DigitizerSetSamplesCount() API. Each of the digitizer inputs can have a programmable trigger mode, trigger mode can be set by calling the Gx3748DigitizerSetTriggerMode() API. The user can set programmatically the trigger threshold for each of the digitizer inputs by calling the Gx3748DigitizerSetTriggerThreshold() API. Acquisition progress and total number of samples acquired of each of the digitizers inputs can monitor at any time by calling the Gx3748DigitizerGetSamplesCounter() API. Each of the digitizer inputs can armed or disarmed by calling the Gx3748DigitizerArm() API.
The user can halt the acquisition at any time by calling the Gx3748DigitizerHalt() API.
Once acquisition is done, to verify use Gx3748DigitizerGetGroupStatus() and Gx3748DigitizerGetStatus() APIs, the user can read back the acquired data by calling Gx3748DigitizerReadWaveform() API.
Each of the digitizer inputs has a dedicated group of input channels:
Digitizer Group 0: user can select programmatically the source to be one of Group 0 channels 0-15 by calling Gx3748DigitizerSetSource() API.
Digitizer Group 1: user can select programmatically the source to be one of Group 1 channels 0-15 by calling Gx3748DigitizerSetSource() API.
Digitizer Group 2: user can select programmatically the source to be one of Group 2 channels 0-15 by calling Gx3748DigitizerSetSource() API.
The following example sets the digitizer’s source to channel 0 and returns the set value (see Gx3748DigitizerReadWaveform() API for complete example code):
SHORT nHandle, nStatus;
SHORT nChannel;
Gx3748DigitizerGetSource (nHandle, GX3748_DIGITIZER_GROUP0, GX3748_GROUP_CH0, &nStatus);
Gx3748DigitizerGetSource (nHandle, GX3748_DIGITIZER_GROUP0, &nChannel, &nStatus);
Gx3748DigitizerArm, Gx3748DigitizerGetGroupStatus, Gx3748DigitizerGetStatus, Gx3748DigitizerHalt, Gx3748DigitizerReadSampleCount, Gx3748DigitizerReadTriggerTimestamp, Gx3748DigitizerReadWaveform, Gx3748DigitizerReset, Gx3748DigitizerSetSamplesCount, Gx3748DigitizerSetSamplesPeriod, Gx3748DigitizerSetSource, Gx3748DigitizerSetTriggerMode, Gx3748DigitizerSetTriggerThreshold, Gx3748DigitizerSoftwareTrigger, GxFpgaGetErrorString