This client application allows you to inventory all EnOcean devices. It can automatically read and detect devices from the RS485 bus or from wireless network. After the devices are listed in the EnOcean Device Manager you can enricht device information like changing the name, comment or adapt parameters like timeframes, thresholds, units, ... . Furthermore, it automatically can detect default settings for Home Assistant configuration which can be adjust as well and it allows you to generate and export the configuration for Home Assistant. (The exported Home Assistant configuration is intended for the Eltako Home Assistant Integration)
This tool is a desktop application (not browser based) and it runs independent of Home Assistant. Install it directly on a Windows, Linux or Max. (So far only Windows has been tested but all three operating systems should be supported.) Your PC requires Python pre-installed and you should be able to connect it to your EnOcean devices, either via USB cable (Eltako FAM14, FGW14-USB, ...) or wireless transceiver (Eltako FAM-USB). Support for the wireless transceiver 'EnOcean USB300' is planned for future releases.
For the moment I recommend a laptop with Windows and Python installed. You should be able bring close to FAM14 in order to connect it. (Connection to FAM14 is only required for a short moment during the device scan process.)
- Create virtual python environment:
python.exe -m venv .\.venv - Install application:
.\.venv\Scripts\pip.exe install eo_man --force-reinstall(Package available under pypi: eo_man) - Run application:
.\.venv\Scripts\python.exe -m eo_man
- Install application:
pip.exe install eo_man(Package available under pypi: eo_man) - Run application:
python.exe -m eo_man
- Clone/Download the repo.
- Change into the repo directory.
- Create virtual environment for python:
python.exe -m venv .venv - Install dependencies:
.\.venv\Scripts\python.exe setup.py install - Start the app:
.\.venv\Scripts\python.exe -m eo_manor.\.venv\Scripts\python.exe -m eo_man demo.eodm(Directly loads demo data)
For update you can execute:
git pull(Gets newest state of the code)- Optionally change branch:
git checkout BRANCH_NAME - Reinstall
.\.venv\Scripts\python.exe setup.py install --force - Run app:
.\.venv\Scripts\python.exe -m eo_man
Please open issues if you encounter bugs or if you have ideas for new features. Also quite a lot of devices are not yet supported.
pytest tests
- Install package
pip install pre-commit - Config git:
pre-commit install
python setup.py bdist_wheel
pip install dist/eo_man-VERSION-py3-none-any.whl use --force-reinstall if you want to overwrite an existing version.
You can use command line only to generate Home Assistant Configuration based on an existing application configuration.
Check out: python -m eo_man -h
I'm really happy to provide a more and more growing Home Assistant Eltako Integration and tools like this which extend this automation corner even more. The size of this integration is getting much bigger than the use cases I've realized at home, the variety of supported devices is increasing and the stability of the integraiton is getting to a professional level. On the other side it is getting hard to keep this level of development speed and operational quality. I'm about to build up a professional development and testing environment so that the quality can even improved and futher features can still be delivered in a short time frame. You can support this activity in sending devices and/or money.
In general, you can contribute to this project by:
- Support users in the Home Assistant Community (Eltako “Baureihe 14 – RS485” (Enocean) Debugging)
- Reporting Issues
- Creating Pull Requests
- Providing Documentation
- Supporting a proper development and test environment by sending devices and/or money.