Signal Hound BB60C Programmer's Reference Manual

Signal Hound | API Functions
33
12.
13. // Alternative 1: Assume it's ready
14. if( bbOpenDevice( &myID ) == bbNoError )
15. return true;
16. else
17. return false;
18.
19.
20. // Alternative 2: Try a few times, it may not be ready at first
21. int trys = 0;
22. while(trys++ < 3) {
23. if( bbOpenDevice( &myID ) == bbNoError )
24. return true;
25. else
26. Sleep(500);
27. }
28. return false;
29. }
bbSelfCal
Calibrate the device for significant temperature changes. BB60A only
bbStatus bbSelfCal(int device);
Parameters
device Handle of an open device.
Description
This function causes the device to recalibrate itself to adjust for internal device temperature changes,
generating an amplitude correction array as a function of IF frequency. This function will explicitly call
bbAbort() to suspend all device operations before performing the calibration, and will return the
device in an idle state and configured as if it was just opened. The state of the device should not be
assumed, and should be fully reconfigured after a self-calibration.
Temperature changes of 2 degrees Celsius or more have been shown to measurably alter the
shape/amplitude of the IF. We suggest using bbGetDeviceDiagnostics() to monitor the device’s
temperature and perform self-calibrations when needed. Amplitude measurements are not guaranteed
to be accurate otherwise, and large temperature changes (10
°
C or more) may result in adding a dB or
more of error.
Because this is a streaming device, we have decided to leave the programmer in full control of when the
device in calibrated. The device is calibrated once upon opening the device through bbOpenDevice()
and is the responsibility of the programmer after that.
Note:
After calling this function, the device returns to the default state. Currently the API does not retain state
prior to the calling of bbSelfCal(). Fully reconfiguring the device will be necessary.
Return Values
bbNoError The device was recalibrated successfully.

Signal Hound BB60C Specifications

General

Brand	Signal Hound
Model	BB60C
Category	Measuring Instruments
Language	English