BB Electronics Barcode Reader 232OPSDA User Manual

Not Recommended for New Installations.

Please contact Technical Support for more information.

Optically Isolated Serial

Data Acquisition Module

232OPSDA Module

Documentation Number 232OPSDA1397

This product

Designed and Manufactured

In Ottawa, Illinois

USA

of domestic and imported parts by

B&B Electronics Mfg. Co. Inc.

707 Dayton Road -- P.O. Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Internet:

http://www.bb-elec.com

[email protected]

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

Cover Page

PH (815) 433-5100 -- FAX (815) 433-5105

APPENDIX A: DEC TO HEX TO ASCII CONVERSION.......... A-27

APPENDIX B: 232OPSDA SCHEMATIC & BOARD .................B-29

Table of Contents

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Chapter 1: Introduction

232OPSDA Features

The 232OPSDA is an optically isolated data acquisition module

that is connected to your computer’s RS-232 serial port. It provides

2500V of optical isolation protection between the I/O and RS-232

side of the module. The 232OPSDA offers six channels of 12-bit

A/D, one digital input, and one digital output. The six A/D input

channels can be used for a number of applications. One A/D

channel can read a 4-20mA analog current, two buffered channels

read voltages between 0 and 5V, two non-buffered channels read

voltages between 0 and 5V, and one channel can read voltages

between 0 and 10V.

The 232OPSDA connects to your computer’s RS-232 serial port

through a DB-25S (female) connector. The module automatically

detects baud rates from 1,200 to 9,600. A data format of 8 data bits,

1 stop bit, and no parity is used.

The RS-232 side of the 232OPSDA is port powered. Power is

drawn from RTS and DTR regardless of whether they are asserted

HIGH or LOW. In addition, an isolated external power supply is

required to power the I/O side of the module. Both port-powering

and the external power supply are required. The 232OPSDA

requires a power supply that produces 9-16VDC @ 10mA (not

including power consumption of external devices).

Figure 1.1: 232OPSDA Module

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Terminal Blocks

TB 7

TB 6

Digital Input

Digital Output

Optical Isolation

Microprocessor

Serial Port

DB-25S

A/D Converter

TB 4

TB 5

A/D 4

A/D 5

RS-232

Tranceiver

TB 0

TB 1

TB 2

TB 3

A/D 0

A/D 1

Signal

A/D 2

Conditioning

A/D 3

Circuitry

Figure 1.2: General Block Diagram

Packing List

Examine the shipping carton and the contents for physical

damage. The following items should be in the shipping carton:

1. 232OPSDA module

2. One 232OPSDA 3.5” disk

3. This instruction manual

If any of these items are missing or damaged, contact B&B

Electronics immediately.

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Software Installation

The 232OPSDA comes with several a demonstration program.

To install these programs on your hard drive:

1. Place the disk in drive A.

2. Type A: and press the <ENTER> key.

3. Type INSTALL and press the <ENTER> key.

4. Follow the instructions given by the program.

The file, READ.ME, contains corrections and additions to the printed

user’s manual. The file, FILES.LST, contains a list and description of

the files installed on the hard drive. The file, HISTORY.LST,

contains a historic description of the 232OPSDA.

232OPSDA Specifications

Analog to Digital Converter

Resolution:

12 bit

Channels:

A/D Connections:

4-20mA channel:

Terminal Blocks

Input Resistance:

10Ω

Input Offset voltage:

Input Offset Voltage Drift:

Signal Conditioning Error:

0 to 5V Buffered Input Channels:

Input Resistance:

1500µV

0.5µV/°C

±3% of output

1TΩ

Input Offset voltage:

1500µV

0.5µV/°C

±1% of output

200KΩ

1500µV

0.5µV/°C

±1% of output

Input Offset Voltage Drift:

Signal Conditioning Error:

0 to 10V Input Channel:

Input Resistance:

Input Offset voltage:

Input Offset Voltage Drift:

Signal Conditioning Error:

0 to 5V Non-buffered Input Channels: 2

Input Offset voltage:

1500µV

Input Offset Voltage Drift:

Total Unadjusted Error:

0.5µV/°C

±1.75LSB

Non-buffered A/D input channels must be driven from a

source impedance less than 1KΩ.

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Digital Input

Channels:

Voltage Range:

Low Voltage:

High Voltage:

Leakage Current:

-30VDC to +30VDC

-30VDC to 1.0VDC

2.0VDC to 30VDC

1 µA maximum

Digital Output

Channels:

Low Voltage:

High Voltage:

0.6VDC @ 8.7mA

4.3VDC @ -5.4mA

Power Supply

Input Voltage:

9-16VDC @ 10mA (Does not include the

power consumption of external devices.)

Terminal Blocks

Connections:

Communications

Standard:

Baud Rate:

Format:

RS-232 (unit is DCE)

1,200 to 9,600 (automatic detection)

8 data bits, 1 stop bit, no parity

Isolation Protection: 2500V (Power supply not considered)

Port Power:

Connections:

RTS and DTR (either state)

DB-25S (female)

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Chapter 2: Connections

This chapter will cover the connections required for the

232OPSDA. Four sets of connections are required: A/D converter,

digital I/O, serial port, and power supply connections. Do not make

any connections until you have read this chapter. If you do not use a

particular type of connection, it is still important to read each section.

Table 2.1 shows the terminal block assignments.

Table 2.1: Terminal Block Assignments

Terminal

Block

TB 0

Function

Description

A/D 0

A/D 1

A/D 2

A/D 3

A/D 4

A/D 5

4-20mA Current Loop Input Channel*

Buffered 0 to 5V A/D Channel**

Buffered 0 to 5V A/D Channel

0 to 10V A/D Channel

Non-buffered 0 to 5V A/D Channel

TB 1

TB 2

TB 3

TB 4

TB 5

TB 6

Digital out Digital Output

TB 7

GND

Digital in

GND

Digital Input

Ground

+12VDC

Power Supply Connection

* The current loop input uses a non-inverting amplifier that has a

gain of 23.064. Space for through-hole resistors is provided to

change the gain. By decreasing the gain, currents up to 100mA can

be read with A/D 0.

** This A/D input uses a voltage follower circuit. Spaces for through-

hole resistors are provided to convert the voltage follower into a non-

inverting amplifier with gain > 1.

A/D Connections

The A/D connections are made on the I/O port which consists of

ten terminal blocks. Terminal Blocks 0-5 are A/D channels 0-5.

These six A/D channels are referenced to GND (terminal block 8).

The 4-20mA Current Loop A/D channel requires connections

different from the other five channels, so two different diagrams are

shown for required A/D connections. Figure 2.1 shows the

connections required for the 4-20mA Current Loop channel (A/D 0),

and Figure 2.2 shows the connections required for A/D channels 1-

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

RS-232 Port

232OPSDA

Output

Input

Out

4-20mA

Current Loop

Transmitter

Return

4-20mA Current

Loop

4-20mA

Current Loop

Receiver

Figure 2.1: Current Loop Channel Connections (A/D 0)

NOTE: When using the 4-20mA Current Loop Input with the setup

shown in Figure 2.1, A/D 1-5 cannot be used and should be

connected to the terminal block labeled GND.

TB 1

A/D 1

A/D 2

A/D 3

A/D 4

A/D 5

A/D 0

GND

0 to 5VDC Input

0 to 10VDC Input

0 to 5VDC Input

TB 2

TB 3

TB 4

TB 5

TB 0

TB 8

GND

Figure 2.2: Required Connections for A/D 1- A/D 5

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Digital I/O Connections

The digital I/O connections are made on the I/O port, which

consists of terminal blocks. Table 2.1 shows the terminal block

assignments.

Digital Input

Terminal block 7 is the digital input line. This input is CMOS/TTL

compatible and can handle voltage from -30VDC to 30VDC. If a

digital input is from -30VDC to 1.0VDC, the state will be read as a

“0” (LOW). If a digital input is from 2.0VDC to 30VDC, the state will

be read as a “1” (HIGH). If the digital input is not used, it should be

connected to GND. Figure 2.3 show the connections required for the

digital input.

Digital Output

Terminal Block 6 is the digital output line. This line is CMOS/TTL

compatible. When the digital output is set to “0” (LOW), the output

voltage will be between 0 and 0.6VDC. When the digital output is set

to “1” (HIGH), the output voltage will be between 4.3VDC to 5.0VDC.

Figure 2.3 shows the connections required for the digital output.

TB 6

Digital Output

Digital Input

0 to 5VDC Output

-30VDC to 30VDC Input

To Device GND

TB 7

TB 8

GND

Figure 2.3: Digital I/O Required Connections

Serial Port Connections

In order to communicate with the 232OPSDA module it must be

connected to an RS-232 serial port. The unit automatically detects

baud rates from 1,200 to 9,600. A data format of 8 data bits, 1 stop

bit and no parity is used. The 232OPSDA is configured as a DCE

device (See Table 2.2). If your communications equipment is

configured as a DTE device, such as a standard IBM PC serial port,

the 232OPSDA should be connected using a “straight through” DB-

25 cable or a standard DB-9 to DB-25 cable adapter as shown in

Table 2.3. If your communications equipment is configured as a

DCE device, such as a modem, the 232OPSDA should be

connected using a “null modem” cable (See Table 2.4).

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Table 2.2 - RS-232 Connector Pinout

DB25S

Pin #

232OPSD

A Function

Signal

Notes

Transmit Data (TD)

Receive Data (RD)

Request to Send (RTS)

Clear to Send (CTS)

Input

Output

Input

Connection is required.

Used for power.

Internally connected to

RTS (pin 4).

Data Set Ready (DSR)

Internally connected to

DTR (pin 20).

Signal Ground (SG)

Data Carrier Detect (DCD)

Connection is required.

Internally connected to

to DTR (pin 20).

Signal Ground (SG)

Data Terminal Ready

(DTR)

Input

Used for power.

Optional Power Supply

Connection

Connect Power Supply

to this pin if RTS and

DTR are not available

Table 2.3 - 232OPSDA To DTE Connections

232SPDA

DTE DB-25

DTE DB-9

Pin #

Signal

Connection

Transmit Data (TD)

Receive Data (RD)

Request to Send (RTS)

Clear to Send (CTS)

Data Set Ready (DSR)

Signal Ground (SG)

Data Carrier Detect (DCD)

Data Terminal Ready (DTR)

Table 2.4 - 232OPSDA To DCE Connections

232OPSDA

Pin #

DCE DB-25

Connection

DCE DB-9

Connection

Signal

Transmit Data (TD)

Receive Data (RD)

Request to Send (RTS)

Clear to Send (CTS)

Data Set Ready (DSR)

Signal Ground (SG)

Data Carrier Detect (DCD)

Data Terminal Ready (DTR)

N/C

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Power Supply Connections

The 232OPSDA requires an isolated external power supply that

is able to produce 9-16VDC @10mA in addition to the port power.

The positive(+) lead of the power supply is connected to the terminal

block labeled +12VDC and the negative(-) lead is connected to the

terminal block labeled GND. The external power supply powers the

I/O side of the module. The RS-232 side of the module is port

powered using RTS and DTR. These lines may be either LOW or

HIGH to provide power to the module. The two sources of power are

required for optical isolation.

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Chapter 3: Commands

Only three commands are required to operate the 232OPSDA:

the read A/D command, read digital I/O command, and the set

digital output command. The command string consists of four bytes.

The read A/D and digital I/O commands require an additional data

byte. See Table 3.1.

Table 3.1: 232OPSDA Commands

Function

Command Response

Read A/D !0RA{#}

Channels

{ch#msb}{ch#lsb}{ch(#-1)msb}…

{ch0msb}{ch0lsb}

Read

!0RD

{I/O states}

Digital I/O

Set Digital !0SO{#}

Output

no response

NOTE: Each {…} represents one byte.

In addition to the commands mentioned above, an extended set

of commands are provided that support bit-error identification.

These commands use the “#” character in place of the “!” character,

and the compliment of the data byte must be sent after the data

byte. The extended commands are shown in table 3.2.

Table 3.1: 232OPSDA Commands

Function

Command

Response

Read A/D #0RA{#}~{#} {ch#msb}~{ch#msb}{ch#lsb}{ch#lsb}

Channels

{ch(#-1)msb}~{ch(#-1)msb}….{ch0msb}

~{ch0msb}{ch0lsb}~{ch0lsb}

{I/O states}~{I/O states}

Read

#0RD

Digital I/O

Set Digital #0SO{#}~{#} no response

Output

NOTE: ~{…} represents the complement of one byte.

Before going into the specifics of each command, it is important

to understand that a byte has a value from 0 to 255 and can be

represented in decimal (0 to 255), hexadecimal (00 to FF), or by an

ASCII character. The commands in Table 3.1 are shown in ASCII,

for example: “!0RD”. The decimal and hexadecimal equivalents of

some ASCII characters are shown in Table 3.2. Notice that the

ASCII representation of the character “0” does not have a value of 0.

Refer to Appendix A for more ASCII, decimal, and hexadecimal

equivalents.

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Table 3.2 - Equivalent Values

ASCII Decimal Hexadecimal

NUL

SOH

STX

ETX

EOT

ENQ

ACK

BEL

21h

23h

30h

41h

44h

4Fh

52h

53h

Syntax

As mentioned earlier, the command string consists of four bytes.

The first byte is the start of message byte. The start of message

byte is always the “!” character. The second byte is the address byte.

This byte allows each unit to have a unique address (useful in RS-

485 networks). Since the 232OPSDA uses RS-232 communications,

this byte is the ASCII “0” (zero) character and cannot be changed.

The next two bytes are the command characters. These bytes are

used to specify which command will be executed by the module.

Some commands require a fifth byte, a data byte.

Command Syntax: ! 0 _ _ _

| | | | |

| | | | Data Byte

| | | 2^ndcommand Byte

| | 1^stCommand Byte

| Address Byte

Start of Message Byte

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

The command syntax for the extended command set is shown

below:

Command Syntax: # 0 _ _ _ _

| | | | | |

| | | | Data Byte

| | | 2^ndCommand Byte

| | 1^stCommand Byte

| Address Byte

Start of Message Byte

Reading A/D Channels Command

The Read A/D channels command returns two bytes for each

channel read. The two bytes represent the most significant byte

(MSB) and least significant byte (LSB) of the reading. The MSB is

received first, followed by the LSB. This command requires a data

byte. The data byte is used to specify the number of the highest

channel to be read. All channels less than this channel will be read

as well. For example, if the data byte has a value of 3, then channels

0 to 3 will be read. The highest channel is read first.

Command Syntax

!0RA{#}

Where “{#}” is a byte that specifies the number of the highest

channel to be read. See Table 3.3

Response Syntax

{ch(#)MSB}{ch(#)LSB}{ch(#-

1)MSB}...{ch0MSB}{ch0LSB}

The most significant byte of the channel specified is received

first. The least significant byte and the lower channels will follow in

descending order. “{chxMSB}” and “{chxLSB}” represent the most

and least significant bytes of the A/D conversion result.

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Table 3.3 - Read A/D Response

# of Channels Specified Response

Channels Returned

(order of response)

Bytes

Returned

decimal

Hex

ASCII

NUL

SOH

STX

ETX

EOT

ENQ

Channel 0

Channels 1,0

Channels 2,1,0

Channels 3,2,..,0

Channels 4,3,..,0

Channels 5,4,..,0

NOTE: There are three test channels that can be read: Ref+, Ref-,

and Ref+/2. Specify 13 (0Dh) to read Ref+, 12 (0Ch) to read Ref-,

and 11 (0Bh) to read Ref+/2.

Reading Digital I/O Command

The Read Digital I/O command returns a byte which represents

the state of the digital input and digital output. Bit 0 corresponds to

the state of the digital output, and bit 3 corresponds to the state of

the digital input. If a bit is a 0 then the digital state of that digital I/O is

LOW. If a bit is a 1 then the digital state of the I/O is HIGH. NOTE:

Bits 1-2 and 4-7 of the data byte are ignored.

Command Syntax

!0RD

Unit Response

{states}

Where {states} is a byte in which bits 0 corresponds to the current

state of the digital output and bit 3 corresponds to the current state

of the digital input.

Set Digital Output Command

The Set Digital Output command is used to set the state of the

digital output line. This command requires a data byte. The data byte

is used to specify the output state. Bits 0 corresponds to the state of

the digital output. If bit 0 is a 0 then the output will be set LOW. If bit

0 is a 1 then the output will be set HIGH. NOTE: This command

ignores bits 1-7 of the data byte.

Command Syntax

!0SO{states}

Where {states} is a byte in which bit 0 corresponds to the output

state of the digital outputs.

Unit Response

no response

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Chapter 4: A/D

This chapter will deal with the various A/D channels and

manipulating the data obtained from them.

Sampling Rate

The A/D converter has

conversion time around 10

microseconds, however, the actual sampling rate is limited by the

serial communications. The actual sampling rate for a single

channel is around 120 samples per second (9600 baud). This rate

drops to around 41 samples per second when sampling all of the

channels. When reading an A/D input, the 232OPSDA takes four

readings and returns the average (0.5 and greater are rounded up)

of these readings. This averaging helps filter out noise.

A/D Converter Range

The actual A/D converter chip in the 232OPSDA is a 12 bit A/D

converter that can read analog voltages between 0 and 5VDC.

However, the 232OPSDA contains signal conditioning circuitry that

allows you to measure voltages from 0 to 10VDC (Gain = 0.5) as

well as other ranges. In the following sections, each channel

configuration will be covered.

Non-buffered 0 to 5VDC A/D Inputs

The 232OPSDA has two non-buffered 0 to 5V inputs. They are

A/D 4 on Terminal Block 4 and A/D 5 on Terminal Block 5. The

voltage applied to the Terminal Blocks is the voltage that is read by

the A/D converter chip. The driving source impedance should be

less than 1KΩ for these two channels.

Buffered 0 to 5V A/D Inputs

The 232OPSDA has two buffered 0 to 5V inputs. They are A/D 1

on Terminal Block 1 and A/D 2 on Terminal Block 2. An operational

amplifier is setup as a voltage follower to buffer the A/D converter

from the source of the voltage. The input resistance of each of these

channels is 1TΩ. This allows you to have a large source impedance.

Both A/D 1 and A/D 2 are set up as voltage followers with a gain

of 1 when they leave the factory. However, the voltage follower for

A/D 1 (TB 1) has spaces for optional through hole resistors. This

allows you to reconfigure A/D 1 into a non-inverting amplifier

configuration. A non-inverting amplifier can have a gain greater than

1. See the circuit schematic in Figure B.1 and board layout in Figure

B.2 in Appendix B. To change the voltage follower into a non-

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

inverting amplifier, remove R15 and calculate values for R13 and

R14 using the equation below.

V₀

R13

R14

Gain =

= 1+

Vin

NOTE: V is the voltage read by the A/D converter chip, and Vin is

the voltage at TB1. R13 and R14 should be chosen so that V does

not exceed 5.00VDC.

0 to 10VDC A/D Input

The 232OPSDA contains one A/D input than is capable of

handling voltages between 0VDC and 10VDC. This channel is A/D 3

and is located on Terminal Block 3. The gain of the signal

conditioning circuitry for this channel is 0.5. If 10VDC is applied to

Terminal Block 3, the A/D Converter chip will read 5.00V. The input

resistance of this channel is 200KΩ, so the driving source

impedance should be less than 1KΩ to minimize voltage division

error.

4-20mA Current Loop A/D Input

The 232OPSDA has one A/D channel capable of monitoring the

loop current in a 4-20mA analog current loop. See figure B.1 in

Appendix B for a circuit schematic. A 10Ω resistor is connected

between TB 0 and GND inside the 232OPSDA. The voltage drop

across this resistor is proportional to the current in the current loop.

With the original configuration, the following equation can be used to

convert the voltage read by the A/D converter chip to the actual

current in the loop. The value 23.064 is the gain of the signal

conditioning circuitry

1000 × AD₀

(

)

LoopCurrent mA =

23.064 ×10Ω

NOTE: AD is the voltage read by the A/D converter chip. This

voltage is between 0 and 5.00VDC.

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

The signal conditioning circuit for this A/D input channel has been

designed to be easily modified. In the original configuration, R5 and

R6 are left OPEN (they are not present). These two spaces are

provided if you need a different gain. Reducing the gain of this non-

inverting amplifier allows you to measure currents up to 100mA, and

increasing the gain allows you to read much smaller currents with

greater accuracy. See the circuit schematic in Figure B.1 and board

layout in Figure B.2 in Appendix B.

To change the gain of this non-inverting amplifier, remove R8

and R9, and calculate values for R4 and R5 using the equation

below.

V₀

Gain =

= 1+

10 × LoopCurrent

NOTE: V is the voltage read by the A/D converter and (10 x loop

current) is the voltage drop across the 10Ω resistor. R4 and R5

should be chosen so that V does not exceed 5.00VDC.

NOTE: Decreasing the gain allows you to measure larger currents,

but the maximum current that can be read is 100mA. The 100mA

limit is due to the power rating of the 10Ω resistor (0.125W).

NOTE: When using the 4-20mA current loop input, A/D 1 - A/D 5

should be connected to the terminal block labeled GND.

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

Chapter 5: Software

Application Program Interface

The application program interface (API) is a set of routines that

makes it easy to communicate with the 232OPSDA module from a 16-

bit DOS application. Example programs using the API are written in

Borland C++, Borland Pascal and Microsoft QuickBASIC v4.5. The

batch file, MAKEIT.BAT, in the directory for each language shows how

to compile and link the demo program with the API routines.

B232OPSDA_ReadAnalog

This function reads the A/D input channels.

Purpose:

Syntax:

BOOL B232OPSDA_ReadAnalog (WORD hComDev,

BYTE modAddr, WORD channels, WORD* data);

function B232OPSDA_ReadAnalog (hComDev :

Pascal:

word; modAddr : byte; channels : word;

data : Pword);

FUNCTION B232OPSDAReadAnalog (BYVAL

hComDev AS INTEGER, BYVAL modAddr AS

INTEGER, BYVAL channels AS INTEGER, BYVAL

wdataseg AS INTEGER, BYVAL wdataoff AS

INTEGER)

BASIC:

hComDev is the handle to a serial port where the

module is connected. This is the value returned by

initComPort. modAddr is the module address, which

is always 30H (48 decimal) for the 232OPSDA module.

channels is a bit mask for the A/D input channels that

should be read. See the table below for the meaning of

each bit.

Remarks:

Bit

Channel

Value

(hex)

Value

(decimal)

Bit 7

Bit 6

Bit 5

Bit 4

Bit 3

Bit 2

Bit 1

Bit 0

(nothing)

80H

128

40H

20H

10H

08H

04H

02H

01H

A/D Channel 5

A/D Channel 4

A/D Channel 3

A/D Channel 2

A/D Channel 1

A/D Channel 0

data is that address of an array of 16-bit values where

the results of the A/D conversion will be stored.

For QuickBASIC users: wdataseg and wdataoff are the

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

segment and offset addresses of the integer array where

the results of the A/D conversion will be stored.

FALSE (zero) if the function fails, otherwise it returns

TRUE (non-zero).

Returns:

B232OPSDA_ReadDigital

This function reads the states of all the digital I/O lines.

Purpose:

Syntax:

BOOL B232OPSDA_ReadDigital (WORD hComDev,

BYTE modAddr, WORD* data);

function B232OPSDA_ReadDigital (hComDev :

word; modAddr : byte; data : Pword);

Pascal:

FUNCTION B232OPSDAReadDigital (BYVAL

hComDev AS INTEGER, BYVAL modAddr AS

INTEGER, BYVAL wdataseg AS INTEGER, BYVAL

wdataoff AS INTEGER)

BASIC:

hComDev is the handle to a serial port where the

module is connected. This is the value returned by

initComPort. modAddr is the module address. This is

always 30H (48 decimal) for the 232OSPSDA module.

data is the address of the 16-bit value where the digital

I/O values will be stored. If bit 0 (01H; 1 decimal) of data

is set, then digital input 0 is on, otherwise it is off. If bit 4

(10H; 16 decimal) of data is set, then digital output 1 is

on, otherwise it is off.

Remarks:

For QuickBASIC users: wdataseg and wdataoff are the

segment and offset addresses of the integer the digital

I/O values will be stored.

FALSE (zero) if the function fails, otherwise it returns

TRUE (non-zero).

Returns:

Documentation Number 232OPSDA1397 Manual

B&B Electronics -- PO Box 1040 -- Ottawa, IL 61350

PH (815) 433-5100 -- FAX (815) 433-5105

B232OPSDA_SetDigitalOutput

This function sets the states of the digital output lines.

Purpose:

Syntax:

BOOL B232OPSDA_SetDigitalOutput (WORD

hComDev, BYTE modAddr, WORD lines, WORD

states);

function B232OPSDA_ReadDigitalOutput

(hComDev : word; modAddr : byte; lines :

word; states : word);

Pascal:

FUNCTION B232OPSDAReadDigitalOutput

(BYVAL hComDev AS INTEGER, BYVAL modAddr

AS INTEGER, BYVAL lines AS INTEGER, BYVAL

states AS INTEGER)

BASIC:

hComDev is the handle to a serial port where the

module is connected. This is the value returned by

initComPort. modAddr is the module address. This

is always 30H (48 decimal) for 232OPSDA module.

lines is a bit mask of the digital outputs to change. This

will always be 01H (1 decimal) of the 232OPSDA,

because it only has one digital output line. states is the

new state of the digital outputs specified in lines. This

can be either zero for OFF or non-zero for ON.

Remarks:

FALSE (zero) if the function fails, otherwise it returns

TRUE (non-zero).

Returns:

deinitComPort

Removes the serial communications port driver.

Purpose:

Syntax:

void deinitComPort (WORD hComDev);

procedure deinitComPort (hComDev : word);

Pascal:

BASIC:

sub deinitComPort (BYVAL hComDev AS

INTEGER);

This function must be called after

serial

Remarks:

communications port is installed with initComPort to

remove the interrupt service routine that it installs.

Nothing.

initComPort

Returns: