Package jisa.visa.drivers

Class GPIBDriver.GPIBConnection

java.lang.Object

jisa.visa.drivers.GPIBDriver.GPIBConnection

All Implemented Interfaces:

Connection, GPIBConnection

Enclosing class:

GPIBDriver

public class GPIBDriver.GPIBConnection
extends java.lang.Object
implements GPIBConnection

Implementation of Connection for GPIB-based connections

Constructor Summary

Constructors

Constructor	Description
GPIBConnection(int ibHandle)

Method Summary

Modifier and Type	Method	Description
void	clear()
void	close()	Closes the connection, freeing up the resources used by it.
java.nio.charset.Charset	getEncoding()
byte[]	readBytes(int bufferSize)	Attempts to read the given number of bytes from the connection.
void	setEncoding(java.nio.charset.Charset charset)
void	setEOIEnabled(boolean set)
void	setReadTerminator(long character)	Sets the "End of String" terminator, in numerical form.
void	setTimeout(int duration)	Sets the time-out, in milli-seconds, to use on this connection.
void	write(java.lang.String toWrite)	Writes the specified string over the connection.
void	writeBytes(byte[] bytes)

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface jisa.visa.connections.Connection

read, read, setReadTerminator

Constructor Detail

GPIBConnection

public GPIBConnection(int ibHandle)

Method Detail

writeBytes

public void writeBytes(byte[] bytes)
                throws VISAException

Specified by:

writeBytes in interface Connection

Throws:

VISAException

clear

public void clear()
           throws VISAException

Specified by:

clear in interface Connection

Throws:

VISAException

setEncoding

public void setEncoding(java.nio.charset.Charset charset)

Specified by:

setEncoding in interface Connection

getEncoding

public java.nio.charset.Charset getEncoding()

Specified by:

getEncoding in interface Connection

write

public void write(java.lang.String toWrite)
           throws VISAException

Description copied from interface: Connection

Writes the specified string over the connection.

Specified by:

write in interface Connection

Parameters:

toWrite - String to write

Throws:

VISAException - Upon something going wrong with VISA

readBytes

public byte[] readBytes(int bufferSize)
                 throws VISAException

Description copied from interface: Connection

Attempts to read the given number of bytes from the connection. Will return if either the number of bytes is reached or the specified EOS terminator is found. Will time-out if neither of these conditions are met within the value specified by setTMO(...).

Specified by:

readBytes in interface Connection

Parameters:

bufferSize - The number of bytes to read

Returns:

Array of bytes read (trimmed)

Throws:

VISAException - Upon something going wrong

setEOIEnabled

public void setEOIEnabled(boolean set)
                   throws VISAException

Specified by:

setEOIEnabled in interface GPIBConnection

Throws:

VISAException

setReadTerminator

public void setReadTerminator(long character)
                       throws VISAException

Description copied from interface: Connection

Sets the "End of String" terminator, in numerical form. This is the terminator used for reading from the connection, to specify the end of a message from the instrument. For example:

line-feed: \n = 0x0A carriage-return \r = 0x0D CR-LF \r\n = 0x0D0A

Specified by:

setReadTerminator in interface Connection

Parameters:

character - The terminator to look for (numerical representation)

Throws:

VISAException - Upon something going wrong

setTimeout

public void setTimeout(int duration)
                throws VISAException

Description copied from interface: Connection

Sets the time-out, in milli-seconds, to use on this connection.

Specified by:

setTimeout in interface Connection

Parameters:

duration - Time-out, in milli-seconds

Throws:

VISAException - Upon something going wrong

close

public void close()
           throws VISAException

Description copied from interface: Connection

Closes the connection, freeing up the resources used by it.

Specified by:

close in interface Connection

Throws:

VISAException - Upon something going wrong