org.lsst.ccs.drivers.ascii

Class TestAscii

java.lang.Object

org.lsst.ccs.drivers.ascii.TestAscii

public class TestAscii
extends Object

Program to test the Ascii command device driver.

Author:

Owen Saxton

Field Summary

Fields

Modifier and Type	Field and Description
protected Ascii	dev

Constructor Summary

Constructors

Constructor and Description
TestAscii() Constructor.
TestAscii(Ascii dev) Constructor.

Method Summary

Modifier and Type	Method and Description
void	close() Closes connection to a device.
protected static String	makeCommandString(String command, String... args) Makes a command string.
void	open(org.lsst.ccs.drivers.commons.DriverConstants.ConnType type, String ident) Opens connection to a device with default parameters.
void	open(org.lsst.ccs.drivers.commons.DriverConstants.ConnType type, String ident, int param) Opens connection to a device.
void	openNet(String host) Opens connection to a network device with default port.
void	openNet(String host, int port) Opens connection to a network device.
void	openSerial(String devc) Opens connection to a serial device with default baud rate.
void	openSerial(String devc, int baud) Opens connection to a serial device.
void	openSerial(String devc, int baud, Ascii.DataBits dbits, Ascii.StopBits sbits, Ascii.Parity parity, Ascii.FlowCtrl flow) Opens connection to a serial device.
String	read() Reads a response.
String	read(String command, String... args) Writes a command and reads the response.
void	setCommandTerm(Ascii.Terminator term) Sets the command terminator.
void	setConnTimeout(int time) Sets the network connection timeout.
void	setDefaultBaud(int baud) Sets default baud rate
void	setDefaultPort(int port) Sets default network port
void	setOptions(Ascii.Option option) Sets device options.
void	setResponseTerm(Ascii.Terminator term) Sets the response terminator.
void	setTerminator(Ascii.Terminator term) Sets both the command and response terminators.
void	setTimeout(int time) Sets the response timeout.
int	showConnTimeout() Shows the network connection timeout.
int	showTimeout() Shows the response timeout.
void	write(String command, String... args) Writes a command.

Methods inherited from class java.lang.Object

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

Field Detail

dev

protected final Ascii dev

Constructor Detail

TestAscii

public TestAscii()

Constructor.

TestAscii

public TestAscii(Ascii dev)

Constructor.

Parameters:

dev - The device to use

Method Detail

setOptions

@Command(description="Set options")
public void setOptions(@Argument(description="Device options")
                                                           Ascii.Option option)

Sets device options.

Parameters:

option - The options enum

setDefaultBaud

@Command(description="Set default baud rate")
public void setDefaultBaud(@Argument(description="Default baud rsate")
                                                                         int baud)

Sets default baud rate

Parameters:

baud - The default baud rate

setDefaultPort

@Command(description="Set default network port")
public void setDefaultPort(@Argument(description="Default parameter")
                                                                            int port)

Sets default network port

Parameters:

port - The default network port

open

@Command(description="Open connection to general device")
public void open(@Argument(description="Connection type: net or serial")
                                                                           org.lsst.ccs.drivers.commons.DriverConstants.ConnType type,
                                                                           @Argument(description="Device identifier")
                                                                           String ident,
                                                                           @Argument(description="Device parameter")
                                                                           int param)
                                                                    throws org.lsst.ccs.drivers.commons.DriverException

Opens connection to a device.

Parameters:

type - The connection type

ident - The device identification

param - The device parameter

Throws:

org.lsst.ccs.drivers.commons.DriverException

open

@Command(description="Open connection to general device")
public void open(@Argument(description="Connection type: net or serial")
                                                                           org.lsst.ccs.drivers.commons.DriverConstants.ConnType type,
                                                                           @Argument(description="Device identifier")
                                                                           String ident)
                                                                    throws org.lsst.ccs.drivers.commons.DriverException

Opens connection to a device with default parameters.

Parameters:

type - The connection type

ident - The device identification

Throws:

org.lsst.ccs.drivers.commons.DriverException

openNet

@Command(description="Open connection to network device")
public void openNet(@Argument(description="Host name")
                                                                              String host,
                                                                              @Argument(description="Port number")
                                                                              int port)
                                                                       throws org.lsst.ccs.drivers.commons.DriverException

Opens connection to a network device.

Parameters:

host - The host name

port - The port number

Throws:

org.lsst.ccs.drivers.commons.DriverException

openNet

@Command(description="Open connection to network device")
public void openNet(@Argument(description="Host name")
                                                                              String host)
                                                                       throws org.lsst.ccs.drivers.commons.DriverException

Opens connection to a network device with default port.

Parameters:

host - The host name

Throws:

org.lsst.ccs.drivers.commons.DriverException

openSerial

@Command(description="Open connection to serial device")
public void openSerial(@Argument(description="Device name")
                                                                                String devc,
                                                                                @Argument(description="Baud rate")
                                                                                int baud,
                                                                                @Argument(description="The number of data bits")
                                                                                Ascii.DataBits dbits,
                                                                                @Argument(description="The number of stop bits")
                                                                                Ascii.StopBits sbits,
                                                                                @Argument(description="The parity")
                                                                                Ascii.Parity parity,
                                                                                @Argument(description="The flow control")
                                                                                Ascii.FlowCtrl flow)
                                                                         throws org.lsst.ccs.drivers.commons.DriverException

Opens connection to a serial device.

Parameters:

devc - The device name

baud - The baud rate

dbits - The number of data bits (eight or seven)

sbits - The number of stop bits (one or two)

parity - The parity (none, odd, even, mark or space)

flow - The flow control (none, xon, rts or dtr)

Throws:

org.lsst.ccs.drivers.commons.DriverException

openSerial

@Command(description="Open connection to serial device")
public void openSerial(@Argument(description="Device name")
                                                                                String devc,
                                                                                @Argument(description="Baud rate")
                                                                                int baud)
                                                                         throws org.lsst.ccs.drivers.commons.DriverException

Opens connection to a serial device.

Parameters:

devc - The device name

baud - The baud rate

Throws:

org.lsst.ccs.drivers.commons.DriverException

openSerial

@Command(description="Open connection to serial device")
public void openSerial(@Argument(description="Device name")
                                                                                String devc)
                                                                         throws org.lsst.ccs.drivers.commons.DriverException

Opens connection to a serial device with default baud rate.

Parameters:

devc - The device name

Throws:

org.lsst.ccs.drivers.commons.DriverException

close

@Command(description="Close connection to device")
public void close()
                                                              throws org.lsst.ccs.drivers.commons.DriverException

Closes connection to a device.

Throws:

org.lsst.ccs.drivers.commons.DriverException

write

@Command(description="Write command to device")
public void write(@Argument(description="Command word")
                                                                  String command,
                                                                  @Argument(description="Arguments")
                                                                  String... args)
                                                           throws org.lsst.ccs.drivers.commons.DriverException

Writes a command.

Parameters:

command - The command word to send

args - The arguments

Throws:

org.lsst.ccs.drivers.commons.DriverException

read

@Command(description="Read response from device")
public String read()
                                                              throws org.lsst.ccs.drivers.commons.DriverException

Reads a response.

Returns:

The received response

Throws:

org.lsst.ccs.drivers.commons.DriverException

read

@Command(description="Write command and read response")
public String read(@Argument(description="Command word")
                                                                           String command,
                                                                           @Argument(description="Arguments")
                                                                           String... args)
                                                                    throws org.lsst.ccs.drivers.commons.DriverException

Writes a command and reads the response.

Parameters:

command - The command word to send

args - The arguments

Returns:

The response string

Throws:

org.lsst.ccs.drivers.commons.DriverException

setTimeout

@Command(description="Set read response timeout")
public void setTimeout(@Argument(description="Timeout value (msec)")
                                                                         int time)
                                                                  throws org.lsst.ccs.drivers.commons.DriverException

Sets the response timeout.

Parameters:

time - The timeout (msec); 0 means no timeout

Throws:

org.lsst.ccs.drivers.commons.DriverException

showTimeout

@Command(description="Show read response timeout (msec)")
public int showTimeout()

Shows the response timeout.

Returns:

The timeout (msec)

setConnTimeout

@Command(description="Set network connection timeout")
public void setConnTimeout(@Argument(description="Timeout value (msec)")
                                                                                  int time)

Sets the network connection timeout.

Parameters:

time - The timeout (msec); 0 means no timeout

showConnTimeout

@Command(description="Show network connection timeout (msec)")
public int showConnTimeout()

Shows the network connection timeout.

Returns:

The timeout (msec)

setCommandTerm

@Command(description="Set command terminator")
public void setCommandTerm(@Argument(description="Terminator enum")
                                                                          Ascii.Terminator term)

Sets the command terminator.

Parameters:

term - The terminator to set

setResponseTerm

@Command(description="Set response terminator")
public void setResponseTerm(@Argument(description="Terminator enum")
                                                                            Ascii.Terminator term)

Sets the response terminator.

Parameters:

term - The terminator to set

setTerminator

@Command(description="Set both terminators")
public void setTerminator(@Argument(description="Terminator enum")
                                                                       Ascii.Terminator term)

Sets both the command and response terminators.

Parameters:

term - The terminator to set

makeCommandString

protected static String makeCommandString(String command,
                                          String... args)

Makes a command string.

Parameters:

command - The command word

args - The command arguments

Returns:

The generated command string