Die LG ThinQ Integration ermöglicht die Verbindung Ihrer LG ThinQ-Geräte mit Home Assistant. Diese Integration bietet umfassende Funktionen, um Ihr Smart Home-Erlebnis zu optimieren und Ihre LG-Haushaltsgeräte nahtlos in Ihre Heimautomatisierung zu integrieren.
Zu den Hauptmerkmalen dieser LG ThinQ Home Assistant Integration gehören:
- Die Steuerung von LG-Geräten als Home Assistant-Entitäten über die LG ThinQ Connect API.
Voraussetzungen für die LG ThinQ Integration
Um die LG ThinQ-Integration in Home Assistant nutzen zu können, sind einige Voraussetzungen zu beachten:
- Internetverbindung: Diese Funktion arbeitet über die LG ThinQ Cloud, weshalb eine aktive Internetverbindung zwingend erforderlich ist.
- Persönliches Zugriffstoken (PAT): Sie benötigen ein persönliches Zugriffstoken (PAT), um die LG ThinQ Connect API verwenden zu können.
Persönliches Zugriffstoken (PAT) beantragen
Ein Personal Access Token (PAT) ist entscheidend für die Authentifizierung Ihrer Home Assistant-Installation mit der LG ThinQ Cloud. Folgen Sie dieser Schritt-für-Schritt-Anleitung, um Ihr PAT zu generieren:
- Besuchen Sie die Seite für das persönliche Zugriffstoken. Hierfür ist ein LG ThinQ-Konto erforderlich.
- Wählen Sie ADD NEW TOKEN (Neues Token hinzufügen).
- Geben Sie einen Namen für Ihr neues Token ein und wählen Sie die folgenden Berechtigungen (Authorized Scopes) aus:
- Permission to view all devices (Berechtigung zum Anzeigen aller Geräte)
- Permission to view all device statuses (Berechtigung zum Anzeigen aller Gerätestatus)
- All device control rights (Alle Gerätesteuerungsrechte)
- All device event subscription rights (Alle Rechte zur Geräteereignis-Abonnierung)
- All device push notification permissions (Alle Geräte-Push-Benachrichtigungsberechtigungen)
- Permission to inquiry device energy consumption (Berechtigung zur Abfrage des Geräteenergieverbrauchs)
- Bestätigen Sie mit CREATE TOKEN (Token erstellen).
- Nachdem alle Schritte abgeschlossen sind, wird ein PAT generiert und Ihnen angezeigt. Notieren Sie sich diesen Wert sorgfältig.
Konfiguration der LG ThinQ Integration
Die Integration des LG ThinQ Hubs in Ihre Home Assistant-Instanz ist unkompliziert. Sie haben die Wahl zwischen der automatischen Erkennung oder einer manuellen Konfiguration.
[Die LG ThinQ Integration kann von Home Assistant automatisch erkannt werden. Wenn eine Instanz gefunden wird, erscheint sie als Entdeckt und kann sofort eingerichtet werden.
Manuelle Konfigurationsschritte
Falls die Integration nicht automatisch entdeckt wurde, können Sie sie manuell hinzufügen:
- Navigieren Sie zu Ihrer Home Assistant-Instanz.
- Gehen Sie zu Einstellungen > Geräte & Dienste.
- Wählen Sie in der unteren rechten Ecke die Schaltfläche Integration hinzufügen.
- Wählen Sie aus der Liste LG ThinQ.
- Folgen Sie den Anweisungen auf dem Bildschirm, um die Einrichtung abzuschließen.
Bei der manuellen Konfiguration müssen Sie folgende Informationen eingeben:
- Den Token Value, den Sie während des PAT-Generierungsprozesses erhalten haben (erforderlich).
- Den Namen des Eintrags.
- Wählen Sie die entsprechende Region (Land) aus.
Unterstützte LG ThinQ Geräte
Die LG ThinQ Integration unterstützt eine breite Palette von LG-Haushaltsgeräten, die als Home Assistant-Entitäten gesteuert werden können:
- Klimaanlagen (Air Conditioner)
- Luftreiniger (Air Purifier)
- Luftreiniger-Ventilatoren (Air Purifier Fan)
- Deckenventilatoren (Ceiling Fan)
- Kochfelder (Cooktop)
- Luftentfeuchter (Dehumidifier)
- Geschirrspüler (Dishwasher)
- Trockner (Dryer)
- Heimbrauanlagen (Home Brew)
- Dunstabzugshauben (Hood)
- Luftbefeuchter (Humidifier)
- Kimchi-Kühlschränke (Kimchi Refrigerator)
- Mikrowellen (Microwave Oven)
- Backöfen (Oven)
- Pflanzenzüchter (Plant Cultivator)
- Kühlschränke (Refrigerator)
- Saugroboter (Robot Cleaner)
- Stabstaubsauger (Stick Cleaner)
- Styler (Kleiderpflegesysteme)
- Systemkessel (System Boiler)
- Wasch-Trockner-Kombinationen (Washcombo Main, Washcombo Mini)
- Waschmaschinen (Washer)
- Waschtürme (Washtower, Washtower Dryer, Washtower Washer)
- Warmwasserbereiter (Water Heater)
- Wasserfilter (Water Purifier)
- Weinkühlschränke (Wine Cellar)
- Ventilatoren (Ventilator)
Datenaktualisierungen und Energieverbrauch
Die LG ThinQ Integration bietet detaillierte Informationen über den Status Ihrer Geräte und deren Energieverbrauch:
- Statusaktualisierungen: Bei einer Statusänderung des Geräts werden Ereignisse gesendet. Bei älteren Gerätemodellen (Legacy) werden Ereignisse alle 5 Minuten gesendet, da Statusänderungen nicht in Echtzeit aggregiert werden können.
- Energieverbrauch: Aggregierte Nutzungsdaten bis zum Vortag werden jeden Morgen aktualisiert.
Sensoren für den Energieverbrauch
Die Integration unterstützt historische Energieverbrauchssensoren für einzelne Geräte:
- Energie letzten Monat (Wh): Zeigt den Energieverbrauch des letzten Monats an.
- Energie diesen Monat (Wh): Zeigt den Energieverbrauch des aktuellen Monats an.
- Energie gestern (Wh): Zeigt den Energieverbrauch des Vortages an.
Plattformen: Entitäten in Home Assistant
LG ThinQ stellt Geräte als eine Reihe von Eigenschaften dar, die in Home Assistant Entitäten zugeordnet werden. Hier ist eine Liste aller Entitätsplattformen, die von der LG ThinQ Integration bereitgestellt werden:
Binärsensor (Binary Sensor)
Eine schreibgeschützte Eigenschaft mit nur zwei Zuständen, die umgeschaltet werden können, wird als Binärsensor-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Kochfeld | Fernstart |
| Geschirrspüler | Klingelton, Reinigungsanzeige, Tür, Maschinenreinigungserinnerung, Fernstart, Nachfüllen Spülmittel erforderlich |
| Dunstabzugshaube | Leistung |
| Backofen | Fernstart |
| Kühlschrank | Tür, Umweltfreundlich, Energiesparmodus, Sabbat |
| Kimchi Kühlschrank | Frischluftfilter |
| Trockner, Styler, Waschmaschine, Washcombo Main, Washcombo Mini, Waschturm, Waschturm Trockner, Waschturm Waschmaschine | Fernstart |
| Warmwasserbereiter | Leistung |
| Weinkühlschrank | Sabbat |
Schaltfläche (Button)
Eine beschreibbare Eigenschaft mit nur zwei Zuständen, die umgeschaltet werden können, wird als Binärsensor-Plattform dargestellt.
| Gerät | Eigenschaft | Aktion |
|---|---|---|
| Geschirrspüler | Betrieb | Starten / Pause |
| Trockner, Styler, Waschmaschine, Washcombo Main, Washcombo Mini, Waschturm, Waschturm Trockner, Waschturm Waschmaschine | Betrieb | Starten / Pause |
Klima (Climate)
Eigenschaften zur Steuerung von Temperatur und Windstärke des Geräts werden als Klima-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Klimaanlage | Aktuelle Temperatur, Lüftermodus, Schwenkmodus, Horizontaler Schwenkmodus, HVAC-Modus, Voreingestellter Modus, Temperatur, Kühltemperatur, Heiztemperatur, Einheit |
| Systemkessel | Aktuelle Temperatur, HVAC-Modus, Temperatur, Kühltemperatur, Heiztemperatur, Einheit |
Ereignis (Event)
Eine vom Server gesendete Benachrichtigungsnachricht wird als Ereignis-Plattform dargestellt. Die Benachrichtigungscodes zeigen den vollständigen Support-Umfang, und Sie können den Umfang Ihres Geräts über die Entwicklertools überprüfen.
| Gerät | Eigenschaft | Benachrichtigungscodes |
|---|---|---|
| Klimaanlage | Benachrichtigung | water_is_full |
| Luftreiniger | Benachrichtigung | lack_of_water, time_to_clean_filter, pollution_is_high, time_to_change_filter |
| Luftreiniger-Ventilator | Benachrichtigung | time_to_change_filter |
| Luftentfeuchter | Benachrichtigung | water_is_full |
| Geschirrspüler | Fehler, Benachrichtigung | cleaning_is_complete, error_during_cleaning, water_leak_has_occurred, rinse_is_not_enough, salt_refill_is_needed |
| Luftbefeuchter | Benachrichtigung | time_to_change_filter, lack_of_water |
| Kimchi Kühlschrank | Benachrichtigung | door_is_open |
| Mikrowelle | Benachrichtigung | keine |
| Backofen | Benachrichtigung | preheating_is_complete, cooking_is_complete, time_to_clean, error_has_occurred |
| Kühlschrank | Benachrichtigung | time_to_change_filter, time_to_change_water_filter, frozen_is_complete, door_is_open |
| Saugroboter | Fehler, Benachrichtigung | – |
| Stabstaubsauger | Benachrichtigung | charging_is_complete, time_to_clean_filter |
| Waschmaschine, Trockner, Washcombo Main, Washcombo Mini, Waschturm, Waschturm Trockner, Waschturm Waschmaschine | Fehler, Benachrichtigung | washing_is_complete, error_during_washing, drying_is_complete, drying_failed |
| Styler | Fehler, Benachrichtigung | styling_is_complete, error_has_occurred |
| Weinkühlschrank | Benachrichtigung | door_is_open |
Ventilator (Fan)
Eigenschaften zur Steuerung der Windstärke des Geräts werden als Ventilator-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Deckenventilator | Leistung, Geschwindigkeit |
Luftbefeuchter (Humidifier)
Eigenschaften zur Steuerung der Zielfeuchtigkeit des Geräts werden als Luftbefeuchter-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Luftentfeuchter | Leistung, Modus, Zielfeuchtigkeit |
| Luftbefeuchter | Leistung, Modus, Zielfeuchtigkeit |
Zahl (Number)
Eine schreib-/lesbare Eigenschaft mit einem numerischen Wert wird als Zahl-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Klimaanlage | Zeitplan Ausschalten, Zeitplan Einschalten, Sleep Timer |
| Luftreiniger-Ventilator | Sleep Timer, Windtemperatur |
| Dunstabzugshaube | Ventilator, Licht |
| Luftbefeuchter | Sleep Timer, Zielfeuchtigkeit |
| Mikrowelle | Ventilator, Licht |
| Backofen | Temperatur |
| Kühlschrank | Temperatur |
| Trockner, Styler, Waschmaschine, Washcombo Main, Washcombo Mini, Waschturm, Waschturm Trockner, Waschturm Waschmaschine | Verzögerter Start/Ende |
| Warmwasserbereiter | Temperatur |
| Weinkühlschrank | Licht, Temperatur |
| Ventilator | Sleep Timer |
Auswahl (Select)
Eine beschreibbare Eigenschaft mit einer Liste von wählbaren Werten wird als Auswahl-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Klimaanlage | Luftreinigung, Luftqualitätssensor |
| Luftreiniger | Betriebsmodus, Geschwindigkeit |
| Luftreiniger-Ventilator | Displayhelligkeit, Betriebsmodus, Rotation, Geschwindigkeit |
| Luftentfeuchter | Geschwindigkeit, Betrieb |
| Geschirrspüler | Betrieb |
| Luftbefeuchter | Displayhelligkeit, Trocknungsmodus, Betriebsmodus, Geschwindigkeit |
| Backofen | Kochmodus, Betrieb |
| Kühlschrank | Frischluftfilter |
| Trockner, Styler, Waschmaschine, Washcombo Main, Washcombo Mini, Waschturm, Waschturm Trockner, Waschturm Waschmaschine | Betrieb |
| Warmwasserbereiter | Betriebsmodus |
| Weinkühlschrank | Licht, Betriebsmodus |
| Ventilator | Geschwindigkeit, Betriebsmodus |
Schalter (Switch)
Eine schreib-/lesbare Eigenschaft mit nur zwei Zuständen, die umgeschaltet werden können, wird als Schalter-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Klimaanlage | Leistung, Beleuchtung, Energiesparen, Luftreinigung |
| Luftreiniger | Leistung |
| Luftreiniger-Ventilator | Heizung, Leistung, UVnano |
| Luftentfeuchter | Leistung |
| Geschirrspüler | Leistung |
| Trockner, Styler, Waschmaschine, Washcombo Main, Washcombo Mini, Waschturm, Waschturm Trockner, Waschturm Waschmaschine | Leistung |
| Luftbefeuchter | Automodus, Heizung, Stimmungslicht, Leistung, Schlafmodus |
| Kühlschrank | Express-Modus, Express-Kühlung, Schnellgefrieren |
| Systemkessel | Leistung, Warmwasser |
| Weinkühlschrank | Belüftung |
| Ventilator | Leistung |
Staubsauger (Vacuum)
Eigenschaften zur Steuerung des Reinigungsbetriebs des Geräts werden als Staubsauger-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Saugroboter | Batterie, Aktueller Status, Betrieb |
Warmwasserbereiter (Water heater)
Eigenschaften zur Steuerung des Betriebsmodus und der Temperatur werden als Warmwasserbereiter-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Warmwasserbereiter | Modus, Aktuelle Temperatur, Temperatur |
Sensor (Sensor)
Eine schreibgeschützte Eigenschaft mit Zuständen wird als Sensor-Plattform dargestellt.
| Gerät | Eigenschaft |
|---|---|
| Klimaanlage | Filterrest, Luftfeuchtigkeit, Geruch, Gesamte Luftqualität, PM1, PM10, PM2.5, Zeitplan Ausschalten, Zeitplan Einschalten, Sleep Timer |
| Luftreiniger | Luftfeuchtigkeit, Geruch, Betriebsmodus, Gesamte Luftqualität, Persönlicher Modus, PM1, PM10, PM2.5, Filterrest, Zeitplan Ausschalten, Zeitplan Einschalten |
| Luftreiniger-Ventilator | Luftfeuchtigkeit, Geruch, Gesamte Luftqualität, PM1, PM10, PM2.5, Sleep Timer, Temperatur, Zeitplan Ausschalten, Zeitplan Einschalten |
| Kochfeld | Aktueller Status, Leistungsstufe, Restzeit |
| Luftentfeuchter | Luftfeuchtigkeit, Betriebsmodus |
| Geschirrspüler | Aktueller Zyklus, Aktueller Status, Spülmittelstand, Enthärtungsstufe, Verzögerter Start, Restzeit, Gesamtzeit |
| Heimbrauanlage | Braudauer, Brauperiode, Aktueller Status, Erster Geschmack, Zweiter Geschmack, Hausbraurezept, Erster Hopfen, Zweiter Hopfen, Rezeptfortschritt, Würze, Hefe |
| Luftbefeuchter | Luftfeuchtigkeit, Gesamte Luftqualität, PM1, PM10, PM2.5, Zeitplan Ausschalten, Zeitplan Einschalten, Sleep Timer, Temperatur |
| Kimchi Kühlschrank | Frischluftfilter, Temperatur |
| Mikrowelle | Aktueller Status |
| Backofen | Aktueller Status, Temperatur |
| Pflanzenzüchter | Aktueller Status, Tageswachstumstemperatur, Beleuchtungsdauer, Beleuchtungsintensität, Beleuchtungszeiten an, Modus, Nachtwachstumstemperatur, Temperatur, Windgeschwindigkeit |
| Kühlschrank | Frischluftfilter, Wasserfilter benutzt |
| Saugroboter | Aktueller Status, Betriebsmodus, Laufzeit |
| Stabstaubsauger | Batterie, Aktueller Status, Betriebsmodus |
| Systemkessel | Innentemperatur, Einlasstemperatur, Auslasstemperatur |
| Wasserfilter | Hochtemperatursterilisation, Typ, UVnano |
| Trockner, Styler, Waschmaschine, Washcombo Main, Washcombo Mini, Waschturm, Waschturm Trockner, Waschturm Waschmaschine | Aktueller Status, Verzögerter Start/Ende, Restzeit, Gesamtzeit, Zyklen |
| Ventilator | Kohlendioxid, PM1, PM10, PM2.5, Sleep Timer, Temperatur, Zeitplan Ausschalten, Zeitplan Einschalten |
Beispiel für eine Automatisierung
Automatisierungen sind ein Kernstück von Home Assistant. Hier ist ein Beispiel, wie Sie auf ein Ereignis von einem LG ThinQ-Gerät reagieren können:
- Anleitung: Automatisierung bei Ereignissen
- Wichtig: Schritte 3 und 4 der Anleitung beachten.
- Sie können die gewünschte Zustandsänderung, die als Auslöser dienen soll, in Schritt 4 auswählen.