beautypg.com

Shsaoccupiedbandwidthdata structure, Shsachanneldata structure, Sweepcount – Bird Technologies SignalHawk User Manual

Page 26

background image

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.