get_sn
Description
Retrieves the Series Number from the physical device.
Syntax
Arguments
| deviceIndexNum | the index number of the AWG device |
Return Value
| seriesNumber | Series Number of the AWG |
Example
int seriesNumber;
seriesNumber = awg_group.get_sn(0);
Notes
The index number that you pass into this function is always "0" if there is only one AWG. You can use the number property from the AWG_Group_API class to determine how many boards are connected to your system. The index number starts from 0 and counts incrementally up. If there are three AWGs connected then the index numbers will be 0 for the first AWG, 1 for the second AWG, and 2 for the third AWG.
This method is part of the AWG_Group_API class. The Series Number is an unique number that identifies each AWG board. You should always use this method to get the Series Number in order to initialize the AWG.
When this method returns with "0" it means that there were no AWGs found. If you try to initialize an AWG_API object (using the ini method) with argument "0", your program will fail. You should have a conditional test to test whether the get_sn function returns with "0" and if it does, to stop further execution and display a message.