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