background image

Section 3: Software Reference 

S530 Parametric Test Systems Frequency Analysis Option Manual 

 

3-12 

S530-923-01 Rev. A / January 2014 

 

Format

  int freq_detect_peaks(double min_level, double lower_bound, double upper_bound, 

double *freq_array, int nPeaks, double *amp_array, int nPeak1); 

Parameters

min_level

 

Minimum amplitude in dB; the peak detected must be higher than the min_level 

lower_bound

 

The measured peak will be ignored if the ratio of measured freq vs. returned peaks is NOT less than the 

lower_bound 

lower_bound

 

The measured peak will be ignored if the ratio of measured freq vs. returned peaks is NOT greater than the 

upper_bound 

nPeaks

 

Number of peak frequencies to be returned; zero will be returned to fill up the output array when the 

number of detected peaks is less than nPeaks 

nPeak1

 

Must be the same as nPeaks 

 

Returns

freq_array

 

array output of measured peak frequencies in Hz 

amp_array

 

amplitude of the measured peak frequencies in dB 

Remarks

:  

The spectrum analyzer must be initialized before using the 

freq_detect_peaks

 command. 

Example

   

double freq; 

   

double ampltd; 

   

   

   

   

Status1 = freq_init( ); 

   

Status2 = freq_setup(20e6, 850e6, 1e6); 

   

status3 = freq_detect_peaks(6e-4, 0.7, 1.4, &freq, 5, &ampltd, 5); 

 

freq_selftest 

Purpose

:    

Performs an internal self-test of the scope card. 

Format

 

   

 

int freq_selftest(); 

Parameters

:  

None 

Returns

:  

This command returns a 1, if executed without error; otherwise, a negative 

number is returned to indicate an error. 

Remarks

:    

The unit must be initialized before using 

freq_selftest

 command. 

Example

   

 

Status1 = freq_selftest(); 

 

Summary of Contents for S530

Page 1: ...www keithley com S530 Parametric Test System Frequency Analysis Option Manual S530 923 01 Rev A January 2014 PS53092301A S530 923 01 A Tektronix Company A Greater Mesure of Confidence...

Page 2: ...in whole or in part without the prior written approval of Keithley Instruments Inc is strictly prohibited All Keithley Instruments product names are trademarks or registered trademarks of Keithley In...

Page 3: ...be connected to mains These instruments will be marked as category II or higher Unless explicitly allowed in the specifications operating manual and instrument labels do not connect any instrument to...

Page 4: ...y disposed of according to federal state and local laws The WARNING heading in the user documentation explains dangers that might result in personal injury or death Always read the associated informat...

Page 5: ...Software description 2 1 Making a measurement 2 2 Create a KITT macro S530 2 3 Software Reference 3 1 Measurement routines 3 1 ring_lcc 3 2 ring_max 3 3 ring_meas 3 4 ring_ref 3 6 Control routines 3...

Page 6: ...is field installable by a Keithley field service engineer FSE Package contents The frequency analysis option includes the following content Model 4200 SCP2HR scope card Customer documentation KTE Use...

Page 7: ...nalyzer instead of a frequency counter is necessary because the signal frequency of the ring oscillator is often in excess of several hundred mega hertz This signal frequency is well beyond the measur...

Page 8: ...take a measurement using the basic sequence of required events To use the scope card when composing a Keithley Interactive Test Tool KITT macro open the scope card user library using the KITT librarie...

Page 9: ...2 3 Create a KITT macro S530 The following code creates a KITT macro S530 that you can use to make a scope card measurement double vcc 5 0 conpin SMU1 vcc_pin vccb_pin 0 conpin vss_pin GND 0 conpin SC...

Page 10: ...re the following signal characteristics Inverter chain CMOS ring oscillators see next figure Differential ring oscillators supported types only Figure 3 Generalized inverter chain ring The following m...

Page 11: ...utput pin vcc double Voltage of Vcc vccb double Voltage of Vccb stages int Number of stages to the signal output min_freq double Beginning frequency of the scan spectrum max_freq double Ending frequen...

Page 12: ...Purpose This algorithm detects frequency at maximum amplitude The next figure shows an example of a detected maximum amplitude Parameters Inputs Type Description vcc_pin int Pin number of Vcc pin vcc...

Page 13: ...until it finds the frequency peak in the desired frequency range Input parameters freq_expected and tolerance define the desired frequency range A failure is returned if the frequency cannot be found...

Page 14: ...1e30 if fails level_freq double Signal level dB 1e30 if fails status double Measure status 1 valid measurement in the first try n 0 valid measurement in n th iteration 2 level in the first measuremen...

Page 15: ...to 1 35 target_freq Parameters Inputs Type Description vcc_pin int Pin number of Vcc pin vccb_pin int Pin number of Vccb pin vss_pin int Pin number of Vss pin out_pin int Pin number of signal output p...

Page 16: ...mands for instrument setup and acquisition of data are provided in the control library freq_init freq_setup freq_measure freq_measure_next freq_detect_peaks freq_selftest freq_close freq_init Purpose...

Page 17: ...max_freq Stop frequency of the scan in Hz res_bandwidth Step size scan resolution in Hz can only be 1e6 3e5 1e5 3e4 1e4 3e3 or 1000 Relation of res_bandwidth and span Frequency span RBW 60 MHz Span 1...

Page 18: ...uble freq_result double amp_result Parameters None Returns This command returns a 1 if executed without error otherwise a negative number is returned to indicate an error freq_result measured frequenc...

Page 19: ...amp_result Parameters None Returns This command returns a 1 if executed without error otherwise a negative number is returned to indicate an error freq_result measured frequency in Hz amp_result measu...

Page 20: ...o choose the total number of peaks If a given peak detected is not greater than the minimum level min_level that peak will be dropped and the frequency will be returned as zero If the peak detected is...

Page 21: ...cies to be returned zero will be returned to fill up the output array when the number of detected peaks is less than nPeaks nPeak1 Must be the same as nPeaks Returns freq_array array output of measure...

Page 22: ...Reference S530 923 01 Rev A January 2014 3 13 freq_close Purpose This routine disconnects communications to the scope card Format int freq_close Parameters None Returns This command returns a 1 if exe...

Page 23: ...eithley Instruments Inc All other trademarks and trade names are the property of their respective companies Keithley Instruments Inc Corporate Headquarters 28775 Aurora Road Cleveland Ohio 44139 440 2...

Reviews: