A software for a Raspberry pi Zero and other Raspberry models to read the production of APS inverters yc600, qs1 and ds3. I should mention that the basics (the zigbee communication) has been reverse engineered by others who shared their results here: Koenkk/zigbee2mqtt#4221
A very important detail is the software running on the zigbee module, developped by @kadzsol.
NEW april 2022 The DS3 inverter is implemented.
For information on building and use please see the WIKI
See it in action on YouTube
People keep asking for the ssh login, this is 'root' and 'mies'. Please be aware that this is known to the whole world now.
So never put the ssh port open 'to the world'
If you experience speed problems after upgrading to 3_2 or above, you can install zswap, please see the wiki
From outside your network you won't see the menu link. Maintenance can only be done from inside your own network.
The influx database system has the very annoying feature that it starts very slow, sometimes as much as 15 minutes after system boot. This means that you shouldn't backup or restore databases during this period! The values displayed on the webpage are the values reported by the inverter. In case of an inverter reset, these values start at zero so they seem to be incorrect. In the database / charts however, the values will be correct so there is no need for actions by the user. In case of a raspberry reboot there are initially no values written to the database, because it starts very slowly. This means that the chart of the power won't be correct. The energy value in the database will be correct the next day.
This project is intended for reading APS Systems inverters. The program can pair and poll YC600, QS1 and DS3 inverters, up to 9 pieces. The read values are:
- displayed on a web page
- sent via mosquitto in a Json format
- saved in a database for charts and statistics.
2022-07-26 A new sd-card image version RPI-ECU-v3_3 is available (see changelog). RPI-ECU-3_3.zip
This has to be installed by burning the disk image to an sdcard. Before you start please read the instructions. If you want to backup and restore your settings and databases, be sure you have version RPI-ECU-v2_3 or above. And schedule some time after midnight to perform the migration. Please follow the steps in installation via the sd-card image , in particular it is important that you expand the filesystem first and than wait for influxdb is running, before restoring your backup!!.
2022-03-14: ecu_swupdate-v3_7.tar is available (see changelog). Install this only when you are running version 3_1 or higher (please see the expanation to version 3_1 below).
If you experience malformed webpages, please clear your browser cache (delete web history saved pictures)
2022-10-03: ecu_swupdate-v3_6.tar is available (see changelog). Install this only when you have version 3_1 or higher installed (please see the expanation to version 3_1 below).
If you experience malformed webpages, please clear your browser cache (delete web history saved pictures)
If you feel that your system is somewhat slow or less reactive, you can install 'ZRAM', just like a normal software upgrade.
You can download this software patch here: ecu_swupgrade_zram.tar. It is included in sd-card image 3_3.
2022-07-12: A software update to version RPI-ECU-v3_1 is available (see changelog). This is a special update that prepares the system for a new update process.
You can install (and should) v3-1 on any version but please follow the instruction.
2022-07-12: ecu_swupdate-v3_1.tar (set permissions and prepare for new upgrade process)
instruction: The v3_1 update should be installed twice!. The second time the apache server will be restarted, which is necessary to effectuate some system settings. The information window will be greyed out than. When done you don't need to do this again, you now can install higher versions.
From now on, the latest software upgrade will completely update your system to the newest version. No need anymore to do the updates one by one. Example: You have version 2_7. Now if you installed 3_1 (2 times!) and than 3_5, you are completely up-to-date. After you checked the upgrade process please go to the homepage and refresh it.
2022-06-30 A software update to version RPI-ECU-v3_0 is available (see changelog). Install this only when you currently use version 2_9
ecu_swupdate-v3_0.tar
2022-06-23 A software update to version RPI-ECU-v2_9 is available (see changelog). Install this only when you currently use version 2_8
ecu_swupdate-v2_9.tar
2022-06-14 A software update to version RPI-ECU-v2_8 is available (see changelog). Install this only when you currently use version 2_7
ecu_swupdate_14-06-2022.tar
2022-08-10 The sd-card image RPI-ECU-v3_3 is available. This has to be installed by burning the disk image to an sdcard. Before you start please read the instructions. If you want to backup and restore your settings and databases, be sure you have version RPI-ECU-v2_3 or above. And schedule some time after midnight to perform the migration. Please follow the steps in installation via the sd-card image , in particular it is important that you expand the filesystem first and than wait for influxdb is running, before restoring your backup!!.
Please see 'CHANGELOG'
In case someone wants to print the housing: https://1drv.ms/u/s!AkMG5FvUwhediwaPqGYXa7vMkXp8?e=kzkdHQ
Some webpages:
- all inverter information such as temperature, dc voltage etc available
- energy production per solar panel displayed
- values are transferred via Mqtt in user defined json formats
- Easy wifi config portal
- Easy add, delete and pair inverters
- a very smart console to send zigbee commands and debug
- almost all processes show debug information, most pages have a frame for that.
- polled values are stored in a database
- charts of the production at multiple days are available
- There is a page with statistic data
- The menu is only accessible from local network with login
- software can be updated by uploading and installing a tar achive
- data can be requested via a direct link like 'ip_of_ecu/recovery/getInverter.php?inv=x'
(RE) INSTALLATION INSTRUCTIONS (see also the WIKI for further instructions)
installation via the sd-card image
step 1
Download the package, unzip and burn the image on an sd card. If you are new user of this software please continue with stap 3.
step 2
You already are using this software then you can make a backup of your system and databases first. You should do this after midnight.
The backup is primarily intended for system migrations and have to be restored the same day as it was made. If you restore it on a later date you will miss data.
So complete the next steps before sunrise in order to get a smooth migration.
step 3
Visit the WIKI for further instructions
What you need for this project is:
- a Raspberry zero 1.3 W (yes the W means wifi) ~11Euro or a goodold model 1 will work too.
- micro sd-card class 10, 8 or 16 gB (like in your phone)
- a cc2530 module, see photo, with the right firmware on it (see readme in the info folder of the download package.
- a 5V dc 3A powersupply see photo
estimates costs some 25 Euro. The zigbeemodule should be flashed with a firmware that can be found here Koenkk/zigbee2mqtt#4221.
you need 5 dupont cables.
cc2530/31 (see wiki)
p02 -> gpio14 ( pin 8 )
p03 -> gpio15 ( pin 10 )
rst -> gpio18 ( pin 12 )
vcc -> 3.3V
gnd -> g
You forgot your admin password. If you type http://your_ecu_ip/recovery/recover.php you will enter a secret page where you can drop your wifi credentials. At reboot the accesspoint RadioAP is started.
version RPI-ECU-v3_7 14 feb 2023 upgrade archive:
- added retainflag to Mosquitto.
- added the option to have a separate mqtt topic for each inverter.
version RPI-ECU-v3_6 03 oct 2022 upgrade archive:
- added 2 more mqtt json formats (values as float).
- added a zigbee signal quality value (shown in the journal).
version RPI-ECU-v3_5 13 aug 2022 upgrade archive:
- energy values now persistant until midnight, consequent with database and survive inverter resets.
- improved photo display, especially for mobile devices.
version RPI-ECU-v3_4 10 aug 2022 upgrade archive:
- fixed null values for energy due to inverter resets at sunset.
- added default picture, picture icon appears in the inverter details page.
- repaired a small bug in the inverter details page
- improved the navigation/cosmetics and chart of the daily energy.
version RPI-ECU-v3_3 27 july 2022 sdcard image and upgrade archive:
- installed zram-swap for better system performance
- added a memo utility to remember certain events
- check and restore some file privileges at bootup
- prevent overwriting of the photo at swupgrade
- Decreased the sd-card writing by tweaking log settings
- moved a frequently written variable to ramdisk
- improved the navigation and the appearance of charts in small screens
- improved security by disabling page viewing for all o.t.t.w. pages
- improved the swupgrading process, now possible to replace whole directories.
- improved the datase backup and restore processes.
- added an option for authentication in mosquitto
version RPI-ECU-v3_1 12 july 2022 upgrade archive:
- prepare for a new software upgrade procedure
version RPI-ECU-v3_0 30 june 2022 upgrade archive or sd image
- removed the http poll trigger.
- changed the navigation and the appearance of some pages
version RPI-ECU-v2_9 23 june 2022 upgrade archive
- added a http requests to retrieve inverter data
- changed the main page (now a clickable list of all inverters and data)
- repaired a bug in the inverters administration (delete process)
version RPI-ECU-v2_8 13 june 2022 upgrade archive
- repaired a bug in the polling process of ds3 (wrong time value)
- removed a bug in the powercalculation of ds3
version RPI-ECU-v2_7 08 june 2022 upgrade archive
- added healthcheck of influxdb
- fixed a bug in send a zigbeecommand
version RPI-ECU-v2_6 30 may 2022 upgrade archive
- removed limit of 20 in database query
- added a value validation to prevent erratical energy values
version RPI-ECU-v2_5 27 may 2022 upgrade archive
- added dc current for the ds3 inverter
- improved powercalculation
version RPI-ECU-v2_4 19 april 2022 new sd image
- made the program suitable for the ds3 inverter
- extended database query and editing
version RPI-ECU-v2_3 22 march 20222 upgrade archive.
- repaired a bug with database editing
version RPI-ECU-v2_2 22 march 20222 upgrade archive.
- added a utility to edit database entries in 'invEnergy'
version RPI-ECU-v2_1 25 feb 20222 upgrade archive.
- repaired a bug with offset to sunrise / sunset
- restored a missing file for mqtt test.
- Some cosmetics
version RPI-ECU-v2_0 15 feb 20222 Only installable as sd-image.
- changed the process of gathering the total energy values.
- ruled out the effect of disturbances (eclips, inverter resets, zigbee disturbances)
- added a tool to upload and show a photo of your powerplant.