Skip to content

Intercept the voltronic phone-home session for local management with mqtt and others

License

Notifications You must be signed in to change notification settings

brilthor/voltronic-wifi-bridge

Repository files navigation

voltronic-wifi-bridge

Intercept the voltronic phone-home session for local management with mqtt and others

The inverters I have tested appear to phone home to ess.eybond.com on port 502 using a protocol similar to the one available on the serial port but wrapped in TCP and some extra magic

Docker

https://hub.docker.com/r/brilthor/voltronic-wifi-bridge

Usage

host this server somewhere private and either NAT or use static DNS to force the inverters to connect to it instaed of the remote server

usage: voltronic-wifi-bridge [-h] [-u USER] [-p PASSWORD] [-t TOPIC] [-P PORT] mqtthostname mqttport

positional arguments:
  mqtthostname          host name of the mqtt server
  mqttport              port of the mqtt server

options:
  -h, --help            show this help message and exit
  -u USER, --user USER  username for the mqtt server
  -p PASSWORD, --password PASSWORD
                        password for the mqtt server
  -t TOPIC, --topic TOPIC
                        mqtt topic base
  -P PORT, --port PORT  the port to run the voltronic server on

Docker

There is and included dockerfile and docker compose to build and run the service inside docker

Compatible Hardware

Many Voltronic inverters use very similar protocols. Yours may work automatically or might need minor tweaking. Feel free to let the project know if you test it with other hardware.

Brand Model Firmware Versions Compatibility
Maple Leaf Power Systems 6500EX-48 00069.05/00012.21 Works

TODO features (PRs welcome)

  • auto-reg home assistant mqtt
  • feed data to influxdb (multiple versions?)
  • passthrough to remote servers so the phone app still works
  • add support for other inverter models

References

https://github.com/manio/skymax-demo for CRC algorithm Update 2023-11: found more protocol documentation which is close: https://github.com/jblance/mpp-solar/blob/master/docs/protocols/PI30_Communication-Protocol-20150924-Customer.pdf

About

Intercept the voltronic phone-home session for local management with mqtt and others

Resources

License

Stars

Watchers

Forks

Packages

No packages published