Shsaoccupiedbandwidthdata structure, Shsachanneldata structure, Sweepcount – Bird Technologies SignalHawk User Manual
Page 26
Bird Technologies
14
SweepCount
SweepCount is used to provide information about the data set when a
timeout occurs while waiting for data. Under normal conditions, the
API will always return complete measurements and SweepCount = 705.
However, if the requested timeout value passed in shSaGetData() is too
short, shSaGetData() will return an ERROR_TIMEOUT error. In this
case, it is possible that the PC Hawk has delivered a part of a sweep.
SweepCount will indicate the number of data samples since the start
of the sweep.
Subsequent calls to shSaGetData() will accumulate more of the data
associated with the sweep until either the sweep is complete or shSaS-
top() is called to stop the sweep.
It is recommended that shSaGetData be called with a timeout value
long enough to accumulate the entire sweep. However, these details
allow shSaGetData to be called repeatedly until all the data has been
acquired. See the DoSaSweep() function in the DefaultSaMeasureCon-
sole sample project for an example of this use of shSaGetData().
shSaOccupiedBandwidthData Structure
shSaChannelData Structure
SaCountersId FreqData[SA_MAX_DATA_SIZE]
SweepData[SA_MAX_DATA_SIZE]
CountersData
SaDemodSignalId
None. See shSaDemodSignalData for
information on demodulation data
structures.
OccupiedBandwidth
Variable of type Frequency (unsigned
64 bit) indicating the Occupied
Bandwidth measurement result in Hz.
ChannelPower
Variable of type float indicating the
Channel Power in dBm.