Signal Hound | API Functions
The verticalScale parameter will change the units of returned sweeps. If BB_LOG_SCALE is provided
sweeps will be returned in amplitude unit dBm. If BB_LIN_SCALE is return, the returned units will be in
milli-volts. If the full scale units are specified, no corrections are applied to the data and amplitudes are
taken directly from the full scale input.
Return Values
bbNoError Function completed successfully.
bbDeviceNotOpenErr The device handle provided points to a device that is not open.
bbInvalidDetectorErr The detector type provided does not match the list of accepted values.
bbInvalidScaleErr The scale provided does not match the list of accepted values.
bbConfigureCenterSpan
Change the center and span frequencies
bbStatus bbConfigureCenterSpan(int device, double center, double span);
Parameters
device Handle to the device being configured.
center Center frequency in hertz.
span Span in hertz.
Description
This function configures the operating frequency band of the broadband device. Start and stop
frequencies can be determined from the center and span.
- start = center – (span / 2)
- stop = center + (span / 2)
The values provided are used by the device during initialization and a more precise start frequency is
returned after initiation. Refer to the bbQueryTraceInfo() function for more information.
Each device has a specified operational frequency range. These limits are BB#_MIN_FREQ and
BB#_MAX_FREQ. The center and span provided cannot specify a sweep outside of this range.
There is also an absolute minimum operating span of 20 Hz, but 200kHz is a suggested minimum.
Certain modes of operation have specific frequency range limits. Those mode dependent limits are
tested against during bbInitiate() and not here.
Return Values
bbNoError Device successfully configured.
bbDeviceNotOpenErr The device handle provided points to a device that is not open.
bbInvalidSpanErr The span provided is less than the minimum acceptable span.
bbFrequencyRangeErr The calculated start or stop frequencies fall outside of the operational
frequency range of the specified device.