mirror of https://github.com/openhab/openhab-addons.git synced 2025-01-10 15:11:59 +01:00

History

Cody Cutrer 4cbae6f111 [mqtt.homeassistant] implement non-deprecated color inference for JSON Schema lights (#17529 ) In particular, use the color_mode attribute to tell us which color space to parse in, instead of trying to guess. Some devices will fill out attributes not-pertinent to the current color mode, and their math might be... less than optimal. Also sync color temp and color channels when the color_mode is the opposite. Signed-off-by: Cody Cutrer <cody@cutrer.us>		2024-10-11 14:56:17 +02:00
..
src	[mqtt.homeassistant] implement non-deprecated color inference for JSON Schema lights (#17529 )	2024-10-11 14:56:17 +02:00
noEmbedDependencies.profile	[mqtt.homeassistant] Use Jinjava directly (#17378 )	2024-09-09 14:54:08 +02:00
NOTICE	Fix links and NOTICE files (#9860 )	2021-01-18 21:49:06 +01:00
pom.xml	[mqtt.homeassistant] Update Jinjava to 2.7.3 (#17412 )	2024-09-23 16:57:21 +02:00
README.md	[mqtt.homeassistant] Fully implement Fan component (#17402 )	2024-09-11 22:36:43 +02:00

README.md

Home Assistant MQTT Components Binding

NOTE: This binding is provided by the MQTT binding, and therefore no explicit installation is necessary beyond installing the MQTT binding.

Devices that use Home Assistant MQTT Discovery are automatically configured with this binding. Components that share a common device.identifiers will automatically be grouped together as a single Thing. Each component will be represented as a Channel Group, with the attributes of that component being individual channels.

Discovery

Any device that publishes the component configuration under the homeassistant prefix in MQTT will have their components automatically discovered and added to the Inbox. You can also manually create a Thing, and provide the individual component topics, as well as a different discovery prefix.

Supported Components

Alarm Control Panel
Binary Sensor
Button
Camera
JSON attributes and Base64 encoding are not supported.
Climate
Cover
Device Trigger
Fan
JSON attributes are not supported.
Light
Lock
Number
Scene
Select
Sensor
JSON attributes are not supported.
Switch
Update
This is a special component, that will show up as additional properties on the Thing, and add a button on the Thing to initiate an OTA update.
Vacuum

Supported Devices

See the Home Assistant documentation for a broad list of devices that should be supported by this binding. It's not feasible to test every component from every device, so there may be issues with specific devices. Please report an issue on GitHub if you find a device that is not working as expected, and not otherwise noted as a limitation above.

ESPHome

Configure your device to connect to MQTT as described in the documentation, and make sure discovery is not set to false. Assuming you're not running Home Assistant in parallel, you should also remove any api: block in your configuration.

Tasmota

To activate Home Assistant discovery support on your Tasmota device you need to do the following:

Configuration → MQTT: You must have unique Client name and Topic (should be the default).
Configuration → Other: The Device Name will be used to identify the newly found device. And you need to enable MQTT, of course.
Console: Enter SetOption19 1.

Your Tasmota device should now show up in your inbox.