:warning: This addon is independent of Anker and eufy. eufy does not provide an open api, in case of any problems with this addon please do not contact eufy.
:warning: CCU3 users with the original firmware provided by eq-3 please note: Starting with version v3.0, this addon will no longer be compatible to the CCU3 with the original firmware provided by eq-3. You can upgrade your CCU3 to RaspberryMatic to use addon version v3.0 and newer. This step is unfortunately necessary because since 2023-09-11 node.js v16 is out of support. With the CCU3s original firmware, node.js newer than v16 cannot be executed. That means, no new devices will be implementent nor changes in the communication with the devices will be implemented anymore for CCU3 with the original firmware. If the CCU3 is already running on RaspberryMatic, no action is necessary.
With this addon for the ELV/eq-3 CCU3 (operated with RaspberryMatic) or a central based on RaspberryMatic you can control your eufy security system and integrate it in your existing connected home environment. The addon provide a web-based user interface for configuration and monitoring. The communication between your eufy security system and your CCU is done by using predefined system variables. For interaction with your eufy security device there is an API.
This addon supports multiple stations and multiple cams. The login token is stored in the config, so there is no need to login every time a connection to eufy is established. After retrieving the stations at startup, the local network address of each station is stored in the config and will be used for switching the guard mode. Since v2.6.0 the addon has a multi-language website. Currently German and English are supported.
The addon will only run with the original CCU3 Firmware and other community projects (RaspberryMatic, piVCCU and debmatic).
Most of the eufy security devices should be compatible, but there might be issues with recently released devices. The following eufy security devices are known as compatible:
1: This device is compatible with v3.0.0 and newer.
If you are using other devices, please send the files you can find on top of the settings page of the device to me, so that they can properly be integrated in one of the next releases.
To install this addon on your CCU follow these steps:
On the website of the addon (http://
For creating the needed system variables, please use the table of system variables on the "Einstellungen" page of the addons website.
iptables -t nat -A PREROUTING -p tcp -i $HOST_IF --dport 52789 -j DNAT --to-destination $CCU_IP:52789
and iptables -t nat -A PREROUTING -p tcp -i $HOST_IF --dport 52790 -j DNAT --to-destination $CCU_IP:52790
(for the two standard ports).This addon based on the eufy-security-client of @bropat. Some changes were done for adapting the client to the api. The following projects also influenced this project:
For integrating into the CCU the knowledge of
The addons website is built on bootstrap https://getbootstrap.com/.
I would also like to thank the people who sponsoring and support this project. I appreciate that. Thank you very much.
eufy, eufy security, ELV, eq-3, CCU, HomeMatic, homematic ip and RaspberryMatic are trademarks of their respective owners.