Spectrum Brands MI.61XX Appendix, Error Codes, Error name Value hex Value dec Error description

Page 77

Appendix

Error Codes

 

 

Appendix

Error Codes

The following error codes could occur when a driver function has been called. Please check carefully the allowed setup for the register and change the settings to run the program.

error name

value (hex)

value (dec.)

error description

ERR_OK

0h

0

Execution OK, no error.

ERR_INIT

1h

1

The board number is not in the range of 0 to 15. When initialisation is executed: the board number is yet

 

 

 

initialised, the old definition will be used.

ERR_NR

2h

2

The board is not initialised yet. Use the function SpcInitPCIBoards first. If using ISA boards the function SpcI-

 

 

 

nitBoard must be called first.

ERR_TYP

3h

3

Initialisation only: The type of board is unknown. This is a critical error. Please check whether the board is

 

 

 

correctly plug in the slot and whether you have the latest driver version.

ERR_FNCNOTSUPPORTED

4h

4

This function is not supported by the hardware version.

ERR_BRDREMAP

5h

5

The board index remap table in the registry is wrong. Either delete this table or check it craefully for double

 

 

 

values.

ERR_KERNELVERSION

6h

6

The version of the kernel driver is not matching the version of the DLL. Please do a complete reinstallation of

 

 

 

the hardware driver. This error normally only occurs if someone copies the dll manually to the system direc-

 

 

 

tory.

ERR_HWDRVVERSION

7h

7

The hardware needs a newer driver version to run properly. Please install the driver that was delivered toge-

 

 

 

ther with the board.

ERR_LASTERR

10h

16

Old Error waiting to be read. Please read the full error information before proceeding. The driver is locked

 

 

 

until the error information has been read.

ERR_ABORT

20h

32

Abort of wait function. This return value just tells that the function has been aborted from another thread.

ERR_BOARDLOCKED

30h

48

Access to the driver already locked by another program. Stop the other program before starting this one.

 

 

 

Only one program can access the driver at the time.

ERR_REG

100h

256

The register is not valid for this type of board.

ERR_VALUE

101h

257

The value for this register is not in a valid range. The allowed values and ranges are listed in the board spe-

 

 

 

cific documentation.

ERR_FEATURE

102h

258

Feature (option) is not installed on this board. It’s not possible to access this feature if it’s not installed.

ERR_SEQUENCE

103h

259

Channel sequence is not allowed.

ERR_READABORT

104h

260

Data read is not allowed after aborting the data acquisition.

ERR_NOACCESS

105h

261

Access to this register denied. No access for user allowed.

ERR_POWERDOWN

106h

262

Not allowed if powerdown mode is activated.

ERR_TIMEOUT

107h

263

A timeout occured while waiting for an interrupt. Why this happens depends on the application. Please

 

 

 

check whether the timeout value is programmed too small.

ERR_CHANNEL

110h

272

The channel number may not be accessed on the board: Either it is not a valid channel number or the chan-

 

 

 

nel is not accessible due to the actual setup (e.g. Only channel 0 is accessible in interlace mode)

ERR_RUNNING

120h

288

The board is still running, this function is not available now or this register is not accessible now.

ERR_ADJUST

130h

304

Automatic adjustion has reported an error. Please check the boards inputs.

ERR_NOPCI

200h

512

No PCI BIOS is found on the system.

ERR_PCIVERSION

201h

513

The PCI bus has the wrong version. SPECTRUM PCI boards require PCI revision 2.1 or higher.

ERR_PCINOBOARDS

202h

514

No SPECTRUM PCI boards found. If you have a PCI board in your system please check whether it is cor-

 

 

 

rectly plug into the slot connector and whether you have the latest driver version.

ERR_PCICHECKSUM

203h

515

The checksum of the board information has failed. This could be a critical hardware failure. Restart the

 

 

 

system and check the connection of the board in the slot.

ERR_DMALOCKED

204h

516

DMA buffer not available now.

ERR_MEMALLOC

205h

517

Internal memory allocation failed. Please restart the system and be sure that there is enough free memory.

ERR_FIFOBUFOVERRUN

300h

768

Driver buffer overrun in FIFO mode. The hardware and the driver have been fast enough but the application

 

 

 

software didn’t manage to transfer the buffers in time.

ERR_FIFOHWOVERRUN

301h

769

Hardware buffer overrun in FIFO mode. The hardware transfer and the driver has not been fast enough.

 

 

 

Please check the system for bottlenecks and make sure that the driver thread has enough time to transfer

 

 

 

data.

ERR_FIFOFINISHED

302h

770

FIFO transfer has been finished, programmed number of buffers has been transferred.

ERR_FIFOSETUP

309h

777

FIFO setup not possible, transfer rate to high (max 250 MB/s).

ERR_TIMESTAMP_SYNC

310h

784

Synchronisation to external timestamp reference clock failed. At initialisation is checked wether there is a

 

 

 

clock edge present at the input.

ERR_STARHUB

320h

800

The autorouting function of the star-hub initialisation has failed. Please check whether all cables are mounted

 

 

 

correctly.

(c) Spectrum GmbH

77

Image 77
Contents English version October 5 MI.61xxPage Software Driver Installation Hardware InstallationIntroduction SoftwareProgramming the Board Fifo ModeAnalog Outputs Standard generation modesOption Extra I/O Option Gated ReplaySynchronization Option AppendixPreface IntroductionGeneral Information PrefaceIntroduction Different models of the MI.61xx seriesMI.6110 MI.6111 Extra I/O Option -XIO Additional optionsExtra I/O Option -XMF Introduction Additional options StarhubSpectrum type plate Hardware information Block diagram Technical DataOrder information Dynamic ParametersHardware informationIntroduction FilterSystem Requirements Hardware InstallationInstalling the board in the system Installing a board with extra I/O Option -XMF Installing a board with digital inputs/outputsMounting the wired boards Installing multiple boards synchronized by starhubHooking up the boards Only use the included flat ribbon cablesInstalling multiple synchronized boards Interrupt Sharing Software Driver InstallationSoftware Driver Installation Version control InstallationWindows Driver Update Windows Software Driver Installation Windows Windows XP Windows XP Adding boards to the Windows NT driver Windows NTOverview LinuxNow it is possible to access the board using this device Installing the deviceDriver info Automatic load of the driverSoftware Overview SoftwareFirst Test with SBench SoftwareHeader files ++ Driver InterfaceMicrosoft Visual C++ Linux Gnu CNational Instruments LabWindows/CVI Other Windows C/C++ compilersDriver functions Include DriversFunction SpcSetParam Function SpcSetParamFunction SpcSetData Windows Function SpcGetDataSpectrum GmbH Type definition Delphi Pascal Programming InterfaceInclude Driver ExamplesDelphi Pascal Programming Interface VBA for Excel Examples Visual Basic Programming InterfaceVisual Basic Examples Visual Basic Programming Interface Programming the Board Error handlingOverview Register tablesInitialization Example for error checkingStarting the automatic initialization routine PCI RegisterHardware version Installed memoryDate of production Serial numberUsed interrupt line Installed features and optionsUsed type of driver Driver versionExample program for the board initialization Powerdown and resetSpcpcimemsize SpcpciserialnoChannel Selection Analog OutputsImportant note on channels selection Disabling the outputsOutput Amplifiers Setting up the outputsOutput offset Register Value Direction Description Amplitude rangeOutput Filters Filter SpecificationsMaximum Output Range Programming Standard generation modesGeneral description Maximum memsize Standard generation modes ProgrammingMaximum posttrigger in MSamples Minimum and stepsize of memsize and posttrigger in samplesStarting with interrupt driven mode Starting without interrupt classic modeCommand register ProgrammingStandard generation modesWriting data with SpcSetData Data organizationValue ’start’ as a 32 bit integer value Value ’len’ as a 32 bit integer valueSample format Standard modeBit Standard Mode General Information Fifo ModeBackground Fifo Write Speed LimitationsSoftware Buffers Programming Fifo ModeTheoretical maximum sample rate PCI Bus Throughput 60040 Read out the number of available Fifo buffersBuffer processing Fifo Mode ProgrammingAnalog acquisition or generation boards Digital I/O 701x or 702x or pattern generator boards== Maxbuf Example Fifo generation modeSpcfifostart SpcfifowaitProgramming Standard internal sample rate Clock generationInternally generated sample rate External clocking Using plain quartz with no PLLExternal reference clock Maximum external samplerate in MS/s Direct external clockMinimum external sample rate CHANNEL0 CHANNEL1 CHANNEL2 CHANNEL3 External clock with dividerExample Trigger modes and appendant registers Example for setting up the software triggerSoftware trigger External TTL triggerEdge triggers Example on how to set up the board for positive TTL triggerTrigger modes and appendant registers Positive TTL triggerPositive and negative TTL trigger Option Multiple Replay Standard ModeOutput modes Trigger modesTrigger modes Option Multiple Replay Resulting start delaysOption Gated Replay General information and trigger delayOption Gated Replay Value Direction DescriptionAllowed trigger modes Example programExternal TTL edge trigger Spctriggermode TmttlposDigital I/Os Option Extra I/OChannel direction Transfer DataAnalog Outputs Option Extra I/O Analog OutputsProgramming example Different synchronization options Synchronization OptionSynchronization with option cascading Synchronization with option starhubSet up the board parameters Setup order for the different synchronization optionsExample of board setup for three boards Write Data to on-board memory output boards onlyExample of board #2 set as trigger master Define the boards for trigger master3a Define synchronization or trigger Define the remaining boards as trigger slavesExample board number 0 is clock master Define the board for clock masterDefine the remaining boards as clock slaves Arm the boards for synchronizationWait for the end of the measurement Start all of the trigger master boardsRead data from the on-board memory acquisition boards only Example for data reading2a Write first data for output boards Allocate the Fifo software buffersSpcsyncmasterfifo SpcsyncslavefifoAs trigger slaves General information Additions for synchronizing different boardsCalculating the clock dividers 20xx 30xx 31xx 40xx 45xx 60xx 61xx 70xx 72xxBoard type 3122 3120 Setting up the clock divider40 MS/s Board type 3025 3131Delay in standard non Fifo modes Resulting delays using different boards or speedsDelay in Fifo mode Additions for equal boards with different sample ratesError name Value hex Value dec Error description Error CodesAppendix AppendixPin assignment of the multipin cable Pin assignment of the multipin connectorExtra I/O with external connectorOption -XMF Extra I/O with internal connector Option -XIO Pin assignment of the internal multipin connectorD14 D12 D10 D15 D13 D11