IQview_defines.h
上传用户:gelin96
上传日期:2017-01-08
资源大小:20993k
文件大小:22k
- /*===========================================================================
- Module:
- IQView_defines.h
- Description:
- This header file defines names used when extracting results from the IQV
- tester interface.
- ===========================================================================*/
- #ifndef IQVIEW_DEFINES_H
- #define IQVIEW_DEFINES_H
- /*===========================================================================
- Definitions
- ===========================================================================*/
-
- enum IQV_GROUP_ENUM
- {
- IQV_GROUP_0, /* Reserved */
- IQV_GROUP_1, /* Reserved */
- IQV_GROUP_FFT, /* Generic FFT Analysis */
- IQV_GROUP_CCDF_ANALYSIS, /* CCDF Analysis */
- IQV_GROUP_OFDM_POWER_RAMP, /* OFDM Power Ramp Analysis */
- IQV_GROUP_802_11_B_POWER_RAMP, /* 802.11 B Power Ramp Analysis */
- IQV_GROUP_SIDE_LOBE, /* General Spectrum Analysis,
- includes 11B side lobe and 11a,g
- spectrum analysis */
- IQV_GROUP_802_11_B_ANALYSIS, /* 802.11 B Analysis */
- IQV_GROUP_OFDM_ANALYSIS, /* OFDM Analysis */
- IQV_GROUP_9, /* Reserved */
- IQV_GROUP_WAVE_ANALYSIS, /* Wave Analysis */
- IQV_GROUP_CW_ANALYSIS, /* Continuous Wave Analysis */
- IQV_GROUP_POWER_ANALYSIS, /* Returns RMS Power in dB. */
- IQV_GROUP_13, /* Reserved */
- IQV_GROUP_14, /* Reserved */
- IQV_GROUP_15, /* Reserved */
- IQV_GROUP_16, /* Reserved */
- IQV_GROUP_17, /* Reserved */
- IQV_GROUP_18, /* Reserved */
- IQV_GROUP_MISC_CMD, /* Reserved for IQV_misc_cmd. */
- IQV_LAST_GROUP
- };
- /*===========================================================================
- Values can be retrieved with the following functions:
- - IQV_result
- - IQV_result_real
-
- Vectors can be retrieved with the following functions:
- - IQV_result_data_real (real part of a vector)
- - IQV_result_data_imag (imaginary part of a vector)
-
- ===========================================================================*/
- /*===========================================================================
- Results returned after running IQV_data_analysis of group
- IQV_GROUP_WAVE_ANALYSIS.
- ===========================================================================*/
- /* DC DC value. Value is returned. */
- #define IQV_RES_DC_DC "DC.DC"
- /* DC RMS value. Value is returned. */
- #define IQV_RES_DC_RMS "DC.rms"
- /* DC Minimum value. Value is returned. */
- #define IQV_RES_DC_MIN "DC.min"
- /* DC Maximum value. Value is returned. */
- #define IQV_RES_DC_MAX "DC.max"
- /* DC Peak to Peak value. Value is returned. */
- #define IQV_RES_DC_PP "DC.pp"
- /* DC RMS for I Channel. Value is returned. */
- #define IQV_RES_DC_RMS_I "DC.rms_I"
- /* DC RMS for Q Channel. Value is returned. */
- #define IQV_RES_DC_RMS_Q "DC.rms_Q"
- /* AC DC value. Value is returned. */
- #define IQV_RES_AC_DC "AC.DC"
- /* AC RMS value. Value is returned. */
- #define IQV_RES_AC_RMS "AC.rms"
- /* AC Minimum value. Value is returned. */
- #define IQV_RES_AC_MIN "AC.min"
- /* AC Maximum value. Value is returned. */
- #define IQV_RES_AC_MAX "AC.max"
- /* AC Peak to Peak value. Value is returned. */
- #define IQV_RES_AC_PP "AC.pp"
- /* AC RMS for I Channel. Value is returned. */
- #define IQV_RES_AC_RMS_I "AC.rms_I"
- /* AC RMS for Q Channel. Value is returned. */
- #define IQV_RES_AC_RMS_Q "AC.rms_Q"
- /* AC RMS value in dB. Value is returned. */
- #define IQV_RES_RMS_DB "rms_db"
- /*===========================================================================
- Results returned after running IQV_data_analysis specifically for group
- IQV_GROUP_OFDM_ANALYSIS.
- ===========================================================================*/
- /* EVM for data part of frame. Value is returned. */
- #define IQV_RES_EVM_DATA "evm.data"
- /* EVM for pilot part of frame. Value is returned. */
- #define IQV_RES_EVM_PILOT "evm.pilot"
- /* The PSDU data. 0/1 values. Includes the MAC Header
- and the FCS, if present. Real vector is returned. */
- #define IQV_RES_OFDM_PSDU_RX "ofdm.psdu_rx"
- /* Provides the approximate starting locations of each packet detected in
- the input data. If no packet detected, this is an empty vector.
- Real vector is returned. */
- #define IQV_RES_OFDM_START_POINTERS "ofdm.start_pointers"
- /* Provides the approximate end location of each packet pointed to in
- IQV_RES_OFDM_START_POINTERS. In this release this vector is always empty.
- Real vector is returned. */
- #define IQV_RES_OFDM_STOP_POINTERS "ofdm.stop_pointers"
- /* 64 element complex vector that represents the FFT output of the 2 long
- symbols in the PLCP pre-amble of the OFDM signal.
- Real vector is returned. */
- #define IQV_RES_OFDM_HHEST "ofdm.HHest"
- /* Single element double vector */
- /* 1 = PSDU CRC Check Failed, 0 = PSDU CRC Check Passed */
- #define IQV_RES_OFDM_PSDU_CRC_FAIL "ofdm.more_res.psdu_crc_fail"
- /* Single element double vector */
- /* 1 = PLCP CRC Check Passed, 0 = PLCP CRC Check Failed */
- #define IQV_RES_OFDM_PLCP_CRC_OK "ofdm.more_res.PLCP.crcok"
- /* Double vector */
- /* PLCP (binary) data as 1/0s. */
- #define IQV_RES_OFDM_PLCP_DATA "ofdm.more_res.PLCP.PLCP_bin"
- /* Single element double vector */
- /* Data rate in Mbps */
- #define IQV_RES_OFDM_DATA_RATE_MBPS "ofdm.more_res.PLCP.Data_rate_Mbps"
- /* Single element double vector */
- /* Coding Rate */
- #define IQV_RES_OFDM_CODING_RATE "ofdm.more_res.PLCP.Rr"
- /* Single element double vector */
- /* Number of symbols */
- #define IQV_RES_OFDM_NUMBER_SYMBOLS "ofdm.more_res.PLCP.Nspp"
- /* Single element double vector */
- /* Number of bytes in PSDU */
- #define IQV_RES_OFDM_RX_LENGTH "ofdm.more_res.PLCP.RX_length_oct"
- /*===========================================================================
- Results returned after running IQV_data_analysis specifically for group
- IQV_GROUP_802_11_B_ANALYSIS.
- ===========================================================================*/
- /* EVM peak value. Value is returned. */
- #define IQV_RES_EVM_PEAK "evm.pk"
- /* The PSDU data. 0/1 values. Includes the MAC Header and the
- FCS, if present. Real vector is returned. */
- #define IQV_RES_11B_PSDU_RX "b11.psdu_rx"
- /* Provides the approximate starting locations of each packet detected in the
- input data. If no packet detected, this is an empty vector.
- Real vector is returned. */
- #define IQV_RES_11B_START_POINTERS "b11.start_pointers"
- /* Provides the approximate end location of each packet pointed to in
- IQV_RES_OFDM_START_POINTERS.
- Real vector is returned. */
- #define IQV_RES_11B_STOP_POINTERS "b11.stop_pointers"
- /* Provides the start and end pointer for the packet selected by the
- analysis program for analysis.
- Real vector is returned. */
- #define IQV_RES_11B_SELECT "b11.select"
- /* Represents the values of the In-phase receiver channel at 19 samples
- per chip. Can be used to plot the eye-diagram by plotting samples
- (0:18)+n*19 on the same plot. Real vector is returned. */
- #define IQV_RES_EYE_REAL "b11.eye_real"
- /* Same as IQV_RES_EYE_REAL, except for the Quadrature receiver channel.
- Real vector is returned. */
- #define IQV_RES_EYE_IMAG "b11.eye_imag"
- /* Scrambler Initialization. 7 element (or empty) Real vector is returned. */
- #define IQV_RES_SCRAMBLER_INIT "b11.scrambler_init"
- /* Double vector */
- /* PLCP (binary) data as 1/0s. */
- #define IQV_RES_11B_PLCP_DATA "b11.PLCP_info.raw"
- /* Single element double vector */
- /* Bit Rate, see 802.11b standard */
- #define IQV_RES_11B_BIT_RATE "b11.PLCP_info.bit_rate"
- /* Single element double vector */
- /* Number of bytes in PSDU */
- #define IQV_RES_11B_RX_LENGTH "b11.PLCP_info.PSDU_length_oct"
- /* Single element double vector */
- /* Mod Type, see 802.11b standard */
- #define IQV_RES_11B_MOD_TYPE "b11.PLCP_info.mod_type"
- /* Single element double vector */
- /* Locked Clock, see 802.11b standard */
- #define IQV_RES_11B_LOCKED_CLOCK "b11.PLCP_info.locked_clock"
- /* Single element double vector */
- /* 1 = PLCP CRC Check Failed, 0 = PLCP CRC Check Passes */
- #define IQV_RES_11B_PLCP_CRC_FAIL "b11.PLCP_info.crc_fail"
- /* Single element double vector */
- /* 1 = PSDU CRC Check Failed, 0 = PSDU CRC Check Passes */
- #define IQV_RES_11B_PSDU_CRC_FAIL "b11.meas_out.crc_data_fail"
- /* Single element double vector */
- /* 1 = Long Preamble, 0 = Short Preamble */
- #define IQV_RES_11B_LONG_PREAMBLE "b11.db_stuff.long_preamble_flag"
- /*===========================================================================
- Results returned after running IQV_data_analysis of groups
- IQV_GROUP_OFDM_ANALYSIS or IQV_GROUP_802_11_B_ANALYSIS.
- The power results in this section are also returned after BlueTooth Analysis.
- ===========================================================================*/
- /* EVM for entire frame. Value is returned. */
- #define IQV_RES_EVM_ALL "evm.all"
- /* Frequency Error. Value is returned. */
- #define IQV_RES_FREQ_ERR "signal.freqerr"
-
- /* Symbol Clock Error. Value is returned. */
- #define IQV_RES_SYMBOL_CLOCK_ERR "signal.symclockerr"
- /* Frequency RMS Phase Noise. Value is returned. */
- #define IQV_RES_RMS_PHASE_NOISE "signal.rmspn"
- /* IQ Match Amplitude Error. Value is returned. */
- #define IQV_RES_IQ_MATCH_AMP "iqmatch.amp"
- /* IQ Match Amplitude Error in dB. Value is returned. */
- #define IQV_RES_IQ_MATCH_AMP_DB "iqmatch.amp_dB"
- /* IQ Match Phase Error. Value is returned. */
- #define IQV_RES_IQ_MATCH_PHASE "iqmatch.phase"
- /* Power RMS No Gap. Value is returned. */
- #define IQV_RES_POWER_RMS_NO_GAP "pow.rmsnogap"
- /* Power RMS. Value is returned. */
- #define IQV_RES_POWER_RMS "pow.rms"
- /* Power Peak. Value is returned. */
- #define IQV_RES_POWER_PEAK "pow.peak"
- /* Power RMS Max. Average. Value is returned. */
- #define IQV_RES_POWER_RMS_MAX_AVG "pow.maxavgrms"
- /*===========================================================================
- Results returned after running IQV_data_analysis of group
- IQV_GROUP_SIDE_LOBE.
- ===========================================================================*/
- /* Resolution Bandwidth in Hz. Value is returned. */
- #define IQV_RES_RESOLUTION_BW "sidelobe.res_bw_Hz"
- /* FFT Bin Size in Hz. Value is returned. */
- #define IQV_RES_FFT_BIN_SIZE "sidelobe.fft_bin_size_Hz"
- /* Peak Center in dB. Value is returned. */
- #define IQV_RES_PEAK_CENTER "sidelobe.peak_center"
- /* Peak 1st Lower Side Lobe in dB. Value is returned. */
- #define IQV_RES_PEAK_1_LEFT "sidelobe.peak_1_left"
- /* Peak 2nd Lower Side Lobe in dB. Value is returned. */
- #define IQV_RES_PEAK_2_LEFT "sidelobe.peak_2_left"
- /* Peak 1st Higher Side Lobe in dB. Value is returned. */
- #define IQV_RES_PEAK_1_RIGHT "sidelobe.peak_1_right"
- /* Peak 2nd Higher Side Lobe in dB. Value is returned. */
- #define IQV_RES_PEAK_2_RIGHT "sidelobe.peak_2_right"
- /*===========================================================================
- Results returned after running IQV_data_analysis of group
- IQV_GROUP_SIDE_LOBE. Retrieve by using function IQV_result_data_real.
- ===========================================================================*/
- /* PSD Plot data in dB. Real vector is returned. */
- #define IQV_RES_PSD_DB "sidelobe.psd_dB"
- /*===========================================================================
- Vector results returned after running IQV_data_analysis of groups
- IQV_GROUP_802_11_B_POWER_RAMP or IQV_GROUP_OFDM_POWER_RAMP.
- Retrieve by using function IQV_result_data_real.
- ===========================================================================*/
- /* Instant. power on ramp. Real vector is returned. */
- #define IQV_RES_RAMP_ON_POWER_INST "ramp.on_power_inst"
- /* Instant. power off ramp. Real vector is returned. */
- #define IQV_RES_RAMP_OFF_POWER_INST "ramp.off_power_inst"
- /* Power on ramp Peak values. Real vector is returned. */
- #define IQV_RES_RAMP_ON_POWER_PEAK "ramp.on_power_peak"
- /* Power off ramp Peak values. Real vector is returned. */
- #define IQV_RES_RAMP_OFF_POWER_PEAK "ramp.off_power_peak"
- /* Power on ramp time vector. Real vector is returned. */
- #define IQV_RES_RAMP_ON_TIME_VECT "ramp.on_time_vect"
- /* Power off ramp time vector. Real vector is returned. */
- #define IQV_RES_RAMP_OFF_TIME_VECT "ramp.off_time_vect"
- /* Power on ramp mask x-axis. Real vector is returned. */
- #define IQV_RES_RAMP_ON_MASK_X "ramp.on_mask_x"
- /* Power off ramp mask x-axis. Real vector is returned. */
- #define IQV_RES_RAMP_OFF_MASK_X "ramp.off_mask_x"
- /* Power on ramp mask y-axis. Real vector is returned. */
- #define IQV_RES_RAMP_ON_MASK_Y "ramp.on_mask_y"
- /* Power off ramp mask y-axis. Real vector is returned. */
- #define IQV_RES_RAMP_OFF_MASK_Y "ramp.off_mask_y"
- /* ---------------------------------------------------------------------------
- Consider the following example on how to plot IQV_RES_RAMP_O.._MASK_X vs.
- IQV_RES_RAMP_O.._MASK_Y:
-
- The two vectors IQV_RES_RAMP_ON_MASK_X and IQV_RES_RAMP_ON_MASK_Y consist
- of the following arbitrary data points:
-
- -------------------------------------------
- | x0 | x1 | x2 | x3 | x4 | x5 |
- ------------------------------------------------------------------
- IQV_RES_RAMP_ON_MASK_X | 0 | 5 | 5 | 10 | 11 | 12 |
- ------------------------------------------------------------------
-
- -------------------------------------------
- | y0 | y1 | y2 | y3 | y4 | y5 |
- ------------------------------------------------------------------
- IQV_RES_RAMP_ON_MASK_Y | -10 | 20 | 20 | 15 | -5 | -5 |
- ------------------------------------------------------------------
-
- Use a pair of x and y values to define a line segment. The first line
- segment is starting in point (x0, y0) and ending in point (x1, y1).
- The next line segment is starting in point (x2, y2) and ending in point
- (x3, y3). This continues until no more points are available.
-
- In the above example, the ramp consists of three line segments:
-
- (x0, y0) <-> (x1, y1) = ( 0, -10) <-> ( 5, 20)
- (x2, y2) <-> (x3, y3) = ( 5, 20) <-> (10, 15)
- (x4, y4) <-> (x5, y5) = (11, -5) <-> (12, -5)
- --------------------------------------------------------------------------- */
- /*===========================================================================
- Results returned after running IQV_data_analysis of groups
- IQV_GROUP_802_11_B_POWER_RAMP or IQV_GROUP_OFDM_POWER_RAMP.
- ===========================================================================*/
- /* Ramp on time. Value is returned. */
- #define IQV_RES_RAMP_ON_TIME "ramp.on_time"
- /* Ramp off time. Value is returned. */
- #define IQV_RES_RAMP_OFF_TIME "ramp.off_time"
- /*===========================================================================
- Results returned after running IQV_data_analysis of group
- IQV_GROUP_CW_ANALYSIS.
- ===========================================================================*/
- /* Frequency result. Value is returned. */
- #define IQV_RES_CW_FREQ "cw.freq"
- /*===========================================================================
- Results returned after running IQV_misc_cmd.
- ===========================================================================*/
- /* Serial Number. The serial number is returned in the structure
- IQV_RESULT_TYPE in the variable called desc. Can be read using IQV_result. */
- #define IQV_RES_SERIAL_NO "serial_no"
- /*===========================================================================
- Results returned after running IQV_data_analysis of group
- IQV_GROUP_CCDF.
- ===========================================================================*/
- /* Maximum number of returned elements for IQV_RES_CCDF_PROB and
- IQV_RES_CCDF_POWER_REL_DB. */
- #define IQV_MAX_CCDF_ELEMENTS 1000
- /* Real vector containing CCDF probability values (Y-axis of CCDF plot) */
- #define IQV_RES_CCDF_PROB "CCDF.prob"
- /* Real vector containing CCDF power relative to average power in dB values
- (X-axis of CCDF plot) */
- #define IQV_RES_CCDF_POWER_REL_DB "CCDF.power_rel_dB"
- /* Result structure for CCDF power percentage. Value is returned. */
- #define IQV_RES_CCDF_PERCENT_POW "CCDF.percent_pow"
- /*===========================================================================
- Results returned after running function IQV_fft_analyze.
- ===========================================================================*/
- /* X-axis values, typically frequency. Vector is returned. */
- #define IQV_RES_FFT_X "x"
- /* Y-axis values, power in dBm. Vector is returned. */
- #define IQV_RES_FFT_Y "y"
- /* X-axis label. String value is returned. */
- #define IQV_RES_FFT_X_LABEL "x_string"
- /* Y-axis label. String value is returned. */
- #define IQV_RES_FFT_Y_LABEL "y_string"
- /* Text for title. String value is returned. */
- #define IQV_RES_FFT_TITLE "title"
- /* Returns (value) whether results are valid or not. 1:valid, 0:invalid */
- #define IQV_RES_FFT_VALID "valid"
- /* Returns (value) that if equal to 1, indicates that the results */
- /* should be looked at with caution */
- #define IQV_RES_FFT_WARNING "warning"
- /* Returns a text string that explains the reason for the valid flag being 0
- /* or the warning flag being 1. */
- #define IQV_RES_FFT_ERROR "error"
- /* Returns length of X and Y Vectors above. Value is returned. */
- #define IQV_RES_FFT_LENGTH "length"
- /* Resolution bandwidth used in calculations. Value is returned. */
- #define IQV_RES_FFT_RES_BW "res_bw"
- /* Noise bandwitdh used in calculations. May be different than resolution
- bandwidth. Value is returned. */
- #define IQV_RES_FFT_NOISE_BW "noise_bw"
- /* Video bandwidth used in calculation. Value is returned. */
- #define IQV_RES_FFT_VIDEO_BW "video_bw"
- /* Start frequency in Hz. Value is returned. */
- #define IQV_RES_FFT_FREQ_START "Freq_start"
- /* Stop frequency in Hz. Value is returned. */
- #define IQV_RES_FFT_FREQ_STOP "Freq_stop"
- /* Frequency increment in Hz. Value is returned. */
- #define IQV_RES_FFT_FREQ_DELTA "Delta_freq"
- /*===========================================================================
- Results returned after running IQV_data_analysis of group
- IQV_GROUP_POWER_ANALYSIS.
- ===========================================================================*/
- /* RMS Power in dB, no gap. */
- #define IQV_RES_RMS_DB_NO_GAP "rms_db_nogap"
- /* RMS Power in dB. */
- #define IQV_RES_RMS_DB "rms_db"
- /*===========================================================================
- The following are the signals, which are predefined for use with the tester.
- ===========================================================================*/
- enum IQV_SIGNAL_ENUM
- {
- SIG_UNUSED, /* Unused value. */
- SIG_64_QAM_OFDM, /* 64 QAM OFDM signal. */
- SIG_16_QAM_OFDM, /* 16 QAM OFDM signal. */
- SIG_QPSK_OFDM, /* QPSK OFDM signal. */
- SIG_BPSK_OFDM, /* BPSK OFDM signal. */
- SIG_802_11_B_1MBS, /* 802.11b 1 Mbit/s. */
- SIG_802_11_B_2MBS, /* 802.11b 2 Mbit/s. */
- SIG_802_11_B_5_5MBS, /* 802.11b 5.5 Mbit/s. */
- SIG_802_11_B_11MBS, /* 802.11b 11 Mbit/s. */
- SIG_LAST
- };
- /*===========================================================================
- Raw data sample results returned after running IQV_data_capture. Retrieve
- the two channels by functions IQV_result_data_real and
- IQV_result_data_imag.
- ===========================================================================*/
- #define IQV_RES_CAPT_DATA ""
- /* Include the IQView.h header file. */
- #include "IQView.h"
- /*------------------------------------------------------------------- End ---*/
- #endif /* IQVIEW_DEFINES_H */