SC5506A Operating & Programming Manual
Rev 2.1.1
22
Type Definitions
typedef
struct
deviceInfo_t
{
unsigned
int
productSerialNumber;
unsigned
int
rfModuleSerialNumber;
float
firmwareRevision;
float
hardwareRevision;
unsigned
int
calDate;
// year, month, day, hour:&(0xFF000000,0xFF0000,0xFF00,0xFF)
unsigned
int
manDate;
// year, month, day, hour:&(0xFF000000,0xFF0000,0xFF00,0xFF)
}
deviceInfo_t;
typedef
struct
//deviceStatus_t
{
bool
ch1AutoLevelEnable;
//added in rev2.0 for Firmware >= 4.0
bool
ch2AutoLevelEnable;
//added in rev2.0 for firmware >= 4.0
bool
ch1AlcOpen;
bool
ch2AlcOpen;
bool
ch1OutEnable;
bool
ch2OutEnable;
bool
ch1StandbyEnable;
bool
ch2StandbyEnable;
bool
ch1SumPllStatus;
bool
ch1CrsPllStatus;
bool
ch1FinePllStatus;
bool
ch2SumPllStatus;
bool
ch2CrsPllStatus;
bool
ch2FinePllStatus;
bool
vcxoPllStatus;
bool
tcxoPllStatus;
bool
extRefDetected;
bool
extRefLockEnable;
bool
refClkOutEnable;
bool
deviceAccess;
} deviceStatus_t;
Function Definitions and Usage
Before reading this API section, please note that there are API changes in revision 2.0 or later. The changes
consist of the following:
•
The API library is renamed from sc5506a.dll to sc5506a_usb.dll for the USB interface to prevent
confusion between libraries for USB and RS232.
•
Two extra members of the deviceStatus_t struct is added, these report the current status of the
Auto leveling function of each channel. These are valid only on devices with firmware revision 4
or higher.
•
The device handle type is changed from struct type to HANDLE (*void) type. In the following
functions,
deviceHandle
*
devHandle
should be changed to
HANDLE
devHandle
when calling
revision 2 or higher API library.
•
Function sc5506a_GetDeviceParams() has been added to retrieve current channel frequency and
power level. This is valid only on devices with firmware revision 4 or higher.
•
The device handle from the sc5506a_OpenDevice() function is passed back via a parameter
instead of a returned type.