5.7 Reference Guide for using DLL
199
This function provides measurement of the Spectrum.
Syntax
unsigned long spectrum(unsigned long center_frequency, unsigned short span, unsigned short num_points,
unsigned char trigger, unsigned short threshold, unsigned char acc_type, unsigned long lap, unsigned
short num_sweeps, unsigned char mode, short *data, unsigned short *act_span, unsigned long
*act_frequency);
Return Value
The return value of this function will be zero if the function is successful. Otherwise, the return value will be
an error code.
Parameter
center_frequency // center frequency in Hz
span // required span in KHz
num_points // number of points. The value must be power of two.
trigger // If 'trigger' == TRIGGERING_OFF (0x00) then Trigger is off.
// Measurement should to start immediately after receiving by
// a Host Controller the Read_Spectrum command.
// If 'trigger' == TRIGGERING_ON (0x01) then Trigger is on.
// Measurement will start only after receiving RF signal with power
// more than Threshold level.
// If 'trigger' == TRIGGERING_SYNC (0x03) then measurement
// will start if the access code correlator exceeds the trigger threshold
// If 'trigger' == TRIGGERING_RX_SLOT (0x04) measurement will
// start at start time of RX slot
Threshold // Threshold level for triggering in dB multiplied by 100. (1 unit = 0.01dBm)
// The value is meaningfull only if Trigger is on.
acc_type // type of access code. 0:custom, 1:IAC, 2:DAC, 3:CAC.
// Meaningful only if 'trigger' = TRIGGERING_SYNC.
Lap // LAP of BD_ADDR to derive an access code.
// Meaningful only if 'trigger' = TRIGGERING_SYNC and acc_type == 0 (custom) num_sweeps
// number of sweeps
mode // mode (AVERAGE_MODE / MAXHOLD_MODE). Meaningful if 'num_sweeps' > 1.
data// measurement data. The size must not be less than 'num_points'.
act_span // actual span in KHz
act_frequency // actual measurement frequency in Hz
modul_time
Description
This function provides measurement of the Modulation vs. Time characteristic.
Syntax
unsigned long modul_time(unsigned long carier_frequency, unsigned short resolution, unsigned
shortnum_points, unsigned char trigger, short start_time, short *freq_dev, unsigned short *act_resolution,
unsigned long *act_frequency);
Return Value
The return value of this function will be zero if the function is successful. Otherwise, the return value will be
an error code.
Parameter
carier_frequency // carier frequency in Hertzs. If zero then any frequency.
resolution // Time resolution (time interval between two nearest samples of data) in nanoseconds.
num_points // number of points
trigger // If 'trigger' = TRIGGERING_OFF (0x00) then Trigger is off.
// Measurement should to start immediately after receiving by a Host Controller
// the Read_Modulation_Time_Data command.
// If 'trigger' = TRIGGERING_SYNC (0x02) then measurement will start
// if the access code correlator exceeds the trigger threshold