ICC PRO - Mottechmottech.com/wp-content/uploads/2018/04/ICC-PRO-OPC-Server_4_4.pdfICC PRO ICC PRO -...

ICC PRO V 4.4

OPC Server

2 ICC PRO - OPC Server v4.4

Legal Notice

DISCLAIMER

ICC Water Control Ltd makes no representations or warranties with respect to this

manual and, to the maximum extent permitted by law, expressly limits its liability for

breach of any warranty that may be implied to the replacement of this manual with

another.

Further, ICC Water Control reserves the right to revise this publication at any time

without incurring an obligation to notify any person of the revision.

COPYRIGHT

© Copyright 2018 ICC Water Control Ltd. All rights reserved.

TRADEMARKS

ICC Water Control has made every effort to supply trademark information about

company names, products and services mentioned in this manual.

IRRInet, IRRInet-XL, IRRInet-XM, IRRInet-M, IRRInet-ACE, Piccolo-XR, PIU,

Scorpio, Intrac are registered trademarks of Motorola Inc.

Windows, Windows 7, 8, 10, Windows Server 2008, 2012, 2016, SQL Server, SQL

Server 2008, SQL Server 2012 LocalDB and Microsoft are either registered

trademarks or trademarks of Microsoft Corporation in the United States and/or other

countries.

All other brands and products referenced in this document are acknowledged to be the

trademarks or registered trademarks of their respective holders.

GENERAL NOTICE

Some product names used in this manual are used for identification purposes only and

may be trademarks of their respective companies.

ICC PRO ICC PRO - OPC Server v4.4 3

Content

1. Introduction 4

Purpose 4

Audience 4

2. ICC PRO - OPC Server feature 5

General 5

Data available via OPC 5 Field Unit 6 Analog Input 7 Analog Output 7 Digital Input 8 Digital Output 8 External Flag 9 Fert Pump 9 Filter Program 10 Internal Flag 11 Irrigation Program 11 Logic Flag 15 Main Line 15 Meter 16 Sensor 17 Virtual Analog Input 17 Virtual Meter 18

3. Access from remote workstation 19

Distributed OPC Overview 19 DCOM 19 OPCEnum 19

Configuring DCOM 19 Adding a local user 19 Adding a group 20 Configuring OPC Server 21

Firewall settings 34


1. Introduction

Purpose

This document guides the user how to configure and use ICC PRO - OPC Server.

The document describes the ICC PRO - OPC Server features and how to use it both

locally and on a network.

Audience

This document is for those who will configure ICC PRO - OPC Server for use with

third party clients and for users that want to connect a SCADA or other OPC client to

ICC PRO system via the OPC Server.

It is also important for administrators and for new users of ICC PRO.


2. ICC PRO - OPC Server feature

ICC PRO - OPC Server allows any client OPC application to retrieve information

from ICC PRO and also modify data using the OPC standard protocol.

ICC PRO support OPC DA 2.0 and OPC DA 3.0.

Please refer to the ICC PRO installation manual for information about installing ICC

PRO and especially about installing the ICC PRO - OPC Server.

General

The OPC Server name is ICC_OPC_Server.1

If you install ICC PRO with the OPC Server option, the OPC Server is available after

installing ICC PRO and no special configuration is required.

To allow remote access (from an OPC client that is running on a remote workstation)

please refer to the chapter ‎3 Access from remote workstation

Data available via OPC

ICC PRO - OPC Server allows OPC clients to access real time data of the system.

You must define the elements in ICC before you can access them from an OPC client.

As soon as you define an element in ICC, it will be available to OPC clients without

any specific configuration in ICC.

The following elements are available via the OPC interface:

Field Unit

Analog Input

Analog Output

Digital Input

Digital Output

External Flag

Fert Pump

Filter Program

Internal Flag

Irrigation Program

Logic Flag

Main Line

Meter

Sensor

Virtual Analog Input

Virtual Meter

The available information for each element type is described in the following sections.


Field Unit

OPC Tag Description Type R/W Remarks

ApplicationVersion The IRRInet

application

version

Decimal

R

FullDownloadOrUploadRequire Flag that

indicate if the

field unit

require an

upload or

download

Boolean

R

CommFail True if the

field unit is in

communication

failure status

Boolean

R

DailyAcc Daily

accumulation

in Liters

Double

R

WeeklyAcc Weekly

accumulation

in Liters

Double

R

MonthlyAcc Monthly

accumulation

in Liters

Double

R

YearlyAcc Yearly

accumulation

in Liters

Double

R

DailyFertAcc Daily Fert.

accumulation

in Liters

Double

R

WeeklyFertAcc Weekly Fert.

accumulation

in Liters

Double

R

MonthlyFertAcc Monthly Fert.

accumulation

in Liters

Double

R

YearlyFertAcc Yearly Fert.

accumulation

in Liters

Double

R

The full path for the tag is FieldUnits.[FIELD_UNIT_NAME].[TAG_NAME]

Where [FIELD_UNIT_NAME] is the name of the field unit in ICC and

[TAG_NAME] is one of the above tags.


Analog Input


CommFailure

If set indicate a

communication

failure with the

element

Boolean R

HWFailure

If set indicate a

hardware failure in

the element

Boolean R

Sample

If set by the client,

ICC will sample the

value from the

IRRInet

Boolean W

Value

The current value of

the element in the

element

measurement units

Double R

The full path for the tag is

FieldUnits.[FIELD_UNIT_NAME].AnalogInputs.[ELEMENT_NAME].[TAG_NAM

E]

Where [FIELD_UNIT_NAME] is the name of the field unit in ICC,

{ELEMENT_NAME] is the name of the element is ICC and [TAG_NAME] is one of

the above tags.

Analog Output


CommFailure

If set indicate a

communication

failure with the

element

Boolean R

HWFailure

If set indicate a

hardware failure in

the element

Boolean R

Sample


ICC will sample the

value from the

IRRInet

Boolean W

Value


the element in the

element

measurement units

Double R/W


FieldUnits.[FIELD_UNIT_NAME].AnalogOutputs.[ELEMENT_NAME].[TAG_NA

ME]




the above tags.

Digital Input


CommFailure

If set indicate a

communication

failure with the

element

Boolean R

HWFailure

If set indicate a

hardware failure in

the element

Boolean R

MomentaryStatus

The current status

of the digital input

regardless of the

stability time

Boolean R

RemainStabilityTime Remaining stability

time Integer R/W

Time in

seconds

Sample


ICC will sample

the value from the

IRRInet

Boolean W

StableStatus

The current stable

status of the digital

input

Boolean R


FieldUnits.[FIELD_UNIT_NAME].DigitialInputs.[ELEMENT_NAME].[TAG_NAM

E]



the above tags.

Digital Output


CommFailure

If set indicate a

communication

failure with the

element

Boolean R

HWFailure

If set indicate a

hardware failure in

the element

Boolean R


ManualStatus

The current manual

status of the digital

output

Boolean R/W

Write 1 to

manually

open or 0 to

manually

close

Sample


ICC will sample

the value from the

IRRInet

Boolean W

Status The current status

of the digital output Boolean R


FieldUnits.[FIELD_UNIT_NAME].DigitialOutputs.[ELEMENT_NAME].[TAG_NA

ME]



the above tags.

External Flag


Sample


ICC will sample

the value from the

IRRInet

Boolean W


of the External Flag Boolean R/W

Write 1 to set

the flag or 0

to reset it


FieldUnits.[FIELD_UNIT_NAME].ExternalFlags.[ELEMENT_NAME].[TAG_NAM

E]



the above tags.

Fert Pump


ClearAlarm

If set by the client

the active alarm

will be cleared

Boolean W

Write 1 to

clear current

alarm

InUse

If set indicate that

the pump is used

by an irrigation

Boolean R


program

Sample


ICC will sample

the status from the

IRRInet

Boolean W

UncontrolAlarm

If set there is an

uncontrol alarm in

the fert pump

Boolean R

UnopenAlarm

If set there is an

unopen alarm in the

fert pump

Boolean R


FieldUnits.[FIELD_UNIT_NAME].FertPumps.[ELEMENT_NAME].[TAG_NAME]



the above tags.

Filter Program


FlushingCounter

Number of

flushes since

last reset

Integer R

FlushingCounterResetTime

The flushing

counter reset

time

Date R

RemainingDelayBeforeStartFlushing

Remaining

time before

start flushing

Integer R/W Seconds

RemainingDelayBetweenFilterValves

Remaining

time to wait

between

closing the

last flashing

valve and

open the

next valve

Integer R/W Seconds

RemainingFlushingTime

Remaining

time to flush

with the

current valve

Integer R/W Seconds

RemainingIntervalBetweenFlushes

Remaining

time or

quantity

until starting

Integer R/W

Minutes

for time

based

filter or

ICC PRO ICC PRO - OPC Server v4.4

11

a new

flushing

cycle

pulses for

quantity

based

filter

Sample

If set by the

client, ICC

will sample

the status

from the

IRRInet

Boolean W


FieldUnits.[FIELD_UNIT_NAME].FilterPrograms.[ELEMENT_NAME].[TAG_NA

ME]



the above tags.

Internal Flag


Sample


ICC will sample

the value from the

IRRInet

Boolean W


of the Internal Flag Boolean R


FieldUnits.[FIELD_UNIT_NAME].InternalFlags.[ELEMENT_NAME].[TAG_NAM

E]



the above tags.

Irrigation Program


Activate

Activate or

Deactivate the

program

Boolean W

Write 1 to

activate the

program or 0 to

deactivate the

program

Active True if the

program is active Boolean R

ActualFlow The program

actual flow Double R

Actual Flow in

meter flow units


ClearAlarm

Reset the

program active

alarm

Boolean W Write 1 to clear

the active alarm

CyclesInDay Cycles in day Integer R/W

Applicable only

for the first

program in a

group

DaysInterval Interval between

irrigation days Integer R/W

Applicable only

for the first

program in a

group

ExpectedFlow Program

expected flow Double R/W

In meter flow

units

HighFlowAlarm Program high

flow alarm Boolean R

True if there is

high flow alarm

in the program

IrrigateByDaysInterval

True if the

program is

irrigating by days

interval.

False if irrigating

by week days

Boolean R/W

Write 1 to

irrigate by days

interval

IrrigateByWeekDays

True if the

program is

irrigating by

week days.

False if irrigating

by days interval

Boolean R/W

Write 1 to

irrigate by week

days

IrrigateNow Irrigate now

command Boolean W

Write 1 to

irrigate now the

group.

Applicable only

to the first

program in a

group

IrrigateNowSelected

Irrigate now

selected

command. Must

mark the selected

program before

setting this.

Boolean W

Write 1 to

irrigate now

selected the

group.

Applicable only

to the first

program in a

group

IrrigateNowSelectedDebt

Irrigate now

selected debt

command. Must

mark the selected

Boolean W

Write 1 to

irrigate now

selected debt the

group.


13

program before

setting this.

Applicable only

to the first

program in a

group

IrrigateToday Irrigate today

command Boolean W

Write 1 to

irrigate today the

group.

Applicable only

to the first

program in a

group

IrrigateTodaySelected

Irrigate today

selected

command. Must

mark the selected

program before

setting this.

Boolean W

Write 1 to

irrigate today

selected the

group.

Applicable only

to the first

program in a

group

IrrigateTodaySelectedDebt

Irrigate today

selected debt

command. Must

mark the selected

program before

setting this.

Boolean W

Write 1 to

irrigate today

selected debt the

group.

Applicable only

to the first

program in a

group

IrrigationBasis Program

Irrigation basis Byte R/W

1 – Time

3- Quantity

IrrigationDays Irrigation week

days Integer R/W

Two week

irrigation days.

Bit pattern.

First week

Sunday is bit 1

and Saturday on

week two is bit

14.

LowFlowAlarm Program low

flow alarm Boolean R

True if there is

low flow alarm

in the program

RemainingCyclesInDay Remaining cycles

in day Integer R/W

Applicable only

for the first

program in a

group

RemainingDaysInterval

Remaining

interval between

irrigation days

Integer R/W

Applicable only

for the first

program in a

group


RemainingWaterQuantity Remaining water

quantity Double R/W

Time in seconds

if irrigation basis

is time or

quantity in meter

volume unit if

irrigate basis is

quantity

Sample

If set by the

client, ICC will

sample the status

from the IRRInet

Boolean W

StartTime Group start time Integer R/W

Seconds since

midnight.

Applicable only

for the first

program in a

group

StopTime Group stop time Integer R/W

Seconds since

midnight.

Applicable only

for the first

program in a

group

Suspend

Suspend

irrigation

command

Boolean W

Applicable only

for the first

program in a

group. Write 1 to

suspend the

group or 0 to

resume

Suspended Group suspend

status Boolean R

1 if the group

suspened

UnopenAlarm Program unopen

alarm Boolean R

True if there is

unopen alarm in

the program

WaterQuantity Water quantity Double R/W

Time in seconds

if irrigation basis

is time or

quantity in meter

volume unit if

irrigate basis is

quantity


15


FieldUnits.[FIELD_UNIT_NAME].IrrigationPrograms.[ELEMENT_NAME].[TAG_

NAME]



the above tags.

Logic Flag


Sample


ICC will sample

the value from the

IRRInet

Boolean W


of the Logic Flag Boolean R


FieldUnits.[FIELD_UNIT_NAME].LogicFlags.[ELEMENT_NAME].[TAG_NAME]



the above tags.

Main Line


BurstAlarm

True if there is a

burst alarm in the

main line

Boolean R

ClearAlarm Clear current

alarm Boolean W

Write 1 to

clear the

alarm

Run

Run status of the

main line. 1 – Run,

0 – Stop.

Boolean R/W

Write 1 to

run the main

line or 0 to

stop the

main line

Sample


ICC will sample

the value from the

IRRInet

Boolean W

UncontrolFertAlarm

True if there is a

fert leak alarm in

the main line

Boolean R


UncontrolWaterAlarm

True if there is a

water leak alarm in

the main line

Boolean R


FieldUnits.[FIELD_UNIT_NAME].MainLines.[ELEMENT_NAME].[TAG_NAME]



the above tags.

Meter


Accumulator Meter accumulator Double R/W In meter

volume units

CommFailure

Communication

Failure with the

meter

Boolean R

Flow Current flow Double R In meter

flow units

HWFailure Hardware Failure

in the meter Boolean R

Sample


ICC will sample

the value from the

IRRInet

Boolean W

SampleRemote


ICC will sample

the value from the

IRRInet and send

request to sample

the remote unit

(Scorpio, XR…)

Boolean W

DailyAcc Daily

accumulation Double R

In meter

volume units

WeeklyAcc

Weekly


In meter

volume units

MonthlyAcc

Monthly


In meter

volume units

YearlyAcc

Yearlyly


In meter

volume units


FieldUnits.[FIELD_UNIT_NAME].Meters.[ELEMENT_NAME].[TAG_NAME]


17



the above tags.

Sensor


Accumulator Sensor

accumulator Double R/W Pulses

CommFailure

Communication

Failure with the

sensor

Boolean R

HWFailure Hardware Failure

in the sensor Boolean R

Sample


ICC will sample

the value from the

IRRInet

Boolean W

SampleRemote


ICC will sample

the value from the

IRRInet and send

request to sample

the remote unit

(Scorpio, XR…)

Boolean W

Value Current value Double R In sensor

units


FieldUnits.[FIELD_UNIT_NAME].Sensors.[ELEMENT_NAME].[TAG_NAME]



the above tags.

Virtual Analog Input


Sample


ICC will sample the

value from the

IRRInet

Boolean W

Value


the element in the

element

measurement units

Double R



FieldUnits.[FIELD_UNIT_NAME].VirtualAnalogInputs.[ELEMENT_NAME].[TAG

_NAME]



the above tags.

Virtual Meter


Accumulator Meter accumulator Double R/W In meter

volume units

Flow Current flow Double R In meter

flow units

Sample


ICC will sample

the value from the

IRRInet

Boolean W

DailyAcc Daily


In meter

volume units

WeeklyAcc

Weekly


In meter

volume units

MonthlyAcc

Monthly


In meter

volume units

YearlyAcc

Yearlyly


In meter

volume units


FieldUnits.[FIELD_UNIT_NAME].VirtulMeters.[ELEMENT_NAME].[TAG_NAM

E]



the above tags.


19

3. Access from remote workstation

This chapter describes the required configuration for accessing ICC PRO - OPC

Server from a client that is located on a remote workstation.

The OPC uses DCOM as the communication infrastructure so you need to configure

DCOM on the server machine to allow remote access.

Distributed OPC Overview

DCOM

DCOM (Distributed Component Object Model) is an extension of COM (Component

Object Model) that allow COM components to communicates with objects on

different computers.

Because DCOM can cause security threats, you should take care how you configure

your server to allow remote clients to access it.

OPCEnum

OPC clients need to discover OPC servers that are running on a computer.

To do so, a component named OPCEnum is available from the OPC Foundation.

This component runs as system service and inform clients about the OPC servers that

available on the computer.

Configuring DCOM

To allow secured connection we need to define a user and group that will have access

to the OPC Server.

When working in a domain, the network administrator will need to create the user and

the group. If we work in a workgroup, we need to manually add the user and the

group.

Please note: The workgroup option is possible also if working in a domain.

Adding a local user

Launch the Local User and Group snap-in. You can run it by entering lusrmgr.msc

command.


Right click on Users and select New User…

Type the new user information.

Click Create and Close.

Adding a group

Right click on Groups and select New Group…


21

Type the new group information.

Click on Add… then click on Advanced… and then click on Find Now.

Select IccOpc and click OK and another OK.

Click on Create and then on Close.

Configuring OPC Server

Launch dcomcnfg.exe from the Start-Run or Windows 7 "Search Programs and Files".

Please Note: On windows 64 there is a known problem with the dcomcnfg utility, so

run the 32 bit version from C:\WINDOWS\SysWOW64/mmc comexp.msc /32


Right click on My Computer and select Properties.

Please note: If you do not get a dialog like the following (not all tabs available or

the application crashes), you need to modify the security for

C:\Windows\Registration folder and assign full access to the Administrators group.


23

Ensure that the Default Properties tab definition is as follow:


Now, open the COM Security tab.


25

Click on Access Permissions – Edit Default… and allow local and remote access to

the Network, System, INTERACTIVE and IccOpcGroup users/groups.

Do the same for Edit Limits…

Click on Launch and Activation Permissions – Edit Default… and allow local

Launch, remote launch, local Activation and remote Activation to the Network,

System, INTERACTIVE and IccOpcGroup users/groups.

Do the same for Edit Limits…

Click OK to apply the changes.

Open the DCOM Config branch and select the OpcEnum component.

Right click on OpcEnum and select Properties.


In the General tab, set the Authentication Level to None.

Open the Location tab.


27

Ensure that "Run application on this computer" is checked.

Select the Security tab.


Ensure that Launch and Activation Permissions and Access Permissions set to Use

Defaults.

Set the Configuration Permissions to Customize.

Allow Full Control to the Network, System, INTERACTIVE and IccOpcGroup

users/groups.

Open the Identity tab and ensure that the system account selected.


29

Click on OK to apply the changes.

Now, select the ICC PRO - OPC Server.

In DCOM Config branch select ICC_OPC_Server OPC DA Server.

Right click on it and select properties.


In the General tab, set the Authentication Level to None.

Open the Location tab.


31

Ensure that "Run application on this computer" is checked.

Select the Security tab.


33

Ensure that Launch and Activation Permissions and Access Permissions set to Use

Defaults.

Set the Configuration Permissions to Customize.

Allow Full Control to the Network, System, INTERACTIVE and IccOpcGroup

users/groups.

Open the Identity tab.


Select the "This user" option and enter the IccOpcClient user you defined and the

password.

This will ensure that all clients will run the same instance of the OPC Server.

Click on OK to apply the changes.

To enable the new configuration you need to restart the PC or at least, restart the

OpcEnum service the stop the ICC OPC Server if it runs (use the task manager to kill

it).

Firewall settings

You will need to add an exception to the firewall that enables DCOM connection.

Please note: You can turn off the firewall during the testing and when everything is

working ok, turn on the firewall and apply the following exceptions.


35

Open the firewall configuration and add an exception.

Add the OPCEnum.exe program that is located in C:\Windows\System32 folder

(C:\Windows\SysWOW64 on 64 bits machines)

Add the ICC OPC Server located at C:\Program Files\ICC PRO\ICC_OPCServer.exe

(C:\Program Files (x86)\ICC PRO\ICC_OPCServer.exe on 64 bits machines)

Add the 135 port with TCP protocol.

Click OK to accept the changes.

You may also need to add firewall exception on the client machine.

Add the OPC client program as an exception.

Add port 135 with the TCP protocol.

Now you can connect with ICC PRO - OPC Server from remote stations.

ICC PRO - Mottechmottech.com/wp-content/uploads/2018/04/ICC-PRO-OPC-Server_4_4.pdfICC PRO ICC PRO -...

Documents

Transcript of ICC PRO - Mottechmottech.com/wp-content/uploads/2018/04/ICC-PRO-OPC-Server_4_4.pdfICC PRO ICC PRO -...