Solar power generation work best if there are no clouds anywhere to be seen :)
This repository aims to document how to use Deye microinverters entirely local only and cloud free. It consolidates the knowledge that at the time of writing was spread over hundreds of different posts, issues and comments.
Furthermore, it also features a cloud replacement implementation so you won't have to install any apps or create any accounts. You also won't have to share any e-mail address or phone number.
So far, the following devices are known to work like this:
- Deye SUN600G3-EU-230
- Deye SUN-M80G3-EU-Q0
- Deye SUN-M80G4-EU-Q0
it should also be the same for other inverters of the same series including rebrands such as Bosswerk.
If you have verified that it works with another device, feel free to extend this list.
Here are the main things you will want to know about these microinverters:
- They have Wi-Fi
- They can be connected to Wi-Fi networks via their webinterface
- They can operate without an internet connection
- They can operate without an account
- They can be monitored and controlled via their local ModbusTCP interface
- You can also completely replace the cloud with a local implementation: dummycloud
2024-08-20 Update
Deye has started rolling out firmware updates for the logger that block both ModbusTCP access and prevent the mock cloud from working due to the introduction of TLS. Fortunately, for now it seems that newly bought inverters still come with older logger firmwares that work offline. Also equally fortunately, it seems that downgrading the firmware is possible as well.
However, both of these things may change in the future.
Compared to traditional PV setups where a single large inverter is connected to strings of many PV Panels, in a microinverter Setup, you have one small inverter for every 1-4 PV Panels.
There are up- and downsides to both of these topologies but that is for now out of scope for this document. What you need to know is that microinverters are cheaper and scaled-down versions of their larger brothers.
Because they only cost 150-200€ they make getting into solar power generation accessible for many more people than ever before. Paired with two PV Panels you're looking at an investment of at most 1000€ to get free energy from the sun.
Additionally, because you only need few panels for the setup to make sense financially, often a balcony or garden can be enough for a small solar setup. This is especially interesting for people living in rental properties.
After reading through way too many concerning posts and comments, here's what has to be said:
Please please please don't cut any corners when it comes to safety-critical stuff such as cabling and also mounting panels. You don't want your home to burn down or anyone to be killed by a falling 1.5m² 25kg PV Panel.
Electricity is dangerous. So are heavy things with a huge attack surface for wind.
When in doubt, contact a local electrician. They know what they're doing and will help you.
Now with that out of the way, we can talk about what to do.
The first important thing to note is that these inverters will shut down if they don't sense at least 20V on at least one PV input. This means that you have to do all this during the day connected while connected to a PV panel.
Alternatively, some people reported that they got the inverter to wake up by connecting a 30V lab power supply to one of the PV inputs.
By default, your microinverter should provide a Wi-Fi Access point with an SSID named similarly to AP_4151234567
.
Using a laptop, connect to that using the password printed on the AP or for older inverters the default password 12345678
.
In a browser, navigate to the IP of the inverter in that network which should by default be http://10.10.100.254/
.
Log in to the webinterface with the default credentials admin:admin
and use that to configure Wi-Fi.
The AP-mode can be a bit unstable so prepare for the webinterface stopping to work occasionally. Once the inverter is connected to you Wi-Fi, this should not be an issue anymore.
After joining the inverter to you Wi-Fi network, connect to the webinterface again but this time using the IP in your network.
Now, expand the Device Information
on the Status
page and ensure that your logger firmware version is at least MW3_16U_5406_1.53
or newer.
Older firmwares don't allow reconfiguration of the Wi-Fi AP, which is a serious vulnerability, as it allows an attacker to easily gain access to your real Wi-Fi credentials.
If your firmware is older, you can find firmware update files in this repo: https://github.com/dasrecht/deye-firmware.
You can flash them using the Upgrade Firmware
page of the webinterface.
With the logger firmware upgraded, you should now use the webinterface to change SSID and Password for the AP of the inverter.
Pick something not immediately obvious and relatively secure as - as mentioned before - it is all that prevents an attacker from connecting to that AP and reading out your main Wi-Fi credentials.
I have been told that you can also use the wizard to disable the AP entirely, however personally, I like having a fallback way into the inverter, especially since I did not see a "Factory Reset" button on the device.
Now that the AP is secured, use the configuration interface of your router to block internet access of the inverter. You will also likely want to configure it, so that it will always get the same IP assigned via DHCP.
These things should be dropdowns and checkboxes in most consumer routers. If you run some advanced setup, you will know what to do.
You can also try to DNS-block access1.solarmanpv.com
and access2.solarmanpv.com
, however it seems that the logger firmware might also use hardcoded IPs?
Either way, just blocking internet access entirely should be much easier in most setups anyway and comes with no known downsides.
After connecting the inverter to your Wi-Fi network, securing it and blocking its internet access, all you need to do now is monitor and control it.
For this there are different options.
Most of the options rely on polling the local modbusTCP interface that uses the inverter logger serial number for authentication.
To get this serial, simply look at the sticker on the device:
If you feel like doing something arcane and/or want to build something for that yourself, you can find the Modbus spec for these inverters in the complementary assets repo: https://github.com/Hypfer/deye-microinverter-cloud-free-assets.
Note that with internet access blocked, the inverter never receives any time information.
This breaks the Yield today
counter as it will never properly reset unless you manually set the time on each boot using modbus register 22
, 23
and 24
.
With Home Assistant, the easiest way to get your inverter connected is by using HACS to install the Solarman custom_component
.
Please refer to the project documentation on how to install and configure those.
Home Assistant offers powerful tooling to store, visualize and process data right out of the box.
For example, here's how a solar dashboard could look like using mock data and only stock home assistant cards. The real world will obviously look slightly different but the idea should be the same:
If you're using OpenHAB, FHEM, ioBroker or something else, as long as it can speak MQTT, you can use for example https://github.com/kbialek/deye-inverter-mqtt to connect your inverter to your smarthome.
A docker-compose.yml
entry for that tool could look like this:
deyetomqtt:
image: ghcr.io/kbialek/deye-inverter-mqtt
container_name: "deyetomqtt"
environment:
- LOG_LEVEL=DEBUG
- DEYE_DATA_READ_INTERVAL=60
- DEYE_METRIC_GROUPS=micro
- DEYE_LOGGER_SERIAL_NUMBER=4151234567
- DEYE_LOGGER_IP_ADDRESS=192.168.178.123
- DEYE_LOGGER_PORT=8899
- MQTT_HOST=192.168.178.2
- MQTT_TOPIC_PREFIX=deye
- MQTT_PORT=1883
restart: always
Keep in mind that this might change in the future so make sure to always check the docs of the project itself.
If you don't want polling and/or are unhappy with having the inverter in a perpetual state of reconnection to the cloud, you can instead deploy the cloud replacement that can be found in the dummycloud folder in this repository.
This will make the inverter happy, provide it with the correct time for daily counters to work and push all the data to your MQTT broker. It will also autoconfigure entities for home assistant.
It is however a bit more complicated than the polling approaches, as it requires you to understand how networks work and how to deploy a service somewhere. Nothing too arcane of course but if you don't know anything about linux, you might want to pass on this.
For further information, check out the dummycloud folder.
Hidden configuration page
These inverters also have a hidden configuration page that is reachable via /config_hide.html
.
There, it is possible to configure
- Cloud Server A and B
- Serial Port parameters (which serial port?)
- The port of the modbusTCP server of the inverter
- Enable/Disable the AP
- Switch the branding(?)
Apart from the modbus over tcp interface, these inverters also provide another interface on port 48899 where you can talk to it over AT commands like a modem. For that, for now you can use this tool: https://github.com/s10l/deye-logger-at-cmd.
Some firmware versions seem to respond to the AT+H
command with a full list of commands.
Mine doesn't, however a user fortunately posted a full response which is the source for this table:
Click here to show the AT command table
Command | Vendor Description |
---|---|
AT+TIME | Set/Get Device Time |
AT+ADDRESS | Set/Get Device Address |
AT+KEY | Set/Get Device Password |
AT+MTYPE | Set/Get Device Mtype |
AT+CNMOSAVE | Set/Get TCPB Link Mode |
AT+DEVICENUM | Set/Get Device Link Num |
AT+DEVSELCTL | Set/Get Web Device List Info |
AT+NDBGS | Set/Get Debug Status |
AT+FFCLER | Clear File in Flash |
AT+LANGSEL | Select Language |
AT+ADTIME | Set/Get Device Time |
AT+YZFTIME | Set/Get Device factory Time |
AT+TZEARSE | Clear yz File in Flash |
AT+YZACK | Clear yz File in Flash |
AT+YZTIME | Clear yz File in Flash |
AT+YZWKTIME | Clear yz File in Flash |
AT+YZERRCLR | Clear yz File in Flash |
AT+YZDBNUM | Clear yz File in Flash |
AT+YZDB | Clear yz File in Flash |
AT+YZVER | Clear yz File in Flash |
AT+YZLOG | Clear yz File in Flash |
AT+YZAPP | Clear yz File in Flash |
AT+YZAPSTAT | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZWAKEYCTL | Clear yz File in Flash |
AT+YZsize | Clear yz File in Flash |
AT+YZFLSHTEST=,<devlist_status> | |
AT+YZFLSHTEST=,<devlist_status> | |
AT+YZVER | Clear yz File in Flash |
AT+YZVER | Clear yz File in Flash |
AT+YZVER | Clear yz File in Flash |
AT+YZVER | Clear yz File in Flash |
AT+YZVER | Clear yz File in Flash |
AT+YZEXPFUN | Clear yz File in Flash |
AT+YZEXPFUN | Clear yz File in Flash |
AT+YZEXPFUN | Clear yz File in Flash |
AT+YZEXPFUN | Clear yz File in Flash |
AT+YZEXPFUN | Clear yz File in Flash |
AT+YZEXPFUN | Clear yz File in Flash |
AT+TMODE | Set/Get the UART work mode. |
AT+ENTM | Goto Through MOde. |
AT+UART | Set/Get the UART0/UART1 Parameters. |
AT+WSMAC | Set/Get Module MAC Address. |
AT+WAMAC | Get Module MAC Address in AP mode. |
AT+NDBGL | set/get debug level |
AT+RELD | Reload the default setting and reboot. |
AT+RLDEN | Put on/off the Reload Pin. |
AT+MID | Get The Module ID. |
AT+WRMID | Write Module ID. |
AT+ASWD | Set/Query WiFi configuration code. |
AT+VER | Get application version. |
AT+BVER | Get bootloader version. |
AT+HWVER | Get hardware version. |
AT+FCLR | Clear Fsetting. |
AT+CFGRD | Get current system config. |
AT+CFGTF | Save Current Config to Default Config. |
AT+SMEM | show system memory stat |
AT+OTA | OTA |
AT+UPURL | Set/Get the path of remote upgrade. |
AT+CMDPW | Set/Get cmd password in throuphput mode. |
AT+UID | Set/Get UID. |
AT+E | Echo ON/Off, to turn on/off command line echo function. |
AT+Z | Reset the Module. |
AT+SRST | Soft Reset the Module. |
AT+H | show help |
AT+NETP | Set/Get the Net Protocol Parameters. |
AT+TCPLK | Get The state of TCP link. |
AT+TCPTO | Set/Get TCP time out. |
AT+TCPDIS | Connect/Dis-connect the TCP Client link |
AT+MAXSK | Set/Get MAX num of TCP socket (1~5) |
AT+RCV | Recv data from socket_a |
AT+SEND | Send data to socket_a |
AT+SOCKB | Set/Get Parameters of socket_b. |
AT+TCPLKB | Get The state of TCP_B link. |
AT+TCPTOB | Set/Get TCP_B time out. |
AT+TCPDISB | Connect/Dis-connect the TCP_B Client link. |
AT+RCVB | Recv data from socket_b |
AT+SNDB | Send data to socket_b |
AT+WMODE | Set/Get the WIFI Operation Mode (AP or STA). |
AT+WSSSID | Set/Get the AP's SSID of WIFI STA Mode. |
AT+WSKEY | Set/Get the Security Parameters of WIFI STA Mode. |
AT+WSLK | Get Link Status of the Module (Only for STA Mode). |
AT+WSLQ | Get Link Quality of the Module (Only for STA Mode). |
AT+WAP | Set/Get the AP parameters. |
AT+WAKEY | Set/Get the Security Parameters of WIFI AP Mode. |
AT+WALK | Show sta information of AP connection. |
AT+WALKIND | enable/disable LED indication of AP connection. |
AT+WAPMXSTA | Set/Get the Max Number Of Sta Connected to Ap. |
AT+WSCAN | Get The AP site Survey (only for STA Mode). |
AT+SMTLK | Start Smart Configuration. |
AT+SMTLKST=mode,protocol | Setup smartlnk mode and protocol. |
AT+SMARTAPCONFIG | Enable/disable smart AP config function. |
AT+SMARTAPSTART | Start smart AP config function. |
AT+WPS | Start WPS. |
AT+DISPS | Disable power saving mode of WIFI |
AT+WIFI=UP/DOWN | Power down or up the wifi chip. |
AT+MDCH | Put on/off automatic switching WIFI mode. |
AT+WSLKO | Enable/Disable connect router with the best signal. |
AT+DTIM | Set/Get station listen interval(1~3). |
AT+UDPLCPT | Set/Get local UDP port. |
AT+PING | General PING command. |
AT+WANN | Set/Get The WAN setting if in STA mode. |
AT+LANN | Set/Get The LAN setting if in ADHOC mode. |
AT+WADHCP | enable/disable AP dhcp server and set ip address pool |
AT+WEBU | Set/Get the Login Parameters of WEB page. |
AT+WEBVER | Get WEB version. |
AT+PLANG=EN/CN | Set/Get the language of WEB page. |
AT+WSDNS | Set/Get the DNS Server address. |
AT+NTPEN | Enable/Disable NTP Server. |
AT+NTPRF | Set/Query NTP. |
AT+NTPTM | Set/Query Ntp Time. |
AT+NTPSER | Set/Query Ntp Server. |
AT+TXPWR | Set/Get wifi rf tx power. |
AT+RFTESTMODE | RF test mode ON/OFF. |
If this software and documentation effort brought value to you, there's the option to leave a small donation using the "Sponsor" button on top of the repo or by clicking right here.
Thanks!