VEDIRECT

From HSYCO
Jump to navigation Jump to search

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.

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.