Signal Hound | API Functions
bbUSBTimeoutErr The USB transfer timed out during the requested sweep. Causes may
include a faulty USB cable or high processor/kernel load. See Error
Handling: Device Connection Errors
bbPacketFramingErr This error occurs when data loss or miscommunication has occurred
between the device and the API. During normal operation we do not
expect this error to occur. If you find this error occurs frequently, it may
be indicative of larger issues. If this error is returned, the data returned
is undefined. The device should be power cycled manually or with the
bbPreset routine.
bbADCOverflow This warning is returned when the ADC detects clipping of the input
signal. This occurs when the maximum voltage has been reached. Signal
analysis and reconstruction become issues on clipped signals. To
prevent this, a combination of increasing attenuation, decreasing gain,
or increasing reference level(when gain is automatic) will allow for more
headroom.
bbFetchAudio
Retrieve 4096 audio samples
bbStatus bbFetchAudio(int device, float *audio);
Parameters
device Handle of an initialized device.
audio Pointer to an array of 4096 32-bit floating point values
Description
If the device is initiated and running in the audio demodulation mode, the function is a blocking call
which returns the next 4096 audio samples. The approximate blocking time for this function is 128 ms if
called again immediately after returning. There is no internal buffering of audio, meaning the audio will
be overwritten if this function is not called in a timely fashion. The audio values are typically -1.0 to 1.0,
representing full-scale audio. In FM mode, the audio values will scale with a change in IF bandwidth.
Return Values
bbNoError Function returned successfully
bbDeviceNotOpenErr The device specified is not open
bbDeviceNotConfiguredErr The device is not initiated and running the audio demodulation mode.
bbNullPtrErr audio pointer is NULL
bbDeviceConnectionErr Device connection issues were present in the acquisition of audio. See
Error Handling : Device Connection Errors.
bbFetchRaw
Retrieve raw data from a streaming device
To Next Page
Loading...
Need help?
General
