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 (@date@)

Author:

Dieter Wimberger

Field Summary

private static AtomicCounter	c_TransactionID
private ModbusTransport	m_IO
private ModbusRequest	m_Request
private ModbusResponse	m_Response
private int	m_Retries
private SerialConnection	m_SerialCon
private Mutex	m_TransactionLock
private int	m_TransDelayMS
private boolean	m_ValidityCheck

Constructor Summary

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

private void	assertExecutable() Asserts if this ModbusTCPTransaction is executable.
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

Field Detail

c_TransactionID

private static AtomicCounter c_TransactionID

m_IO

private ModbusTransport m_IO

m_Request

private ModbusRequest m_Request

m_Response

private ModbusResponse m_Response

m_ValidityCheck

private boolean m_ValidityCheck

m_Retries

private int m_Retries

m_TransDelayMS

private int m_TransDelayMS

m_SerialCon

private SerialConnection m_SerialCon

m_TransactionLock

private Mutex m_TransactionLock

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

assertExecutable

private void assertExecutable()
                       throws ModbusException

Asserts if this ModbusTCPTransaction is executable.

Throws:

ModbusException - if the transaction cannot be asserted.

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.