get_sn
Description
Retrieves the Series Number from the physical device.
Syntax
Arguments
| deviceIndexNumber | the index number of the module |
Return Value
| seriesNumber | Series Number of DSM device |
Example
int seriesNumber;
seriesNumber = dsm_group.get_sn(0);
Notes
This method is part of the DSM_Group_API class. The Series Number is an unique number that identifies each DSM board. You should always use this method to get the Series Number in order to initialize the DSM board.
If only one module is connected to the computer then the index number will be 0. If two devices are connected to the computer then the index number will be either 0 or 1. For three or more modules the index number follows the same format.
The Series Number will always be a positive non-zero integer. When this method returns with "0" it means that there were no DSM boards found. If you try to initialize a DSMX 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.