Skip to content

Normal Usage

mak-gitdev edited this page Oct 26, 2023 · 2 revisions

HA_enoceanmqtt is just an Home Assistant overlay for enoceanmqtt.
This overlay is in charge of automatically creating and managing your devices using MQTT devices in Home Assistant.
At startup, all specified devices are created or updated in Home Assistant such that you can directly interact with the device.
Your devices will be available in Home Assistant under the MQTT integration's devices and entities.

For enoceanmqtt to handle your device, you have to manually declare it in your configuration file or device configuration file for addon users.
For that, adapt the example file (addon example file, standalone example file, docker example file).

[<your_device_name>]
address = <your_device_address>
rorg = <your_device_rorg>
func = <your_device_func>
type = <your_device_type>

Your device name shall contain neither spaces nor special characters, with the exception of _, - and /.
Tip: You can use / in your device name, e.g. [lights/livingroom], to group your devices by type when exploring MQTT messages. The / character will be converted to _ in the device name reported in Home Assistant (lights_livingroom).

Refer to Finding your device ID to know how to find your device address.