This library uses PHP to connect to the Ecovacs API and let you control your Ecovacs based devices, like Deebot for example. You need an Ecovacs cloud account and a password to login or a local server like Bumper. The library shows and let you control the supported and registered devices, linked to your account. EcoPhacs has been written in PHP and is an alternative to the Sucks project.
- 2020-10-16 EcoPhacs-Daemon and EcoPhacs-Client released
If you would like to have fast access to your bots and immidiate command reactions and responses,
then this new daemon/client combination is probably what you are searching for. You need two FIFOs
in /run, named
ecophacs-in.fifo
andecophacs-out.fifo
, which can be accessed by theEcoPhacs-Daemon.php
while running. The requirement to run the daemon is to create a config file, usingEcoPhacs-Configure.php
. After the daemon has started, you can use EcoPhacs-Client.php to send commands, which your bot immidiatly executes.
Project requirements are given in composer.json
(
Composer website):
You can use this library in your project by running:
composer require welterrocks/ecophacs
or just clone it from GitHub:
git clone https://github.com/WelterRocks/ecophacs
After you got your copy of ecophacs, change to the installation directory and run the following command, if you want to install ecophacs to your system:
sudo ./install.sh
Just wait for the script to finish the installation. To create a config file, just type:
sudo EcoPhacs-Configure.php
After that, copy ~/.ecophacsrc to /etc/ecophacs/ecophacs.conf:
sudo cp ~/.ecophacsrc /etc/ecophacs/ecophacs.conf
Now you can start the daemon:
sudo EcoPhacs-Daemon.php start
If you would like to start the daemon at system start-up, type:
systemctl enable ecophacs-daemon
to see, whats going on, tail your syslog:
sudo tail -f /var/log/syslog
Now, you can start controlling your bots:
EcoPhacs-Client.php devicelist
This will give you the list of registered devices. Choose one, e.g. E0000111122223333344444, clean for 10 seconds and than go back to the charger:
EcoPhacs-Client.php --device-id E0000111122223333344444 auto --wait 10 charge
But remember, this software is in a beta testing phase.
This library is in an early development stage. You can use this library with the ecovacs cloud, to control your registered devices. Also it has been tested with Bumper, which is a great project by Brian Martin, giving you a local server for your bots. Use this lib with care and do NOT use it for production environments for now, because there is too much testing to do...Hope I can get you to give it a try.
- testing - writing some testing routines for packaging currently there is only one working Example.php and no tests
- mqtt - implement support for MQTT broker it is planned to implement a mqtt listener and a mqtt status daemon