---
title: "system.dnp3.directOperateBinary"
description: "Issues a Direct-Operate command for digital control operations at binary output points (CROB)."
---

# system.dnp3.directOperateBinary

> Issues a Direct-Operate command for digital control operations at binary output points (CROB).

:::note
The following function uses [system.dnp3](appendix\scripting-functions\system-dnp3\system-dnp3.md) and the [Legacy DNP3 driver](ignition-modules\opc-ua\opc-ua-drivers\dnp3\legacy-dnp3-driver\legacy-dnp3-driver.md). See [system.dnp](appendix\scripting-functions\system-dnp\system-dnp.md) for [DNP3](ignition-modules\opc-ua\opc-ua-drivers\dnp3\dnp3.md) functions using the [DNP3 driver](ignition-modules\opc-ua\opc-ua-drivers\dnp3\dnp3-driver\dnp3-driver.md).
:::

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

## Description
## Client Permission Restrictions
[Permission Type](ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-permissions-properties): DNP3 Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

## Syntax
`system.dnp3.directOperateBinary(deviceName, indexes, opType, tcCode, count, onTime, offTime)`

### Parameters
Type | Parameter | Description 
------- | ------- | -----
String| `deviceName` | The name of the DNP3 device driver.
List| `indexes` | A list of indexes of the objects to be modified in the outstation.
Integer| `opType` | The type of the operation. 0=NUL, 1=PULSE_ON, 2=PULSE_OFF, 3=LATCH_ON, 4=LATCH_OFF
Integer| `tcCode` | The Trip-Close code, used in conjunction with the opType. 0=NUL, 1=CLOSE, 2=TRIP
Integer| `count` | The number of times the outstation shall execute the operation.
Long| `onTime` | The duration that the output drive remains active, in millis. [optional]
Long| `offTime` | The duration that the output drive remains non-active, in millis. [optional]

### Returns
The DNP3 [status code](system-dnp3.md#status-codes) of the response, as an integer.

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples

```python title="Example #1"
# This example shows latching off 3 binary output points with the Direct-Operate command. 
 
off = system.dnp3.LATCH_OFF
system.dnp3.directOperateBinary("Dnp3", [0, 1, 2], off)
```

```python title="Example #2"
# This example shows setting a binary output point at index 3 to pulse at 5 second intervals
# with the Direct-Operate command. 
 
pulse = system.dnp3.PULSE_OFF
trip = system.dnp3.TRIP
system.dnp3.directOperateBinary("Dnp3", [3], pulse, trip, 5000, 5000)
```