ve-ctrl-tool

ve-ctrl-tool (Victron Energy VE.Bus MK2 protocol tool)

this is a library and cli tools to interact with Victron (https://www.victronenergy.com/) devices over the Mk3 adapter.

The author and the project are not affiliated with the Victron Company. The brand name is used only in educational context. Everything here is shared for educational purpose only and for use at your own risk only.

Code structure

• cmd/ commands/servers/entrypoints
• pkg/ potentially re-usable packages.

Usage

Interactive mode:

$ go run ./cmd/ve-shell
Mk2> read-ram 1
value=14 value=0b1110 value=0xe
Mk2> (exit with EOF / CTRL-D)

Commandline invocation:

$ go run ./cmd/ve-shell read-ram 1
value=14 value=0b1110 value=0xe

Run the help command to get a list of commands.

Run with Shelly 3em

go run ./cmd/ve-ess-shelly http://10.1....shelly-address

Monitoring:

$ watch -n 0.1 bash -c '"curl -s localhost:18001/metrics | grep -v -E '^#' | sort"'

Screenshot of monitoring of a 12V Multiplus (smallest available model):

Runtime flags manipulation

With the browser, or:

curl localhost:8080/flags --data 'maxInverter=123'

NixOS flake

Configure NixOS Module:

{
  services.ve-ess-shelly = {
    enable = true;
    maxInverter = 120;
    shellyEM3 = "http://shellyem3-.1.localnet.cc";
  };
}