Home Assistant EnOcean app

Provide Home Assistant EnOcean compatibility using MQTT broker and integration

ℹ️ About the Project • ⭐️ Features • ⚙ ️Setup • 👏🏻 Contributing • 🛠 Stack Tech • 🙏 Special Thanks

ℹ️ About the Project

This Home Assistant app allows to integrate EnOcean devices using MQTT integration.

⭐️ Features

1. Compatibility

100+ devices supported

2. Pairing

Pair devices from Home Assistant

3. Versatile architecture

Add your own device compatibility

⚙ ️Simple setup

Installation

To install this project, follow these steps:

Installation

1. If you don't have a MQTT broker yet, click on the below button and then Install or in Home Assistant go to Settings → Add-ons → Add-on store and install the Mosquitto broker addon.

2. Click on the below button and then Add or go back to the Add-on store, click ⋮ → Repositories, fill in
   https://github.com/ChristopheHD/HA_enoceanmqtt-addon and click Add → Close.

3. Click on the app and press Install and wait until the app is installed.

Configuration

1. Adapt the addon/enoceanmqtt.devices.sample (refer to the wiki for help) and put it to your Home Assistant /config directory. You can use the Home Assistant File Editor.
2. Go on the Configuration tab of the app
   • Indicate the location of this device file under the device_file entry (on HAOS, it would be /config/enoceanmqtt.devices).
   • Select the serial interface of your EnOcean transceiver in the list of detected serial ports. When using yaml configuration, the format is for example:

     enocean_port: /dev/ttyUSB0

   • Click Save at the bottom of the page
3. Start the app by going to Info tab and click Start

👏🏻 Contributing

We welcome contributions from the community! If you would like to contribute to this project, please follow the guidelines below.

Ways to Contribute

• Report bugs or issues by opening a new issue on our GitHub repository.
• Suggest new features or improvements by opening a new issue on our GitHub repository.
• Contribute code by forking the repository, making changes, and submitting a pull request.

For more information on how to contribute, please visit Contribution Guidelines.

🛠 Stack Tech

- A general-purpose programming language

- An open-source platform for deploying applications

- Lightweight messaging protocol

🙏 Special Thanks

Special thanks to @mak-gitdev which created this app, @embyt which created the EnOcean MQTT mapping and @kipe which created the EnOcean communication library.

---

Built with ❤️ with Document My Project