system.iec61850.operate
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.
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​
| Type | Parameter | Description |
|---|---|---|
| String | deviceName | The name of the configured IEC 61850 device. |
| PyDictionary | mapParams | Control 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. |
| Float | controlValue | Control value (32-bit float). |
Returns​
No return value.
Scope​
Gateway, Perspective Session
Code Examples​
# 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)