---
title: "system.iec61850.getControlParams"
description: "This function returns a list of report control names and their attributes contained in the configured IEC 61850 device."
---

# system.iec61850.getControlParams

> This function returns a list of report control names and their attributes contained in the configured IEC 61850 device.

This function is used in **Python Scripting**.

## Description

:::danger Check Parameter, Control Interlock, and Synchrocheck
The **Check** parameter 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.
:::

## Client Permission Restrictions

This scripting function has no [Client Permission](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax

`system.iec81650.getControlParams(deviceName)`

### Parameters

Type | Parameter | Description
------- | ------- | ------
String | `deviceName` | The name of the configured IEC 61850 device.

### Returns

**List[PyDictionary]** - A list of PyDictionaries, where each dictionary contains the following keys:

- name: Displays the logical device pathname.
- ctlModel: The type of control model defined by a the attribute value.
    - 0: Status-only
    - 1: Direct-with-normal-security
    - 2: SBO-with-normal-security
    - 3: Direct-with-enhanced-security
    - 4: SBO-with-enhanced-security
- T: The time stamp of the control object when the client issues the request.
- Check: Specifies the kind of check the control object performs, if any, before any control operation. This parameter may involve interlock and synchronizing logic, such as **Control Interlock (CILO)** and **Synchrocheck (RSYN)**, to ensure safe operation.
- ctlNumb: Displays the data object status change sequence number.
- orCat: Specifies the category of the origin request.
- orIdent: Displays the identification of the sender, if known.
- Test: Indicates the send is for test purposes only when true.

### Scope

Gateway, Perspective Session

## Code Examples

```python title="Example #1 - Retrieving Report Control Objects"
# This example prints the control names and corresponding param values on the IEC 61850 device.
# Declare results variable using the system function and print
 
results = system.iec61850.getControlParams("IEC61850")
print(results)
```