foo

Added FC 22 Mask Write Register support

.gitignore

@@ -0,0 +1,4 @@
+/vendor
+composer.lock
+
+*~

.hgignore

@@ -1,2 +0,0 @@
-vendor
-.svn

.hgtags

@@ -1,5 +0,0 @@
-a88b5a87fb4cd49f16ce72062cce19d55f1fbf98 0.2
-a7f90c18859d31922bdd8c61299e2790f5e2eb1a 0.3
-bdf8b3f414c4d08fc0edf9fd1953f55db26e4bac 0.4
-1e09b0da7d8c62a9a292ee51540feac9de4c1222 0.4.1
-e1262f028e180c2719564f840ffa1a9f8672b6be 0.5

LICENSE

@@ -1,62 +1,89 @@
-The Phpmodbus License, Version 1
++---------------------------------------------------------+
-============================
+| ACKNOWLEDGEMENTS                                        |
-
++---------------------------------------------------------+
-Copyright (c) 2004, 2011 Jan Krakora, Wago (http://www.wago.com)
+
-All rights reserved.
+This project is based on work by Jan Krákora, (c) 2004-2013.
-
+The original license is reproduced below.
-This license is a legal agreement between you and Jan Krakora, Wago (the "Author")
+
-for the use of Phpmodbus (the "Software"). By obtaining, using and/or
+  https://code.google.com/archive/p/phpmodbus/
-copying the Software, you agree that you have read, understood, and will
+
-comply with the terms and conditions of this license.
+Further improvements - John S. Long and other contributors
-
+
-
+  https://github.com/adduc/phpmodbus
-PERMITTED USE
+  
--------------
+Cleanup and namespaces - Ondřej Hruška, 2016
-
+
-You are permitted to use, copy, modify, and distribute the Software and its
+  https://github.com/MightyPork/phpmodbus
-documentation, with or without modification, for any purpose, provided that
+
-the following conditions are met:
+
-
++---------------------------------------------------------+
-1. A copy of this license agreement must be included with the distribution.
+| ORIGINAL LICENSE                                        |
-
++---------------------------------------------------------+
-2. Redistributions of source code must retain the above copyright notice in
+
-   all source code files.
+
-
+The Phpmodbus License, Version 1
-3. Redistributions in binary form must reproduce the above copyright notice
+============================
-   in the documentation and/or other materials provided with the distribution.
+
-
+Copyright (c) 2004, 2013 Jan Krakora
-4. Products derived from the Software must include an acknowledgment that
+All rights reserved.
-   they are derived from "Phpmodbus" in their documentation and/or other
+
-   materials provided with the distribution.
+This license is a legal agreement between you and Jan Krakora (the "Author")
-
+for the use of Phpmodbus (the "Software"). By obtaining, using and/or
-5. The name "Phpmodbus" must not be used to endorse or promote products
+copying the Software, you agree that you have read, understood, and will
-   derived from the Software without prior written permission from Author.
+comply with the terms and conditions of this license.
-
+
-6. Products derived from the Software may not be called "Phpmodbus",
+
-   nor may "Phpmodbus" appear in their name, without prior written
+PERMITTED USE
-   permission from Author.
+-------------
-
+
-
+You are permitted to use, copy, modify, and distribute the Software and its
-INDEMNITY
+documentation, with or without modification, for any purpose, provided that
----------
+the following conditions are met:
-
+
-You agree to indemnify and hold harmless the Author and any contributors
+1. A copy of this license agreement must be included with the distribution.
-for any direct, indirect, incidental, or consequential third-party claims,
+
-actions or suits, as well as any related expenses, liabilities, damages,
+2. Redistributions of source code must retain the above copyright notice in
-settlements or fees arising from your use or misuse of the Software,
+   all source code files.
-or a violation of any terms of this license.
+
-
+3. Redistributions in binary form must reproduce the above copyright notice
-
+   in the documentation and/or other materials provided with the distribution.
-DISCLAIMER OF WARRANTY
+
-----------------------
+4. Products derived from the Software must include an acknowledgment that
-
+   they are derived from "Phpmodbus" in their documentation and/or other
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "AS IS" AND
+   materials provided with the distribution.
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+5. The name "Phpmodbus" must not be used to endorse or promote products
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR
+   derived from the Software without prior written permission from Author.
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+6. Products derived from the Software may not be called "Phpmodbus",
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+   nor may "Phpmodbus" appear in their name, without prior written
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+   permission from Author.
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
+
+INDEMNITY
+---------
+
+You agree to indemnify and hold harmless the Author and any contributors
+for any direct, indirect, incidental, or consequential third-party claims,
+actions or suits, as well as any related expenses, liabilities, damages,
+settlements or fees arising from your use or misuse of the Software,
+or a violation of any terms of this license.
+
+
+DISCLAIMER OF WARRANTY
+----------------------
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "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 THE COPYRIGHT HOLDER 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. 
+
+
+
+End of file.

README.md

@@ -0,0 +1,49 @@
+# phpmodbus
+
+Implementation of the basic functionality of the Modbus TCP and UDP based protocol using PHP. 
+
+This is a fork of the original project at https://code.google.com/p/phpmodbus/
+
+> **What's new**
+> 
+> This fork adds a namespace and fixes issues encountered when porting to PHP 7
+
+**WARNING: Everything except the actual code in this repo may be broken and outdated.**
+
+Implemented features:
+ * Modbus master
+  * FC1 - Read coils 
+  * FC2 - Read input discretes
+  * FC3 - Read holding registers 
+  * FC4 - Read holding input registers 
+  * FC5 - Write single coil 
+  * FC6 - Write single register
+  * FC15 - Write multiple coils
+  * FC16 - Write multiple registers
+  * FC23 - Read/Write multiple registers
+
+Example:
+
+```php
+require_once dirname(__FILE__) . '/Phpmodbus/ModbusMaster.php'; 
+
+// Modbus master UDP
+$modbus = new ModbusMaster("192.168.1.1", "UDP"); 
+// Read multiple registers
+try {
+    $recData = $modbus->readMultipleRegisters(0, 12288, 5); 
+}
+catch (Exception $e) {
+    // Print error information if any
+    echo $modbus;
+    echo $e;
+    exit;
+}
+// Print data in string format
+echo PhpType::bytes2string($recData); 
+```
+
+For more see [http://code.google.com/p/phpmodbus/downloads/list documentation] or [http://code.google.com/p/phpmodbus/wiki/FAQ FAQ].
+
+Note: 
+ * The PHP extension php_sockets.dll should be enabled (server php.ini file)

composer.json

@@ -1,17 +1,21 @@
 {
-    "name": "adduc/phpmodbus",
+  "name": "MightyPork/phpmodbus",
-    "description": "Composer version of PhpModBus",
+  "keywords": ["phpmodbus","modbus"],
-    "license": "LGPL",
+  "description": "PhpModbus with namespaces and updated to PHP 7",
-    "authors": [
+  "license": "LGPL",
-        {
+  "require": {
-            "name": "Honza Krakora",
+    "php": "^5.3.2 || ^7.0",
-            "email": "krakora.jan@googlemail.com"
+    "ext-sockets": "*"
-        }
+  },
-    ],
+  "authors": [
-    "autoload": {
+    {
-        "classmap": [ "Phpmodbus" ]
+      "name": "Honza Krakora",
-    },
+      "email": "krakora.jan@googlemail.com"
-    "require": {
-        "ext-sockets": "*"
     }
+  ],
+  "autoload": {
+    "psr-4": {
+      "PHPModbus\\": "src/"
+    }
+  }
 }

examples/README.md

@@ -0,0 +1,3 @@
+Those examples have not been updated to use namespaces.
+
+They may not work. Just for reference.

examples/example_fc22.php

@@ -0,0 +1,28 @@
+<?php
+
+require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+
+// Create Modbus object
+$modbus = new ModbusMaster("192.192.15.51", "UDP");
+
+// Data to be writen
+$bitValue = true;
+$bitNumber = 2;
+$andMask =  0xFFFF ^ pow(2, $bitNumber) ;
+$orMask =  0x0000 ^ (pow(2, $bitNumber) * $bitValue ) ;
+
+try {
+    // FC22
+    $modbus->maskWriteRegister(0, 12288, $andMask, $orMask);
+}
+catch (Exception $e) {
+    // Print error information if any
+    echo $modbus;
+    echo $e;
+    exit;
+}
+
+// Print status information
+echo $modbus;
+
+?>

examples/example_fc4.php

@@ -0,0 +1,19 @@
+<?php
+
+require_once dirname(__FILE__) . '/../../Phpmodbus/ModbusMasterUdp.php';
+
+// Create Modbus object
+$modbus = new ModbusMasterUdp("192.192.15.51");
+
+try {
+    // Read input discretes - FC 4
+    $recData = $modbus->readMultipleInputRegisters(0, 0, 2);
+}
+catch (Exception $e) {
+    // Print error information if any
+    echo $modbus;
+    echo $e;
+    exit;
+}
+
+var_dump($recData);

examples/example_fc5.php

@@ -0,0 +1,24 @@
+<?php
+
+require_once dirname(__FILE__) . '/../../Phpmodbus/ModbusMasterUdp.php';
+
+// Create Modbus object
+$modbus = new ModbusMasterUdp("192.192.15.51");
+
+// Data to be writen - TRUE, FALSE
+$data_true = array(TRUE);
+$data_false = array(FALSE);
+
+try {
+    // Write single coil - FC5
+    $modbus->writeSingleCoil(0, 12288, $data_true);
+    $modbus->writeSingleCoil(0, 12289, $data_false);
+    $modbus->writeSingleCoil(0, 12290, $data_true);
+    $modbus->writeSingleCoil(0, 12291, $data_false);
+}
+catch (Exception $e) {
+    // Print error information if any
+    echo $modbus;
+    echo $e;
+    exit;
+}

src/IecType.php

@@ -1,133 +1,136 @@
-<?php
+<?php
-/**
+
- * Phpmodbus Copyright (c) 2004, 2010 Jan Krakora, WAGO Kontakttechnik GmbH & Co. KG (http://www.wago.com)
+namespace PHPModbus;
- *
+
- * This source file is subject to the "PhpModbus license" that is bundled
+/**
- * with this package in the file license.txt.
+ * Phpmodbus Copyright (c) 2004, 2013 Jan Krakora
- *
+ *
- * @author Jan Krakora
+ * This source file is subject to the "PhpModbus license" that is bundled
- * @copyright Copyright (c) 2004, 2010 Jan Krakora, WAGO Kontakttechnik GmbH & Co. KG (http://www.wago.com)
+ * with this package in the file license.txt.
- * @license PhpModbus license
+ *
- * @category Phpmodbus
+ * @author Jan Krakora
- * @package Phpmodbus
+ * @copyright Copyright (c) 2004, 2013 Jan Krakora
- * @version $id$
+ * @license PhpModbus license
- */
+ * @category Phpmodbus
-
+ * @package Phpmodbus
-/**
+ * @version $id$
- * IecType
+ */
- *
+
- * The class includes set of IEC-1131 data type functions that converts a PHP
+/**
- * data types to a IEC data type.
+ * IecType
- *
+ *
- * @author Jan Krakora
+ * The class includes set of IEC-1131 data type functions that converts a PHP
- * @copyright  Copyright (c) 2004, 2010 Jan Krakora, WAGO Kontakttechnik GmbH & Co. KG (http://www.wago.com)
+ * data types to a IEC data type.
- * @package Phpmodbus
+ *
- */
+ * @author Jan Krakora
-class IecType {
+ * @copyright  Copyright (c) 2004, 2010 Jan Krakora
-
+ * @package Phpmodbus
-    /**
+ */
-     * iecBYTE
+class IecType {
-     *
+
-     * Converts a value to IEC-1131 BYTE data type
+    /**
-     *
+     * iecBYTE
-     * @param value value from 0 to 255
+     *
-     * @return value IEC BYTE data type
+     * Converts a value to IEC-1131 BYTE data type
-     *
+     *
-     */
+     * @param value value from 0 to 255
-    public static function iecBYTE($value) {
+     * @return value IEC BYTE data type
-        return chr($value & 0xFF);
+     *
-    }
+     */
-
+    public static function iecBYTE($value) {
-    /**
+        return chr($value & 0xFF);
-     * iecINT
+    }
-     *
+
-     * Converts a value to IEC-1131 INT data type
+    /**
-     *
+     * iecINT
-     * @param value value to be converted
+     *
-     * @return value IEC-1131 INT data type
+     * Converts a value to IEC-1131 INT data type
-     *
+     *
-     */
+     * @param value value to be converted
-    public static function iecINT($value) {
+     * @return value IEC-1131 INT data type
-        return self::iecBYTE(($value >> 8) & 0x00FF) .
+     *
-                self::iecBYTE(($value & 0x00FF));
+     */
-    }
+    public static function iecINT($value) {
-
+        return self::iecBYTE(($value >> 8) & 0x00FF) .
-    /**
+                self::iecBYTE(($value & 0x00FF));
-     * iecDINT
+    }
-     *
+
-     * Converts a value to IEC-1131 DINT data type
+    /**
-     *
+     * iecDINT
-     * @param value value to be converted
+     *
-     * @param value endianness defines endian codding (little endian == 0, big endian == 1)
+     * Converts a value to IEC-1131 DINT data type
-     * @return value IEC-1131 INT data type
+     *
-     *
+     * @param value value to be converted
-     */
+     * @param value endianness defines endian codding (little endian == 0, big endian == 1)
-    public static function iecDINT($value, $endianness = 0) {
+     * @return value IEC-1131 INT data type
-        // result with right endianness
+     *
-        return self::endianness($value, $endianness);
+     */
-    }
+    public static function iecDINT($value, $endianness = 0) {
-
+        // result with right endianness
-    /**
+        return self::endianness($value, $endianness);
-     * iecREAL
+    }
-     *
+
-     * Converts a value to IEC-1131 REAL data type. The function uses function  @use float2iecReal.
+    /**
-     *
+     * iecREAL
-     * @param value value to be converted
+     *
-     * @param value endianness defines endian codding (little endian == 0, big endian == 1)
+     * Converts a value to IEC-1131 REAL data type. The function uses function  @use float2iecReal.
-     * @return value IEC-1131 REAL data type
+     *
-     */
+     * @param value value to be converted
-    public static function iecREAL($value, $endianness = 0) {
+     * @param value endianness defines endian codding (little endian == 0, big endian == 1)
-        // iecREAL representation
+     * @return value IEC-1131 REAL data type
-        $real = self::float2iecReal($value);
+     */
-        // result with right endianness
+    public static function iecREAL($value, $endianness = 0) {
-        return self::endianness($real, $endianness);
+        // iecREAL representation
-    }
+        $real = self::float2iecReal($value);
-
+        // result with right endianness
-    /**
+        return self::endianness($real, $endianness);
-     * float2iecReal
+    }
-     *
+
-     * This function converts float value to IEC-1131 REAL single precision form.
+    /**
-     *
+     * float2iecReal
-     * For more see [{@link http://en.wikipedia.org/wiki/Single_precision Single precision on Wiki}] or
+     *
-     * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes @ Georgia Tech 21-Nov-2007] or
+     * This function converts float value to IEC-1131 REAL single precision form.
-     * [{@link http://www.php.net/manual/en/function.pack.php PHP pack/unpack functionality}]
+     *
-     *
+     * For more see [{@link http://en.wikipedia.org/wiki/Single_precision Single precision on Wiki}] or
-     * @param float value to be converted
+     * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes @ Georgia Tech 21-Nov-2007] or
-     * @return value IEC REAL data type
+     * [{@link http://www.php.net/manual/en/function.pack.php PHP pack/unpack functionality}]
-     */
+     *
-    private static function float2iecReal($value) {
+     * @param float value to be converted
-        // get float binary string
+     * @return value IEC REAL data type
-        $float = pack("f", $value);
+     */
-        // set 32-bit unsigned integer of the float
+    private static function float2iecReal($value) {
-        $w = unpack("L", $float);
+        // get float binary string
-        return $w[1];
+        $float = pack("f", $value);
-    }
+        // set 32-bit unsigned integer of the float
-
+        $w = unpack("L", $float);
-    /**
+        return $w[1];
-     * endianness
+    }
-     *
+
-     * Make endianess as required.
+    /**
-     * For more see http://en.wikipedia.org/wiki/Endianness
+     * endianness
-     *
+     *
-     * @param int $value
+     * Make endianess as required.
-     * @param bool $endianness
+     * For more see http://en.wikipedia.org/wiki/Endianness
-     * @return int
+     *
-     */
+     * @param int $value
-    private static function endianness($value, $endianness = 0) {
+     * @param bool $endianness
-        if ($endianness == 0)
+     * @return int
-            return
+     */
-                    self::iecBYTE(($value >> 8) & 0x000000FF) .
+    private static function endianness($value, $endianness = 0) {
-                    self::iecBYTE(($value & 0x000000FF)) .
+        if ($endianness == 0)
-                    self::iecBYTE(($value >> 24) & 0x000000FF) .
+            return
-                    self::iecBYTE(($value >> 16) & 0x000000FF);
+                    self::iecBYTE(($value >> 8) & 0x000000FF) .
-        else
+                    self::iecBYTE(($value & 0x000000FF)) .
-            return
+                    self::iecBYTE(($value >> 24) & 0x000000FF) .
-                    self::iecBYTE(($value >> 24) & 0x000000FF) .
+                    self::iecBYTE(($value >> 16) & 0x000000FF);
-                    self::iecBYTE(($value >> 16) & 0x000000FF) .
+        else
-                    self::iecBYTE(($value >> 8) & 0x000000FF) .
+            return
-                    self::iecBYTE(($value & 0x000000FF));
+                    self::iecBYTE(($value >> 24) & 0x000000FF) .
-    }
+                    self::iecBYTE(($value >> 16) & 0x000000FF) .
-
+                    self::iecBYTE(($value >> 8) & 0x000000FF) .
-}
+                    self::iecBYTE(($value & 0x000000FF));
-
+    }
+
+}
+
 ?>

src/ModbusMaster.php

@@ -1,12 +1,15 @@
 <?php
+
+namespace PHPModbus;
+
 /**
- * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
+ * Phpmodbus Copyright (c) 2004, 2013 Jan Krakora
  *  
  * This source file is subject to the "PhpModbus license" that is bundled
  * with this package in the file license.txt.
  *   
  *
- * @copyright  Copyright (c) 2004, 2012 Jan Krakora
+ * @copyright  Copyright (c) 2004, 2013 Jan Krakora
  * @license PhpModbus license 
  * @category Phpmodbus
  * @tutorial Phpmodbus.pkg 
@@ -15,9 +18,6 @@
  *  
  */
 
-require_once dirname(__FILE__) . '/IecType.php';
-require_once dirname(__FILE__) . '/PhpType.php'; 
-
 /**
  * ModbusMaster
  *
@@ -27,13 +27,16 @@ require_once dirname(__FILE__) . '/PhpType.php';
  *   - FC  1: read coils
  *   - FC  2: read input discretes
  *   - FC  3: read multiple registers
+ *   - FC  4: read multiple input registers 
+ *   - FC  5: write single coil  
  *   - FC  6: write single register
  *   - FC 15: write multiple coils
  *   - FC 16: write multiple registers
+ *   - FC 22: mask write register
  *   - FC 23: read write registers
  *   
  * @author Jan Krakora
- * @copyright  Copyright (c) 2004, 2012 Jan Krakora
+ * @copyright  Copyright (c) 2004, 2013 Jan Krakora
  * @package Phpmodbus  
  *
  */
@@ -98,6 +101,8 @@ class ModbusMaster {
             $this->status .= "Bound\n";
         }
     }
+    // Socket settings
+    socket_set_option($this->sock, SOL_SOCKET, SO_SNDTIMEO, array('sec' => 1, 'usec' => 0));
     // Connect the socket
     $result = @socket_connect($this->sock, $this->host, $this->port);
     if ($result === false) {
@@ -510,6 +515,207 @@ class ModbusMaster {
     return $data;
   }
   
+  /**
+   * readMultipleInputRegisters
+   *
+   * Modbus function FC 4(0x04) - Read Multiple Input Registers.
+   * 
+   * This function reads {@link $quantity} of Words (2 bytes) from reference 
+   * {@link $referenceRead} of a memory of a Modbus device given by 
+   * {@link $unitId}.
+   *    
+   *
+   * @param int $unitId usually ID of Modbus device 
+   * @param int $reference Reference in the device memory to read data.
+   * @param int $quantity Amounth of the data to be read from device.
+   * @return false|Array Success flag or array of received data.
+   */
+  function readMultipleInputRegisters($unitId, $reference, $quantity){
+    $this->status .= "readMultipleInputRegisters: START\n";
+    // connect
+    $this->connect();
+    // send FC 4    
+    $packet = $this->readMultipleInputRegistersPacketBuilder($unitId, $reference, $quantity);
+    $this->status .= $this->printPacket($packet);    
+    $this->send($packet);
+    // receive response
+    $rpacket = $this->rec();
+    $this->status .= $this->printPacket($rpacket);    
+    // parse packet    
+    $receivedData = $this->readMultipleInputRegistersParser($rpacket);
+    // disconnect
+    $this->disconnect();
+    $this->status .= "readMultipleInputRegisters: DONE\n";
+    // return
+    return $receivedData;
+  }
+  
+  /**
+   * fc4
+   *
+   * Alias to {@link readMultipleInputRegisters} method.
+   *
+   * @param int $unitId
+   * @param int $reference
+   * @param int $quantity
+   * @return false|Array
+   */
+  function fc4($unitId, $reference, $quantity){
+    return $this->readMultipleInputRegisters($unitId, $reference, $quantity);
+  }  
+  
+  /**
+   * readMultipleInputRegistersPacketBuilder
+   *
+   * Packet FC 4 builder - read multiple input registers
+   *
+   * @param int $unitId
+   * @param int $reference
+   * @param int $quantity
+   * @return string
+   */
+  private function readMultipleInputRegistersPacketBuilder($unitId, $reference, $quantity){
+    $dataLen = 0;
+    // build data section
+    $buffer1 = "";
+    // build body
+    $buffer2 = "";
+    $buffer2 .= iecType::iecBYTE(4);                                                // FC 4 = 4(0x04)
+    // build body - read section    
+    $buffer2 .= iecType::iecINT($reference);                                        // refnumber = 12288      
+    $buffer2 .= iecType::iecINT($quantity);                                         // quantity
+    $dataLen += 5;
+    // build header
+    $buffer3 = '';
+    $buffer3 .= iecType::iecINT(rand(0,65000));                                     // transaction ID
+    $buffer3 .= iecType::iecINT(0);                                                 // protocol ID
+    $buffer3 .= iecType::iecINT($dataLen + 1);                                      // lenght
+    $buffer3 .= iecType::iecBYTE($unitId);                                          // unit ID
+    // return packet string
+    return $buffer3. $buffer2. $buffer1;
+  }
+  
+  /**
+   * readMultipleInputRegistersParser
+   *
+   * FC 4 response parser
+   *
+   * @param string $packet
+   * @return array
+   */
+  private function readMultipleInputRegistersParser($packet){    
+    $data = array();
+    // check Response code
+    $this->responseCode($packet);
+    // get data
+    for($i=0;$i<ord($packet[8]);$i++){
+      $data[$i] = ord($packet[9+$i]);
+    }    
+    return $data;
+  }
+  
+  /**
+   * writeSingleCoil
+   *
+   * Modbus function FC5(0x05) - Write Single Register.
+   *
+   * This function writes {@link $data} single coil at {@link $reference} position of 
+   * memory of a Modbus device given by {@link $unitId}.
+   *
+   *
+   * @param int $unitId usually ID of Modbus device 
+   * @param int $reference Reference in the device memory (e.g. in device WAGO 750-841, memory MW0 starts at address 12288)
+   * @param array $data value to be written (TRUE|FALSE).
+   * @return bool Success flag
+   */       
+  function writeSingleCoil($unitId, $reference, $data){
+    $this->status .= "writeSingleCoil: START\n";
+    // connect
+    $this->connect();
+    // send FC5    
+    $packet = $this->writeSingleCoilPacketBuilder($unitId, $reference, $data);
+    $this->status .= $this->printPacket($packet);    
+    $this->send($packet);
+    // receive response
+    $rpacket = $this->rec();
+    $this->status .= $this->printPacket($rpacket);    
+    // parse packet
+    $this->writeSingleCoilParser($rpacket);
+    // disconnect
+    $this->disconnect();
+    $this->status .= "writeSingleCoil: DONE\n";
+    return true;
+  }
+
+
+  /**
+   * fc5
+   *
+   * Alias to {@link writeSingleCoil} method
+   *
+   * @param int $unitId
+   * @param int $reference
+   * @param array $data
+   * @param array $dataTypes
+   * @return bool
+   */
+  function fc5($unitId, $reference, $data, $dataTypes){    
+    return $this->writeSingleCoil($unitId, $reference, $data, $dataTypes);
+  }
+
+
+  /**
+   * writeSingleCoilPacketBuilder
+   *
+   * Packet builder FC5 - WRITE single register
+   *
+   * @param int $unitId
+   * @param int $reference
+   * @param array $data
+   * @param array $dataTypes
+   * @return string
+   */
+  private function writeSingleCoilPacketBuilder($unitId, $reference, $data){
+    $dataLen = 0;
+    // build data section
+    $buffer1 = "";
+    foreach($data as $key=>$dataitem) {
+      if($dataitem == TRUE){
+       $buffer1 = iecType::iecINT(0xFF00);
+      } else {
+       $buffer1 = iecType::iecINT(0x0000);
+      };
+    };
+    $dataLen += 2;
+    // build body
+    $buffer2 = "";
+    $buffer2 .= iecType::iecBYTE(5);             // FC5 = 5(0x05)
+    $buffer2 .= iecType::iecINT($reference);      // refnumber = 12288
+    $dataLen += 3;
+    // build header
+    $buffer3 = '';
+    $buffer3 .= iecType::iecINT(rand(0,65000));   // transaction ID    
+    $buffer3 .= iecType::iecINT(0);               // protocol ID    
+    $buffer3 .= iecType::iecINT($dataLen + 1);    // lenght    
+    $buffer3 .= iecType::iecBYTE($unitId);        //unit ID    
+    
+    // return packet string
+    return $buffer3. $buffer2. $buffer1;
+  }
+  
+  /**
+   * writeSingleCoilParser
+   *
+   * FC5 response parser
+   *
+   * @param string $packet
+   * @return bool
+   */
+  private function writeSingleCoilParser($packet){
+    $this->responseCode($packet);
+    return true;
+  }
+  
   /**
    * writeSingleRegister
    *
@@ -844,6 +1050,106 @@ class ModbusMaster {
     return true;
   }
 
+
+  /**
+   * maskWriteRegister
+   *
+   * Modbus function FC22(0x16) - Mask Write Register.
+   *
+   * This function alter single bit(s) at {@link $reference} position of
+   * memory of a Modbus device given by {@link $unitId}.
+   *
+   * Result = (Current Contents AND And_Mask) OR (Or_Mask AND (NOT And_Mask))
+   *
+   * @param int $unitId usually ID of Modbus device
+   * @param int $reference Reference in the device memory (e.g. in device WAGO 750-841, memory MW0 starts at address 12288)
+   * @param int $andMask
+   * @param int $orMask 
+   * @return bool Success flag
+   */
+  function maskWriteRegister($unitId, $reference, $andMask, $orMask){
+    $this->status .= "maskWriteRegister: START\n";
+    // connect
+    $this->connect();
+    // send FC22
+    $packet = $this->maskWriteRegisterPacketBuilder($unitId, $reference, $andMask, $orMask);
+    $this->status .= $this->printPacket($packet);
+    $this->send($packet);
+    // receive response
+    $rpacket = $this->rec();
+    $this->status .= $this->printPacket($rpacket);
+    // parse packet
+    $this->maskWriteRegisterParser($rpacket);
+    // disconnect
+    $this->disconnect();
+    $this->status .= "maskWriteRegister: DONE\n";
+    return true;
+  }
+
+
+  /**
+   * fc22
+   *
+   * Alias to {@link maskWriteRegister} method
+   *
+   * @param int $unitId
+   * @param int $reference
+   * @param int $andMask
+   * @param int $orMask
+   * @return bool
+   */
+  function fc22($unitId, $reference, $andMask, $orMask){
+    return $this->maskWriteRegister($unitId, $reference, $andMask, $orMask);
+  }
+
+
+  /**
+   * maskWriteRegisterPacketBuilder
+   *
+   * Packet builder FC22 - MASK WRITE register
+   *
+   * @param int $unitId
+   * @param int $reference
+   * @param int $andMask
+   * @param int $orMask
+   * @return string
+   */
+  private function maskWriteRegisterPacketBuilder($unitId, $reference, $andMask, $orMask){
+    $dataLen = 0;
+    // build data section
+    $buffer1 = "";
+    // build body
+    $buffer2 = "";
+    $buffer2 .= iecType::iecBYTE(22);             // FC 22 = 22(0x16)
+    $buffer2 .= iecType::iecINT($reference);      // refnumber = 12288
+    $buffer2 .= iecType::iecINT($andMask);        // AND mask
+    $buffer2 .= iecType::iecINT($orMask);     	  // OR mask
+    $dataLen += 7;
+    // build header
+    $buffer3 = '';
+    $buffer3 .= iecType::iecINT(rand(0,65000));   // transaction ID
+    $buffer3 .= iecType::iecINT(0);               // protocol ID
+    $buffer3 .= iecType::iecINT($dataLen + 1);    // lenght
+    $buffer3 .= iecType::iecBYTE($unitId);        //unit ID
+    // return packet string
+    return $buffer3. $buffer2. $buffer1;
+  }
+
+
+  /**
+   * maskWriteRegisterParser
+   *
+   * FC22 response parser
+   *
+   * @param string $packet
+   * @return bool
+   */
+  private function maskWriteRegisterParser($packet){
+    $this->responseCode($packet);
+    return true;
+  }
+
+
   /**
    * readWriteRegisters
    *

src/ModbusMasterTcp.php

@@ -1,49 +1,50 @@
-<?php
+<?php
-/**
+
- * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
+namespace PHPModbus;
- *  
+
- * This source file is subject to the "PhpModbus license" that is bundled
+/**
- * with this package in the file license.txt.
+ * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
- *   
+ *  
- *
+ * This source file is subject to the "PhpModbus license" that is bundled
- * @copyright  Copyright (c) 2004, 2012 Jan Krakora
+ * with this package in the file license.txt.
- * @license PhpModbus license 
+ *   
- * @category Phpmodbus
+ *
- * @tutorial Phpmodbus.pkg 
+ * @copyright  Copyright (c) 2004, 2012 Jan Krakora
- * @package Phpmodbus 
+ * @license PhpModbus license 
- * @version $id$
+ * @category Phpmodbus
- *  
+ * @tutorial Phpmodbus.pkg 
- */
+ * @package Phpmodbus 
-
+ * @version $id$
-require_once dirname(__FILE__) . '/ModbusMaster.php'; 
+ *  
-
+ */
-/**
+
- * ModbusMasterTcp
+/**
- *
+ * ModbusMasterTcp
- * This class deals with the MODBUS master using TCP. Extends ModbusMaster class.
+ *
- *  
+ * This class deals with the MODBUS master using TCP. Extends ModbusMaster class.
- * Implemented MODBUS functions:
+ *  
- *   - FC  1: read coils
+ * Implemented MODBUS functions:
- *   - FC  3: read multiple registers
+ *   - FC  1: read coils
- *   - FC 15: write multiple coils 
+ *   - FC  3: read multiple registers
- *   - FC 16: write multiple registers
+ *   - FC 15: write multiple coils 
- *   - FC 23: read write registers
+ *   - FC 16: write multiple registers
- *   
+ *   - FC 23: read write registers
- * @author Jan Krakora
+ *   
- * @copyright  Copyright (c) 2004, 2012 Jan Krakora
+ * @author Jan Krakora
- * @package Phpmodbus  
+ * @copyright  Copyright (c) 2004, 2012 Jan Krakora
- *
+ * @package Phpmodbus  
- */
+ *
-class ModbusMasterTcp extends ModbusMaster {
+ */
-  /**
+class ModbusMasterTcp extends ModbusMaster {
-   * ModbusMasterTcp
+  /**
-   *
+   * ModbusMasterTcp
-   * This is the constructor that defines {@link $host} IP address of the object. 
+   *
-   *     
+   * This is the constructor that defines {@link $host} IP address of the object. 
-   * @param String $host An IP address of a Modbus TCP device. E.g. "192.168.1.1".
+   *     
-   */         
+   * @param String $host An IP address of a Modbus TCP device. E.g. "192.168.1.1".
-  function ModbusMasterTcp($host){
+   */         
-    $this->host = $host;
+  function ModbusMasterTcp($host){
-    $this->socket_protocol = "TCP";
+    $this->host = $host;
-  }
+    $this->socket_protocol = "TCP";
-}
+  }
+}

src/ModbusMasterUdp.php

@@ -1,50 +1,51 @@
-<?php
+<?php
-/**
+
- * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
+namespace PHPModbus;
- *  
+
- * This source file is subject to the "PhpModbus license" that is bundled
+/**
- * with this package in the file license.txt.
+ * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
- *   
+ *  
- *
+ * This source file is subject to the "PhpModbus license" that is bundled
- * @copyright  Copyright (c) 2004, 2012 Jan Krakora
+ * with this package in the file license.txt.
- * @license PhpModbus license 
+ *   
- * @category Phpmodbus
+ *
- * @tutorial Phpmodbus.pkg 
+ * @copyright  Copyright (c) 2004, 2012 Jan Krakora
- * @package Phpmodbus 
+ * @license PhpModbus license 
- * @version $id$
+ * @category Phpmodbus
- *  
+ * @tutorial Phpmodbus.pkg 
- */
+ * @package Phpmodbus 
-
+ * @version $id$
-require_once dirname(__FILE__) . '/ModbusMaster.php'; 
+ *  
-
+ */
-/**
+
- * ModbusMasterUdp
+/**
- *
+ * ModbusMasterUdp
- * This class deals with the MODBUS master using UDP stack.
+ *
- *  
+ * This class deals with the MODBUS master using UDP stack.
- * Implemented MODBUS master functions:
+ *  
- *   - FC  1: read coils
+ * Implemented MODBUS master functions:
- *   - FC  3: read multiple registers
+ *   - FC  1: read coils
- *   - FC 15: write multiple coils 
+ *   - FC  3: read multiple registers
- *   - FC 16: write multiple registers
+ *   - FC 15: write multiple coils 
- *   - FC 23: read write registers
+ *   - FC 16: write multiple registers
- *   
+ *   - FC 23: read write registers
- * @author Jan Krakora
+ *   
- * @copyright  Copyright (c) 2004, 2012 Jan Krakora
+ * @author Jan Krakora
- * @package Phpmodbus  
+ * @copyright  Copyright (c) 2004, 2012 Jan Krakora
- *
+ * @package Phpmodbus  
- */
+ *
-class ModbusMasterUdp extends ModbusMaster {
+ */
-  
+class ModbusMasterUdp extends ModbusMaster {
-  /**
+  
-   * ModbusMasterUdp
+  /**
-   *
+   * ModbusMasterUdp
-   * This is the constructor that defines {@link $host} IP address of the object. 
+   *
-   *     
+   * This is the constructor that defines {@link $host} IP address of the object. 
-   * @param String $host An IP address of a Modbus UDP device. E.g. "192.168.1.1".
+   *     
-   */         
+   * @param String $host An IP address of a Modbus UDP device. E.g. "192.168.1.1".
-  function ModbusMasterUdp($host){
+   */         
-    $this->host = $host;
+  function ModbusMasterUdp($host){
-    $this->socket_protocol = "UDP";    
+    $this->host = $host;
-  }
+    $this->socket_protocol = "UDP";    
-}
+  }
+}

src/PhpType.php

@@ -1,249 +1,252 @@
-<?php
+<?php
-/**
+
- * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
+namespace PHPModbus;
- *
+
- * This source file is subject to the "PhpModbus license" that is bundled
+/**
- * with this package in the file license.txt.
+ * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
- *
+ *
- * @author Jan Krakora
+ * This source file is subject to the "PhpModbus license" that is bundled
- * @copyright Copyright (c) 2004, 2012 Jan Krakora
+ * with this package in the file license.txt.
- * @license PhpModbus license
+ *
- * @category Phpmodbus
+ * @author Jan Krakora
- * @package Phpmodbus
+ * @copyright Copyright (c) 2004, 2012 Jan Krakora
- * @version $id$
+ * @license PhpModbus license
- *
+ * @category Phpmodbus
- */
+ * @package Phpmodbus
-
+ * @version $id$
-/**
+ *
- * PhpType
+ */
- *
+
- * The class includes set of methods that convert the received Modbus data
+/**
- * (array of bytes) to the PHP data type, i.e. signed int, unsigned int and float.
+ * PhpType
- *
+ *
- * @author Jan Krakora
+ * The class includes set of methods that convert the received Modbus data
- * @copyright  Copyright (c) 2004, 2012 Jan Krakora
+ * (array of bytes) to the PHP data type, i.e. signed int, unsigned int and float.
- * @package Phpmodbus
+ *
- *
+ * @author Jan Krakora
- */
+ * @copyright  Copyright (c) 2004, 2012 Jan Krakora
-class PhpType {
+ * @package Phpmodbus
-
+ *
-    /**
+ */
-     * bytes2float
+class PhpType {
-     *
+
-     * The function converts array of 4 bytes to float. The return value
+    /**
-     * depends on order of the input bytes (endianning).
+     * bytes2float
-     *
+     *
-     * @param array $values
+     * The function converts array of 4 bytes to float. The return value
-     * @param bool $endianness
+     * depends on order of the input bytes (endianning).
-     * @return float
+     *
-     */
+     * @param array $values
-    public static function bytes2float($values, $endianness = 0) {
+     * @param bool $endianness
-        $data = array();
+     * @return float
-        $real = 0;
+     */
-
+    public static function bytes2float($values, $endianness = 0) {
-        // Set the array to correct form
+        $data = array();
-        $data = self::checkData($values);
+        $real = 0;
-        // Combine bytes
+
-        $real = self::combineBytes($data, $endianness);
+        // Set the array to correct form
-        // Convert the real value to float
+        $data = self::checkData($values);
-        return (float) self::real2float($real);
+        // Combine bytes
-    }
+        $real = self::combineBytes($data, $endianness);
-
+        // Convert the real value to float
-    /**
+        return (float) self::real2float($real);
-     * bytes2signedInt
+    }
-     *
+
-     * The function converts array of 2 or 4 bytes to signed integer.
+    /**
-     * The return value depends on order of the input bytes (endianning).
+     * bytes2signedInt
-     *
+     *
-     * @param array $values
+     * The function converts array of 2 or 4 bytes to signed integer.
-     * @param bool $endianness
+     * The return value depends on order of the input bytes (endianning).
-     * @return int
+     *
-     */
+     * @param array $values
-    public static function bytes2signedInt($values, $endianness = 0) {
+     * @param bool $endianness
-        $data = array();
+     * @return int
-        $int = 0;
+     */
-        // Set the array to correct form
+    public static function bytes2signedInt($values, $endianness = 0) {
-        $data = self::checkData($values);
+        $data = array();
-        // Combine bytes
+        $int = 0;
-        $int = self::combineBytes($data, $endianness);
+        // Set the array to correct form
-        // In the case of signed 2 byte value convert it to 4 byte one
+        $data = self::checkData($values);
-        if ((count($values) == 2) && ((0x8000 & $int) > 0)) {
+        // Combine bytes
-            $int = 0xFFFF8000 | $int;
+        $int = self::combineBytes($data, $endianness);
-        }
+        // In the case of signed 2 byte value convert it to 4 byte one
-        // Convert the value
+        if ((count($values) == 2) && ((0x8000 & $int) > 0)) {
-        return (int) self::dword2signedInt($int);
+            $int = 0xFFFF8000 | $int;
-    }
+        }
-
+        // Convert the value
-    /**
+        return (int) self::dword2signedInt($int);
-     * bytes2unsignedInt
+    }
-     *
+
-     * The function converts array of 2 or 4 bytes to unsigned integer.
+    /**
-     * The return value depends on order of the input bytes (endianning).
+     * bytes2unsignedInt
-     *
+     *
-     * @param array $values
+     * The function converts array of 2 or 4 bytes to unsigned integer.
-     * @param bool $endianness
+     * The return value depends on order of the input bytes (endianning).
-     * @return int|float
+     *
-     */
+     * @param array $values
-    public static function bytes2unsignedInt($values, $endianness = 0) {
+     * @param bool $endianness
-        $data = array();
+     * @return int|float
-        $int = 0;
+     */
-        // Set the array to correct form
+    public static function bytes2unsignedInt($values, $endianness = 0) {
-        $data = self::checkData($values);
+        $data = array();
-        // Combine bytes
+        $int = 0;
-        $int = self::combineBytes($data, $endianness);
+        // Set the array to correct form
-        // Convert the value
+        $data = self::checkData($values);
-        return self::dword2unsignedInt($int);
+        // Combine bytes
-    }
+        $int = self::combineBytes($data, $endianness);
-
+        // Convert the value
-    /**
+        return self::dword2unsignedInt($int);
-     * bytes2string
+    }
-     *
+
-     * The function converts an values array to the string. The function detects
+    /**
-     * the end of the string by 0x00 character as defined by string standards.
+     * bytes2string
-     *
+     *
-     * @param array $values
+     * The function converts an values array to the string. The function detects
-     * @param bool $endianness
+     * the end of the string by 0x00 character as defined by string standards.
-     * @return string
+     *
-     */
+     * @param array $values
-    public static function bytes2string($values, $endianness = 0) {
+     * @param bool $endianness
-        // Prepare string variable
+     * @return string
-        $str = "";
+     */
-        // Parse the received data word array
+    public static function bytes2string($values, $endianness = 0) {
-        for($i=0;$i<count($values);$i+=2) {
+        // Prepare string variable
-            if ($endianness) {
+        $str = "";
-                if($values[$i] != 0)
+        // Parse the received data word array
-                    $str .= chr($values[$i]);
+        for($i=0;$i<count($values);$i+=2) {
-                else
+            if ($endianness) {
-                    break;
+                if($values[$i] != 0)
-                if($values[$i+1] != 0)
+                    $str .= chr($values[$i]);
-                    $str .= chr($values[$i+1]);
+                else
-                else
+                    break;
-                    break;
+                if($values[$i+1] != 0)
-            }
+                    $str .= chr($values[$i+1]);
-            else {
+                else
-                if($values[$i+1] != 0)
+                    break;
-                    $str .= chr($values[$i+1]);
+            }
-                else
+            else {
-                    break;
+                if($values[$i+1] != 0)
-                if($values[$i] != 0)
+                    $str .= chr($values[$i+1]);
-                    $str .= chr($values[$i]);
+                else
-                else
+                    break;
-                    break;
+                if($values[$i] != 0)
-            }
+                    $str .= chr($values[$i]);
-        }
+                else
-        // return string
+                    break;
-        return $str;
+            }
-    }
+        }
-
+        // return string
-    /**
+        return $str;
-     * real2float
+    }
-     *
+
-     * This function converts a value in IEC-1131 REAL single precision form to float.
+    /**
-     *
+     * real2float
-     * For more see [{@link http://en.wikipedia.org/wiki/Single_precision Single precision on Wiki}] or
+     *
-     * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes @ Georgia Tech 21-Nov-2007] or
+     * This function converts a value in IEC-1131 REAL single precision form to float.
-     * [{@link http://www.php.net/manual/en/function.pack.php PHP pack/unpack functionality}]
+     *
-     *
+     * For more see [{@link http://en.wikipedia.org/wiki/Single_precision Single precision on Wiki}] or
-     * @param value value in IEC REAL data type to be converted
+     * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes @ Georgia Tech 21-Nov-2007] or
-     * @return float float value
+     * [{@link http://www.php.net/manual/en/function.pack.php PHP pack/unpack functionality}]
-     */
+     *
-    private static function real2float($value) {
+     * @param value value in IEC REAL data type to be converted
-        // get unsigned long
+     * @return float float value
-        $ulong = pack("L", $value);
+     */
-        // set float
+    private static function real2float($value) {
-        $float = unpack("f", $ulong);
+        // get unsigned long
-        
+        $ulong = pack("L", $value);
-        return $float[1];
+        // set float
-    }
+        $float = unpack("f", $ulong);
-
+        
-    /**
+        return $float[1];
-     * dword2signedInt
+    }
-     *
+
-     * Switch double word to signed integer
+    /**
-     *
+     * dword2signedInt
-     * @param int $value
+     *
-     * @return int
+     * Switch double word to signed integer
-     */
+     *
-    private static function dword2signedInt($value) {
+     * @param int $value
-        if ((0x80000000 & $value) != 0) {
+     * @return int
-            return -(0x7FFFFFFF & ~$value)-1;
+     */
-        } else {
+    private static function dword2signedInt($value) {
-            return (0x7FFFFFFF & $value);
+        if ((0x80000000 & $value) != 0) {
-        }
+            return -(0x7FFFFFFF & ~$value)-1;
-    }
+        } else {
-
+            return (0x7FFFFFFF & $value);
-    /**
+        }
-     * dword2signedInt
+    }
-     *
+
-     * Switch double word to unsigned integer
+    /**
-     *
+     * dword2signedInt
-     * @param int $value
+     *
-     * @return int|float
+     * Switch double word to unsigned integer
-     */
+     *
-    private static function dword2unsignedInt($value) {
+     * @param int $value
-        if ((0x80000000 & $value) != 0) {
+     * @return int|float
-            return ((float) (0x7FFFFFFF & $value)) + 2147483648;
+     */
-        } else {
+    private static function dword2unsignedInt($value) {
-            return (int) (0x7FFFFFFF & $value);
+        if ((0x80000000 & $value) != 0) {
-        }
+            return ((float) (0x7FFFFFFF & $value)) + 2147483648;
-    }
+        } else {
-
+            return (int) (0x7FFFFFFF & $value);
-    /**
+        }
-     * checkData
+    }
-     *
+
-     * Check if the data variable is array, and check if the values are numeric
+    /**
-     *
+     * checkData
-     * @param int $data
+     *
-     * @return int
+     * Check if the data variable is array, and check if the values are numeric
-     */
+     *
-    private static function checkData($data) {
+     * @param int $data
-        // Check the data
+     * @return int
-        if (!is_array($data) ||
+     */
-                count($data)<2 ||
+    private static function checkData($data) {
-                count($data)>4 ||
+        // Check the data
-                count($data)==3) {
+        if (!is_array($data) ||
-            throw new Exception('The input data should be an array of 2 or 4 bytes.');
+                count($data)<2 ||
-        }
+                count($data)>4 ||
-        // Fill the rest of array by zeroes
+                count($data)==3) {
-        if (count($data) == 2) {
+            throw new Exception('The input data should be an array of 2 or 4 bytes.');
-            $data[2] = 0;
+        }
-            $data[3] = 0;
+        // Fill the rest of array by zeroes
-        }
+        if (count($data) == 2) {
-        // Check the values to be number
+            $data[2] = 0;
-        if (!is_numeric($data[0]) ||
+            $data[3] = 0;
-                !is_numeric($data[1]) ||
+        }
-                !is_numeric($data[2]) ||
+        // Check the values to be number
-                !is_numeric($data[3])) {
+        if (!is_numeric($data[0]) ||
-            throw new Exception('Data are not numeric or the array keys are not indexed by 0,1,2 and 3');
+                !is_numeric($data[1]) ||
-        }
+                !is_numeric($data[2]) ||
-
+                !is_numeric($data[3])) {
-        return $data;
+            throw new Exception('Data are not numeric or the array keys are not indexed by 0,1,2 and 3');
-    }
+        }
-
+
-    /**
+        return $data;
-     * combineBytes
+    }
-     *
+
-     * Combine bytes together
+    /**
-     *
+     * combineBytes
-     * @param int $data
+     *
-     * @param bool $endianness
+     * Combine bytes together
-     * @return int
+     *
-     */
+     * @param int $data
-    private static function combineBytes($data, $endianness) {
+     * @param bool $endianness
-        $value = 0;
+     * @return int
-        // Combine bytes
+     */
-        if ($endianness == 0)
+    private static function combineBytes($data, $endianness) {
-            $value = (($data[3] & 0xFF)<<16) |
+        $value = 0;
-                    (($data[2] & 0xFF)<<24) |
+        // Combine bytes
-                    (($data[1] & 0xFF)) |
+        if ($endianness == 0)
-                    (($data[0] & 0xFF)<<8);
+            $value = (($data[3] & 0xFF)<<16) |
-        else
+                    (($data[2] & 0xFF)<<24) |
-            $value = (($data[3] & 0xFF)<<24) |
+                    (($data[1] & 0xFF)) |
-                    (($data[2] & 0xFF)<<16) |
+                    (($data[0] & 0xFF)<<8);
-                    (($data[1] & 0xFF)<<8) |
+        else
-                    (($data[0] & 0xFF));
+            $value = (($data[3] & 0xFF)<<24) |
-
+                    (($data[2] & 0xFF)<<16) |
-        return $value;
+                    (($data[1] & 0xFF)<<8) |
-    }
+                    (($data[0] & 0xFF));
-}
+
+        return $value;
+    }
+}
 ?>

tests/Codesys/test.SYM

@@ -1,4 +0,0 @@
-;Version=2
-;ProjectId=114942
-;Checksum=0
-;Filesize=0

tests/IecType/output/test.iecByte.php.html

@@ -1 +0,0 @@
-125<br>98<br>0<br>0<br>0<br>0<br>0<br>0<br>0<br>0<br>0<br>0<br>255<br>255<br>255<br>255<br>158<br>88<br>97<br>168<br>

tests/IecType/output/test.iecDInt.php.html

@@ -1 +0,0 @@
-Endianing off <hr>0 --> Packet: 0000_0000_</br>1 --> Packet: 0001_0000_</br>-1 --> Packet: ffff_ffff_</br>2147483647 --> Packet: ffff_7fff_</br>-2147483648 --> Packet: 0000_8000_</br>Endianing on <hr>0 --> Packet: 0000_0000_</br>1 --> Packet: 0000_0001_</br>-1 --> Packet: ffff_ffff_</br>2147483647 --> Packet: 7fff_ffff_</br>-2147483648 --> Packet: 8000_0000_</br>

tests/IecType/output/test.iecInt.php.html

@@ -1 +0,0 @@
-Endianing off <hr>0 --> Packet: 0000_</br>1 --> Packet: 0001_</br>-1 --> Packet: ffff_</br>32767 --> Packet: 7fff_</br>-32768 --> Packet: 8000_</br>Endianing on <hr>0 --> Packet: 0000_</br>1 --> Packet: 0001_</br>-1 --> Packet: ffff_</br>32767 --> Packet: 7fff_</br>-32768 --> Packet: 8000_</br>

tests/IecType/output/test.iecReal.php.html

@@ -1,12 +0,0 @@
-Endianing off <hr>
-0 --> Packet: 0000_0000_<br>
-1 --> Packet: 0000_3f80_<br>
--2 --> Packet: 0000_c000_<br>
-0.333333333333 --> Packet: aaab_3eaa_<br>
-25 --> Packet: 0000_41c8_<br>
-Endianing on <hr>
-0 --> Packet: 0000_0000_<br>
-1 --> Packet: 3f80_0000_<br>
--2 --> Packet: c000_0000_<br>
-0.333333333333 --> Packet: 3eaa_aaab_<br>
-25 --> Packet: 41c8_0000_<br>

tests/ModbusMaster/output/test.tcp.fc16fc3.php.html

@@ -1,72 +0,0 @@
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 255
-    [8] => 0
-    [9] => 255
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 255
-    [5] => 255
-    [6] => 127
-    [7] => 255
-    [8] => 128
-    [9] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 0
-    [8] => 255
-    [9] => 255
-    [10] => 255
-    [11] => 255
-    [12] => 255
-    [13] => 255
-    [14] => 127
-    [15] => 255
-    [16] => 0
-    [17] => 0
-    [18] => 128
-    [19] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 0
-    [6] => 63
-    [7] => 128
-    [8] => 0
-    [9] => 0
-    [10] => 192
-    [11] => 0
-    [12] => 170
-    [13] => 171
-    [14] => 62
-    [15] => 170
-    [16] => 0
-    [17] => 0
-    [18] => 65
-    [19] => 200
-)

tests/ModbusMaster/output/test.tcp.fc26.php.html

@@ -1 +0,0 @@
-writeMultipleRegister (FC26): DONE

tests/ModbusMaster/output/test.tcp.socket_protocol_mismatch.php.html

@@ -1 +0,0 @@
-Caught exception: Unknown socket protocol, should be 'TCP' or 'UDP'

tests/ModbusMaster/output/test.udp.fc16fc3.php.html

@@ -1,72 +0,0 @@
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 255
-    [8] => 0
-    [9] => 255
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 255
-    [5] => 255
-    [6] => 127
-    [7] => 255
-    [8] => 128
-    [9] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 0
-    [8] => 255
-    [9] => 255
-    [10] => 255
-    [11] => 255
-    [12] => 255
-    [13] => 255
-    [14] => 127
-    [15] => 255
-    [16] => 0
-    [17] => 0
-    [18] => 128
-    [19] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 0
-    [6] => 63
-    [7] => 128
-    [8] => 0
-    [9] => 0
-    [10] => 192
-    [11] => 0
-    [12] => 170
-    [13] => 171
-    [14] => 62
-    [15] => 170
-    [16] => 0
-    [17] => 0
-    [18] => 65
-    [19] => 200
-)

tests/ModbusMaster/output/test.udp.fc26.php.html

@@ -1 +0,0 @@
-writeMultipleRegister (FC26): DONE

tests/ModbusMasterTcp/output/test.fc16fc3.php.html

@@ -1,72 +0,0 @@
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 255
-    [8] => 0
-    [9] => 255
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 255
-    [5] => 255
-    [6] => 127
-    [7] => 255
-    [8] => 128
-    [9] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 0
-    [8] => 255
-    [9] => 255
-    [10] => 255
-    [11] => 255
-    [12] => 255
-    [13] => 255
-    [14] => 127
-    [15] => 255
-    [16] => 0
-    [17] => 0
-    [18] => 128
-    [19] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 0
-    [6] => 63
-    [7] => 128
-    [8] => 0
-    [9] => 0
-    [10] => 192
-    [11] => 0
-    [12] => 170
-    [13] => 171
-    [14] => 62
-    [15] => 170
-    [16] => 0
-    [17] => 0
-    [18] => 65
-    [19] => 200
-)

tests/ModbusMasterTcp/output/test.fc26.php.html

@@ -1 +0,0 @@
-writeMultipleRegister (FC26): DONE

tests/ModbusMasterUdp/output/test.fc15fc1.php.html

@@ -1,66 +0,0 @@
-array(32) {
-  [0]=>
-  bool(true)
-  [1]=>
-  bool(false)
-  [2]=>
-  bool(true)
-  [3]=>
-  bool(true)
-  [4]=>
-  bool(false)
-  [5]=>
-  bool(true)
-  [6]=>
-  bool(true)
-  [7]=>
-  bool(true)
-  [8]=>
-  bool(true)
-  [9]=>
-  bool(true)
-  [10]=>
-  bool(true)
-  [11]=>
-  bool(true)
-  [12]=>
-  bool(false)
-  [13]=>
-  bool(false)
-  [14]=>
-  bool(false)
-  [15]=>
-  bool(false)
-  [16]=>
-  bool(false)
-  [17]=>
-  bool(false)
-  [18]=>
-  bool(false)
-  [19]=>
-  bool(false)
-  [20]=>
-  bool(true)
-  [21]=>
-  bool(true)
-  [22]=>
-  bool(true)
-  [23]=>
-  bool(true)
-  [24]=>
-  bool(true)
-  [25]=>
-  bool(true)
-  [26]=>
-  bool(true)
-  [27]=>
-  bool(true)
-  [28]=>
-  bool(true)
-  [29]=>
-  bool(true)
-  [30]=>
-  bool(true)
-  [31]=>
-  bool(true)
-}

tests/ModbusMasterUdp/output/test.fc16fc3.php.html

@@ -1,72 +0,0 @@
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 255
-    [8] => 0
-    [9] => 255
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 255
-    [5] => 255
-    [6] => 127
-    [7] => 255
-    [8] => 128
-    [9] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 0
-    [8] => 255
-    [9] => 255
-    [10] => 255
-    [11] => 255
-    [12] => 255
-    [13] => 255
-    [14] => 127
-    [15] => 255
-    [16] => 0
-    [17] => 0
-    [18] => 128
-    [19] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 0
-    [6] => 63
-    [7] => 128
-    [8] => 0
-    [9] => 0
-    [10] => 192
-    [11] => 0
-    [12] => 170
-    [13] => 171
-    [14] => 62
-    [15] => 170
-    [16] => 0
-    [17] => 0
-    [18] => 65
-    [19] => 200
-)

tests/ModbusMasterUdp/output/test.fc16fc3bind.php.html

@@ -1,72 +0,0 @@
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 255
-    [8] => 0
-    [9] => 255
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 1
-    [4] => 255
-    [5] => 255
-    [6] => 127
-    [7] => 255
-    [8] => 128
-    [9] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 1
-    [6] => 0
-    [7] => 0
-    [8] => 255
-    [9] => 255
-    [10] => 255
-    [11] => 255
-    [12] => 255
-    [13] => 255
-    [14] => 127
-    [15] => 255
-    [16] => 0
-    [17] => 0
-    [18] => 128
-    [19] => 0
-)
-Array
-(
-    [0] => 0
-    [1] => 0
-    [2] => 0
-    [3] => 0
-    [4] => 0
-    [5] => 0
-    [6] => 63
-    [7] => 128
-    [8] => 0
-    [9] => 0
-    [10] => 192
-    [11] => 0
-    [12] => 170
-    [13] => 171
-    [14] => 62
-    [15] => 170
-    [16] => 0
-    [17] => 0
-    [18] => 65
-    [19] => 200
-)

tests/ModbusMasterUdp/output/test.fc26.php.html

@@ -1 +0,0 @@
-writeMultipleRegister (FC26): DONE

tests/ModbusMasterUdp/output/test.fc26bind.php.html

@@ -1 +0,0 @@
-writeMultipleRegister (FC26): DONE

tests/ModbusMasterUdp/output/test.fc6fc3.php.html

@@ -1,5 +0,0 @@
-Array
-(
-    [0] => 207
-    [1] => 199
-)

tests/ModbusMasterUdp/ref/test.fc4.php.html

@@ -1,7 +1,11 @@
 Test should pass when %IX0.0==FALSE and %IX0.1==TRUE
-array(2) {
+array(4) {
   [0]=>
-  bool(false)
+  int(0)
   [1]=>
-  bool(true)
+  int(2)
+  [2]=>
+  int(0)
+  [3]=>
+  int(0)
 }

tests/ModbusMasterUdp/ref/test.fc5.php.html

@@ -0,0 +1,5 @@
+Array
+(
+    [0] => 0
+    [1] => 5
+)

tests/ModbusMasterUdp/test.fc4.php

@@ -0,0 +1,14 @@
+<?php
+require_once dirname(__FILE__) . '/../../Phpmodbus/ModbusMasterUdp.php';
+require_once dirname(__FILE__) . '/../config.php';
+
+// Create Modbus object
+$modbus = new ModbusMasterUdp($test_host_ip);
+
+// Test requirements
+echo "Test should pass when %IX0.0==FALSE and %IX0.1==TRUE\n";
+
+// Read input discretes - FC 4
+$recData = $modbus->readMultipleInputRegisters(0, 0, 2);
+
+var_dump($recData);

tests/ModbusMasterUdp/test.fc5.php

@@ -0,0 +1,23 @@
+<?php
+require_once dirname(__FILE__) . '/../../Phpmodbus/ModbusMasterUdp.php';
+require_once dirname(__FILE__) . '/../config.php';
+
+// Create Modbus object
+$modbus = new ModbusMasterUdp($test_host_ip);
+
+// Data to be writen - TRUE, FALSE
+$data_true = array(TRUE);
+$data_false = array(FALSE);
+
+// Reset target WORD
+$modbus->writeSingleRegister(0, 12288, array(0), array('WORD'));
+
+// Write single coil - FC5
+$modbus->writeSingleCoil(0, 12288, $data_true);
+$modbus->writeSingleCoil(0, 12289, $data_false);
+$modbus->writeSingleCoil(0, 12290, $data_true);
+$modbus->writeSingleCoil(0, 12291, $data_false);
+
+// Read data - FC3
+$recData = $modbus->readMultipleRegisters(0, 12288, 1);
+print_r($recData);

tests/PhpType/output/test.bytes2mixed.php.html

@@ -1 +0,0 @@
-32098<br>0<br>0<br>-1<br>-25000<br>25000<br>

tests/PhpType/output/test.bytes2real.php.html

@@ -1 +0,0 @@
-1000<br>2000<br>1.25<br>

tests/PhpType/output/test.bytes2signedint.php.html

@@ -1 +0,0 @@
--1<br>0<br>1<br>-2147483648<br>2147483647<br> 

tests/PhpType/output/test.bytes2string.php.html

@@ -1 +0,0 @@
-eHll oowlr!da<br>Hello world!<br>

tests/PhpType/output/test.bytes2unsignedint.php.html

@@ -1,6 +0,0 @@
-float(4294967295)
-<br>int(0)
-<br>int(1)
-<br>float(2147483648)
-<br>int(2147483647)
-<br> 

tests/PhpType/output/test.strangearray.size.php.html

@@ -1 +0,0 @@
-Exception 'Data are not in array 2 or 4 bytes'<br>25602<br>Exception 'Data are not in array 2 or 4 bytes'<br>25602<br>Exception 'Data are not in array 2 or 4 bytes'<br>

tests/PhpType/output/test.strangearray.textarray.php.html

@@ -1 +0,0 @@
-Exception 'Data are not numeric'

tests/README.md

@@ -0,0 +1,3 @@
+Probably broken and dubious.
+
+Left from the original repo.

tests/config.php

@@ -1,3 +1,3 @@
 <?php
-  $test_host_ip = "192.168.1.105";  
+  $test_host_ip = "192.192.1.10";  
-  $test_bind_client_ip = "192.168.1.106";
+  $test_bind_client_ip = "192.192.1.100";

tutorials/Phpmodbus/Phpmodbus.pkg

@@ -1,190 +0,0 @@
-<refentry id="{@id}">
- <refnamediv>
-  <refname>Phpmodbus user's guide</refname>
-  <refpurpose>Phpmodbus How-to</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
-  <author>
-   Jan Krakora
-   <authorblurb>
-    {@link mailto:krakora.jan@googlemail.com email}
-   </authorblurb>
-  </author>
- </refsynopsisdiv>
- {@toc}
- <refsect1 id="{@id intro}">
-  <title>Introduction</title>
-  <para>
-   Phpmodbus is a PHP library for the Modbus protocol. The library implements
-   Modbus TCP/UDP master class with subset of the most used Modbus commands.
-  </para>
-  <para>
-   The library implements:
-   <itemizedlist>
-     <listitem><para>FC  1: read multiple coils</para></listitem>
-     <listitem><para>FC  2: read input discretes</para></listitem>
-     <listitem><para>FC  3: read multiple registers</para></listitem>
-     <listitem><para>FC  6: write single register</para></listitem>
-     <listitem><para>FC 15: write multiple coils</para></listitem>
-     <listitem><para>FC 16: write multiple registers</para></listitem>
-     <listitem><para>FC 23: read write registers</para></listitem>
-    </itemizedlist>
-  </para>
-  <para>
-   For more about Modbus protocol see [{@link http://www.modbus.org}] or
-   [{@link http://en.wikipedia.org/wiki/Modbus Wiki}]
-  </para>
- </refsect1>
- <refsect1 id="{@id install}">
-  <title>Install</title>
-  <para>
-   At the first, it is supposed an PHP solution has been already installed on
-   your server (LAMP, WAMP, MSS+CGI etc.).
-  </para>
-  <para>
-   Copy the Phpmodbus library to your PHP project folder.
-  </para>
-  <para>
-   Create a PHP script and assign the library using require_once() command
-     <programlisting role="c">
-      <![CDATA[require_once dirname(__FILE__) . '/Phpmodbus/ModbusMaster.php'; ]]>
-     </programlisting>     
-  </para>
-  <para>
-    To create UDP Modbus master object communicating to an modbus slave 
-    e.g. at IP address 192.168.1.1 write
-    <programlisting role="c" linenumbering="numbered" startinglinenumber="2">
-      <![CDATA[ $modbus = new ModbusMaster("192.168.1.1", "UDP"); ]]>
-    </programlisting>
-  </para>
-  <para>
-    To create TCP Modbus master use
-    <programlisting role="c" linenumbering="numbered" startinglinenumber="2">
-      <![CDATA[ $modbus = new ModbusMaster("192.168.1.1", "TCP"); ]]>
-    </programlisting>
-  </para>
-  <para>
-    To read 5 words (10 bytes) from the device ID=0 and its memory address 12288
-    use try-catch method call
-    <programlisting role="c" linenumbering="numbered" startinglinenumber="3">
-      <![CDATA[try {
-    // Function processing
-    $recData = $modbus->readMultipleRegisters(0, 12288, 5); 
-}
-catch (Exception $e) {
-    // Exception processing, e.g. print error information
-    echo $modbus;
-    echo $e;
-    exit; 
-}]]>
-     </programlisting>
-  </para>
-  <para>
-    To process the function byte stream, use conversion to PHP types in 
-  </para>
-  <programlisting role="c" linenumbering="numbered" startinglinenumber="15">
-      <![CDATA[echo PhpType::bytes2string($recData); ]]>
-     </programlisting>
-  <para>
-  For other examples see sections bellow.
-  </para>
- </refsect1>  
- <refsect1 id="{@id examples}">
-  <title>Examples</title>
-  <para>
-    This section presents library features and examples
-  </para>
-    <refsect2 id="{@id example_fc1}">
-    <title>FC1 - read mutliple coils</title>
-    <para>
-      FC1 functionality example
-    </para>
-    <para>
-    {@example example_fc1.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id example_fc2}">
-    <title>FC2 - read input discretes</title>
-    <para>
-      FC2 functionality example
-    </para>
-    <para>
-    {@example example_fc2.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id example_fc3}">
-    <title>FC3 - read mutliple registers</title>
-    <para>
-      FC3 functionality example
-    </para>
-    <para>
-    {@example example_fc3.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id example_fc6}">
-    <title>FC6 - write single register</title>
-    <para>
-      FC6 functionality example
-    </para>
-    <para>
-    {@example example_fc6.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id example_fc15}">
-    <title>FC15 - write mutliple coils</title>
-    <para>
-      FC15 functionality example
-    </para>
-    <para>
-    {@example example_fc15.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id example_fc16}">
-    <title>FC16 - write mutliple registers</title>
-    <para>
-      FC16 functionality example
-    </para>
-    <para>
-    {@example example_fc16.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id example_fc23}">
-    <title>FC23 - read write registers</title>
-    <para>
-      FC23 functionality example
-    </para>
-    <para>
-    {@example example_fc23.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id wago_example}">
-    <title>Dump of M-memory from WAGO 750-84x series coupler.</title>
-    <para>
-      Dump of M-memory from WAGO 750-84x series coupler.
-    </para>
-    <para>
-    {@example example_750841_Mmemory.php}
-    </para>
-  </refsect2>
-  <refsect2 id="{@id datatype}">
-    <title>Data conversion to PHP types.</title>
-    <para>
-      Conversion of the data bytes, received from Modbus, to a PHP type.
-    </para>
-    <para>
-    {@example example_datatype.php}
-    </para>
-  </refsect2>
- </refsect1> 
- <refsect1 id="{@id back_comp}">
-  <title>Back compatibility</title>
-  <para>
-   This version is back compatible to the last versions. Just use  
-   <programlisting role="c">
-      <![CDATA[require_once dirname(__FILE__) . '/Phpmodbus/ModbusMasterUdp.php';
-$modbus = new ModbusMasterUdp("192.168.1.1"); 
-// ... ]]>
-     </programlisting>
-  </para>
- </refsect1>
-</refentry>