get_sn


Description

Retrieves the Series Number from the physical device.

Syntax

C++
UInt16 get_sn(UInt16 deviceIndexNum)

Arguments

deviceIndexNum the index number of the DSM device

Return Value

seriesNumber Series Number of DSM device

Example

int seriesNumber;
seriesNumber = ug.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.

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.