Rockwell Automation 1747-PCIS API Software - Open Controller - Manual (Page 9)

i Publication 1747-UM002A-US-P - June 2000
Table of Contents
Chapter 1
Overview Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Relationship to the Open Controller. . . . . . . . . . . . . . . . . . 1-1
Interface API to the Scanner . . . . . . . . . . . . . . . . . . . . . . . 1-2
API Software for DOS . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
API Software for Windows NT . . . . . . . . . . . . . . . . . . . 1-3
Understanding the 1746 I/O PCI Interface Architecture . . . . 1-4
Understanding the Open Controller Architecture . . . . . . . . 1-4
Common Attributes of the 1746 I/O PCI Interface and 1747
Open Controller Architectures . . . . . . . . . . . . . . . . . . . 1-5
Scanner Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Checking LED Indicators . . . . . . . . . . . . . . . . . . . . . . . 1-7
STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Installing the DOS API . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Installing the Windows NT API . . . . . . . . . . . . . . . . . . . . . 1-8
Installation Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Uninstalling the Windows NT API. . . . . . . . . . . . . . . . . 1-10
Chapter 2
Using the API Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Programming Conventions . . . . . . . . . . . . . . . . . . . . . . . . 2-2
DOS Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Windows NT Considerations . . . . . . . . . . . . . . . . . . . . 2-3
Tools to Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Sample DOS MAKE file for Borland compilers. . . . . . . . 2-4
Sample DOS MAKE file for Microsoft compilers. . . . . . . 2-5
Sample Windows NT MAKE file for Microsoft compilers 2-6
Sample Windows NT MAKE file for Borland compilers . 2-8
Chapter 3
Developing Applications Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
How the API Functions Are Organized. . . . . . . . . . . . . . . . 3-1
Programming Sequence. . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Access the scanner. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Initialize the scanner . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Configure the scanner . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Control scanner operation . . . . . . . . . . . . . . . . . . . . . . 3-4
Scan I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Programming Example for DOS . . . . . . . . . . . . . . . . . . . . . 3-5
Programming Example for Windows NT . . . . . . . . . . . . . . 3-11
Handling Interrupt Messages . . . . . . . . . . . . . . . . . . . . . . . 3-17
Handling Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
Determining Partition Sizes for Shared Memory . . . . . . . . . 3-18