background image

2 Software Tools: M31/M33XXA Digitizers

Parameters

Name

Description

Inputs

errorIn

(LabVIEW only) If it contains an error, the function will not be executed and errorIn will be
passed to errorOut

Outputs

nModules

Number of Keysight modules installed in the system. Negative numbers for errors

Error Codes

(page 81)

errorOut

(LabVIEW only)

Error Codes (page 81)

C

int SD_Module_moduleCount();

C++

int SD_Module::moduleCount();

Visual Studio .NET, MATLAB

int SD_Module::moduleCount();

Python

int SD_Module::moduleCount();

LabVIEW

moduleCount.vi

M3601A

Available: No

2. 4. 2. 4 getProductName

This function returns the product name of the specified device.

Static Function: (Object-oriented languages only)
getProductName is a static function

30

Keysight M31XXA/M33XXA Digitizer User's Guide

Содержание M31 A Series

Страница 1: ...User s Guide Keysight M31XXA M33XXA Digitizers...

Страница 2: ...by which the software is customarily provided to the public Accordingly Keysight provides the Software to U S government customers under its standard commercial license which is embodied in its End U...

Страница 3: ...ith local AC mains connections Assume all measurement control and data I O connections are for connection to Category I sources unless otherwise marked or described in the user documentation Exercise...

Страница 4: ...Canadian Interference Causing Equipment Standard ICES 001 It also identifies the product is an Industrial Scientific and Medical Group 1 Class A product CISPR 11 Clause 4 South Korean Class A EMC Dec...

Страница 5: ...ight SD1 SFP Software Front Panels Overview 19 2 1 1 2 Main Front Panel 19 2 1 1 3 Input settings 20 2 1 1 4 Time domain scope like operation 21 2 1 1 5 Frequency domain Spectrum Analyzer 22 2 2 FPGA...

Страница 6: ...9 DAQstartMultiple 54 2 4 5 10 DAQstop 55 2 4 5 11 DAQstopMultiple 56 2 4 5 12 DAQpause 57 2 4 5 13 DAQpauseMultiple 58 2 4 5 14 DAQresume 59 2 4 5 15 DAQresumeMultiple 60 2 4 5 16 DAQflush 61 2 4 5 1...

Страница 7: ...Tools 85 3 1 1 SW Programming 85 3 1 1 1 Keysight SD1 Programming Libraries 86 3 1 2 HW Programming 86 3 1 2 1 HVI Technology Keysight M3601A 86 3 1 2 2 FPGA Programming Keysight M3602A 90 3 2 Design...

Страница 8: ...viii...

Страница 9: ...VI section 3 1 2 1 with precise timing and multi module synchronization Graphical FPGA programing section 3 1 2 2 allows for FPGA customization without HDL programming expertise and performance penalt...

Страница 10: ...option This option might be needed when different modules coexist The compatibility options are shown in Table 0 Output Signal Selection Programming Definitions Option Description Name Value Legacy Ch...

Страница 11: ...r User s Guide 3 1 1 1 Input Settings The M31 M33XXA Digitizers provides a block that allows the user to configure all the input settings such as input impedance full scale coupling prescaler etc Figu...

Страница 12: ...pedance Input impedance is high value is product dependent check the corresponding datasheet AIN_IMPEDANCE_HZ 0 50 Input impedance is 50 AIN_IMPEDANCE_50 1 Table 1 Options for the input impedance sett...

Страница 13: ...its Advanced Prescaler vs Downsampling Decimation The prescaler cannot be considered as a full decimation or downsampling block as it does not contain any filter and therefore it generates aliasing Fo...

Страница 14: ...n Name Value Rising Edge Trigger is generated when the input signal is rising and crosses the threshold AIN_RISING_EDGE 1 Falling Edge Trigger is generated when the input signal is falling and crosses...

Страница 15: ...1 Theory of Operation M31 M33XX Digitizers Keysight M31XXA M33XXA Digitizer User s Guide 7 Table 6 Programming functions related to the analog triggers...

Страница 16: ...e among others the trigger method the number of DAQ cycles to perform number of triggers the number of acquired words per cycle DAQ pointsPerCycle and the number of words that must be acquired before...

Страница 17: ...sing and Resuming the DAQ The function DAQstop page 55 pauses the DAQ operation triggers are discarded The acquisition can be resumed calling DAQstart page 53 A DAQstop is performed automatically when...

Страница 18: ...and the computer can handle Larger buffers allow handling longer high speed bursts PC load The DAQ buffer must be chosen to allow the PC enough time to pro cess each DAQ buffer DAQdata and to handle i...

Страница 19: ...ig Section 2 4 5 4 As show in Table 7 the user has the following options for hardware triggers Hardware Digital Trigger If the DAQ is set to use a digital hardware trigger the user must configure it u...

Страница 20: ...onfigures the acquisition of words Data Acquisition DAQs Section 2 4 5 4 DAQdigitalTriggerConfig This function configures the digital hardware triggers for the selected DAQ Trigger Section 2 4 5 5 DAQ...

Страница 21: ...rIOread This function reads the trigger input Section 2 4 5 23 clockSetFrequency This function sets the module clock frequency Section 2 4 5 24 clockGetFrequency This function returns the real hardwar...

Страница 22: ...1 Theory of Operation M31 M33XX Digitizers Table 10 Programming functions related to the digitizers 14 Keysight M31XXA M33XXA Digitizer User s Guide...

Страница 23: ...se digital output sig nal which can be written by the user software AOU_TRG_OUT 0 Trigger Input TRG operates as a trigger input or as general purpose digital input signal which can be read by the user...

Страница 24: ...plications where clock stability and precision is crucial e g GPS experimental physics etc the user can replace the chassis clock with an external reference In the case of PXI PXIe this is possible vi...

Страница 25: ...frequency can be changed within the range indicated in the datasheet of the corresponding product function clockSet Frequency Section 2 3 4 17 on page 44 The CLKsync frequency changes with the CLKsys...

Страница 26: ...18 Keysight M31XXA M33XXA Digitizer User s Guide...

Страница 27: ...enchtop instruments using Keysight SD1 SFP 2 a software front panel application This chapter describes the M31 M33XXA digitizer SD1 SFP front panel Consult Section 3 3 1 2 1 1 2 Main Front Panel Figur...

Страница 28: ...lable channels waiting for the user to configure the input Channels Digitizer front panel provide both time domain scope like functionality and frequency domain spectrum analyzer like functionality 2...

Страница 29: ...33XXA digitizer input control 2 1 1 4 Time domain scope like operation Figure7c shows the dialogs and the workflow to use the SD1 SFP as a scope Figure7c M31 M33XXA digitizer scope workflow Digitizer...

Страница 30: ...ons Figure7d M31 M33XXA digitizer FFT Spectrum analyzer control Spectrum analyzer Workflow 1 Select channel 2 Define number of FFT points set resolution 3 Set windowing option see windows types below...

Страница 31: ...estimation WINDOW_GAUSS 6 Table14a M31 M33XXA digitizer FFT window types 2 2 FPGA Programming Keysight M3602A Design Environment M3XXXA PXIe hardware with FP1 option 2 2 1 FPGA Programming Overview A...

Страница 32: ...sign environment with a user friendly flowchart style interface 2 3 2 HVI Functions Keysight s HVI Technology uses the same programming instructions that are available in the Keysight SD1 Programming...

Страница 33: ...osoft Visual Studio NET NET Library dll MinGW Qt GCC C Library h a Any C compiler C Library h lib C Microsoft Visual Studio NET NET Library dll MinGW Qt GCC C Library h a C Builder Turbo C C Library h...

Страница 34: ...eters Some of the parameters of the library functions are language dependent The table of inputs and outputs parameters for each function is a conceptual description therefore the user must check the...

Страница 35: ...the device is located The chassis number can be found in nearly any Keysight software It can also be retrieved with the function getChassis page 33 slot Slot number where the device is plugged in This...

Страница 36: ...atibility Python int SD_Module openWithSerialNumber string productName string serialNumber int SD_Module openWithSlot string productName int chassis int slot int SD_Module openWithSerialNumberCompatib...

Страница 37: ...page 81 C int SD_Module_close int moduleID C int SD_Module close Visual Studio NET MATLAB int SD_Module close Python int SD_Module close LabVIEW close vi M3601A Available No 2 4 2 3 moduleCount This...

Страница 38: ...s for errors Error Codes page 81 errorOut LabVIEW only Error Codes page 81 C int SD_Module_moduleCount C int SD_Module moduleCount Visual Studio NET MATLAB int SD_Module moduleCount Python int SD_Modu...

Страница 39: ...ly If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs productName Product name It can be used in function open errorOut Error Codes page 81 C int...

Страница 40: ...found on the chassis or in nearly any Keysight software It can also be retrieved with the function getSlot page 34 errorIn LabVIEW only If it contains an error the function will not be executed and e...

Страница 41: ...vice is located Static Function Object oriented languages only getChassis is a static function Parameters Name Description Inputs index Module index It must be in the range 0 nModules 1 where nModules...

Страница 42: ...tion Parameters Name Description Inputs index Module index It must be in the range 0 nModules 1 where nModules is returned by function moduleCount page 29 errorIn LabVIEW only If it contains an error...

Страница 43: ...is only available in PXI PXI Express form factors Parameters Name Description Inputs moduleID Non object oriented languages only Module identifier returned by function open page 27 nPXItrigger PXI tr...

Страница 44: ...ilable in PXI PXI Express form factors Parameters Name Description Inputs moduleID Non object oriented languages only Module identifier returned by function open page 27 nPXItrigger PXI trigger number...

Страница 45: ...e 37 C int SD_Module PXItriggerRead int nPXItrigger Visual Studio NET MATLAB int SD_Module PXItriggerRead int nPXItrigger Python int SD_Module PXItriggerRead int nPXItrigger LabVIEW PXItriggerRead vi...

Страница 46: ...nterface data Tx data buffer dataSize Number of 32 bit words to write maximum is 128 words errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to...

Страница 47: ...open page 27 nPCport PCport number address Address that will appear the PCport interface dataSize Number of 32 bit words to read maximum is 128 words errorIn LabVIEW only If it contains an error the f...

Страница 48: ...dress int data SD_AddressingMode addressMode SD_AccessMode accessMode Python int int SD_Module FPGAreadPCport int nPCport int dataSize int address int addressMode int accessMode Returned data array is...

Страница 49: ...r value errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs moduleIDout LabVIEW only A copy of moduleID errorOut See Error Cod...

Страница 50: ...gValue string unit int SD_Module writeDoubleRegisterWithName string regName double regValue string unit LabVIEW writeRegister vi M3601A Available No the value can be accessed using math operations e g...

Страница 51: ...odule readRegister const char regName int regValue double SD_ Module readRegister int regNumber const char unit int errorOut double SD_ Module readRegister const char regName const char unit int error...

Страница 52: ...2 Software Tools M31 M33XXA Digitizers M3601A Available No the value can be accessed using math operations e g MathAssign 44 Keysight M31XXA M33XXA Digitizer User s Guide...

Страница 53: ...Scale Input full scale in volts impedance Input impedance coupling Input coupling errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut...

Страница 54: ...LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs moduleIDout LabVIEW only A copy of moduleID errorOut Error Codes page 81 C int SD...

Страница 55: ...eshold in volts errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs moduleIDout LabVIEW only A copy of moduleID errorOut Error...

Страница 56: ...but less than the amount specified in DAQpoints Parameters Name Description Inputs moduleID Non object oriented languages only Module identifier returned by function open page 27 nDAQ DAQ to configure...

Страница 57: ...erDelay int triggerMode LabVIEW DAQconfig vi 2 4 5 5 DAQdigitalTriggerConfig This function configures the digital hardware triggers for the selected DAQ Trigger page 11 Parameters Name Description Inp...

Страница 58: ...AQ int triggerSource int triggerBehaviour Python int SD_AIN DAQdigitalTriggerConfig int nDAQ int triggerSource int triggerBehaviour LabVIEW DAQdigitalTriggerConfig vi M3601A Available Yes 2 4 5 6 DAQa...

Страница 59: ...tudio NET MATLAB int SD_AIN DAQanalogTriggerConfig int nDAQ int triggerNumber Python int SD_AIN DAQanalogTriggerConfig int nDAQ int triggerNumber LabVIEW DAQanalogTriggerConfig vi M3601A Available No...

Страница 60: ...utputs moduleIDout LabVIEW only A copy of moduleID DAQdata Array with acquired words DAQpoints Number of acquired words status 1 if DAQpoints is equal to the amount of words configured with DAQconfig...

Страница 61: ...ed languages only Module identifier returned by function open page 27 nDAQ DAQ to be started or resumed DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the function will n...

Страница 62: ...s 0 bit 1 and so forth DAQ n is connected to channel n nDAQ DAQ to be started or resumed DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the function will not be executed...

Страница 63: ...ect oriented languages only Module identifier returned by function open page 27 nDAQ DAQ to be paused DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the function will not...

Страница 64: ...DAQ n is con nected to channel n nDAQ DAQ is paused DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOu...

Страница 65: ...Non object oriented languages only Module identifier returned by function open nDAQ DAQ to be stopped errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be...

Страница 66: ...t 1 and so forth DAQ n is connected to channel n DAQ DAQ is paused DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be pa...

Страница 67: ...uages only Module identifier returned by function open page 27 nDAQ DAQ to be resumed errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to error...

Страница 68: ...AQ n is connected to channel n nDAQ DAQ is started or resumed DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed...

Страница 69: ...oduleID Non object oriented languages only Module identifier returned by function open page 27 nDAQ DAQ to be reset errorIn LabVIEW only If it contains an error the function will not be executed and e...

Страница 70: ...re reset LSB is DAQ 0 bit 1 is DAQ 1 and so forth DAQ n is connected to channel n DAQ DAQ to be reset DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the function will not...

Страница 71: ...puts moduleID Non object oriented languages only Module identifier returned by function open page 27 nDAQ DAQ to be triggered DAQ n is connected to channel n erronIn LabVIEW only If it contains an err...

Страница 72: ...t which DAQs are triggered LSB is 0 bit 1 and so forth DAQ n is con nected to channel n DAQ DAQ to be triggered DAQ n is connected to channel n errorIn LabVIEW only If it contains an error the functio...

Страница 73: ...uts moduleID Non object oriented languages only Module identifier returned by function open page 27 DAQ DAQ whose counter is read errorIn LabVIEW only If it contains an error the function will not be...

Страница 74: ...direction Input or output syncMode Sampling synchronization mode errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs moduleIDo...

Страница 75: ...rs Name Description Inputs moduleID Non object oriented languages only Module identifier returned by function open page 27 value Trigger output value 0 OFF 1 ON errorIn LabVIEW only If it contains an...

Страница 76: ...oriented languages only Module identifier returned by functionopen page 27 errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs...

Страница 77: ...Description Inputs moduleID Non object oriented languages only Module identifier returned by func tion open page 27 frequency Frequency in Hz mode Operation mode of the variable Clock System page 16 e...

Страница 78: ...tFrequency double frequency int mode LabVIEW clockSetFrequency vi M3601A Available No 2 4 5 25 clockGetFrequency This function returns the real hardware clock frequency Clock System page 16 It may dif...

Страница 79: ...y int moduleID C double SD_AIN clockGetFrequency Visual Studio NET MATLAB double SD_AIN clockGetFrequency Python double SD_AIN clockGetFrequency LabVIEW clockGetFrequency vi M3601A Available No 2 4 5...

Страница 80: ...uency Visual Studio NET MATLAB int SD_AIN clockGetSyncFrequency Python int SD_AIN clockGetSyncFrequency LabVIEW clockGetSyncFrequency vi M3601A Available No 2 4 5 27 clockResetPhase This function sets...

Страница 81: ...rror Codes page 81 C int SD_AIN_clockResetPhase int moduleID int triggerBehavior int PXItrigger double skew C int SD_AIN clockResetPhase int triggerBehavior int PXItrigger double skew Visual Studio NE...

Страница 82: ...lled user Object It can be null errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs moduleID Non object oriented languages onl...

Страница 83: ...d and released by user nPoints Size of dataBuffer buffer errorIn LabVIEW only If it contains an error the function will not be executed and errorIn will be passed to errorOut Outputs moduleID Non obje...

Страница 84: ...t be executed and errorIn will be passed to errorOut Outputs moduleID Non object oriented languages only Module identifier or a negative number for errors see Error Codes errorOut See Error Codes buff...

Страница 85: ...ect oriented languages only Module identifier returned by function open nDAQ DAQ from where use take out the buffer errorIn LabVIEW only If it contains an error the function will not be executed and e...

Страница 86: ...riented languages only Module identifier returned by function open nDAQ DAQ from where use take out the buffer errorIn LabVIEW only If it contains an error the function will not be executed and errorI...

Страница 87: ...acquired by DAQread size Input data size resultSize Size of the output buffers module and phase dB Scale dB or linear windowType Windowing option section 2 1 5 errorIn LabVIEW only If it contains an e...

Страница 88: ...int SD_AIN FFT int channel short data out double result bool dB int windowType int SD_AIN FFT int channel short data out double result out double resultPhase bool dB int windowType Python double int S...

Страница 89: ...SD_ERROR_BITMAP_ASSIGNED_DOES_ NOT_EXIST 8015 Keysight Error Any input assigned to the bitMap does not exist SD_ERROR_BUS_INVALID_SIZE 8016 Keysight Error Input size does not fit on this bus SD_ERROR...

Страница 90: ...CTION 8050 Keysight Error Invalid direction SD_ERROR_INVALID_MODE 8051 Keysight Error Invalid mode SD_ERROR_INVALID_FREQUENCY 8052 Keysight Error Invalid frequency SD_ERROR_INVALID_IMPEDANCE 8053 Keys...

Страница 91: ...Software Tools M31 M33XXA Digitizers Keysight M31XXA M33XXA Digitizer User s Guide 83 Error Define Error No Error Description SD_Error INVALID_HANDLE 8072 Invalid handle Table 15 Software error codes...

Страница 92: ...84 Keysight M31XXA M33XXA Digitizer User s Guide...

Страница 93: ...ighly optimized software instructions controls the off the shelf functionalities of the compatible Keysight hardware These instructions are compiled into the Programming Libraries The use of customiza...

Страница 94: ...al time performance might not be enough for the application even with a real time operating system In addition many modern applications require tight triggering and precise intermodule synchronization...

Страница 95: ...in the Keysight SD1 Programming Libraries HVIs are programmed with Keysight M3601A an HVI design environment with a user friendly flowchart style interface compatible with all M3XXXA Keysight PXIe har...

Страница 96: ...rogramming Key sight M3602A Design Environment M3XXXA PXIe hardware with FP1 option page 23 HVIs can interact with user defined FPGA functions making the real time processing capabilities of HVIs unli...

Страница 97: ...and Software Overview Keysight M31XXA M33XXA Digitizer User s Guide 89 Figure 12 HVI flowchart elements Keysight M3601A is based on flowchart programming providing an easy to use environment to devel...

Страница 98: ...n optional FP1 Enabled FPGA Programming capability with K32 or K41 logic This capability provides the same built in functionalities of their standard counterparts giving the users more time to focus o...

Страница 99: ...at allows the user to customize M3XXXA PXIe hardware products M3602A provides the necessary tools to design compile and program the FPGA of the module Figure 15 Keysight M3602A provides the following...

Страница 100: ...e up space The user can remove unused built in resources to free up more FPGA space One click compiling and programming 3x faster ultra secure cloud FPGA compiling An ultra fast cloud compiling sys te...

Страница 101: ...he Design IO Blocks that provide the outer interface of the design The user can then add remove blocks from the Keysight Block Library External Blocks or Xilinx IP cores 3 3 Application Software 3 3 1...

Страница 102: ...This information is subject to change without notice Keysight Technologies 2013 2020 Edition 2 February 2020 M3100 90002 www keysight com...

Отзывы: