Dein erstes Gerät hinzufügen

Wie funktioniert das Hinzufügen?

Geräte werden in Home Assistant über Integrationen hinzugefügt. Eine Integration ist ein Plugin, das die Verbindung zu einem Gerät oder Dienst herstellt und die Kommunikation zwischen Home Assistant und dem Gerät übersetzt.

Stell dir eine Integration wie einen Dolmetscher vor: Dein Shelly Plug spricht „HTTP/CoAP", dein Zigbee-Sensor spricht „Zigbee" — die Integration übersetzt alles in die einheitliche HA-Sprache aus Entities, Services und Events.

1. Gerät einrichten
2. Erkennung
3. Integration
4. Entities
5. Dashboard

Wenn du ein Gerät hinzufügst, passiert Folgendes:

• Home Assistant erkennt oder findet das Gerät über die Integration
• Es werden Entities erstellt — die einzelnen Datenpunkte (Schalter, Stromverbrauch, Temperatur)
• Die Entities erscheinen im Dashboard und können in Automationen verwendet werden
• Optional: Du weist das Gerät einem Raum (Area) zu

Hinweis: Viele Geräte (Shelly, Philips Hue, Sonos) werden automatisch erkannt und erscheinen unter Einstellungen → Geräte & Dienste → Entdeckt. Bei anderen (z.B. MQTT-Geräten) musst du die Integration manuell hinzufügen und die IP-Adresse eingeben.

Was sind Entities?

Entities sind das zentrale Konzept in Home Assistant. Jedes Gerät wird in einzelne Datenpunkte aufgeteilt. Ein Shelly Plug hat z.B. 4 Entities: Schalter, Leistung, Energie, Temperatur.

Stell dir ein Auto als Gerät vor: Es hätte Entities für Kilometerstand (Sensor), Türschloss (Lock), Klimaanlage (Climate), Tankfüllung (Sensor) und Licht (Light) — jede Entity steuert oder misst genau einen Aspekt.

Hinweis: Jede Entity hat eine eindeutige ID im Format domain.name, z.B. switch.shelly_plug_relay. Die Domain (switch, sensor, light) bestimmt den Typ. Der Name wird automatisch vergeben, kann aber angepasst werden.

Wichtige Entity-Typen

Entity-Attribute verstehen

Jede Entity hat neben dem Zustand (State) auch Attribute — zusätzliche Daten:

1# Beispiel: Attribute eines Shelly Plug
2# Entity: switch.shelly_plug_relay
3# State: on
4
5# Attribute:
6device_class: outlet
7friendly_name: "Stehlampe Wohnzimmer"
8icon: mdi:power-plug
9
10# Entity: sensor.shelly_plug_power
11# State: 42.3
12
13# Attribute:
14device_class: power
15unit_of_measurement: "W"
16state_class: measurement
17
18# Zugriff in Templates:
19# {{ state_attr('switch.shelly_plug_relay', 'friendly_name') }}
20# {{ states('sensor.shelly_plug_power') }}

Entity-Zustände und deren Bedeutung

Entities haben immer einen State — aber nicht alle States sind gleich:

Hinweis: unavailable bedeutet, HA kann das Gerät nicht erreichen (Netzwerkproblem). unknown bedeutet, HA hat noch keinen Wert erhalten (z.B. nach Neustart). Beides sind keine normalen Zustände — prüfe die Verbindung!

Beispiel: Shelly Plug hinzufügen

Ein Shelly Plug ist eine smarte Steckdose, die über WLAN arbeitet. Sie misst den Stromverbrauch und kann per Fernsteuerung ein-/ausgeschaltet werden.

Vorteile:

• Lokale Steuerung ohne Cloud
• Energiemessung integriert
• Automatische Erkennung in HA
• Günstiger Preis (ca. 15 EUR)
• Kompaktes Design
• REST API und MQTT möglich

Nachteile:

• Benötigt WLAN (kein Zigbee/Z-Wave)
• Maximale Belastung beachten (2500W)
• Kein Thread/Matter-Support (ältere Modelle)

Schritt 1: Gerät im Netzwerk einrichten

1. Shelly Plug einstecken — Stecke den Shelly Plug in eine Steckdose. Die LED blinkt blau/rot.
2. Mit Shelly-WLAN verbinden — Der Plug erstellt ein eigenes WLAN: shellyplug-XXXXX. Verbinde dich damit.
3. WLAN konfigurieren — Öffne http://192.168.33.1 und gib dein Heim-WLAN und Passwort ein.
4. Neustart abwarten — Der Plug verbindet sich mit deinem WLAN und bekommt eine IP-Adresse.

Hinweis: Vergib dem Shelly eine feste IP-Adresse in deinem Router (DHCP-Reservierung). So ändert sich die IP nie und HA verliert nicht die Verbindung. Das gilt für alle WLAN-Geräte!

Hinweis: Du kannst die Shelly App (iOS/Android) für die Ersteinrichtung nutzen — sie findet den Plug automatisch und führt durch die WLAN-Konfiguration. Danach übernimmt Home Assistant.

Schritt 2: Integration hinzufügen

• Gehe zu Einstellungen, Geräte & Dienste
• Home Assistant zeigt den Shelly möglicherweise bereits unter Entdeckt an
• Falls nicht: Klicke auf + Integration hinzufügen und suche nach Shelly
• Gib die IP-Adresse des Shelly ein (findest du in deinem Router oder der Shelly App)
• Klicke auf Absenden — fertig!

Schritt 3: Entities verstehen

Nach dem Hinzufügen erstellt Home Assistant automatisch mehrere Entities:

Schritt 4: Im Dashboard steuern

Die Entities erscheinen automatisch in der Übersicht. Du kannst die Steckdose direkt ein- und ausschalten.

Hinweis: Weise das Gerät einem Raum zu: Einstellungen, Geräte & Dienste, Shelly Plug, Bereich. So wird es im Dashboard automatisch gruppiert.

Beispiel 2: Philips Hue Lampen hinzufügen

Philips Hue ist eines der beliebtesten Smart-Lighting-Systeme. Es benötigt eine Hue Bridge (Steuerungszentrale), die die Zigbee-Lampen verwaltet.

1. Hue Bridge anschließen — Bridge per Ethernet mit dem Router verbinden und einschalten
2. HA erkennt die Bridge — HA zeigt die Hue Bridge automatisch unter Entdeckt an
3. Bridge-Button drücken — Drücke den großen runden Button auf der Hue Bridge zur Autorisierung
4. Räume zuweisen — Die Lampen werden automatisch importiert — weise sie HA-Räumen zu

Nach der Einrichtung bekommst du Entities für jede Lampe:

1# Hue Lampen-Entities
2# Jede Hue Lampe erstellt diese Entities:
3light.wohnzimmer_decke            # Licht ein/aus/dimmen/Farbe
4sensor.wohnzimmer_decke_battery   # Akku (bei Hue Motion)
5
6# Services die du nutzen kannst:
7light.turn_on:
8  entity_id: light.wohnzimmer_decke
9  brightness_pct: 80              # Helligkeit 0-100%
10  color_temp_kelvin: 3000         # Farbtemperatur
11  transition: 2                   # Übergang in Sekunden
12  
13light.turn_on:
14  entity_id: light.wohnzimmer_decke
15  rgb_color: [255, 120, 50]       # RGB-Farbe
16  
17# Alle Hue-Lampen in einem Raum:
18light.turn_on:
19  target:
20area_id: wohnzimmer           # Alle Lichter im WZ

Hinweis: Wenn du bereits Szenen in der Hue App erstellt hast, importiert HA diese automatisch als scene.hue_* Entities. Du kannst sie direkt in Automationen verwenden!

Beispiel 3: Aqara Zigbee-Sensor hinzufügen

Aqara-Sensoren sind günstige Zigbee-Geräte für Temperatur, Tür/Fenster und Bewegung. Sie benötigen einen Zigbee-Koordinator (USB-Stick).

1. Zigbee-Stick anschließen — Sonoff ZBDongle-E oder ConBee III über USB-Verlängerung einstecken
2. ZHA Integration hinzufügen — Einstellungen, Geräte & Dienste, + Integration, ZHA suchen
3. Sensor pairen — In ZHA: Gerät hinzufügen, dann Reset-Button am Sensor 5 Sek. drücken
4. Entity nutzen — Temperatur, Luftfeuchtigkeit und Druck erscheinen als Sensor-Entities

Ein Aqara Temperature/Humidity Sensor erstellt folgende Entities:

Weitere beliebte Erstgeräte

Neben dem Shelly Plug sind diese Geräte ideal für Einsteiger:

• Philips Hue Starter Kit — 2-3 Lampen + Bridge. Sofortige Farb- und Helligkeitssteuerung. Ca. 80 EUR
• Aqara Temperatur-Sensor — Zigbee-Sensor für Temperatur & Luftfeuchtigkeit. Klein, günstig (ca. 12 EUR). Braucht Zigbee-Stick.
• Aqara Tür-/Fenstersensor — Erkennt ob Türen/Fenster offen sind. Perfekt für Automationen. Ca. 10 EUR
• IKEA TRADFRI Fernbedienung — Zigbee-Fernbedienung. 5 Tasten, frei belegbar in HA. Ca. 8 EUR
• TP-Link Tapo Kamera — Günstige WLAN-Kamera mit HA-Integration. Livestream im Dashboard. Ca. 25 EUR
• SONOFF SNZB Sensoren — Günstige Zigbee-Sensoren: Temperatur, Tür/Fenster, Bewegung. Ab 8 EUR

Geräte nach Protokoll

Helfer-Entities erstellen

Neben physischen Geräten kannst du Helfer-Entities erstellen — virtuelle Schalter, Zähler und Eingabefelder für deine Automationen:

1# Helfer in Automationen nutzen
2# Helfer erstellen: Einstellungen > Geräte & Dienste > Helfer > + Helfer
3
4# Beispiel: Urlaubsmodus als input_boolean
5# Entity: input_boolean.urlaubsmodus
6
7# Automation: Anwesenheitssimulation im Urlaub
8automation:
9  - alias: "Urlaubslicht Simulation"
10trigger:
11  - platform: time_pattern
12    minutes: "/45"
13condition:
14  - condition: state
15    entity_id: input_boolean.urlaubsmodus
16    state: "on"
17  - condition: sun
18    after: sunset
19action:
20  - service: light.toggle
21    target:
22      entity_id: >
23        {{ ['light.wohnzimmer', 'light.kueche', 
24            'light.schlafzimmer'] | random }}
25
26# Beispiel: Wunschtemperatur als input_number
27# Entity: input_number.wunschtemperatur (min: 16, max: 25, step: 0.5)
28
29automation:
30  - alias: "Heizung auf Wunschtemperatur"
31trigger:
32  - platform: state
33    entity_id: input_number.wunschtemperatur
34action:
35  - service: climate.set_temperature
36    target:
37      entity_id: climate.wohnzimmer
38    data:
39      temperature: "{{ states('input_number.wunschtemperatur') | float }}"

In einer Automation verwenden

Sobald ein Gerät eingerichtet ist, kannst du es in Automationen nutzen. Hier sind praktische Beispiele:

Beispiel 1: Shelly Plug um 23:00 Uhr ausschalten

1# Automation: Zeitgesteuert ausschalten
2automation:
3  - alias: "Shelly Plug nachts ausschalten"
4trigger:
5  - platform: time
6    at: "23:00:00"
7action:
8  - service: switch.turn_off
9    target:
10      entity_id: switch.shelly_plug_relay

Beispiel 2: Benachrichtigung bei hohem Stromverbrauch

1# Automation: Stromverbrauch-Alarm
2automation:
3  - alias: "Warnung bei hohem Verbrauch"
4trigger:
5  - platform: numeric_state
6    entity_id: sensor.shelly_plug_power
7    above: 2000
8    for: "00:01:00"
9action:
10  - service: notify.mobile_app_mein_handy
11    data:
12      title: "Hoher Stromverbrauch!"
13      message: >
14        Der Shelly Plug verbraucht aktuell 
15        {{ states('sensor.shelly_plug_power') }} Watt.

Beispiel 3: Standby-Erkennung (Waschmaschine fertig)

1# Automation: Standby erkennen
2automation:
3  - alias: "Waschmaschine fertig"
4trigger:
5  - platform: numeric_state
6    entity_id: sensor.shelly_plug_power
7    below: 5
8    for: "00:03:00"
9condition:
10  - condition: numeric_state
11    entity_id: sensor.shelly_plug_energy
12    above: 0.1
13action:
14  - service: notify.mobile_app_mein_handy
15    data:
16      title: "Waschmaschine fertig!"
17      message: "Die Wäsche kann aufgehängt werden."
18  - service: tts.speak
19    target:
20      entity_id: tts.piper
21    data:
22      media_player_entity_id: media_player.wohnzimmer
23      message: "Die Waschmaschine ist fertig!"

Beispiel 4: Stehlampe bei Sonnenuntergang

1# Automation: Zeitfenster
2automation:
3  - alias: "Stehlampe Zeitfenster"
4trigger:
5  - platform: sun
6    event: sunset
7    offset: "-00:30:00"
8action:
9  - service: switch.turn_on
10    target:
11      entity_id: switch.shelly_plug_relay
12  - delay: "04:00:00"
13  - service: switch.turn_off
14    target:
15      entity_id: switch.shelly_plug_relay

Beispiel 5: Gerät nur bei Anwesenheit einschalten

1# Automation: Anwesenheitsbasiert
2automation:
3  - alias: "Ventilator nur wenn jemand zuhause"
4trigger:
5  - platform: state
6    entity_id: person.max
7    to: "home"
8condition:
9  - condition: numeric_state
10    entity_id: sensor.wohnzimmer_temperatur
11    above: 25
12action:
13  - service: switch.turn_on
14    target:
15      entity_id: switch.ventilator
16      
17  - alias: "Ventilator aus wenn niemand zuhause"
18trigger:
19  - platform: state
20    entity_id: zone.home
21    to: "0"       # Niemand mehr in der Home-Zone
22action:
23  - service: switch.turn_off
24    target:
25      entity_id: switch.ventilator

Beispiel 6: Hue Lampe adaptiv steuern

1# Automation: Adaptive Beleuchtung
2automation:
3  - alias: "Wohnzimmer Licht adaptiv"
4trigger:
5  - platform: state
6    entity_id: binary_sensor.wohnzimmer_bewegung
7    to: "on"
8condition:
9  - condition: sun
10    after: sunset
11action:
12  - service: light.turn_on
13    target:
14      entity_id: light.wohnzimmer_decke
15    data:
16      # Farbtemperatur und Helligkeit je nach Uhrzeit
17      brightness_pct: >
18        {% set hour = now().hour %}
19        {% if hour < 7 %}20
20        {% elif hour < 18 %}100
21        {% elif hour < 21 %}70
22        {% else %}30{% endif %}
23      color_temp_kelvin: >
24        {% set hour = now().hour %}
25        {% if hour < 7 %}2200
26        {% elif hour < 18 %}4500
27        {% elif hour < 21 %}3000
28        {% else %}2200{% endif %}
29      transition: 3

Beispiel 7: Tür-Sensor: Licht im Flur

1# Automation: Tür öffnet → Licht an
2automation:
3  - alias: "Flur-Licht bei Tür öffnen"
4mode: restart
5trigger:
6  - platform: state
7    entity_id: binary_sensor.haustuer
8    to: "on"
9action:
10  - service: light.turn_on
11    target:
12      entity_id: light.flur
13    data:
14      brightness_pct: >
15        {% if is_state('sun.sun', 'below_horizon') %}60
16        {% else %}100{% endif %}
17  - delay: "00:05:00"
18  - service: light.turn_off
19    target:
20      entity_id: light.flur
21    data:
22      transition: 5

Beispiel 8: Stromverbrauch als Dashboard-Karte

1# Custom Card für Stromverbrauch
2type: custom:mushroom-entity-card
3entity: sensor.shelly_plug_power
4name: Stehlampe Verbrauch
5icon: mdi:flash
6layout: horizontal
7primary_info: state
8secondary_info: last-changed
9
10# Oder als Graph:
11type: custom:mini-graph-card
12entities:
13  - entity: sensor.shelly_plug_power
14name: Leistung
15hours_to_show: 24
16line_width: 2
17show:
18  labels: true
19  points: false

Geräte-Verwaltung: Best Practices

Entities richtig organisieren

• Entities umbenennen — Kryptische Namen durch lesbare ersetzen: Einstellungen, Geräte, Entity, Zahnrad. Z.B. shelly1pm_relay → Stehlampe Wohnzimmer
• Entities deaktivieren — Unnötige Entities (RSSI, Debug, WiFi-Signal) ausschalten ohne Gerät zu entfernen — spart Datenbank-Platz
• Räume zuweisen — Geräte Räumen zuordnen für automatische Dashboard-Gruppierung und area_id in Automationen
• Feste IP vergeben — Im Router DHCP-Reservierung einrichten für stabile Verbindungen — gilt für ALLE WLAN-Geräte
• History nutzen — Verlaufsdaten ansehen: Entity anklicken, Verlauf-Tab öffnen — zeigt Änderungen über die Zeit
• Labels verwenden — Entities mit Labels taggen (Etage, Priorität, Typ) für bessere Organisation und Filterung

Entity-Benennung: Konventionen

1# Empfohlene Namensgebung
2# SCHLECHT: Automatisch generierte Namen
3# switch.shelly1pm_244cab81a2e0
4# sensor.0x00158d0001234567_temperature
5
6# GUT: Beschreibende, konsistente Namen
7# switch.stehlampe_wohnzimmer
8# sensor.temperatur_wohnzimmer
9
10# Konventionen:
11# - Deutsch oder Englisch, aber einheitlich
12# - Format: funktion_raum (z.B. licht_flur, temperatur_bad)
13# - Keine Sonderzeichen, nur a-z, 0-9, Unterstrich
14# - Raum immer am Ende für alphabetische Sortierung
15
16# Entity umbenennen:
17# Einstellungen > Geräte & Dienste > Gerät > Entity > Zahnrad
18# Dort: Entity-ID und Anzeigename ändern

Fehlerbehebung

Hinweis: Wenn ein Gerät Probleme macht: Entwicklerwerkzeuge → Zustände → Entity suchen. Dort siehst du den aktuellen State, alle Attribute und den letzten Update-Zeitpunkt. Wenn last_changed sehr alt ist, kommuniziert das Gerät nicht mehr.

Nächster Schritt: Lerne, wie du noch komplexere Automationen erstellst. Automationen & Szenen