CS-C1

Ce document proprit d ALSTOM ne doit pas tre utilis, copi ou communiqu des tiers sans son autorisation

This document is the exclusive property of ALSTOM and shall not be used, copied or communicated to third parties without their prior authorization

CLG870.5-104
Software Installation Manual

DIFFUSION :

CONFIDENTIELLE

ACCESSIBILITY

CONFIDENTIAL

DATE
11/02/04
ETABLI

ESTABLISHED

VERIFIE

CHECKED

APPROUVE
APPROVED

NOM
NAME

RESTREINTE
RESTRICTED

CONTROLEE
CONTROLLED

SIGNATURE

P. EZANNO
G. RAGOUILLAUX

Power

Electrical and Control Systems

R. CHABANNE

P S M 3 1 A 4 0 3 9 7
PA 400 D

LIBRE
FREE

REV

STAT.

GFE

F/F FIN

Nb F

SH/SH END

N of SH

1/71

71

TABLE DES MODIFICATIONS / MODIFICATIONS TABLE

PA 401 C

REV

ETABLI

ESTABLISHED

VERIFIE

CHECKED

APPROUVE
APPROVED

RAGOUILLAUX

GRAVIL

RAGOUILLAUX

DROUHOT

CHABANNE

RAGOUILLAUX

DROUHOT

EZANNO

EZANNO

21/05/02

MODIFICATIONS

STAT.

Version originale

BPE

26/12/02

Adjonction des ASDUs relatifs aux Tc doubles et TVC de

type Bitstring

BPE

CHABANNE

17/02/03

Adjonction de ASDUs et variables systme selon PID

BPE

RAGOUILLAUX

CHABANNE

18/12/03

English translation and Update for multiple LRU

BPE

RAGOUILLAUX

CHABANNE

11/02/04

Installation procedures under UNIX or Windows NT/XP

BPE

CLG870.5-104
Software Installation Manual

ZACHARIA

DATE

PSM31A40397.2/72

TABLE OF CONTENTS
1

INTRODUCTION ........................................................................................... 5

1.1

GENERAL PRESENTATION ............................................................................ 5

1.2

CONFIGURABLE PROTOCOL ELEMENTS ....................................................... 6

1.3

DEFINITIONS................................................................................................ 7

RECOMMENDED CONFIGURATION.............................................................. 8

2.1

HARDWARE CONFIGURATION ..................................................................... 8

2.1.1

CLG870.5-104 application host stations...................................................... 8

2.1.2

Expansion board for the TCP/IP link ........................................................... 8

2.2

CONTROCAD CONFIGURATION................................................................. 10

2.3

CONFIGURING THE APPLICATION............................................................. 11

2.3.1

Definition of the System configuration file: phkb_Sys_***_n.do ............... 13

2.3.2

Definition of the application Data configuration file:

phkb_Data_***_n.do .................................................................................. 28

INSTALLATION ........................................................................................... 59

3.1

PRIOR STATE............................................................................................... 59

3.2

INSTALLATION PROCEDURE UNDER UNIX ................................................ 59

3.2.1

Installation of the IEC files......................................................................... 59

3.2.2

Adding the IEC function to the system configuration ............................... 61

3.2.3

Installing the IEC function on selected stations......................................... 62

3.3

INSTALLATION PROCEDURE UNDER WINDOWS NT/XP ............................ 64

3.3.1

Hardware configuration ............................................................................ 64

3.3.2

List of software media ............................................................................... 64

3.3.3

Controcad configuration ............................................................................ 64

3.3.4

CSS-G installation ...................................................................................... 65

3.3.5

Configuration files ..................................................................................... 66

3.3.6

Installation of an additional CSS-G........................................................... 66

CLG870.5-104
Software Installation Manual

PSM31A40397.3/72

3.4

STARTING AND STOPPING THE SOFTWARE .............................................. 67

3.4.1

Under UNIX ............................................................................................... 67

3.4.2

Under NT.................................................................................................... 67

MAINTENANCE........................................................................................... 68

4.1

FILES MANIPULATED BY THE SOFTWARE APPLICATION ............................ 68

4.2

COUNTER MEMORIZATION FILE ................................................................ 71

4.3

TM PARAMETERS CONFIGURATION FILE ................................................... 72

CLG870.5-104
Software Installation Manual

PSM31A40397.4/72

INTRODUCTION

1.1

GENERAL PRESENTATION
CLG870.5-104 (slave IEC) is a Solaris or Windows NT/XP-based software application
used to establish a gateway between the Centralog and a controlling station by
means of the IEC 870.5-104 communication protocol.
The area of application of this protocol is wide. The CLG 870.5-104 software
application implements a major part of the protocol, i.e. that part which concerns the
communication of the principal Centralog variable types: TSs, TMs and counters sent
from the Centralog to the controlling station; TSs, TMs, VRs, TCs and TVCs
transmitted from the controlling station to the Centralog (the PID describes the specific
implementation in detail). The parameters described in the present document enable
operation of the CLG 870.5-104 application to be adapted to the controlling station
with which it communicates.
Before installing the application the following configuration points should be agreed
in link with the persons responsible for the controlling station:
parameters defining the IEC 870.5-104 protocol implementation options, size of
variable identifiers, choice of transmission in delta mode or not for data
transmitted in spontaneous mode, operation of the general check, etc.
physical characteristics of the link: parameters of the TCP/IP link.
data to be exchanged: identifiers and parameters of each variable .
This document describes how to configure and install the application using the ADM
tool.

CLG870.5-104
Software Installation Manual

PSM31A40397.5/72

1.2

CONFIGURABLE PROTOCOL ELEMENTS

The table below summarizes the principal elements of the IEC 870.5-104 protocol that can be
configured in this communications gateway.
Description
ASDU <01>: Single_Point_information - non-timetagged TS state
ASDU <03>: Double_Point_Information non-timetagged dual TS state
ASDU <05>: Step_Position non-timetagged VR value
ASDU <09>: Nornalized_value non-timetagged standardized format TM value
ASDU <11>: Scaled_value non-timetagged scaled TM value
ASDU <13>: Floating_point_value non-timetagged floating format TM value
ASDU <15>: Integrated_totals non-timetagged counter value
ASDU <30>: Dated_Single_Point_information - timetagged TS state
ASDU <31>: Dated_Double_Point_Information timetagged dual TS state
ASDU <32>: Dated_Step_Position timetagged VR value
ASDU <34>: Dated_Nornalized_value timetagged standardized format TM value
ASDU <35>: Dated_Scaled_value timetagged scaled TM value
ASDU <36>: Dated_Floating_point_value timetagged floating point TM value
ASDU <37>: Dated_Integrated_totals non-timetagged counter value
ASDU <45>: Single_Command - non-timetagged single TC
ASDU <46>: Double_Command - non-timetagged dual TC
ASDU <47>: Regulating _Step - non-timetagged TC +/ASDU <48>: Normalised_Set_point - non-timetagged standardized TVC
ASDU <49>: Scaled_Set_point - non-timetagged scaled TVC
ASDU <51>: Floating_point _Set_point non-timetagged floating point format TVC
ASDU <50>: Bitstring _Set_point - TVC transported by a 32 bit bitstring
ASDU <58>: Dated_Single_Command timetagged single TC
ASDU <59>: Dated_Double_Command timetagged dual TC
ASDU <60>: Dated_Regulating _Step timetagged TC +/ASDU <61>: Dated_Normalised_Set_point timetagged standardized TVC
ASDU <62>: Normalised_Set_point timetagged scaled TVC
ASDU <63>: Dated_Floating_point _Set_point - timetagged floating point format TVC
ASDU <110>: Parameter_Normalised_value - standardized TM parameter
ASDU <112>: Parameter_Floating_point _ value - floating point TM parameter
Parameters applicable to single TSs
Parameters applicable to dual TSs
Parameters applicable to TMs
Parameters applicable to VRs (Step_Position)
Parameters applicable to counters
Parameters applicable to single, dual and incremental TCs
Parameters applicable to TVCs
Parameters applicable to TSPs
Parameters applicable to TMPs
Parameters defining the preferred implementation of the protocol
Dimensioning and timing parameters
Parameters regarding bi-directional mode and multi-master redundancy

CLG870.5-104
Software Installation Manual

Link
ASDU_01
ASDU_03
ASDU_05
ASDU_09
ASDU_11
ASDU_13
ASDU_15
ASDU_30
ASDU_31
ASDU_32
ASDU_34
ASDU_35
ASDU_36
ASDU_37
ASDU_45
ASDU_46
ASDU_47
ASDU_48
ASDU_49
ASDU_50
ASDU_51
ASDU_58
ASDU_59
ASDU_60
ASDU_61
ASDU_62
ASDU_63
ASDU_110
ASDU_112
TS parameters
Dual TS parameters
TM parameters
VR parameters_VR
Counter parameters
TC parameters
TVC parameters
TSP parameters
TMP parameters
Main_Choices
Size_Time
Bi_direction

PSM31A40397.6/72

DEFINITIONS

1.3

GTW

: Gateway

IEC

: Communication standard from the International Electro-technical Commission

CIS

: Real time CENTRALOG database

CCC

: maintenance and setting tools station for the Centralog system

CVS

: Station supporting MMI functions

QUAD

: 4 Ethernet ports board

IBDD

: interface layer between MMI or gateway function and the real time database

BDBF

: Functional Block database

TCP/IP

: Ethernet transport and link layers

EXP

: MMI function of Centralog

CLOGSQL

: Centralog SQL server

SYSCLOG

: Centralog installation program

TS

: Digital point (logical input acquired in controllers)

TSP

: Digital point generated in Centralog station

TM

: Measured value (analogue input)

TMP

: Analogue value generated in Centralog station

TC

: Single / double command (logical output)

TVC

: Set point (analogue output)

DEVICE

: DEVICE is equivalent to RTU

GPT

: Generic Protocol Translator

RTU

: Remote Terminal Unit

DCS

: Digital Control System

CLG870.5-104
Software Installation Manual

PSM31A40397.7/72

RECOMMENDED CONFIGURATION

2.1

HARDWARE CONFIGURATION

2.1.1

CLG870.5-104 application host stations

The CLG870.5-104 software application can be installed on the following stations:
a Centralog 10 station,
a Centralog 30-50 CCC-S or CVS station
on SUN/Solaris or PC/Windows NT/XP based platforms.
The installation of the CLG870.5-104 application consumes the following resources,
for both types of platform:
an Ethernet port on the QUAD board installed in the station;
an IBDD connection,
a Gateway function.
It is possible to install more than one CLG870.5-104 software application on the
same station, within the limit of the resources available, given the fact that other
software applications also consume these resources.
For example:
each EXP application (one per screen) consumes an IBDD connection,
each CLOGSQL application consumes two IBDD connections and a Gateway
function.
The maximum number of IBDD connections available on a station and the maximum
number of Gateway functions available on a Centralog is defined in the document
Centralog Capacities and Performance.

2.1.2

Expansion board for the TCP/IP link

A standard station is generally equipped with two Ethernet ports. The implementation
of CLG IEC-870.5-104 requires the addition of an expansion board (on condition
that an expansion slot remains free in the station). The QUAD FastEthernet PCI
Adapter board has been validated with the CLG IEC-870.5-104 application. This
board enables 4 further Ethernet ports to be added.

CLG870.5-104
Software Installation Manual

PSM31A40397.8/72

The QUAD board driver is installed by SYSCLOG. The QUAD board must be located
in the station before starting the full installation. The Centralog Installation and
Configuration Guide describes the procedure to be followed.
Installing the QUAD board after the installation of the station is more complicated as
the system files must be reset by hand and the station rebooted.

On SUN/Solaris platform :
Select port qfe1. This port corresponds to file /etc/hostname.qfe1. This must
contain the symbolic name IECServern.
E.g. : IECServer1
The /etc/hosts file must contain the IP address corresponding to IECServern.
E.g. :
199.207.36.101

IECServer1

This IP address must of course be compatible with the network to which the port is
connected.

On PC/Windows platform :
The C:\WINNT\System32\drivers\etc\hosts file must contain the IP
address corresponding to IECServern.
E.g. :
199.207.36.101

IECServer1

This IP address must of course be compatible with the network to which the port is
connected.

CLG870.5-104
Software Installation Manual

PSM31A40397.9/72

2.2

CONTROCAD CONFIGURATION
Each slave IEC needs to be associated with a Gateway. The configuration
engineer must perform the following operations:

Declare the name(s) of the Gateway function(s) on the station hosting

the slave IEC(s).

Declare the Gateway number(s) associated with the slave IECs.

Declare a one second TM output rate.

Declare a one second TS and VR buffer clearance time.

IMPORTANT: The CLG870.5-104 software application uses the Gateway dynamic

configuration feature, which means that the declaration in CCAD of the Gateway
variables used by the slave IEC is optional.
However all the variables consumed must exist in the Centralog database and be
defined in the data configuration file of the slave IEC (cf. phkb_Data_***_n.do in the
remainder of this document).

CLG870.5-104
Software Installation Manual

PSM31A40397.10/72

2.3

CONFIGURING THE APPLICATION

The CLG870.5-104 software application is configured by means of two configuration
files located:

On SUN/Solaris platform, in the directory /local/af/exe/sc on the SUN

station;

On PC/Windows platform, in the directory E:\P320\exe\sc on the PC.

The name of these configuration files are indexed with the Centralog identifier and
the Gateway number used by the software application. In this way they cannot be
confused with the configuration files of another CLG870.5-104 application installed
on the same station.
Their role are as follows:

The system configuration file named phkb_Sys_***_n.do (*** is the identifier

of the Centralog from 0 thru 3 characters, and n is the number of the Gateway)
contains the following information:

parameters of the communication layer,

parameters defining the choice of implementation of the IEC 870.5-104

protocol,

parameters used for the internal dimensioning and rates of the CLG 870.5104 application.

The data configuration file of the application named phkb_Data_***_n.do (***

is the Centralog identifier from 0 thru 3 characters, and n is the Gateway
number) contains the following information:

list of the system TSs indicating the state of the link,

list of the variable types manipulated,

list of variables of each type exchanged with the controlling station.

Important: Two sample configuration files are delivered with the CLG870.5-104
software application. They are located on the CCC-S respectively, in the directory
/local/af/exe/sc , in case of SUN/Solaris configuration, or E:\P320\exe\sc,
in case of PC/Windows configuration, and are named phkb_Sys_1_exemple.do
and phkb_Data_1_exemple.do

CLG870.5-104
Software Installation Manual

PSM31A40397.11/72

Syntax of configuration files:

Any line starting with # is a comment.
E.g.

#this line is a comment

A parameter is declared as follows:

<Key identifying the parameter>=<value of the parameter>
E.g.

COUNTER_MODE=4

Most of the parameters have a default value: when a parameter is absent, its default
value is used. In the remainder of this document, the default values are underlined.

CLG870.5-104
Software Installation Manual

PSM31A40397.12/72

2.3.1

Definition of the System configuration file: phkb_Sys_***_n.do

2.3.1.1

Parameters defining the choice of implementation of the IEC 870.5-104

Protocol
The line BASE_PERIOD=<Spontaneous cyclical transmission period>
gives the value in seconds of the transmission period of variables belonging to
ASDUs containing non-timetagged variables (non-timetagged TS and TM
variables). The default value is 10.
E.g.

BASE_PERIOD=5

The line DELTA_MODE=<Boolean designating the transmission mode

of spontaneous cyclical transmissions> indicates whether the
variables are transmitted systematically or in delta mode. The possible choices are:
. YES: after expiry of the period of spontaneous cyclical transmissions
(BASE_PERIOD parameter), only the variables that have changed since the last
transmission are sent to the controlling station. A TM has changed if its validity
has changed or if its value has changed outside its Deadband. A TS has
changed if its value or its validity has changed. This mode economizes the
bandwidth of the link but requires a reliable line.
. NO: after expiry of the period of spontaneous cyclical transmissions
(BASE_PERIOD parameter), all the variables are sent to the controlling station
The default value is YES.
E.g.

DELTA_MODE=YES

The line COUNTER_MODE=<A/C> indicates the counter management mode. In mode

A, the counter values are fixed and transmitted cyclically>. In mode C, the counter
values are fixed and transmitted on instruction from the controlling station.
This parameter is optional; The default value is C.
E.g.

COUNTER_MODE=A

The line COUNTER_PERIOD =<Counter transmission period> gives the

spontaneous transmission period of the counters in mode A in number of
BASE_PERIODs. This parameter is optional; it is only used if mode A is selected
previously. The default value is 10.
E.g.

COUNTER_PERIOD=12

CLG870.5-104
Software Installation Manual

PSM31A40397.13/72

The line GI_WITH_PAQ_TS=<Utilization or not of TS packets to

answer to GI> indicates whether or not the ASDU M_PS_NA_1 is used to
answer to the General Interrogation message originating from the controlling
station. (See PID). The possible choices are:
. YES: each group of 16 TSs with consecutive addresses is sent to the controlling
station via a TS packet. TSs with addresses that are not contiguous with those of
15 other TSs are sent to the controlling station via the ASDU of the nontimetagged TSs (M_SP_NA_1).
. NO: On request for a GI, the TSs are sent to the controlling station via the ASDU
of the non-timetagged TSs (M_SP_NA_1).
It is advisable to set this option to NO. In fact the TS packet ASDU contains only
one validity bit for a group of 16 TSs with consecutive addresses: consequently
TS packets can only be used if the TSs in a single group are valid or invalid at
the same time (e.g. they are located on the same acquisition board). This kind of
configuration is very difficult to achieve and to maintain; consequently you are
strongly advised not to use TS packets.
The default value is YES.
E.g.

GI_WITH_PAQ_TS=NO

The line USE_M_EI=<Utilization or not of the "End of

initialization" message > indicates whether or not the ASDU M_EI_NA_1
is used to tell the controlling station that the CLG870.5-104 software application
has terminated its initialization (see PID). The possible choices are:
. YES: the M_EI message is used (at the end of startup or after a request to reset
the controlling station)
. NO: the M_EI message is not used. In this case the controlling station considers
that the CLG870.5-104 software is ready as soon as the connection sequence is
terminated. It is advisable to set this option to NO unless the controlling station
needs to utilize the message M_EI. In effect, since this message complicates and
lengthens the initialization phase it should only be used if it is indispensable for
the controlling station.
The default value is YES.
E.g.

USE_M_EI=NO

The line INVALID_TIMETAG_DELAY=<TS state change timetag

invalidation delay> indicates the maximum delay after which a state change
timetag is invalidated: during the transmission to the controlling station of a
changement of state TS, the software calcule the time coul depuis the
changement of state. If this is greater than the invalidation delay, the state change
timetag is invalidated. The possible choices are:
. 0: the timetag of the event is not invalidated even if it is very old,
CLG870.5-104
Software Installation Manual

PSM31A40397.14/72

. Numerical value: value of the invalidation delay in seconds.

The default value is 0.
E.g. (delay of 30 minutes):

INVALID_TIMETAG_DELAY=1800

Important: Event timetags are always invalid if the Centralog fails to receive the
external time signal correctly.

The line MAX_SELECT_TIME=<Maximum TC selection time> indicates the

maximum selection time of a Select Before Operate type command in seconds. If
the execution request of the command arrives after the expiry of this timeout it is
rejected. An integer value greater than 0 is expected.
The default value is 60 (seconds).
E.g.

MAX_SELECT_TIME=120

The line REMOTE_CLOCK_SYNC=<Boolean> indicates whether or not the

CLG870.5-104 software application updates the Centralog time on the basis of
the message "Clock synchronization (ASDU C_CS_NA_1)" originating from the
controlling station. The possible choices are:
. YES: the CLG870.5-104 software application updates the Centralog time. This
choice can only be effective if the two systems are synchronized by the same time
signal.
. NO: the CLG870.5-104 software application ignores time update messages.
The default value is NO.
E.g.

REMOTE_CLOCK_SYNC=NO

The line CLOCK_TRANSMISSION_DELAY=<Transmission delay "Clock

synchronization" message> indicates the maximum time allowed for
transmission of the time sync message from the controlling station to the CIS. This
delay is expressed in seconds. The parameter is not used if the CLG870.5-104
application does not synchronize the Centralog time on the basis of data received
from the controlling station.
The default value is 5 (seconds).
E.g.

CLOCK_TRANSMISSION_DELAY=3

The lines OCF000,OCF001,OCF010,...,OCF111=<Values of a dual TS>

are used to configure the output states of a dual TS as a function of the value of the
single Open, Close and Fault TSs that are used in its composition. The possible
values are:

CLG870.5-104
Software Installation Manual

PSM31A40397.15/72

. 00: maneuvering or malfunctioning, according to the controlling station,

. 01: open or closed, according to the controlling station,
. 10: closed or open, according to the controlling station,
. 11: in malfunction,
. NIL: neutral state. In this case the dual TS keeps its previous value. No new state
change is generated.
The table below shows the default values used depending on the value of the single
TSs that compose a dual TS:
Value of the TS
Open

Value of the TS
Close

Value of the TS
Fault

OCF000=NIL

OCF001=11

OCF010=10

OCF011=11

OCF100=01

OCF101=11

OCF110=NIL

OCF111=11

Key word of the file

E.g.
OCF000=00
OCF001=11
OCF010=10
OCF011=11
OCF100=01
OCF101=11
OCF110=NIL
OCF111=11
Important: The document "Centralog Gateway Dual TS Specification" describes
how dual TS are produced

CLG870.5-104
Software Installation Manual

PSM31A40397.16/72

2.3.1.2

Parameters determining the internal dimensions and rates of the CLG

870.5-104 Application
The line GPT_PERIOD=<GPT activation period> indicates the period of
activation in milliseconds of the thread managing the transmission and acquisition
of data in IEC 870.5-104 format. The shorter this period, the faster the polling of
messages waiting in the communication layer; on the other hand, the shorter the
period, the higher the consumption of the CPU by the CLG870.5-104 application.
An integer value is expected. You are advised to select a value between 250ms
(default value) and 500ms.
E.g.

GPT_PERIOD=250

The line TS_LINK_PERIOD=<Link outage detection period> indicates the

time, in seconds, necessary to detect a break. The parameter is used to monitor the
link between the Centralog and the controlling station. An integer value is
expected. The default value is 10 seconds.
E.g.

TS_LINK_PERIOD=60

The line LONG_TIME_FAULT_DETECTION=<Long outage detection period>

indicates the time, in seconds, before detection of a long break. When a long
outage is detected the CLG870.5-104 software triggers a procedure to monitor the
events awaiting extraction in the file in order to delete those that are too old. (This
surveillance can be disabled or enabled via the option CYCLIC_QUEUE_CONTROL).
An integer value is expected. The default value is 1800 seconds.
E.g.

LONG_TIME_FAULT_DETECTION=600

The line QUEUE_SIZE=<Maximum number of posts for insertion in the

internal chronological queue> is used to dimension the chronological
queue of the CLG870.5-104 application. This queue fills up most during a general
check. When TS packets are not used it is necessary to allow at least one post per
TS configured. When TS packets are used allow at least one post for every 16 TSs.
An integer value is expected. The default value is 1000.
E.g. (configuration with 2,000 TSs plus a 50% reserve)

QUEUE_SIZE=3000

The line EVENT_WAITING_TIME=<Time events are retained in the

queue> indicates the time, in seconds, that events are kept in the queue in order to
ensure their chronology. An integer value greater than or equal to 0 is expected.
The default value is 2 (seconds).
E.g.

EVENT_WAITING_TIME=2

CLG870.5-104
Software Installation Manual

PSM31A40397.17/72

The line CYCLIC_QUEUE_CONTROL=<Boolean> indicates whether or not the

chronological queue of the CLG870.5-104 software application must be
scrutinized in the event of a long break so that the oldest events can be deleted
from the queue.
This option is useful when the Centralog is connected to the controlling station by
two independent links. But the controlling station uses only one line at a time to
execute the exchanges: the option is used on switchover from one link to the other
to prevent the controlling station recovering all the events that have accumulated in
the application queue since the previous switchover. The possible choices are:
. YES: cyclical queue control is enabled: in the event of a long break, the timetags
of the events waiting in the queue are checked every 30 seconds and outdated
events are deleted.
. NO: cyclical queue control is not enabled: in the event of a long break the queue
is not scrutinized.
The default value is NO.
E.g.

CYCLIC_QUEUE_CONTROL=YES

The line MAX_TIME_EVT_IN_QUEUE=<Time in seconds> indicates the

maximum time that an event can remain in the queue awaiting extraction in the
event of a long break. This parameter is only used if the
CYCLIC_QUEUE_CONTROL option is enabled. The default value is 180 (seconds).
E.g.

MAX_TIME_EVT_IN_QUEUE=60

The line TIME_CONTROL_COMMAND=<Time in seconds> indicates the maximum

delay between the date included in a command message (TC or TVC) and the
actual system time. The command is rejected (negative ACTCON) if the delay is
overcome. The default value is 90 (seconds).
E.g.

TIME_CONTROL_COMMAND=60

The line BUF_CMD_SIZE=<Size of the inter-thread mailbox> indicates

the maximum number of events that can be inserted in the mailbox of the
communication messages from the interface thread protocol to the interface GTW
thread. This mailbox is also used to store data transmitted in reverse direction. An
integer value is expected. The default value is 200.
E.g.

BUF_CMD_SIZE=400

The line TRACE_MODE=<Boolean indicating whether trace mode is

selected or not> indicates whether or not the CLG870.5-104 software
application is in trace mode or in normal mode. The possible choices are:

CLG870.5-104
Software Installation Manual

PSM31A40397.18/72

. YES: trace mode is actived. This means that messages designed to facilitate
debugging are displayed and that the CLG870.5-104 application can be polled
by means of scenario files in order to examine the content of the local database
or the chronological queue. The utilization of these scenario files is described in
the DCP.
. NO: trace mode is not actived; the software application is running in normal mode.
The default value is NO.
E.g.

TRACE_MODE=NO

The line TRACE_COM=<Boolean indicating whether or not the

communication layer is in trace mode> indicates whether or not the
software traces the frames exchanged on the link . The possible choices are:
. YES: trace mode is active. Communication trace messages are recorded
simultaneously in two files:
- The file piko_TraceCom_n.do is placed in the /tmp directory in UNIX and in
C:/temp in NT. This file is used to save the frames exchanged on the
communication level (n is the number of the gateway associated to the CLG
870.5 software application).
Important:
In UNIX the command tail -f <directory>/piko_TraceCom_n.do is used
to monitor the frames exchanged by the IEC function.
. NO: no communication message is traced.
The default value is NO.
E.g.

TRACE_COM=NO

The line P1=<Timeout in seconds> indicates the timeout for establishment of the
connection; it corresponds to parameter T0 of the IEC870.5-104 standard. Its
value must be between 1 and 255 seconds. The default value is 30 (seconds).
E.g.

P1=30

The line P2=<Timeout in seconds> indicates the timeout of send or test APDUs;
it corresponds to parameter T1 of the IEC870.5-104 standard. Its value must be
between 1 and 255 seconds. The default value is 15 (seconds). P2 must be smaller
than P4 and greater than P3.
E.g.

P2=15

CLG870.5-104
Software Installation Manual

PSM31A40397.19/72

The line P3=<Timeout in seconds> indicates the acknowledgement timeout in

the case of absent data messages; it corresponds to parameter T2 of the
IEC870.5-104 standard. Its value must be between 1 and 255 seconds. The
default value is 10 (seconds). P3 must be smaller than P2.
E.g.

P3=10

The line P4=<Timeout in seconds> indicates the timeout for sending test frames
in case of a long idle state; it corresponds to parameter T3 of the IEC870.5-104
standard. Its value must be between 1 and 255 seconds. The default value is 30
(seconds). P4 must be greater than P2.
E.g.

P4=30

The line P5=<Number of APDUs> indicates the maximum difference receive

sequence number to send state variable; it corresponds to parameter K of the
IEC870.5-104 standard. Its value must be between 1 and 32767 APDUs. The
default value is 12 (APDUs).
E.g.

P5=12

The line P6=<Number of APDUs> indicates the latest acknowledge after receiving
w I format APDUs; it corresponds to parameter W of the IEC870.5-104 standard.
Its value must be between 1 and 32767 APDUs. The default value is 8 (APDUs).
(recommendation: w should not exceed 2/3 of k).
E.g.

P6=8

Important notice:
The parameters T0, T1, T2, T3, K and W must be
configured at the same value in the master and in the slave station.

CLG870.5-104
Software Installation Manual

PSM31A40397.20/72

2.3.1.3

Parameters concerning bi-directional transfers, master/Centralog

redundancy and command flow management
The line BI_DIRECTIONAL_TRANSFER=<YES/NO> indicates whether bidirectional
transfer mode must be activated or not. In this mode the CLG870.5-104 software
transmits a general check on initialization to enable reception of TSs and TMs from
the controlling station.
This parameter is optional; its default value is NO.
E.g.

BI_DIRECTIONAL_TRANSFER=YES

The line REVERSE_GI_PERIOD=<Period in seconds> indicates the period of

activation in seconds of asking GI to the remote LRU(s) of the controlling station.
An integer value is expected. The default value is 300 (seconds).
E.g.

REVERSE_GI_PERIOD=300

The line REVERSE_TEST_PERIOD=<Period in seconds> indicates the period of

activation in seconds of making TEST check of the remote LRU(s) of the controlling
station. An integer value is expected. The default value is 0 (second).
E.g.

REVERSE_TEST_PERIOD=10

The line DCS_TYPE=<CYCLIC/EVENT> indicates whether or not the transfer of TSs

and TMs in bidirectional mode is cyclical or event-related. This parameter is
optional; its default value is EVENT.
E.g.

DCS_TYPE=EVENT

The line CLG_TYPE=<STANDALONE/LOCAL/NORMAL/BACKUP> indicates the type of

Centralog used to manage the TVC_CMD and the TM_CMD in the supervision of
the Centralog transmitting commands to the cell controllers.
NORMAL: this value indicates a Centralog with xxxServer1 configured in the
hosts file on the device. The TVC_CMD is sent with the value 2. The TM_CMD
must equal 2 for the commands to be sent to the cell controllers.
BACKUP: this value indicates a Centralog with xxxServer2 configured in the
hosts file on the device. The TVC_CMD is sent with the value 4. The TM_CMD
must equal 4 for the commands to be sent to the cell controllers.
LOCAL: this value indicates a Centralog that it has no IEC104 link. The TVC_CMD
and the commands are not sent.
STANDALONE: this value indicates the Centralog that it has an IEC104 link with a
non-redundant DCS. The TVC_CMD and the commands are not sent.

CLG870.5-104
Software Installation Manual

PSM31A40397.21/72

The default value is STANDALONE.

This value is applied only if DCS_TYPE_REDUNDANCY is set to PARALLELE.
E.g.

CLG_TYPE=STANDALONE

The line CMD_PERIOD=<Period in seconds> indicates the TVC_CMD

transmission period.
This is the minimum value configured by default. This value can be increased at the
cost of the detection of loss of communication between the CENTRALOG and the
cell controllers.
If the value is set to 0: the TVC_CMD is not sent.
The value is set to 1 at the cost of the bandwith of transmissions to the cell
controllers. This means that the TVC_CMD will be transmitted every 5 transmissions.
A value of 2 means transmission of the TVC_CMD every 10 command transmissions
to the cell controllers and detection of loss of communication between the
CENTRALOG transmitting the commands and the cell controllers every 4 seconds.
If the value is greater than 2, the command transmission bandwith will be improved,
but loss of communication between the cell controllers and the CENTRALOG
transmitting the commands will only be detected at intervals equal to twice the
transmission period.
E.g. Transmission at 5 seconds, transmission of the TVC_CMD every 25 command
transmissions but detection of loss of communication every 10 seconds.
The default value is 0.
This value is applied only if DCS_TYPE_REDUNDANCY is set to PARALLELE.
E.g.

CMD_PERIOD=10

The line DCS_TYPE_REDUNDANCY=<NO_REDONDANT/PARALLELE/ANARCHIQUE>

indicates the operating mode of DCS transmissions on the link IEC104.
By default the DCS is considered as non-redundant (NO_REDONDANT).
NO_REDONDANT: DCS is non-redundant or transmits its variables on a single
Ethernet link even if 2 Centralogs are connected. In this case, the TVC_CMD and
TM_CMD configurations on the Centralogs can be ignored.
PARALLELE: DCS transmitting in parallel on both the Ethernet links;
consequently, an identical command can be sent by the 2 Centralogs to the cell
controllers. To avoid transmitting the same command in parallel to the cell
controllers, the TVC_CMDs and TM_CMDs must be configured and the Centralog
type (CLG_TYPE) must be set correctly on each CENTRALOG.

CLG870.5-104
Software Installation Manual

PSM31A40397.22/72

ANARCHIQUE: DCS transmitting anarchically on both the Ethernet links. This case
is allowed for but is processed like NO_REDUNDANT mode. It is therefore
unnecessary to configure the TVC_CMDs and TM_CMDs. In this case, the
transmissions executed on the "second" link are lost.
E.g.

DCS_TYPE_REDUNDANCY=NO_REDONDANT

The line INIT_TIME=<Initialization timeout in seconds> indicates the

time during which TC/TVC commands are blocked by the software after the
opening of the session. This parameter is optional; its default value is 30 (seconds).
E.g.

INIT_TIME=30

The line USED_MANAGED_COMMAND=<YES/NO> indicates whether or not command

flow management is active. Flow management enables the number of TCs and
TVCs sent to cell controllers to be limited in order to avoid loss of command in case
of temporary overload. This parameter is optional; its default value is NO.
E.g.

USED_MANAGED_COMMAND=YES

The line SIZE_FIFO_GTW=<Size of command FIFO> indicates the size in terms

of the number of TC/TVCs in the queue of commands to the cell controllers. This
parameter is only used if flow management is active. Its default value is 5.
E.g.

SIZE_FIFO_GTW=2
The line COMMAND_PER_CYCLE=<Number of commands per cycle> indicates
the maximum number of TC/TVCs transmitted from the gateway to the cell
controllers per 200 ms period; this period corresponds to the cell controller
command application cycle. This parameter is only used if flow management is
active. Its default value is 1.
E.g.

COMMAND_PER_CYCLE=1

The line CONSUMER_NB=<Number of command consumers> indicates the

number of TC/TVC command consumers, which is the number of cell controllers.
This parameter is only used if flow management is active. Its default value is 1.
E.g.

CONSUMER_NB=5

The line MASTER_REDUNDANCY=<YES/NO> indicates whether or not the gateway

processes multi-master connections like master redundancy. In this case, several
masters can establish a TCP/IP connection but variables are transferred only with
the last master to have sent a STARTDT. Each new STARTDT closes the previously
opened variable transfer session and opens a new session. This parameter is
optional; its default value is NO.

CLG870.5-104
Software Installation Manual

PSM31A40397.23/72

E.g.

MASTER_REDUNDANCY=YES

The line WAIT_FOR_GI=<NEVER/FIRST_STARTDT/ALWAYS> indicates the mode

of startup of the variable transfer sessions:
NEVER: After a STARTDT the transfer can start without waiting for a general
check.
FIRST_STARTDT: The gateway awaits a general check after the first
STARTDT following the software initialization. Subsequent STARTDTs are
considered as switchovers from dual/redundant masters and do not
require a general check before transferring events.
ALWAYS: The gateway always waits for a general check after a STARTDT
before transferring events.
This parameter is optional; its default value is ALWAYS.
E.g.

WAIT_FOR_GI=NEVER

CLG870.5-104
Software Installation Manual

PSM31A40397.24/72

2.3.1.4

Redundancy and flow management: regular configurations

All combinations of parameters are possible; the paragraphs below show a few cases of regular
configurations of the Gateway IEC 870 104 depending on the type of DCS connected.
DCS in event-related write operating mode (like the P320):
DCS_TYPE = EVENT
INIT_TIME=0
USED_MANAGED_COMMAND = NO
SIZE_FIFO_GTW=0
COMMAND_PER_CYCLE=0
CONSUMER_NB=0
CLG_TYPE= STANDALONE
CMD_PERIOD=0
DCS_REDUNDANCY = NO_REDUNDANT
No TS_INIT
No TS_MANAGED_COMMAND
No TVC_CMD of TM_CMD
No PROCESS_VAR or PROCESS_VAR=NO on the TC and TVC
No DEADBAND on the TVC
DCS in periodic write operating mode and in parallel to both Gateways:
DCS_TYPE = CYCLIC
INIT_TIME = (SIZE_FIFO_TGW*0,2 s + basic value ) in seconds
USED_MANAGED_COMMAND = YES
SIZE_FIFO_GTW = somme of the TS_IA and TM_IA (PROCESS_VAR = YES) + talon (=1)
COMMAND_PER_CYCLE=1
CONSUMER_NB=1
CLG_TYPE=NORMAL or BACKUP or LOCAL
CMD_PERIOD=2
DCS_REDUNDANCY = PARALLELE
TS_INIT
TS_MANAGED_COMMAND
TVC_CMD
TM_CMD
PROCESS_VAR=YES for process states (TC => TS_IA and TVC => TM_IA),
PROCESS_VAR=NO for all pure commands ( TC and TVC)
DEADBAND on the TVC where PROCESS_VAR=YES
Non-redundant DCS in periodic write operating mode:
DCS_TYPE = CYCLIC
INIT_TIME = (SIZE_FIFO_TGW*0,2 s + basic value ) in seconds

CLG870.5-104
Software Installation Manual

PSM31A40397.25/72

USED_MANAGED_COMMAND = YES
SIZE_FIFO_GTW = sum of TS_IA and TM_IA (PROCESS_VAR = YES) + stub (=1)
COMMAND_PER_CYCLE=1
CONSUMER_NB=1
CLG_TYPE=STANDALONE
CMD_PERIOD=0
DCS_REDUNDANCY = NO_REDUNDANT
TS_INIT
TS_MANAGED_COMMAND
No TVC_CMD of TM_CMD
PROCESS_VAR=YES for process states (TC => TS_IA and TVC => TM_IA),
PROCESS_VAR=NO for all pure commands ( TC and TVC)
DEADBAND on the TVC where PROCESS_VAR=YES

2.3.1.5

LIMITS OF THE SYSTEM

The system cannot manage cases of chattering values:

chattering appears unlikely with operator commands originating from the DCS, but may occur
with process states if a sensor is badly regulated and/or if the DEADBAND of a TM_IA is badly
configured.
For information, the following has been observed:
a "commands" FIFO dimensioned at 5 messages (minimum value by default), overflows with 2
variables chattering at 200 ms. The overflow is limited to the "Commands" FIFO and does not
affect the Centralog or the S8000E.
On the Centralog, when the IEC104 function traces are scrolled in the CCC message window,
only a little CPU time remains available to execute consultation actions or actions on the views
(opening a shell takes a lot of time).
The trace modes (configured in the system file of the IEC104 software) have been removed in
order to improve this behavior, and these trace modes (TRACE_COM and TRACE_MODE at NO)
must be disabled in the site configurations.

CLG870.5-104
Software Installation Manual

PSM31A40397.26/72

2.3.1.6

Summary of system configuration file parameters

Label

Description

BASE_PERIOD
DELTA_MODE
COUNTER_MODE
COUNTER_PERIOD
GI_WITH_PAQ_TS
USE_M_EI
INVALID_TIMETAG_DELAY
MAX_SELECT_TIME
REMOTE_CLOCK_SYNC
CLOCK_TRANSMISSION_DELAY
OFC000 OFC111

Period of cyclical TS and TM transmissions

Transmission on value / state change
Counter management mode (IEC parameter)
Period of cyclical counter transmissions (in mode A only)
TS grouping in response to general checks
End of initialization message
State change timetag invalidation timeout
Maximum TC selection time
Time sync by network
Maximum time sync message transmission time
Dual TS coding matrix

GPT_PERIOD
TS_LINK_PERIOD
LONG_TIME_FAULT_DETECTION
QUEUE_SIZE
EVENT_WAITING_TIME
CYCLIC_QUEUE_CONTROL
MAX_TIME_EVT_IN_QUEUE
TIME_CONTROL_COMMAND
BUF_CMD_SIZE
TRACE_MODE
TRACE_COM
p1
P2
P3
P4
P5
P6

Network task activation period

Network outage detection time-out
Long outage time-out detection (overflow management)
Size of the event file
Chronological event reclassification time
Long outage monitoring
Maximum age of an event in the queue
Maximum age of a command (Tcand TVC) before being executed
Size of the internal command file
Activation of trace mode
Save trace messages in files
Connection time-out (IEC parameter: t0)
Response time-out (IEC parameter: t1)
Maximum acknowledgement time (IEC parameter: t2)
Maximum network silence time (IEC parameter: t3)
Maximum value of sequence number offset (IEC parameter)
Maximum anticipation rate for ASDU acknowledgement (IEC parameter)

BI_DIRECTIONAL_TRANSFER
REVERSE_GI_PERIOD
REVERSE_TEST_PERIOD
DCS_TYPE
CLG_TYPE
CMD_PERIOD
DCS_TYPE_REDUNDANCY
INIT_TIME
USED_MANAGED_COMMAND
SIZE_FIFO_GTW
COMMAND_PER_CYCLE
CONSUMER_NB
MASTER_REDUNDANCY
WAIT_FOR_GI

In bi-directional mode: reception of TS and TM and transmission of GI

In bi-directional mode: period of asking GI to the remote LRU
In bi-directional mode: period of making TEST check of the remote LRU
In bi-directional mode: reception of TS / TM in cyclical or on event
Type of Centralog
TVC_CMD transmission period in case of CLG redundancy
Operating mode of DCS transmissions
TC/TVC command blocking timeout after initialization
Management of the command flow to the controllers
Size of the command FIFO to the controllers
Number of commands transmitted per 200 ms cycle
Number of consumers of TC /TVC commands
Redundant master takeover
Standby for general check (GI) after a STARTDT

CLG870.5-104
Software Installation Manual

PSM31A40397.27/72

2.3.2

Definition of the application Data configuration file: phkb_Data_***_n.do

The CLG870.5-104 application can now be configured with several devices (up to
32). The identifier of each device is the common ASDU for this device.
The application data configuration file is structured in 3 distinct blocks:
1. At the head of the file is located the definition of the system TSs used to provide the
Centralog operator with information on the state of the link.
2. The following block describes the variable types (IEC objects) manipulated. This block
is delimited by the key words:
DESCRIPTION_DEVICE=<Device identifier>
or
DESCRIPTION_REMOTE_DEVICE=<Device identifier>
IEC objects transmitted by the Centralog
IEC objects received by the Centralog
END_DEVICE
DESCRIPTION_DEVICE is used to declare data transmitted in standard direction to
the controlling station, while DESCRIPTION_REMOTE_DEVICE is used to declare
data transmitted in reverse direction from the controlling station.
3. The last block describes the lists of variables exchanged, classed by type. Each
variable is defined with its parameters:
Centralog key of the variable,
Identifier of the variable recognized by the controlling station, used during the
exchanges,
Other parameters dependent on the variable type.
This block is delimited by the following key words:
OBJECT_DEVICE=<Device identifier>
List of the variables of the IEC i object
List of the variables of the IEC j object
....
List of the variables of the IEC k object
END_OBJECT_DEVICE

2.3.2.1

Definition of the Line Number used by the Master:

LINE=<Number of the line> defines the number of the line used by the master

CLG870.5-104
Software Installation Manual

PSM31A40397.28/72

2.3.2.2

Definition of System Variables:

- The line TS_CONDUITE=<Key of the control authorization TSP>
defines the key of the TS used to authorize or forbid all the commands originating
from the controlling station:
when the TS is valid and equal to 1 the controlling station is authorized to control
the Centralog;
when it is equal to 0 or is invalid, the controlling station cannot control the
Centralog.
This parameter is optional. When no control TS is defined, commands
originating from the controlling station are authorized.
The Application is responsible for setting the control TS.
If the controlling station has to receive this TS, it must belong to the list of
transmitted variables TSs (timetagged or not) to the controlling station.
E.g.

TS_CONDUITE=PRO-TSP01

- The line TS_LIAISON_G1=<Key of the TSP indicating the state of

the link with the controlling station> defines the key of the TS
indicating whether or not the CLG870.5-104 software has established the link with
the controlling station.
The TS is valid and equal to 1 when the link is established, and equal to 0
otherwise. The reset to 0 period of this TS depends on the parameter
TS_LINK_PERIOD defined in the system configuration file: the TS is set to 0 if no
message has been received from the controlling station during a period that is at
least equal to this period of time.
This TS must be defined.
E.g.

TS_LIAISON_G1=PRO-TSP02

- The line TS_LIAISON_CLG=<Key of the TSP indicating the state of

the link with the CIS> defines the key of the TS that indicates the state of
the link with the real time database of the CIS.
The TS is valid and equal to 1 when the CLG870.5-104 application is connected
to the CIS, and equal to 0 otherwise.
This TS must be defined. If the controlling station has to receive this TS, it must
belong to the list of transmitted variables TSs (timetagged or not) to the
controlling station.
E.g.

CLG870.5-104
Software Installation Manual

TS_LIAISON_CLG=PRO-TSP03

PSM31A40397.29/72

- The line TS_SATURATION=<Key of the overflow TSP> defines the key of the
TS that indicates whether one of the chronological queues is full or none. When one
of the queues is full the TS is valid and equal to 1, otherwise it is equal to 0. This
parameter can also be defined in the first device section, instead of in this first
block.
Important: This TS must be defined, here or in the first device section.
E.g.

TS_SATURATION=PRO-TSP04

- The line TS_INIT=<Key of the TSP indicating the state of the

initialization phase> defines the key of the TS indicating the state of the
Gateway initialization phase. The TS is valid and equal to 1 at startup, at the
establishment of communication with the DCS and following the loss of
communication with the DCS. It is equal to 0 when the initialization timeout
INIT_TIME is attained and steady state is established.
This parameter is optional. If the controlling station receives it, the list of TSs
transmitted to the controlling station must be defined. It must be configured with
a CYCLIC type DCS if the INIT_TIME value is not null. In other cases, it serves
no purpose: if the DCS is EVENT type, it remains at 0.
E.g.

TS_INIT=PRO-TSP04

- The line TS_MANAGED_COMMAND=<Key of the TSP indicating

transmission overflow> defines the key of the TS indicating the state of the
overflow TS regarding process command and state transmission on the S8000E
network. The TS is valid and equal to 1 when the process command and state FIFO
is full. It is equal to 0 on initialization and when the FIFO overflow is cleared. This
variable is not reset to zero until at least one second after the FIFO is cleared.
This parameter is optional. If the controlling station receives it, the list of TSs
transmitted to the controlling station must be defined. It must be configured if the
command flow is managed as it indicates the state of overflow of the process
command and state management FIFO. If flow management is not configured
(USED_MANAGED_COMMAND=NO), this variable has no purpose and remains at 0.
E.g.

TS_MANAGED_COMMAND=PRO-TSP05

- The line TVC_CMD=<Key of the command TVC> defines the key of the TVC
used by the cell controller to determines the TM command TM_CMD in accordance
with the parameter CLG_TYPE. Its value authorizes the Centralog to send the
process commands or states to the cell controllers.
Each Centralog type CLG_TYPE=[NORMAL or BACKUP] writes its own value in the
TVC_CMD: CLG_TYPE=NORMAL => TVC_CMD=2
or CLG_TYPE=BACKUP => TVC_CMD=4.

CLG870.5-104
Software Installation Manual

PSM31A40397.30/72

In the initialization phase, the TVC_CMD is equal to 0.

The TVC_CMD is sent if the TM_CMD=0 (this is in fact a request to transmit
commands) or if the TM_CMD=TVC_CMD (to maintain the link between the
Centralog and the cell controllers).
The TVC_CMD is reset to 0 if the Centralog that transmits the commands has just
lost the link with the DCS (TS_LINK switches from 1 to 0).
The transmission period of the TVC_CMD is CMD_PERIOD when there is no change in the state of the
link with the DCS.
This parameter is optional. It serves no purpose with an EVENT type DCS.
E.g.

TS_MANAGED_COMMAND=PRO-TVC_CMD_06

- The line TM_CMD=<Key of the TM command> defines the key of the TM

authorizing the transmission of the commands in accordance with the parameter
CLG_TYPE.
TM_CMD=0:
Initialization phase of the software
Loss of communication between the cell controllers and the Centralog
transmitting commands over the S8000E; value returned by the cell controllers
following its reset to 0.
Loss of communication between the DCS and the Centralog transmitting the
commands; return by the cell controllers of the TVC_CMD equal to 0.
TM_CMD=2:
Centralog type CLG_TYPE=NORMAL transmits the commands to the cell
controllers.
The Centralog type CLG_TYPE=BACKUP runs in parallel but the commands that
it receives are not transmitted to the Centralog.
TM_CMD=4:
Centralog type CLG_TYPE=BACKUP transmits the commands to the cell
controllers.
The Centralog type CLG_TYPE=NORMAL runs in parallel but the commands that it receives are not
transmitted to the Centralog.
The TM_CMD is not managed if the DCS is not redundant
(DCS_TYPE_REDUNDANCY different from PARALLELE) or if the Centralog is
standalone type (CLG_TYPE=STANDALONE).

CLG870.5-104
Software Installation Manual

PSM31A40397.31/72

This parameter is optional. It serves no purpose with an EVENT type DCS

E.g.
2.3.2.3

TM_CMD=PRO-TM_07

Definition of Variable Types (IEC Objects)

The header of the definition block is beginning by:
The line DESCRIPTION_DEVICE=<Device identifier> , to declare data
transmitted in standard direction to the controlling station,
or the line DESCRIPTION_REMOTE_DEVICE=<Device identifier> , to declare
data transmitted in reverse direction from the controlling station.
This identifier of device must be between 1 and 65535 (16 bits format).
This line must be defined.
As several devices can be defined for the IEC 870.5-104 protocol, the common
ASDU address is defined for each device by the <Device Identifier>.
The line END_DEVICE terminates this IEC object definition block. The parameters
defined within the block are as follows:
For the first device only, the parameter TS_SATURATION=<Key of the
overflow TSP> could be placed here, instead of in the previous block. It defines
the key of the TS that indicates whether one of the chronological queues is full or
none. When one of the queues is full the TS is valid and equal to 1, otherwise it is
equal to 0. This parameter could also be defined in this section because other
protocols that use the same configuration files need to define several devices with
one chronological queue and an associated overflow TS.
Important: This TS must be defined, in the previous section or here,
for the first device only.
If a controlling station has to receive this TS, it must belong to the list of TSs
transmitted to the controlling station.
E.g.

TS_SATURATION=PRO-TSP04

Then, the declaration of the two lists of variables (transmitted or received) is done
independantly of the type of concerned device (local or remote).
The list of variable types transmitted by the IEC 870.5-104 Gateway (or controlling
station) is declared as follows:
OBJECT_DESCRIPTION_TRANSMIT
OBJECT=<Id1> TYPE=<type1> BLOCK=<base1> POINTS=<Start1>,<End1>
OBJECT=<Id2> TYPE=<type2> BLOCK=<base2> POINTS=<Start2>,<End2>

....
OBJECT=<Idn> TYPE=<Typen> BLOCK=<Basen> POINTS=<Startn>,<Endn>

END_OBJECT_DESCRIPTION

CLG870.5-104
Software Installation Manual

PSM31A40397.32/72

It is possible to declare up to 64 objects of the same type: thus enabling the

definition of several blocks of variables with contiguous addresses.
The parameters of an IEC object are:
. OBJECT=<Id>: indicates the object identifier. Referred to in the variable
definition block in order to define the full list of object variables,
. TYPE=<type>: defines the object variable type. Each of the possible types
corresponds to an IEC 870.5-104 standard ASDU (see PID)
The possible types are:
- SINGLE_POINT: non-timetagged TS type corresponding to the standard
ASDU 0x1 (M_SP_NA_1),
- SINGLE_POINT_WITH_TIME: timetagged TS type corresponding to the
standard ASDU 0x1e (M_SP_TB_1),
- DOUBLE_POINT: non-timetagged dual TS type corresponding to the standard
ASDU 0x3 (M_DP_NA_1) ,
- DOUBLE_POINT_WITH_TIME: timetagged dual TS type corresponding to the
standard ASDU 0x1f (M_DP_TB_1),
- MEASURED_NORMALIZED_VALUE: normalized TM type corresponding to the
standard ASDU 0x9 (M_ME_NA_1).
The value of this type of TM transmitted to the controlling station after
application of the conversion formula must be between[-1, 1].
This formula is used to convert the Centralog measurement of the TM into a
normalized measurement recognized by the controlling station: it is equal to
Mdis=(MClog-Offset)/Coeff,
- MEASURED_NORMALIZED_VALUE_WITH_TIME: standardized TM type
corresponding to the standard ASDU 0x22 (M_ME_TD_1).
The value of this type of TM transmitted to the controlling station after
application of the conversion formula must be between[-1, 1].
This formula is used to convert the Centralog measurement of the TM into a
normalized measurement recognized by the controlling station: it is equal to
Mdis=(MClog-Offset)/Coeff,
- MEASURED_SCALED_VALUE: scaled TM type corresponding to the standard
ASDU 0xB (M_ME_NB_1). The value of this type of TM transmitted to the
controlling station after application of the conversion formula is between
[-32768,32767]
(The conversion formula is the same as that applied to a normalized TM)
Important: The VR values of MEASURED_INTEGER_VALUE type that are
defined are transmitted by the slave IEC via the standard ASDU
M_ME_NB_1.

CLG870.5-104
Software Installation Manual

PSM31A40397.33/72

- MEASURED_SCALED_VALUE_WITH_TIME: adjusted TM type corresponding

to the standard ASDU 0x23 (M_ME_TE_1). The value of this type of TM
transmitted to the controlling station after application of the conversion
formula is between [-32768,32767]
(The conversion formula is the same as that applied to a normalized TM)
- MEASURED_FLOAT_VALUE: short floating point TM type corresponding to the
standard ASDU 0xD (M_ME_NC_1). The value of this type of TM, transmitted
to the controlling station after application of the conversion formula, is a short
floating point number that conforms to standard IEEE STD 754.
This formula is used to convert the Centralog measurement of the TM into a
measurement understood by the controlling station: it is equal to
Mdis=(MClog-Offset)/Coeff,
- MEASURED_FLOAT_VALUE_WITH_TIME: short floating point TM type
corresponding to the standard ASDU 0x24 (M_ME_TF_1).
The value of this type of TM, transmitted to the controlling station after
application of the conversion formula, is a short floating point number that
conforms to standard IEEE STD 754.
This formula is used to convert the Centralog measurement of the TM into a
measurement understood by the controlling station: it is equal to
Mdis=(MClog-Offset)/Coeff,
- STEP_POSITION: TM type corresponding to the standard ASDU 0x5
(M_ST_NA_1). The value of this type of TM, transmitted to the controlling
station after application of the conversion formula, must be between 0,31].
This formula is used to convert the Centralog measurement of the TM into a
measurement understood by the controlling station: it is equal to
Mdis=(MClog-Offset)/Coeff,
- STEP_POSITION_WITH_TIME: TM type corresponding to the standard ASDU
0x20 (M_ST_TB_1). The value of this type of TM, transmitted to the controlling
station after application of the conversion formula, must be between 0,31].
This formula is used to convert the Centralog measurement of the TM into a
measurement understood by the controlling station: it is equal to
Mdis=(MClog-Offset)/Coeff,
- INTEGRATED_TOTAL: counter type corresponding to the standard ASDU 0xF
(M_IT_NA_1).
- INTEGRATED_TOTAL_WITH_TIME: counter type corresponding to the
standard ASDU 0x25 (M_IT_TB_1).
Important: it is not necessary to define the TS packet object (standard ASDU
0x14 M_PS_NA_1). In fact, if used (GI_WITH_PAQ_TS=YES), it
is constructed dynamically on startup by concatenating all the
objects containing TSs (ASDU M_SP_NA_1 and M_SP_TA_1)
. BLOCK=<Base>: defines the base number of the object variable identifiers,

CLG870.5-104
Software Installation Manual

PSM31A40397.34/72

. POINTS=<Start>,<End>: gives the limits of the object variable identifiers. The low
limit is equal to: <Base>+<Start>; the high limit is equal to: <Base>+<End>
During the definition of the list of object variables, the software application
checks that each variable identifier is located within these limits. The identifier is
calculated with the formula: Id=<Base>+<Point> (<Point> is a parameter of
the variable)
Example 1: The base address of the objects is equal to 0, which is the same as
defining the variable identifiers directly in the lists declared subsequently.
OBJECT_DESCRIPTION_TRANSMIT
OBJECT=1
OBJECT=2
OBJECT=31
OBJECT=32
OBJECT=3
OBJECT=4
OBJECT=5
OBJECT=6
OBJECT=7
OBJECT=10

TYPE=SINGLE_POINT
TYPE=SINGLE_POINT_WITH_TIME
TYPE=DOUBLE_POINT
TYPE=DOUBLE_POINT_WITH_TIME
TYPE=MEASURED_NORMALIZED_VALUE
TYPE=MEASURED_SCALED_VALUE
TYPE=MEASURED_FLOAT_VALUE_WITH_TIME
TYPE=INTEGRATED_TOTAL
TYPE=INTEGRATED_TOTAL_WITH_TIME
TYPE=MEASURED_INTEGER_VALUE

BLOCK=0
BLOCK=0
BLOCK=0
BLOCK=0
BLOCK=0
BLOCK=0
BLOCK=0
BLOCK=0
BLOCK=0
BLOCK=0

POINTS=0,
499
POINTS=500, 799
POINTS=800, 899
POINTS=900, 999
POINTS=1000,1499
POINTS=1500,1799
POINTS=1800,1999
POINTS=2000,2099
POINTS=2100,2499
POINTS=3000,3599

END_OBJECT_DESCRIPTION
Example 2: The ASDU of the non-timetagged TS is composed of 3 consecutive blocks;
a single TM type is used and there are no counters:
OBJECT_DESCRIPTION_TRANSMIT
OBJECT=1
OBJECT=11
OBJECT=12
OBJECT=2
OBJECT=4
OBJECT=6

TYPE=SINGLE_POINT
TYPE=SINGLE_POINT
TYPE=SINGLE_POINT
TYPE=SINGLE_POINT_WITH_TIME
TYPE=MEASURED_SCALED_VALUE
TYPE=MEASURED_FLOAT_VALUE

BLOCK=0
BLOCK=100
BLOCK=200
BLOCK=0
BLOCK=0
BLOCK=0

POINTS=0,29
POINTS=0,9
POINTS=0,20
POINTS=500,999
POINTS=1500,1999
POINTS=2000,2099

END_OBJECT_DESCRIPTION
The list of the data types received from the controlling station is declared as follows:
OBJECT_DESCRIPTION_RECEIVE
OBJECT=<Id1> TYPE=<Type1> BLOCK=<Base1> POINTS=<Start1>,<End1>
OBJECT=<Id2> TYPE=<Type2> BLOCK=<Base2> POINTS=<Start2>,<End2>

....
OBJECT=<Idn> TYPE=<Typen> BLOCK=<Basen> POINTS=<Startn>,<Endn>

END_OBJECT_DESCRIPTION
It is possible to declare up to 64 object of the same type.
The parameters of an IEC object are:
. OBJECT=<Id>: indicates the object identifier.
. TYPE=<type>: defines the object variable type. Each of the possible types
corresponds to an IEC 870.5-104 standard ASDU (see PID)
The possible types are:
- SINGLE_COMMAND: direct TC and Select Before Operate TC type
corresponding to the standard ASDU 0x2D (C_SC_NA_1),
- SINGLE_COMMAND_WITH_TIME: direct TC type and Select Before Operate
TC type corresponding to the standard ASDU 0x3A (C_SC_TA_1),

CLG870.5-104
Software Installation Manual

PSM31A40397.35/72

- DOUBLE_COMMAND: direct TC type and Select Before Operate TC type

corresponding to the standard ASDU 0x2E (C_DC_NA_1),
- DOUBLE_COMMAND_WITH_TIME: direct TC type and Select Before Operate
TC type corresponding to the standard ASDU 0x3B (C_DC_TA_1),
- REGULATING_STEP_COMMAND: direct TC type and Select Before Operate TC
type corresponding to the standard ASDU 0x2F (C_RC_NA_1),
- REGULATING_STEP_COMMAND_WITH_TIME: direct TC type and Select Before
Operate TC type corresponding to the standard ASDU 0x3C (C_RC_TA_1),
- SET_POINT_NORMALIZED_VALUE: standardized TVC type corresponding to the
standard ASDU 0x30 (C_SE_NA_1).
The value of this type of TVC received from the controlling station before
application of the conversion formula is located in the interval [-1, 1]. This
formula is used to convert the measurement transmitted by the controlling station
into a Centralog setpoint: it is equal to MClog=(MDis-Offset)/Coeff,
- SET_POINT_NORMALIZED_VALUE_WITH_TIME: standardized TVC type
corresponding to the standard ASDU 0x3D (C_SE_TA_1).
The value of this type of TVC received from the controlling station before
application of the conversion formula is located in the interval [-1, 1]. This
formula is used to convert the measurement transmitted by the controlling station
into a Centralog setpoint: it is equal to MClog=(MDis-Offset)/Coeff,
- SET_POINT_SCALED_VALUE: scaled TVC type corresponding to the standard
ASDU 0x31 (C_SE_NB_1). The value of this type of TVC received from the
controlling station before application of the conversion formula, is located in
the interval [-32768,32767]. (The conversion formula is the same as that
applied to a normalized TVC).
- SET_POINT_FLOAT_VALUE: short floating TVC type corresponding to the
standard ASDU 0x32 (C_SE_NC_1). The conversion formula given above is
applied to the value received from the controlling station before its
transmission to the Centralog.
- SET_POINT_SCALED_VALUE_WITH_TIME: adjusted TVC type corresponding
to the standard ASDU 0x3E (C_SE_TB_1). The value of this type of TVC
received from the controlling station before application of the conversion
formula, is located in the interval [-32768,32767]. (The conversion formula
is the same as that applied to a normalized TVC).
- SET_POINT_FLOAT_VALUE_WITH_TIME: short floating point TVC type
corresponding to the standard ASDU 0x3F (C_SE_TC_1). The conversion
formula given above is applied to the value received from the controlling
station before its transmission to the Centralog.

CLG870.5-104
Software Installation Manual

PSM31A40397.36/72

- SET_POINT_BIT_STRING: TVC type corresponding to the standard ASDU

0x33 (C_BO_NA_1). The conversion formula given above is applied to the
value received from the controlling station before its transmission to the
Centralog.
Important:

The SET_POINT_BIT_STRING type TVC values that are

defined are transmitted by the IEC slave via the the standard
ASDU M_BO_NA_1 on the least significant 16 bits.

- PARAMETER_NORMALIZED_VALUE: standardized parameter type

corresponding to the standard ASDU 0x6E (P_ME_NA_1). The value of the
parameter is related to the value of the TM sent to the controlling station - not
to be configured.
- PARAMETER_SCALED_VALUE: ASDU 0x6F (P_ME_NB_1) - not implemented
- PARAMETER_FLOAT_VALUE: standardized parameter type corresponding to
the standard ASDU 0x70 (P_ME_NC_1). The value of the parameter is related
to the value of the TM sent to the controlling station - not to be configured.
Note: The deadband parameter is applicable on MDis but not on Mclog.
The received objects from a remote LRU of the controlling station (in
reverse direction) are distinguished by the use of distinct object variable
types (suffix _FROM_MASTER):
- SINGLE_POINT_FROM_MASTER: non-timetagged TS (idem transmitted
variables),
- SINGLE_POINT_WITH_TIME_FROM_MASTER: timetagged TS (idem
transmitted variables),
- DOUBLE_POINT_FROM_MASTER: non-timetagged dual TS (idem transmitted
variables),
- DOUBLE_POINT_WITH_TIME_FROM_MASTER: timetagged dual TS (idem
transmitted variables),
- MEASURED_NORMALIZED_VALUE_FROM_MASTER: standardized TM (idem
transmitted variables),
- MEASURED_NORMALIZED_VALUE_WITH_TIME_FROM_MASTER: timetagged
standardized TM (idem transmitted variables),
- MEASURED_SCALED_VALUE_FROM_MASTER: adjusted TM (idem transmitted
variables),
- MEASURED_SCALED_VALUE_WITH_TIME_FROM_MASTER: timetagged
adjusted TM (idem transmitted variables) ,

CLG870.5-104
Software Installation Manual

PSM31A40397.37/72

- MEASURED_FLOAT_VALUE_FROM_MASTER: short floating point TM (idem

transmitted variables),
- MEASURED_FLOAT_VALUE_WITH_TIME_FROM_MASTER: timetagged short
floating point TM (idem transmitted variables),
- STEP_POSITION_FROM_MASTER: TM corresponding to ASDU 05 (idem
transmitted variables),
- STEP_POSITION_WITH_TIME_FROM_MASTER: TM corresponding to ASDU
0x20 (idem transmitted variables),
. BLOCK=<Base>: defines the base number of the object variable identifiers,
. POINTS=<Start>,<End>: gives the limits of the object variable identifiers. The low
limit is equal to: <Base>+<Start>; the high limit is equal to: <Base>+<End>,
E.g. the TC object is subdivided into two in order to separate the addresses of the
direct TCs from those of the Select Before Operate TCs.
OBJECT_DESCRIPTION_RECEIVE
# Object of the direct TCs
OBJECT=61 TYPE=SINGLE_COMMAND

BLOCK=0 POINTS=3000,3499

# Object of the Select Before Operate TCs

OBJECT=62 TYPE=SINGLE_COMMAND

BLOCK=0 POINTS=3500,3599

# Object of the Select Before Operate TCs

OBJECT=63 TYPE=DOUBLE_COMMAND_WITH_TIME
BLOCK=0 POINTS=3600,3699
OBJECT=64 TYPE=REGULATING_STEP_COMMAND_WITH_TIME BLOCK=0 POINTS=3700,3999
OBJECT=67 TYPE=SET_POINT_NORMALIZED_VALUE BLOCK=0 POINTS=4000,4199
OBJECT=68 TYPE=SET_POINT_FLOAT_VALUE_WITH_TIME BLOCK=0 POINTS=4200,4499
OBJECT=69 TYPE=SET_POINT_SCALED_VALUE
BLOCK=0 POINTS=4500,4799
OBJECT=9 TYPE=SET_POINT_BIT_STRING

BLOCK=0 POINTS=4800,4999

END_OBJECT_DESCRIPTION

CLG870.5-104
Software Installation Manual

PSM31A40397.38/72

2.3.2.4

Definition of the Variable Lists of Each IEC Object

Important: In order to optimize the bandwidth of the link the variable identifiers of
each object must be consecutive: the IEC 870.5-104 protocol is much more efficient
when it transmits a group of variables with consecutive addresses in an ASDU than
when it transmits variables with discontinuous addresses.
The line OBJECT_DEVICE=<Device identifier> corresponds to the header of
this definition block. The identifier of the device must be the same as that defined in
the previous definition block (delimited by the key words DESCRIPTION_DEVICE=<
Device identifier> or DESCRIPTION_REMOTE_DEVICE=<Device
identifier> ... END_DEVICE)
The line END_OBJECT_DEVICE terminates this definition block.
This block must contain the variable lists of all the objects defined in the previous
block. An object variable list is delimited by the following key words:
DATA_OBJECT=<Object identifier>
Definition of the first variable in the object
Definition of the second variable in the object
....
Definition of the last variable in the object
END_DATA_OBJECT
The object identifier is the identifier used to define the object in the previous block.
Then a control of the object type is done depending of the type of the current device.
For a <Device identifier> of type DESCRIPTION_DEVICE, the allowed
objects are the following:
- SINGLE_POINT,
- SINGLE_POINT_WITH_TIME,
- DOUBLE_POINT,
- DOUBLE_POINT_WITH_TIME,
- MEASURED_NORMALIZED_VALUE,
- MEASURED_NORMALIZED_VALUE_WITH_TIME,
- MEASURED_SCALED_VALUE, and assimilated MEASURED_INTEGER_VALUE,
- MEASURED_SCALED_VALUE_WITH_TIME,
- MEASURED_FLOAT_VALUE,
- MEASURED_FLOAT_VALUE_WITH_TIME,

CLG870.5-104
Software Installation Manual

PSM31A40397.39/72

- STEP_POSITION,
- STEP_POSITION_WITH_TIME,
- INTEGRATED_TOTAL,
- INTEGRATED_TOTAL_WITH_TIME,
- SINGLE_COMMAND,
- SINGLE_COMMAND_WITH_TIME,
- DOUBLE_COMMAND,
- DOUBLE_COMMAND_WITH_TIME,
- REGULATING_STEP_COMMAND,
- REGULATING_STEP_COMMAND_WITH_TIME,
- SET_POINT_NORMALIZED_VALUE,
- SET_POINT_NORMALIZED_VALUE_WITH_TIME,
- SET_POINT_SCALED_VALUE,
- SET_POINT_FLOAT_VALUE,
- SET_POINT_SCALED_VALUE_WITH_TIME,
- SET_POINT_FLOAT_VALUE_WITH_TIME,
- SET_POINT_BIT_STRING.
For a <Device identifier> of type DESCRIPTION_REMOTE_DEVICE (i.e. data
transfer in reverse direction), the allowed objects are the following:
- SINGLE_POINT_FROM_MASTER,
- SINGLE_POINT_WITH_TIME_FROM_MASTER,
- DOUBLE_POINT_FROM_MASTER,
- DOUBLE_POINT_WITH_TIME_FROM_MASTER,
- MEASURED_NORMALIZED_VALUE_FROM_MASTER,
- MEASURED_NORMALIZED_VALUE_WITH_TIME_FROM_MASTER,
- MEASURED_SCALED_VALUE_FROM_MASTER,

CLG870.5-104
Software Installation Manual

PSM31A40397.40/72

- MEASURED_SCALED_VALUE_WITH_TIME_FROM_MASTER,
- MEASURED_FLOAT_VALUE_FROM_MASTER,
- MEASURED_FLOAT_VALUE_WITH_TIME_FROM_MASTER,
- STEP_POSITION_FROM_MASTER,
- STEP_POSITION_WITH_TIME_FROM_MASTER,
All the variables in a single object must be of the same type. The variable type must
be compatible with the object type. The key words used to define the different kinds
of variable are:
. DATA_TS (<TS parameters>): Definition of a TS. The IEC objects that
contain this kind of definition are of SINGLE_POINT or
SINGLE_POINT_WITH_TIME type,
. DATA_DOUBLE_TS (<Dual TS parameters>): Definition of a dual TS. The
IEC objects that contain this kind of definition are of DOUBLE_POINT or
DOUBLE_POINT_WITH_TIME type,
. DATA_TM (<TM parameters>): Definition of a TM. The IEC objects that
contain this kind of definition are of the type:
MEASURED_NORMALIZED_VALUE
MEASURED_NORMALIZED_VALUE_WITH_TIME
MEASURED_SCALED_VALUE
MEASURED_SCALED_VALUE_WITH_TIME
MEASURED_FLOAT_VALUE
MEASURED_FLOAT_VALUE_WITH_TIME
. DATA_VR (<VR parameters>): Definition of a VR.
MEASURED_INTEGER_VALUE type objects are exchanged via the channel of
MEASURED_SCALED_VALUE type IEC objects, The other objects that
contain VRs are of the type:
STEP_POSITION
STEP_POSITION_WITH_TIME
. DATA_COUNTER (<Counter parameters>): Definition of a counter. The IEC
objects that contain this kind of definition are of the type:
INTEGRATED_TOTAL
INTEGRATED_TOTAL_WITH_TIME
. DATA_TC (<TC parameters>) closed by END_DATA_TC: Definition of a TC.
The IEC objects that contain this kind of definition are of the type:
SINGLE_COMMAND
CLG870.5-104
Software Installation Manual

PSM31A40397.41/72

SINGLE_COMMAND_WITH_TIME
DOUBLE_COMMAND
DOUBLE_COMMAND_WITH_TIME
REGULATING_STEP_COMMAND
REGULATING_STEP_COMMAND_WITH_TIME
. DATA_TVC (<TVC parameters>): Definition of a TVC. The IEC objects that
contain this kind of definition are of the type:
SET_POINT_NORMALIZED_VALUE
SET_POINT_NORMALIZED_VALUE_WITH_TIME
SET_POINT_SCALED_VALUE
SET_POINT_SCALED_VALUE_WITH_TIME
SET_POINT_FLOAT_VALUE
SET_POINT_FLOAT_VALUE_WITH_TIME
SET_POINT_BIT_STRING
. DATA_PARAMETER (<Parameters of a parameter>): Definition of a
parameter. The IEC objects that contain this kind of definition are of the type:
PARAMETER_NORMALIZED_VALUE
PARAMETER_SCALED_VALUE - not implemented
PARAMETER_FLOAT_VALUE

The received objects from a remote LRU of the controlling station (in
reverse direction) are distinguished by the use of distinct variable types
(suffix _FROM_MASTER):
. DATA_TSP (<Received TS parameters>): Definition of received TS.
The IEC objects containing this kind of information are of type
SINGLE_POINT_FROM_MASTER or SINGLE_POINT_WITH_TIME_FROM_MASTER,
. DATA_DOUBLE_TSP (<Received double TS parameters>): Definition of
received double TS. The IEC objects containing this kind of information are of type
DOUBLE_POINT_FROM_MASTER or DOUBLE_POINT_WITH_TIME_FROM_MASTER,
. DATA_TMP (<Received TM parameters>): Definition of received TM.
The IEC objects containing this kind of information are of type
MEASURED_NORMALIZED_VALUE_FROM_MASTER
MEASURED_NORMALIZED_VALUE_WITH_TIME_FROM_MASTER
MEASURED_FLOAT_VALUE_FROM_MASTER
MEASURED_FLOAT_VALUE_WITH_TIME_FROM_MASTER
MEASURED_SCALED_VALUE_FROM_MASTER
MEASURED_SCALED_VALUE_WITH_TIME_FROM_MASTER

CLG870.5-104
Software Installation Manual

PSM31A40397.42/72

Examples of definitions of variable lists:

# List of SINGLE_POINT object variables:
DATA_OBJECT=1
DATA_TS (<Parameters of the first non-timetagged TS>)
....
DATA_TS (<Parameters of the last non-timetagged TS>)
END_DATA_OBJECT
# List of SINGLE_POINT_WITH_TIME object variables:
DATA_OBJECT=2
DATA_TS (<Parameters of the first timetagged TS>)
....
DATA_TS (<Parameters of the last timetagged TS>)
END_DATA_OBJECT
# List of DOUBLE_POINT object variables:
DATA_OBJECT=31
DATA_DOUBLE_TS (<Parameters of the first non-timetagged dual TS >)
....
DATA_DOUBLE_TS (<Parameters of the last non-timetagged dual TS >)
END_DATA_OBJECT
# List of DOUBLE_POINT_WITH_TIME object variables:
DATA_OBJECT=32
DATA_DOUBLE_TS (<Parameters of the first timetagged dual TS >)
....
DATA__DOUBLE_TS (<Parameters of the last timetagged dual TS >)
END_DATA_OBJECT
# List of MEASURED_NORMALIZED_VALUE object variables:
DATA_OBJECT=3
DATA_TM (<Parameters of the first normalized TM >)
....
DATA_TM (<Parameters of the last normalized TM >)
END_DATA_OBJECT
# List of MEASURED_SCALED_VALUE object variables:
DATA_OBJECT=4
DATA_TM (<Parameters of the first scaled TM >)
....
DATA_TM (<Parameters of the last scaled TM >)
END_DATA_OBJECT
# List of MEASURED_FLOAT_VALUE_WITH_TIME object variables
DATA_OBJECT=5
DATA_TM (<parameters of the first floating TM >)
....
DATA_TM (<parameters of the last floating TM >)
END_DATA_OBJECT
#
List
of
DATA_OBJECT=6
DATA_COUNTER
....
DATA_COUNTER
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

INTEGRATED_TOTAL
(<Parameters

of

(<Parameters

of

object
the
the

variables:

first

counter>)

last

counter>)

PSM31A40397.43/72

# List of INTEGRATED_TOTAL_WITH_TIME object variables:

DATA_OBJECT=7
DATA_COUNTER (<Parameters of the first counter>)
....
DATA_COUNTER (<Parameters of the last counter>)
END_DATA_OBJECT
# List of MEASURED_INTEGER_VALUE object variables:
DATA_OBJECT=10
DATA_VR (<Parameters of the first VR>)
....
DATA__VR (<Parameters of the last VR>)
END_DATA_OBJECT
# List of SINGLE_COMMAND object variables:
DATA_OBJECT=61
DATA_TC
<Parameters of the first direct TC>
END_DATA_TC
....
DATA_TC
<Parameters of the last direct TC>
END_DATA_TC
END_DATA_OBJECT
# List of SINGLE_COMMAND object variables:
DATA_OBJECT=62
DATA_TC
<Parameters of the first Select Before Operate TC>
END_DATA_TC
....
DATA_TC
<Parameters of the last Select Before Operate TC>
END_DATA_TC
END_DATA_OBJECT
# List of DOUBLE_COMMAND_WITH_TIME object variables:
DATA_OBJECT=63
DATA_TC
<Parameters of the first Select Before Operate TC>
END_DATA_TC
....
DATA_TC
<Parameters of the last Select Before Operate TC>
END_DATA_TC
END_DATA_OBJECT
# List of REGULATING_STEP_COMMAND_WITH_TIME object variables:
DATA_OBJECT=64
DATA_TC
<Parameters of the first TC>
END_DATA_TC
....
DATA_TC
<Parameters of the last TC>
END_DATA_TC
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

PSM31A40397.44/72

# List of SET_POINT_NORMALIZED_VALUE object variables:

DATA_OBJECT=67
DATA_TVC (<Parameters of the first standardized TVC >)
....
DATA_TVC (<parameters of the last standardized TVC >)
END_DATA_OBJECT
# List of SET_POINT_FLOAT_VALUE_WITH_TIME object variables:
DATA_OBJECT=68
DATA_TVC (<Parameters of the first floating TVC >)
....
DATA_TVC (<Parameters of the last floating TVC >)
END_DATA_OBJECT
# List of SET_POINT_SCALED_VALUE object variables:
DATA_OBJECT=69
DATA_TVC (<Parameters of the first scaled TVC >)
....
DATA_TVC (<Parameters of the last scaled TVC >)
END_DATA_OBJECT
# List of SET_POINT_BIT_STRING object variables:
DATA_OBJECT=9
DATA_TVC (<Parameters of the first scaled TVC >)
....
DATA_TVC (<Parameters of the last scaled TVC >)
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

PSM31A40397.45/72

2.3.2.5

Definition of TS Parameters
The parameters of a TS are declared as follows:
DATA_TS (POINT=<p> KEY=<Key> [LIB=<Label>] [ADR_CSSF=<q>])
where:
POINT=<p>: number used to identify the TS during exchanges with the controlling
station. The identifier of the TS is equal to <p> + <Base>.
(<Base> is the base number of the object variable identifiers in which the TS is
defined),
KEY=<Key>: Centralog key of the TS.
LIB=<Label>: Label of the variable (in a word). This label is used as a comment.
For example the controlling station TS key could be used. This parameter is optional.
ADR_CSSF=<q>: System CSS-F address used to identify the TS during exchanges
between the system CSS-F and the application CSS-F. This parameter is optional
for the slave IEC.
Important: It is possible to reserve a point for subsequent use.
In this case the following declaration is made:
DATA_TS (POINT=45 NO_KEY LIB=TS_reserved)
The CLG870.5-104 software application never sends this TS to the controlling
station.
E.g.
DATA_OBJECT=2
DATA_TS (POINT=500
DATA_TS (POINT=501
DATA_TS (POINT=502
DATA_TS (POINT=503
.....
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

KEY=TSRAUT1000)
KEY=TSRAUT1001)
NO_KEY)
KEY=TSRAUT1003)

PSM31A40397.46/72

2.3.2.6

Definition of Dual TS Parameters

The parameters of a dual TS are declared as follows:
DATA_DOUBLE_TS( POINT=<p>
TS_OPEN=<Key> TS_CLOSE=<Key> TS_FAULT=<Key>
[LIB=<Label>] )
Where:
POINT=<p>: number used to identify the dual TS during exchanges with the
controlling station. The identifier of the dual TS is equal to <p> + <Base>.
(<Base> is the base number of the object variable identifiers in which the dual TS
is defined),
TS_OPEN=<Key>: Centralog key of the single open TS, used in the composition of
the dual TS,
TS_CLOSE=<Key>: Centralog key of the single close TS, used in the composition of
the dual TS,
TS_FAULT=<Key>: Centralog key of the single malfunction TS, used in the
composition of the dual TS,
Important: The table giving the state of a dual TS as a function of the state of
each of its components, used in its composition, is defined in the
system configuration file via the parameters OCFxxx.
LIB=<Label>: label of the variable (in a word). This label is used as a comment.
For example the controlling station key of the dual TS can be used.
This parameter is optional.
Important: It is possible to reserve a point for subsequent use.
In this case the following declaration is made:
DATA_DOUBLE_TS (POINT=833 NO_KEY LIB=TS_double_reserved)
The CLG870.5-104 software never transmits this dual TS to the controlling station.
E.g.
DATA_OBJECT=31
DATA_DOUBLE_TS(POINT=800
DATA_DOUBLE_TS(POINT=801

TS_OPEN=01KCZUS08SM1
TS_CLOSE=01KCZUS08SM2
TS_FAULT=01KCZUS08SM3)
TS_OPEN=01KCZUS09SM1
TS_CLOSE=01KCZUS09SM2
TS_FAULT=01KCZUS09SM3)

.....
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

PSM31A40397.47/72

2.3.2.7

Definition of TM Parameters
The parameters of a TM are declared as follows:
DATA_TM (POINT=<p>
KEY=<Key> [ADR_CSSF=<q>]
[OFFSET=<Offset>]
[COEFF=<Coeff>]
[DEADBAND=<Deviation>][LIB=<Label>] )
Where:
POINT=<p>: number used to identify the TM during exchanges with the controlling
station. The identifier of the TM is equal to <p> + <Base>.
KEY=<Key>: Centralog key of the TM.
OFFSET=<Offset>: offset of the formula used to convert the Centralog value of the
TM into the value transmitted to the controlling station. The value resulting from the
formula is then adapted to the format of the ASDU used to transmit the TM
(whatever the type of ASDU, the value transmitted is in 16 bits). This parameter is
optional; by default it is equal to 0.0
COEFF=<Coeff>: coefficient of the formula used to convert the Centralog value of
the TM into the value transmitted to the controlling station. This parameter is
optional; by default it is equal to 1.0
Important: The OFFSET and COEFF parameters of a TM must be defined in
order to match the ASDU used. For example for a normalized TM (ASDU 0x9)
varying between 0 and 2000 an offset of -1000 and a coefficient of 1000 could be
selected so that the measurement transmitted will always be between -1 and 1.
DEADBAND=<Deviation>:this parameter is used when:
The mode of transmission of the variables is the delta-mode (DELTA_MODE=YES) for
the non-timetagged TM,
For the timetagged TM, this parameter is not taken in account if a parameter
Deadband exists and is transmitted by the Controlling station.
It indicates the limit beyond which the value of the TM is considered to have
changed, thus triggering transmission to the controlling station. This is an absolute
value applied to the Centralog value (32 bits) of the TM.
This parameter is optional; by default it is equal to 0.0
LIB=<Label>: label of the variable (in a word). This label is used as a comment. It
is optional.
ADR_CSSF=<q>: system CSS-F address used to identify the TM during exchanges
between the system CSS-F and the application CSS-F. This parameter is optional
for the slave IEC.

CLG870.5-104
Software Installation Manual

PSM31A40397.48/72

Important: It is possible to reserve a point for subsequent use.

In this case the following declaration is made:
DATA_TM (POINT=1123 NO_KEY LIB=TM_reserved)
E.g.
DATA_OBJECT=4
DATA_TM (POINT=1501
DEADBAND=10)
DATA_TM (POINT=1502
DEADBAND=7.4)
DATA_TM (POINT=1503
DATA_TM (POINT=1504
.....
END_DATA_OBJECT

2.3.2.8

KEY=PRO-TMP01 OFFSET=-1000 COEFF=-10

KEY=PRO-TMP02 OFFSET=1000 COEFF=5.5
NO_KEY)
KEY=PRO-TMP04)

Definition of VR Parameters
The parameters of a VR are declared as follows:
DATA_VR (POINT=<p> KEY=<Key> [LIB=<Label>] [ADR_CSSF=<q>] )
Where:
POINT=<p>: number used to identify the VR during exchanges with the controlling
station. The identifier of the VR is equal to <p> + <Base> (<Base> is the base
number of the object variable identifiers in which the VR is defined).
KEY=<Key>: Centralog key of the VR.
LIB=<Label>: label of the variable (in a word). This label is used as a comment.
For example the controlling station TS key can be used.
This parameter is optional.
ADR_CSSF=<q>: system CSS-F address used to identify the VR during exchanges
between the system CSS-F and the application CSS-F. This parameter is optional
for the slave IEC.
Important: It is possible to reserve a point for subsequent use. In this case the
following declaration is made:
DATA_VR (POINT=50 NO_KEY LIB=VR_reserved)
The CLG870.5-104 software never transmits this VR to the controlling station.
E.g.
DATA_OBJECT=10
DATA_VR (POINT=3000
DATA_VR (POINT=3001
DATA_VR (POINT=3002
DATA_VR (POINT=3003
.....
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

KEY=01VRE00)
KEY=02VRE00)
NO_KEY)
KEY=03VRE00)

PSM31A40397.49/72

2.3.2.9

Definition of Counter Parameters

The parameters of a counter are declared as follows:
DATA_COUNTER (POINT=<p> KEY=<Key>
[MAX=<Maximum of the TM counter>]
[LIB=<Label>] )
Where:
POINT=<p>: number used to identify the counter during exchanges with the
controlling station. The identifier of the counter is equal to <p> + <Base>.
KEY=<Key>: Centralog key of the counter TM
MAX=<Maximum of the counter TM>: maximum value that the counter TM can
take: this parameter is used to establish the increment in the counter transmitted to
the controlling station when the TM counter resets to 0 after reaching this
maximum. To ensure that the counter is correctly calculated the low limit of the TM
must equal 0 and the high limit must equal the value of this parameter. The value
selected by default is 100000.
LIB=<Label>: label of the variable (in a word). This label is used as a comment. It
is optional.
Important: It is possible to reserve a point for subsequent use.
In this case the following declaration is made:
DATA_COUNTER (POINT=2003 NO_KEY LIB=Counter_reserved)
E.g.
DATA_OBJECT=5
DATA_COUNTER (POINT=2001
DATA_COUNTER (POINT=2002
DATA_COUNTER (POINT=2003
DATA_COUNTER (POINT=2004
.....
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

KEY=PRO-TMI01 MAX=500000)
KEY=PRO-TMI02 MAX=500000)
NO_KEY)
KEY=PRO-TMI04 MAX=500000)

PSM31A40397.50/72

2.3.2.10

Definition of TC Parameters
The parameters of a command transmitted by the controlling station are declared as
follows:
DATA_TC
TYPE=<Type of the TC>
POINT=<p>
[LIB=<Label>]
[PROCESS_VAR =<YES/NO>]
[TC_SELECT(<Characteristic of the Centralog TC>)]
[TC_DESELECT(<Characteristic of the Centralog TC>)]
TC_SIMPLE(<Characteristic of the Centralog TC>)
OR
TC_ON(<Characteristic of the Centralog TC>)
TC_OFF(<Characteristic of the Centralog TC>)
OR
TC_ON_SHORT(<Characteristic of the Centralog TC>)
TC_OFF_SHORT(<Characteristic of the Centralog TC>)
OR
TC_ON_LONG(<Characteristic of the Centralog TC>)
TC_OFF_LONG(<Characteristic of the Centralog TC>)
OR
TC_ON_PERSISTENT(<Characteristic of the Centralog TC>)
TC_OFF_PERSISTENT (<Characteristic of the Centralog TC>)
OR
TC_ON_SHORT(<Characteristic of the Centralog TC>)
TC_ON_LONG (<Characteristic of the Centralog TC>)
TC_OFF_SHORT(<Characteristic of the Centralog TC>)
TC_OFF_LONG(<Characteristic of the Centralog TC>)
OR
TC_HIGHER(<Characteristic of the Centralog TC>)
TC_LOWER(<Characteristic of the Centralog TC>)
OR
TC_HIGHER_SHORT(<Characteristic of the Centralog TC>)
TC_LOWER_SHORT(<Characteristic of the Centralog TC>)
OR
TC_HIGHER_LONG(<Characteristic of the Centralog TC>)
TC_LOWER_LONG(<Characteristic of the Centralog TC>)
OR
TC_HIGHER_SHORT(<Characteristic of the Centralog TC>)
TC_HIGHER_LONG (<Characteristic of the Centralog TC>)
TC_LOWER_SHORT(<Characteristic of the Centralog TC>)
TC_LOWER_LONG(<Characteristic of the Centralog TC>)
END_DATA_TC
With:
TYPE=<Type of the TC>: This parameter indicates the type of the TC. The
possible values are:

CLG870.5-104
Software Installation Manual

PSM31A40397.51/72

. TC_DIRECT: case of a direct command. On reception of the command, a hold

TC (defined with the TC_SIMPLE parameter) or one of the pulse TCs (defined
with the TC_ON and TC_OFF parameters) is transmitted to the CIS. The choice of
the pulse TC transmitted to the CIS depends on the value of the command
transmitted by the controlling station: 0 = transmission of the TC_OFF, 1 =
transmission of the TC_ON
. TC_SBO: case of a Select Before Operate TC:
- during selection, the command is selected locally; if a selection TC has been
defined (via the parameter TC_SELECT) it is transmitted to the CIS,
- During deselection, the command is locally deselected; if a TC of deselection
has been defined (via the parameter TC_DESELECT) it is transmitted to the
CIS,
- during execution, if the command is selected, a hold TC (defined with the
parameter TC_SIMPLE) or one of the pulse TCs (defined with the parameters
TC_ON and TC_OFF) is transmitted to the CIS. The choice of the Pulse TC
transmitted to the CIS depends on the value of the command transmitted by
the controlling station: 0 = transmission of the TC_OFF, 1 = transmission of
the TC_ON
. TC_QUALIFIED: case of a direct command using a qualifier. The qualifier
determines the nature of the order to the actuator: short pulse, long pulse or
persistent output. On reception of the command, a pulse TC is transmitted to the
CIS (defined with the parameters TC_ON_SHORT,TC_ON_LONG,
TC_ON_PERSISTENT, TC_OFF_SHORT, TC_OFF_LONG,or
TC_OFF_PERSISTENT). The choice of the pulse TC transmitted to the CIS
depends on the value and on the qualifier of the command transmitted by the
controlling station:
- value: 0 transmission of the OFF TC, 1 transmission of the ON TC taking
account of the qualifier
- qualifier: transmission of the TC (ON or OFF depending on the
value)_(SHORT or LONG or PERSISTENT)
. TC_SBO_QUALIFIED: case of a Select Before Operate using a qualifier TC > the
qualifier determines the nature of the order to the actuator: short, long or
persistent:
- during selection, the command is selected locally; if a selection TC has been
defined (via the parameter TC_SELECT) it is transmitted to the CIS,
- During deselection, the command is locally deselected; if a TC of deselection
has been defined (via the parameter TC_DESELECT) it is transmitted to the
CIS,

CLG870.5-104
Software Installation Manual

PSM31A40397.52/72

- if the command is selected during execution, a pulse TC is transmitted to the

CIS (defined with the parameters TC_ON_SHORT,TC_ON_LONG,
TC_ON_PERSISTENT, TC_OFF_SHORT, TC_OFF_LONG,or
TC_OFF_PERSISTENT). The choice of the pulse TC transmitted to the CIS
depends on the value and on the qualifier of the command transmitted by the
controlling station:
. value: 0 transmission of the OFF TC, 1 transmission of the ON TC taking
account of the qualifier
. qualifier: transmission of the TC(ON or OFF depending on the
value)_(SHORT or LONG or PERSISTENT)
Important: Each TC transmission to the CIS is only effective if the authorization
checks are correct
POINT=<p>: number used to identify the TC during exchanges with the controlling
station. The identifier of the TC is equal to <p> + <Base>.
LIB=<Label>: label of the command (in a word). This label is used as a comment.
It is optional.
PROCESS_VAR=<YES/NO>: Indicates that the command results from the reception
of a TS in bi-directional mode. Optional parameter; the default value is NO.
TC_SELECT: definition of the Centralog TC used to execute selection. This parameter
is only used in the case of a Select Before Operate TC. Even in this case it is
optional.
TC_DESELECT: definition of the Centralog TC used to execute deselection. This
parameter is only used in the case of a Select Before Operate TC. Even in this case
it is optional,
TC_SIMPLE: definition of the Centralog command execution TC. This parameter is
used when the controlling station command is transmitted to the CIS by means of a
hold TC,
TC_OFF: definition of the Centralog command execution TC when it is equal to 0.
This parameter is used when the controlling station command is transmitted to the
CIS by means of 2 single pulse TCs,
TC_ON: definition of the Centralog command execution TC when this is equal to 1.
This parameter is used when the command originating from the controlling station
is transmitted to the CIS by means of 2 single pulse TCs,
TC_OFF_SHORT: definition of the Centralog Command execution TC when this is
equal to 0 and when the qualifier corresponds to "short pulse". This parameter is
used when the command originating from the controlling station is transmitted to
the CIS by means of 2 single pulse TCs,

CLG870.5-104
Software Installation Manual

PSM31A40397.53/72

TC_ON_SHORT: definition of the Centralog Command execution TC when this is

equal to 1 and when the qualifier corresponds to "short pulse". This parameter is
used when the command originating from the controlling station is transmitted to
the CIS by means of 2 single pulse TCs,
TC_OFF_LONG: definition of the Centralog Command execution TC when this is
equal to 0 and when the qualifier corresponds to "long pulse". This parameter is
used when the command originating from the controlling station is transmitted to
the CIS by means of 2 single pulse TCs,
TC_ON_LONG: definition of the Centralog Command execution TC when this is equal
to 1 and when the qualifier corresponds to "long pulse". This parameter is used
when the command originating from the controlling station is transmitted to the CIS
by means of 2 single pulse TCs,
TC_OFF_PERSISTENT: definition of the Centralog Command execution TC when
this is equal to 0 and when the qualifier corresponds to "persistent output". This
parameter is used when the command originating from the controlling station is
transmitted to the CIS by means of 2 single pulse TCs,
TC_ON_PERSISTENT: definition of the Centralog Command execution TC when this
is equal to 1 and when the qualifier corresponds to "persistent output". This
parameter is used when the command originating from the controlling station is
transmitted to the CIS by means of 2 single pulse TCs,
Important: The presence of the TC_SIMPLE parameter or the TC_ON and
TC_OFF parameters is mandatory on TC_DIRECT and TC_SBO type commands.
The presence of the TC_ON_<qualifier> and TC_OFF_<qualifier>
parameters is mandatory on TC_QUALIFIED and TC_SBO_QUALIFIED type
commands for at least one qualifier.
The characteristics of a Centralog TC are defined as follows:
TC_<Function>(TC=<TC key> [ADR_CSSF=<q>]
[TS_AUTO=<TS key>] [SENS_AUTO=<Authorization TS sense>]
[TS_RET=< TS key>] [SENS_RET=<Execution TS sense>]
[DELAY=<Delay>])
Where:
TC=<TC key>: Centralog key of the TC
TS_AUTO=<TS key>: key of the authorization TS associated with the TC. This
parameter is optional.
SENS_AUTO=<Authorization TS sense>: value that the authorization TS of the
TC must have for its transmission to be authorized. This parameter is optional; if it
is absent when an authorization TS has been defined, its default value is 0 .
TS_RET=<TS key>: key of the return TS associated with the TC. This parameter is
optional.

CLG870.5-104
Software Installation Manual

PSM31A40397.54/72

SENS_RET=<Execution TS sense>: value that the return TS must have after

execution of the TC. This parameter is optional; if it is absent when a return TS has
been defined, its default value is 0.
DELAY=<Delay>: TC execution delay in seconds. This parameter is optional; if it is
absent when a return TS has been defined, its default value is 60.
ADR_CSSF=<q>: system CSS-F address used to identify the direct TC during the
exchanges between the system CSS-F and the application CSS-F. This parameter is
optional for the slave IEC.
Example 1:
# Direct command object
DATA_OBJECT=61
# The controlling station command is sent to the CIS via a
# hold TC
DATA_TC
TYPE_TC=TC_DIRECT
POINT=3001
TC_SIMPLE (
TC=HYD-TCE01
TS_AUTO=PRO-TSP10 SENS_AUTO=1
TS_RET=TSRAUT1000 SENS_RET=1 DELAY=90)
END_DATA_TC
# The controlling station command is sent to the CIS via two
# single pulse TCs
DATA_TC
TYPE_TC=TC_DIRECT
POINT=3002
TC_OFF
(
TC=HYD-TCE02
TS_AUTO=PRO-TSP11 SENS_AUTO=1
TS_RET=TSRAUT1001 SENS_RET=0 DELAY=90)
TC_ON (
TC=HYD-TCE03
TS_AUTO=PRO-TSP11 SENS_AUTO=1
TS_RET=TSRAUT1001 SENS_RET=1 DELAY=90)
END_DATA_TC
....
END_DATA_OBJECT
Example 2:
#Select Before Operate command object
DATA_OBJECT=62
DATA_TC
TYPE_TC=TC_SBO
POINT=3003
TC_SELECT (
TC=HYD-TCE05 )
TC_DESELECT( TC=HYD-TCE06)
TC_SIMPLE ( TC=HYD-TCE07
TS_AUTO=PRO-TSP13 SENS_AUTO=0
TS_RET=TSRAUT1002 SENS_RET=1 DELAY=90)
END_DATA_TC
....
END_DATA_OBJECT

CLG870.5-104
Software Installation Manual

PSM31A40397.55/72

2.3.2.11

Definition of TVC Parameters

The parameters of a TVC are declared as follows:
DATA_TVC(POINT=<p> TVC=<Key TVC> [ADR_CSSF=<q>]
[OFFSET=<Offset>] [COEFF=<Coeff>][LIB=<Label>]
[PROCESS_VAR =<YES/NO>]
[DEADBAND=<Deviation>]
[TS_AUTO=<TS key>] [SENS_AUTO=<Authorization TS sense>]
[TM_RET=<TM key >] [TOLERANCE=<Dm>] [DELAY=<Delay>])
Where:
POINT=<p>: number used to identify the TVC during exchanges with the controlling
station. The identifier of the TVC equal to <p> + <Base>,
TVC=<TVC key>: Centralog key of the TVC,
OFFSET=<Offset>: offset of the formula used to convert the transmitted value of
the setpoint originating from the controlling station into a Centralog value. Before
conversion the 16-bit value received is transformed into a 32-bit value, taking
account of the ASDU type of the TVC. This parameter is optional; by default it is
equal to 0.0
COEFF=<Coeff>: coefficient of the formula used to convert the transmitted value of
the setpoint originating from the controlling station into a Centralog value. This
parameter is optional; by default it is equal to 1.0
Important:The OFFSET and COEFF parameters of a TVC must be defined to
match the ASDU used. For example for a normalized TVC (ASDU 0x30) varying
between 0 and 2000 an offset of -1000 and a coefficient of 1000 could be
selected so that the measurement transmitted between -1 and 1 will be converted
into a setpoint between 0 and 2000.
LIB=<Label>: label of the variable (in a word). This label is used as a comment. It
is optional.
PROCESS_VAR=<YES/NO>: Indicates that the setpoint results from the reception of a
TM in bi-directional mode. Optional parameter; the default value is NO.
DEADBAND=<Deviation>:This parameter is used to limit the flow of TVCs
generated by the reception of TMs in bi-directional mode. It indicates the
deadband outside of which the value of the TVC is considered to have changed,
thus triggering its transmission to the cell controller. The deadband is an absolute
value applied to the Centralog value (32 bits) of the TVC. This parameter is
optional; by default it is equal to 0.0
ADR_CSSF=<q>: system CSS-F address used to identify the TVC during exchanges
between the system CSS-F and the application CSS-F. This parameter is optional
for the slave IEC.

CLG870.5-104
Software Installation Manual

PSM31A40397.56/72

TS_AUTO=<TS key>: key of the authorization TS associated with the TVC. This
parameter is optional.
SENS_AUTO=<Authorization TS sense>: value that the authorization TS of the
TVC must have for its transmission to be authorized. This parameter is optional; if it
is absent when an authorization TS has been defined, its default value is 0 .
TM_RET=<TM key>: key of the return TM associated with the TVC. This parameter is
optional.
TOLERANCE=<Dm>: maximum deviation tolerated between the setpoint and the
return value of the TM associated with the TVC, for the CLG870.5-104 software
application to consider that the setpoint has been correctly taken into account. This
parameter is optional; if it is absent when a return TM has been defined, its default
value is 0.0.
DELAY=<Delay>: TVC execution delay in seconds. This parameter is optional; if it is
absent when a return TM has been defined, its default value is 60.
Important: It is possible to reserve a point for subsequent use.
In this case the following declaration is made:
DATA_TVC (POINT=5678 NO_KEY LIB=TVC_reserved)
E.g.
DATA_OBJECT=7
DATA_TVC(POINT=4001 KEY=PRO-TVC01
OFFSET=100 COEFF=50
TS_AUTO=TSRAUT1040 SENS_AUTO=0
TM_RET=PRO-TMPESS01 TOLERANCE=10 DELAY=30)
DATA_TVC(POINT=4002 NO_KEY)
.....
END_DATA_OBJECT

2.3.2.12

Definition of TSP Parameters

A TSP is declared like a TC with certain particularities as explained below.
The parameters of a TM are declared as follows:
DATA_TC
TYPE= TC_DIRECT
POINT=<p>
[LIB=<Label>]
TC_SIMPLE(TSP = <TSP key>)
END_DATA_TC
Where:
POINT=<p>: number used to identify the TC during exchanges with the controlling
station. The identifier of the TC is equal to <p> + <Base>.

CLG870.5-104
Software Installation Manual

PSM31A40397.57/72

LIB=<Label>: label of the TSP (in a word). This label is used as a comment. It is
optional.
TSP=<TSP key>: Centralog key of the TSP

2.3.2.13

Definition of TMP Parameters

A TMP is declared like a TVC with certain particularities as explained below.
The parameters of a TM are declared as follows:
DATA_TVC
POINT=<p>
TMP = <TMP key>)
[OFFSET=<Offset>] [COEFF=<Coeff>][LIB=<Label>]
[DEADBAND=<Deviation>]
END_DATA_TVC
With:
POINT=<p>: number used to identify the TMP during exchanges with the controlling
station. The identifier of the TVC equal to <p> + <Base>,
TMP=<TMP key>: Centralog key of the TMP,
OFFSET=<Offset>: offset of the formula used to convert the transmitted value of
the setpoint originating from the controlling station into a Centralog value. Before
conversion the 16-bit value received is transformed into a 32-bit value taking
account of the TMP ASDU type.
This parameter is optional; by default it is equal to 0.0.
COEFF=<Coeff>: coefficient of the formula used to convert the transmitted value of
the setpoint originating from the controlling station into a Centralog value. This
parameter is optional; by default it is equal to 1.0.
LIB=<Label>: label of the variable (in a word). This label is used as a comment. It
is optional.
DEADBAND=<Deviation>: This parameter is used to limit the flow of TMPs. It
indicates the deadband outside of which the value of the TMP is considered to have
changed, thus triggering its transmission to the Centralog. This is an absolute value
applied to the Centralog value (32 bits) of the TM. This parameter is optional; by
default it is equal to 0.0.

CLG870.5-104
Software Installation Manual

PSM31A40397.58/72

INSTALLATION

3.1

PRIOR STATE
As the CLG870.5-104 software application uses a QUAD type expansion board, the
board must be installed in the target station before starting to install the system.
In effect for SYSCLOG to install the board drivers correctly, the board must already
be present when the tool is executed.
The CLG870.5-104 software application can be installed either during the installation
of the system or afterwards.

3.2

INSTALLATION PROCEDURE UNDER UNIX

The CLG870.5-104 software application is installed by means of the ADM tool. The
name of this software application for the ADM tool is IEC.
Installation is performed in three phases:

3.2.1

Installation of the IEC function files,

Declaration of the IEC function on the stations on which the CLG870.5-104

software application is to be installed,

Installation of the software application on all the stations, where it is declared.

Installation of the IEC files

The IEC files installation procedure is as follows:

If the software is delivered by e-mail or by CD-ROM :

- Name of the compressed file: IecXXX.gz

- Copy the file in the directory C:\InetPub\ftproot on the Controcad Server PC,
- Log under account root on C10 Centralog (The password is by default
root_c1) ; and go under /tmp directory: cd /tmp
- Use ftp to transfer the file from the Controcad Server PC to the C10 :
ftp <Name of Controcad Server (pc0101)>
Name: anonymous

CLG870.5-104
Software Installation Manual

PSM31A40397.59/72

Password: <none> or anonymous

Under ftp:
ftp> binary

# To transfer in binary mode (MANDATORY)

ftp> get IecXXX.gz # Get file on PC

ftp> quit

If the software is delivered by a DAT:

- Insert the DAT in the drive of C10 Centralog;

- Log under account root on C10 Centralog (The password is by default
root_c1), and go under /tmp directory: cd /tmp
- Execute the following commands:
tar xvf /dev/rmt/0m
gzip -d IecXXX.gz

# uncompress file

tar xvf IecXXX

# extraction from uncompressed file

# The file extraction creates a directory LIVRAISON_XXX.

# This directory contains, documentation and a directory IecXXX_<Release>
with Software and shell script to install it:

install.sh

- Then:
cd /tmp/LIVRAISON*/IecXXX_<Release>
./install.sh
# Some files are installed under subdirectories of directory /local/af/exe
- Finally reboot the Centralog C10 (command reboot s) to install IEC function.

CLG870.5-104
Software Installation Manual

PSM31A40397.60/72

3.2.2

Adding the IEC function to the system configuration

To add the IEC function, select the "Define configuration" option in the main menu of
the adm tool:
Administration main menu
Define system parameters
Define Configuration
Deliver Cxx software
Install Cxx software
Make Cxx software
Administrator
<CR> to exit
Your choice ? 2

1
2
3
4
5
6

The current configuration is displayed. Add the IEC function on the concerned
station(s), to select:
(in the example, the function is installed on operator station 2, ws0634)
Current configuration is:
Station
Functions
System Name
------- --------------------------------------------------- ----------ws0673
CCC-S,CCC-D,CCC-M,EXP,HDSR,PRMGR,CLGTOOLS
5hob
ws0634
EXP,HDSR
5hpb
ws6603
CISSUN,CISGEN
5hsb
ws6604
CISSUN,CISGEN
5hsp
Enter station name to configure or to modify: ws0634
Enter function names[EXP,HDSR]: +IEC
Current Configuration is:
Station
Functions
System Name
------- --------------------------------------------------- ----------ws0673
CCC-S,CCC-D,CCC-M,EXP,HDSR,PRMGR,CLGTOOLS
5hob
ws0634
EXP,HDSR,IEC
5hpb
ws6603
CISSUN,CISGEN
5hsb
ws6604
CISSUN,CISGEN
5hsp

CLG870.5-104
Software Installation Manual

PSM31A40397.61/72

3.2.3

Installing the IEC function on selected stations

To install the IEC function, select the "Install CXX software" option in the main menu of
the adm tool:
Administration main menu
Define system parameters
Define Configuration
Deliver CXXs softwares
Install CXXs softwares
Make CXXs software
Administrator
<CR> to exit
Your choice ? 4

1
2
3
4
5
6

Answer to the questions as shown in the example below:

(installation of the IEC function on port qfe1 of operator station 2 ws0634)
Enter name of software: IEC
Specific installation for IEC
Install IEC software on ws0634 (y/n): y
Install IEC software on ws0634
Execute oc/piks_IEC.sh installation file
********************************
INSTALLATION OF IEC PROTOCOL
********************************
At this stage the user can choose:
to uninstall the IEC function,
to install or reinstall the IEC function one or more times on the station: each
installation consumes a gateway, an IBDD connection and an Ethernet port on the
station,
or to quit the installation without modification.
>> Warning, previous installation will be cleared !! <<
- Hit 0 to uninstall IEC protocol link
- Enter the number of IEC links to install [1..4]
- Hit return to exit to adm without any change
Enter your choice:1
>> Clearing previous IEC protocol completed!! <<

CLG870.5-104
Software Installation Manual

PSM31A40397.62/72

The label proposed by default is composed of the name of the function for ADM or of
the label that has already been input. It is completed by the number of the gateway
after input (e.g. IEC:GTW1). This label is used in the pulldown menus used to run or
stop the software application. In the example it is not modified:
***********************************
First IEC protocol link install ...
***********************************
Label of IEC protocol : IEC
New label ? :
->
The maximum number of gateways for the Centralog is 8. A single gateway cannot
be shared by several links. The installation engineer must check that the gateway
number selected is not used elsewhere in the system.
WARNING!! Each gateway number must be used only once in the
Centralog
Number(s) of Gateways available: [ 1 2 3 4 5 6 7 8 ]
Enter your choice ? :
-> 1
The menu proposes the list of the free ports on the station or the choice "other port".
The last allows the input of a name of any port without check on its presence.
Select "Other port" and indicate the name of the port Iec_Servern
Ports available:
/dev/ttya
-> 1
/dev/ttyb
-> 2
Other port
-> 3
Enter your choice: 3
New port name?
Iex_Server1
>> Creating file /local/af/exe/dc/piks_RESS_IEC.do <<
>> Creation of file /local/af/exe/sc/piks_GA_IEC.do <<
-> /local/af/exe/oc/piks_lance_IEC1.sh installed !!
IEC installation on ws0634 OK
Reinstalling the IEC function overwrites the choice defined previously.

CLG870.5-104
Software Installation Manual

PSM31A40397.63/72

3.3

INSTALLATION PROCEDURE UNDER WINDOWS NT/XP

The installation procedure is available for a CSS-G software of version 5.3.3, under
Windows NT/XP. This software runs under a Centralog version 5.3.3.

3.3.1

Hardware configuration
Controcad Server version 3.3.3,
Centralog in version 5.3.3,
ADMP320 software already installed,
CONFP320 software already installed,
An available Ethernet network port.

3.3.2

List of software media

The following support is needed:

3.3.3

CD-ROM CSS-G IEC104 (current version)

Controcad configuration
The Gateway configuration must be done on the Controcad Server imperatively
before the installation of ConfP320 on the Centralog station.
Any modification of the Gateways configuration (addition of a Gateway, for example)
on the Controcad server implies the reinstallation of ConfP320 software on the
Centralog target station.
Gateway declaration on Controcad:
1.
2.
3.
4.
5.
6.

Connect on the Controcad server,

Select the folder BD HMI of Controcad project,
Right click on folder Station and select New ,
Select GTW and enter the name and number of Gateway,
Save and generate the BD HMI,
Install ConfP320, AdmP320 softwares and the standard Centralog functions on
the CIS stations,
7. Load the Controcad Database on the Centralog
8. Check on ConfP320 configuration that the Gateway list is correct.

CLG870.5-104
Software Installation Manual

PSM31A40397.64/72

3.3.4

CSS-G installation
Important remark:
If several Gateways have to be installed on an unique machine, they must be
installed at the same time by the AdmP320 software (by indicating the final number of
Gateways to be installed), otherwise a new installation will be necessary and will reset
the former installed Gateways.
1. Log under exe account on the Centralog target station,
2. Insert the CD-ROM in the drive,
3. Copy the file IEC104_xx.tar.gz in a local directory,
4.
Uncompress the file IEC104_xx.tar.gz by using by using the tools
gzip32.exe and tar.exe located in C:\P320\bin,
-

Copy gzip32 and tar in the local directory or use absolute descriptor.

Execute the following commands:

gzip32 -d IEC104_XXX.gz

# uncompress file

tar xvf IEC104_XXX

# extraction from uncompressed file

5. Launch the script file Install_IEC_Windows.sh ,

6. Edit (by using Wordpad, for example) the file
P320\Confdata\InstallData\function.txt located in the shared
drive and add at last line, the following line:
IEC|51|N|No
7. Launch the ConfP320 tool from the Start menu,
8. Click on Modify Centralog Function configuration ,
9. Select the CIS on which the CSS-G(s) must be installed and click on Edit ,

10.Check the IEC function exists in the functions list,

11.Add the IEC by clicking on Add ,
12.Exit from ConfP320 software,

13.Log under exe account on the CIS target station,

14.Launch AdmP320 tool the Start menu CIS target station,
15.Click on Yes to change the existing configuration, and Next ,
16.For IEC function, select on Deliver et Install then valid by
Next . The useful files are delivered on the CIS the installation script is
launched,
17.Enter the number of CSS-G instances to install and for each:
18.Enter the name of the IEC function,
19.Enter the number of Gateway,
20.Edit (by using Wordpad, for example) the file
/winnt/systems32/drivers/etc/hosts and add the following line:
IP address of IEC port
IEC104ServerX
where X is the number of the chosen Gateway,

CLG870.5-104
Software Installation Manual

PSM31A40397.65/72

21.Edit (by using Wordpad, for example) the file

/winnt/systems32/drivers/etc/ and add the following line:
IEC104Tcp
2404/tcp
22.Restart the CIS target station.

3.3.5

Configuration files

3.3.5.1

System configuration file phkb_Sys_n.do

The file phkb_Sys_n.do where n is the number of the chosen Gateway, is
located in directory /P320/exe/sc.
This file is described in previous paragraph 2.3.1 Definition of the System
configuration file: phkb_Sys_***_n.do (for more information).

3.3.5.2

Data configuration file phkb_Data_n.do

The file phkb_Data_n.do where n is the number of the chosen Gateway, is
located in directory /P320/exe/sc.
This file is described in previous paragraph 2.3.2 Definition of the application Data
configuration file: phkb_Data_***_n.do (for more information).
A minimum configuration is necessary to allow a good running of CSS-G software.

3.3.6

Installation of an additional CSS-G

The installation of several Gateways, on an unique machine, must be done at the
same time by the AdmP320 software (by indicating the final number of Gateways to
be installed), otherwise a new installation will reset the former installed Gateways.

CLG870.5-104
Software Installation Manual

PSM31A40397.66/72

3.4

STARTING AND STOPPING THE SOFTWARE

3.4.1

Under UNIX
The application starts automatically when the station boots.
To stop the software application independently of the other software applications on
the station, use the pulldown menu accessible from the Window manager Desktop:
Menu: Application/IEC_Protocol/IEC:GTW1/Stop
To restart the software application independently of the other software applications
on the station, use the pulldown menu accessible from the Window manager Desktop:
Menu: Application/IEC_Protocol/IEC:GTW1/Start.
Execution is not authorized if the software application is already running.

3.4.2

Under NT
After installation of software (under exe account of Centralog target station and
CIS station), restart the CIS station by logging under clg . The application starts
automatically.
It is also possible to start or stop manually the software by the menu:
Start/Programs/IEC_GTWN_PROTOCOL/Start ,
or Start/Programs/IEC_GTWN_PROTOCOL/Stop .

CLG870.5-104
Software Installation Manual

PSM31A40397.67/72

MAINTENANCE

4.1

FILES MANIPULATED BY THE SOFTWARE APPLICATION

The files managed by the software application are indexed with the number of the
gateway used.
The diagram below shows the location of the different files manipulated in the Unix
environment:

local

tmp

af

Communication trace file:

piko_TraceCom_n.do
Configuration trace files:
phkb_InfoSys_n.do
piks_ConfApp_n.do
piks_InfoBdl_n.do
Running flag:
phkb_gtwn_run

clg

exe

protocols

sc

Counters & downloaded

parameters :
pikr_Cpt_n.do
pikr_CptWithTime_n.do
pikr_Param_n.do

Configuration files:
phkb_Sys_n.do
phkb_Data_n.do

Fig. 1: Files used by the CLG870.5-104 software application / Unix

CLG870.5-104
Software Installation Manual

PSM31A40397.68/72

The diagram below shows the location of the different files manipulated in the
Windows environment:

P320

Temp

exe
Communication trace file:
piko_TraceCom_n.do

Tmp

Configuration trace files:

phkb_InfoSys_n.do
piks_ConfApp_n.do
piks_InfoBdl_n.do

protocoles

Running flag:
phkb_gtwn_run

sc

Counters & downloaded

parameters :
pikr_Cpt_n.do
pikr_CptWithTime_n.do
pikr_Param_n.do

Configuration files:
phkb_Sys_n.do
phkb_Data_n.do

Fig. 2: Files used by the CLG870.5-104 software application / Windows

The phkb_gtwn_run file is used as a pseudo-semaphore to disable the startup of

the CLG870.5-104 software application associated to gateway n if it is already in
operation.
The following files are systematically produced on startup:
phkb_InfoSys_n.do: information on the configuration system,
piks_ConfApp_n.do: information on the configuration of the application data,
piks_InfoBdl_n.do: information on the content of the local database.
The following files are produced and updated during the lifetime of the software
application, if the option TRACE_COM=YES:
piko_TraceCom_n.do: traces the frames exchanged on the serial link (maximum
10,000 lines),
piko_TraceCom_n.old: save of the previous trace file.

CLG870.5-104
Software Installation Manual

PSM31A40397.69/72

Files pikr_Cpt_n.do and pikr_CptWithTime_n.do are used to save counter

information. Files pikr_Param_n.do are used to save downloaded parameters for
measured values. These files are created and updated by the software application.
Except in exceptional circumstances, it should not be modified. Its syntax is explained
in the following paragraph (4.2 Counter Memorization file and 4.3).
The configuration files phkb_Sys_n.do and phkb_Data_n.do are described in
paragraph 2.3 Configuring the application.

CLG870.5-104
Software Installation Manual

PSM31A40397.70/72

4.2

COUNTER MEMORIZATION FILE

The piks_Cpt_n.do file must not be modified except in exceptional cases. The
modification will only be taken into account if it is done before the application is
started.
The file is composed of n lines, each used to save the parameters of a counter. The
syntax of a line is as follows:
KEY=<TM key> VC=<Vc> IS_VC_VALID=<v> VCM1=<vcm1> TMM1=<tmm1>

Where:
KEY=<TM key>: Centralog key of the TM used to manage the counter,
VC=<Vc>: current value of the counter,
IS_VC_VALID=<v>: indicates whether the current value of the counter is valid (1) or

not (0)

VCM1=<vcm1>: previous value of the counter,

TMM1=<tmm1>: value of the TM during reception of the previous save order.

E.g.
KEY=PRO-TMI01
KEY=PRO-TMI02
KEY=PRO-TMI03
KEY=PRO-TMI04
KEY=PRO-TMI05

CLG870.5-104
Software Installation Manual

VC=120000
VC=130000
VC=140000
VC=150000
VC=160000

IS_VC_VALID=1
IS_VC_VALID=1
IS_VC_VALID=1
IS_VC_VALID=1
IS_VC_VALID=1

VCM1=110000
VCM1=120000
VCM1=130000
VCM1=140000
VCM1=150000

TMM1=700
TMM1=700
TMM1=700
TMM1=700
TMM1=700

PSM31A40397.71/72

4.3

TM PARAMETERS CONFIGURATION FILE

The pikr_Param_n.do file must not be modified except in exceptional cases. The
modification will only be taken into account if it is done before the application is
started.
The file is composed of n lines, each used to save the configuration parameters of a
TM. The syntax of a line is as follows:
KEY=<TM key> PRESENCE_PARAM=<Presence_Param>
NVA_THRESHOLD=<NVA_Threshold> NVA_SMOOTHING_FACTOR
=<NVA_SmoothingFactor> F32_THRESHOLD=<F32_Threshold>
F32_SMOOTHING_FACTOR=<F32_SmoothingFactor>
SCALED_THRESHOLD=<SCALED_Threshold> SCALED_SMOOTHING_FACTOR
=<SCALED_SmoothingFactor>
With:
-

KEY=<TM key> : Centralog key of the TM using this parameters.

PRESENCE_PARAM=<Presence_Param>: Type of TM (normalised, scaled or
floating) or existing of reception from controlling station of parameters DEADBAND
and SMOOTHING_FACTOR.
NVA_THRESHOLD=<NVA_Threshold>: Threshold value in format NVA.
NVA_SMOOTHING_FACTOR=<NVA_SmoothingFactor>: Smoothing factor
value in format NVA.
F32_THRESHOLD=<F32_Threshold>: Threshold value in format IEE STD 754
(float 32 bits).
F32_SMOOTHING_FACTOR=<F32_SmoothingFactor>: Smoothing factor
value in IEE STD 754 (float 32 bits).
SCALED_THRESHOLD=<SCALED_Threshold>: Threshold value in format
Scaled.
SCALED_SMOOTHING_FACTOR=<SCALED_SmoothingFactor>: Smoothing
factor value in format Scaled.

Example:
KEY=TSTASIG_TM_5
PRESENCE_PARAM=035 NVA_THRESHOLD=18350 NVA_SMOOTHING_FACTOR=-32768 F32_THRESHOLD=0.00000
F32_SMOOTHING_FACTOR=0.00000 SCALED_THRESHOLD=+00000
SCALED_SMOOTHING_FACTOR=+00000
KEY=TSTASIG_TM_1
PRESENCE_PARAM=035 NVA_THRESHOLD=18137 NVA_SMOOTHING_FACTOR=+14548 F32_THRESHOLD=0.00000
F32_SMOOTHING_FACTOR=0.00000 SCALED_THRESHOLD=+00000
SCALED_SMOOTHING_FACTOR=+00000
KEY=TSTASIG_TM_2
PRESENCE_PARAM=067
NVA_THRESHOLD=+00000 NVA_SMOOTHING_FACTOR=+00000
F32_THRESHOLD=0.00000 F32_SMOOTHING_FACTOR=0.00000
SCALED_THRESHOLD=-01136 SCALED_SMOOTHING_FACTOR=+02536

CLG870.5-104
Software Installation Manual

PSM31A40397.72/72