net.wimpi.modbus.io

Class ModbusSerialTransaction

java.lang.Object

net.wimpi.modbus.io.ModbusSerialTransaction

All Implemented Interfaces:

ModbusTransaction

public class ModbusSerialTransaction
extends Object
implements ModbusTransaction

Class implementing the ModbusTransaction interface.

Version:

1.2

Author:

Dieter Wimberger

Constructor Summary

Constructors

Constructor and Description
ModbusSerialTransaction() Constructs a new ModbusSerialTransaction instance.
ModbusSerialTransaction(ModbusRequest request) Constructs a new ModbusSerialTransaction instance with a given ModbusRequest to be send when the transaction is executed.
ModbusSerialTransaction(SerialConnection con) Constructs a new ModbusSerialTransaction instance with a given ModbusRequest to be send when the transaction is executed.

Method Summary

Modifier and Type	Method and Description
protected void	checkValidity() Checks the validity of the transaction, by checking if the values of the response correspond to the values of the request.
void	execute() Executes this ModbusTransaction.
ModbusRequest	getRequest() Returns the ModbusRequest instance associated with this ModbusTransaction.
ModbusResponse	getResponse() Returns the ModbusResponse instance associated with this ModbusTransaction.
int	getRetries() Returns the amount of retries for opening the connection for executing the transaction.
int	getTransactionID() Returns the actual transaction identifier of this ModbusTransaction.
int	getTransDelayMS() Get the TransDelayMS value.
boolean	isCheckingValidity() Tests whether the validity of a transaction will be checked.
void	setCheckingValidity(boolean b) Sets the flag that controls whether the validity of a transaction will be checked.
void	setRequest(ModbusRequest req) Sets the ModbusRequest for this ModbusTransaction.
void	setRetries(int num) Set the amount of retries for opening the connection for executing the transaction.
void	setSerialConnection(SerialConnection con) Sets the port on which this ModbusTransaction should be executed.
void	setTransDelayMS(int newTransDelayMS) Set the TransDelayMS value.

Methods inherited from class java.lang.Object

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

Constructor Detail

ModbusSerialTransaction

public ModbusSerialTransaction()

Constructs a new ModbusSerialTransaction instance.

ModbusSerialTransaction

public ModbusSerialTransaction(ModbusRequest request)

Constructs a new ModbusSerialTransaction instance with a given ModbusRequest to be send when the transaction is executed.

Parameters:

request - a ModbusRequest instance.

ModbusSerialTransaction

public ModbusSerialTransaction(SerialConnection con)

Constructs a new ModbusSerialTransaction instance with a given ModbusRequest to be send when the transaction is executed.

Parameters:

con - a TCPMasterConnection instance.

Method Detail

setSerialConnection

public void setSerialConnection(SerialConnection con)

Sets the port on which this ModbusTransaction should be executed.

Parameters:

con - a SerialConnection.

getTransactionID

public int getTransactionID()

Description copied from interface: ModbusTransaction

Returns the actual transaction identifier of this ModbusTransaction. The identifier is a 2-byte (short) non negative integer value valid in the range of 0-65535.

Specified by:

getTransactionID in interface ModbusTransaction

Returns:

the actual transaction identifier as int.

setRequest

public void setRequest(ModbusRequest req)

Description copied from interface: ModbusTransaction

Sets the ModbusRequest for this ModbusTransaction.

The related ModbusResponse is acquired from the passed in ModbusRequest instance.

Specified by:

setRequest in interface ModbusTransaction

Parameters:

req - a ModbusRequest.

getRequest

public ModbusRequest getRequest()

Description copied from interface: ModbusTransaction

Returns the ModbusRequest instance associated with this ModbusTransaction.

Specified by:

getRequest in interface ModbusTransaction

Returns:

the associated ModbusRequest instance.

getResponse

public ModbusResponse getResponse()

Description copied from interface: ModbusTransaction

Returns the ModbusResponse instance associated with this ModbusTransaction.

Specified by:

getResponse in interface ModbusTransaction

Returns:

the associated ModbusRequest instance.

setCheckingValidity

public void setCheckingValidity(boolean b)

Description copied from interface: ModbusTransaction

Sets the flag that controls whether the validity of a transaction will be checked.

Specified by:

setCheckingValidity in interface ModbusTransaction

Parameters:

b - true if checking validity, false otherwise.

isCheckingValidity

public boolean isCheckingValidity()

Description copied from interface: ModbusTransaction

Tests whether the validity of a transaction will be checked.

Specified by:

isCheckingValidity in interface ModbusTransaction

Returns:

true if checking validity, false otherwise.

getRetries

public int getRetries()

Description copied from interface: ModbusTransaction

Returns the amount of retries for opening the connection for executing the transaction.

Specified by:

getRetries in interface ModbusTransaction

Returns:

the amount of retries as int.

setRetries

public void setRetries(int num)

Description copied from interface: ModbusTransaction

Set the amount of retries for opening the connection for executing the transaction.

Specified by:

setRetries in interface ModbusTransaction

Parameters:

num - the amount of retries as int.

getTransDelayMS

public int getTransDelayMS()

Get the TransDelayMS value.

Returns:

the TransDelayMS value.

setTransDelayMS

public void setTransDelayMS(int newTransDelayMS)

Set the TransDelayMS value.

Parameters:

newTransDelayMS - The new TransDelayMS value.

execute

public void execute()
             throws ModbusIOException,
                    ModbusSlaveException,
                    ModbusException

Description copied from interface: ModbusTransaction

Executes this ModbusTransaction. Locks the ModbusTransport for sending the ModbusRequest and reading the related ModbusResponse. If reconnecting is activated the connection will be opened for the transaction and closed afterwards.

Specified by:

execute in interface ModbusTransaction

Throws:

ModbusException - if an I/O error occurs, or the response is a modbus protocol exception.

ModbusIOException

ModbusSlaveException

checkValidity

protected void checkValidity()
                      throws ModbusException

Checks the validity of the transaction, by checking if the values of the response correspond to the values of the request.

Throws:

ModbusException - if the transaction is not valid.