node-red-contrib-victron-vedirect-usb 0.0.1

package/README.md

@@ -0,0 +1,44 @@
+This node uses a [VE.Direct USB connection](https://www.victronenergy.com/accessories/ve-direct-to-usb-interface)
+to grab the communication on the serial port and trnaslates it into usable data.
+
+A typical use case would be to run Node-RED on a Raspberry Pi and
+connect to the VE.Direct port of a Victron Energy device. E.g. a
+SmartShunt, BMV, Inverter or MPPT.
+
+# Usage
+
+Once the node gets deployed it keeps on reading and stores the values as they
+get read from the serial port. It only outputs on 'inject', so it is needed to
+trigger output via an _inject_ node to the node. Typically you would configure
+that to repeat on an interval of a few seconds.
+
+# Configuration
+
+Select the port to use from the dropdown. The dropdown is generated on the fly,
+so make sure that the USB part of the cable is connected to the system running
+Node-RED.
+
+# Output
+
+The output depends on the connected product, but is based on the
+[VE.Direct-Protocol-3.23.pdf](https://www.victronenergy.com/upload/documents/VE.Direct-Protocol-3.32.pdf).
+
+The `msg.payload` holds the used VE.Direct label, the units, description and value. E.g.:
+
+```
+...
+PID: {"value":"0xA389","description":"ProductID","units":""},
+V: {"value":7814,"description":"Main or channel 1 (battery) voltage","units":"mV"},
+I: {"value":0,"description":"Main or channel 1 battery current","units":"mA"}
+...
+```
+
+The above example is abbreviated. It typically consists of more labels.
+
+# License
+
+License is _GPL-3.0-or-later_.
+
+# About
+
+The code is based on https://github.com/bencevans/ve.direct of Ben Evans.

package/examples/Read from VE.Direct USB.json

@@ -0,0 +1,70 @@
+[
+    {
+        "id": "2b846580860dc65c",
+        "type": "tab",
+        "label": "Flow 2",
+        "disabled": false,
+        "info": "",
+        "env": []
+    },
+    {
+        "id": "1e16a853db4ee92d",
+        "type": "victron-vedirect-usb",
+        "z": "2b846580860dc65c",
+        "name": "",
+        "port": "/dev/ttyUSB0",
+        "x": 390,
+        "y": 320,
+        "wires": [
+            [
+                "a145b12a5d20c03f"
+            ]
+        ]
+    },
+    {
+        "id": "57af26c6c87b120e",
+        "type": "inject",
+        "z": "2b846580860dc65c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "5",
+        "crontab": "",
+        "once": true,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "x": 210,
+        "y": 320,
+        "wires": [
+            [
+                "1e16a853db4ee92d"
+            ]
+        ]
+    },
+    {
+        "id": "a145b12a5d20c03f",
+        "type": "debug",
+        "z": "2b846580860dc65c",
+        "name": "VE.Direct parsed",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 590,
+        "y": 320,
+        "wires": []
+    }
+]

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "node-red-contrib-victron-vedirect-usb",
+  "version": "0.0.1",
+  "description": "Access the Victron equipment with a USB VE.Direct cable",
+  "main": "index.js",
+  "scripts": {
+    "test": "standard --fix"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dirkjanfaber/node-red-contrib-victron-vedirect-usb.git"
+  },
+  "keywords": [
+    "node-red",
+    "victron",
+    "vedirect"
+  ],
+  "node-red": {
+    "nodes": {
+      "victron-vedirect-usb": "src/nodes/vedirect-usb.js"
+    },
+    "version": ">=3.0.2"
+  },
+  "engines": {
+    "node": ">=14.17.4"
+  },
+  "author": "Dirk-Jan Faber <dfaber@victronenergy.com>",
+  "license": "GPL-3.0-or-later",
+  "bugs": {
+    "url": "https://github.com/dirkjanfaber/node-red-contrib-victron-vedirect-usb/issues"
+  },
+  "homepage": "https://github.com/dirkjanfaber/node-red-contrib-victron-vedirect-usb#readme",
+  "dependencies": {
+    "@serialport/bindings": "^10.0.0",
+    "serialport": "^10.0.0"
+  }
+}

package/src/nodes/icons/victronenergy.svg

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 23.0.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 92.7 62.2" style="enable-background:new 0 0 92.7 62.2;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#FFFFFF;}
+</style>
+<title>v-symbol</title>
+<path class="st0" d="M23.9,7.7c-3.4-1.1-7.1-0.3-9.8,2.1c0,0-5.9,4-7,20.6c0,0-0.3,2.8,2.1,3.2c0,0,2.5,0.5,2.8-1.6s0.3-12.6,4.9-18
+	c0.4-0.5,1-1,1.7-1.2c1-0.7,1.8-1.7,2.5-2.7C21.8,9,22.8,8.2,23.9,7.7"/>
+<path class="st0" d="M32.7,7.3c0,0-4.4-1.4-9,2.2c0,0-5.5,3.4-6.9,16.9c-0.2,1.7-0.3,3.3-0.2,5c0.1,1.2,1.1,2,2.2,2.1
+	c0,0,2.5,0.2,2.6-2.1l0.2-3.2c0,0,0.4-9,4-13.5l0.9,0.7C27.7,12,29.9,9.2,32.7,7.3L32.7,7.3z"/>
+<path class="st0" d="M41.6,7.3c-3.7-0.7-7.4,0.5-10,3.2c0,0-4.2,3.7-5.4,13c0,0-0.5,5-0.6,7.4c0,1.3,0.9,2.4,2.2,2.6
+	c1.3,0.1,2.4-0.9,2.5-2.2c0-0.1,0-0.1,0-0.2c0,0,0.2-11.3,4.4-16.5l1,0.6C35.6,15.3,37.4,10.1,41.6,7.3L41.6,7.3z"/>
+<path class="st0" d="M48.2,7.1c-3.9,0.1-7.4,2.3-9.3,5.7c0,0-4,5.8-4,17.6c0,0-0.2,2.8,2,3.1c1.4,0.1,2.6-1,2.6-2.4
+	c0-0.1,0-0.3,0-0.4c0,0,0.1-11.7,4.6-16.4c0,0,4,4.7,4.3,15.9c0,0,0.1,7.7,1.6,11.9c0.9-3.7,1.4-7.5,1.5-11.3c0-0.8,0.3-1.5,0.9-2
+	c0,0,0.7-0.3,0.5-1.5c0,0-1-9.7-4.2-15.3c0,0,6.9-0.5,8.2,13.3c0,1.2,0.4,2.3,1.1,3.3c0.6,0.5,0.9,1.2,0.9,2c0.1,2.8,0,5.5-0.4,8.2
+	c-0.1,1.1,0.1,2.3,0.5,3.3c1-3,1.4-6.2,1.3-9.3c0,0-0.2-3.7,1.6-5c0,0-0.1-10.5-4.3-16.2C55.4,8.7,51.9,7.1,48.2,7.1L48.2,7.1z"/>
+<path class="st0" d="M68.8,54.4c3.4,1.1,7.1,0.3,9.8-2.1c0,0,5.9-4,7-20.6c0,0,0.3-2.8-2.1-3.2c0,0-2.5-0.5-2.8,1.6
+	s-0.3,12.6-4.9,18c-0.4,0.5-1,1-1.7,1.2c-1,0.7-1.8,1.7-2.5,2.7C70.8,53.1,69.9,53.8,68.8,54.4"/>
+<path class="st0" d="M59.9,54.8c0,0,4.4,1.4,9-2.2c0,0,5.5-3.4,6.9-16.9c0.2-1.7,0.3-3.3,0.2-5c-0.1-1.2-1.1-2.1-2.2-2.1
+	c0,0-2.5-0.2-2.6,2.1l-0.2,3.2c0,0-0.4,9-4,13.5L66,46.8C64.9,50,62.8,52.9,59.9,54.8L59.9,54.8z"/>
+<path class="st0" d="M51.1,54.8c3.7,0.7,7.4-0.5,10-3.2c0,0,4.2-3.7,5.4-13c0,0,0.5-5,0.6-7.4c0-1.3-0.9-2.4-2.2-2.6
+	c-1.3-0.1-2.4,0.9-2.5,2.2c0,0.1,0,0.1,0,0.2c0,0-0.1,11.3-4.4,16.5l-1-0.6C57.1,46.7,55.3,52,51.1,54.8L51.1,54.8z"/>
+<path class="st0" d="M44.4,55c3.9-0.1,7.4-2.3,9.3-5.7c0,0,4-5.8,4-17.6c0,0,0.2-2.8-2-3.1c-1.4-0.1-2.6,1-2.6,2.4
+	c0,0.1,0,0.3,0,0.4c0,0-0.1,11.7-4.6,16.4c0,0-4-4.7-4.3-15.9c0,0-0.1-7.7-1.6-11.9c-0.9,3.7-1.4,7.5-1.5,11.3c0,0.8-0.3,1.5-0.9,2
+	c0,0-0.7,0.3-0.5,1.5c0,0,1,9.7,4.2,15.3c0,0-6.9,0.5-8.2-13.3c0-1.2-0.4-2.3-1.1-3.3c-0.6-0.5-0.9-1.2-0.9-2
+	c-0.1-2.8,0-5.5,0.4-8.2c0-1.1-0.1-2.3-0.5-3.3c-1,3-1.4,6.2-1.2,9.3c0,0,0.2,3.7-1.6,5c0,0,0.2,10.5,4.3,16.2
+	C37.2,53.4,40.7,55,44.4,55L44.4,55z"/>
+</svg>

package/src/nodes/vedirect-usb.html

@@ -0,0 +1,84 @@
+<script type="text/javascript">
+
+var portsUrl = (RED.settings.httpNodeRoot || RED.settings.httpAdminRoot || "").replace(/\/$/, "") + '/victron/vedirect-ports/';
+
+function buildEditPanel(node) {
+    var buildOption = function buildOption(port) {
+        return $('<option/>').val(port.path).text(port.path).data(port);
+    };
+
+    var populateSelect = function populateSelect(selector, ports) {
+        selector[0].options.length = 0;
+        ports.forEach(function (port) {
+            selector.append(buildOption(port));
+        });
+        selector.trigger('change');
+    };
+    
+    $.ajax(portsUrl, {
+            beforeSend: function(jqXHR) {
+                var auth_tokens = RED.settings.get("auth-tokens");
+                if (auth_tokens) {
+                    jqXHR.setRequestHeader("Authorization","Bearer "+auth_tokens.access_token);
+                }
+            }
+        })
+        .done(data => {
+            if (data.length !== 0) {
+                populateSelect($('#node-input-port'), data);
+            }
+            if (node.port) { $('#node-input-port').val(node.port) }
+
+        }).fail(function () {
+            return showStatusMessage("Unable to access the service endpoint.");
+        });
+        
+}
+    RED.nodes.registerType('victron-vedirect-usb',{
+        category: 'Victron Energy',
+        paletteLabel: 'VE.Direct USB',
+        color: '#f7ab3e',
+        defaults: {
+            name: {value: ""},
+            port: {value: "/dev/ttyUSB0"}        },
+        inputs: 1,
+        outputs: 1,
+        icon: "victronenergy.svg",
+        label: function() {
+            return this.name||"VE.Direct USB";
+        },
+        oneditprepare: function oneditprepare() {
+            buildEditPanel(this);
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="victron-vedirect-usb">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-port"><i class="fa fa-tag"></i> Port</label>
+        <select id="node-input-port" required>
+        </select>     
+        </div>
+</script>
+
+<script type="text/html" data-help-name="victron-vedirect-usb">
+  <p>A node for VE.Direct USB communication with Victron devices.</p>
+
+  <h3>Configuration</h3>
+
+  <p>Only needed configuration is to select the port where the ttyUSB dongle
+    is connected to. Make sure that you have rights for reading the dongle
+    (this might need you to be in group <tt>dialup</tt>).
+  </p>
+
+  <h3>Input</h3>
+
+  <p>On each input, the read output gets send out. So use an repeating 
+    inject node to get output every x seconds.
+  </p>
+
+</script>

package/src/nodes/vedirect-usb.js

@@ -0,0 +1,56 @@
+module.exports = function (RED) {
+  'use strict'
+  const VEDirect = require('../services/vedirect')
+  const bindings = require('@serialport/bindings')
+
+  function VEDirectUSB (config) {
+    RED.nodes.createNode(this, config)
+
+    const node = this
+    const dataReader = new VEDirect(config.port)
+
+    dataReader.on('data', (data) => {
+      const nodeContext = this.context()
+      const msg = {
+        topic: 'VE.direct'
+      }
+
+      if (data.H1) {
+        nodeContext.set('d1', data)
+        msg.payload = Object.assign({}, data, nodeContext.get('d2'))
+      } else {
+        nodeContext.set('d2', data)
+        msg.payload = Object.assign({}, data, nodeContext.get('d1'))
+      }
+    })
+
+    dataReader.on('error', (error) => {
+      console.error(error)
+      node.warn(error)
+    })
+
+    node.on('input', function (msg) {
+      const nodeContext = this.context()
+      msg.payload = Object.assign({}, nodeContext.get('d1'), nodeContext.get('d2'))
+      node.send(msg)
+    })
+
+    node.on('close', function () {
+      dataReader.serial.close()
+    })
+  }
+
+  RED.nodes.registerType('victron-vedirect-usb', VEDirectUSB)
+
+  RED.httpNode.get('/victron/vedirect-ports', (req, res) => {
+    function list (ports) {
+      res.setHeader('Content-Type', 'application/json')
+      return res.send(ports)
+    }
+
+    bindings.list().then(list, err => {
+      console.log(err)
+      process.exit(1)
+    })
+  })
+}

package/src/services/parser.js

@@ -0,0 +1,484 @@
+const { Transform } = require('stream')
+
+const checksum = (blockBuffer) => {
+  return blockBuffer.reduce((prev, curr) => {
+    return (prev + curr) & 255
+  }, 0)
+}
+
+const parseValues = (frame) => {
+  for (const key in frame) {
+    switch (key) {
+      case 'V':
+        frame[key] = {
+          value: frame[key],
+          description: 'Main or channel 1 (battery) voltage',
+          units: 'mV'
+        }
+        break
+      case 'V2':
+        frame[key] = {
+          value: frame[key],
+          description: 'Channel 2 (battery) voltage',
+          units: 'mV'
+        }
+        break
+      case 'V3':
+        frame[key] = {
+          value: frame[key],
+          description: 'Channel 3 (battery) voltage',
+          units: 'mV'
+        }
+        break
+      case 'VS':
+        frame[key] = {
+          value: frame[key],
+          description: 'Auxiliary (starter) voltage',
+          units: 'mV'
+        }
+        break
+      case 'VM':
+        frame[key] = {
+          value: frame[key],
+          description: 'Mid-point voltage of the battery bank',
+          units: 'mV'
+        }
+        break
+      case 'DM':
+        frame[key] = {
+          value: frame[key],
+          description: 'Mid-point deviation of the battery bank',
+          units: '‰'
+        }
+        break
+      case 'VPV':
+        frame[key] = {
+          value: frame[key],
+          description: 'Panel voltage',
+          units: 'mV'
+        }
+        break
+      case 'PPV':
+        frame[key] = {
+          value: frame[key],
+          description: 'Panel power',
+          units: 'W'
+        }
+        break
+      case 'I':
+        frame[key] = {
+          value: frame[key],
+          description: 'Main or channel 1 battery current',
+          units: 'mA'
+        }
+        break
+      case 'I2':
+        frame[key] = {
+          value: frame[key],
+          description: 'Channel 2 battery current',
+          units: 'mA'
+        }
+        break
+      case 'I3':
+        frame[key] = {
+          value: frame[key],
+          description: 'Channel 3 battery current',
+          units: 'mA'
+        }
+        break
+      case 'IL':
+        frame[key] = {
+          value: frame[key],
+          description: 'Load current',
+          units: 'mA'
+        }
+        break
+      case 'LOAD':
+        frame[key] = {
+          value: frame[key],
+          description: 'Load output state (ON/OFF)',
+          units: 'W'
+        }
+        break
+      case 'T':
+        frame[key] = {
+          value: frame[key],
+          description: 'Battery temperature',
+          units: '°C'
+        }
+        break
+      case 'P':
+        frame[key] = {
+          value: frame[key],
+          description: 'Instantaneous power',
+          units: 'W'
+        }
+        break
+      case 'CE':
+        frame[key] = {
+          value: frame[key],
+          description: 'Consumed Amp Hours',
+          units: 'mAh'
+        }
+        break
+      case 'SOC':
+        frame[key] = {
+          value: frame[key],
+          description: 'State-of-charge',
+          units: '‰'
+        }
+        break
+      case 'TTG':
+        frame[key] = {
+          value: frame[key],
+          description: 'Time-to-go',
+          units: 'Minutes'
+        }
+        break
+      case 'Alarm':
+        frame[key] = {
+          value: frame[key],
+          description: 'Alarm condition active',
+          units: ''
+        }
+        break
+      case 'Relay':
+        frame[key] = {
+          value: frame[key],
+          description: 'Relay state',
+          units: ''
+        }
+        break
+      case 'AR':
+        frame[key] = {
+          value: frame[key],
+          description: 'Alarm reason',
+          units: ''
+        }
+        break
+      case 'OR':
+        frame[key] = {
+          value: frame[key],
+          description: 'Off reason',
+          units: ''
+        }
+        break
+      case 'H1':
+        frame[key] = {
+          value: frame[key],
+          description: 'Depth of the deepest discharge',
+          units: 'mAh'
+        }
+        break
+      case 'H2':
+        frame[key] = {
+          value: frame[key],
+          description: 'Depth of the last discharge',
+          units: 'mAh'
+        }
+        break
+      case 'H3':
+        frame[key] = {
+          value: frame[key],
+          description: 'Depth of the average discharge',
+          units: 'mAh'
+        }
+        break
+      case 'H4':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of charge cycles',
+          units: ''
+        }
+        break
+      case 'H5':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of full discharges',
+          units: ''
+        }
+        break
+      case 'H6':
+        frame[key] = {
+          value: frame[key],
+          description: 'Cumulative Amp Hours drawn',
+          units: 'mAh'
+        }
+        break
+      case 'H7':
+        frame[key] = {
+          value: frame[key],
+          description: 'Minimum main (battery) voltage',
+          units: 'mV'
+        }
+        break
+      case 'H8':
+        frame[key] = {
+          value: frame[key],
+          description: 'Maximum main (battery) voltage',
+          units: 'mV'
+        }
+        break
+      case 'H9':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of seconds since last full charge',
+          units: 'Seconds'
+        }
+        break
+      case 'H10':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of automatic synchronizations',
+          units: ''
+        }
+        break
+      case 'H11':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of low main voltage alarms',
+          units: ''
+        }
+        break
+      case 'H12':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of high main voltage alarms',
+          units: ''
+        }
+        break
+      case 'H13':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of low auxiliary voltage alarms',
+          units: ''
+        }
+        break
+      case 'H14':
+        frame[key] = {
+          value: frame[key],
+          description: 'Number of high auxiliary voltage alarms',
+          units: ''
+        }
+        break
+      case 'H15':
+        frame[key] = {
+          value: frame[key],
+          description: 'Minimum auxiliary (battery) voltage',
+          units: 'mV'
+        }
+        break
+      case 'H16':
+        frame[key] = {
+          value: frame[key],
+          description: 'Maximum auxiliary (battery) voltage',
+          units: 'mV'
+        }
+        break
+      case 'H17':
+        frame[key] = {
+          value: frame[key],
+          description: 'Amount of discharged energy (BMV) / Amount of produced energy (DC monitor)',
+          units: '0.01 kWh'
+        }
+        break
+      case 'H18':
+        frame[key] = {
+          value: frame[key],
+          description: 'Amount of charged energy (BMV) / Amount of consumed energy (DC monitor)',
+          units: '0.01 kWh'
+        }
+        break
+      case 'H19':
+        frame[key] = {
+          value: frame[key],
+          description: 'Yield total (user resettable counter)',
+          units: '0.01 kWh'
+        }
+        break
+      case 'H20':
+        frame[key] = {
+          value: frame[key],
+          description: 'Yield today',
+          units: '0.01 kWh'
+        }
+        break
+      case 'H21':
+        frame[key] = {
+          value: frame[key],
+          description: 'Maximum power today',
+          units: 'W'
+        }
+        break
+      case 'H22':
+        frame[key] = {
+          value: frame[key],
+          description: 'Yield yesterday',
+          units: '0.01 kWh'
+        }
+        break
+      case 'H23':
+        frame[key] = {
+          value: frame[key],
+          description: 'Maximum power yesterday',
+          units: 'W'
+        }
+        break
+      case 'ERR':
+        frame[key] = {
+          value: frame[key],
+          description: 'Error code',
+          units: ''
+        }
+        break
+      case 'CS':
+        frame[key] = {
+          value: frame[key],
+          description: 'State of operation',
+          units: ''
+        }
+        break
+      case 'BMV':
+        frame[key] = {
+          value: frame[key],
+          description: 'Model description (deprecated)',
+          units: ''
+        }
+        break
+      case 'FW':
+        frame[key] = {
+          value: frame[key],
+          description: 'Firmware version (16 bit)',
+          units: ''
+        }
+        break
+      case 'FWE':
+        frame[key] = {
+          value: frame[key],
+          description: 'Firmware version (24 bit)',
+          units: ''
+        }
+        break
+      case 'PID':
+        frame[key] = {
+          value: frame[key],
+          description: 'ProductID',
+          units: ''
+        }
+        break
+      case 'SER#':
+        frame[key] = {
+          value: frame[key],
+          description: 'Serial number',
+          units: ''
+        }
+        break
+      case 'HSDS':
+        frame[key] = {
+          value: frame[key],
+          description: 'Day sequence number (0..364)',
+          units: ''
+        }
+        break
+      case 'MODE':
+        frame[key] = {
+          value: frame[key],
+          description: 'Device mode',
+          units: ''
+        }
+        break
+      case 'AC_OUT_V':
+        frame[key] = {
+          value: frame[key],
+          description: 'AC output voltage',
+          units: '0.01 V'
+        }
+        break
+      case 'AC_OUT_I':
+        frame[key] = {
+          value: frame[key],
+          description: 'AC output current',
+          units: '0.1 A'
+        }
+        break
+      case 'AC_OUT_S':
+        frame[key] = {
+          value: frame[key],
+          description: 'AC output apparent power',
+          units: 'VA'
+        }
+        break
+      case 'WARN':
+        frame[key] = {
+          value: frame[key],
+          description: 'Warning reason',
+          units: ''
+        }
+        break
+      case 'MPPT':
+        frame[key] = {
+          value: frame[key],
+          description: 'Tracker operation mode',
+          units: ''
+        }
+        break
+      case 'MON':
+        frame[key] = {
+          value: frame[key],
+          description: 'DC monitor mode',
+          units: ''
+        }
+        break
+      default:
+        frame[key] = {
+          value: frame[key],
+          description: 'Non implemented key',
+          units: ''
+        }
+        break
+    }
+    frame[key].value = parseFloat(frame[key].value) || frame[key].value
+    if (frame[key].value === '0') {
+      frame[key].value = 0
+    }
+  }
+
+  return frame
+}
+
+class VEDirectParser extends Transform {
+  constructor () {
+    super({
+      readableObjectMode: true
+    })
+
+    this.buf = Buffer.alloc(0)
+    this.blk = {}
+  }
+
+  _transform (chunk, _, cb) {
+    const [key, val] = chunk.toString().split('\t')
+
+    if (key[0] === ':') {
+      return cb()
+    }
+
+    this.buf = Buffer.concat([this.buf, Buffer.from([0x0d, 0x0a]), chunk])
+
+    if (key === 'Checksum') {
+      if (checksum(this.buf) === 0) {
+        this.push(parseValues(this.blk))
+      }
+
+      this.buf = Buffer.alloc(0)
+      this.blk = {}
+    } else {
+      this.blk[key] = val
+    }
+
+    cb()
+  }
+}
+
+module.exports = VEDirectParser
+module.exports.checksum = checksum

package/src/services/vedirect.js

@@ -0,0 +1,32 @@
+const { SerialPort } = require('serialport')
+const { DelimiterParser } = require('@serialport/parser-delimiter')
+const VEDirectParser = require('../services/parser')
+const { EventEmitter } = require('events')
+
+class VEDirect extends EventEmitter {
+  constructor (path) {
+    super()
+
+    this.serial = new SerialPort({
+      path,
+      baudRate: 19200,
+      dataBits: 8,
+      parity: 'none'
+    })
+
+    this.rl = new DelimiterParser({
+      delimiter: Buffer.from([0x0d, 0x0a], 'hex'),
+      includeDelimiter: false
+    })
+
+    this.ve = new VEDirectParser()
+
+    this.ve.on('data', (data) => {
+      this.emit('data', data)
+    })
+
+    this.serial.pipe(this.rl).pipe(this.ve)
+  }
+}
+
+module.exports = VEDirect