Spectrum PCI.412 User manual

SPECTRUM SYSTEMENTWICKLUNG MICROELECTRONIC GMBH xAHRENSFELDER WEG 13-17 x22927 GROSSHANSDORF xGERMANY
TEL.: [phone] xFAX: [phone] xEMAIL: [e-mail] xINTERNET: http://www.spec.de
31.03.2004
PCI.412
10/40 MHz 4 channel
12 bit transient recorder
for PCI bus
Hardware Manual
Driver Manual

© Spectrum Systementwicklung Microelectronic GmbH - 2004
Ahrensfelder Weg 13-17, 22927 Grosshansdorf, Germany
SBench is a registered trademark of Spectrum Systementwicklung Microelectronic GmbH.
MS-DOS, Windows and Windows NT are trademarks or registered trademarks of Microsoft Corporation.
LabVIEW is a trademark of National Instruments Corporation.
MATLAB is a registered trademark of The MathWorks Inc.
Agilent VEE is a trademark of Agilent.
FlexPro is a registered trademark of Weisang & Co.
DASYLab is a registered trademark of DATALOG GmbH.
Spectrum reserves the right to make improvements and/or changes to the products and/or programs at any time in order to improve
design and to supply the best product possible.

PCI.412 manual 31.03.2004
Page 3of 26
Table of Contents
Table of Contents ................................................................................................................................................. 3
Preface ................................................................................................................................................................5
Product Introduction............................................................................................................................................. 6
General Information..........................................................................................................................................................6
Software .........................................................................................................................................................................6
Additional information ......................................................................................................................................................6
Order information ............................................................................................................................................................6
Installation .......................................................................................................................................................... 7
System Requirements ............................................................................................................................................................7
Hardware Installation ...........................................................................................................................................................7
Driver Installation.................................................................................................................................................................7
DOS ..................................................................................................................................................................................8
Win 98/ME/2000/XP (WDM)..............................................................................................................................................8
Windows 95 (VXD)..............................................................................................................................................................8
Windows NT (Legacy) ..........................................................................................................................................................9
Windows NT...................................................................................................................................................................9
Installation for Linux............................................................................................................................................................10
Login............................................................................................................................................................................10
Select the right driver ......................................................................................................................................................10
Load Driver ...................................................................................................................................................................10
Major Number...............................................................................................................................................................10
Installing the Device........................................................................................................................................................10
End ..............................................................................................................................................................................10
Info ..............................................................................................................................................................................11
Utilities.............................................................................................................................................................................11
SBench 5.x....................................................................................................................................................................11
DRVCONFG.EXE ...........................................................................................................................................................11
PCITEST.EXE ..................................................................................................................................................................11
Hardware Description........................................................................................................................................ 12
Trigger Information.............................................................................................................................................................12
Option Synchronisation ......................................................................................................................................................12
Block diagram PCI.412 ......................................................................................................................................................13
Technical data...................................................................................................................................................................13
Placement PCI.412.............................................................................................................................................................14
Connectors....................................................................................................................................................................14
AC/DC jumper ..............................................................................................................................................................15
50 Ohm jumper .............................................................................................................................................................15
Digital inputs PCI.412.....................................................................................................................................................15
Sync Bus .......................................................................................................................................................................15
Software Description.......................................................................................................................................... 16
General Information ...........................................................................................................................................................16
Header files on CD ............................................................................................................................................................16
DLLTYP.H.......................................................................................................................................................................16
SPECTRUM.H ................................................................................................................................................................16
REGS.H ........................................................................................................................................................................16
ERRORS.H.....................................................................................................................................................................16
Driver functions..................................................................................................................................................................16
int16 SpcInitPCIBoards (int16* count, int16* PCIVersion).....................................................................................................17
int16 SpcInitBoard (int16 nr, int16 typ)..............................................................................................................................17
int16 SpcSetParam (int16 nr, int32 reg, int32 value) ...........................................................................................................17
int16 SpcGetParam (int16 nr, int32 reg, int32* value).........................................................................................................17
int16 SpcSetData (int16 nr, int16 ch, int32 start, int32 len, dataptr data) ...............................................................................17
int16 SpcGetData (int16 nr, int16 ch, int32 start, int32 len, dataptr data) ..............................................................................18
Error Codes...................................................................................................................................................................18
Valid Board Types..........................................................................................................................................................18
Hints for programming the boards.....................................................................................................................................19
Software - Register .............................................................................................................................................................19
PCI register....................................................................................................................................................................19
PCI Features register .......................................................................................................................................................19
Error registers ................................................................................................................................................................19
Status register ................................................................................................................................................................20
Command register..........................................................................................................................................................20

PCI.412 manual 31.03.2004
Page 4of 26
Synchronisation (Option) .................................................................................................................................................20
Memory register.............................................................................................................................................................21
Posttrigger register..........................................................................................................................................................21
Features register.............................................................................................................................................................21
Input range register.........................................................................................................................................................21
Triggermode register.......................................................................................................................................................22
Triggerlevel register ........................................................................................................................................................23
Multiple Recording (Option).............................................................................................................................................23
Samplerate register.........................................................................................................................................................24
Data format...................................................................................................................................................................24
Example of Driver use.........................................................................................................................................................25
Transfer speed...................................................................................................................................................................26

PCI.412 manual 31.03.2004
Page 5of 26
Vorwort
Diese Anleitung enthält detailierte Informationen über die
Hardware Möglichkeiten der PCI.412 von Spectrum
Systementwicklung. Diese Informationen enthalten die
technischen Daten, die Spezifikationen, die Beschreibung der
Schnittstellen.
Außerdem führt diese Beschreibung durch den
Installationsprozess sowohl der Karte als auch der Treiber für
das jeweilige Betriebssystem.
Zuletzt enthält dieses Handbuch die komplette Software
Beschreibung der Karte und des zugehörigen Treibers. Der Leser
wird in die Lage versetzt diese Karte in einem beliebigen PC
System unter einem der unterstützten Betrienbssysteme
einzusetzen.
Achtung, in diesem Handbuch ist keine Beschreibung der
speziellen Treiber für die Produkte von Drittherstellern wie
LabVIEW oder MatLab enthalten. Diese Treiber sind nicht im
normalen Lieferumfang enthalten.
Neuerungen der Karte, zusätzliche Optionen oder Speicher-
aufrüstungen werden auf der Homepage http://www.spec.de
bekannt gegeben. Hier kann ebenfalls die neueste Treiberverison
mit den letzten Fehlerbereinigungen gefunden werden.
Preface
This manual provides detailed information on the hardware
features of the PCI.412 from Spectrum Systementwicklung. This
information includes specifications, block diagram, connector
description.
In addition, this guide takes you through the process of installing
your board and also describes the installation of the delivered
driver package for each operating system.
Finally this manual provides you with the complete software
information of the board and the related driver. The reader of
this manual is able to integrate the board in any PC system with
one of the supported operating systems.
Please note that in this manual there is no description for specific
driver parts like LabVIEW or MatLab software that are not
normally enclosed in the hardware.
For any new information on the board as well as new available
options or memory upgrades please contact our website
http://www.spec.de. You will also find the actual driver
package with the latest bug fixes on our site.
Spectrum reserves the right to make changes at any time in order to improve design and to supply the best
product possible.

PCI.412 manual 31.03.2004
Page 6of 26
Product Introduction
Allgemeine Information
Der Transientenrekorder PCI.412 ist ein schneller, hochauflö-
sender A/D Wandler für den PCI Bus. Seine 4 ADCs ermögli-
chen die simultane Erfassung mehrerer Signale ohne die Nach-
teile gemultiplexter Systeme. Außerdem stehen noch 16 Bit
Digitaleingänge zur Verfügung, die mit dem gleichen Takt
aufgezeichnet werden.
Jeder Kanal besitzt eine eigene Triggerlogik, die mit denen der
anderen Kanäle verknüpft werden kann. Die verschiedenen
Betriebsarten wie Speichersegmentierung, interner/externer Takt
und Trigger, sowie Pre/Posttrigger ermöglichen dem Anwender
eine einfache Anpassung an sein spezielles Meßproblem.
Mit einem speziellen Takt / Trigger Bus lassen sich mehrere
Karten zu einem vielkanaligen System ausbauen.
Anwendungsbeispiele: Radar, Ultraschall, LDA/PDA,
Qualitätssicherung, Spektroskopie
General Information
The PCI.412 transient recorder is a fast high resolution
A/D-Converter for PCI based systems. Its 4 independent ADCs
enable the simultaneously sampling of signals without the
problems of multiplexed systems. Additionally 16 bits of digital
inputs are available. These inputs are sampled with the same
clock as the analogue inputs.
Each channel has its own triggerlogic, which can be linked
together. The different modes, e.g. memory segmentation,
internal/external clock and trigger as well as the pre- and
posttrigger capability makes it easy to adapt this recorder to the
measuring problem.
By using a special clock- and trigger bus the user may upgrade
the PCI.412 to a measuring system with high channel count.
Application: Radar, Supersonics, LDA/PDA, Quality
managment, Spectroscopie
Software
Kostenlos mitgeliefert werden Treiber für Linux, DOS und
Windows 9x/ME/NT/2000/XP. Für die einfache Program-
mierung sind Beispiele in C/C++, Delphi und Visual Basic
enthalten. Darüber hinaus steht zur komfortablen Steuerung die
Signalverarbeitungssoftware SBench 5.2 kostenlos zur Ver-
fügung. Außerdem sind Treiber für LabVIEW, DASYLab,
MATLAB und VEE erhältlich.
Software
Drivers for Linux, DOS and Windows 9x/ME/NT/2000/XP as
well as programming examples for C/C++, Delphi and Visual
Basic are delivered with the board. Comfortable programming,
initialising and data display are performed by the free-of-charge
Windows program SBench 5.2. Software drivers for LabVIEW,
DASYLab, MATLAB and VEE are available.
Additional information
To minimise noise keep the PCI.412 away from the power supply-
The PCI.412 operates with components having very high power consumption. Therefore it is highly recommended to place the board near
the cooling fan. Do not use the PCI.412 in hermetic closed systems.
Order information
PCI.412 40 MHz PCI.412 with 512 kSamples memory, 40 MHz, including drivers PCI412-40
PCI.412 10 MHz PCI.412 with 512 kSamples memory, 10 MHz, including drivers PCI412-10
Option 2 M Memory upgrading to 2 MSamples PCI412-2
Multiple recording Memory segmentation for fast repetition rates PCI412-mr
Gate Gated sampling with an external control signal PCI412-gs
Cascading Synchronisation of several PCI.412 for multi-channel-systems PCI412-ks
Input range 3 user specific input ranges between r500 mV and r2.5 V bipolar or unipolar PCI412-ir
SBench 5.0 Signal processing software for Win 95/98, Win 2000, Win NT SBENCH5
DASYLab driver Drivers for DASYLab 5.0 for Win 95/98, Win 2000 and Win NT PCI412-dl
HP-VEE driver Drivers for HP-VEE 5.0 for Win 95/98, Win 2000 and Win NT PCI412-hp
LabVIEW driver Drivers for LabVIEW 4.0 for Win 3.11, Win 95/98, Win 2000 and Win NT PCI412-lv
MatLab driver Drivers for MatLab 5.0 for Win 95/98, Win 2000 and Win NT MATLAB

PCI.412 manual 31.03.2004
Page 7of 26
Installation
System Anforderungen
PCI basierter IBM kompatibler PC mit mindestens einem freien
PCI Steckplatz in voller Länge. Der PCI-Bus muß mindestens der
Revision 2.1. genügen. Die Karte arbeitet nicht in einem PCI-Bus
Revision 2.0 oder früher. Wenn mehr als eine Karte im System
installiert werden soll, so empfehlen wir einen zusätzlichen Lüfter
für die Karten einzusetzen.
System Requirements
PCI based IBM PC compatible PC with at least one free full-
length PCI slot. The PCI bus version must be at least revision 2.1.
The boards will not work with older PCI busses of revision 2.0. If
you are installing more than one board in your PC, an additional
cooling fan is strongly recommended.
Hardware Installation
(1) Schalten Sie den PC aus.
(2) Öffnen Sie das Gehäuse.
(3) Wählen Sie einen freien PCI Steckplatz der benötigten
Länge aus. Wenn in Ihrem System kein zusätzlicher Lüfter
installiert ist, so ist die beste Wahl ein Steckplatz, in dem
die Karte nicht direkt neben einer anderen Karte plaziert
ist. Wenn Ihr System einen oder mehrere zusätzliche Lüfter
besitzt, so plazieren Sie die Karte direkt in deren Luftstrom.
(4) Installieren Sie die Karte in dem ausgewählten Steckplatz.
Achten Sie dabei besonders auf den korrekten Sitz des PCI
Steckers im Steckplatz.
(5) Schrauben Sie die Karte an der Frontblende am Gehäuse
fest.
(6) Wenn Sie eine PCI Karte in voller Baulänge erstanden
haben, so liegt Ihrer Karte ein Kartenhalter bei (bei Karten
mit SMB Steckern ist dieser bereits montiert). Es wird
empfohlen diesen Kartenhalter zu installieren, um die Karte
fest im System zu fixieren. Wenn Sie eine Karte mit 9 mm
BNC Steckern haben, so ist nur die nachträgliche Montage
des Bügels an der bereits installierten Karte mit einem
kurzen Schraubendreher möglich.
(7) Starten Sie das System.
(8) Wenn Ihr System nicht bootet, überprüfen Sie bitte den
korrekten Sitz der Karte in ihrem Steckplatz. Starten Sie
danach das System neu.
(9) Wenn Ihr System immer noch nicht bootet kann es jetzt ein
Problem in der Zusammenarbeit mit anderen PCI Karten
geben. Deinstallieren Sie bitte alle anderen PCI Karten bis
auf die Grafikkarte und versuchen Sie das System in dieser
Konfiguration zu starten. Wenn diese Maßnahme zum
Erfolg führt, so muß vermutlich die Reihenfolge der PCI
Karten in Ihrem System geändert werden.
Hardware Installation
(1) Power off your PC.
(2) Open the cover.
(3) Select a free PCI slot of the required length. If you are using
a system with no additional cooling fans, it is the best
decision to put the board in a slot not adjacent to any other
board. If you have a system with additional cooling fans,
place the PCI board in front of a cooling fan.
(4) Install the board in this slot. Make sure that the PCI
connector is right struck into the slot.
(5) Use a screw to fix the bracket to the PC.
(6) If your board has full PCI length a retainer is delivered with
the board (on boards with SMB connectors this retainer is
already installed). It is recommended to use this retainer to
fix the board in the system. If you have a board with 9 mm
BNC connectors, it is not possible to install the retainer
before inserting the board in the system. You need to install
the retainer with a short screwdriver to the already installed
board.
(7) Reboot the system.
(8) If your system will not boot, please check whether the
board is struck correctly into the PCI connector and reboot
again.
(9) If your system will not boot after this, there may be a
problem with other PCI boards. Please de-install all other
PCI boards and try to boot the system without them. If this
works, you may have to change the order of the PCI boards
in the system.
Treiber Installation
Spectrum liefert einen Kartentreiber aus, der alle Karten
unterstützt. Dieser Treiber hat auf allen Betriebssystemen ein
einheitliches Interface. Mit Vorstellung der Treiberversion 3.00,
die jetzt einen WDM kompatiblen Treiber enthält, mußte eine
Unterteilung in PCI und ISA Karten gemacht werden. Bitte
wählen Sie den passenden Treiber anhand der Tabelle aus.
Wenn Sie ISA und PCI Karten von Spectrum gemischt in einem
System benutzen, so nutzen Sie bitte den ISA Treiber.
Driver Installation
Spectrum supplies one driver that supports all boards with an
unique interface for all operating systems. With introduction of
the new version 3.00 which includes a WDM style driver there
has been a separation made between PCI and ISA boards.
Please use the matching driver that is listed in the table. If you
mix ISA and PCI boards from Spectrum in your system you need
to use the ISA driver.
Operating System PCI boards only PCI and ISA mixed ISA boards only
Windows XP WDM driver (Windows 98/ME/2000/XP) Legacy driver (Windows NT) Legacy driver (Windows NT)
Windows 2000 WDM driver (Windows 98/ME/2000/XP) Legacy driver (Windows NT) Legacy driver (Windows NT)
Windows ME WDM driver (Windows 98/ME/2000/XP) VXD driver (Windows 95) VXD driver (Windows 95)
Windows 98 WDM driver (Windows 98/ME/2000/XP) VXD driver (Windows 95) VXD driver (Windows 95)
Windows NT Legacy driver (Windows NT) Legacy driver (Windows NT) Legacy driver (Windows NT)
Windows 95 VXD driver (Windows 95) VXD driver (Windows 95) VXD driver (Windows 95)

PCI.412 manual 31.03.2004
Page 8of 26
DOS OBJ files (DOS driver) OBJ files (DOS driver) OBJ files (DOS driver)
Linux Linux Kernel Module Linux Kernel Module Linux Kernel Module
DOS
Der Treiber für DOS besteht aus einem Satz Objektdateien zum
Linken in ein DOS Programm. Die Treiber Dateien können auf
der CD im Verzeichnis \DRIVER\DOS auf der Diskette gefunden
werden. Beispiele zur Nutzung von Borland C++ 3.1 sind
ebenfalls vorhanden. Zur Benutzung der Treiber müssen nur die
Objekt Dateien *.OBJ und die Header Dateien *.H ins
Arbeitsverzeichnis kopiert werden.
Wenn die Beispielprogramme bei der Arbeit mit DOS nicht
laufen, so kann es hier zu einem Problem mit den im System
installierten Software Treibern gekommen sein. Starten Sie das
System erneut ohne irgendwelche installierten Treiber. Wenn das
Programm so läuft, fügen Sie Schritt für Schritt Ihre Treiber
wieder in das System ein, um den problematischen Treiber
herauszufinden.
Auf einigen Motherboards kann es zu Problemen mit älteren
Versionen der Datei EMM386.EXE kommen. Die Version 6.22
läuft hier korrekt. Es kann daher nötig sein, diese Datei gegen
eine neuere Version auszutauschen.
DOS
The driver consists of a set of object files ready to link to a DOS
program. The driver files are found on CD in the directory
\DRIVER\DOS on the driver disk. Examples for the use with
Borland C++ 3.1 are included. To use the driver files, just copy
the object *.OBJ and header *.H files to your working directory.
If the example files are not working when using DOS operating
system, there may be problems with the installed software
drivers. Start the system once again without any software drivers
installed. After this install the drivers step by step to find out the
problematic software driver. On some motherboards, there may
be problems when using older versions of EMM386.EXE. The
version 6.22 works correctly. It may be necessary to update this
driver to a higher version.
Win 98/ME/2000/XP (WDM)
Wenn das Betriebssystem Windows 98, Windows ME,
Windows 2000 oder Windows XP installiert ist, wird die PCI
Karte nach dem nächsten Start automatisch erkannt. Das System
bietet die direkte Installation eines Treibers für die Karte an.
Wählen Sie hier als Installationsquelle die mitgelieferte CD. Die
Treiberdateien befinden sich im Verzeichnis
\Driver\Win98_2k_XP. Die Treiber stehen sofort nach der
Installation ohne Neustart des Systems zur Verfügung.
Die Treiber bestehen aus einer 32 Bit DLL, die alle Funktionen
des Treibers enthält, und einem WDM-Kernel-Treiber (SYS). Die
DLL kann mit allen Systemen benutzt werden, die eine
Schnittstelle zu 32 Bit Windows DLLs anbieten. Beispiele für
Microsoft Visual C++, Borland Delphi und Microsoft Visual Basic
sind ebenfalls enthalten.
Falls Sie Visual C++ benutzen, so ist es möglich, die Library
Datei SPECTRUM.LIB mit in ein Projekt zu integrieren, um die
Funktionen des Treibers auf einfache Weise in das Programm
einzubinden. Die Library Datei arbeitet nicht mit Borland
Compilern zusammen.
Die beiden DLLs unterscheiden sich nur im Aufruf der
Funktionen. Die Datei SPECTRUM.DLL exportiert die Funktionen
als _cdecl (für C, C++, Delphi), die Datei SPCSTD95.DLL als
_stdcall (für Visual Basic). Je nach benutztem Compiler kann eine
der beiden DLLs benutzt werden.
Win 98/ME/2000/XP (WDM)
When the operating system Windows 98, Windows ME,
Windows 2000 or Windows XP is installed, the PCI board will
be automatically recognised after the rebooting. The system will
ask for a driver to be installed. Select the install directory from
the Spectrum driver CD. The driver files are placed in the
directory \Driver\Win98_2k_XP. The driver is ready to use
directly after installing, no reboot is necessary.
The driver consists of a 32 bit windows DLL which includes all
functions of the driver and a WDM kernel driver (SYS). The DLL
can be used with all systems which accept 32 bit windows DLLs.
Examples for Microsoft Visual C++ 4.x, Borland Delphi and
Microsoft Visual Basic are included.
If you are using Microsoft Visual C++, you may use the delivered
library file SPECTRUM.LIB to access the driver functions easily.
The library file will not work with Borland compilers.
The only difference between the both DLLs is the calling
convention. The file SPECTRUM.DLL uses _cdecl definition (for C,
C++, Delphi), the file SPCSTD95.DLL uses _stdcall definition (for
Visual Basic). Depending on the used programming language,
one of the two DLLs may be used.
Windows 95 (VXD)
Die Treiber für Windows 95 bestehen aus einer 32 Bit DLL, die
alle Funktionen des Treibers enthält, und einem Virtual Device
Driver (VXD). Die DLL kann mit allen Systemen benutzt werden,
die eine Schnittstelle zu 32 Bit Windows DLLs anbieten. Beispiele
für Microsoft Visual C++, für Borland Delphi und für Visual Basic
sind ebenfalls enthalten.
Zur Installation des Treibers benutzen Sie bitte die auf der CD
enthaltene Installationsversion im Verzeichnis /Install/Win95Drv.
Hiermit werden alle Treiberdateien in die vorgesehenen
Verzeichnisse installiert.
Falls Sie Visual C++ benutzen, so ist es möglich, die Library
Datei SPECTRUM.LIB mit in ein Projekt zu integrieren, um die
Funktionen des Treibers auf einfache Weise in das Programm
Windows 95 (VXD)
The driver consists of a 32 bit windows DLL which includes all
functions of the driver and a virtual device driver (VXD). The DLL
can be used with all systems which accept 32 bit windows DLLs.
Examples for Microsoft Visual C++ 4.x, Borland Delphi and
Microsoft Visual Basic are included.
You need to use the install program for driver installtion. The
program is located on CD in the directory /Install/Win95Drv.
The program installs all driver files in the correct directory.
If you are using Microsoft Visual C++, you may use the delivered
library file SPECTRUM.LIB to access the driver functions easily.
The library file will not work with Borland compilers.
The only difference between the both DLLs is the calling
convention. The file SPECTRUM.DLL uses _cdecl definition (for C,

PCI.412 manual 31.03.2004
Page 9of 26
einzubinden. Die Library Datei arbeitet nicht mit Borland
Compilern zusammen.
Die beiden DLLs unterscheiden sich nur im Aufruf der
Funktionen. Die Datei SPECTRUM.DLL exportiert die Funktionen
als _cdecl (für C, C++, Delphi), die Datei SPCSTD95.DLL als
_stdcall (für Visual Basic). Je nach benutztem Compiler kann eine
der beiden DLLs benutzt werden.
C++, Delphi), the file SPCSTD95.DLL uses _stdcall definition (for
Visual Basic). Depending on the used programming language,
one of the two DLLs may be used.
Windows NT (Legacy)
Der Treiber besteht aus einem Kernel Mode Treiber für Windows
NT und einer 32 Bit DLL, die die Funktionen des Kernel Mode
Treibers benutzt. Beispiele für Microsoft Visual C++, Borland
Delphi und Microsoft Visual C++ werden ebenfalls mitgeliefert.
Windows NT (Legacy)
The driver consists of a kernel mode driver for Windows NT and
a 32 bit windows DLL which uses the functions of the kernel
mode driver. Examples for Microsoft Visual C++, Borland Delphi
and Microsoft Visual Basic are included.
Windows NT
(1) Loggen Sie sich als ADMINISTRATOR oder als ein Benutzer
mit dem Recht Treiber zu installieren und die Registry zu
ändern in Ihr System ein.
(2) Starten Sie das Setup Programm auf der Treiber CD. Sie
finden das Installationsprogramm im Verzeichnis
\Install\WinNTDrv.
(3) Das Installationsprogramm installiert den Kernel Mode
Treiber und die 32 Bit Windows DLL, sowie einige
Hilfsprogramme im Verzeichnis Spectrum GmbH. Die
Registry wird ebenfalls angepaßt.
(4) Starten Sie den Computer neu.
(5) Die PCI Karten werden automatisch vom Kernel erkannt und
eingetragen.
(6) Falls der Geräte Treiber nicht korrekt startet (Eine Nachricht
im Event Log von der Datei SPCDRV.SYS), ist der Treiber
nicht korrekt konfiguriert. Bitte überprüfen Sie, ob mit dem
Programm DRVCONFG.EXE, ob die Standard Karte PCI
Board eingetragen ist.
Windows NT
(1) Login as ADMINISTRATOR or with another account having
the right to install drivers and to change the registry.
(2) Start the setup program on the driver CD. The installation
program is found in the directory \Install\WinNTDrv.
(3) The installation routine will install the kernel mode driver,
the 32 bit windows DLL and some utilities in the program
folder Spectrum GmbH. It will also update the registry.
(4) Restart the computer
(5) The PCI boards are automatically detected by the kernel
driver.
(6) If the service does not start correct (A message in the event
log from the service SpcDrv.SYS), the driver is not setup
correctly. Please run DRVCONFG.EXE and check weather
the standard board is correctly set to PCI Board
Falls Sie Visual C++ benutzen, so ist es möglich, die Library
Datei SPECTRUM.LIB mit in ein Projekt zu integrieren, um die
Funktionen des Treibers auf einfache Weise in das Programm
einzubinden. Die Library Datei arbeitet nicht mit Borland
Compilern zusammen.
Es werden die beiden DLLs SPECTRUM.DLL und SPCSTDNT.DLL
installiert. Die beiden DLLs unterscheiden sich nur im Aufruf der
Funktionen. Die Datei SPECTRUM.DLL exportiert die Funktionen
als _cdecl (für C, C++, Delphi), die Datei SPCSTDNT.DLL als
_stdcall (für Visual Basic). Je nach benutztem Compiler kann eine
der beiden DLLs benutzt werden.
If you are using Microsoft Visual C++, you may use the delivered
library file SPECTRUM.LIB to access the driver functions easily.
The library file will not work with Borland compilers.
The both DLLs SPECTRUM.DLL and SPCSTDNT.DLL are installed.
The only difference between the both DLLs is the calling
convention. The file SPECTRUM.DLL uses _cdecl definition (for C,
C++, Delphi), the file SPCSTD95.DLL uses _stdcall definition (for
Visual Basic). Depending on the used programming language,
one of the two DLLs may be used.

PCI.412 manual 31.03.2004
Page 10 of 26
Installation für Linux
Der Treiber besteht aus einem ladbaren Kernel Modul für alle
Karten. Beispiele für Gnu C werden ebenfalls mitgeliefert.
Installation for Linux
The driver consists of a loadable kernel module for all boards.
Examples for Gnu C are also delivered.
Login
Loggen Sie sich als root ein oder als Benutzer mit dem Recht
Module zu laden und Devices anzulegen.
Auswahl des richtigen Treibers
Die Verwendung von Linux-Kernel-Modulen hängt stark von der
Kernelversion sowie der verwendeten Distribution ab. Diesem
Umstand Rechnung tragend werden die Spectrum Treiber in
verschiedenen Versionen ausgeliefert. Bitte wählen Sie das am
besten passende Archiv für Ihre Installation aus.
Treiber laden
Der Linux Treiber wird als ladbares Kernel Modul spc.o
ausgeliefert. Der Treiber enthält alle Spectrum PCI, CompactPCI
und ISA Karten. Die PCI und CompactPCI Karten werden
automatisch erkannt.
Laden Sie das Modul mit insmod f spc.o.
Der insmod Befehl kann die Warnung generieren, daß das
Kernel Modul für eine andere Kernel Version kompiliert wurde.
Dies Meldung können Sie ignorieren.
Wenn das Kernel-Modul nicht in Ihrere Linux Installation geladen
werden kann, so ist es notwendig den Treiber auf Ihrem System
neu zu kompilieren. Bitte setzen Sie sich mit Spectrum in
Verbindung, um die benötigten Sourcedateien zu bekommen.
Major Number
Für den Zugriff auf den Treiber benötigen Sie die zugeteilte
Major number. Sie finden diese Zahl in /proc/devices. Der
Treiber trägt den Namen spec. Normalerweise ist diese
Nummer 254, kann aber auch je nach vorher installierten
Treibern davon abweichen.
Device anlegen
Als letzten Schritt muß ein Device mit dem Treiber verknüpft
werden. Dieses geschieht über den Befehl mknod. Als Major
number wird die in /proc/devices gefunden Zahl eingetragen.
Als Minor Number der Index der Karte die angesprochen wird.
Die Indexzählung beginnt bei 0.
mknod /dev/spc0 c 254 0 für die erste Karte
mknod /dev/spc1 c 254 1 für die zweite Karte
Stellen Sie sicher, daß alle Benutzer, die mit dem Treiber
arbeiten müssen Schreibrechte für das neu angelegte Device
haben. Dafür können Sie allen Personen Schreibrechte für das
Device erteilen: chmod a+w /dev/spc0.
Ende
Die Karte kann jetzt über das angelegte Device angesprochen
werden. Das genaue Vorgehen kann aus den Beispielen
entnommen werden.
Nach einem Neustart von Linux ist es nur nötig das Treiber
Modul zu laden. Das Device muß nur geändert werden, falls die
Major Number nicht mehr stimmt.
Login
Login as root or login as a user who has the right to load
modules and to install devices.
Select the right driver
Linux kernel modules are heavily depending on the kernel
version and distribution. Therefore the kernel driver for the
Spectrum boards is shipped in different versions. Please select
the archieve that is best matching your installed version.
Load Driver
The linux driver is shipped as the loadable kernel module spc.o.
The driver includes all Spectrum PCI, CompactPCI and ISA
boards. All PCI and CompactPCI boards are recognised
automatically.
Load the module with insmod f spc.o
The insmod command could generate a warning that the driver
module was compiled for an other kernel version. You could
ignore this warning.
It is not possible to use the driver module with linux versions prior
to kernel version 2.0.
If the kernel module could not be loaded in your linux installation
it is necessary to compile the driver directly on your system.
Please contact Spectrum to get the needed source files.
Major Number
For accessing the device driver it is necessary to know the major
number of the driver. This number is listed in /proc/devices. The
device driver is called spec in this list. Normally this number is
254 but this depends on the already installed device drivers.
Installing the Device
You connect a device to the driver with the mknod command.
The major number is the number found in /proc/devices. The
minor number is the index of the board starting with 0.
mknod /dev/spc0 c 254 0 for the first board
mknod /dev/spc1 c 254 1 for the second board
Make sure that the users that should work with the driver has
write rights to access the device. Therefore you should give all
persons all rights to the device: chmod a+w /dev/spc0
End
The board could now be accessed using the device. See the
example files for more information.
After restarting linux it is only necessary to load the driver again.
The device must only be changed if the major number has
changed.