Wasco OPTOOUT-PCIe32 STANDARD User manual

Handbuch
wasco®
user‘s guide
wasco®
OPTOOUT-PCIe32
STANDARD
EDP No: A-846600
32 optocoupler isolated digital outputs
OPTOOUT-PCIe32
STANDARD
EDV-Nr.: A-846600
32 Ausgänge über Optokoppler

2
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
2
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
22
wasco®wasco®
Copyright©2019 by Messcomp Datentechnik GmbH
This documentation is copyright by Messcomp Datentechnik GmbH. All
rights are reserved.
Messcomp Datentechnik GmbH reserves the right to modify the products
described in this manual at any time and without preannouncement.
No parts of this manual are allowed to be reproduced, copied, translated
or transmitted in any way without a prior written consent of Messcomp
Datentechnik GmbH.
Registered Trademarks
Windows®, Visual Basic®, Visual C++®, Visual C#®are trademarks of
Microsoft.
wasco®is registered trademark
Linux® is registered trademark
Ubuntu® is registered trademark
LabVIEW® is registered trademark
Other product and company names mentioned may be trademarks of
their respective owners
Disclaimer
The company Messcomp Datentechnik GmbH assumes no liability for the
use of the interface card OPTOOUT-PCIe32STANDARD and this documenta-
tion, neither for direct nor indirect damages.
Copyright©2019 by Messcomp Datentechnik GmbH
Diese Dokumentation ist urheberrechtlich geschützt. Alle Rechte sind
vorbehalten.
Messcomp Datentechnik GmbH behält sich das Recht vor, die in dieser
Dokumentation beschriebenen Produkte jederzeit und ohne Vorankündi-
gung zu verändern.
Ohne schriftliche Genehmigung der Firma Messcomp Datentechnik
GmbH darf diese Dokumentation in keinerlei Form vervielfältigt werden.
Geschützte Warenzeichen
Windows®, Visual Basic®, Visual C++®, Visual C#®sind eingetragene
Warenzeichen von Microsoft.
wasco®ist ein eingetragenes Warenzeichen.
Linux®ist ein eingetragenes Warenzeichen.
Ubuntu®ist ein eingetragenes Warenzeichen.
LabVIEW®ist ein eingetragenes Warenzeichen.
Bei anderen genannten Produkt- und Firmennamen kann es sich um
Warenzeichen der jeweiligen Inhaber handeln.
Haftungsbeschränkung
Die Firma Messcomp Datentechnik GmbH haftet für keinerlei durch den
Gebrauch der Interfacekarte OPTOOUT-PCIe32STANDARD und dieser Doku-
mentation direkt oder indirekt entstandene Schäden.

3
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
3
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
33
wasco®wasco®
Table of Contents Inhaltsverzeichnis
1. Description........................................................................................5
2. Installing the OPTOOUT-PCIe32STANDARD ..........................................6
2.1 Installing the card into your computer....................................................................6
3. Connectors........................................................................................7
3.1 Position of the connector plugs on the board........................................................7
3.2 Pin assignment of CN1..........................................................................................8
4. System Components........................................................................9
4.1 Block diagram........................................................................................................9
4.2 Access to the system components......................................................................10
5. 32 Optocoupler Outputs ................................................................11
5.1 Pin assignment of the output optocouplers .........................................................11
5.2 Optocoupler specications ..................................................................................11
5.3 Output circuitry ....................................................................................................11
6. Board Identication........................................................................12
6.1 Board Identication..............................................................................................12
6.2 Access via 16 or 32 bit.........................................................................................13
7. Programming under Windows®.....................................................14
7.1 Installing the Windows®driver.............................................................................14
7.2 Installing the Windows® development les ..........................................................14
7.3 Programming the OPTOOUT-PCIe32 with wasco®driver...................................17
7.4 Access to the card OPTOOUT-PCIe32Standard .......................................................18
7.5 Assignment of the Memory Mapped I/O Addresses ............................................18
7.6 Compatibility to the OPTOOUT-PCI32STANDARD.....................................................19
8. Programming under Linux®...........................................................20
8.1 Installing the Linux®driver...................................................................................20
8.2 Supported Linux distributions/kernel versions.....................................................20
8.3 Programming of the OPTOOUT-PCIe32 with wasco®driver...............................20
8.4 Access to the card OPTOOUT-PCIe32Standard..................................................................................................21
8.5 Assignment of the Memory Mapped I/O addresses.............................................21

4
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
4
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
44
wasco®wasco®
Table of Contents Inhaltsverzeichnis
9. Accessories ....................................................................................22
9.1 Compatible wasco®accessories..........................................................................22
9.2 Connection Technique (application examples)....................................................22
9.3 Single components for customized assembly .....................................................23
10. Troubleshooting ...........................................................................24
11. Specications ...............................................................................25
12. Product Liability Act.....................................................................26
13. CE Conrmation ...........................................................................28

5
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
5
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
55
wasco®wasco®
1. Description
The wasco®interface card OPTOOUT-PCIe32STANDARD provides 32 digital
outputs, every single channel is galvanically isolated. Electrical isolation
is granted by special high power optocouplers, which can cope with a
switching current of up to 150 mA. Additionally, each output is tted with
protection diodes against harmful voltage peaks.
The output optocouplers are fed to a 68-pin SCSI socket mounted on the
board’s slot bracket.
Pin assignment and input voltage ranges are identical with PCI bus card
OPTOOUT-PCI32STANDARD. Therefore a switch to PCIe is easily to realise.
Furthermore, the card provides a jumper block for a card identication.
This enables you to differentiate between several identical cards in your
system.
1. Produktbeschreibung
Die OPTOOUT-PCIe32STANDARD bietet 32 digitale Ausgänge mit galva-
nischer Trennung, einzeln für jeden Kanal. Die Potentialtrennung ge-
währleisten hochwertige, leistungsfähige Optokoppler, die einen Schalt-
strom von bis zu 150 mA bewältigen. Jeder Ausgang ist zusätzlich durch
eine Schutzdiode gegen schädliche Spannungsspitzen und Impulse ge-
schützt. Über leicht steckbare Jumper sind für jeden einzelnen Eingangs-
kanal zwei verschiedene Eingangsspannungsbereiche einstellbar.
Die Anschlüsse der Ausgangsoptokoppler sind der am Slotblech der
Platine montierten 68poligen SCSI-Buchse zugeführt. Die Steckerbe-
legungen ist identisch zur PCI-Bus-Karte OPTOOUT-PCI32STANDARD, ein
Umstieg auf PCIe ist dadurch einfach realisierbar.
Des Weiteren besitzt die Karte einen Board-Identikations-Jumperblock,
um mehrere identische Karten im PC unterscheiden zu können.

6
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
6
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
66
wasco®wasco®
2. Installing the OPTOOUT-PCIe32STANDARD
2.1 Installing the card into your computer
Before you insert the card unplug the power cord or make sure, there is
no current to/in the computer. Inserting into a running system may cause
damaging or destroying not only OPTOOUT-PCIe32STANDARD, but even
other already inserted cards of your computer.
Select an empty PCIe slot of your computer for inserting the card. Please
refer to the computer‘s manual for support. Secure the OPTOIO-PCIe32
by screwing the slot bracket to the casing of your computer to avoid the
card coming loose by effects of the cables.
2. Installation der OPTOOUT-PCIe32STANDARD
2.1 Installation der Karte in den Rechner
Achten Sie vor dem Einbau der OPTOOUT-PCIe32 darauf, dass der
Rechner vom Netz getrennt oder zumindest ausgeschaltet ist. Beim Ein-
bau der Interface-Karte in den laufenden Rechner besteht die Gefahr,
dass neben der OPTOOUT-PCIe32 auch andere Karten des PCs oder
Rechners beschädigt oder zerstört werden.
Wählen Sie in Ihrem Rechner einen freien PCIe-Steckplatz in den Sie
dann die Karte einsetzen. Nehmen Sie dazu auch das Benutzerhandbuch
Ihres Computers zu Hilfe. Verschrauben Sie das Slotblech der Platine mit
dem Rechnergehäuse, damit sich die Karte nicht während des Betriebs
unter Einwirkung der Anschlusskabel aus dem Steckplatz lösen kann.

7
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
7
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
77
wasco®wasco®
3. Connectors
3.1 Position of the connector plugs on the board
CN1: Optocoupler Outputs OUT00...OUT31
CN1
17.06.2020 13:38 f=1.50 C:\Daten\Layout\Karten\OPTOOUT-PCIe32U\OPTOOUT-PCIe32_v1.02\OPTOOUT-PCIe32_1v02.brd
3. Anschlussstecker
3.1 Lage der Anschlussstecker auf der Platine
CN1: Optokoppler-Ausgänge OUT00...OUT31
CN1
17.06.2020 13:38 f=1.50 C:\Daten\Layout\Karten\OPTOOUT-PCIe32U\OPTOOUT-PCIe32_v1.02\OPTOOUT-PCIe32_1v02.brd

8
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
8
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
88
wasco®wasco®
3.2 Pin assignment of CN1
Vcc:
Connector for internal voltage source (+ 5V) (a wiring bridge must be soldered on B11),
Never apply an external voltage across this pin.
GND:
Ground connection (only when a wiring bridge is soldered on B12).
GND
GND
OUT31-
OUT30-
OUT29-
OUT28-
OUT27-
OUT26-
OUT25-
OUT24-
OUT23-
OUT22-
OUT21-
OUT20-
OUT19-
OUT18-
OUT17-
OUT16-
OUT15-
OUT14-
OUT13-
OUT12-
OUT11-
OUT10-
OUT09-
OUT08-
OUT07-
OUT06-
OUT05-
OUT04-
OUT03-
OUT02-
OUT01-
OUT00-
Vcc
Vcc
OUT31+
OUT30+
OUT29+
OUT28+
OUT27+
OUT26+
OUT25+
OUT24+
OUT23+
OUT22+
OUT21+
OUT20+
OUT19+
OUT18+
OUT17+
OUT16+
OUT15+
OUT14+
OUT13+
OUT12+
OUT11+
OUT10+
OUT09+
OUT08+
OUT07+
OUT06+
OUT05+
OUT04+
OUT03+
OUT02+
OUT01+
OUT00+
68 34
67 33
66 32
65 31
64 30
63 29
62 28
61 27
60 26
59 25
58 24
57 23
56 22
55 21
54 20
53 19
52 18
51 17
50 16
49 15
48 14
47 13
46 12
45 11
44 10
43 9
42 8
41 7
40 6
39 5
38 4
37 3
36 2
35 1
3.2 Steckerbelegung von CN1
Vcc:
Interne Versorgungsspannung (+ 5V) der PCIe-Karte (nur durch Einlöten einer Drahtbrücke
an B11). Hier niemals eine externe Spannung anlegen.
GND:
Masse des Rechners (nur durch Einlöten einer Drahtbrücke an B12)
GND
GND
OUT31-
OUT30-
OUT29-
OUT28-
OUT27-
OUT26-
OUT25-
OUT24-
OUT23-
OUT22-
OUT21-
OUT20-
OUT19-
OUT18-
OUT17-
OUT16-
OUT15-
OUT14-
OUT13-
OUT12-
OUT11-
OUT10-
OUT09-
OUT08-
OUT07-
OUT06-
OUT05-
OUT04-
OUT03-
OUT02-
OUT01-
OUT00-
Vcc
Vcc
OUT31+
OUT30+
OUT29+
OUT28+
OUT27+
OUT26+
OUT25+
OUT24+
OUT23+
OUT22+
OUT21+
OUT20+
OUT19+
OUT18+
OUT17+
OUT16+
OUT15+
OUT14+
OUT13+
OUT12+
OUT11+
OUT10+
OUT09+
OUT08+
OUT07+
OUT06+
OUT05+
OUT04+
OUT03+
OUT02+
OUT01+
OUT00+
68 34
67 33
66 32
65 31
64 30
63 29
62 28
61 27
60 26
59 25
58 24
57 23
56 22
55 21
54 20
53 19
52 18
51 17
50 16
49 15
48 14
47 13
46 12
45 11
44 10
43 9
42 8
41 7
40 6
39 5
38 4
37 3
36 2
35 1

9
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
9
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
99
wasco®wasco®
4.1 Block diagram
4. System Components
PCIe x1
PCIe Bus
Interface
Control
Logik
+12V
32 Bit Internal Data Bus
+12V 5V
GND
68-pin SCSI-II Socket
Optocoupler Outputs
OUT00...OUT31
Board Identification
4.1 Blockschaltbild
4. Systemkomponenten
PCIe x1
PCIe Bus
Interface
Steuer-
Logik
+12V
32 Bit interner Datenbus
+12V 5V
GND
68polige SCSI-Buchse
Optokopplerausgänge
OUT00...OUT31
Board Identifikation

10
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
10
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1010
wasco®wasco®
4.2 Access to the system components
Access to the hardware components of the OPTOOUT-PCIe32 is made
by reading and writing in Memory Mapped I/O addresses by library func-
tions. The relevant addresses for OPTOOUT-PCIe32 depend on the base
address assigned by the BIOS. You can access to the OPTOIO-PCIe32
by double word access only. For reasons of compatibility the wasco dri-
vers process or take into account the least signicant bytes only.
(Please nd more information in the chapter Programming or in the
samples on the enclosed CD)
PCIe Bus
Interface
Control
Logic
32 Bit PCIe Connector
32/16 Bit
internal
Data Bus
4.2 Zugriff auf die Systemkomponenten
Der Zugriff auf die Hardware-Komponenten der OPTOOUT-PCIe32 er-
folgt durch das Lesen von bzw. Schreiben in Memory-Mapped I/O-Adres-
sen mit Hilfe von Library-Funktionen. Die für die OPTOOUT-PCIe32 rele-
vantenAdressen ergeben sich abhängig von einer vom BIOSvergebenen
Basisadresse. Der Zugriff auf die OPTOOUT-PCIe32 erfolgt ausschließ-
lich im Doppel-Word-Zugriff, wobei die wasco-Treiber-Funktionen aus
Kompatibilitätsgründennurdie beidenniederwertigsten Bytes verarbeiten
bzw. berücksichtigen. (Hinweise hierzu nden Sie im Kapitel Program-
mierung sowie in den Beispielprogrammen auf der mitgelieferten CD).
PCIe Bus
Interface
Steuer-
Logik
32 Bit PCIe Connector
16/32 Bit
interner
Datenbus

11
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
11
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1111
wasco®wasco®
Die OPTOOUT-PCIe32 provides 32 output channels, which are galvani-
cally isolated by optocouplers.
5.2 Optocoupler specications
Voltage collector-emitter: max. 50V
Voltage emitter-collector: 0,1V
Current collector-emitter: 150 mA
5.1 Pin assignment of the output optocouplers
5. 32 Optocoupler Outputs
1
2
4
3
5.3 Output circuitry
OUT..+
OUT..-
Schutzdiode
Optocoupler
DieOPTOOUT-PCIe32verfügtüber32Ausgangskanäle,derengalvanische
Trennung mittels Optokoppler erreicht wird.
5.2 Optokopplerdaten
Spannung-CE: max. 50V
Spannung-EC: 0,1V
Strom-CE: 150 mA
5.1 Pinbelegung der Ausgangsoptokoppler
5. 32 Optokopplerausgänge
1
2
4
3
5.3 Ausgangsbeschaltung
OUT..+
OUT..-
Schutzdiode
Optokoppler

12
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
12
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1212
wasco®wasco®
6. Board Identication
JP1
1 2 3 4 5
0 1 2 3 4
Jumper
Bit
The board Identication enables you to dif-
ferentiate between several PC boards of the
same type in your system. This is realised by
a software readable jumper block.
The board identication to be read consists of one Byte (16 Bit) and is
structured as follows:
„x“ corresponds to „1“, if the Jumper is set, otherwise „0“
Calling the reading command you can read out the setting of the jumper
block JP1. Not used bits are basically „0“, a set or closed jumper will be
read as „1“ .
For example:
(Jumper 1 and 3 set)
Result of the reading command: $05
Bit 31....876543210
Jumper 54321
Board ID Register 0 0 0 0 0 0 0 x x x x x
JP1
6.1 Board Identication
6. Board-Identikation
JP1
1 2 3 4 5
0 1 2 3 4
Jumper
Bit
Die Board-Identifikation dient zur Unter-
scheidung mehrerer PC-Karten gleichen
Typs im Computer. Sie erfolgt durch einen
Jumperblock, welcher per Software gelesen
werden kann.
Die zu lesende Board-Identikation besteht aus einem Byte (8 Bit) und ist
wie folgt aufgebaut:
„x“ entspricht „1“, wenn der Jumper gesetzt ist, sonst „0“
Mittels des Lesebefehls kann die Jumperstellung des Jumperblocks JP1
ausgelesen werden. Die nicht benützten Bits sind grundsätzlich „0“, ein
gesetzter Jumper wird als „1“ gelesen.
z.B.
(Jumper 1 und 3 gesetzt)
Ergebnis des Lesebefehls: $05
Bit 31....876543210
Jumper 54321
Board ID Register 0 0 0 0 0 0 0 x x x x x
JP1
6.1 Board-Identikation

13
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
13
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1313
wasco®wasco®
6.2 Access via 16 or 32 bit
The jumper block JP2/1-2 can be used to set the access width.
If the jumper block JP2/1-2 is not set (default), the card operates in com-
patibility mode. In this mode, the card is accessed in 16-bit mode.
Furthermore,theoffsetaddressesofthePCIcardOPTOOUT-PCI32STANDARD
are effective with factor 2.
If the jumper is set, the card operates in 32-bit mode and therefore is fully
compatible with other PCIe cards in offset addressing.
The offset addresses of both of the modes are covered in chapter 7.5
„Assignment of the Memory Mapped I/O Addresses“
JP2
2 4 6 8 10
1 3 5 7 9
Jumper
JP2
2 4 6 8 10
1 3 5 7 9
Jumper
16-Bit mode 32-Bit mode
6.2 Zugriff mit 16 oder 32 Bit
Mit Hilfe des Jumperblocks JP2/1-2 kann die Zugriffs-Datenbreite einge-
stellt werden.
Ist der Jumperblock JP2/1-2 nicht gesetzt (Default), so funktioniert die
Karte im Kompatibilitätsmodus. In diesem Modus wird im 16-Bit-Modus
aufdieKartezugegriffen.ZudemgeltendieOffset-AdressenderPCI-Karte
OPTOOUT-PCI32STANDARD mit dem Faktor 2.
Ist der Jumper gesetzt, so funktioniert die Karte im 32-Bit-Modus und ist
bei der Offset-Adressierung kompatibel mit anderen PCIe-Karten.
Die Offset-Adressen der beiden Modi sind im Kapitel 7.5 „Zuordnung der
Memory-Mapped I/O-Adressen“ beschrieben.
JP2
2 4 6 8 10
1 3 5 7 9
Jumper
JP2
2 4 6 8 10
1 3 5 7 9
Jumper
16-Bit-Modus 32-Bit-Modus

14
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
14
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1414
wasco®wasco®
7. Programming under Windows®
7.1 Installing the Windows®driver
In order to implement the card under Windows®, it is necessary to install
a special driver, which allows access to the card. The operating system
under Windows®10, 8 and 7 automatically reports after starting the PC,
that a new hardware component has been found. In this case, insert the
data medium and instruct to the system to install the driver les herefrom.
If the operating system does not respond, the driver also can be installed
in the Device Manager.
7.2 Installing the Windows® development les
For installation of the development les, please run the „Setup.exe“ le
in the folder driver on the accompanying CD and follow the installation
instructions.
7. Programmierung unter Windows®
7.1 Installation des Windows®Treibers
Für die Anwendung der Karte unter Windows®ist es notwendig, einen
speziellen Treiber zu installieren, der den Zugriff auf die Karte ermöglicht.
Unter Windows®10, 8 und 7 meldet das Betriebssystem selbständig nach
dem Einschalten des PCs, dass eine neue Hardware-Komponente ge-
funden wurde. In diesem Fall legen Sie den Datenträger ein und weisen
das System an, von diesem die Treiber-Dateien zu installieren. Sollte sich
das Betriebssystem nicht melden, kann der Treiber auch im Gerätemana-
ger installiert werden.
7.2 Installation der Windows®Entwicklungsdateien
Zur Installation der Windows®Entwicklungsdateien führen Sie bitte die
Datei "Setup.exe" im Ordner Treiber auf der mitgelieferten CD aus und
folgen Sie den Installationsanweisungen.

15
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
15
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1515
wasco®wasco®
Once the driver and development les have been installed completely,
you will nd an icon in the control panel of your computer to localize all
wasco®PCI and PCIe cards existing in the system.
Wurden die Treiber- und Entwicklungsdateien vollständig installiert, n-
den Sie in der Systemsteuerung Ihres Rechners ein Icon zur Lokalisie-
rung aller im System vorhandenen wasco®PCI- und PCIe-Karten.

16
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
16
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1616
wasco®wasco®
Startthecardquerybydouble-clickingthe„wasco®“icon.Followingwindow
appears: (An OPTOIO-PCIe16STANDARD is used as an example)
Ifyourcardhasbeendetectedinthesystem,theboardname,theBoard-ID,
the I/O address as well as the possible interrupt number of the respective
card are displayed in this window. Furthermore, the driver version and the
location of the driver le can be queried via the „Information“ tab.
StartenSiedie Kartenabfragedurch einen Doppelklickauf das"wasco®“-
Icon. Folgendes Fenster erscheint: (Als Beispiel wurde hier eine OPTO-
IO-PCIe16STANDARD verwendet)!
Wurde Ihre Karte im System erkannt, wird der Kartenname, Board ID,
I/O-Adresse sowie die mögliche Interruptnummer für die jeweilige Karte
in diesem Fenster angezeigt. Desweiteren kann über den Reiter "Infor-
mation" die Treiber-Version sowie der Standort der Treiberdatei abgefragt
werden.

17
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
17
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1717
wasco®wasco®
If your card was not detected, following error message will be displayed:
Please find more about the possible causes in the chapter
Troubleshooting.
7.3 Programming the OPTOOUT-PCIe32 with wasco®driver
After installing the development les of Kithara by means of the setup
program the folder wasco contains of the relevant development les and
the sample programs. Further sample programs specied for access to
the OPTOOUT-PCIe32 you can nd on the enclosed CD or please visit
our homepage.
Programming the hardware components of the OPTOOUT-PCIe32 is
realized by access to Memory Mapped I/O addresses which depend on
the base address assigned by the system‘s BIOS for the OPTOOUT-
PCIe32. Find a more detailed description for programming in the driver
documentation.
Wurde Ihre Karte im System nicht erkannt, wird folgende Fehlermeldung
angezeigt:
Informieren Sie sich im Kapitel Fehlersuche über die möglichen Ursa-
chen!
7.3 Programmierung der OPTOOUT-PCIe32 mit wasco®-Treiber
Nach Installation der Entwicklungsdateien von Kithara mittels des Setup-
Programms benden sich in dem Ordner wasco die entsprechenden
Entwicklungsdateien sowie die Beispielprogramme. Weitere Beispiel-
programme, speziell für den Zugriff auf die OPTOOUT-PCIe32, benden
sich auf der beiliegenden CD sowie auf unserer Homepage.
Die Programmierung der Hardwarekomponenten der OPTOOUT-PCIe32
erfolgt durch den Zugriff auf Memory Mapped I/O-Adressen, die sich ab-
hängig von der vom BIOS des Sytems für die OPTOOUT-PCIe32 ver-
gebenen Basisadresse ergeben. Eine genauere Beschreibung zur Pro-
grammierung bendet sich in der Treiberdokumentation.

18
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
18
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1818
wasco®wasco®
7.4 Access to the card OPTOOUT-PCIe32Standard
The access to the OPTOOUT-PCIe32Standard is done exclusively via board
name (card type) WASCO-PCIe8246
7.5 Assignment of the Memory Mapped I/O Addresses
The Memory Mapped I/O addresses of the individual hardware compon-
ents depend on the base address as follows:
Port/Register BA + Offset RD/WR
Optocoupler Output Port A BA + $40 RD/WR
(OUT00...OUT016)
Optocoupler Output Port B BA + $44 RD/WR
(OUT16...OUT31)
Board Identication BA+ $3E0 RD
Attention! The driver‘s offset constants work directly only for the PCI
cards. We recommend using the offsets instead of the constants when
programming.
Port/Register BA + Offset RD/WR
Optocoupler Output Port A BA + $8 RD/WR
(OUT00...OUT31)
Board Identication BA+ $FF8 RD
16-bit mode
32-bit mode
7.4 Zugriff auf die Karte OPTOOUT-PCIe32Standard
DerZugriffaufdieOPTOOUT-PCIe32Standard erfolgtausschließlichüberden
Boardnamen (Kartentyp) WASCO-PCIe8246
7.5 Zuordnung der Memory Mapped I/O-Adressen
DieMemoryMappedI/O-AdressendereinzelnenHardware-Komponenten
ergeben sich abhängig von der Basisadresse wie folgt:
Port/Register BA + Offset RD/WR
Optokoppler-Ausgangsport A BA + $40 RD/WR
(OUT00...OUT016)
Optokoppler-Ausgangsport B BA + $44 RD/WR
(OUT16...OUT31)
Board Identikation BA+ $3E0 RD
Achtung! Die Offset-Konstanten des Treibers funktionieren direkt nur für
die PCI-Karten. Wir empfehlen bei der Programmierung die Offsets statt
der Konstanten zu verwenden.
Port/Register BA + Offset RD/WR
Optokoppler-Ausgangsport A BA + $8 RD/WR
(OUT00...OUT31)
Board Identikation BA+ $FF8 RD
16-Bit-Modus
32-Bit-Modus

19
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
19
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
1919
wasco®wasco®
7.6 Compatibility to the OPTOOUT-PCI32STANDARD
Developping the OPTOOUT-PCIe32STANDARD and its drivers special regard
wasattendedtouseidenticalaccessesastotheOPTOOUT-PCI32STANDARD.
This enables you to change over from PCI to PCIe with existing programs
in a very easy way. The driver (as from version 8.02) can be used for both
PCI and PCIe.
What has been changed and what has to be changed respectively for the
PCIe board:
1. The board‘s name now is not „OPTOOUT-PCI32STANDARD“ but
„WASCO-PCIe8246“
2. The functions to access to the port addresses for the PCIe board are
given as „wasco_outputPCIeW“ and „wasco_inputPCIeW“
3. The offsets to access to the Memory Mapped I/O addresses have
changed. The former offsets have to be multiplied by two for the PCIe
card. (Unchanged Constants are usable for PCI only).
4. The setting of jumper block JP1 can be monitored via an additional
address. The jumper can be used for example for the identication
of the OPTOOUT-PCIe32STANDARD when using several cards in the PC.
7.6 Kompatibilität zur OPTOOUT-PCI32STANDARD
Bei der Entwicklung der OPTOOUT-PCIe32STANDARD sowie dem dazuge-
hörigen Treiber wurde speziell darauf geachtet, dass der Zugriff auf die
Karte möglichst identisch mit der OPTOOUT-PCI32STANDARD ist. Dies er-
möglicht einen relativ einfachen Umstieg von PCI- auf PCIe-Karten bei
bestehenden Programmen. Der Treiber (ab Version 8.02) ist sowohl für
PCI als auch für PCIe verwendbar.
Was hat sich geändert bzw. was muss für die PCIe-Karte geändert wer-
den:
1. Der Board-Name ist nicht mehr „OPTOOUT-PCI32STANDARD“ sondern
„WASCO-PCIe8246“
2. Die Funktionen zum Zugriff auf die Portadressen sind für die PCIe-
Karte „wasco_outputPCIeW“ und „wasco_inputPCIeW“
3. Die Offsets für den Zugriff auf die Memory Mapped I/O-Adressen
haben sich geändert. Für die PCIe-Karte müssen die alten Offsets mit
zwei multipliziert werden. (Die Konstanten sind unabgeändert nur für
die PCI-Karten verwendbar).
4. Über eine zusätzliche Adresse kann die Einstellung des Jumperblocks
JP1 abgefragt werden. Dieser kann zum Beispiel für die Identikation
der OPTOOUT-PCIe32STANDARD bei der Nutzung von mehreren Karten
im PC genutzt werden.

20
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH DV01
20
OPTOOUT-PCIe32STANDARD © 2019 by Messcomp Datentechnik GmbH EV01
2020
wasco®wasco®
8. Programming under Linux®
For using the card under Linux® , an Linux wasco®driver is provided on
the accompanying CD or on our website. It is available in code form and
can be changed and customized by the user at any time.
8.1 Installing the Linux®driver
ToaccessthecardunderLinux®,aspecialdriverisrequiredtobeinstalled.
In this purpose, insert the data medium and copy the folder of the Linux
driver to your system. To install the driver, follow the instructions in the
readme le
8.2 Supported Linux distributions/kernel versions
The wasco®driver has been tested in the following environments:
Ubuntu®18.04.4 LTS (Kernel: 5.3.0)
8.3 Programming of the OPTOOUT-PCIe32 with wasco®driver
The programming of the hardware components of the OPTOOUT-PCIe32
is done by accessing the Memory Mapped I/O addresses, which depend
on the base address assigned by the system‘s BIOS for the OPTOOUT-
PCIe32.
Thefunctionspreadundpwriteareusedfortheaccess.Usingtheprogram-
ming languages C und C/C++, no further external libraries are required.
Examples for the exact access to the OPTOOUT-PCIe32 can be found on
the accompanying CD or on our homepage.
8. Programmierung unter Linux®
Für die Anwendung der Karte unter Linux® wird auf der mitgelieferten CD
oderaufunsererWebseiteeinLinuxwasco®-TreiberzurVerfügunggestellt.
Dieser liegt in Code-Form vor und kann daher auch jederzeit vom Kunden
geändert und angepasst werden.
8.1 Installation des Linux®Treibers
UnterLinux®istesfürdenZugriffaufdieKartenotwendig,einenspeziellen
Treiberzuinstallieren,derdenZugriffaufdieKarteermöglicht.Dafür legen
Sie den Datenträger ein und kopieren den Ordner des Linux-Treibers auf
ihr System. Zur Installation folgen Sie den Angaben im readme-File
8.2 Unterstützte Linux-Distributionen/Kernelversionen
Der wasco®-Treiber wurde in folgenden Umgebungen getestet:
Ubuntu®18.04.4 LTS (Kernel: 5.3.0)
8.3 Programmierung der OPTOOUT-PCIe32 mit wasco®-Treiber
Die Programmierung der Hardwarekomponenten der OPTOOUT-PCIe32
erfolgt durch den Zugriff auf Memory Mapped I/O-Adressen, die sich
abhängig von der vom BIOS des Sytems für die OPTOOUT-PCIe32 ver-
gebenen Basisadresse ergeben.
Der Zugriff ndet über die Funktionen pread und pwrite statt. Dabei
werden unter der Programmiersprache C und C/C++ keine weiteren
externen Libraries benötigt. Beispiele für den genauen Zugriff auf die
OPTOOUT-PCIe32 benden sich auf der beiliegenden CD sowie auf
unserer Homepage.
Table of contents
Other Wasco Computer Hardware manuals