Used interrupt line, Used type of driver | Spectrum Brands MC.31XX

Programming the Board			Initialization


	PCIBIT_STARHUB	2048	Is set on the board, that carrys the starhub piggy-back module. This flag is set in addition to the PCIBIT_SYNC flag
			mentioned above. If on no synchronized board the starhub option is installed, the boards are synchronized with the
			cascading option.
	PCIBIT_XIO	8192	Is set if the Option Extra I/O is installed.

The following example demonstrates how to read out the information about one feature.

SpcGetParam (hDrv,	SPC_PCIFEATURES,	&lFeatures);
if (lFeatures & PCIBIT_DIGITAL)
printf("Option	digital inputs is installed on your board");

Used interrupt line

This register holds the information of the actual used interrupt line for the board. This information is sometimes more easy in geting the interrupt line of one specific board then using the hardware setups of your operating system.

Register	Value	Direction	Description
SPC_PCIINTERRUPT	2300	r	The used interrupt line of the board.

Used type of driver

This register holds the information about the driver that is actually used to access the board. Although most users will use the boards within a Windows system and most Windows users will use the WDM driver, it can be sometimes necessary of knowing the type of driver.

Register		Value	Direction	Description
SPC_GETDRVTYPE		1220	r	Gives information about what type of driver is actually used
	DRVTYP_DOS	0	DOS driver is used
	DRVTYP_LINUX	1	Linux driver is used

	DRVTYP_VXD	2	Windows VXD driver is used (only Windows 95)

	DRVTYP_NTLEGACY	3	Windows NT Legacy driver is used (only Windows NT)
	DRVTYP_WDM	4	Windows WDM driver is used (only Windows 98/ME/2000/XP). This is the most common Windows driver.

Driver version

This register informs Windows users about the actual used driver DLL. This information can also be obtained from the device manager. Please refer to the „Driver Installation“ chapter. Linux users will get the revision of their kernel driver instead, because linux does not use any DLL.

Register	Value	Direction	Description
SPC_GETDRVVERSION	1200	r	Gives information about the driver DLL version

Kernel Driver version

This register informs OS independent about the actual used kernel driver. Windows users can also get this information from the device man- ager. Plese refer to the „Driver Installation“ chapter. Linux users can get the driver version by simply accessing the following register for the kernel driver.

Register	Value	Direction	Description
SPC_GETKERNELVERSION	1210	r	Gives information about the kernel driver version.

(c) Spectrum GmbH

39

Image 39

Spectrum Brands MC.31XX Used interrupt line, Used type of driver, Programming the Board Initialization, Driver version

Contents

English version April 27 MC.31xxPage Software Hardware InstallationSoftware Driver Installation Introduction Standard acquisition modes Fifo ModeProgramming the Board Analog Inputs Option Extra I/O Option Multiple RecordingOption Gated Sampling Option Timestamp Preface IntroductionPreface General Information Different models of the MC.31xx series MC.3110 MC.3120 MC.3130 MC.3111 MC.3121 MC.3131Introduction MC.3112 MC.3122 MC.3132 Introduction Additional options Additional optionsDigital inputs Extra I/O Option -XMF Timestamp Starhub Spectrum type plate Hardware information Block diagram Technical Data Order No Description Dynamic ParametersOrder information IntroductionHardware information Hardware Installation Installing the board in the systemSystem Requirements Installing a board with digital inputs/outputs Installing a board with extra I/O Option -XMFHardware Installation 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 Interrupt SharingInterrupt Sharing Version control InstallationSoftware Driver Installation Windows Windows Driver Update Windows Driver Update Windows XP Software Driver Installation Windows XP Software Driver Installation Windows NT Windows NTAdding boards to the Windows NT driver Overview Linux Automatic load of the driver Installing the deviceNow it is possible to access the board using this device Driver info Software Overview SoftwareSoftware Overview First Test with SBench Borland C++ Builder ++ Driver InterfaceHeader files Microsoft Visual C++ Include Drivers Other Windows C/C++ compilersNational Instruments LabWindows/CVI Driver functions Function SpcSetData Windows Software ++ Driver Interface Using the Driver under LinuxFunction SpcSetParam Function SpcSetParam Examples Delphi Pascal Programming InterfaceType definition Include Driver Software Visual Basic Programming Interface Visual Basic ExamplesVBA 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 Date of production Installed memoryInstalled features and options Hardware version Driver version Used interrupt lineUsed type of driver Programming the Board Initialization Spcpciserialno Powerdown and resetExample program for the board initialization Spcpcimemsize Analog Inputs Analog InputsChannel Selection Important note on channels selection SPCCHROUTE1 Channel reroutingRerouting information for module SPCCHROUTE0 Input ranges Setting up the inputs Register Value Direction Description Offset range Input offset Automatical adjustment of the offset settings Overrange bitInput termination Spcadjsave ADJUSER0 Spcadjautoadj Adjall Pretrigger = memsize posttrigger Standard acquisition modesProgramming Memory, Pre- and Posttrigger Minimum memsize and posttrigger in samples Starting without interrupt classic modeCommand register Maximum posttrigger in MSamples Starting with interrupt driven mode Standard acquisition modes ProgrammingStatus register Data organization Normal modeFast 8 bit mode 201100 Enables the fast 8 bit mode Value ’len’ as a 32 bit integer value Standard modeReading out the data with SpcGetData Value ’start’ as a 32 bit integer value Programming Speed Limitations Fifo ModeGeneral Information Background Fifo Read 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 acquisition modeFifo acquisition example Spcfifostart Sample format Clock generation Internally generated sample rateStandard internal sample rate Clock generation Using plain quartz without PLLMaximum internal sample rate in MS/s normal mode External reference clock Maximum external samplerate in MS/s External clockingDirect external clock Minimum external sample rate External clock with divider CHANNEL0 CHANNEL1 CHANNEL2 CHANNEL3Fifo External TTL trigger Trigger modes and appendant registersGeneral Description Software trigger Positive TTL trigger Example on how to set up the board for positive TTL triggerEdge triggers Trigger modes and appendant registers TTL pulsewidth trigger for short High pulses Pulsewidth triggersPositive and negative TTL trigger TTL pulsewidth trigger for long High pulses Spcpulsewidth TTL pulsewidth trigger for long LOW pulsesTTL pulsewidth trigger for short LOW pulses Spctriggermode Tmttlhighlp Tmchxoff Channel TriggerOverview of the channel trigger registers Spctriggermode Tmchannel SPCTRIGGERMODE2 Tmchxoff TriggerlevelSpctriggermode Tmchor SPCTRIGGERMODE0 Tmchxoff Input ranges Triggerlevel ±50 mV ±100 mV ±200 mV ±500 mV Reading out the number of possible trigger levelsSPCTRIGGERMODE0 Tmchxpos SPCHIGHLEVEL0 Channel trigger on positive and negative edge Detailed description of the channel trigger modesChannel trigger on positive edge Channel trigger on negative edge Channel pulsewidth trigger for long negative pulses Channel pulsewidth trigger for long positive pulses Channel pulsewidth trigger for short positive pulses Channel pulsewidth trigger for short negative pulsesTmchxposgsp Channel steepness trigger for flat negative pulses Channel steepness trigger for flat positive pulses Channel steepness trigger for steep negative pulses Channel steepness trigger for steep positive pulses Channel window trigger for leaving signals Channel window trigger for entering signals Channel window trigger for long outer signals Channel window trigger for long inner signals Channel window trigger for short outer signals Channel window trigger for short inner signals Recording modes Standard ModeWhen using Multiple Recording pretrigger is not available Option Multiple Recording Spctriggermode Resulting start delaysTrigger modesOption Multiple Recording Spcmemsize Spcgate General information and trigger delayOption Gated Sampling Option Gated Sampling Alignement samples per channel End of gate alignement External TTL edge trigger Number of samples on gate signalAllowed trigger modes Option Gated SamplingTrigger modes Spctriggermode Tmttlpos Example programExample program Option Gated Sampling Channel trigger Limits StartReset modeOption Timestamp Timestamp modes Reading out timestamp data RefClock mode optionalFunctions for accessing the data Timestamp Status Data format SpcGetData nr, ch, start, len, dataSpctimestampcount Standard acquisition mode Example programsAcquisition with Multiple Recording Channel direction Option Extra I/ODigital I/Os Analog Outputs Programming example Option Extra I/O Programming example Spcreaddigital Bit Standard Mode Digital Inputs enabledOption Digital inputs Sample format 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 Let the master calculate it’s clocking 4a Define synchronization or trigger Example for data writingDefine the boards for trigger master Example of board #2 set as trigger master Arm the boards for synchronization Define the board for clock masterExample board number 0 is clock master Define the remaining boards as clock slaves Restarting the board for another synchronized run Start all of the trigger master boardsWait for the end of the measurement Read data from the on-board memory acquisition boards only Spcsyncslavefifo Example of Fifo buffer allocation2a Write first data for output boards Spcsyncmasterfifo General information Additions for synchronizing different boards 20xx 30xx 31xx 40xx 45xx 60xx 61xx 70xx 72xx 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 Codes Error name Value hex Value dec Error description Pin assignment of the multipin connector Extra I/O with external connectorOption -XMFOption Digital inputs Pin assignment of the multipin cable