This is a simple program designed to query the basic runtime parameters of Voltronic, Axpert, Mppsolar PIP, Voltacon, Effekta, and other branded OEM solar inverters.
-
Please see this blog post for the original findings, and inspiration for this project.
-
@ned-kelly has also created a docker based Home Assistant automation of this project and tested it with both Serial & USB. It can be used as a fully-fledged integration to the inverter, with a user-interface and hooked up to a monitoring system such as Grafana - If you are interested, please head to: https://github.com/ned-kelly/docker-voltronic-homeassistant
build/compilation procedure:
git clone git://github.com/manio/skymax-demo.git
cd skymax-demo
cmake .. && make
The code requires your inverter to be connected either via USB or RS323, and can be configured in the inverter.conf file...
You can then run the inverter binary afterwards - By default, it will query the inverter every few seconds and return a JSON response to the console...
USAGE: ./inverter_poller <args> [-r <command>], [-h | --help], [-1 | --run-once]
SUPPORTED ARGUMENTS:
-r <raw-command> TX 'raw' command to the inverter
-h | --help This Help Message
-1 | --run-once Runs one iteration on the inverter, and then exits
-l <buffersize> Define the buffersize for the response of raw command. Default value 7.
-d Additional debugging
Quite a lot of inverters seams to use this protocol. The base seams not to change but depending on your device, you might have more queries available to comunicate with your device and/or more parameters in query response from inverter.
Configuration file allow you to custom the buffersize of wrapped queries qmod, qpigs, qpiri, qpiws, in case default value does not match. Those wrapped queries are use to extract part of the data exposed by your device then wrapped into nice json output.
To get the raw output of your device, you can use the rawcmnd option providing the right buffersize of the query (that's where start your guessing game!).
Here some valid example, tested on an Axpert VM3 inverter, of buffer size to provide to the rawcmd for the associated command:
QPI = 8
QID = 18
QVFW = 18
QVFM2 = 19
QFLAG = 15
QBOOT = 5
QOPM = 6
default: 7, valid value for PE commands
Note:
- When using the
txcommand, your commands will need to follow the specification outlined here. - TX commands will be executed directly on the inverter, then the process wil exit thereafter.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. See the file COPYING for more information.