VEDIRECT
VE.Direct is a simple, proprietary, communication protocol used in Victron Energy BlueSolar MPPT Charge 70/15 and the BMV-700 series battery monitors.
The HSYCO VEDIRECT driver supports the default Text-mode, where the device continuously transmits all run-time fields. HEX-mode is not supported.
Contents
Communication
Connect the VE-Direct port to HSYCO using the Victron Energy "VE.Direct to USB" interface cable.
The default serial port parameters are:
| Baud rate | 19200 |
| Data bits | 8 |
| Stop bit | 1 |
| Parity | none |
| Flow control | none |
VE.Direct devices configuration
On power up, a VE.Direct interface will always be in Text-mode, and continuously transmits all run-time fields. No configuration is needed on the device.
HSYCO Configuration
Add a VEDIRECT I/O Server in the I/O Servers section of the Settings and set its parameters:
Communication
- Comm ID: select the comm port connected to the device.
High Availability
- Shutdown when inactive: defaults to true.
Options
| ID | Default | Values | Description |
|---|---|---|---|
| gui | false | true | enable support for the UISET actions |
| false | disable UI support |
Datapoints
See the Victron Energy VE.Direct protocol documentation for the list and description of all supported data fields. The HSYCO VEDIRECT driver will automatically process and return as datapoint any field that the device will send over the VE.Direct interface.
The following table lists all datapoints returned by the BMV-700 series battery monitors.
| ID | Value | R/W | Description |
|---|---|---|---|
| status | online | R | connection established |
| offline | R | HSYCO can’t connect to the VE.Direct device | |
| alarm | ON | R | alarm condition active |
| OFF | R | alarm condition not active | |
| ar | <value> | R | alarm reason |
| bmv | <value> | R | model description |
| ce | <value> | R | consumed Amp Hours (mAh). When the BMV is not synchronised, these statistics have no meaning, so "---" will be sent instead of a value |
| dm | <value> | R | mid-point deviation of the battery bank (0.1 %) |
| fw | <value> | R | firmware version |
| h1 | <value> | R | depth of the deepest discharge (mAh) |
| h2 | <value> | R | depth of the last discharge (mAh) |
| h3 | <value> | R | depth of the average discharge (mAh) |
| h4 | <value> | R | number of charge cycles |
| h5 | <value> | R | number of full discharges |
| h6 | <value> | R | cumulative Amp Hours drawn (mAh) |
| h7 | <value> | R | minimum main battery voltage (mV) |
| h8 | <value> | R | maximum main battery voltage (mV) |
| h9 | <value> | R | number of seconds since last full charge (s) |
| h10 | <value> | R | number of automatic synchronizations |
| h11 | <value> | R | number of low main voltage alarms |
| h12 | <value> | R | number of high main voltage alarms |
| h17 | <value> | R | amount of discharged energy (0.01 kWh) |
| h18 | <value> | R | amount of charged energy (0.01 kWh) |
| i | <value> | R | current (mA) |
| p | <value> | R | instantaneous power (W) |
| pid | <value> | R | product ID |
| ppv | <value> | R | panel power (W) |
| relay | ON | R | relay on state |
| OFF | R | relay off state | |
| soc | <value> | R | state-of-charge (0.1 %). When the BMV is not synchronised, these statistics have no meaning, so "---" will be sent instead of a value |
| t | <value> | R | battery temperature (C). When no temperature sensor is connected, "---" will be sent instead of a value |
| ttg | <value> | R | time-to-go (minutes). When the battery is not discharging the time- to-go is infinite. This is represented as -1. When the BMV is not synchronised, these statistics have no meaning, so "---" will be sent instead of a value |
| v | <value> | R | main battery voltage (mV) |
| vm | <value> | R | mid-point voltage of the battery bank (mV) |
| vpv | <value> | R | panel voltage (mV) |
| vs | <value> | R | auxiliary (starter) voltage (mV) |
UISET Actions
| ID | Attribute | Set to | Description |
|---|---|---|---|
| ce | value | <value> Ah | consumed Amp Hours (Ah) |
| dm | value | <value> % | mid-point deviation of the battery bank (%) |
| h1 | value | <value> Ah | depth of the deepest discharge (Ah) |
| h2 | value | <value> Ah | depth of the last discharge (Ah) |
| h3 | value | <value> Ah | depth of the average discharge (Ah) |
| h4 | value | <value> | number of charge cycles |
| h5 | value | <value> | number of full discharges |
| h6 | value | <value> Ah | cumulative Amp Hours drawn (Ah) |
| h7 | value | <value> V | minimum main battery voltage (V) |
| h8 | value | <value> V | maximum main battery voltage (V) |
| h9 | value | <value> h | time since last full charge (hhh:mm) |
| i | value | <value> A | current (A) |
| p | value | <value> W | instantaneous power (W) |
| ppv | value | <value> W | panel power (W) |
| soc | value | <value> % | state-of-charge (%) |
| t | value | <value> C | battery temperature (C) |
| ttg | value | <value> h | time-to-go (hhh:mm). When the battery is not discharging the time- to-go is infinite. This is represented as "INF" |
| v | value | <value> V | main battery voltage (V) |
| vm | value | <value> V | mid-point voltage of the battery bank (V) |
| vpv | value | <value> V | panel voltage (V) |
| vs | value | <value> V | auxiliary (starter) voltage (mV) |
Release Notes
3.4.0
- initial version release
VE.Direct is a registered trademarks of Victron Energy B.V.
