viGpibControlREN

NI-VISA

viGpibControlREN

Purpose

Controls the state of the GPIB Remote Enable (REN) interface line, and optionally the remote/local state of the device.

C Syntax

ViStatus viGpibControlREN(ViSession vi, ViUInt16 mode)

Visual Basic Syntax

viGpibControlREN&(ByVal vi&, ByVal mode%)

Resource Classes

GPIB INSTR, GPIB INTFC, USB INSTR

Parameters

Name Direction Description

vi

IN

Unique logical identifier to a session.

mode

IN

Specifies the state of the REN line and optionally the device remote/local state. See the Description section for actual values.

Return Values

Completion Codes Description

VI_SUCCESS

Operation completed successfully.

 

Error Codes Description

VI_ERROR_INV_OBJECT

The given session reference is invalid.

VI_ERROR_NSUP_OPER

The given vi does not support this operation.

VI_ERROR_RSRC_LOCKED

Specified operation could not be performed because the resource identified by vi has been locked for this kind of access.

VI_ERROR_NCIC

The interface associated with this session is not currently the controller in charge.

VI_ERROR_NLISTENERS

No-listeners condition is detected (both NRFD and NDAC are unasserted).

VI_ERROR_NSYS_CNTLR

The interface associated with this session is not the system controller.

VI_ERROR_INV_MODE

The value specified by the mode parameter is invalid.

Description

The viGpibControlREN() operation asserts or unasserts the GPIB REN interface line according to the specified mode. The mode can also specify whether the device associated with this session should be placed in local state (before deasserting REN) or remote state (after asserting REN). This operation is valid only if the GPIB interface associated with the session specified by vi is currently the system controller.

The following table lists special values for the mode parameter.

Value Description

VI_GPIB_REN_DEASSERT

Deassert REN line.

VI_GPIB_REN_ASSERT

Assert REN line.

VI_GPIB_REN_DEASSERT_GTL

Send the Go To Local (GTL) command and deassert REN line.

VI_GPIB_REN_ASSERT_ADDRESS

Assert REN line and address device.

VI_GPIB_REN_ASSERT_LLO

Send LLO to any devices that are addressed to listen.

VI_GPIB_REN_ASSERT_ADDRESS_LLO

Address this device and send it LLO, putting it in RWLS.

VI_GPIB_REN_ASSERT_GTL

Send the Go To Local command (GTL) to this device.

Related Topics

INSTR Resource

INTFC Resource

viGpibControlATN