GpibInterface Class
- Updated2026-08-05
- 3 minute(s) read
Provides access to the board-level GPIB functionality that is available in VISA.
Derives from
- Session
- IGpibInterfaceSession
Syntax
Namespace: NationalInstruments.Visa
public class GpibInterface : Session, IGpibInterfaceSession
Constructors
| Name | Description |
|---|---|
| GpibInterface(string) | Initializes a new instance of the GpibInterface object from the specified resource name. |
| GpibInterface(string, AccessModes, int) | Initializes a new instance of the GpibInterface object from the specified resource name, access modes, and initialization timeout value. |
| GpibInterface(string, AccessModes, int, bool) | Initializes a new instance of the GpibInterface object from the specified resource name, access modes, initialization timeout value, and resource name validation flag. |
Properties
| Name | Description |
|---|---|
| AddressState | Indicates whether the specified GPIB interface is currently addressed to talk or listen, or is not addressed. |
| AllowDma | Specifies whether direct memory access is enabled. In some cases you may not be able to change whether DMA is enabled, so reading this property value may not return the same value that was set. |
| AtnState | Gets the current state of the GPIB ATN (ATtentioN) interface line. |
| DeviceStatusByte | Gets or sets the 488-style status byte of the local controller associated with this session. |
| HS488CableLength | Gets or sets the total length of the GPIB cable used in the specified GPIB interface, in meters. If HS488 is not implemented, the value of this property is โ1. |
| IOProtocol | Gets or sets the protocol type for I/O communication with the physical resource. In some cases you may not be able to change the protocol, so reading this property value may not return the same value that was set. |
| IsControllerInCharge | Indicates whether the specified GPIB interface is currently the controller in charge (CIC). |
| IsSystemController | Specifies whether the specified GPIB interface is currently the system controller. |
| NdacState | Gets the current state of the GPIB NDAC (Not Data ACcepted) interface line. |
| PrimaryAddress | Gets or sets the primary address of the local GPIB controller used by this session. |
| RawIO | Gets a reference to the raw I/O interface for this session. |
| RenState | Gets the current state of the GPIB REN (Remote ENable) interface line. |
| SecondaryAddress | Gets or sets the secondary address of the local GPIB controller used by this session. |
| SendEndEnabled | Enables/disables sending the END signal on the last byte of a write. |
| SrqState | Gets the current state of the GPIB SRQ (Service ReQuest) interface line. |
| TerminationCharacter | Gets or sets the ASCII character used to end reading. |
| TerminationCharacterEnabled | Specifies whether the read operation ends when a termination character is received. |
Methods
| Name | Description |
|---|---|
| AssertTrigger() | Asserts a software trigger. |
| ControlAtn(AtnMode) | Controls the state of the GPIB ATN interface line, and optionally the active controller state of the local interface board. |
| PassControl(short, short) | Tells the GPIB device at the specified address to become controller in charge (CIC). |
| PassControl(short) | Tells the GPIB device at the specified address to become controller in charge (CIC). |
| SendCommand(byte[]) | Writes GPIB command bytes on the bus. |
| SendInterfaceClear() | Pulses the interface clear line (IFC) for at least 100 microseconds. This operation asserts the IFC line and the local interface becomes controller in charge (CIC). |
| SendRemoteLocalCommand(GpibInterfaceRemoteLocalMode) | Controls the state of the GPIB REN interface line and, optionally, the remote/local state of the device. |
Events
| Name | Description |
|---|---|
| Cleared | Occurs when the GPIB controller has been sent a device clear message. |
| ControllerInCharge | Occurs when the GPIB controller has gained or lost CIC (controller in charge) status. |
| Listen | Occurs when the GPIB controller has been addressed to listen. |
| ServiceRequest | Occurs when a service request is received from the interface. |
| Talk | Occurs when the GPIB controller has been addressed to talk. |
| Trigger | Occurs when a trigger interrupt is received from the interface. |