Skip to main content
Version: 8.1

system.iec61850.operate

New in 8.1.25


This function is used in Python Scripting.

Description

This function operates on the IEC 61850 device control immediately, such as to change the position of a switch. This can be done directly, or following a select command.

Operate Function

The Operate function is used to write to the connected 61850 device when possible. However, it should be used with extreme caution. For Direct types, it allows an immediate change to an access point. For Select Before Operate (SBO) types, it should only be used after the Select function has confirmed the access point. Always ensure that the Check parameter is properly set and understood before using this function, as it can influence the behavior of the Control Interlock (CILO) and Synchrocheck (RSYN) logical nodes in the Intelligent Electronic Device (IED).

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.iec61850.operate(deviceName, mapParams, controlValue)

Parameters

TypeParameterDescription
StringdeviceNameThe name of the configured IEC 61850 device.
PyDictionarymapParamsControl parameters dictionary that requires the following keys to be specified: name, T, orCat, orIdent, Check, and Test. Use the same params as the select function when operating on an SBO type control. If you do not know the required key value pairs, they can be found using the getControlParams function.
FloatcontrolValueControl value (32-bit float).

Returns

No return value.

Scope

Gateway, Perspective Session

Code Examples

Example #1
# This example sets a direct control value to 2.    

mapParams = {'name': u'SSSA_52AFA_FPRCTRL/CBCSWI1.Mod', 'T':1 'orCat': 0, 'orIdent': u'not-supported', 'Check': 0, 'Test': False}
system.iec61850.operate("IEC61850", mapParams, 2)

Keywords

system iec61850 operate system.iec61850.operate