Merge branch 'dev'

Author: dhoomakethu

.github/workflows/ci.yml

@@ -158,7 +158,7 @@ jobs:
           mkdir --parents $(dirname $PYPY_EXTERNALS_PATH)
           hg clone https://foss.heptapod.net/pypy/externals/ $PYPY_EXTERNALS_PATH
           dir $PYPY_EXTERNALS_PATH
-          cd $PYPY_EXTERNALS_PATH && hg update win32_14x
+          cd $PYPY_EXTERNALS_PATH && hg update win$(python -c 'import struct; print(struct.calcsize("P") * 8)')_14x
           echo "INCLUDE=$PYPY_EXTERNALS_PATH/include;$INCLUDE" >> $GITHUB_ENV
           echo "LIB=$PYPY_EXTERNALS_PATH/lib;$LIB" >> $GITHUB_ENV
 #          echo "CL=${{ matrix.PYTHON.CL_FLAGS }}" >> $GITHUB_ENV

CHANGELOG.rst

@@ -1,3 +1,11 @@
+version 2.5.3
+----------------------------------------------------------
+* Fix retries on tcp client failing randomly.
+* Fix Asyncio client timeout arg not being used.
+* Treat exception codes as valid responses
+* Fix examples (modbus_payload)
+* Add missing identity argument to async ModbusSerialServer
+
 version 2.5.2
 ----------------------------------------------------------
 * Add kwarg `reset_socket` to control closing of the socket on read failures (set to `True` by default).

README.rst

@@ -89,7 +89,7 @@ For those of you that just want to get started fast, here you go::
     client.close()
 
 For more advanced examples, check out the `Examples <https://pymodbus.readthedocs.io/en/dev/source/example/modules.html>`_ included in the
-respository. If you have created any utilities that meet a specific
+repository. If you have created any utilities that meet a specific
 need, feel free to submit them so others can benefit.
 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -113,7 +113,7 @@ get lost in the noise: http://groups.google.com/group/pymodbus or
 at gitter:  https://gitter.im/pymodbus_dev/Lobby
 
 .. important::
-   **Note For async clients, it is recomended to use `asyncio` as the async facilitator (Python 3.6 and above).**
+   **Note For async clients, it is recommended to use `asyncio` as the async facilitator (Python 3.6 and above).**
    **If using tornado make sure the tornado version is `4.5.3`.Other versions of tornado can break the implementation**
 
 

examples/common/async_asyncio_client.py

@@ -4,7 +4,7 @@
 --------------------------------------------------------------------------
 
 The following is an example of how to use the asynchronous modbus
-client implementation from pymodbus with ayncio.
+client implementation from pymodbus with asyncio.
 
 The example is only valid on Python3.4 and above
 """

examples/common/async_asyncio_serial_client.py

@@ -4,7 +4,7 @@
 --------------------------------------------------------------------------
 
 The following is an example of how to use the asynchronous serial modbus
-client implementation from pymodbus with ayncio.
+client implementation from pymodbus with asyncio.
 
 The example is only valid on Python3.4 and above
 """

examples/common/asynchronous_processor.py

@@ -7,7 +7,7 @@
 free to use it as a skeleton guide in implementing your own.
 """
 # --------------------------------------------------------------------------- #
-# import the neccessary modules
+# import the necessary modules
 # --------------------------------------------------------------------------- #
 from twisted.internet import serialport, reactor
 from twisted.internet.protocol import ClientFactory
@@ -46,7 +46,7 @@
 # --------------------------------------------------------------------------- #
 # an example custom protocol
 # --------------------------------------------------------------------------- #
-# Here you can perform your main procesing loop utilizing defereds and timed
+# Here you can perform your main processing loop utilizing defereds and timed
 # callbacks.
 # --------------------------------------------------------------------------- #
 class ExampleProtocol(ModbusClientProtocol):

examples/common/modbus_payload.py

@@ -35,23 +35,31 @@ def run_binary_payload_ex():
     # ----------------------------------------------------------------------- #
     client = ModbusClient('127.0.0.1', port=5020)
     client.connect()
-    
+
     # ----------------------------------------------------------------------- #
     # If you need to build a complex message to send, you can use the payload
     # builder to simplify the packing logic.
     #
     # Here we demonstrate packing a random payload layout, unpacked it looks
     # like the following:
     #
-    # - a 8 byte string 'abcdefgh'
-    # - a 32 bit float 22.34
-    # - a 16 bit unsigned int 0x1234
-    # - another 16 bit unsigned int 0x5678
-    # - an 8 bit int 0x12
+    # - an 8 byte string "abcdefgh"
     # - an 8 bit bitstring [0,1,0,1,1,0,1,0]
-    # - an 32 bit uint 0x12345678
-    # - an 32 bit signed int -0x1234
-    # - an 64 bit signed int 0x12345678
+    # - an 8 bit int -0x12
+    # - an 8 bit unsigned int 0x12
+    # - a 16 bit int -0x5678
+    # - a 16 bit unsigned int 0x1234
+    # - a 32 bit int -0x1234
+    # - a 32 bit unsigned int 0x12345678
+    # - a 16 bit float 12.34
+    # - a 16 bit float -12.34
+    # - a 32 bit float 22.34
+    # - a 32 bit float -22.34
+    # - a 64 bit int -0xDEADBEEF
+    # - a 64 bit unsigned int 0x12345678DEADBEEF
+    # - another 64 bit unsigned int 0x12345678DEADBEEF
+    # - a 64 bit float 123.45
+    # - a 64 bit float -123.45
 
     # The packing can also be applied to the word (wordorder) and bytes in each
     # word (byteorder)
@@ -123,12 +131,23 @@ def run_binary_payload_ex():
         # Here we demonstrate decoding a random register layout, unpacked it looks
         # like the following:
         #
-        # - a 8 byte string 'abcdefgh'
-        # - a 32 bit float 22.34
-        # - a 16 bit unsigned int 0x1234
-        # - another 16 bit unsigned int which we will ignore
-        # - an 8 bit int 0x12
+        # - an 8 byte string "abcdefgh"
         # - an 8 bit bitstring [0,1,0,1,1,0,1,0]
+        # - an 8 bit int -0x12
+        # - an 8 bit unsigned int 0x12
+        # - a 16 bit int -0x5678
+        # - a 16 bit unsigned int 0x1234
+        # - a 32 bit int -0x1234
+        # - a 32 bit unsigned int 0x12345678
+        # - a 16 bit float 12.34
+        # - a 16 bit float -12.34
+        # - a 32 bit float 22.34
+        # - a 32 bit float -22.34
+        # - a 64 bit int -0xDEADBEEF
+        # - a 64 bit unsigned int 0x12345678DEADBEEF
+        # - another 64 bit unsigned int which we will ignore
+        # - a 64 bit float 123.45
+        # - a 64 bit float -123.45
         # ----------------------------------------------------------------------- #
         address = 0x0
         count = len(payload)
@@ -174,7 +193,7 @@ def run_binary_payload_ex():
         print("-" * 60)
         for name, value in iteritems(decoded):
             print("%s\t" % name, hex(value) if isinstance(value, int) else value)
-    
+
     # ----------------------------------------------------------------------- #
     # close the client
     # ----------------------------------------------------------------------- #

examples/contrib/asynchronous_asyncio_modbus_tls_client.py

@@ -8,7 +8,7 @@
 the TLS feature and asyncio.
 """
 # -------------------------------------------------------------------------- #
-# import neccessary libraries
+# import necessary libraries
 # -------------------------------------------------------------------------- #
 import ssl
 from pymodbus.client.asynchronous.tls import AsyncModbusTLSClient

examples/contrib/bcd_payload.py

@@ -142,7 +142,7 @@ def add_string(self, value):
 class BcdPayloadDecoder(object):
     """
     A utility that helps decode binary coded decimal payload
-    messages from a modbus reponse message. What follows is
+    messages from a modbus response message. What follows is
     a simple example::
 
         decoder = BcdPayloadDecoder(payload)

examples/contrib/concurrent_client.py

@@ -26,7 +26,7 @@
     from futures import Future
 
 # -------------------------------------------------------------------------- #
-# import neccessary modbus libraries
+# import necessary modbus libraries
 # -------------------------------------------------------------------------- #
 from pymodbus.client.common import ModbusClientMixin