Spectrum PCI.208 Hardware manual

PCI.208
100/200 MHz 8 bit transient recorder
for PCI bus
Hardware Manual
Driver Manual
SPECTRUM SYSTEMENTWICKLUNG MICROELECTRONIC GMBH x AHRENSFELDER WEG 13-17 x 22927 GROSSHANSDORF x GERMANY
TEL.: +49 (0)4102-6956-0 x FAX: +49 (0)4102-6956-66 x EMAIL: [email protected] x INTERNET: http://www.spec.de
31.03.2004
© 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.
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 Gated Sampling ................................ ................................ ................................ ................................ ...................... 12
Option Multiple Recording ................................ ................................ ................................ ................................ .................. 13
Option Synchronisation ................................ ................................ ................................ ................................ ...................... 14
Block diagram PCI.208 ................................ ................................ ................................ ................................ ...................... 15
Block diagram CPCI.208 ................................ ................................ ................................ ................................ .................... 16
Technical data ................................ ................................ ................................ ................................ ................................ ...16
Placement PCI.208 ................................ ................................ ................................ ................................ ............................. 17
Placement CPCI.208 ................................ ................................ ................................ ................................ .......................... 17
Connectors ................................ ................................ ................................ ................................ ................................ .... 18
AC/DC jumper ................................ ................................ ................................ ................................ .............................. 18
Digital inputs PCI.208 ................................ ................................ ................................ ................................ ..................... 18
Digital inputs CPCI.208 ................................ ................................ ................................ ................................ ................... 18
Sync Bus ................................ ................................ ................................ ................................ ................................ ....... 18
Software Description.......................................................................................................................................... 19
General Information ................................ ................................ ................................ ................................ ........................... 19
Header files on CD ................................ ................................ ................................ ................................ ............................ 19
DLLTYP.H................................ ................................ ................................ ................................ ................................ ....... 19
SPECTRUM.H ................................ ................................ ................................ ................................ ................................ 19
REGS.H ................................ ................................ ................................ ................................ ................................ ........ 19
ERRORS.H ................................ ................................ ................................ ................................ ................................ ..... 19
Driver functions ................................ ................................ ................................ ................................ ................................ ..19
int16 SpcInitPCIBoards (int16* count, int16* PCIVersion) ................................ ................................ ................................ ..... 20
int16 SpcInitBoard (int16 nr, int16 typ) ................................ ................................ ................................ .............................. 20
int16 SpcSetParam (int16 nr, int32 reg, int32 value) ................................ ................................ ................................ ........... 20
int16 SpcGetParam (int16 nr, int32 reg, int32* value) ................................ ................................ ................................ ......... 20
int16 SpcSetData (int16 nr, int16 ch, int32 start, int32 len, dataptr data) ................................ ................................ ............... 20
int16 SpcGetData (int16 nr, int16 ch, int32 start, int32 len, dataptr data) ................................ ................................ .............. 21
Error Codes ................................ ................................ ................................ ................................ ................................ ...21
Valid Board Types ................................ ................................ ................................ ................................ .......................... 21
Hints for programming the boards ................................ ................................ ................................ ................................ ..... 22
Software - Register ................................ ................................ ................................ ................................ ............................. 23
PCI register................................ ................................ ................................ ................................ ................................ .... 23
PCI-208 / CPCI.208 manual
31.03.2004
PCI Features register ................................ ................................ ................................ ................................ ....................... 23
Error registers ................................ ................................ ................................ ................................ ................................ 23
Status register ................................ ................................ ................................ ................................ ................................ 23
Command register ................................ ................................ ................................ ................................ .......................... 24
Synchronisation (Option) ................................ ................................ ................................ ................................ ................. 24
Memory register ................................ ................................ ................................ ................................ ............................. 24
Posttrigger register ................................ ................................ ................................ ................................ .......................... 24
Features register ................................ ................................ ................................ ................................ ............................. 25
Additional feature register of CPCI.208 ................................ ................................ ................................ ............................. 25
Triggermode register ................................ ................................ ................................ ................................ ....................... 25
Triggerlevel register ................................ ................................ ................................ ................................ ........................ 25
Samplerate register ................................ ................................ ................................ ................................ ......................... 26
Double Mem (Option) ................................ ................................ ................................ ................................ ..................... 26
Multiple Recording (Option) ................................ ................................ ................................ ................................ ............. 26
Gated Sampling (option) ................................ ................................ ................................ ................................ ................. 27
Input range register................................ ................................ ................................ ................................ ......................... 28
Data (Read) ................................ ................................ ................................ ................................ ................................ ...... 28
Example of Driver use ................................ ................................ ................................ ................................ ......................... 29
Transfer speed ................................ ................................ ................................ ................................ ................................ ...30
Page 4 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Vorwort
Preface
Diese Anleitung enthält detailierte Informationen über die
Hardware Möglichkeiten der PCI.208 und der CPCI.208 von
Spectrum Systementwicklung. Diese Informationen enthalten die
technischen Daten, die Spezifikationen, die Beschreibung der
Schnittstellen.
This manual provides detailed information on the hardware
features of the PCI.208 and the CPCI.208 from Spectrum
Systementwicklung. This information includes specifications,
block diagram, connector description.
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 Speicheraufrüstungen werden auf der Homepage http://www.spec.de
bekannt gegeben. Hier kann ebenfalls die neueste Treiberverison
mit den letzten Fehlerbereinigungen gefunden werden.
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.
Page 5 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Product Introduction
Allgemeine Information
General Information
Anwendungsbeispiele: Radar, Qualitätssicherung,
Spektroskopie, Ultraschall, LDA/PDA
Application examples: Radar, Quality management,
Spectroscopie, Supersonics, LDA/PDA
Software
Software
Mit der PCI.208 ist eine schnelle Karte für den PCI Bus mit zwei
separaten A/D Wandlern verfügbar. Jeder Kanal kann
wahlweise als Analogeingang oder als 8 Bit Digitaleingang
benutzt werden.
Aufgrund des großen Speichers von bis zu 256 MSample (über
1 Sekunde Aufzeichnung bei voller Geschwindigkeit!) ist auch
die Aufzeichnung extrem breitbandiger Signale möglich. Um
mehrere schnell aufeinander folgende Ereignisse auf zuzeichnen,
kann der Speicher optional segmentiert werden (multiple
recording).
Die vielfältigen Synchronisationsmöglichkeiten, wie Trigger- und
Taktein-/ausgang, machen die PCI.208 zu einen universell
einsetzbaren Werkzeug. Mit Hilfe des internen Sync-Busses ist
der Aufbau von Mehrkanalmeßsystemen sowie die Verbindung
mit anderen Spectrum Karten möglich.
Kostenlos mitgeliefert werden Treiber für Linux, DOS und
Windows 9x/ME/NT/2000/XP. Für die einfache Programmierung sind Beispiele in C/C++, Delphi und Visual Basic
enthalten. Darüber hinaus steht zur komfortablen Steuerung die
Signalverarbeitungssoftware SBench 5.2 kostenlos zur Verfügung. Außerdem sind Treiber für LabVIEW, DASY Lab,
MATLAB und VEE erhältlich.
The PCI.208 is a fast board for the PCI bus with two separate
A/D-Converters. Each channel may be switched to analogue or
8 bit digital recording.
Due to the large memory of up to 256 MSamples (more than 1
second recording with full speed) the recording of signals with
extremely wide bandwidth is possible. As an option this large
memory may be segmented (multiple recording) to record several
events with a very small pause between them.
The various synchronisation possibilities like trigger and clock
input and output are forming the PCI.208 to an universal tool.
With the help of the internal sync-bus, it is possible to build up
multichannel-systems as well as to connect Spectrum boards of
different types with each other.
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.208/CPCI.208 away from the power supplyThe PCI.208/CPCI.208 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.208/CPCI.208 in hermetic closed systems.
Order information
PCI.208 standard
Option 32 M
Option 64 M
Option 256 M
Multiple recording
Gate
Cascading
Double mem
Input range
DASYLab driver
Agilent VEE driver
LabVIEW driver
MatLab driver
PCI.208 with 16 MSamples memory including drivers
Memory upgrading to 32 MSamples
Memory upgrading to 64 MSamples
Memory upgrading to 256 MSamples
Memory segmentation for fast repetition rates
Gated sampling with an external control signal
Synchronisation of several PCI.208 for multi-channel-systems
Channel 0 uses memory of both channels for all samplerates
3 user specific input ranges between r200 mV and r3 V, bipolar or unipolar
Drivers for DASYLab 5.0 for Win 95/98, Win 2000 and Win NT
Drivers for Agilent VEE 5.0 for Win 95/98, Win 2000 and Win NT
Drivers for LabVIEW 4.0 for Win 3.11, Win 95/98, Win 2000 and Win NT
Drivers for MatLab 5.0 for Win 95/98, Win 2000 and Win NT
Page 6 of 30
PCI208
PCI208-32
PCI208-64
PCI208-256
PCI208-mr
PCI208-gs
PCI208-ks
PCI208-dm
PCI208-ir
PCI208-dl
PCI208-hp
PCI208-lv
MATLAB
PCI-208 / CPCI.208 manual
31.03.2004
Installation
System Anforderungen
System Requirements
Hardware Installation
Hardware Installation
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.
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
(9)
Schalten Sie den PC aus.
Öffnen Sie das Gehäuse.
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.
Installieren Sie die Karte in dem ausgewählten Steckplatz.
Achten Sie dabei besonders auf den korrekten Sitz des PCI
Steckers im Steckplatz.
Schrauben Sie die Karte an der Frontblende am Gehäuse
fest.
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.
Starten Sie das System.
Wenn Ihr System nicht bootet, überprüfen Sie bitte den
korrekten Sitz der Karte in ihrem Steckplatz. Starten Sie
danach das System neu.
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.
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.
Operating System
Windows
Windows
Windows
Windows
Windows
Windows
XP
2000
ME
98
NT
95
PCI boards only
WDM driver (Windows 98/ME/2000/XP)
WDM driver (Windows 98/ME/2000/XP)
WDM driver (Windows 98/ME/2000/XP)
WDM driver (Windows 98/ME/2000/XP)
Legacy driver (Windows NT)
VXD driver (Windows 95)
PCI based IBM PC compatible PC with at least one free fulllength 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.
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
(9)
Power off your PC.
Open the cover.
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.
Install the board in this slot. Make sure that the PCI
connector is right struck into the slot.
Use a screw to fix the bracket to the PC.
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.
Reboot the system.
If your system will not boot, please check whether the
board is struck correctly into the PCI connector and reboot
again.
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.
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.
PCI and ISA mixed
Legacy driver (Windows NT)
Legacy driver (Windows NT)
VXD driver (Windows 95)
VXD driver (Windows 95)
Legacy driver (Windows NT)
VXD driver (Windows 95)
Page 7 of 30
ISA boards only
Legacy driver (Windows NT)
Legacy driver (Windows NT)
VXD driver (Windows 95)
VXD driver (Windows 95)
Legacy driver (Windows NT)
VXD driver (Windows 95)
PCI-208 / CPCI.208 manual
DOS
Linux
OBJ files (DOS driver)
Linux Kernel Module
31.03.2004
OBJ files (DOS driver)
Linux Kernel Module
OBJ files (DOS driver)
Linux Kernel Module
DOS
DOS
Win 98/ME/2000/XP (WDM)
Win 98/ME/2000/XP (WDM)
Windows 95 (VXD)
Windows 95 (VXD)
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.
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.
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
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.
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.
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,
Page 8 of 30
PCI-208 / CPCI.208 manual
31.03.2004
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)
Windows NT (Legacy)
Windows NT
Windows NT
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.
(1)
(2)
(3)
(4)
(5)
(6)
Loggen Sie sich als ADMINISTRATOR oder als ein Benutzer
mit dem Recht Treiber zu installieren und die Registry zu
ändern in Ihr System ein.
Starten Sie das Setup Programm auf der Treiber CD. Sie
finden
das
Installationsprogramm
im
Verzeichnis
\Install\WinNTDrv.
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.
Starten Sie den Computer neu.
Die PCI Karten werden automatisch vom Kernel erkannt und
eingetragen.
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.
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.
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.
(1)
(2)
(3)
(4)
(5)
(6)
Login as ADMINISTRATOR or with another account having
the right to install drivers and to change the registry.
Start the setup program on the driver CD. The installation
program is found in the directory \Install\WinNTDrv.
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.
Restart the computer
The PCI boards are automatically detected by the kernel
driver.
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”
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.
Page 9 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Installation für Linux
Installation for Linux
Login
Login
Auswahl des richtigen Treibers
Select the right driver
Der Treiber besteht aus einem ladbaren Kernel Modul für alle
Karten. Beispiele für Gnu C werden ebenfalls mitgeliefert.
Loggen Sie sich als root ein oder als Benutzer mit dem Recht
Module zu laden und Devices anzulegen.
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.
The driver consists of a loadable kernel module for all boards.
Examples for Gnu C are also delivered.
Login as root or login as a user who has the right to load
modules and to install devices.
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.
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.
Page 10 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Der Zugriff auf das Linux Device erfolgt mit Read und Write
Befehlen sowie ioctl Befehlen. Eine Umsetzung dieser Befehle in
die Standard Treiber Schnittstelle von Spectrum kann über die
Datei „spcioctl.inc“ realisiert werden. Das genaue Vorgehen ist
aus den Beispielen ersichtlich.
Accessing the linux device is done with read and write
commands and ioctl commands. These commands could be
converted to the standard Spectrum driver interface with the file
“spcioctl.inc”. See the examples for this.
Info
Info
Hilfsprogramme
Utilities
SBench 5.x
SBench 5.x
DRVCONFG.EXE
DRVCONFG.EXE
PCITEST.EXE
PCITEST.EXE
Informationen über die installierte Spectrum Karten können unter
/proc/spectrum abgefragt werden. Für ISA Karten ist hier der
Typ und die Basisadresse sichtbar. Für PCI Karten sind alle
grundlegenden Informationen aus dem onboard EEProm
aufgelistet.
Auf der CD wird eine Vollversion von SBench 5.x mitgeliefert.
Das Programm unterstützt alle aktuellen Erfassungs-, Ausgabeund Digital I/O Karten von Spectrum. Je nach verwendeter Karte
und nach Konfiguration des Programms kann SBench als
Digitales Speicheroszilloskop, als Spectrumanalyser, als
Logikanalyser oder einfach als Datenerfassungssystem benutzt
werden. Verschiedenen Import- und Exportfunktionen erlauben
die einfache Nutzung von SBench mit diversen anderen
Programmen.
Eine Installationsversion ist im Verzeichnis /Install/SBench5 auf
der CD zu finden. Im Verzeichnis /Manuals auf der CD ist eine
kurze Anleitung zur Bedienung von SBench in Deutsch und
Englisch zu finden. Eine aktuelle Version ist jederzeit aus dem
Internet unter www.spec.de zu bekommen.
Automatisch installiert im Ordner ‚Spectrum GmbH‘ bei der
Installation des Windows NT Treibers. Dieses Programm erlaubt
die Änderung der Treiber Konfiguration der Spectrum ISA Karten
unter Windows NT. Für PCI Karten braucht das Programm nicht
benutzt werden. Das Programm ändert die Eintragungen in der
Registry. Die neue Konfiguration wird beim nächsten Start des
Systems benutzt.
Zu finden auf der Treiber CD im Verzeichnis \UTILS. Dieses
Hilfsprogramm sammelt alle verfügbaren Informationen über alle
im System installierten Spectrum PCI Karten. Die Informationen
werden aus dem on-board EEProm ausgelesen und angezeigt.
Das Programm läuft nur unter DOS oder in der DOS-Box von
Windows 3.11 oder Windows 9x/ME. Das Programm läuft
nicht unter Windows NT/2000/XP.
Information about the installed boards could be found in the
/proc/spectrum file. For ISA boards the board type and the
base address are listed. For PCI boards the basic information
from the onboard EEProm is listed.
A full version of SBench 5.x is delivered with the board on CD.
The program supports all actual acquisition, generator and
digital I/O boards from Spectrum. Depending on the used board
and the software setup, one could use SBench as a digital
storage oscilloscope, a spectrum analyser, a logic analyser or
simply as a data recording front end. Different export and import
formats allow the use of SBench together with a variety of other
programs.
An install version of the program is found in the directory
/Install/SBench5 on CD. There is also a short program
description in german and english in the /Manuals directory.
A current version could be downloaded from the internet at
www.spec.de at any time.
Installed in the folder ‚Spectrum GmbH‘ when installing the
Windows NT driver. This utility manages the driver configuration
of the Spectrum ISA boards for Windows NT. The program need
not to be used for PCI boards. The utility changes the registry.
The new configuration will only be used after the next reboot of
the system.
Found on the driver CD in the directory \UTILS. This utility will
collect some information about all installed Spectrum PCI boards.
The information of the onboard EEPROM will be read out and
shown. The utility will only work with DOS, Windows 3.1x,
Windows 9x and Windows ME. It will not work with Windows
NT/2000/XP.
Page 11 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Hardware Description
Trigger Informationen
Trigger Information
Option Gated Sampling
Option Gated Sampling
Nach dem Start der PCI.208/CPCI.208 werden die Eingänge
abgetastet und die konvertierten Daten im Speicher abgelegt
(Der Speicher arbeitet als Ringbuffer, die Daten werden
kontinuierlich in den Speicher geschrieben). Wenn für die
Aufnahme Pretrigger programmiert ist, werden die Triggerereignisse ignoriert bis der programmierte Speicher einmal
komplett mit Daten gefüllt ist. Danach wird die
Triggerverarbeitung freigeschaltet. Dieses Verhalten kann über
die Option SPC_NOPRETRIGGER abgeschaltet werden.
Wenn der Software Trigger ausgewählt wurde, wird sofort ein
Triggerereignis erkannt. Wird der TTL Trigger benutzt, so wird
ein Triggerereignis erkannt, wenn das TTL Signal am Eingang
(Connector 2) von LOW Pegel zu HIGH Pegel wechselt
(steigende Flanke) oder von HIGH Pegel zu LOW Pegel wechselt
(fallende Flanke).
Ist der Kanaltrigger (Kanal 0 oder Kanal 1) selektiert, so werden
die vier höchstwertigen Bits des AD-Wandlers mit dem im
Triggerlevel Register programmierten Wert verglichen. Wird der
Wert vom anliegenden Signal gekreuzt (Von kleiner zu größer
bei steigender Flanke, oder von größer zu kleiner bei fallender
Flanke), wird ein Triggerereigniss erkannt.
Der Status ändert sich zu ‚Trigger found‘ und der Postcounter
fängt an den programmierten Posttrigger Wert herunter zu
zählen. Wenn dieser Wert Null erreicht, stoppt die
PCI.208/CPCI.208 und der Status ändert sich auf ‚Ready‘.
Die Option Gated Sampling erlaubt die Aufnahme/Wieder gabe
eines Signals gesteuert über ein Gatesignal. Es werden nur
Daten
aufgenommen,
wenn
das
Gatesignal
einem
programmierten Pegel (TTL HIGH oder TTL LOW) entspricht.
G H OD \
G H OD \
After the PCI.208/CPCI.208 has been started it samples the
input signals and stores the converted data to the memory. (The
memory operates as a circular buffer, so data are written
continuously to the RAM). If pretrigger is programmed, no
triggerevents are processed until the programmed memory is
filled one time completely with data. Afterwards the trigger
sequencer will be enabled. This functionality may be disabled
with the option SPC_NOPRETRIGGER.
If Software trigger is used a triggerevent is detected immediately.
Using the TTL trigger will cause a triggerevent if the external TTL
input will go from low to high (rising edge) or from high to low
(falling edge).
When the triggermode is set to channel-trigger (channel 0/1) the
4 MSB’s of the ADC are compared to the programmed value in
the trigger-level-register. If the value is crossed by the signal (less
to greater when rising edge, or greater to less when falling
edge) a triggerevent is detected.
The status will be change to ‘trigger found’ and the postcounter
starts counting down the posttrigger value. After the postcounter
reaches zero the PCI.208/CPCI.208 stops and signals ‘ready’
in the status register,
The option Gated Sampling allows recording/replay of a signal
controlled by an gate signal. Data is only recorded if the gate
signal is equal to a programmed level (TTL HIGH or TTL LOW).
G H OD \
G H OD \
* D WH VLJ Q D O
6 LJ Q D O
' D WD LQ P H P R U\
0 H P VL] H N
N
Page 12 of 30
G H OD \
S UR J UD P P H G
P H P VL] H UH D FK H G
PCI-208 / CPCI.208 manual
31.03.2004
Option Multiple Recording
Die Option Multiple Recording erlaubt die Aufnahme/Ausgabe
mehrerer Triggerereignisse, ohne die Hardware dazwischen neu
zu starten. Der Speicher der Karte wird in mehrere gleich große
Segmente unterteilt. Jedes Segment wird bei Auftreten eines
Triggerereignisses mit Daten gefüllt. Im Multiple Recording
Modus ist kein Pretrigger möglich.
G H OD \
Option Multiple Recording
The option Multiple Recording allows the recording/replay of
several trigger events without restarting the hardware. The
memory of the board will be divided into several segments of the
same size. Each segment will be filled with data when a trigger
event occurs. Pretrigger is not available when using Multiple
Recording
G H OD \
G H OD \
7ULJ J H UH YH Q W
6 LJ Q D O
' D WD LQ P H P R U\
N
N
N
6 H J P H Q WVL] H 3 R VWWULJ J H U N
N
0 H P VL] H N
Page 13 of 30
PCI-208 / CPCI.208 manual
Option Synchronisierung
31.03.2004
Diese Option erlaubt es, mehrere Karten von Spectrum
miteinander intern zu synchronisieren, um auf einfache Art und
Weise Mehrkanalsystem aufzubauen. Es ist ebenso möglich,
synchrone Systeme aufzubauen, die in einem Rechner sowohl
analoge Kanäle als auch digitale Kanäle zusammen
aufzeichnen.
Die Karten können innerhalb eines Kartentyps synchronisiert
werden. Genauso ist es möglich verschiedene Spectrum Karten,
die alle den SPC100-SyncBus unterstützen, miteinander frei zu
kombinieren.
Eine Karte wird als Master konfiguriert und generiert den Takt
und die Triggerinformation für die anderen (Slave) Karten. Alle
Karten laufen synchron mit exakt dem gleichen Abtasttakt.
Option Synchronisation
This option allows it to connect several boards from Spectrum to
generate a multi-channel system. It is also possible to build up
synchronously mixed mode systems to record analogue channels
and digital channels together.
The boards may be connected in one type of board with each
other. Also it is possible to connect Spectrum boards of different
types that uses the SPC100-SyncBus together.
One board is dedicated as the master board and generates
clock and trigger signals for the other (slave) boards. All boards
are running synchronously.
Example configuration for Multi-Channel Systems :
x
x
x
3 boards PCI.248 32MSample memory
1 board PCI.DIO32 32MSample memory
Synchronisation cable
forming a synchronously system with
x
x
x
x
x
Page 14 of 30
6 analogue channels 8 bit resolution
32 digital channels
samplerate 1.5 MHz to 400 MHz
96 MByte on-board memory
16 MSample memory per channel
PCI-208 / CPCI.208 manual
31.03.2004
Block diagram PCI.208
Page 15 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Block diagram CPCI.208
Technical data
Resolution
Samplerate
Bandwidth DC –3 dB
Bandwidth AC –3 dB
Differential linearity error
Integral linearity error
ENOB fs = 1 MHz, fck=100 MHz
ENOB fs = 31 MHz, fck=100 MHz
Aperture jitter
Input impedance
TTL Input impedance
Multi/Gate: Trig to 1st sample delay
Multi/Gate: recovery (d 100 MHz)
Trigger output delay
Trigger accuracy (d 100 MHz)
Trigger accuracy (200 MHz)
Digital input to analogue input delay
Ext. clock: output delay
Ext. clock: delay to internal clock
Sync: board to board trigger jitter
Sync: board to board clock delay
8 bit
781 kHz up to 200 MHz
0 Hz to 90 MHz
40 Hz to 90 MHz
d r0.5 LSB
d r0.5 LSB
7.5 bit typ. (ADC)
6.5 bit typ. (ADC)
10 ps typ. (ADC)
50 Ohm or 1 MOhm || 25 pF
110 Ohm || 15 pF
8 to 42 samples (fix)
< 20 samples
6 samples
1 sample
2 samples
2 samples
ca. - 6 ns
ca. 10 ns
0 samples
d 1 ns
Input range
Offset error (100 MHz)
Offset error (200 MHz)
Gain error (100 MHz)
Gain error (200 MHz)
Noise (100 MHz)
Noise (200 MHz)
Crosstalk
r200 mV
d 3 LSB
d 4 LSB
d4%
d4%
d 1 LSB
d 2 LSB
d -48 dB
Dimension
Connector
Overvoltage protection
Warm up time
Operating temperature
Storage temperature
Humidity
312 mm x 107 mm
9 mm BNC female
r20 V
10 minutes
0qC - 50qC
-10qC - 70qC
10% to 90% non condensing
Power consumption (A)
Power consumption (W)
+3.3 V
0 mA
0.0 W
Page 16 of 30
r500 mV
d 2 LSB
d 3 LSB
d3%
d3%
d 1 LSB
d 2 LSB
d -48 dB
+5 V
3800 mA
19.0 W
r1 V
d 2 LSB
d 3 LSB
d2%
d2%
d 1 LSB
d 2 LSB
d -48 dB
+12 V
0 mA
0.0 W
-12 V
0 mA
0.0 W
PCI-208 / CPCI.208 manual
31.03.2004
Placement PCI.208
- ' & FK D Q Q H O
' LJ LWD O,Q S XWV
FK D Q Q H O
- ' & FK D Q Q H O
' LJ LWD O,Q S XWV
FK D Q Q H O
6 \Q F% X V
Placement CPCI.208
- ' & FK D Q Q H O
- ' & FK D Q Q H O
' LJ LWD O,Q S X WV
6 \ Q F% X V
Page 17 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Connectors
The PCI.208/CPCI.208 has four 9 mm BNC connectors.
Connector 0:
Connector 1:
analogue channel 0.
analogue channel 1.
Connector 2:
triggermode = TTLPOS or TTLNEG:
triggermode = GATELOW or GATEHIGH
TRIGGEROUT = 1
TRIGGEROUT = 0
external trigger input
external gate input
trigger output
not used
Connector 3:
EXTERNALCLOCK = 1
EXTERNOUT = 1
EXTERNOUT = 0
clock input
clock output
not used
AC/DC jumper
DC coupling channel 0
J10 set
J10 clear
channel 0 DC coupled
channel 0 AC coupled
DC coupling channel 1
J12 set
J12 clear
channel 1DC coupled
channel 1 AC coupled
D7 (marked D7)
D6
D5
D4
D3
D2
D1
D0 (marked D0)
GND
Digital Inputs channel 1
Pin 1
Pin 3
Pin 5
Pin 7
Pin 9
Pin 11
Pin 13
Pin 15
Pin 2, 4, 6, 8, 10, 12, 14, 16
D7 (marked D15)
D6
D5
D4
D3
D2
D1
D0 (marked D8)
GND
Ch0 D7
Ch0 D6
Ch0 D5
Ch0 D4
Ch0 D3
Ch0 D2
Ch0 D1
Ch0 D0
GND
Pin
Pin
Pin
Pin
Pin
Pin
Pin
Pin
Pin
Ch1 D7
Ch1 D6
Ch1 D5
Ch1 D4
Ch1 D3
Ch1 D2
Ch1 D1
Ch1 D0
GND
Digital inputs PCI.208
Digital Inputs channel 0
Pin 1
Pin 3
Pin 5
Pin 7
Pin 9
Pin 11
Pin 13
Pin 15
Pin 2, 4, 6, 8, 10, 12, 14, 16
Digital inputs CPCI.208
Pin A1
Pin A3
Pin A5
Pin A7
Pin A9
Pin A11
Pin A13
Pin A15
Pin A2, A4, A6, ..., A16
B1
B3
B5
B7
B9
B11
B13
B15
B2, B4, B6,..., B16
Sync Bus
Carries the signals for synchronisation of multiple PCI.208/CPCI.208
Pin
Pin
Pin
Pin
1
3
5, 7, 9
2, 4, 6, 8
Sync Clock
Sync Trigger
not used
GND
Page 18 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Software Description
Allgemeine Information
General Information
Header Dateien auf CD
Header files on CD
DLLTYP.H
DLLTYP.H
SPECTRUM.H
SPECTRUM.H
Der Spectrum Treiber besteht aus einem Satz Funktionen zur
Manipulation der Register auf der Karte und zum Daten Transfer
in beide Richtungen. Es gibt nur einen Treiber für alle Karten von
Spectrum. Abhängig von der Funktionalität der Karte und dem
benutzten Bus werden nicht alle Funktionen des Treibers von
allen Karten unterstützt. Die unterschiedliche Funktionalität der
Karten ist mit Hilfe von kartenspezifischen Registern realisiert.
Der Treiber ist für verschiedene Betriebssysteme erhältlich und
wird unter allen Betriebs systemen auf die gleiche Art und Weise
programmiert.
The SPECTRUM driver consists of a set of functions to manipulate
registers on the board and to transfer data from or to the board.
There is only one driver for all the SPECTRUM boards.
Depending on the functionality of the board and the used bus
not all functions will be implemented for all boards. The different
functionality of the boards is implemented with the help of board
specific registers. The driver is available for different operating
systems but will be programmed the same way on all operating
systems.
Enthält alle Plattform spezifischen Definitionen der Datentypen
und der Funktionsdeklarationen. Alle Datentypen basieren auf
diesen Definitionen.
Includes the platform specific definitions for data types and
function declarations. All data types are based on this
definitions.
Definiert die sechs Funktionen des Treibers. Alle Definitionen sind
aus der Datei DLLTYP.H entnommen. Die Funktionen selbst
werden weiter unten beschrieben.
Defines the six functions of the driver. All definitions are taken
from the file DLLTYP.H. The functions itself are described below.
REGS.H
REGS.H
Defines all registers and commands which are used in the
SPECTRUM driver for the different boards. The registers a board
uses are described in the board specific part of the
documentation.
Definiert alle Register und Kommandos, die im Spectrum Treiber
für die verschiedenen Karten benutzt werden. Die Register, die
von einer Karte benutzt werden sind weiter unten im
kartenspezifischen Teil beschrieben.
ERRORS.H
ERRORS.H
Lists all possible error codes of the functions.
Listet alle möglichen Errorcodes der Funktionen auf.
Funktionen des Treibers
Driver functions
SpcInitBoard
SpcSetParam
SpcGetParam
SpcSetData
SpcGetData
Page 19 of 30
+
+
+
+
-
MI.70xx
+
+
+
+
MI.60xx
+
+
+
+
MI.45xx
+
+
+
+
MI.40xx
+
+
+
+
MI.31xx
+
+
+
-
MI.30xx
+
+
+
+
-
PADCO-06
+
+
+
-
TRS582
+
+
+
-
PCK400
+
+
+
+
DAP116
+
+
+
+
PAD164
+
+
+
+
PAD1616
+
+
+
+
+
PAD1232
+
+
+
+
The SPECTRUM driver consists of the following six functions. The
functions are declared in the header file SPECTRUM.H.
Depending on the functionality of the board and the used bus
only some of the functions are used for the specific board. Not
all board specific drivers will interpret all parameters of a
function.
PCI.DIO32
+
+
+
+
PCI.-258
+
+
+
+
PCI.-248
+
+
+
+
CPCI.208
+
+
+
+
PCI.208
+
+
+
+
PCI.212
+
+
+
+
PCI.412
+
+
+
+
PAD242
+
+
+
+
PAD82a/b
SpcInitPCIBoards
PAD52
Der Spectrum Treiber besteht aus den folgenden sechs
Funktionen. Die Funktionen sind in der Header-Datei
SPECTRUM.H definiert. Abhängig von dem Funktionsumfang der
Karte und dem verwendeten Bussystem sind nur einige der
Funktionen für die spezielle Karte notwendig. Bei einigen Karten
werden nicht alle Parameter der Funktion unterstützt.
+
+
+
+
+
PCI-208 / CPCI.208 manual
31.03.2004
int16 SpcInitPCIBoards (int16* count, int16* PCIVersion)
count
PCIVersion
return
adr of 16 bit integer
adr of 16 bit integer
16 bit integer
number of found PCI boards
found PCI version
error code of function like listed below
Initialises all installed PCI boards. The board numbers will start with zero. The number of PCI boards will be given back in the value
Count. All installation parameters will be read from the hardware.
Using Windows NT the boards are already installed in the registry. This function just gives back the values of the
kernel driver.
Linux initialises the boards while loading the kernel module. This function is not available under Linux.
int16 SpcInitBoard (int16 nr, int16 typ)
nr
typ
return
16 bit integer
16 bit integer
16 bit integer
number of the board to be defined in range 0-15
type of the defined board listed in REGS.H
error code of function like listed below
Defines a board for the driver. The driver supports up to 16 boards at the same time. For all ISA boards the type of installed board
must be defined before using the driver the first time. All other functions just use the board number to access the board. After
initialising the board all parameters will be set to default values.
Using Windows NT the board is already installed in the registry. This function will then just compare the board type with the already
installed one.
Linux initialises the boards while loading the kernel module. This function is not available under Linux.
int16 SpcSetParam (int16 nr, int32 reg, int32 value)
nr
reg
value
return
16
32
32
16
bit integer
bit integer
bit integer
bit integer
number of the board as defined by SpcInit...
register to be changed
value for the register
error code of function like listed below
Sets a register to a defined value or executes a command. The board must be initialised before. When using ISA boards, all installation
parameters must be set before (address, installed memory, ...). The allowed registers for the driver are listed in the board specific part of
the documentation.
When using Windows NT the installation parameters may not be changed, they are set in the registry using the
driver configuration utility.
int16 SpcGetParam (int16 nr, int32 reg, int32* value)
nr
reg
value
return
16 bit integer
32 bit integer
adr of 32 bit integer
16 bit integer
number of the board as defined by SpcInit...
register to be read
value from the register
error code of function like listed below
Reads a register or a status information of the board. The board must be initialised before. When using ISA boards, the installation
address must be set before. The allowed registers for the driver are listed in the board specific part of the documentation.
int16 SpcSetData (int16 nr, int16 ch, int32 start, int32 len, dataptr data)
nr
ch
start
len
data
return
16 bit integer
16 bit integer
32 bit integer
32 bit integer
huge ptr to data
16 bit integer
number of the board as defined by SpcInit...
channel to be written to
startvalue to be written
number of values to be written
data to be written
error code of function like listed below
Writes data to the board for a specific channel. The board must be initialised before. When using ISA boards, all installation parameters
must be set before (address, installed memory, ...). The Start and Len parameter are implemented on all PCI boards. On ISA boards the
whole data will be written in one turn. The data must be in two’s complement format (standard integer format).
Page 20 of 30
PCI-208 / CPCI.208 manual
31.03.2004
int16 SpcGetData (int16 nr, int16 ch, int32 start, int32 len, dataptr data)
16 bit integer
16 bit integer
32 bit integer
32 bit integer
huge ptr to data
16 bit integer
nr
ch
start
len
data
return
number of the board as defined by SpcInit...
channel to be read
startvalue to be read
number of values to be read
data space for read values
error code of function like listed below
Reads data from the board from a specific channel. The board must be initialised before. When using ISA boards, all installation
parameters must be set before (address, installed memory, ...). The Start and Len parameter are implemented on all PCI boards. On
ISA boards the whole data will be read in one turn. The read out data is in the two’s complement format and could be directly used for
data processing as standard integer values.
Error Codes
error name
value
(hex)
value
(dec.)
ERR_NR
ERR_TYP
ERR_FNCNOTSUPPORTED
ERR_LASTERR
ERR_ABORT
ERR_BOARDLOCKED
ERR_REG
ERR_VALUE
2
3
4
10
20
30
100
101
2
3
4
16
32
48
256
257
ERR_FEATURE
ERR_SEQUENCE
ERR_READABORT
ERR_NOACCESS
ERR_POWERDOWN
ERR_CHANNEL
102
103
104
105
106
110
258
259
260
261
262
272
ERR_RUNNING
ERR_ADJUST
ERR_NOPCI
ERR_PCIVERSION
ERR_PCINOBOARDS
ERR_PCICHECKSUM
ERR_DMALOCKED
ERR_MEMALLOC
ERR_FIFOBUFOVERRUN
ERR_FIFOHWOVERRUN
ERR_FIFOFINISHED
ERR_FIFOSETUP
ERR_TIMESTAMP_SYNC
120
130
200
201
202
203
204
205
300
301
302
309
310
288
304
512
513
514
515
516
517
768
769
770
777
784
ERR_OK
ERR_INIT
0
1
0
1
description
Execution OK, no error.
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.
The board is not initialised yet. Use the function SpcInitBoard or SpcInitPCIBoards first.Initialisation only: The type of board is unknown.
This function is not supported by the hardware version.
Old Error waiting to be read.
Abort of wait function
Access to the driver already locked by another program. Stop the other program before starting this one.
The register is not valid for this type of board.
The value for this register is not in a valid range, the allowed values and ranges are listed in the board
specific documentation.
Feature is not installed on this board
Channel sequence is not allowed.
Data read is not allowed after aborting the data acquisition.
Access to this register denied. No access for user allowed.
Not allowed if powerdown mode is activated.
The channel number may not be accessed on the board: Either it is not a valid channel number or the
channel is not accessible due to the actual setup (e.g. Only channel 0 is accessible in interlace mode)
The board is still running, this function is not available now or this register is not accessible now.
Automatic adjustion has reported an error. Please check the boards inputs.
No PCI BIOS is found on the system.
The PCI bus has the wrong version. SPECTRUM PCI boards require PCI revision 2.1 or higher.
No SPECTRUM PCI boards found.
The checksum of the board information has failed.
DMA buffer not available now.
Internal memory allocation failed.
Driver buffer overrun in FIFO mode.
Hardware buffer overrun in FIFO mode.
FIFO transfer has been finished, programmed number of buffers has been transferred.
FIFO setup not possible, transfer rate to high (max 250 MB/s)
Synchronisation to external reference clock failed.
Valid Board Types
board
PAD52
PAD82
PAD82a
PAD82b
PAD242
PAD1232-10
PAD1232-30
PAD1232-40
type(hex)
600
200
210
220
700
400
410
420
type (dec)
1536
512
528
544
1792
1024
1040
1056
board
PAD1616a
PAD1616b
PAD164/2
PAD164/5
PADCO-06
PCK400
DAP116
TRS582
type(hex)
500
510
900
910
1400
800
100
1500
type (dec)
1280
1296
2304
2320
5120
2048
256
5376
Page 21 of 30
board
PCI.212
PCI.208
PCI.412
PCI.DIO32
PCI.248
PCI.258
MI.3010
...
type(hex)
300
1000
1100
1200
1300
1600
3010
...
type (dec)
384
4096
4352
4608
4864
5632
12304
...
PCI-208 / CPCI.208 manual
31.03.2004
Hints for programming the boards
Programming an ISA board is done in the following steps:
initialise and define boards with function SpcInitBoard (Windows NT: utility DRVCONFG.EXE)
set installation parameters like address, installed memory, version with function SpcSetParam
set user specific parameters and start board (loop)
Programming an PCI board is done by the following steps:
initialise PCI boards automatically with function SpcInitPCIBoards
read out installation parameters for all found PCI boards like version, installed memory
set user specific parameters and start board (loop)
If you are using ISA and PCI boards in one system at the same time, use the function SpcInitPCIBoards first and initialise the ISA
boards after this. The function SpcInitPCIBoards uses the first board numbers and will overwrite other definitions.
It is only necessary to define the boards once for the driver with the functions SpcInitPCIBoards and SpcInitBoard. If you are defining the
boards again, you will get an error code from the function and the old definition is still used. You may ignore this error.
Page 22 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Software - Register
These software register are to be used for the functions SpcSetParam and SpcGetParam of the software driver. All constants are found in
the header file REGS.H.
PCI register
These Registers are set by the driver after PCI initialisation. The information is found in the on-board ROM. The program PCITEST.EXE on
the driver disk will give the same information’s.
register name
SPC_PCITYP
SPC_PCIVERSION
SPC_PCIDATE
SPC_PCISERIALNO
SPC_PCISAMPLERATE
SPC_PCIMEMSIZE
SPC_PCIFEATURES
SPC_PCIINTERRUPT
reg no.
2000
2010
2020
2030
2100
2110
2120
2300
r/w
type of board as listed above
board revision: high part in bit 8..15, Low part in bit 0..7
production date: month in bit 0..7, year in bit 16..31
serial number of the PCI.208/CPCI.208
max. samplerate as 32 bit integer value
installed memory in bytes as 32 bit integer value
installed features as a bitfield. See description beneath.
interrupt line of the board
r
r
r
r
r
r
r
r
PCI Features register
Bit
...
Bit
Bit
Bit
Bit
Bit
Bit
Bit
Bit
Bit
Bit
31
not used
9
8
7
6
5
4
3
2
1
0
not used
option double mem installed
option synchronisation master: board is clock-master for synchronisat ion
option synchronisation slave : board is clock-slave for synchronisation.
not used
not used
not used
not used
not used
option multiple recording installed
Error registers
If one action caused an error in the driver this error and the register and value where it occurs will be saved. The driver is then locked until
the error is read out using the SPC_LASTERRORCODE function. All other functions will lead to the same errorcode unless the error is
cleared by reading SPC_LASTERRORCODE.
name
SPC_LASTERRORCODE
SPC_LASTERRORREG
SPC_LASTERRORVALUE
SPC_LASTERRORTEXT
value (dec)
999999
999998
999997
999996
r/w
r
r
r
r
errorcode of the last error as defined in errors.h
software register which causes the error
value which causes the error
Copies a short explanation of the error to a string. The argument value must be a
pointer to a string with at least ERRORTEXTLEN characters.
Status register
Status information can be read at any time. The other parameters can only be written and the data can be read if the board is stopped.
register name
reg no.
status code
value
SPC_STATUS
SPC_RUN
SPC_TRIGGER
SPC_READY
10
0
10
20
r/w
r
status register, values listed below.
board is running.
trigger has been found.
recording has stopped.
Page 23 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Command register
The command register executes commands like start and stop or synchronises the board with other boards.
register name
reg no.
status code
value
SPC_STOP
SPC_SYNCMASTER
SPC_SYNCSLAVE
SPC_NOSYNC
SPC_SYNCTRIGGERMASTER
SPC_SYNCTRIGGERSLAVE
20
100
110
120
101
111
SPC_COMMAND
SPC_START
0
r/w
w
10
command register, allowed values listed below.
starts the board with the current register settings. If the settings of the input range has been set
since the last start of the board, the driver will hold a 200 ms delay before starting to wait the
relais settling time.
stops the board, data in memory is undefined.
synchronisation with internal SPC100 sync bus, this board works as master
synchronisation with internal SPC100 sync bus, this board works as slave
no synchronisation
synchronisation: board generates trigger for all boards
synchronisation: board receives trigger from trigger master board.
Synchronisation (Option)
See Hardware Part of the manual for further details.
This option allows it to connect several boards from Spectrum to generate a multi-channel system. It is possible to connect several
PCI.208/CPCI.208 with each other as well as to connect the PCI.208/CPCI.208 with other Spectrum boards using the Spc100 Sync-Bus.
One board is the clock master and generates the clock for the other (slave) boards. The clock master is defined in hardware and has the
synchronisation master bit set in the PCI features register(see above). Only one board may be the clock master. At runtime any of the
synchronised boards may be defined as a trigger master and generates trigger information for the other boards.
If the boards are synchronised, they must be programmed in the following steps:
(1)
(2)
(3)
(2)
(3)
Set all parameters for all boards except the sync information
Set the sync information for the clock-master board.
Set the sync information for all clock-slave boards.
Start all trigger-slave boards.
Start the trigger-master board.
All boards will run with the clock generated by the clock-master board. Only the trigger-master board may generate a trigger. The trigger
settings for the trigger-slave boards will be ignored.
Memory register
This register holds the number of samples, not the number of bytes. The possible values have to be doubled in the interlace mode (200
MHz).
register name
SPC_MEMSIZE
reg no.
10000
r/w
r/w
memory size for recording: 32 samples up to installed mem/2 samples with steps of 32
samples. When using 200 MHz mode: 64 samples up to installed mem with steps of 64.
Posttrigger register
Sets the number of samples to be recorded AFTER the triggerevent has been found. The corresponding pretrigger is calculated by the
formula: pretrigger = memsize - posttrigger
If the posttrigger value is higher than the programmed memsize, the triggerevent is not visible.
If the option Multiple Recording is used, this register holds the segmentsize.
register name
SPC_POSTTRIGGER
reg no.
10100
r/w
r/w
posttrigger value in the range 32 samples up to 256 MSamples with steps of 32. When using
200 MHz mode the value is doubled in the driver.
Page 24 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Features register
All of this features Registers may be set by writing a 1 or cleared by writing a 0. Some features may only be used if this features is
installed on the board (see PCI Features above).
register name
reg no.
r/w
SPC_EXTERNOUT
20110
r/w
SPC_TRIGGEROUT
40100
r/w
SPC_50OHM0
SPC_50OHM1
SPC_DIGITAL0
SPC_DIGITAL1
SPC_NOPRETRIGGER
30030
30130
30050
30150
200600
r/w
r/w
r/w
r/w
r/w
SPC_RUNINTENABLE
290000
r/w
SPC_EXTERNALCLOCK
20100
r/w
the external clock will be used for recording. The external clock is allowed in the range 1
MHz to 100 MHz.
enables the clock output on connector 3 of the board. Not possible if SPC_EXTERNALCLOCK
is enabled.
Enables the trigger output on connector 2 of the board. Not possible if the triggermode is set
to external TTL trigger rising or falling edge.
set the channel 0 to 50 : input resistance (default is 1 M: )
set the channel 1 to 50 : input resistance (default is 1 M: )
enable recording of digital inputs for channel 0
enable recording of digital inputs for channel 1
when set to 1 the trigger sequencer is armed immediately after starting the board. The
memory is not filled with pretrigger data. This may result in the loss of pretrigger data!
enables the generation of an interrupt at the end of recording. The used interrupt line may be
read out with the register SPC_PCIINTERRUPT
Additional feature register of CPCI.208
Register name
SPC_CLOCK50OHM
SPC_TRIGGER50OHM
reg no.
20120
40110
r/w
r/w
r/w
set the clock input to 50 : input resistance
set the trigger input to 50 : input resistance
Triggermode register
Register name
reg no.
Triggermodes
value
SPC_TRIGGERMODE
40000
TM_SOFTWARE
TM_CH0POS
TM_CH0NEG
TM_CH1POS
TM_CH1NEG
TM_TTLPOS
TM_TTLNEG
TM_GATELOW
TM_GATEHIGH
r/w
r/w
0
10000
10010
10100
10110
20000
20010
30000
30010
triggermode for recording.
recording will start immediately.
wait for rising edge on channel 0 at triggerlevel
wait for falling edge on channel 0 at triggerlevel
wait for rising edge on channel 1 at triggerlevel
wait for falling edge on channel 1 at triggerlevel
wait for external TTL trigger rising edge.
wait for external TTL trigger falling edge.
gated sampling (option) gate is TTL LOW
gated sampling (option) gate is TTL HIGH
Triggerlevel register
The triggerlevel is an 4 bit value which will be compared with the upper 4 bit of the ADC data.
register name
reg no.
SPC_TRIGGERLEVEL
triggerlevel
7
6
...
1
0
-1
...
-7
-8
stepsize
42000
r/w
r/w
triggerlevel for the triggermodes TM_CH0/1POS/NEG
r200 mV
r500 mV
r1 V
+25.0 mV
0.0 mV
-25.0 mV
+62.5 mV
0.0 mV
-62.5 mV
+0.125 V
0V
-0.125 V
-175.0 mV
-200.0 mV
-437.5 mV
-500.0 mV
-0.875 V
-1.000 V
+175.0 mV
+150.0 mV
25.0 mV
+437.5 mV
+375.0 mV
62.5 mV
+0.875 V
+0.750 V
0.125 V
Page 25 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Samplerate register
Sets the samplerate for recording.
register name
SPC_SAMPLERATE
reg no.
20000
r/w
r/w
samplerate between 1 MHz and 200 MHz
The value is a 32 bit integer in the range from 100 MHz down to 781 kHz using an 7 bit divider or the value 200 MHz. Possible values
are: 200 MHz, 100 MHz, 100 MHz/2 = 50 MHz, 100 MHz/3 = 33.33 MHz, 100 MHz/4 = 25 MHz, ..., 100 MHz/128 = 781 kHz
Double Mem (Option)
The option Double Mem allows it to use the complete on-board memory for the recording of channel 0. Normally each channel uses half of
the on-board memory and only the 200 MHz mode allows it to use the complete memory for one channel. With the option Double Mem it
is possible to use the full memory for one channel with all samplerates.
register name
SPC_DOUBLEMEM
reg no.
220100
r/w
r/w
enables DoubleMem mode. 0 = disable, 1 = enable.
Using the Double Mem mode together with the Multiple Recording mode or with the 200 MHz samplerate is not allowed. When using this
option the minimum and maximum values for the memsize register are doubled.
Multiple Recording (Option)
See the hardware description part of the manual for basic information about multiple recording.
register name
SPC_MULTI
SPC_MULTIMEMVALID
reg no.
220000
220200
r/w
r/w
r
enables Multiple Recording for the board. 0 = disable, 1 = enable.
read out the number of valid trigger samples after multiple recording was stopped by the user
by writing SPC_STOP to the command register.
The register memsize holds the total amount of memory to be recorded. The register posttrigger will hold the size of one segment.
Recording is started with a fixed delay after the triggerevent is found. There is no pretrigger possible in Multiple Recording mode.
If multiple recording is aborted by the user, all segments that have been recorded before the stop command may be read out. To
determine, where the recording has stopped the user may read out the number of valid samples with the help of the register
SPC_MULTIMEMVALID.
The delay between the external triggerevent and the first sampled data corresponds to the used samplerate, the synchronisation and the
uses triggermode and is fix for each recording with this settings. The delay is necessary for this board because it works with dynamic RAM
and needs refresh cycles to let the data stay in memory when the board is not recording.
Samplerate
d 100 MHz
d 100 MHz
d 100 MHz
d 100 MHz
200 MHz
200 MHz
200 MHz
200 MHz
Synchronisation
No
Yes
No
Yes
No
Yes
No
Yes
Triggermode
TTL Pos. or TTL Neg.
TTL Pos. or TTL Neg.
Ch0 or Ch1 Pos. or Neg.
Ch0 or Ch1 Pos. or Neg.
TTL Pos. or TTL Neg.
TTL Pos. or TTL Neg.
Ch0 or Ch1 Pos. or Neg.
Ch0 or Ch1 Pos. or Neg.
Delay trigger to first recorded sample
8 Samples
13 Samples
16 Samples
21 Samples
16 Samples
26 Samples
32 Samples
42 Samples
Page 26 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Gated Sampling (option)
See the hardware description part of the manual for basic information about gated sampling.
register name
SPC_TRIGGERMODE
SPC_GATEMARKENABLE
reg no.
40000
200400
r/w
r/w
r/w
trigger mode set to TM_GATELOW or TM_GHATEHIGH
enables gate marking in data. value –128 (0x80) is used as mark
The gated sampling mode is enabled by settings the triggermode to TM_GATELOW or TM_GATEHIGH. The register memsize holds the
total amount of memory to be recorded. The register posttrigger has no function at gated sampling.
The sampling of data starts with the first edge of the external gate signal. At trigger mode TM_GATELOW this is the falling edge. At
trigger mode TM_GATEHIGH this is the rising edge. Data is not recorded before the first occurance of the correct edge even if the
programmed gate level is present at the input connector at start time.
The delay between the external triggerevent and the first sampled data corresponds to the used samplerate and the synchronisation and is
fix for each recording with this settings. The delay is necessary for this board because it works with dynamic RAM and needs refresh
cycles to let the data stay in memory when the board is not recording.
Samplerate
d 100 MHz
d 100 MHz
200 MHz
200 MHz
Synchronisation
No
Yes
No
Yes
Triggermode
Gate
Gate
Gate
Gate
LOW
LOW
LOW
LOW
or Gate
or Gate
or Gate
or Gate
HIGH
HIGH
HIGH
HIGH
Delay trigger to first recorded sample
8 Samples
13 Samples
16 Samples
26 Samples
Recording will pause at the end of a gate intervall (rising edge on trigger mode TM_GATELOW or falling edge on trigger mode
TM_GATEHIGH). Due to the structure of the on board memory, recording may only stop at a 16 samples (32 samples for 200 MHz mode)
alignement. So there will be 1 to 16 (1 to 32 on 200 MHz mode) additinal samples recorded after the end of the gate intervall.
When gate marking is enabled, the value –128 is filtered off from the ADC values. Valid samples values are then in the range from –127
to +127. The value –128 is used to mark the end of a gate interval / start of the nect gate interval. All additinal recorded samples after
the end of the gate interval are set to –128.
Example (trigger mode TM_GATEHIGH, no Synchronisation, samplerate d 100 MHz):
sample
ADC data
64
65
...
y64
y65
...
...
0
1
2
...
60
61
62
63
...
-
...
y0
y1
y2
...
y60
y61
y62
y63
...
-
gate signal
...
1
1
1
1
...
1
0
0
0
0
...
0
1
1
1
1
1
1
1
1
1 (8 samples delay)
1
...
data witout gate marking
data with gate marking
y64
y65
...
y64
y65
...
...
y0
y1
y2
...
y60
y61
y62
y63
...
-
...
y0
y1
y2
...
y60
mark = -128
mark = -128
mark = -128
...
-
Gated sampling may not be used together with the option DoubleMem or the option Multiple Recording
Page 27 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Input range register
register name
reg no.
SPC_AMP0
SPC_AMP1
30010
30110
r/w
w
w
input range channel 0
input range channel 1
The input range can be set with in three steps with the help of relais. The input ranges are defined in factory and can be read out.
Standard input ranges are:
PCI.208
value
200
500
1000
CPCI.208
calibrated input range
r 200 mV
r 500 mV
r1V
value
calibrated input range
2000
5000
10000
r2V
r5V
r 10 V
200
500
1000
± 200 mV
± 500 mV
±1V
The available input ranges can be read out from the driver.
register name
reg no.
r/w
SPC_READRANGECH1_0
3300
r
SPC_READIRCOUNT
SPC_READRANGECH0_0
3000
3200
r
r
number of calibrated input ranges.
range in mV of calibrated input range 0. The values of the other entries may be read out from
the following registers. (3201 for range1, 3202 for range2, ...)
range in mV of calibrated input range 0. The values of the other entries may be read out from
the following registers. (3301 for range1, 3302 for range2, ...)
Data (Read)
Data can be read after the board has stopped. The data can be random accessed in blocks of variable length. The trigger event is found
at the position memsize - posttrigger.
Example: 2k memsize, 1k postttrigger
1k Pretrigger
1k Posttrigger
W
2k Memsize
1. value
Example: 2k memsize, 3k postttrigger
Triggerevent
3k Posttrigger
2k Memsize
Triggerevent ( invisible)
1. value
Page 28 of 30
W
PCI-208 / CPCI.208 manual
31.03.2004
Example of Driver use
This example is written for a C or C++ compiler. It reads out the information of the PCI.208, sets the parameters and starts the board once.
This file is also found in the example directory on the driver disk. The programming of the CPCI.208 is similar to this.
3&,VRIWZDUHGULYHUH[DPSOHF6SHFWUXP*PE+
7KLVH[DPSOHZLOORQO\ZRUNFRUUHFWLIMXVWRQH3&,LVLQVWDOOHG
LQWKHV\VWHPDQGQRRWKHU6SHFWUXPERDUGV
LQFOXGHVWGLRK!
LQFOXGH'//7<3+
LQFOXGH63(&7580+
LQFOXGH(55256+
LQFOXGH5(*6+
PDLQ
^
LQW&RXQW3&,9HUVLRQ
LQW7\S9HUVLRQ'DWH6WDWXV
LQW'DWD>O@'DWD>O@
,QLWLDOLVDWLRQRI3&,%XV
LI6SF,QLW3&,%RDUGV&RXQW3&,9HUVLRQ (55B2.UHWXUQ
LI&RXQW UHWXUQ
7HVWIRU3&,VWERDUGLVERDUGQXPEHU
6SF*HW3DUDP63&B3&,7<37\S
LI7\S 7<3B3&,
UHWXUQ
*HWVRPH3&,3DUDPHWHUVIURPGULYHUDQGSULQWWKHP
6SF*HW3DUDP63&B3&,9(56,219HUVLRQ
6SF*HW3DUDP63&B3&,'$7('DWH
SULQWI3&,9[[SURGXFHGGG?QLQW9HUVLRQ!![))
LQW9HUVLRQ[))LQW'DWH[))LQW'DWH!!
6HW3DUDPHWHUVIRU5HFRUGLQJ
6SF6HW3DUDP63&B6$03/(5$7(OVDPSOHUDWH0+]
6SF6HW3DUDP63&B0(06,=(OPHPVL]HN6DPSOH
6SF6HW3DUDP63&B326775,**(5OSRVWWULJJHU6DPSOH
6SF6HW3DUDP63&B(;7(51$/&/2&.QRH[WHUQDOFORFN
6SF6HW3DUDP63&B(;7(51287QRFORFNRXWSXW
6SF6HW3DUDP63&B75,**(5287QRWULJJHURXWSXW
6SF6HW3DUDP63&B$03OFKDQQHO“9LQSXWUDQJH
6SF6HW3DUDP63&B$03OFKDQQHO“9LQSXWUDQJH
6SF6HW3DUDP63&B',*,7$/FKDQQHODQDORJXHLQSXW
6SF6HW3DUDP63&B',*,7$/FKDQQHODQDORJXHLQSXW
6SF6HW3DUDP63&B2+0FKDQQHO: LQSXWUHVLVWDQFH
6SF6HW3DUDP63&B2+0FKDQQHO: LQSXWUHVLVWDQFH
6SF6HW3DUDP63&B75,**(502'(70B62)7:$5(VRIWZDUHWULJJHU
6SF6HW3DUDP63&B08/7,OQRPXOWLSOHUHFRUGLQJ
6SF6HW3DUDP63&B'28%/(0(0OQRGRXEOHPHPPRGH
VWDUWWKHERDUG
6SF6HW3DUDP63&B&200$1'63&B67$57
ZDLWIRUVWDWXVUHDG\
GR
^
6SF*HW3DUDP63&B67$7866WDWXV
`
ZKLOH6WDWXV 63&B5($'<
UHDGGDWD
6SF*HW'DWDOGDWDSWUGDWD
6SF*HW'DWDOGDWDSWUGDWD
UHWXUQ
Page 29 of 30
PCI-208 / CPCI.208 manual
31.03.2004
Transfer speed
All values measured using the actual version of the Spectrum driver. The test system was a Pentium II 450 MHz with 128 MB RAM. Board
configuration is: Memsize as listed in the table, posttrigger=memsize/2, all channels recorded, software trigger
Memsize
Bytes
DOS
Store
Add
Transfer
Win 3.11
Store
Add
Transfer
Memsize
Bytes
Win 95
Store
Add
Transfer
Win NT
Store
Add
Transfer
256
512
1k
2k
4k
8k
16k
32k
64k
128k
256k
512k
1M
256
512
1k
2k
4k
8k
16k
32k
64k
128k
256k
512k
1M
512
1k
2k
4k
8k
16k
32k
64k
128k
256k
512k
1M
2M
512
1k
2k
4k
8k
16k
32k
64k
128k
256k
512k
1M
2M
13000 Hz
10700 Hz
8250 Hz
4850 Hz
2700 Hz
1450 Hz
720 Hz
400 Hz
180 Hz
100 Hz
9500 Hz
8800 Hz
6750 Hz
4100 Hz
2300 Hz
1200 Hz
630 Hz
320 Hz
160 Hz
80 Hz
40 Hz
20 Hz
10 Hz
3700 Hz
2000 Hz
1050 Hz
540 Hz
270 Hz
140 Hz
70 Hz
35 Hz
17 Hz
8 Hz
9500 Hz
8800 Hz
6750 Hz
4100 Hz
2300 Hz
1200 Hz
610 Hz
310 Hz
160 Hz
50 Hz
35 Hz
17 Hz
8 Hz
Store:
Set all Parameters to the board
Loop Start
Start the board
Wait for Ready
Read Data
Loop End
Add:
Set all Parameters to the board
Loop Start
Start the board
Wait for Ready
Read Data
Add Data to existing Data
Loop End
11,0 MB/s
18,0 MB/s
25,0 MB/s
30,0 MB/s
36,5 MB/s
40,5 MB/s
40,5 MB/s
41,0 MB/s
40,0 MB/s
41,0 MB/s
8,0 MB/s
12,5 MB/s
18,0 MB/s
22,5 MB/s
31,0 MB/s
33,0 MB/s
32,0 MB/s
33,5 MB/s
34,0 MB/s
34,0 MB/s
34,0 MB/s
32,5 MB/s
30,0 MB/s
7800 Hz
6800 Hz
5850 Hz
4000 Hz
2300 Hz
1200 Hz
630 Hz
330 Hz
170 Hz
85 Hz
42 Hz
21 Hz
11 Hz
3600 Hz
3400 Hz
3150 Hz
2400 Hz
1650 Hz
1000 Hz
580 Hz
310 Hz
160 Hz
80 Hz
40 Hz
20 Hz
10 Hz
Transfer: Set all Parameters to the board
Star the board
Wait for Ready
Loop Start
Read Data
Loop End
Page 30 of 30
7000 Hz
4800 Hz
2900 Hz
1600 Hz
880 Hz
450 Hz
230 Hz
115 Hz
60 Hz
30 Hz
15 Hz
7 Hz
4 Hz
3600 Hz
3400 Hz
3150 Hz
2400 Hz
1630 Hz
990 Hz
550 Hz
300 Hz
150 Hz
80 Hz
35 Hz
18 Hz
9 Hz
7,0 MB/s
11,5 MB/s
18,0 MB/s
22,0 MB/s
28,5 MB/s
30,0 MB/s
31,0 MB/s
33,0 MB/s
33,0 MB/s
34,0 MB/s
34,0 MB/s
33,0 MB/s
32,0 MB/s
3,0 MB/s
5,8 MB/s
10,0 MB/s
15,5 MB/s
22,0 MB/s
26,0 MB/s
29,0 MB/s
32,0 MB/s
32,5 MB/s
33,0 MB/s
33,5 MB/s
33,0 MB/s
31,5 MB/s