API Functions | Signal Hound
bbConfigureLevel
Change the attenuation and reference level of the device
bbStatus bbConfigureLevel(int device, double ref, double atten);
Parameters
device Handle to the device being configured.
ref Reference level in dBm.
atten Attenuation setting in dB. If attenuation provided is negative,
attenuation is selected automatically.
Description
When automatic atten is selected, the API uses the ref provided to choose the best gain settings for an
input signal with amplitude equal to reference level. If an atten other than BB_AUTO_ATTEN is specified
using bbConfigureLevel(), the ref parameter is ignored.
The atten parameter controls the RF input attenuator, and is adjustable from 0 to 30 dB in 10 dB steps.
The RF attenuator is the first gain control device in the front end.
When attenuation is automatic, the attenuation and gain for each band is selected independently. When
attenuation is not automatic, a flat attenuation is set across the entire spectrum.
It is recommended to set automatic gain and attenuation and set the reference level to a value slighly
higher than the expected inpu power level.
Return Values
bbNoError Device successfully configured.
bbDeviceNotOpenErr The device handle provided points to a device that is not open.
bbReferenceLevelErr The reference level provided exceeds 20 dBm.
bbAttenuationErr The attenuation value provided exceeds 30 db.
bbConfigureGain
Change the RF/IF gain path in the device
bbStatus bbConfigureGain(int device, int gain);
Parameters
device Handle to the device being configured.
gain A gain setting.
Description
To return the device to automatically choose the best gain setting, call this function with a gain of
BB_AUTO_GAIN.