Programming the Board, Analog Inputs | Spectrum Brands MC.31XX

Programming the Board	36
Overview	36
Register tables	36
Programming examples	36
Error handling	36
Initialization	37
Starting the automatic initialization routine	37
PCI Register	37
Hardware version	38
Date of production	38
Serial number	38
Maximum possible sample rate	38
Installed memory	38
Installed features and options	38
Used interrupt line	39
Used type of driver	39
Powerdown and reset	40
Analog Inputs	41
Channel Selection	41
Important note on channels selection	41
Channel rerouting	42
Setting up the inputs	43
Input ranges	43
Input offset	44
Overrange bit	45
Input termination	45
Automatical adjustment of the offset settings	45
Standard acquisition modes	47
General Information	47
Programming	47
Memory, Pre- and Posttrigger	47
Starting without interrupt (classic mode)	48
Starting with interrupt driven mode	49
Data organization	50
Sample format	50
Reading out the data with SpcGetData	51
FIFO Mode	53
Overview	53
General Information	53
Background FIFO Read	53
Speed Limitations	53
Programming	54
Software Buffers	54
Buffer processing	55
FIFO mode	56
Example FIFO acquisition mode	56
Data organization	56
Sample format	57
Clock generation	58
Overview	58
Internally generated sample rate	58
Standard internal sample rate	58
Using plain quartz without PLL	59
External clocking	60
Direct external clock	60
External clock with divider	61
Trigger modes and appendant registers	62
General Description	62
Software trigger	62
External TTL trigger	62
Edge triggers	63
Pulsewidth triggers	64
Channel Trigger	66
Overview of the channel trigger registers	66
Triggerlevel	67
Detailed description of the channel trigger modes	69

4

Image 4

Spectrum Brands MC.31XX Programming the Board, Analog Inputs, Standard acquisition modes, Fifo Mode, Clock generation

Contents

MC.31xx English version April 27Page Hardware Installation Software Driver InstallationIntroduction Software Fifo Mode Programming the BoardAnalog Inputs Standard acquisition modes Option Multiple Recording Option Gated SamplingOption Timestamp Option Extra I/O Introduction PrefaceGeneral Information Preface MC.3110 MC.3120 MC.3130 MC.3111 MC.3121 MC.3131 Different models of the MC.31xx seriesIntroduction MC.3112 MC.3122 MC.3132 Additional options Digital inputsExtra I/O Option -XMF Introduction Additional options Starhub Timestamp Spectrum type plate Block diagram Technical Data Hardware information Dynamic Parameters Order informationIntroductionHardware information Order No Description Installing the board in the system Hardware InstallationSystem Requirements Installing a board with extra I/O Option -XMF Installing a board with digital inputs/outputsHardware Installation Installing multiple boards synchronized by starhub Mounting the wired boardsHooking up the boards Only use the included flat ribbon cables Installing multiple synchronized boards Interrupt Sharing Software Driver InstallationInterrupt Sharing Installation Software Driver Installation WindowsWindows Version control Driver Update Windows Driver Update Software Driver Installation Windows XP Windows XP Windows NT Software Driver Installation Windows NTAdding boards to the Windows NT driver Linux Overview Installing the device Now it is possible to access the board using this deviceDriver info Automatic load of the driver Software Software OverviewFirst Test with SBench Software Overview ++ Driver Interface Header filesMicrosoft Visual C++ Borland C++ Builder Other Windows C/C++ compilers National Instruments LabWindows/CVIDriver functions Include Drivers Software ++ Driver Interface Using the Driver under Linux Function SpcSetParamFunction SpcSetParam Function SpcSetData Windows Delphi Pascal Programming Interface Type definitionInclude Driver Examples Software Visual Basic Examples Visual Basic Programming InterfaceVBA for Excel Examples Visual Basic Programming Interface Error handling Programming the BoardOverview Register tables Example for error checking InitializationStarting the automatic initialization routine PCI Register Installed memory Installed features and optionsHardware version Date of production Used interrupt line Used type of driverProgramming the Board Initialization Driver version Powerdown and reset Example program for the board initializationSpcpcimemsize Spcpciserialno Analog Inputs Channel SelectionImportant note on channels selection Analog Inputs Channel rerouting Rerouting information for moduleSPCCHROUTE0 SPCCHROUTE1 Setting up the inputs Input ranges Input offset Register Value Direction Description Offset range Overrange bit Automatical adjustment of the offset settingsInput termination Spcadjautoadj Adjall Spcadjsave ADJUSER0 Standard acquisition modes ProgrammingMemory, Pre- and Posttrigger Pretrigger = memsize posttrigger Starting without interrupt classic mode Command registerMaximum posttrigger in MSamples Minimum memsize and posttrigger in samples Standard acquisition modes Programming Starting with interrupt driven modeStatus register Normal mode Fast 8 bit mode201100 Enables the fast 8 bit mode Data organization Standard mode Reading out the data with SpcGetDataValue ’start’ as a 32 bit integer value Value ’len’ as a 32 bit integer value Programming Fifo Mode General InformationBackground Fifo Read Speed Limitations Programming Fifo Mode Software BuffersTheoretical maximum sample rate PCI Bus Throughput 60040 Read out the number of available Fifo buffers Fifo Mode Programming Buffer processingAnalog acquisition or generation boards Digital I/O 701x or 702x or pattern generator boards Example Fifo acquisition mode Fifo acquisition exampleSpcfifostart Spcfifowait Sample format Internally generated sample rate Clock generationStandard internal sample rate Using plain quartz without PLL Maximum internal sample rate in MS/s normal modeExternal reference clock Clock generation External clocking Direct external clockMinimum external sample rate Maximum external samplerate in MS/s CHANNEL0 CHANNEL1 CHANNEL2 CHANNEL3 External clock with dividerFifo Trigger modes and appendant registers General DescriptionSoftware trigger External TTL trigger Example on how to set up the board for positive TTL trigger Edge triggersTrigger modes and appendant registers Positive TTL trigger Pulsewidth triggers Positive and negative TTL triggerTTL pulsewidth trigger for long High pulses TTL pulsewidth trigger for short High pulses TTL pulsewidth trigger for long LOW pulses TTL pulsewidth trigger for short LOW pulsesSpctriggermode Tmttlhighlp Spcpulsewidth Channel Trigger Overview of the channel trigger registersSpctriggermode Tmchannel Tmchxoff Triggerlevel Spctriggermode TmchorSPCTRIGGERMODE0 Tmchxoff SPCTRIGGERMODE2 Tmchxoff Reading out the number of possible trigger levels SPCTRIGGERMODE0 TmchxposSPCHIGHLEVEL0 Input ranges Triggerlevel ±50 mV ±100 mV ±200 mV ±500 mV Detailed description of the channel trigger modes Channel trigger on positive edgeChannel trigger on negative edge Channel trigger on positive and negative edge Channel pulsewidth trigger for long positive pulses Channel pulsewidth trigger for long negative pulses Channel pulsewidth trigger for short negative pulses Channel pulsewidth trigger for short positive pulsesTmchxposgsp Channel steepness trigger for flat positive pulses Channel steepness trigger for flat negative pulses Channel steepness trigger for steep positive pulses Channel steepness trigger for steep negative pulses Channel window trigger for entering signals Channel window trigger for leaving signals Channel window trigger for long inner signals Channel window trigger for long outer signals Channel window trigger for short inner signals Channel window trigger for short outer signals Standard Mode When using Multiple Recording pretrigger is not availableOption Multiple Recording Recording modes Resulting start delays Trigger modesOption Multiple RecordingSpcmemsize Spctriggermode General information and trigger delay Option Gated SamplingOption Gated Sampling Spcgate End of gate alignement Alignement samples per channel Number of samples on gate signal Allowed trigger modesOption Gated SamplingTrigger modes External TTL edge trigger Example program Example program Option Gated SamplingChannel trigger Spctriggermode Tmttlpos StartReset mode Option TimestampTimestamp modes Limits RefClock mode optional Functions for accessing the dataTimestamp Status Reading out timestamp data SpcGetData nr, ch, start, len, data Data formatSpctimestampcount Example programs Standard acquisition modeAcquisition with Multiple Recording Option Extra I/O Digital I/OsAnalog Outputs Channel direction Programming example Programming example Option Extra I/O Bit Standard Mode Digital Inputs enabled Option Digital inputsSample format Spcreaddigital Synchronization Option Different synchronization optionsSynchronization with option cascading Synchronization with option starhub Setup order for the different synchronization options Set up the board parametersLet the master calculate it’s clocking Write Data to on-board memory output boards only Example for data writing Define the boards for trigger masterExample of board #2 set as trigger master 4a Define synchronization or trigger Define the board for clock master Example board number 0 is clock masterDefine the remaining boards as clock slaves Arm the boards for synchronization Start all of the trigger master boards Wait for the end of the measurementRead data from the on-board memory acquisition boards only Restarting the board for another synchronized run Example of Fifo buffer allocation 2a Write first data for output boardsSpcsyncmasterfifo Spcsyncslavefifo Additions for synchronizing different boards General information Calculating the clock dividers 20xx 30xx 31xx 40xx 45xx 60xx 61xx 70xx 72xx Setting up the clock divider Board type 3122 312040 MS/s Board type 3025 3131 Resulting delays using different boards or speeds Delay in standard non Fifo modesDelay in Fifo mode Additions for equal boards with different sample rates Error Codes Error CodesError name Value hex Value dec Error description Appendix Extra I/O with external connectorOption -XMF Pin assignment of the multipin connectorOption Digital inputs Pin assignment of the multipin cable