Bbselfcal - Signal Hound BB60C Programmer's Reference Manual

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
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
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
to suspend all device operations before performing the calibration, and will return the
bbAbort()
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
temperature and perform self-calibrations when needed. Amplitude measurements are not guaranteed
to be accurate otherwise, and large temperature changes (10
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
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()
Return Values
bbNoError
Signal Hound | API Functions
true;
Handle of an open device.
. Fully reconfiguring the device will be necessary.
The device was recalibrated successfully.
bbGetDeviceDiagnostics()
°
C or more) may result in adding a dB or
to monitor the device's
bbOpenDevice()
33