Applies To:
  • CitectSCADA 1.00 1.01 1.10 1.11 1.20 2.00 2.01 3.00

Summary:
How do I setup Citect with an Optomux controller? 

Solution:
The serial drivers PCxI, MCxI, COMxI or COMx may be used. Setup the Optomux units with the appropriate communication parameters i.e. baud rate, parity and station number.
I/O Devices form
Name: User supplied unique name
Number: Network wide I/O device number
Address: 0 to 255
Protocol: OPTOMUX
Port name: Use the "Port name" from the Ports form

Standard citect.ini options

[OPTOMUX]
MaxPending = 2
Block = 4 bytes
Retry = 0
Delay = 0
TimeOut = 2000 milliseconds
PollTime = 0
WatchTime = 30 seconds.

Files

  • OPTOMUX.DLL - The OPTOMUX driver for windows
  • OPTOMUX.DBF - The OPTOMUX variable template

OPTOMUX Variables

Optomux commands

Name

Type

Read

Write

Purpose

Read Only Variables

AI#

Int

L

Analog Input.

AIT#

Int

l

Analog Input Temperature with on-board linearization.

AITL#.@

Int

L

Analog Input Temperature with software linearisation. See AIPROBE.

IOTYPE

Digital

F

Input/Output Type. Value 0/1 for Digital/Analog Optomux.

DI#

Digital

M

Digital Input status. Value 0/1 is OFF/ON.

Read/Write Variables

AIL#!

Int

a

b

Analog Input Lowest value.

AIH#!

Int

d

e

Analog Input Highest value.

AIO#!

Int

g

W

Analog Input Offset.

AIG#!

Int

X

Y

Analog Input Gain.

AO#

Int

K

J

Analog Output.

IOC#

Digital

j

H/I

Input/Output Configuration. Value 0/1 is Input/Output.

AILL#!

Digital

O

Q

Analog Input fallen below their Low Limit

AIHL#!

Digital

O

Q

Analog Input fallen below their High Limit.

DO#

Digital

M

L/K

Digital Output status. Value 0/1 is Off/On.

DIT#

Digital

d

c/b

Digtial Input Triggered. Read Value of 1 is pulse completed. Write 0/1 to set trigger on negative/positve pulse.

DIL#!

Digital

Q

S

Digital Input Latch state. Value 0/1 is unlatched/latched.

DID#!

Int

e

g

Digital Input pulse Duration. Value * PERIOD * 10ms.

DIC#!

Int

W

Y

Digital Input pulse Counter.

Write Only Variables

CLEAR

Digital

A

Power up Clear.

RESET

Digital

B

Reset.

DELAY

Int

C

Set turn around Delay. Value 0/1/2/3 for 0/10/100/500 ms.

PERIOD

Int

n

Set Timer resolution. PERIOD = value * 10ms. Default value is 1.

CIO$*

Digital

G

Configure All Input/Output. Address bit 0/1 is Input/Output.

DOT$*

Digital

h

Retrigger Digital Output Time delay.

DOSA$*

Digital

J

Set All Digital Output. Address bit 0/1 is Off/On.

DITSA$*

Digital

a

Set All Digital Input Trigger polarity. Address bit 0/1 is negative/postive.

DILSA$*

Digital

N

Set All Digital Input Latch edge. Address bit 0/1 is OFF-to-ON/ON-to-OFF.

DICSA$*

Digital

T

Start/Stop All Digital Input counter. Address bit 0/1 stop/start counting.

DILS$*

Digital

O/P

Set Digital Input Latch trigger type. Value 0/1 is OFF-to-ON/ON-to-OFF.

DICS$*

Digital

V/U

Start/Stop Digital Input Counter. Value 0/1 stop/start counting.

DW

Int

D

Set Digital Watchdog delay.

Value

Time

Action

0

Watchdog disabled

1

10 seconds

All outputs OFF

2

1 minute

All outputs OFF

3

10 minutes

All outputs OFF

4

Watchdog disabled

5

10 seconds

Output 0 ON, all other outputs OFF

6

1 minute

Output 0 ON, all other outputs OFF

7

10 minutes

Output 0 ON, all other outputs OFF

AW$*

Int

D

Set Analog Watchdog delay.

Value

Time

Action

0

Watchdog timer disabled

1

10 seconds

Write zero scale

2

1 minute

Write zero scale

3

10 minutes

Write zero scale

4

Watchdog timer disabled

5

10 seconds

Write full scale

6

1 minute

Write full scale

7

10 minute

Write full scale

DWE$*

Int

m

Set Enhanced Digital Watchdog delay. Turn ON output on timeout for modules specfied. Turn OFF output on timeout for modules not specified. Delay is value * 10ms.

AWE#

Int

m

Set Enhanced Analog Watchdog . Set output to value on timeout.

AIPROBE$*

Int

k

Set Analog Input Temperature probe type.

Value

0

No temperature probe

1

ICTD Probe (AD4)

2

10 ohm RTD probe (AD14T)

3

100 ohm RTD probe (AD10T)

4

Type J Thermocouple (AD5/AD5T)

5

Type K Thermocouple (AD8/AD8T)

6

Type R Thermocouple (AD17T)

7

Type S Thermocouple (AD17T)

8

Type T Thermocouple (AD18T)

9

Type E Thermocouple (AD19T)

DON$*

Int

k

Set Digital Output On for value * PERIOD.

DOFF$*

Int

l

Set Digital Output Off for value * PERIOD.

DOPULSE$*

String

i

Generate n Digital Output Pulses. Value is "PPNNNN". PP * PERIOD ms is the period of the pulse. NNNN is the number of pulses.

DOD$*

String

Z

Set Digital Output Delay. Value is "TDDdd". Delay is DDdd * PERIOD * 10ms.

T

Delay Type

G

Turn delay off

H

When turned ON, turn ON for delay period, then turn OFF.

I

When turned ON, delay before turning ON.

J

When turned OFF, turn OFF for delay period, then turn ON.

K

When turned OFF, delay before turning OFF.

L

Continuous square wave. ON/OFF time is 2.56 * PERIOD * DD/dd seconds.

M

Continuous high resolution square wave. ON/OFF time is PERIOD * DD/dd ms.

AIRANGE$*

String

N

Set Analog Input range. Value is "HHHLLL". HHH is the high limit in hex and LLL is the low limit in hex.

AOW$*

String

R

Set Analog Output Waveform. Value is "PTHHLL".

P

Period of entire ramp

0

Disable waveform - 8

1.09 minutes

1

2.18 minutes - 9

32.8 seconds

2

3.28 minutes - A

21.8 seconds

3

4.37 minutes - B

16.4 seconds

4

5.46 minutes - C

13.1 seconds

5

6.56 minutes - D

10.9 seconds

6

7.65 minutes - E

9.4 seconds

7

8.74 minutes - F

8.2 seconds

T

Waveform type

0

Waveform off

1

Triangle wave with a positive initial slope

2

Ramp Up -- stops when upper limit reached

3

Continuous ramp up

4

Square wave (50 % duty cycle)

5

Triangle wave; initial slope is down

6

Ramp down -- stops when lower limit reached

7

Continuous ramp down

HH *

16 is the high limit.

LL *

16 is the low limit.

HW$*

String

V

Set Higher resolution Waveform. Value is "THHHLLLPPPP". T is the type of wave form. HHH is the high limit. LLL is the low limit and PPPP * 0.1 is the period in seconds.

Where
# Module number. 0 to 15.
* Bit mask of modules.
! If .0 is appended then the variable is cleared after the read.
 

Keywords:
 

Attachments