Unsere Home Assistant Integration unterstützt ausnahmslos alle Features der Haus-Bus Komponenten. Neben den Basisfunktionalitäten der Standardentitäten (z.b. LIGHT, COVER) werden Zusatzfunktionen per Services und Device Trigger angeboten, die unten auf dieser Seite ausführlich beschrieben werden.
Alle Module werden ohne jegliche Konfiguration automatisch gefunden und kommunizieren mit dem Home Assistant per LAN oder auf Wunsch per WLAN. Untereinander werden die Haus-Bus Komponenten per RS485 Bus verbunden.

Die Haus-Bus Integration wird bald im offiziellen Home Assistand Katalog aufgenommen. So lange die Zertifizierung noch läuft, kann sie mit dem Home Assistant Community Store (HACS) installiert werden. Später kann diese Custom Integration durch die offizielle Version ersetzt werden, ohne dabei Geräte oder Automations zu verlieren. Bitte die folgende Anleitung genau befolgen und falls etwas nicht funktionieren sollte, an info@haus-bus.de schreiben:

	Home Assistant Communit Store installieren (HACS) - Auf der HACS Download Seite die Installationsanweisung zur eigenen Home Assistant Variante befolgen (OS/Superwised, Container oder Core) - Bei OS/Superwised geht man einfach auf den Link und stellt unten die URL zum eigenen Home Assistant ein (z.b. http://homeassistant.local:8123) - Dann auf Installieren klicken und anschließend auf Starten - Danach Home Assistant neu starten - Dann Einstellungen -> Geräte und Dienste -> Integrationen -> Integration hinzufügen (unten rechts) -> HACS eingeben -> Alle Häkchen bestätigen -> OK wählen - Anschließend Authorisierung über Github durchführen und HACS bestätigen - Im nächsten Dialog Überspringen und abschließen wählen
	Haus-Bus als Custom Integration installieren - Links im Seitenmenü HACS wählen und dann bei den drei Punkten oben rechts -> Benutzerdefinierte Repositories - Dort https://github.com/hausbus/integration_hausbus eingeben und als Typ Integration wählen - Anschließend in der HACS Suche hausbus eingeben -> Bei den drei Punkten herunterladen wählen -> herunterladen bestätigen - Homeassisant neu starten - Dann Einstellungen -> Geräte und Dienste -> Integrationen -> Integration hinzufügen (unten rechts) -> Haus-Bus eingeben -> installieren - Anschließend sollten die Haus-Bus Geräte automatisch gefunden werden. Die Kommunikation erfolgt dabei über UDP Port 5855, welcher vom Home Assistant im Netz erreichbar sein muss. - Falls in diesem Moment keine Haus-Bus Module im Netzwerk gefunden wurden, müssen diese zunächst angeschlossen, angeschaltet und die Integration anschließend erneut hinzugefüht werden. - Im Dashboard taucht ein Button auf, mit dem eine neue Gerätesuche jederzeit gestartet werden kann.
	Debug Logs aktivieren Falls es mit der Integration Probleme geben sollte, brauchen wir Logs, die in der configuration.yaml aktiviert werden müssen: logger: default: info logs: custom_components.hausbus: debug pyhausbus: debug

Die Haus-Bus Module kommunizieren untereinander per RS485 Bus. Mindestens ein Modul fungiert als Brücke und kommuniziert mit dem Home Assistant per LAN. Es ist auch möglich mehrere Brückenmodule (z.b. für verschiedene Etagen oder Gebäude) per LAN zu verwenden.
Detailierte Informationen zur Verkabelung und möglichen Topologien findet man hier.

Detailierte Informationen zu den einzelnen Komponenten gibt es unter den folgenden Links:

	32 Kanal IO Modul für die Hutschiene
	22 Kanal IO Modul für Unterputzdose
	Multitaster mit dimmbarer Beleuchtung und Sensoren
	Haus-Bus.de Taster mit vollem Funktionumfang im Gira KNX Design
	16 Kanal 7A Relaismodul
	12 Kanal 16A Relaismodul
	8 Kanal Rollomodul
	8 Kanal 230V Dimmer
	8 Kanal DC Motorsteuerung
	Heizstabregelung für PV Überschuss
	4 Kanal 7A Relaismodul
	8 Kanal 0-10V / 1-10V IO-Modul
	2 Kanal RGB Dimmer / 6 Kanal 24V PWM Dimmer
	WLAN Steckdose zur drahtlosen Systemerweiterung
	LAN - RS485 Brückenmodul

Nachdem die Haus-Bus Module automatisch gefunden wurden, können sie intuitiv mit den normalen Home Assistant Standardfunktionen verwendet werden.
Die folgenden Detailinformationen werden nur dann benötigt, wenn auch die zusätzlichen Spezialfunktionen und Events verwendet werden sollen.
Wie bereits erwähnt, werden Spezialfunktionen, Events und Einstellmöglichkeiten in Home Assistant per Services und Device Trigger angeboten:

Services
Der Hauptsinn von Services ist es Zusatzfunktionen im Home Assistant als Automation Action anzubieten. Im Dashboard können Services auch mittels Lovelace-Karte direkt aufgerufen werden. Erfahrene Nutzer verwenden Services zudem als eine direkte Funktionsschnittstelle innerhalb von Skripten. Man findet alle Services im Frontend über Entwicklerwerkzeuge -> Aktionen. Alle Haus-Bus Dienste haben den Prefix hausbus (z.B. „hausbus.dimmer_start_ramp").

Device Trigger
Um maximale Kompatibilität und Funktionalität zu gewährleisten, werden Events von Tastern und Digitaleingängen zum Einen als Event-Entität und zum Anderen als sogenannte Device Trigger gesendet. Diese werden wiederum als Automation Auslöser (Wenn Auslöser, dann Aktion).

Infos für erfahrene Benutzer:
Die Haus-Bus Device trigger stellen sich auf dem Home Assistant Event-Bus folgendermaßen dar:

Event Typ:	hausbus_button_event
Domain:	hausbus
Device_id:	ID vom sendenden Modul
Typ:	Eventtyp (siehe Beschreibung bei Tasten/Digitaleingänge unten)
Sub Typ:	Name des konkreten Tasters oder Eingangs (z.b. Taster_1)

Beispieldarstellung eines Haus-Bus 6-fach Tasters:

Der Haus-Bus 6-fach Multitaster meldet: 6 x Tasten als Binary_Sensor- und als EventEntity 6 x Leds als Light Entity 1 x Hintergrundbeleuchtung als Light Entity 1 x Temperatursensor als Sensor Entity 1 x Helligkeitssensor als Sensor Entity 1 x Feuchtigkeitssensor als Sensor Entity 4 x Externer Eingang als Binary Sensor- und als EventEntity 4 x Externer Ausgang als Light Entity

Zusatzfunktionen per Service:

	discover_devices	Startet eine neue Gerätesuche
	reset_device	Resettet das angegebene Modul

Home Assistant Standardfunktionen: Switch Entität

Zusatzfunktionen per Service und Automation Action:

switch_off
Schaltet ein Relais mit der angegebenen Abschaltverzögerung.

	off_delay	Wenn größer als 0 konfiguriert, wird der Schalter nach der angegebenen Zeit ausgeschaltet. Wertebereich: 0–65535, Default: 0 (Keine Verzögerung)

switch_on
Schaltet ein Relais für die angegebene Dauer und mit Einschaltverzögerung.

	duration	Wenn größer als 0 konfiguriert, wird der Schalter nach dieser Zeit ausgeschaltet. Wertebereich: 0–65535, Default: 0 (Keine Verzögerung)
	on_delay	Wenn größer als 0 konfiguriert, wird der Schalter nach der angegebenen Zeit eingeschaltet. Wertebereich: 0–65535, Default: 0 (Keine Verzögerung)

switch_toggle
Schaltet ein Relais im Intervall mit den angegebenen An- und Aus-Zeiten und der Menge der Wiederholungen.

	off_time	Dauer, die das Relais im Toggle-Zeitraum aus ist. Wertebereich: 1–255, Default: 1
	on_time	Dauer, die das Relais im Toggle-Zeitraum ein ist. Wertebereich: 1–255, Default: 1
	quantity	Anzahl der Toggle-Zyklen. 0 = unendlich. Wertebereich: 1–255, Default: 0 (Dauer toggeln)

Home Assistant Standardfunktionen: Cover Entität

Zusatzkonfiguration per Service:

cover_set_configuration
Legt alle möglichen Konfigurationswerte für einen Rollo-Kanal fest.

	close_time	Dauer für vollständiges Schließen des Rollos von komplett offen bis komplett geschlossen. Wertebereich: 1–255, Default: 30
	open_time	Dauer für vollständiges Öffnen des Rollos von komplett geschlossen bis komplett offen. Wertebereich: 1–255, Default: 30
	invert_direction	Kehren die UP- und DOWN-Richtungen um. Default: False

Home Assistant Standardfunktionen: Light Entität

Zusatzfunktionen per Service und Automation Action:

dimmer_set_brightness
Schaltet einen Dimmer ein und setzt optional die Einschalt-Dauer.

	brightness	Helligkeit in Prozent (0–100 %), Default: 100 %
	duration	Einschalt-Dauer in Sekunden, Default: 0 s (Daueran)

dimmer_start_ramp
Startet eine Dimmer-Rampe in die angegebene Richtung oder wechselt zur entgegengesetzten Richtung der letzten Aktion.

	direction	Richtung der Dimmer-Rampe, Default: up up: In Richtung heller dimmen down: In Richtung dunkler dimmen toggle: Entgegengesetzt zur letzten Dimmrichtung dimmen

dimmer_stop_ramp
Stoppt eine zuvor gestartete Dimmer-Rampe.


Zusatzkonfiguration per Service:

dimmer_set_configuration
Legt alle verfügbaren Konfigurationswerte eines Dimmer-Kanals fest.

	mode	Definiert den Arbeitsmodus des Dimmers, Default: dimm_trailing_edge (Phasenabschnitt) dimm_trailing_edge: Phasenabschnittdimmer dimm_leading_edge: Phasenanschnittdimmer switch_only: Nur Schalten
	dimming_time	Zeit in 50 ms-Schritten, um von 0 % auf 100 % Helligkeit zu wechseln (1–255), Default: 12
	ramp_time	Zeit in 50 ms-Schritten für Dimmer-Rampen (1–255), Default: 60
	dimming_start_brightness	Start-Helligkeit einer Dimmaktion (0–100 %), Default: 0 %
	dimming_end_brightness	End-Helligkeit einer Dimmaktion (0–100 %), Default: 100 %

Home Assistant Standardfunktionen: Light Entität

Zusatzfunktionen per Service und Automation Action:

rgb_set_color
Schaltet eine RGB-Leuchte ein und setzt optional die Farbe und Dauer.

	brightness_red	Helligkeit für Rot in Prozent (0–100 %), Default: 100 %
	brightness_green	Helligkeit für Grün in Prozent (0–100 %), Default: 100 %
	brightness_blue	Helligkeit für Blau in Prozent (0–100 %), Default: 100 %
	duration	Einschalt-Dauer in Sekunden, Default: 0 s (Daueran)

Zusatzkonfiguration per Service:

rgb_set_configuration
Legt alle verfügbaren Konfigurationswerte eines RGB-Kanals fest.

	dimming_time	Überblendzeit (50 ms) von 0 % auf 100 % beim Setzen einer neuen Helligkeit über set_brightness. Wertebereich: 1–255, Default: 12

Home Assistant Standardfunktionen: Light Entität

Zusatzfunktionen per Service und Automation Action:

led_off
Schaltet eine LED aus und berücksichtigt optional eine Verzögerung.

	off_delay	Verzögerung in Sekunden bis zum Ausschalten, Default: 0 s (Keine Verzögerung)

led_on
Schaltet eine LED ein und berücksichtigt Helligkeit, Dauer und Einschaltverzögerung.

	brightness	Helligkeit in Prozent (0–100 %), Default: 100 %
	duration	Einschalt-Dauer in Sekunden, Default: 0 s (Daueran)
	on_delay	Verzögerung in Sekunden bis zum Einschalten, Default: 0 s (Keine Verzögerung)

led_blink
Lässt eine LED blinken mit angegebenem Muster und Anzahl der Wiederholungen.

	brightness	Helligkeit in Prozent (0–100 %), Default: 100 %
	off_time	Dauer der ausgeschalteten Phase im Blinkmuster, Wertebereich: 0–255, Default: 1
	on_time	Dauer der eingeschalteten Phase im Blinkmuster, Wertebereich: 0–255, Default: 1
	quantity	Anzahl der Blinkzyklen, 0 = unendlich, Wertebereich: 0–65535, Default: 0 (Dauerblinken)

led_set_min_brightness
Setzt eine minimale verbleibende Helligkeit, die auch nach led_off erhalten bleibt.

	min_brightness	Minimale Helligkeit in Prozent (0–100 %), Default: 0 %

Zusatzkonfiguration per Service:

led_set_configuration
Legt alle verfügbaren Konfigurationswerte eines LED-Kanals fest.

	time_base	Basiswert für Zeitparameter, Default: 1000 1000 = Sekunden 1 = Millisekunden Wertebereich: 1–65535

Home Assistant Standardfunktionen: Event Entität

Zusatzevents per Event Entität und Device Trigger:

	button_pressed	Taste wurde gedrückt oder Digitaleingang (z.b. Fensterkontakt) wurde geschlossen
	button_released	Taste wurde losgelassen oder Digitaleingang wurde geöffnet
	button_clicked	Taste wurde gedrückt und losgelassen Wird benötigt, wenn man Doppelklick und Gehalten verwenden möchte, da diese Events grundsätzlich auch button_pressed zu Begin melden
	button_double_clicked	Taste wurde doppelt geklickt
	button_hold_start	Taste wird länger gedrückt (gehalten)
	button_hold_end	Taste wurde nach längerem drücken losgelassen

Beispielanwendung zu einem Taster, der einen Dimmer ansteuert:

	button_clicked	->	Lampe an- / ausschalten
	button_hold_start	->	Dimmrampe starten (Lampe wird heller solange die Taste gehalten wird)
	button_hold_end	->	Dimmrampe stoppen (Lampe bleibt bei der erreichten Helligkeit)
	button_double_clicked	->	Vordefinierter Helligkeit einstellen (z.b. 50%)

Falls mal aber Doppelklick oder Gehalten nicht braucht, ist es besser, die Standardevents der Binärsensor Entität zu verwenden oder alternativ:

button_pressed

->

Lampe an- / ausschalten

Dadurch ist die Reaktionszeit optimal, weil das clicked Event kurz verzögert werden muss, für den Fall, dass es stattdessen ein Doppelklick oder gehalten wird.

Beispielanwendung zu einem Digitaleingang mit Schalter oder Fensterkontakt:
Für diesen Anwendungsfall sollten die Standardevents der Binärsensor Entität ausreichend und optimal, so dass keine Device Trigger benötigt werden.
Falls doch gewünscht, dann:

	button_pressed	->	Fensterkontakt wurde geschlossen
	button_released	->	Fensterkontakt wurde geöffnet

Zusatzfunktionen per Service und Automation Action:

push_button_configure_events
Deaktiviert alle Events dieses Eingangs für eine bestimmte Zeit oder aktiviert sie wieder.

	event_activation_status	Gewünschter Zustand der Eingangsevents, Default: ENABLED DISABLED: Deaktivieren aller Events ENABLED: Aktivieren aller Events INVERT: Invertieren des aktuellen Status
	disabled_duration	Events bleiben für die angegebene Zeit deaktiviert,Default: 0 (Daueraus) Wertebereich: 1–255

Zusatzkonfiguration per Service:

push_button_set_configuration
Legt alle Konfigurationsparameter für den Eingang fest.

	hold_timeout	Dauer, die ein Taster gedrückt werden muss, um button_hold_start Event zu erzeugen, Default: 100 ms Wertebereich: 1–255
	double_click_timeout	Zeitspanne, innerhalb der ein Taster erneut geklickt werden muss, um button_double_clicked Event zu erzeugen, Default: 50 ms Wertebereich: 1–255
	event_button_pressed_active	True, wenn button_pressed Event gesendet werden soll, Default: True
	event_button_released_active	True, wenn button_released Event gesendet werden soll, Default: True
	event_button_hold_start_active	True, wenn button_hold_start Event gesendet werden soll, Default: False button_clicked wird entsprechend verzögert
	event_button_hold_end_active	True, wenn button_hold_end Event gesendet werden soll, Default: False
	event_button_clicked_active	True, wenn button_clicked Event gesendet werden soll, Default: False
	event_button_double_clicked_active	True, wenn button_double_clicked Event gesendet werden soll, Default: False button_clicked wird entsprechend verzögert
	led_feedback_active	True, wenn LED des Haus-Bus-Multitasters gedrückte Taste automatisch anzeigt, Default: True
	inverted	True, wenn die Logik dieses Eingangs invertiert werden soll, Default: False
	debounce_time	Entprellzeit des Eingangs, Default: 40 ms 40: Für Taster 10: Für Signale mit hoher Frequenz Wertebereich: 1–254

Home Assistant Standardfunktionen: Sensor Entität

Zusatzkonfiguration per Service:

temperatur_sensor_set_configuration
Legt alle Konfigurationsparameter für einen Temperatursensor fest.

	correction	Korrekturwert zur Anpassung der gemeldeten Temperatur. Kann positiv oder negativ sein und wird zum gemeldeten Sensorwert addiert. Wertebereich: -10 bis 10, Schritt: 0.1, Einheit: °C, Default: -2
	auto_event_diff	Temperaturänderung, die ein neues Event auslöst. Anstelle eines festen Intervalls wird bei dieser Temperaturänderung ein Update ausgelöst. Wertebereich: 0.1–20, Schritt: 0.1, Einheit: °C, Default: 0.5
	manual_event_interval	Intervall für gemeldete Temperaturwerte, unabhängig von Temperaturänderungen, Default: 5 Minuten Optionen: 1 Sekunde, 5 Sekunden, 10 Sekunden, 30 Sekunden, 1 Minute, 5 Minuten, 10 Minuten, 20 Minuten, 30 Minuten, 60 Minuten

Home Assistant Standardfunktionen: Sensor Entität

Zusatzkonfiguration per Service:

humidity_sensor_set_configuration
Legt alle Konfigurationsparameter für einen Luftfeuchtigkeitssensor fest.

	correction	Korrekturwert zur Anpassung der gemeldeten Luftfeuchtigkeit. Kann positiv oder negativ sein und wird zum gemeldeten Sensorwert addiert. Wertebereich: -100 bis 100, Schritt: 0.1, Einheit: %, Default: 0
	auto_event_diff	Luftfeuchtigkeitsänderung, die ein neues Event auslöst. Anstelle eines festen Intervalls wird bei dieser Änderung ein Update ausgelöst. Wertebereich: 0.1–100, Schritt: 0.1, Einheit: %, Default: 1
	manual_event_interval	Intervall für gemeldete Luftfeuchtigkeitswerte, unabhängig von Änderungen, Default: 5 Minuten Optionen: 1 Sekunde, 5 Sekunden, 10 Sekunden, 30 Sekunden, 1 Minute, 5 Minuten, 10 Minuten, 20 Minuten, 30 Minuten, 60 Minuten

Home Assistant Standardfunktionen: Sensor Entität

Zusatzkonfiguration per Service:

brightness_sensor_set_configuration
Legt alle Konfigurationsparameter für einen Helligkeitssensor fest.

	correction	Korrekturwert zur Anpassung der gemeldeten Helligkeit. Kann positiv oder negativ sein und wird zum gemeldeten Sensorwert addiert. Wertebereich: -100 bis 100, Schritt: 10, Einheit: lux, Default: 0
	auto_event_diff	Helligkeitsänderung, die ein neues Event auslöst. Anstelle eines festen Intervalls wird bei dieser Änderung ein Update ausgelöst. Wertebereich: 10–100, Schritt: 10, Einheit: lux, Default: 30
	manual_event_interval	Intervall für gemeldete Helligkeitswerte, unabhängig von Änderungen, Default: 5 Minuten Optionen: 1 Sekunde, 5 Sekunden, 10 Sekunden, 30 Sekunden, 1 Minute, 5 Minuten, 10 Minuten, 20 Minuten, 30 Minuten, 60 Minuten

Home Assistant Standardfunktionen: Sensor Entität

	last_tag	Zuletzt gelesener RFID Tag
	last_time	Zeitpunkt des letzten Leservorgangs
	last_error	Letzter Fehler

Zusatzevent:

Zusätzlich wird ein Home Assistant Event gesendet, sobald ein RFID Tag gelesen wurde:

	event_typ	hausbus_rfid_event
	device_Id	Sendendes Device
	tag	Gelesener RFID Tag

Home Assistant Standardfunktionen: Sensor Entität

Zusatzkonfiguration per Service:

power_meter_sensor_set_configuration
Legt alle Konfigurationsparameter für einen Strommesssensor fest.

	correction	Korrekturwert zur Anpassung der gemeldeten Leistung. Kann positiv oder negativ sein und wird zum gemeldeten Wert addiert. Wertebereich: -100 bis 100, Schritt: 0,1, Einheit: kW, Default: 0
	auto_event_diff	Leistungsänderung, die ein neues Event auslöst. Anstelle eines festen Intervalls wird bei dieser Änderung ein Update ausgelöst. Wertebereich: 0,1–100, Schritt: 0,1, Einheit: kW, Default: 1
	manual_event_interval	Intervall für gemeldete Leistungswerte, unabhängig von Änderungen, Default: 5 Minuten Optionen: 1 Sekunde, 5 Sekunden, 10 Sekunden, 30 Sekunden, 1 Minute, 5 Minuten, 10 Minuten, 20 Minuten, 30 Minuten, 60 Minuten