background image

0004-000067  

13 

 

PV File Upload Interface 

 
Once The PV file is loaded it can be reviewed by using the link on the EPICS 
Configuration webLXI page, or going to http://<your instrument’s ip address>/ztec.pv.  If 
the new PV file is not visible, make sure the browser is not caching an old page by 
clearing the cache or temporary internet files, and then try to access the page again. 

Since full access is allowed to the PVs, it is possible to upload a non-functional file. If 
this occurs, EPICS functionality will become fully or partially disabled, depending on the 
type of error(s).  PV files can be invalidated in many ways, such as: missing brackets or 
quotations, incorrect number of fields, or FLNKs to non-existent PVs.  In order to verify 
the upload was successful, attempt to access the instrument through Channel Access. If 
this fails, upload a valid PV file, such as the default ztscopeM.pv. 

 

Channel Access Interface 

Channel Access is EPICS’s default command-line and code-based interface, used to 
view and modify process variables.  ZTEC

® 

has provided an example configuration script 

that can be used as a starting point if Channel Access is the preferred interface to 
EPICS.  This script, 

epics_ca_config.sh,

 can be found in the EPICS Installation 

script

 

directory.  Note this is a bash script, so it is necessary to be running Cygwin if using a 
Windows environment, or make command or syntax modifications if using another UNIX 
or Linux shell. 
 

Summary of Contents for ZT4211

Page 1: ...0004 000067 1 EPICS Interface M Class Oscilloscopes LXI Models ZT4611 ZT4612 ZT4211 ZT4212 ZT4421 ZT4422 ZT4431 ZT4432 ZT4441 ZT4442 User s Manual 0004 000067 Revision 2a December 7 2009...

Page 2: ...c or its licensor The reproduction and or transmission of this publication in whole or in part by any means electronic or mechanical is prohibited without the prior written consent of ZTEC Instruments...

Page 3: ...from the work surface Avoid placing tools or electrical parts on insulators Do NOT use any hand tool that can generate a static charge such as a non conductive plunger type solder sucker Use a conduct...

Page 4: ...r Section Renamed and Moved some previous Util PVs to Status PVs UtilStatus Status fixed instr error also UtilStandard StatusStandard fixed instr error also UtilFreqFault StatusFreq UtilTestResult Sta...

Page 5: ...3 EDM MEDM Interfaces 14 Functionality 15 Updating 15 Interfaces 15 Capturing 16 Continuous 16 Single 16 Uploading Waveforms 17 Instrument Use Example 18 Process Variables 19 Process Variable Table 19...

Page 6: ...e auto IP procedures to find a non allocated IP address 3 To determine the instrument s IP address consult the network manager or use any LXI compatible discovery tool such as the provided ZFind Utili...

Page 7: ...and Linux versions of the ZTEC M Class ZScope installers provide EPICS files in the following default installation directories EPICS Installation Windows C Program Files ZTEC Instruments Mclass Scope...

Page 8: ...ers Network configuration is done through the System Configuration page located on the password protected Configuration tab EPICS configuration is also done from the Configuration tab The final tab is...

Page 9: ...le ztscopeM pv which are installed in the following locations by default Windows C Program Files ZTEC Instruments Mclass Scope EPICS dat ztscopeM ch2 ztscopeM ch4 ztscopeM pv Linux usr local share ZSc...

Page 10: ...ent Database Definition File The database definition file defines the record types devices and behaviors for the database See the EPICS documentation for reference and examples A ztec device type has...

Page 11: ...atabase comes with a set of FLNKs to ensure get PVs are processed when the matching set PV is processed Fanout PVs consist of sets of forward links to other PVs Fanouts are useful when a series of com...

Page 12: ...ectory of the EPICS Installation To upload a PV Database file using the ZTEC ZFindTM utility Click on the desired instrument Click the EPICS icon in the toolbar see the ZFind Users Guide for how to ad...

Page 13: ...uch as missing brackets or quotations incorrect number of fields or FLNKs to non existent PVs In order to verify the upload was successful attempt to access the instrument through Channel Access If th...

Page 14: ...configuration files for the panels are found in the EPICS Installation dat directory Using the provided scripts it is possible to use these applications even if the PV prefixes have been altered For m...

Page 15: ...r from a FLNK will process each PV in the fanout group in order Sending caput ztec PvName value through Channel Access When sending input PVs through caput any value will work Sending caput ztec PvNam...

Page 16: ...vailable at 1000 points or less Larger captures are allowed but the data is decimated on read Continuous initiation will occur as fast as possible given the acquisition settings and it may not be poss...

Page 17: ...alloc points 4 sizeof f64 upload_buff 0 double type upload_buff 1 double points upload_buff 2 double time_int upload_buff 3 double volt_int for idx 0 idx points idx upload_buff idx 4 f64 wf_buff idx c...

Page 18: ...ith The environment variables are set through webLXI as described above The environment variables are the same whether they are on your local system or on the instrument 2 Open a channel access comman...

Page 19: ...0004 000067 19 Process Variables Process Variable Table The following tables list the process variables for the oscilloscope grouped according to instrument functionality...

Page 20: ...ueries the input offset in Volts for selected channel Input offset is limited according to range and impedance settings see specifications setInpNPos getInpNPos ao ai 0 0 to 1 0 Sets or queries the re...

Page 21: ...acquisition window and 1 0 the right most setHorzOffset getHorzOffset ao ai pre trigger time to 100 Time offset in seconds for trigger from selected trigger location offset reference Pre trigger 0 to...

Page 22: ...pture acquisition types of average envelope equivalent time and fast acquisition setEnvView getEnvView mbbo mbbi Discrete Envelope view select MIN minimum MAX maximum setAverView getAverView mbbo mbbi...

Page 23: ...nput channel 2 INP3 input channel 3 ZT4xx2 INP4 input channel 4 ZT4xx2 EXT external input MAN software only PATT pattern setTrigType getTrigType mbbo mbbi Discrete Trigger type EDGE edge IN pulse widt...

Page 24: ...LT2 TTLTRG2 external header TTLT3 TTLTRG3 external header TTLT4 TTLTRG4 external header TTLT5 TTLTRG5 external header TTLT6 TTLTRG6 external header TTLT7 TTLTRG7 external header INP1 input channel 1 I...

Page 25: ...er truth for defining pattern match criteria 0 low 1 high used in conjunction with set getTrigPattMask Bit 0 input channel 1 Bit 1 input channel 2 Bit 2 input channel 3 ZT4xx2 Bit 3 input channel 4 ZT...

Page 26: ...ent arm state setArmSource getArmSource mbbo mbbi Discrete Arm source IMM immediate bypass arm TTLT0 TTLTRG0 external header TTLT1 TTLTRG1 external header TTLT2 TTLTRG2 external header TTLT3 TTLTRG3 e...

Page 27: ...trigger complete event ATR trigger A event BTR trigger B event CAPT capture complete event OPC operation complete event CONS constant state PULS programmable pulse REF 10 MHz reference CLOC programmab...

Page 28: ...xample Calc1Enable Range and offset variables need to be updated after a capture Process Variable Type Values Description setCalcNEnable getCalcNEnable bo bi 0 or 1 Channel enable for selected calcula...

Page 29: ...nput channel 4 4 channel only CALC1 calculate channel 1 CALC2 calculate channel 2 CALC3 calculate channel 3 CALC4 calculate channel 4 REF1 reference channel 1 REF2 reference channel 2 REF3 reference c...

Page 30: ...tude linear MLOG magnitude logarithmic PHAS phase REAL real IMAG imaginary setCalcNFiltPoints getCalcNFiltPoints longout longin 2 to 40 Digital lowpass IIR filter smoothing points for selected calcula...

Page 31: ...umber of limit test failures until limit test aborts 0 runs the limit test until aborted n stops the limit test upon the nth failure CalcNLimitClear bo 0 or 1 Clears limit test statistics this will al...

Page 32: ...rage CAV Cycle average CFR Cycle frequency CPER Cycle period CRMS Cycle RMS DC DC RMS ENOB Effective number of bits FFT FEDG Number of Falling Edges FOV Falling edge overshoot FPR Falling edge preshoo...

Page 33: ...gate if setting the gates by number of samples setCalcNGatePointStop getCalcNGatePointStop ao ai 0 to Maximum waveform points Sets or gets the stop point for the mask test gate if setting the gates b...

Page 34: ...annel Reference offset is set automatically when the reference waveform is stored setRefNPos getRefNPos ao ai 0 0 to 1 0 Offset as a fraction of full scale for selected reference channel Reference off...

Page 35: ...length Sets or gets the start measurement gate in seconds if setting the gates by time setMeasGateFreqStart getMeasGateFreqStart ao ai 0 to of the current Sample Frequency Sets or gets the start meas...

Page 36: ...list of measurements A disabled measurement list retains its settings N is 1 to 4 MeasListNClear bo 0 or 1 Set to clear all eight measurements from the measurement list N is 1 4 Idle value is 0 After...

Page 37: ...of Rising Edges ROV Rising edge overshoot RPR Rising edge preshoot RTCR Rising edge crossing time RTIM Rise time SDEV Standard deviation SFDR Spurious free dynamic range FFT SNDR Signal to noise disto...

Page 38: ...ion from 0 to 1 causes the download after which the value returns to 0 OpArm bo 0 or 1 Manual arm for software arm source 0 disarm 1 arm This only applies when the arm source is set to software OpAuto...

Page 39: ...alues are 1000 points for all waveform PVs and the default EPICS_CA_MAX_ARRAY_BYTES is 16384 If NELM is less than the number of points captured by the instrument a valid decimated waveform will be ret...

Page 40: ...ing table N is substituted with the appropriate state number from 1 to 30 for example UtilSave1 Process Variable Type Values Description UtilID stringin ID string Identification string of following fo...

Page 41: ...rns the result of the unit self calibration process The internal calibration determines the zero DC offset the DC offset adjust scale factor and the ADC balance for all input range settings for all in...

Page 42: ...e number of failure reports from last baseboard self test 0 to 9 failures Note This functionality is only valid for the ZT44xx UtilTestCountSM2 longin integer ZT4xx2 Only Returns the number of failure...

Page 43: ...Receives the current instrument string output buffer Use after sending a query via UtilSCPISend See additional notes there setOutCoerce getOutCoerce bo bi 0 or 1 Selects whether set parameters update...

Page 44: ...tStatusEnable mbboDirect mbbiDirect 0016 to FF16 Status register bit enable mask Bit 0 unused Bit 1 unused Bit 2 error log not empty Bit 3 questionable event Bit 4 message available Bit 5 standard eve...

Page 45: ...nlocked Bit 3 memory 3 4 clock unlocked ZT4xx2 Bit 4 reference 1 2 clock unlocked Bit 5 reference 3 4 clock unlocked Bit 6 reference 1 2 loss of signal Bit 7 reference 3 4 loss of signal Bit 8 ADC 1 c...

Page 46: ...ry 1 2 clock unlocked Bit 3 memory 3 4 clock unlocked ZT4xx2 Bit 4 reference 1 2 clock unlocked Bit 5 reference 3 4 clock unlocked Bit 6 reference 1 2 loss of signal Bit 7 reference 3 4 loss of signal...

Page 47: ...gnal Bit 8 ADC 1 clock unlocked Bit 9 ADC 2 clock unlocked Bit 10 ADC 3 clock unlocked Bit 11 ADC 4 clock unlocked Bits 12 14 unused Bit 15 baseboard clock unlocked Bits 8 15 unused ZT4210 Bit 0 sampl...

Page 48: ...mbbiDirect 000016 to FFFF16 Test condition Bit 0 baseboard register test failed Bit 1 n a Bit 2 baseboard ROM test failed Bit 3 n a Bit 4 reference oscillator test failed Bit 5 DRAM test failed Bit 6...

Page 49: ...ting for trigger Bit 6 waiting for arm Bit 7 unused Bit 8 trigger event Bit 9 data capture event Bit 10 limit test event Bit 11 auto download event Bits 12 15 unused StatusPreset bo 0 or 1 Sets the st...

Page 50: ...setStatusQuesEnable getStatusQuesEnable mbboDirect mbbiDirect 000016 to FFFF16 Questionable register bit enable mask Bit 0 voltage fault Bits 1 4 unused Bit 5 frequency fault Bits 6 7 unused Bit 8 ca...

Page 51: ...3 4 overvoltage ZT4xx2 Bit 7 unused Bit 8 accessory 1 fault Bit 9 accessory 2 fault Bit 10 accessory 3 fault ZT4xx2 Bit 11 accessory 4 fault ZT4xx2 ZT4400 ZT4610 Bit 0 input 1 overload Bit 1 input 2 o...

Page 52: ...used Bit 6 input 3 4 overvoltage ZT4xx2 Bit 7 unused Bit 8 accessory 1 fault Bit 9 accessory 2 fault Bit 10 accessory 3 fault ZT4xx2 Bit 11 accessory 4 fault ZT4xx2 ZT4400 ZT4610 Bit 0 input 1 overloa...

Page 53: ...overvoltage ZT4xx2 Bit 7 unused Bit 8 accessory 1 fault Bit 9 accessory 2 fault Bit 10 accessory 3 fault ZT4xx2 Bit 11 accessory 4 fault ZT4xx2 ZT4400 ZT4610 Bit 0 input 1 overload Bit 1 input 2 overl...

Page 54: ...unused ZT4400 Bit 0 calibration storage failed Bit 1 offset zero failed Bit 2 offset scale failed Bit 3 unused Bit 4 gain balance failed Bit 5 unused Bit 6 trigger zero failed Bit 7 trigger gain faile...

Page 55: ...ailed Bits 6 15 unused ZT4400 Bit 0 calibration storage failed Bit 1 offset zero failed Bit 2 offset scale failed Bit 3 unused Bit 4 gain balance failed Bit 5 unused Bit 6 trigger zero failed Bit 7 tr...

Page 56: ...ed ZT4400 Bit 0 calibration storage failed Bit 1 offset zero failed Bit 2 offset scale failed Bit 3 unused Bit 4 gain balance failed Bit 5 unused Bit 6 trigger zero failed Bit 7 trigger gain failed Bi...

Page 57: ...ock test failed Bit 4 ZT4410 ZT4210 unused ZT4610 ADC1 Bit 5 ZT4410 ZT4210 unused ZT4610 ADC2 Bit 6 RAM1 test failed Bit 7 RAM2 test failed Digitizer 2 ZT4xx2 only Bit 0 register test failed Bit 1 ROM...

Page 58: ...3 memory clock test failed Bit 4 ZT4410 ZT4210 unused ZT4610 ADC3 Bit 5 ZT4410 ZT4210 unused ZT4610 ADC4 Bit 6 RAM3 test failed Bit 7 RAM4 test failed StatusTestDigNCond mbbiDirect 0016 to FF16 Digiti...

Page 59: ...0004 000067 59 ZTEC Instruments...

Reviews: