DEYE Wechselrichter

Balkonkraftwerk: DEYE Wechselrichter ohne Cloud auslesen und per MQTT monitoren

Anfang März habe ich endlich ein Balkonkraftwerk über Amazon bestellt und installiert. Es ist ja inzwischen keine Raketenwissenschaft mehr, und die Akzeptanz und Möglichkeiten zur einfachen Installation per Do-It-Yourself haben mich nun endlich Fakten schaffen lassen.

Ich habe zwei Standard PV-Module je 410W samt einem passendem DEYE Wechselrichter (WR) mit Anschlusskabel als Komplettpaket bestellt. Da ich am Balkon schon eine Klimaanlage stehen habe, ist der Stromanschluss auch kein Problem gewesen. Und endlich gilt im Sommer: Wenn es heiß ist und die Klimaanlage läuft, produzieren die PV-Module ordentlich Strom dafür, außerdem muss ich dann keinen Überschuss verschenken.

Zum Start hatten die DEYE Wechselrichter, die meines Wissens identisch zu z.B. Bosswerk, Blaupunkt und Turbo Energy sind, allerdings noch ein Security Problem mit der Firmware, darüber hatte u.a. Heise berichtet. Ein Firmware Upgrade stand kurz darauf zur Verfügung und wurde automatisch eingespielt.

Die DEYE Wechselrichter haben bereits WLAN eingebaut, d.h. man steckt die wirklich nur in die Steckdose und verbindet anschliessend die PV-Module und es geht los. Die Einbindung ins eigene WLAN erfolgt wie üblich mittels eingebautem WLAN Accesspoint und internem Webserver, worüber man die Konfiguration vornimmt und dann am besten den WLAN-AP deaktiviert. Die Internetverbindung des Wechselrichters habe ich dann über meine Fritzbox gesperrt.

Der WR ist über WLAN nur erreichbar, wenn die PV-Module eine Spannung (DC) erzeugen. Der Anschluss an das Stromnetz (AC) ist hierfür irrelevant. Das heisst wenn es dunkel ist, ist er nicht erreichbar bzw. aus.

Der WR bietet verschiedene Möglichkeiten zur Konfiguration und Abfrage der aktuellen Werte:

• einen internen Webserver (http://10.10.10.254)
• die Cloud Anbindung zu Solarman (Solarman Smart App)
• (angepasstes) Modbus Protokoll über Port 8899
• AT+ Befehle über Port 48899

Ich verwende das Modbus Protokoll zum auslesen des WR, das

1. effizient/schnell ist (Performance)
2. ohne Internetverbindung auskommt

Für DEYE kompatible WR stehen inzwischen einige Lösungsansätze zur Verfügung. Ich verwende die DEYE Inverter MQTT Bridge von Krzysztof Białek, da ich hier bereits einen MQTT Server innerhalb der Heimautomatisierungslösung FHEM zur Einbindung meiner Tasmota Devices (Shelly; Hichi) eingerichtet habe.

Diese Lösung ist als Docker Container konzipiert, was mir aber unnötiger Overhead ist. Da es in Python realisiert ist, starte ich das Skript ganz einfach direkt, ohne Docker.

Wechselrichter Eigenheiten

Der Wechselrichter läuft nur, wenn die PV-Module eine Gleichspannung einspeisen - d.h. wenn es draussen hell ist. Ein Auslesen der Werte des WR funktioniert also nicht, wenn es dunkel ist (Timeout). Ausserdem wird der Tageszähler erst durch setzen von Uhrzeit/Datum wieder auf 0 gesetzt, was über eine Internetverbindung erfolgt. Ist die gesperrt, läuft der Tageszähler weiter.

Also, jeden Abend geht der WR aus, und sobald er beim ersten Tageslicht wieder startet möchte ich Datum und Uhrzeit setzen und anschliessend die Werte kontinuierlich auslesen und über MQTT ausgeben. Bis dahin ist der WR aber halt nicht erreichbar.

Installation

Das Projekt von Github laden und in einem Verzeichnis speichern, Python ist normalerweise ja schon installiert. Ausserdem installiere ich Screen, um das Skript von der Console zu lösen.

git clone https://github.com/kbialek/deye-inverter-mqtt
pip install paho-mqtt
cd deye-inverter-mqtt

Unter Debian habe ich im Skript deye_cli.sh python durch python3 ersetzen müssen:

#!/bin/bash
set -a; source config.env; set +a
python3 deye_cli.py "$@"

config.env

Die Konfiguration meines DEYE Wechselrichters vom Typ Micro-Inverter: config.env

DEYE_LOGGER_IP_ADDRESS=<IP Wechselrichter im WLAN>
DEYE_LOGGER_PORT=8899
DEYE_LOGGER_SERIAL_NUMBER=<Seriennummer des WR>

MQTT_HOST=<IP von MQTT Server>
MQTT_PORT=1883
MQTT_USERNAME=
MQTT_PASSWORD=
MQTT_TOPIC_PREFIX=deye

LOG_LEVEL=ERROR
DEYE_DATA_READ_INTERVAL=60
DEYE_METRIC_GROUPS=micro

deye_inverter.sh

Ausserdem habe ich ein kleines Wrapper Skript geschrieben, um Daten des WR einfacher lesen und schreiben zu können:

deye_inverter.sh [--check <pause>] --read <register> | --write <register> <value>

#!/bin/bash
# Read / Write DEYE Inverters
#   via deye_inverter_mqtt python package
#   https://github.com/kbialek/deye-inverter-mqtt

retries=2       # retry deye_inverter command multiple times
sleep=5         # sleep time between retries

# locate script in deye_inverter_mqtt directory
cd $(dirname $0)
if [ ! -f ./deye_cli.sh ]; then
  echo "Error: ./deye_cli.sh not found."
  echo "       Please move $(basename $0) in deye-inverter-mqtt directory."
  exit 1
fi
. ./config.env

log_info ()
{
    if [ ${LOG_LEVEL} = "INFO" ]; then
        logger -t $(basename $0) $@
    fi
}

log_error ()
{
    logger -t $(basename $0) $@
    echo 2>&1 $@
}

# read parameters: mode [rw], register, value and optional -c <check pause>
pause=0
while [ $# -gt 0 ]; do
    case $1 in
        -c|--check) shift
            [ $# -ge 3 ] || exit 1
            pause=$1
            ;;
        -w|--write) mode=w
            shift
            [ $# -eq 2 ] || exit 1
            reg=$1
            val=$2
            shift
            ;;
        -r|--read) mode=r
            shift
            [ $# -eq 1 ] || exit 1
            reg=$1
            ;;
    esac
    shift
done

# handle offline deye_inverter by
#   ${pause} > 0 -> endless loop
#   ${pause} = 0 -> error after ${retries}
while true; do

    # try deye_cli.sh $retries times every $sleep secs
    check=${retries}
    while [ ${check} -gt 0 ]; do

        case ${mode} in
            r) result=$(./deye_cli.sh $mode $reg | grep 'int: ')
                if [ -n "$result" ]; then
                    echo "$result"
                    log_info -t $0 deye_cli.sh $mode $reg
                    exit 0
                fi
               ;;
            w) result=$(./deye_cli.sh $mode $reg $val)
                if [ "$result" = "Ok" ]; then
                    log_info -t $0 deye_cli.sh $mode $reg $val
                    exit 0
               fi
               ;;
        esac

        # wait ${sleep} or ${pause} secs
        sleep $(( ${pause} ? ${sleep} : ${pause} ))

        # try ${retries} times
        (( check-- ))
    done

    # error, or retry endless until wakeup of deye_inverter
    if [ ${pause} -eq 0 ]; then
        log_error "Error: deye_cli.sh $mode $reg $val failed."
        exit 1
    fi

done

Obiges Skript deye_inverter.sh -r 22 liest z.B. das Register 22 aus dem Wechselrichter aus, deye_inverter.sh -w 22 5892 schreibt das Jahr 2023 und den Monat April (23 *256 + 4) in Register 22.

Das benötigt man, um dem WR jeden Morgen zum Start Datum und Uhrzeit beizubringen. Damit wird auch der Tageszähler täglich auf 0 gesetzt, ansonsten bliebe der alte Wert stehen und der Tageszähler würde einfach stetig addieren, wie der Gesamtertragszähler.

Also, jede Nacht geht der WR aus, und sobald er beim ersten Tageslicht wieder startet möchte ich Datum und Uhrzeit setzen und anschliessend die Werte kontinuierlich auslesen und über MQTT ausgeben.

Folgendes Skript starte ich jeden Morgen um 04:00 Uhr per Cron (und in rc.local fürs booten):

deye_mqtt_loop.sh

Dieses Script liegt bei mir unter /root/sbin und startet eine Endlosschleife. Dazu löscht es alte (vorher gestartete) Instanzen von sich selbst - dadurch kann es jederzeit (zB. in der crontab) erneut gestartet werden.

Ausserdem setzt es beim Start den Tageszähler des Wechselrichters bedarfsweise zurück, bevor die Werte des DEYE Wechselrichters per Endlosschleife abgefragt werden.

#!/bin/bash
# reset Daily_Power of DEYE Inverters
#   via deye_inverter_mqtt python package
#   https://github.com/kbialek/deye-inverter-mqtt

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

debug=

# config:
deye_inverter_sh=/root/deye-inverter-mqtt/deye_inverter.sh
deye_inverter_mqtt_cmd="python3 $(dirname ${deye_inverter_sh})/deye_docker_entrypoint.py"
deye_inverter_mqtt_cfg=$(dirname ${deye_inverter_sh})/config.env

myPID=$$
myname=$(basename $0)

# installation:
# locate script in deye_inverter_mqtt directory
if [ ! -f ${deye_inverter_mqtt_cfg} ]; then
  echo "Error: ${deye_inverter_mqtt_cfg} not found."
  echo "       Please update \$deye_inverter_sh path in $0"
  exit 1
fi

# read my config
set -a; source ${deye_inverter_mqtt_cfg}; set +a

# ----- functions () ------------------------------------
log_info ()
{
    [ "$debug" = "yes" -o "$debug" = "true" ] && echo $myname: $@
    [ ${LOG_LEVEL} = "INFO" ] && logger -t $myname $@
}

log_error ()
{
    logger -t $myname $@
    echo 1>&2 $@
}

# store actual date + time into vars
get_date_time ()
{
    year=$(date +%y)
    month=$(date +%m | sed 's/^0//g')
    day=$(date +%d | sed 's/^0//g')
    hour=$(date +%H | sed 's/^0//g')
    minute=$(date +%m | sed 's/^0//g')
    second=$(date +%S | sed 's/^0//g')
}

# get deye_inverter_mqtt PIDs
get_deye_mqtt_pid ()
{
    deye_mqtt_pid=$(ps ax | grep -v grep | grep "${deye_inverter_mqtt_cmd}" | awk '{print $1}')
}

# kill deye_inverter_loop ()
kill_deye_inverter_loop ()
{
    # kill old instances of me
    my_PS=$(ps ax | grep -v grep | grep ${myname} | awk '{print $1}')
    for ps in $my_PS; do
        [ $ps -lt $myPID ] && kill $ps
    done
}

# kill deye_inverter_instance ()
kill_deye_inverter_instance ()
{
    get_deye_mqtt_pid
    if [ ! -z "${deye_mqtt_pid}" ]; then
        kill ${deye_mqtt_pid}
        log_info "Info: KILL running deye_mqtt ${deye_mqtt_pid}"
    fi

    # kill any running deye_requests
    my_PS=$(ps ax | grep -v grep | grep "${deye_inverter_sh}" | awk '{print $1}')
    [ ! -z "$my_PS" ] && kill $my_PS
}

# stop all runnning instances
deye_inverter_mqtt_stop ()
{
    kill_deye_inverter_loop
    kill_deye_inverter_instance
}

# start deye_inverter_mqtt
deye_inverter_mqtt_start ()
{
    log_info "MQTT start"
    ${deye_inverter_mqtt_cmd}
}

# read Daily power register
read_daily_Power ()
{
    ${deye_inverter_sh} -c 10 -r 60 | sed 's/int: //g' | cut -d, -f1
}

# wait until 04:00 - 22:00
wait_for_operative_window ()
{
    get_date_time

    # calulate time in secs until 04:00
    if [ $hour -ge 4 ]; then
        ((sleep_time=((((28-$hour)*60)-$minute)*60)-$second))
    else
        ((sleep_time=((((4-$hour)*60)-$minute)*60)-$second))
    fi

    # wait for operative time
    if [ $hour -lt 4 -o $hour -ge 22 ]; then
        log_info $sleep_time
        sleep $sleep_time
    fi
}

# write actual date/time into deye inverter
reset_deye_inverter ()
{
    # wait until deye inverter starts by reading (old) year/month (register 22)
    val22_old=$(${deye_inverter_sh} -c 60 -r 22 | sed 's/int: //g' | cut -d, -f1)
    log_info "date/time update initialized"

    # read Daily power register
    dailyPower=$(read_daily_Power)

    # daily reset phase
    daily_reset=init
 
   # ensure by loop, that all register values are written
    while [ ${daily_reset} != "done" ]; do

        # read (old) day
        val23_day=$(${deye_inverter_sh} -c 10 -r 23 | sed 's/.*h: //g' | cut -d, -f1)

        # set actual year, month, day, hour, minute, second
        get_date_time

        # calculate register 22-24 by date and time
        val22=$(( ${year}   * 256 + ${month} ))
        val23=$(( ${day}    * 256 + ${hour} ))
        val24=$(( ${minute} * 256 + ${second} ))

        # reset power/date/time only once a day or exit loop
        [ "$dailyPower" -eq 0 -a "${val22_old}" = "${val22}" -a "${val23_day}" = "${day}" ] && break

        # reset daily_power by
        # setting register 22-24 with actual date + time
        ${deye_inverter_sh} -w 22 $val22 || continue
        ${deye_inverter_sh} -w 23 $val23 || continue
        ${deye_inverter_sh} -w 24 $val24 || continue

        # test success
        # read Daily power register, should be resetted to 0 now
        dailyPower=$(read_daily_Power)

        # exit loop if power is updated, else log that reset failed
        if [ "$dailyPower" -eq 0 ]; then
            daily_reset=done

        ### skip loop here, reset doesn't work always :-(
        # elif [ $daily_reset = "init" ]; then
        #    daily_reset=failed
        #    sleep 60

        else
            log_info "daily power reset failed"
            break
        fi
    done
    log_info "date/time updated"
}

# ------------------------
# MAIN: Script starts here
# ------------------------

# stop any runnning deye_inverter_mqtt processes
deye_inverter_mqtt_stop

# wait until 04:00 - 22:00
wait_for_operative_window

# setting date/time also resets daily power register
reset_deye_inverter

# start deye_mqtt_loop
while get_date_time; do

    # wait for next operative window 04:00 - 22:00
    [ $hour -lt 4 -o $hour -le 22 ] && \
        wait_for_operative_window

    # start deye_inverter_mqtt
    get_deye_mqtt_pid
    [ -z "$deye_mqtt_pid" ] && deye_inverter_mqtt_start

done

Contrab und /etc/rc.local

Mein Crontab Eintrag:

0 4,22 * * * /root/sbin/deye_mqtt_loop.sh 2>/dev/null &

und /etc/rc.local:

# start monitoring of PV-System: DEYE inverter
$(sleep 20; /root/sbin/deye_mqtt_loop.sh 2>dev/null)&

Dashboard

So sieht das aus, wenn es den ganzen Tag im April regnet und bedeckt ist:

Die Eigenverbrauchsquote habe ich mittels Grafana ermittelt: