Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/manio/skymax-demo
https://skyboo.net/2017/03/monitoring-voltronic-power-axpert-mex-inverter-under-linux/
https://github.com/manio/skymax-demo
Last synced: about 8 hours ago
JSON representation
https://skyboo.net/2017/03/monitoring-voltronic-power-axpert-mex-inverter-under-linux/
- Host: GitHub
- URL: https://github.com/manio/skymax-demo
- Owner: manio
- License: gpl-2.0
- Created: 2017-04-26T10:18:10.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-07-01T06:18:04.000Z (5 months ago)
- Last Synced: 2024-07-05T17:16:13.816Z (4 months ago)
- Language: C++
- Size: 54.7 KB
- Stars: 51
- Watchers: 6
- Forks: 29
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# Inverter Poller
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](https://skyboo.net/2017/03/monitoring-voltronic-power-axpert-mex-inverter-under-linux/) for the original findings, and inspiration for this project.
- [@ned-kelly](https://github.com/ned-kelly/) has also created a docker based [Home Assistant](https://www.home-assistant.io/) 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](https://github.com/ned-kelly/docker-voltronic-homeassistant)
------------------------------------------------------------
## Compilation / running
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...
#### Basic command line arguments supported are:
```
USAGE: ./inverter_poller [-r ], [-h | --help], [-1 | --run-once]
SUPPORTED ARGUMENTS:
-r TX 'raw' command to the inverter
-h | --help This Help Message
-1 | --run-once Runs one iteration on the inverter, and then exits
-l Define the buffersize for the response of raw command. Default value 7.
-d Additional debugging
```
#### Configuration hint:
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 `tx` command, your commands will need to follow the specification outlined [here](https://github.com/ned-kelly/docker-voltronic-homeassistant/blob/master/manual/HS_MS_MSX_RS232_Protocol_20140822_after_current_upgrade.pdf).
- TX commands will be executed directly on the inverter, then the process wil exit thereafter.
--------------------------------------------------------------------------------------
license
--------------------------------------------------------------------------------------
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.