system.iec61850.select

New in 8.1.25

This function is used in Python Scripting.

Description

Select an SBO type control to prepare it for a subsequent operate command for a configured IEC 61850 device. These selections can be removed by using the cancel function.

Select Function

The Select function is used to confirm a chosen access point before the Operate function will run. This is especially important for Select Before Operate (SBO) type controls. Misuse of this function can lead to unintended operations. 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.select(device_name, mapParams, value)

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. 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

Example #1

# This example prepares an SBO type control for an operate command.    
 
mapParams = {'name': u'SSSA_52AFA_FPRCTRL/CBCSWI1.Mod', 'T':1 'orCat': 0, 'orIdent': u'not-supported', 'Check': 0, 'Test': False}
system.iec61850.select("IEC61850", mapParams, 1)