Signal Hound | API Functions
Description
This function is used to configure the digital I/Q data stream. A decimation factor and filter bandwidth
are able to be specified. The decimation rate divides the I/Q sample rate directly while the bandwidth
parameter further filters the digital stream.
For each given decimation rate, a maximum bandwidth value must be supplied to account for sufficient
filter rolloff. That table is above. See bbFetchRaw() for polling the I/Q data stream.
See Appendix: Code Examples: I/Q Streaming Example.
Return Values
bbNoError Function completed successfully.
bbDeviceNotOpenErr The device specified is not open.
bbInvalidParameterErr The downsample rate is outside the acceptable input range. The
downsample rate is not a power of two.
bbClampedToLowerLimit The bandpass filter width specified is lower than BB_MIN_IQ_BW
bbClampedToUpperLimit Warning that the bandpass filter width was clamped to the maximum
value allowed by the downsampleFaction.
bbConfigureRealTime
Configure the real-time frame parameters
bbStatus bbConfigureRealTime(int device, double frameScale, int frameRate);
Parameters
device Handle to the device being configured.
frameScale Specifies the height in dB of the real-time frame. The value is ignored if
the scale is linear. Possible values range from [10 – 200].
frameRate Specifies the rate at which frames are generated in real-time mode, in
frames per second. Possible values range from [4 – 30], where four
means a frame is generated every 250ms and 30 means a frame is
generated every ~33 ms.
Sample Rate (I/Q pairs/s)