mk2vsc

Read, validate, decode, diff and edit the .rvms configuration files that Victron’s VRM Remote VEConfigure downloads from a MultiPlus or Quattro system, on macOS, Linux or Windows, without VEConfigure. Zero-dependency Python library and command line.

pip install mk2vsc
mk2vsc show download.rvms
mk2vsc edit download.rvms absorption=56.8 float=54.0
mk2vsc verify download.edited.rvms redownload.rvms
mk2vsc diagnose download.rvms

Source and issues: github.com/kylehart/mk2vsc.

The file format

• The .rvms file format: section grammar, the per-section checksum, the per-inverter block, device form versus upload form, the assistant area.
• The settings table: every VE.Bus setting ID with Victron’s name, VEConfigure’s identifier, scale, unit, default and range, and how sure we are.
• Assistants (ESS) in the file and ESS injection by file: the experiment in full.

Working with the device

• Error codes: mk2vsc-36, mk2vsc-47, mk2vsc-49, Error 1303, VE.Bus errors.
• Diagnose: configuration problems read from the settings, with evidence, a fix to take or leave, and a manual change sheet.
• Workflow with VRM Remote VEConfigure, including assistant removal and reinstall and what still needs Windows.
• Change control: the loop that keeps a fleet’s configuration auditable.
• Safety and how to decide whether to trust this.

Background

• How this came to be, the fixture corpus, how the project is run.