# @bencevans/ve.direct

> Victron VE.Direct Parser

Latest version **1.2.0** (published 2026-02-25) · GPL-3.0-or-later license · 0 weekly downloads

## Install

```sh
npm install @bencevans/ve.direct
pnpm add @bencevans/ve.direct
yarn add @bencevans/ve.direct
bun add @bencevans/ve.direct
```

## Health

**Score 45/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.2.0 |
| Published | 2026-02-25 |
| First published | 2020-07-26 |
| Weekly downloads | 0 |
| License | GPL-3.0-or-later |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Ben Evans |
| Maintainers | bencevans |
| Keywords | victron, mppt, solar, parser, ve.direct |

## Links

- npm: https://www.npmjs.com/package/@bencevans/ve.direct
- Repository: https://github.com/bencevans/ve.direct
- Homepage: https://github.com/bencevans/ve.direct#readme
- Issues: https://github.com/bencevans/ve.direct/issues
- npm.io page: https://npm.io/package/@bencevans/ve.direct

## Dependencies (2)

- [serialport](https://npm.io/package/serialport.md) ^13.0.0
- [@serialport/parser-delimiter](https://npm.io/package/@serialport/parser-delimiter.md) ^13.0.0

## Alternatives

- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads

## Recent versions

- 1.2.0 (latest) — 2026-02-25
- 1.1.1 — 2025-10-19
- 1.1.0 — 2025-07-31
- 1.0.0 — 2020-07-26

## README

# @bencevans/ve.direct

> Victron VE.Direct Parser

- Read and parses Victron VE.Direct (Text Mode).
- Checks data integrity by protocol's checksum.

```
npm install @bencevans/ve.direct
```

## Usage

## List Devices

```js
const { list } = require("@bencevans/ve.direct");

const devices = await list();
console.log(devices);
// [
// {
//   path: '/dev/ttyUSB1',
//   manufacturer: 'VictronEnergy BV',
//   serialNumber: 'VE3ZJQ53',
//   pnpId: 'usb-VictronEnergy_BV_VE_Direct_cable_VE3ZJQ53-if00-port0',
//   locationId: undefined,
//   vendorId: '0403',
//   productId: '6015'
// }
// ]
```

## Read Data

```js
const VEDirect = require("@bencevans/ve.direct");

new VEDirect("/dev/...").on("data", console.log);
// ...
// {
//   PID: 41055,
//   FW: 150,
//   'SER#': 'xxxxxxxxxxx',
//   V: 12790,
//   I: 800,
//   VPV: 38870,
//   PPV: 13,
//   CS: 3,
//   MPPT: 2,
//   OR: 0,
//   ERR: 0,
//   LOAD: 'ON',
//   IL: 200,
//   H19: 417,
//   H20: 25,
//   H21: 183,
//   H22: 38,
//   H23: 168,
//   HSDS: 8
// }
// ...
```

## Related

- [VE.Direct Whitepaper](https://www.victronenergy.com/upload/documents/Whitepaper-Data-communication-with-Victron-Energy-products_EN.pdf)
- [VE.Direct Protocol FAQ](https://www.victronenergy.com/live/vedirect_protocol:faq)

---
_Source: https://npm.io/package/@bencevans/ve.direct · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._