@teamcymbeline/node-red-contrib-mcprotocol 0.0.0-stage → 1.4.1

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+node-red-contrib-mcprotocol
+===========================
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## About
+
+### Overview
+This is a Node-RED node module to directly interface with MITSUBISHI PLCs over Ethernet using MC Protocol. 
+
+### Features
+- Both TCP and UDP connections are possible
+- frames 1E, 3E and 4E are possible
+- works for PLC types
+  - A *(See Note 1)*
+  - QnA
+  - Q
+  - L
+  - R
+- ASCII and BINARY mode *(See Note 2)*
+
+### Recommendation
+If your PLC suports UDP + 4E, this is by far most reliable. 
+
+### NOTES
+1. For A series PLC, only 1E frames are supported
+2. ASCII mode is currently not supported for frames 3E and 4E
+---
+## Install
+
+### Prerequisites
+
+* node.js	(runtime for Node-RED)
+* Node-RED
+* [optional] git (Used for repository cloning/downloads)
+
+### Easy install
+
+Use the Manage Palette > Install option from the menu inside node-red
+
+
+### NPM install
+```sh
+cd ~/.node-red
+npm install node-red-contrib-mcprotocol
+```
+
+### GIT install Direct
+```sh
+cd ~/.node-red
+npm install Steve-Mcl/node-red-contrib-mcprotocol
+```
+
+### GIT Install
+Make a directory for the base files on the disk (somewhere secure) and open the created folder and open PowerShell (SHIFT + right_click) or "Git Bash Here" with right mouse inside the folder. Now enter the following:
+```sh
+cd c:/tempsourcefolder
+git clone https://github.com/Steve-Mcl/node-red-contrib-mcprotocol.git
+
+cd ~/.node-red
+npm install c:/tempsourcefolder/node-red-contrib-mcprotocol
+```
+
+---
+
+### Credits
+* [plcpeople](https://github.com/plcpeople/mcprotocol) for the original implementation of mcprotocol

package/connection_pool.js

@@ -0,0 +1,161 @@
+/*
+MIT License
+
+Copyright (c) 2019, 2020 Steve-Mcl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 
+*/
+
+var pool = {};
+
+module.exports = {
+  get: function(port, host, opts) {
+    var mcprotocol = require("./mcprotocol/mcprotocol.js");
+    var id = `mcprotocol: {host:'${host || ""}', port: ${port || "''"}}`;
+    //var id = `mcprotocol: {host:'${(host || "")}', port: ${(port || "''")}, frame:'${frame}', plcType:'${plcType}}`;
+    var node = this;
+
+    if (!pool[id]) {
+      pool[id] = (function() {
+        var options = opts || {};
+        options.host = host;
+        options.port = port;
+        options.protocol = options.protocol || "TCP";
+        options.ascii = options.ascii || false;
+        options.frame = options.frame || "3E";
+        options.plcType = options.plcType || "Q";
+        options.autoConnect =
+          options.autoConnect == "undefined" ? true : options.autoConnect;
+        options.preventAutoReconnect = false;
+        options.logLevel = options.logLevel || "WARN";
+        node.debug(`[mcprotocol] adding new connection to pool ~ ${id}`);
+
+        var mcp = new mcprotocol();
+
+        mcp.setDebugLevel(options.logLevel);
+        mcp.initiateConnection(options);
+        var connecting = false;
+        var obj = {
+          getMCP: function mcp() {
+            return mcp;
+          },
+          getAutoConnect: function() {
+            return options.autoConnect == true;
+          },
+          setAutoConnect: function(b) {
+            options.autoConnect = b == true;
+          },
+          _instances: 0,
+          write: function(addr, data, callback) {
+            if (!mcp.isConnected()) {
+              //this.connect();
+              throw new Error("Not connected!");
+            }
+            var reply = mcp.writeItems(addr, data, callback);
+            return reply;
+          },
+          read: function(addr, callback) {
+            if (!mcp.isConnected()) {
+              //this.connect();
+              throw new Error("Not connected!");
+            }
+            var reply = mcp.readItems(addr, callback);
+            return reply;
+          },
+          closeConnection: function() {
+            mcp.connectionReset();
+            options.preventAutoReconnect = true;
+          },
+          on: function(a, b) {
+            mcp.on(a, b);
+          },
+          connect: function() {
+            options.preventAutoReconnect = false;
+            if (mcp && !mcp.isConnected() && !connecting) {
+              connecting = true;
+              mcp.initiateConnection(options);
+            }
+          },
+          disconnect: function() {
+            this._instances -= 1;
+            if (this._instances <= 0) {
+              node.debug(`[mcprotocol] closing connection ~ ${id}`);
+              mcp.dropConnection();
+              mcp = null;
+              node.debug(`[mcprotocol] deleting connection from pool ~ ${id}`);
+              delete pool[id];
+            }
+          },
+          reinitialize: function() {
+            //in case of physical connection loss, it does not get the connection back
+            //when connecting again. the mcp object needs to be renewed. 
+            this.disconnect();
+            if (!mcp) {
+              mcp = new mcprotocol();
+              connecting = false;
+            }
+            this.connect();
+            this._instances += 1;
+          },
+        };
+
+        mcp.on("error", function(e) {
+          if (mcp) {
+            node.error(`[mcprotocol] error ~ ${id}: ${e}`);
+            connecting = false;
+            if (options.autoConnect) {
+              setTimeout(function() {
+                if (options.autoConnect && !options.preventAutoReconnect) {
+                  node.error(
+                    `[mcprotocol] autoConnect call from  error handler ~ ${id}`
+                  );
+                  obj.connect();
+                }
+              }, 1000); //parametrise
+            }
+          }
+        });
+        mcp.on("open", function() {
+          if (mcp) {
+            node.debug(`[mcprotocol] connected ~ ${id}`);
+            connecting = false;
+          }
+        });
+        mcp.on("close", function(err) {
+          node.debug(`[mcprotocol] connection closed ~ ${id}`);
+          connecting = false;
+          if (options.autoConnect) {
+            setTimeout(function() {
+              if (options.autoConnect && !options.preventAutoReconnect) {
+                node.debug(
+                  `[mcprotocol] autoConnect call from close handler ~ ${id}`
+                );
+                obj.connect();
+              }
+            }, 1000); //parametrise
+          }
+        });
+
+        return obj;
+      })();
+    }
+    pool[id]._instances += 1;
+    return pool[id];
+  }
+};

package/examples/demo.json

@@ -0,0 +1 @@
+[{"id":"4fabbfaa.503e6","type":"MC Read","z":"766a1068.58afb","name":"","topic":"","connection":"8a67d1bd.c84ff","address":"topic","addressType":"msg","outputFormat":0,"errorHandling":"throw","outputs":1,"x":540,"y":200,"wires":[["909f6d71.d3977"]]},{"id":"9d18a8b9.d51988","type":"udp in","z":"766a1068.58afb","name":"","iface":"","port":"5002","ipv":"udp4","multicast":"false","group":"","datatype":"buffer","x":180,"y":360,"wires":[["a906dcf7.c23e5","14abe69.0aacc19"]]},{"id":"a906dcf7.c23e5","type":"debug","z":"766a1068.58afb","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":350,"y":360,"wires":[]},{"id":"609554a9.b5e02c","type":"inject","z":"766a1068.58afb","name":"","props":[{"p":"topic","vt":"str"},{"p":"count","v":"50","vt":"num"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"DINT0,50","x":200,"y":140,"wires":[["b920e789.6f8f98"]]},{"id":"1c92fdaa.e58f42","type":"inject","z":"766a1068.58afb","name":"connect","props":[{"p":"connect","v":"true","vt":"bool"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"connect","x":370,"y":60,"wires":[["894f189d.2280f8"]]},{"id":"29dda2ac.8a8dae","type":"inject","z":"766a1068.58afb","name":"disconnect","props":[{"p":"disconnect","v":"true","vt":"bool"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"disconnect","x":380,"y":100,"wires":[["894f189d.2280f8"]]},{"id":"14abe69.0aacc19","type":"switch","z":"766a1068.58afb","name":"3E / 4E","property":"payload[0]","propertyType":"msg","rules":[{"t":"eq","v":"0x50","vt":"num"},{"t":"eq","v":"0x54","vt":"num"}],"checkall":"true","repair":false,"outputs":2,"x":200,"y":420,"wires":[["1762bb1b.795375"],["b31e7337.5fd9"]]},{"id":"b31e7337.5fd9","type":"buffer-parser","z":"766a1068.58afb","name":"","data":"payload","dataType":"msg","specification":"spec","specificationType":"ui","items":[{"type":"uint16le","name":"header","offset":0,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"sid","offset":2,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"acess_route=>network","offset":6,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"acess_route=>pc_no","offset":7,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"acess_route=>destination_module_station_No","offset":8,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>command","offset":15,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>sub_command","offset":17,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>device_no","offset":19,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"request_data=>device_code","offset":22,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>device_count","offset":23,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"buffer","name":"buf","offset":0,"length":-1,"offsetbit":0,"scale":"1","mask":""}],"swap1":"","swap2":"","swap3":"","swap1Type":"swap","swap2Type":"swap","swap3Type":"swap","msgProperty":"payload","msgPropertyType":"str","resultType":"keyvalue","resultTypeType":"output","multipleResult":false,"fanOutMultipleResult":false,"setTopic":true,"outputs":1,"x":370,"y":440,"wires":[["a2f00c21.a640e","9f013c7f.8bfa7"]]},{"id":"a2f00c21.a640e","type":"debug","z":"766a1068.58afb","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":390,"y":480,"wires":[]},{"id":"9f013c7f.8bfa7","type":"switch","z":"766a1068.58afb","name":"Read? Write","property":"payload.request_data.command","propertyType":"msg","rules":[{"t":"eq","v":"0x0401","vt":"num"},{"t":"eq","v":"0x1401","vt":"num"}],"checkall":"true","repair":false,"outputs":2,"x":570,"y":400,"wires":[["dd7886d0.f142f8"],["74cfa55d.b1adfc"]]},{"id":"909f6d71.d3977","type":"debug","z":"766a1068.58afb","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":670,"y":200,"wires":[]},{"id":"dd7886d0.f142f8","type":"function","z":"766a1068.58afb","name":"Build read reply","func":"//debugger\nvar registers =\t{\n        D: {symbol: 'D', type: 'WORD', notation: 'Decimal', binary: 0xA8, ascii: 'D*', description: 'Data register'},\n\t    W: {symbol: 'W', type: 'WORD', notation: 'Hexadecimal', binary: 0xB4, ascii: 'W*', description: 'Link register'},\n\t    Z: {symbol: 'Z', type: 'WORD', notation: 'Decimal', binary: 0xCC, ascii: 'Z*', description: 'Index register'},\n\t    R: {symbol: 'R', type: 'WORD', notation: 'Decimal', binary: 0xAF, ascii: 'R*', description: 'File register'},\n    }\nvar regLookup = {\n    0xA8: registers.D,\n    0xB4: registers.W,\n    0xCC: registers.Z,\n    0xAF: registers.R,\n}\nvar frame = msg.payload.header == 0x54 ? \"4E\" : (msg.payload.header == 0x50 ? \"3E\" : \"??\");\n\nvar reg = regLookup[msg.payload.request_data.device_code];\nif (!reg) { \n    node.error(`device code ${msg.payload.request_data.device_code} not supported`, msg);\n    //todo: return error to MC Read node\n    return null;//temp\n}\n\n//build read reply\nvar buf = Buffer.alloc(8192);\nvar pos = 0;\n\nvar plcmem = flow.get(\"plcmem\");\nif(!plcmem) {\n    plcmem = { \"D\": [], \"R\": [], \"W\": [] };\n    flow.set(\"plcmem\", plcmem);\n}\nvar data = plcmem[reg.symbol] || [];\nvar dataStart = 11; //3E\nif (frame == '4E') {\n    dataStart = 15;\n    pos = buf.writeUInt16LE(0x00D4, pos);//0 expectedResponse\n    pos = buf.writeUInt16LE(msg.payload.sid, pos);//2 sid\n    pos = buf.writeUInt16LE(0, pos);//4 fixed 0\n} else {\n    pos = buf.writeUInt16LE(0x00D0, pos);//0 expectedResponse\n}\npos = buf.writeUInt8(msg.payload.acess_route.network, pos);//6 accessRouteNetworkNo\npos = buf.writeUInt8(msg.payload.acess_route.pc_no, pos);//7 accessPCNo\npos = buf.writeUInt16LE(msg.payload.acess_route.destination_module_station_No, pos);//8 accessRouteModuleIONo\npos = buf.writeUInt8(0, pos);//10 accessRouteModuleStationNo\npos = buf.writeUInt16LE((msg.payload.request_data.device_count*2)+2, pos);//11 UInt16LE length\npos = buf.writeUInt16LE(0, pos);//12 UInt16LE endCode\npos = dataStart;// - data start\n// debugger\nfor (let index = 0; index < msg.payload.request_data.device_count; index++) {\n    const element = data[msg.payload.request_data.device_no + index] || 0;\n    pos = buf.writeUInt16LE(element, pos);\n}\nmsg.origPayload = msg.payload;\nmsg.payload = buf.slice(0, pos);\n\nreturn msg;","outputs":1,"noerr":0,"initialize":"","finalize":"","x":780,"y":380,"wires":[["5b3f3ef1.041e8"]]},{"id":"5b3f3ef1.041e8","type":"udp out","z":"766a1068.58afb","name":"","addr":"","iface":"","port":"","ipv":"udp4","outport":"","base64":false,"multicast":"false","x":1030,"y":380,"wires":[]},{"id":"f8a9b16f.529d7","type":"function","z":"766a1068.58afb","name":"Build write reply","func":"//debugger\nvar registers =\t{\n        D: {symbol: 'D', type: 'WORD', notation: 'Decimal', binary: 0xA8, ascii: 'D*', description: 'Data register'},\n\t    W: {symbol: 'W', type: 'WORD', notation: 'Hexadecimal', binary: 0xB4, ascii: 'W*', description: 'Link register'},\n\t    Z: {symbol: 'Z', type: 'WORD', notation: 'Decimal', binary: 0xCC, ascii: 'Z*', description: 'Index register'},\n\t    R: {symbol: 'R', type: 'WORD', notation: 'Decimal', binary: 0xAF, ascii: 'R*', description: 'File register'},\n    }\nvar regLookup = {\n    0xA8: registers.D,\n    0xB4: registers.W,\n    0xCC: registers.Z,\n    0xAF: registers.R,\n}\nvar frame = msg.payload.header == 0x54 ? \"4E\" : (msg.payload.header == 0x50 ? \"3E\" : \"??\");\n\nvar reg = regLookup[msg.payload.request_data.device_code];\nif (!reg) { \n    node.error(`device code ${msg.payload.request_data.device_code} not supported`, msg);\n    //todo: return error to MC Read node\n    return null;//temp\n}\n\n//build read reply\nvar buf = Buffer.alloc(8192);\nvar pos = 0;\n\nvar plcmem = flow.get(\"plcmem\") || {};\nvar data = plcmem[reg.symbol] || [];\n// debugger\nvar writeData = msg.payload.data.values;\nvar writeIndex = msg.payload.request_data.device_no;\nfor (let index = 0; index < msg.payload.request_data.device_count; index++) {\n    data[writeIndex++] = writeData[index];\n}\n\nvar dataStart = 11; //3E\nif (frame == '4E') {\n    dataStart = 15;\n    pos = buf.writeUInt16LE(0x00D4, pos);//0 expectedResponse\n    pos = buf.writeUInt16LE(msg.payload.sid, pos);//2 sid seqNum\n    pos = buf.writeUInt16LE(0, pos);//4 fixed 0 dummy\n} else {\n    pos = buf.writeUInt16LE(0x00D0, pos);//0 expectedResponse\n}\npos = buf.writeUInt8(msg.payload.acess_route.network, pos);//6 accessRouteNetworkNo\npos = buf.writeUInt8(msg.payload.acess_route.pc_no, pos);//7 accessPCNo\npos = buf.writeUInt16LE(0, pos);//8 accessRouteModuleIONo\npos = buf.writeUInt8(0, pos);//10 accessRouteModuleStationNo\npos = buf.writeUInt16LE(2, pos);//11 UInt16LE length\npos = buf.writeUInt16LE(0, pos);//13 UInt16LE endCode\npos = buf.writeUInt16LE(0, pos);//15 UInt16LE endDetail\n\nmsg.origPayload = msg.payload;\nmsg.payload = buf.slice(0, pos);\n\nreturn msg;\n\n","outputs":1,"noerr":0,"initialize":"","finalize":"","x":1000,"y":460,"wires":[["5b3f3ef1.041e8"]]},{"id":"161497d7.583468","type":"buffer-parser","z":"766a1068.58afb","name":"get write data (3E)","data":"payload.buf","dataType":"msg","specification":"spec","specificationType":"ui","items":[{"type":"uint16le","name":"values","offset":21,"length":-1,"offsetbit":0,"scale":"1","mask":""}],"swap1":"","swap2":"","swap3":"","swap1Type":"swap","swap2Type":"swap","swap3Type":"swap","msgProperty":"payload.data","msgPropertyType":"str","resultType":"keyvalue","resultTypeType":"output","multipleResult":false,"fanOutMultipleResult":false,"setTopic":true,"outputs":1,"x":790,"y":460,"wires":[["f8a9b16f.529d7"]]},{"id":"1762bb1b.795375","type":"buffer-parser","z":"766a1068.58afb","name":"","data":"payload","dataType":"msg","specification":"spec","specificationType":"ui","items":[{"type":"uint16le","name":"header","offset":0,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"acess_route=>network","offset":2,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"acess_route=>pc_no","offset":3,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"acess_route=>destination_module_station_No","offset":4,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>command","offset":11,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>sub_command","offset":13,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>device_no","offset":15,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"byte","name":"request_data=>device_code","offset":18,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"request_data=>device_count","offset":23,"length":1,"offsetbit":0,"scale":"1","mask":""},{"type":"uint16le","name":"buf","offset":0,"length":-1,"offsetbit":0,"scale":"1","mask":""}],"swap1":"","swap2":"","swap3":"","swap1Type":"swap","swap2Type":"swap","swap3Type":"swap","msgProperty":"payload","msgPropertyType":"str","resultType":"keyvalue","resultTypeType":"output","multipleResult":false,"fanOutMultipleResult":false,"setTopic":true,"outputs":1,"x":370,"y":400,"wires":[["9f013c7f.8bfa7"]]},{"id":"74cfa55d.b1adfc","type":"switch","z":"766a1068.58afb","name":"3E / 4E","property":"payload.header","propertyType":"msg","rules":[{"t":"eq","v":"0x50","vt":"num"},{"t":"eq","v":"0x54","vt":"num"}],"checkall":"true","repair":false,"outputs":2,"x":580,"y":480,"wires":[["161497d7.583468"],["713e004a.8d583"]]},{"id":"713e004a.8d583","type":"buffer-parser","z":"766a1068.58afb","name":"get write data (4E)","data":"payload.buf","dataType":"msg","specification":"spec","specificationType":"ui","items":[{"type":"uint16le","name":"values","offset":25,"length":-1,"offsetbit":0,"scale":"1","mask":""}],"swap1":"","swap2":"","swap3":"","swap1Type":"swap","swap2Type":"swap","swap3Type":"swap","msgProperty":"payload.data","msgPropertyType":"str","resultType":"keyvalue","resultTypeType":"output","multipleResult":false,"fanOutMultipleResult":false,"setTopic":true,"outputs":1,"x":790,"y":500,"wires":[["f8a9b16f.529d7","fe2f26eb.73faa8"]]},{"id":"894f189d.2280f8","type":"MC Write","z":"766a1068.58afb","name":"","topic":"","connection":"8a67d1bd.c84ff","data":"payload","address":"topic","addressType":"msg","dataType":"msg","errorHandling":"throw","outputs":1,"x":540,"y":140,"wires":[["d1d847e5.f14728"]]},{"id":"d1d847e5.f14728","type":"debug","z":"766a1068.58afb","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":670,"y":140,"wires":[]},{"id":"39868be.7425874","type":"inject","z":"766a1068.58afb","name":"","props":[{"p":"topic","vt":"str"},{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"D0,5","payload":"","payloadType":"str","x":190,"y":200,"wires":[["4fabbfaa.503e6"]]},{"id":"fe2f26eb.73faa8","type":"debug","z":"766a1068.58afb","name":"","active":false,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":970,"y":500,"wires":[]},{"id":"b920e789.6f8f98","type":"function","z":"766a1068.58afb","name":"Build write data","func":"var count = msg.count || 5\nvar data = [];\nfor (let index = 0; index < count; index++) {\n    data[index] = index;\n}\n\nmsg.payload = data;\n\nreturn msg;\n\n","outputs":1,"noerr":0,"initialize":"","finalize":"","x":360,"y":140,"wires":[["894f189d.2280f8"]]},{"id":"d5772eff.5f0b7","type":"comment","z":"766a1068.58afb","name":"Basic Mitsubishi Q Emulator (Supports Z, D, R, W areas only)","info":"","x":340,"y":320,"wires":[]},{"id":"8a67d1bd.c84ff","type":"MC Protocol Connection","name":"","host":"localhost","port":"5002","protocol":"UDP","frame":"4E","plcType":"Q","ascii":false,"PLCStation":"","PCStation":"","PLCModuleNo":"","network":"","octalInputOutput":false,"timeout":"1234"}]

package/mcprotocol/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Dana Moffit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/mcprotocol/README.md

@@ -0,0 +1,192 @@
+mcprotocol
+==========
+
+mcprotocol is a library that allows communication to Mitsubishi PLCs (currently only FX3U tested) using the MC (MELSEC Communication) Ethernet protocol as documented by Mitsubishi. 
+
+This software is not affiliated with Mitsubishi in any way, nor am I.  FX3U and MELSEC are trademarks of Mitsubishi.
+
+WARNING - This code is VERY MUCH BETA. Many things are untested (e.g. every combination of PLC / frame / ascii mode / device code / device number / count have not yet been carried out). You need to be aware that WRONG VALUES could be written to WRONG LOCATIONS.  Fully test everything you do.  In situations where writing to a PLC could cost you money, back up your data and test this fully.  If there is any possibily of injury to someone or something, consider other software.
+
+It is optimized - it sorts a large number of items being requested from the PLC and decides what overall data areas to request, then it groups multiple small requests together in a single packet or number of packets up to the maximum length the protocol supports.   So a request for 100 different bits, all close (but not necessarily completely contiguous) will be grouped in one single request to the PLC, with no additional direction from the user.
+
+mcprotocol manages reconnects for you.  So if the connection is lost because the PLC is powered down or disconnected, you can continue to request data with no other action necessary.  "Bad" values are returned, and eventually the connection will be automatically restored.
+
+mcprotocol is written entirely in JavaScript, so no compiler or Python installation is necessary on Windows, and deployment on other platforms (ARM, etc) should be trivial.
+
+Either ASCII or binary communication is supported on 1E frame, only binary mode is currently supported on 3E and 4E frames.  Binary communication is the default, as it is faster as less data is actually sent.
+
+This has been tested only on direct connection to FX3U-ENET, FX3U-ENET-ADP and Q-Series E71.  Any Mitsubishi PLC or PLC Ethernet Card that supports frame 1E, 3E or 4E  should (in theory) work.  Serial port access is not supported - the protocol is slightly different.  This only sends and receives "A, QnA, Q/L compatible 1E, 3E, 4E frames". 
+
+UDP connections are not currently possible.
+
+__To configure a compatible connection on your PLC...__<br>
+Under PLC Parameter, Ethernet Setting, Open Setting, make sure one or more of the connections are set up as "TCP", "MC Protocol". 
+
+_If "MC Protocol" is not available..._
+* Protocol "TCP"
+* Open System "Unpassive" (Fixed buffer can be send or receive if using a FX3U-ENET)
+* Fixed Buffer Communication Procedure set to "Procedure Exist (MC)"
+* "Pairing Open" set to "Disable"
+* Existence Confirmation set to "Confirm" (No Confirm works as well, but can keep connections open for a long time causing failed reconnects) 
+* "Port" (1025 ~ 1029 are values I choose on Q Series. YMMV)
+
+__To get started:__
+
+	npm install mcprotocol
+
+Example usage:
+
+	var mc = require('mcprotocol');
+	var conn = new mc;
+	var doneReading = false;
+	var doneWriting = false;
+
+	var variables = { TEST1: 'D0,5', 	// 5 words starting at D0
+		  TEST2: 'M6990,28', 			// 28 bits at M6990
+		  TEST3: 'CN199,2',			// ILLEGAL as CN199 is 16-bit, CN200 is 32-bit, must request separately
+		  TEST4: 'R2000,2',			// 2 words at R2000
+		  TEST5: 'X034',				// Simple input
+		  TEST6: 'D6000.1,20',			// 20 bits starting at D6000.1
+		  TEST7: 'D6001.2',				// Single bit at D6001
+		  TEST8: 'S4,2',				// 2 bits at S4
+		  TEST9: 'RFLOAT5000,40'		// 40 floating point numbers at R5000	
+	};										// See setTranslationCB below for more examples
+
+	conn.initiateConnection({port: 1281, host: '192.168.0.2', ascii: false}, connected); 
+
+	function connected(err) {
+		if (typeof(err) !== "undefined") {
+			// We have an error.  Maybe the PLC is not reachable.  
+			console.log(err);
+			process.exit();
+		}
+		conn.setTranslationCB(function(tag) {return variables[tag];}); 	// This sets the "translation" to allow us to work with object names defined in our app not in the module
+		conn.addItems(['TEST1', 'TEST4']);	
+		conn.addItems('TEST6');
+	//	conn.removeItems(['TEST2', 'TEST3']);  // We could do this.  
+	//	conn.writeItems(['TEST5', 'TEST7'], [ true, true ], valuesWritten);  	// You can write an array of items as well.  
+		conn.writeItems('TEST4', [ 666, 777 ], valuesWritten);  				// You can write a single array item too.  
+		conn.readAllItems(valuesReady);	
+	}
+
+	function valuesReady(anythingBad, values) {
+		if (anythingBad) { console.log("SOMETHING WENT WRONG READING VALUES!!!!"); }
+		console.log(values);
+		doneReading = true;
+		if (doneWriting) { process.exit(); }
+	}
+
+	function valuesWritten(anythingBad) {
+		if (anythingBad) { console.log("SOMETHING WENT WRONG WRITING VALUES!!!!"); }
+		console.log("Done writing.");
+		doneWriting = true;
+		if (doneReading) { process.exit(); }
+	}
+
+
+This produces the following output, excluding some logs from mcprotocol.js itself:
+	
+	Done writing.
+	{ TEST1: [ 0, 0, 0, 0, 0 ],
+	TEST6:
+	[ true,
+	     false,
+	     true,
+	     false,
+	     false,
+	     true,
+	     false,
+	     false,
+	     false,
+	     false,
+	     false,
+	     false,
+	     false,
+	     true,
+	     false,
+	     true,
+	     true,
+	     false,
+	     true,
+	     true ],
+	  TEST4: [ 666, 777 ] }
+	
+	
+	
+### API
+ - [initiateConnection()](#initiate-connection)
+ - [dropConnection()](#drop-connection)
+ - [setTranslationCB()](#set-translation-cb)
+ - [addItems()](#add-items)
+ - [removeItems()](#remove-items)
+ - [writeItems()](#write-items)
+ - [readAllItems()](#read-all-items)
+
+
+#### <a name="initiate-connection"></a>mcprotocol.initiateConnection(params, callback)
+Connects to a PLC.  
+
+params should be an object with the following keys:
+- port (must match setting in configurator - note this is for TCP connections only, see other setup suggestions above)
+- host (ip address or host name)
+- ascii (default false, set to true if you have set this setting this way in the configurator for the Ethernet module)
+- octalInputOutput (default true, set to false if you really don't like the fact that the program converts Xxxx and Yxxx addresses from Octal to Decimal, ensure you connect before you add items if you're going to set this to false)  If left at the default, addresses line up with GXWorks/GXDeveloper.
+
+`callback(err)` will be executed on success or failure.  err is either an error object, or undefined on successful connection.
+
+#### <a name="drop-connection"></a>mcprotocol.dropConnection()
+Disconnects from a PLC.  
+
+This simply terminates the TCP connection.
+
+
+#### <a name="set-translation-cb"></a>mcprotocol.setTranslationCB(translator)
+Sets a callback for name - address translation.  
+
+This is optional - you can choose to use "addItem" etc with absolute addresses.
+
+If you use it, `translator` should be a function that takes a string as an argument, and returns a string in the following format:
+- <memory area>[type modifier]<device offset><.bit offset><,array length>
+- Examples:
+- M100,20 - 20 boolean values starting at M100, ending at M119
+- X0,8 - First 8 inputs
+- TS190 - Status of timer 290 (boolean)
+- TN190 - Elapsed time value of timer 290 (integer)
+- CS190 - Status of counter 190 
+- CN220 - Count value (double integer as it's over 200)
+- DFLOAT1000 - Floating point value starting at D1000 (and including D1001 as float takes 2 words)
+- D2000,5 - 5 values starting at D2000
+- RDINT80 - R80 and R81 as a DINT
+- RSTR30,10 - String that is 10 characters (5 words) starting at R30
+- S5 - Boolean at S5
+- RFLOAT20,5 - Floating point values starting at R20-21 and ending R28-29
+- Y010 - Output at Y010 (actually the 9th output as outputs are in order Y000-Y008 then Y010)
+- D1000.2 - Bit 2 of word D1000
+- D1000.2,5 - 5 bits starting at D1000.2
+
+In the example above, an object is declared and the `translator` references that object.  It could just as reference a file or database.  In any case, it allows cleaner Javascript code to be written that refers to a name instead of an absolute address.  
+
+
+#### <a name="add-items"></a>mcprotocol.addItems(items)
+Adds `items` to the internal read polling list.  
+
+`items` can be a string or an array of strings.
+
+#### <a name="remove-items"></a>mcprotocol.removeItems(items)
+Removes `items` to the internal read polling list.  
+
+`items` can be a string or an array of strings.
+
+#### <a name="write-items"></a>mcprotocol.writeItems(items, values)
+Writes `items` to the PLC using the corresponding `values`.  
+
+`items` can be a string or an array of strings.  If `items` is a single string, `values` should then be a single item (or an array if `items` is an array item).  If `items` is an array of strings, `values` must be an array.
+
+
+#### <a name="read-all-items"></a>mcprotocol.readAllItems(callback)
+Reads the internal polling list and calls `callback` when done.  
+
+`callback(err, values)` is called with two arguments - a boolean indicating if ANY of the items have "bad quality", and `values`, an object containing the values being read as keys and their value (from the PLC) as the value.
+
+
+