5.7 Reference Guide for using DLL
200
start_time // Time offset in hundreds of nanoseconds from the triggering point.
freq_dev // pointer to initialized array to write the measured data of frequency deviation
// from 'carier_frequency' in Hertzs divided by 100. (1unit = 100 Hz)
act_resolution // actual resolution value in nanoseconds
act_frequency // actual measurement frequency value in Hertzs
power_time
Description
This function provides measurement of the Power-Time characteristic.
Syntax
unsigned long power_time(unsigned char meas_mode, unsigned long frequency, unsigned short
resolution,unsigned short num_points, unsigned char trigger, short threshold, unsigned char acc_type,
unsigned long lap, short start_time, unsigned short num_sweeps, unsigned char sweep_mode, unsigned
char cal, short *power, 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
meas_mode // measurement mode: 0: passive (connectionless), 1: active
frequency // unit : Hz
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 starts immediately after receiving by a HC the Read_Power_Time_Data
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 (0x02) then measurement will
// start if the access code correlator exceeds the trigger threshold
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)
start_time // Time offset in hundreds of nanoseconds from the triggering point.
// This parameter will be ignored if Trigger is off.
num_sweeps // number of sweeps
sweep_mode // sweep mode (AVERAGE_MODE / MAXHOLD_MODE). Meaningful if 'num_sweeps' > 1.
cal // flag whether calibration must be done. 0:skip calibration, 1:calibrate power data
power // measurement data
act_resolution // actual span in KHz
act_frequency // actual measurement frequency in Hz
power_channel
Description
This function provides measurement of the Power vs Channel characteristic.
Syntax
unsigned long power_channel(short power[79]);
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