system.iec61850
IEC 61850 Functions
The following functions give you access to interact with IEC 61850 devices.
📄️ cancel
Cancels the selection of an SBO type control on a configured IEC 61850 device to prevent the operate command from performing.
📄️ getControlParams
This function returns a list of report control names and their attributes contained in the configured IEC 61850 device.
📄️ listFiles
This function returns a list of filenames from a remote path for the configured IEC 61850 device.
📄️ operate
This function operates on the IEC 61850 device control immediately, such as to change the position of a switch.
📄️ readFile
This function downloads remote files from the configured IEC 61850 device to an identified local path.
📄️ select
Select an SBO type control to prepare it for a subsequent operate command for a configured IEC 61850 device.
📄️ writeFile
This function uploads a file from a local path to the configured IEC 61850 device remote path.
Functions by Scope
Safety Considerations
When working with the IEC 61850 system control functions, it's crucial to understand the potential safety implications. Misuse of these functions can lead to unintended operations and potentially catastrophic results for a high voltage substation.
The Check parameter associated with system.iec61850.getControlParams is of critical importance for safety. Inside the Intelligent Electronic Device (IED) itself, there are logical nodes for interlocking and synchronizing, named Control Interlock (CILO) and Synchrocheck (RSYN). If the Check parameter is 00
, the IED will ignore CILO and RSYN and execute the command even if there is an interlock activated or the grid is not synchronized with the generator speed. The results of not knowing this can be catastrophic for a high voltage substation. It is crucial for an integrator to be aware of this.
The system.iec61850.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).
The system.iec61850.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).
The system.iec61850.cancel function will clear a selection of a Select Before Operate (SBO) type control if an operate command is not desired to be executed on the selected control. This function can be used as a safety measure to prevent 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).