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).
- CCU3 with original software: use the ccu3 package (CCU1 and CCU2 are not supported) [not supported by branch 2.7 and newer]
- RaspberryMatic running on other hardware than RaspberryPi 3 or 4 based hardware: use the arm32 package
- RaspberryMatic running on RaspberryPi 3 or 4 based hardware (including RaspberryMatic running on CCU3): you can use the arm64 instead of the arm32 package
- RaspberryMatic on OVA platforms: use the amd64 package
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:
- HomeBase: HomeBase E (T8002), HomeBase 2 (T8010) and HomeBase 3 (T8030)
- eufyCam: eufyCam E (T8112), eufyCam 2C (T8113), eufyCam 2 (T8114), eufyCam 2C Pro (T8142), eufyCam 2 Pro (T8140), eufyCam 3 (T8160) and eufyCam 3C (T8161)
- IndoorCam: IndoorCam C24 (T8400), IndoorCam P24 (T8410) and IndoorCam S350 (T8416)1
- Doorbell: Video Doorbell 2K (T8210), Video Doorbell Dual (T8213) and Video Doorbell Dual E340 (T8214)1
- WallLightCam: Wall Light Cam S100 (T84A1)1
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:
- Download the latest version from release as tar.gz-file. Do not extract this file (important for Apple users).
- Open the WebUI of your CCU and navigate to "Einstellungen" -> "Systemsteuerung" -> "Zusatzsoftware" and select the tar.gz-file downloaded in step 1.
- Click on "Installieren" and wait about one minute.
- In the new popup, select "Installation starten".
-
- If you use the original CCU3 firmware: Wait at least 10 minutes to install. During this time, the WebUI is not accessible, and you will receive several error messages. Please ignore these messages. When the installation is done, the CCU will reboot automatically.
- If you use a RaspberryMatic: The installation is much faster and the CCU will not reboot.
- When the installation is done, navigate to http://<IP_OF_CCU>/addons/eufySecurity and start configuration of the addon.
On the website of the addon (http://<IP_OF_CCU>/addons/eufySecurity), navigate to "Einstellungen" and provide your eufy security account data. Please also read the Notes section. After you click on "Einstellungen speichern", the addon will restart the API and you will see your stations and devices under "Geräte". More information how to use this addon you will find on the "Über" page in the addon website.
For creating the needed system variables, please use the table of system variables on the "Einstellungen" page of the addons website.
- Please do not use 2FA with the the eufy security account you want to use with this addon.
- Please do not use the account on multiple devices (use the account only for this addon).
- You can share the stations and cams are with the account or include the account to your created home.
- To reduce the size of the backup, some folders are excluded. The configfile is included in the backup. So simply reinstall the addon after restoring the ccu.
- For communication between API and stations or devices you need to change the firewall settings of your CCU.
- For communicating with the API, you have to open at least these two ports (standard setting: 52789 and 52790). You can specify individual ports for the API.
- For communicating with the stations or devices you must set the firewall to open all ports (set the rule to ports open) if you are using the default setting. Alternatively, you can specify ports to use. and exclude these in the firewall settings.
- If you run piVCCU in a container add the port forwarding to the ports, e.g. in /etc/network/if-up.d/pivccu add
iptables -t nat -A PREROUTING -p tcp -i $HOST_IF --dport 52789 -j DNAT --to-destination $CCU_IP:52789andiptables -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:
- https://github.com/FuzzyMistborn/python-eufy-security
- https://github.com/keshavdv/python-eufy-security/tree/p2p
- https://github.com/JanLoebel/eufy-node-client
For integrating into the CCU the knowledge of
- Jens Maus https://github.com/jens-maus
- Sebastian Raff https://github.com/hobbyquaker and the community of the HomeMatic-Forum https://www.homematic-forum.de was appreciated.
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.