             FieldTalk(TM) Modbus Master Library, Java(TM) Edition
                        FT-MBMP-JAVA-EVAL Read Me Notes

   Revision 2.6.5, 2021-01-18

   Welcome  to  the  evaluation  of  FieldTalk(TM) Modbus Master Library,
   Java(TM) Edition!

   This evaluation package allows you to:
     * Read the product manual
     * Browse the Modbus Master library API documentation
     * Study the source code of the Modbus examples provided
     * Modify and compile the Modbus examples
     * Create your own Modbus programs and test them using the library
     _________________________________________________________________

Documentation

   To browse the API Documentation please click [1]here.

   To read or print the Product Manual please click [2]here.

   Please  refer to the additional Application Notes published on our web
   site: [3]http://www.modbusdriver.com/doc
     _________________________________________________________________

Limitations and Restrictions

   The evaluation version is functional limited to 100 modbus operations.
   Once  100 operations are reached, all library functions will throw and
   EvaluationExpiredException exception.

   In  addition  it  does not contain any redistributable components. You
   must not redistribute any source, class, jar or library files.

   This package is provided for the purpose of evaluating whether to
   purchase an ongoing license to use the Package.

   THE EVALUATION PERIOD IS LIMITED TO 30 DAYS and does not include the
   right to reproduce and distribute Applications using the Package. At
   the end of the evaluation period, if You do not purchase a license,
   You must uninstall the Package from the computers or devices You
   installed it on.

   THE EVALUATION VERSION IS FUNCTIONAL LIMITED TO 100 MODBUS OPERATIONS!
     _________________________________________________________________

Files part of the package

   README, README.pdf
          These Read Me notes.

   LICENSE-LIB, LICENSE-LIB.pdf
          Library  License  containing  the  Terms & Conditions of use of
          this software.

   doc\README.pdf
          Documentation in PDF format.

   doc\html\index.html
          Documentation in HTML format.

   samples
          Directory  with  example  programs as a starting point for your
          application.

   lib\mbusmaster.jar
          Jar  package containing the FieldTalk library. This jar file is
          distributed with your application.

   lib\javacomm20-win32.zip
          Java  Communication API for Windows from Sun Microsystems, Inc.
          We  ship  this  3rd  party product together with our product so
          Windows  user  can  run  the  example programs. A Java COMM API
          extension  must  be  installed  first  in  order  to use serial
          communication!

   src
          FieldTalk  library  source  code  files. Only required if it is
          desired  to  re-compile  the  library with custom settings. The
          precompiled   jar   archive   should  be  sufficient  for  most
          applications.
     _________________________________________________________________

Distributable components

   This is an evaluation edition and does not contain any redistributable
   components.

   Important
            You must not redistribute any executables, source, class, jar or
            library files which are based on this evaluation edition.
     _________________________________________________________________

Release history

  2.6.5 (2021-01-18)

   Enhancements
     * Added MBAP ID validation

  2.6.4 (2012-10-26)

   Bug fixes
     * Changed  handling  of  IOException  which  caused  failing  of the
       MbusRtuOverTcpProtocol.

  2.6.3 (2011-10-31)

   Bug fixes
     * New  method of waiting for silence in RTU. Disabled monitor thread
       mechanism. Caused phantom time-outs with SerialIO serial library.

  2.6.2 (2011-03-23)

   API changes
     * RTU  over  TCP protocol added, which is also known as encapsulated
       RTU.  This  protocol  flavour  is  for  example  used  by  ISaGraf
       Soft-PLCs.

  2.6.1 (2011-01-20)

   Documentation
     * Fixed   error   in   documentation   of   Modbus   function  22  /
       maskWriteRegister.

   API changes
     * Maximum supported slave ID increased from 247 to 255
     * Defaults  for serial protocols changed to 19200 and even parity as
       per Modbus specification.
     * MbusAsciiMessaging,  MbusTcpMessaging,  MbusRtuMessaging:  classes
       now declared public
     * Removed    redundant    and    rarely   used   overloaded   method
       openProtocol(string     portName,     Int32     baudRate).     Use
       `openProtocol(portName,   baudRate,  dataBits,  stopBits,  parity)
       instead.

   Enhancements
     * Serial  Modbus  comm  port  initialisation  now ignores errors for
       unsupported  API  functions  like setFlowControlMode. Not all comm
       APIs seem to support them.
     * Modbus/TCP:   openProtocol   now   honours   timeout  setting  for
       connections if running on JDK 1.4 or higher.

   Bug fixes
     * ENRON support for writeMultipleRegisters fixed.

  2.2 (2004-03-17)

     * Vendor specific Read Log History function (FC 100) added.
     * ELAM Modbus extension support added.

  2.1 (2003-09-09)

     * Added  Daniel/Enron  32-bit mode support. The 32-bit configuration
       settings can now be applied on a per slave basis.
     * Result  buffer  is  not  cleared anymore. It is now up to the user
       application to invalidate data after a data retrieval function has
       failed   (Clearing   the   result   buffer   caused   problems  in
       multi-threaded apps).
     * New     configuration    methods:    configureStandard32BitMode(),
       configureLittleEndianFloats(),      configureStandard32BitMode(int
       slaveAddr),                        configureSingleReg32BitMode(int
       slaveAddr),configureCountFromOne(int                    slaveAddr)
       configureCountFromZero(int   slaveAddr),  configureCountFromOne(),
       configureLittleEndianInts(int slaveAddr),
       configureSingleReg32BitMode(),          configureBigEndianInts(int
       slaveAddr), configureCountFromZero(),
       configureLittleEndianFloats(int                        slaveAddr),
       configureLittleEndianInts() configureSwappedFloats(int slaveAddr)

  2.0 (2003-08-15)

     * Logger  class  changed,  it does not depend on the availability of
       Swing  anymore.  Swing is not available on some stripped down Java
       micro  editions. Logger now supports debug log configuration via a
       logger.properties  file.  Renamed  closeConnection  and  closePort
       methods  to  closeProtocol.  Renamed  openConnection  and openPort
       methods  to  openProtocol. openProtocol (formerly openPort) method
       opens  serial  port  now  with NO PARITY. Implemented new time-out
       mechanism which uses a monitor thread. The old mechanism relied on
       the  COMM  API's time-out function which did not work reliable due
       to  a  bug  in  Microsoft's  Win98  COMM  driver. Small changes to
       compile against TINI SDK 1.11.

  1.1 (2002-02-18)

     * Class         MbusSerialMasterProtocol         made        public,
       MbusTcpProtocol.setPort()  validates  now  port  parameter passed,
       MbusTcpProtocol.isConnected() renamed to MbusTcpProtocol.isOpen(),
       isOpen() introduced in MbusMasterFunctions.

  1.0 (2002-02-10)

     * First release
     _________________________________________________________________

   Copyright (c) 2002-2021 proconX Pty Ltd. All rights reserved.

   Email: [4]mail@modbusdriver.com

   THIS  IS  PROPRIETARY  SOFTWARE  AND  YOU  NEED  A  LICENSE  TO USE OR
   REDISTRIBUTE.

   Please refer to file LICENSE-LIB for license and distribution terms.

   THIS  SOFTWARE IS PROVIDED BY PROCONX AND CONTRIBUTORS "AS IS" AND ANY
   EXPRESS  OR  IMPLIED  WARRANTIES,  INCLUDING,  BUT NOT LIMITED TO, THE
   IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND FITNESS FOR A PARTICULAR
   PURPOSE  ARE  DISCLAIMED. IN NO EVENT SHALL PROCONX OR CONTRIBUTORS BE
   LIABLE  FOR  ANY  DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
   CONSEQUENTIAL  DAMAGES  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
   SUBSTITUTE  GOODS  OR  SERVICES;  LOSS  OF  USE,  DATA, OR PROFITS; OR
   BUSINESS  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
   WHETHER  IN  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
   OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
   IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     _________________________________________________________________

References

   1. file://localhost/doc/html/index.html
   2. file://localhost/doc/README.pdf
   3. http://www.modbusdriver.com/doc
   4. mailto:mail@modbusdriver.com