Settings for the IEC 61850 client.
[iec61850] abortOnMismatch
- Type
- bool
- Default
- 0
- Range
- 0|1
Defines if enabling an RCB shall be aborted if the RCB on the server is configured with a
different data set than the RCB in WinCC OA.
[iec61850] aliveInterval
- Type
- uint
- Default
- 20
- Range
- 0 - 600 (in sec)
Determines the interval for sending alive telegrams for checking the connectivity of a
peripheral device. 0 indicates no alive check.
[iec61850] aliveTimeout61850
- Type
- uint
- Default
- 10
- Range
- 1 - 600 (in sec)
Determines the time after which the client recognizes a loss of connection to the
peripheral device.
Note: The alive timeout is only triggered if a TCP connection is still available
but the device does not respond. If the TCP connection fails on the hardware level
(power-outage, etc) the time-out of the underlying stack is triggered (approx. 10
seconds). The time-out is OS dependent and cannot be changed. Under Linux the
maximum time until a connection loss is recognized is aliveTimeout61850 +
aliveInterval.
[iec61850] autoGQ
- Type
- uint
- Default
- 3
- Range
- 0 - 3
Determines whether the client sends a General Query automatically after connecting to a
device. 0: No automatic GQ 1: Automatic GQ on connecting 2: Automatic GQ after redundancy
changeover or failover. 3: Automatic GQ on connecting and on redundancy changeover/failover.
Note The settings also apply to General Interrogation (GI) and will trigger a GI for all
enabled report control blocks.
[iec61850] certPath
- Type
- string
Relative path of the certificate store under <project>/data/IEC61850/. The
directory is defined by the config entry, e.g.:
[iec61850]certPath="myCertificates"
Creates the directory <projectpath>\data\IEC61850\myCertificates.
[iec61850] clientIedName
- Type
- string
- Default
- <WinCC OA Client Name>
The config entry assigns a spearate (Client) IED name to an IEC 61850 driver instance in
WinCC OA. The entry must be set in a instance specific section [iec61850_<manager
number>]. The RCB management panel only displays unassigned RCBs as well as RCBs that
are directly assigned to the Client instance if the config entry is set. A
corresponding entry to the SCL configuration file must be made according to the norm:
e.g. <ClientLN ... IedName="WinCC OA Client Name">
The <ClientLN> entry must be placed inside of the <ReportControl> node.
An example can be found within the "Report Control Blocks" chapter of the IEC61850
Engineering documentation.
[iec61850] connRetryInterval
- Type
- uint
- Default
- 30
- Range
- 1 - 600 (in sec)
Determines the interval for periodically trying re-establishing the connection to a
peripheral device after connection loss.
[iec61850] debugMsgQueueLimit
- Type
- uint
- Default
- 10000
- Range
- 1 - 50000
Determines the maximum number of debug messages the debug message queue can hold.
[iec61850] fileTransferTimeout61850
- Type
- uint
- Default
- 15
- Range
- 1 - 60
- Unit
- Seconds
The timeout defines how long a file transfer operation, e.g. downlowding a file from the
server, is allowed to take.
[iec61850] maxReadRequests
- Type
- uint
- Default
- 20
- Range
- 1 - 1000
Maximum read requests that the client sends to the server in a single MMS Packet.
[iec61850] maxWriteRequests
- Type
- uint
- Default
- 40
- Range
- 1 - 1000
Limits the number of write-requests, being sent to the connected server. Each
write-request contains one or more output DP elements - depending on the number of DP
elements in the executed dpSet() call.
[iec61850] originatorCategory
- Type
- uint
- Default
- 2
- Range
- 1 - 3
Applies to the IEC 61850 command model and modifies the definition of the originator
category. Possible values are: 1 -> Bay 2 -> Station 3 -> Remote
[iec61850] originatorIdentifier
- Type
- string
- Default
- <hostname>_<project name>_<driver number>
- Range
- 30 (characters)
Applies to the IEC 61850 command model and allows modifying the originatorIdentifier. By
defaults this is built as <hostname>_<project name>_<driver number>
[iec61850] rcbReleaseTimeout
- Type
- uint
- Default
- 10
- Range
- 10 - 120
- Unit
- seconds
In a redundant WinCC OA system, on a redundancy switch, the driver becoming passive
releases all server connections where "Passive host connects to device" has been
activated.
This timeout determines the interval in seconds after which the client re-establishes
these connections.
[iec61850] readRequestQueueLimit
- Type
- uint
- Default
- 50000
- Range
- 1 - 1000000
Determines the maximum number of read requests the read request queue can hold.
[iec61850] readResponseQueueLimit
- Type
- uint
- Default
- 50000
- Range
- 1 - 1000000
Determines the maximum number of read responses that the read response queue can hold.
[iec61850] reportEnaMaxRetry
- Type
- uint
- Default
- 10
- Range
- 0 - 50000
Maximum number of retries to enable RCB after a connection establishment with the device
or redundancy changeover. 0 -> Infinite retry. Note: If the enabling attempt fails, an
appropriate error is written to _IEC61850_RCB.State.RCBState. In case that the maximum
number of retries is exhausted, an log message is displayed in addition.
[iec61850] reportEnaRetryInterval
- Type
- uint
- Default
- 6
- Range
- 1 - 600 (in sec)
Determines the time interval after which the client tries to enable an RCB if the
previous attempt was not successful.
[iec61850] sequentialConnSetup
- Type
- bool
- Default
- n
- Range
- y|n
The config entry defines if the driver serializes initializing, activating and connecting
of IEDs and RCBs or if these steps should be performed in parallel. Procesing the
steps in parallel (= "n"; default) will speed up the start-up of the driver but may result
in a forced shutdown of the driver in case the project contains a high number of IEDs with
lots of RCBs. Therefor it is recommended to enable the sequential mode (= "y")
reducing the message load between driver and event/ data manager.
[iec61850] setInvalidForConnLoss
- Type
- uint
- Default
- 2
- Range
- 0 - 2
Defines if the invalid bit should be set if the driver loses the connection to the
device. 0-> Invalid bit will not be set by the driver after connection loss. 1-> Invalid bit
will be set by the driver with connection loss time. 2-> Invalid bit will be set by the
driver with last data update time. Note The invalid bit is reset as soon as the first valid
value is received after connection reestablishment. If there is no value change, the invalid
bit is not reset. The invalid bit can also be reset by GI. In this case the optional field
Reason for Inclusion must be enabled and autoGQ must be set to 3.
[iec61850] userBitReduSourceDevice
- Type
- uint
- Default
- 6
- Range
- 1 - 32
Defines which user bit shall be used to distinguish between messages sent from the
primary and secondary redundancy partner. The config entry is only used if
"userByteQualityMode" is disabled.
[iec61850] userByteCommandMode
- Type
- uint
- Default
- 1
- Range
- 1 - 4
Determines the User Byte in write direction used for commands of the control model. 1 ->
_userbyte1 2 -> _userbyte2 3 -> _userbyte3 4 -> _userbyte4
[iec61850] userByteQualityDetail
- Type
- uint
- Default
- 0
- Range
- 0 - 4
Determines the user byte in read direction used for mapping IEC 61850 Quality information
for the attributes validity, source, test and operator blocked. 0 -> No mapping 1 ->
_userbyte1 2 -> _userbyte2 3 -> _userbyte3 4 -> _userbyte4 Note: The config entries
userByteTimeQuality, userByteQualityDetail and userByteQualityMode refer to the detailed
quality information provided by the IEC standard. You might set either or none of these
config entries. If none is set, quality and time related, quality bits are not mapped to the
user bytes of the _original config. The data quality (valid/invalid) is always considered
and does not require the setting of any config entries.
[iec61850] userByteQualityMode
- Type
- uint
- Default
- 0
- Range
- 0 - 4
Determines the user byte in read direction used for mapping IEC 61850 Quality information
for the attributes of the structure Quality/detailQual. 0 -> No mapping 1 -> _userbyte1 2 ->
_userbyte2 3 -> _userbyte3 4 -> _userbyte4 Note: The config entries userByteTimeQuality,
userByteQualityDetail and userByteQualityMode refer to the detailed quality information
provided by the IEC standard. You might set either or none of these config entries. If none
is set, quality and time related, quality bits are not mapped to the user bytes of the
_original config. The data quality (valid/invalid) is always considered and does not require
the setting of any config entries.
[iec61850] userByteTimeQuality
- Type
- uint
- Default
- 0
- Range
- 0 - 4
Determines the user byte in read direction used for mapping IEC 61850 Time Quality
information. 0 -> No mapping 1 -> _userbyte1 2 -> _userbyte2 3 -> _userbyte3 4 -> _userbyte4
Note: The config entries userByteTimeQuality, userByteQualityDetail and userByteQualityMode
refer to the detailed quality information provided by the IEC standard. You might set either
or none of these config entries. If none is set, quality and time related, quality bits are
not mapped to the user bytes of the _original config. The data quality (valid/invalid) is
always considered and does not require the setting of any config entries.
[iec61850] writeIntDpQueueLimit
- Type
- uint
- Default
- 10000
- Range
- 1 - 50000
Determines the maximum number of elements the queue storing values to be written to
internal data points can hold.
[iec61850] writeRequestQueueLimit
- Type
- uint
- Default
- 50000
- Range
- 1 - 1000000
Determines the maximum number of write requests the write request queue can hold.
