Spectrum GmbH | Spectrum Brands MI.61XX instruction

Software	C/C++ Driver Interface

Under Linux the additional parameter nBytesPerSample must be used for this function. For all boards with 8 bit resolution the parameter is „1“, for all boards with 12, 14 or 16 bit resolution this parameter has to be „2“. Under Linux the value „hDrv“ must contain the handle that was given back by the open function of that specific board.

Function SpcGetData (Linux)

int32 SpcGetData (int hDrv, int32 lCh, int32 lStart, int32 lLen, int16 nBytesPerSample, dataptr pvData)

(c) Spectrum GmbH

Page 31

Image 31

Spectrum Brands MI.61XX manual Spectrum GmbH

Contents

English version October 5 MI.61xxPage Software Hardware InstallationSoftware Driver Installation Introduction Standard generation modes Fifo ModeProgramming the Board Analog Outputs Appendix Option Gated ReplayOption Extra I/O Synchronization Option Preface IntroductionPreface General Information MI.6110 MI.6111 Different models of the MI.61xx seriesIntroduction Extra I/O Option -XMF Additional optionsExtra I/O Option -XIO Introduction Additional options Starhub Spectrum type plate Hardware information Block diagram Technical Data Filter Dynamic ParametersOrder information Hardware informationIntroduction Installing the board in the system Hardware InstallationSystem Requirements Installing a board with extra I/O Option -XMF Installing a board with digital inputs/outputs Only use the included flat ribbon cables Installing multiple boards synchronized by starhubMounting the wired boards Hooking up the boards Installing multiple synchronized boards Software Driver Installation Software Driver InstallationInterrupt Sharing Windows InstallationVersion control Driver Update Windows Software Driver Installation Windows Windows XP Windows XP Adding boards to the Windows NT driver Windows NT Overview Linux Automatic load of the driver Installing the deviceNow it is possible to access the board using this device Driver info Software SoftwareSoftware Overview First Test with SBench Linux Gnu C ++ Driver InterfaceHeader files Microsoft Visual C++ Include Drivers Other Windows C/C++ compilersNational Instruments LabWindows/CVI Driver functions Function SpcGetData Function SpcSetParamFunction SpcSetParam Function SpcSetData Windows Spectrum GmbH Examples Delphi Pascal Programming InterfaceType definition Include Driver Delphi Pascal Programming Interface Visual Basic Examples Visual Basic Programming InterfaceVBA for Excel Examples Visual Basic Programming Interface Register tables Error handlingProgramming the Board Overview PCI Register Example for error checkingInitialization Starting the automatic initialization routine Serial number Installed memoryHardware version Date of production Driver version Installed features and optionsUsed interrupt line Used type of driver Spcpciserialno Powerdown and resetExample program for the board initialization Spcpcimemsize Disabling the outputs Analog OutputsChannel Selection Important note on channels selection Register Value Direction Description Amplitude range Setting up the outputsOutput Amplifiers Output offset Maximum Output Range Filter SpecificationsOutput Filters General description Standard generation modesProgramming Minimum and stepsize of memsize and posttrigger in samples Standard generation modes ProgrammingMaximum memsize Maximum posttrigger in MSamples ProgrammingStandard generation modes Starting without interrupt classic modeStarting with interrupt driven mode Command register Value ’len’ as a 32 bit integer value Data organizationWriting data with SpcSetData Value ’start’ as a 32 bit integer value Bit Standard Mode Standard modeSample format Speed Limitations Fifo ModeGeneral Information Background Fifo Write 60040 Read out the number of available Fifo buffers Programming Fifo ModeSoftware Buffers Theoretical maximum sample rate PCI Bus Throughput Digital I/O 701x or 702x or pattern generator boards Fifo Mode ProgrammingBuffer processing Analog acquisition or generation boards Spcfifowait Example Fifo generation mode== Maxbuf Spcfifostart Programming Internally generated sample rate Clock generationStandard internal sample rate External reference clock Using plain quartz with no PLLExternal clocking Minimum external sample rate Direct external clockMaximum external samplerate in MS/s Example External clock with dividerCHANNEL0 CHANNEL1 CHANNEL2 CHANNEL3 External TTL trigger Example for setting up the software triggerTrigger modes and appendant registers Software trigger Positive TTL trigger Example on how to set up the board for positive TTL triggerEdge triggers Trigger modes and appendant registers Positive and negative TTL trigger Trigger modes Standard ModeOption Multiple Replay Output modes Trigger modes Option Multiple Replay Resulting start delays Value Direction Description General information and trigger delayOption Gated Replay Option Gated Replay Spctriggermode Tmttlpos Example programAllowed trigger modes External TTL edge trigger Transfer Data Option Extra I/ODigital I/Os Channel direction Programming example Analog OutputsAnalog Outputs Option Extra I/O Synchronization with option starhub Synchronization OptionDifferent synchronization options Synchronization with option cascading Write Data to on-board memory output boards only Setup order for the different synchronization optionsSet up the board parameters Example of board setup for three boards Define the remaining boards as trigger slaves Define the boards for trigger masterExample of board #2 set as trigger master 3a Define synchronization or trigger Arm the boards for synchronization Define the board for clock masterExample board number 0 is clock master Define the remaining boards as clock slaves Example for data reading Start all of the trigger master boardsWait for the end of the measurement Read data from the on-board memory acquisition boards only Spcsyncslavefifo Allocate the Fifo software buffers2a Write first data for output boards Spcsyncmasterfifo As trigger slaves 20xx 30xx 31xx 40xx 45xx 60xx 61xx 70xx 72xx Additions for synchronizing different boardsGeneral information Calculating the clock dividers Board type 3025 3131 Setting up the clock dividerBoard type 3122 3120 40 MS/s Additions for equal boards with different sample rates Resulting delays using different boards or speedsDelay in standard non Fifo modes Delay in Fifo mode Appendix Error CodesError name Value hex Value dec Error description Appendix Extra I/O with external connectorOption -XMF Pin assignment of the multipin connectorPin assignment of the multipin cable D15 D13 D11 Pin assignment of the internal multipin connectorExtra I/O with internal connector Option -XIO D14 D12 D10