Controls the state of the GPIB Remote Enable (REN) interface line, and optionally the remote/local state of the device.
ViStatus viGpibControlREN(ViSession vi, ViUInt16 mode)
viGpibControlREN&(ByVal vi&, ByVal mode%)
GPIB INSTR, GPIB INTFC, USB INSTR
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. |
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. |
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