LG ThinQ

LG ThinQ 集成可让您将 LG ThinQ 设备连接到 Home Assistant。此集成的功能包括：

通过 LG ThinQ Connect API 将 LG 家电作为 Home Assistant 实体进行控制。

前提条件

此功能通过 LG ThinQ 云端运行，因此需要互联网连接。
需要一个 personal access token 才能使用 LG ThinQ Connect API。

Personal Access Token (PAT)

打开 personal access token 页面（需要 LG ThinQ 账户）。
选择 ADD NEW TOKEN。
输入新的令牌名称，并选择以下授权范围：
- Permission to view all devices
- Permission to view all device statuses
- All device control rights
- All device event subscription rights
- All device push notification permissions
- Permission to inquiry device energy consumption
选择 CREATE TOKEN。
完成以上步骤后，您会看到一个已生成的 PAT。

配置

此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。

输入用于 LG ThinQ Connect API 的信息：
- 通过 PAT 签发流程获得的 Token Value（必填）
- 条目名称
选择地区（国家）。

支持的设备

家电

当前支持以下 LG 家电：

Air Conditioner
Air Purifier
Air Purifier Fan
Ceiling Fan
Cooktop
Dehumidifier
Dishwasher
Dryer
Home Brew
Hood
Humidifier
Kimchi Refrigerator
Microwave Oven
Oven
Plant Cultivator
Refrigerator
Robot Cleaner
Stick Cleaner
Styler
System Boiler
Washcombo Main
Washcombo Mini
Washer
Washtower
Washtower Dryer
Washtower Washer
Water Heater
Water Purifier
Wine Cellar
Ventilator

数据更新

状态：设备状态发生变化时会发送事件。
状态（旧版传统型号）：由于设备状态变化无法实时聚合，因此每 5 分钟发送一次事件。
能耗：截至昨天的汇总使用数据会在每天早晨更新。

能耗

支持为单个设备提供历史能耗传感器：

Energy last month (Wh)：上个月的能耗。
Energy this month (Wh)：本月的能耗。
Energy yesterday (Wh)：昨天的能耗。

平台

LG ThinQ 会将设备表示为一组属性，这些属性会映射为 Home Assistant 中的实体。

LG ThinQ 集成提供的实体平台如下：

Binary sensor
Button
Climate
Event
Fan
Humidifier
Number
Select
Sensor
Switch
Vacuum
Water heater

Binary sensor

只读且只有两个可切换状态的属性会表示为二进制传感器平台。

Device	Property
Cooktop	Remote start
Dish Washer	Chime sound Clean indicator light Door Machine clean reminder Remote start Rinse refill needed
Hood	Power
Oven	Remote start
Refrigerator	Door Eco friendly Power saving mode Sabbath
Kimchi Refrigerator	Fresh air filter
Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer	Remote start
Water Heater	Power
Wine Cellar	Sabbath

Button

A writable 且只有两个可切换状态的属性会表示为按钮平台。

Device	Property	Action
Dish Washer	Operation	Start / Pause
Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer	Operation	Start / Pause

Climate

用于同时控制设备温度和风力强度的属性会表示为 climate 平台。

Device	Property
Air Conditioner	Current temperature Fan mode Swing mode Swing horizontal mode HVAC mode Preset mode Temperature Temperature cool Temperature heat Unit
System Boiler	Current temperature HVAC mode Temperature Temperature cool Temperature heat Unit

Event

由服务器推送的通知消息会表示为 event 平台。Notification codes 显示完整支持范围，您也可以通过开发者工具查看自己设备支持的范围。

Device	Property	Notification codes
Air Conditioner	Notification	water_is_full
Air Purifier	Notification	lack_of_water, time_to_clean_filter, pollution_is_high, time_to_change_filter
Air Purifier Fan	Notification	time_to_change_filter
Dehumidifier	Notification	water_is_full
Dish Washer	Error Notification	cleaning_is_complete, error_during_cleaning, water_leak_has_occurred, rinse_is_not_enough, salt_refill_is_needed
Humidifier	Notification	time_to_change_filter, lack_of_water
Kimchi Refrigerator	Notification	door_is_open
Microwave Oven	Notification	none
Oven	Notification	preheating_is_complete, cooking_is_complete, time_to_clean, error_has_occurred
Refrigerator	Notification	time_to_change_filter, time_to_change_water_filter, frozen_is_complete, door_is_open
Robot Cleaner	Error Notification	-
Stick Cleaner	Notification	charging_is_complete, time_to_clean_filter
Washer Dryer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer	Error Notification	washing_is_complete, error_during_washing, drying_is_complete, drying_failed
Styler	Error Notification	styling_is_complete, error_has_occurred
Wine Cellar	Notification	door_is_open

Fan

用于控制设备风力强度的属性会表示为 fan 平台。

Device	Property
Ceiling Fan	Power Speed

Humidifier

用于控制设备目标湿度的属性会表示为 humidifier 平台。

Device	Property
Dehumidifier	Power Mode Target humidity
Humidifier	Power Mode Target humidity

Number

可读写且具有数值的属性会表示为 number 平台。

Device	Property
Air Conditioner	Schedule turn-off Schedule turn-on Sleep timer
Air Purifier Fan	Sleep timer Wind temperature
Hood	Fan Light
Humidifier	Sleep timer Target humidity
Microwave Oven	Fan Light
Oven	Temperature
Refrigerator	Temperature
Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer	Delayed start/end
Water Heater	Temperature
Wine Cellar	Light Temperature
Ventilator	Sleep timer

Select

可写且具有可选值列表的属性会表示为 select 平台。

Device	Property
Air Conditioner	Air purify Air quality sensor
Air Purifier	Operating mode Speed
Air Purifier Fan	Display brightness Operating mode Rotation Speed
Dehumidifier	Speed Operation
Dish Washer	Operation
Humidifier	Display brightness Drying mode Operating mode Speed
Oven	Cook mode Operation
Refrigerator	Fresh air filter
Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer	Operation
Water Heater	Operating mode
Wine Cellar	Light Operating mode
Ventilator	Speed Operating mode

Switch

可读写且只有两个可切换状态的属性会表示为 switch 平台。

Device	Property
Air Conditioner	Power Lighting Energy saving Air clean
Air Purifier	Power
Air Purifier Fan	Heating Power UVnano
Dehumidifier	Power
Dish Washer	Power
Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer	Power
Humidifier	Auto mode Heating Mood light Power Sleep mode
Refrigerator	Express mode Express cool Quick freeze
System Boiler	Power Hot water
Wine Cellar	Ventilation
Ventilator	Power

Vacuum

用于控制设备清扫操作的属性会表示为 vacuum 平台。

Device	Property
Robot Cleaner	Battery Current status Operation

Water heater

用于控制运行模式和温度的属性会表示为 water_heater 平台。

Device	Property
Water heater	Mode Current temperature Temperature

Sensor

只读且具有状态值的属性会表示为 sensor 平台。

Device	Property
Air Conditioner	Filter remaining Humidity Odor Overall air quality PM1 PM10 PM2.5 Schedule turn-off Schedule turn-on Sleep timer
Air Purifier	Humidity Odor Operating mode Overall air quality Personal mode PM1 PM10 PM2.5 Filter remaining Schedule turn-off Schedule turn-on
Air Purifier Fan	Humidity Odor Overall air quality PM1 PM10 PM2.5 Sleep timer Temperature Schedule turn-off Schedule turn-on
Cooktop	Current status Power level Remaining time
Dehumidifier	Humidity Operating mode
Dish Washer	Current cycle Current status Rinse aid dispenser level Softening level Delayed start Remaining time Total time
Home Brew	Brewing duration Brewing period Current status First flavor Second flavor Homebrew recipe First hop Second hop Recipe progress Wort Yeast
Humidifier	Humidity Overall air quality PM1 PM10 PM2.5 Schedule turn-off Schedule turn-on Sleep timer Temperature
Kimchi Refrigerator	Fresh air filter Temperature
Microwave Oven	Current status
Oven	Current status Temperature
Plant Cultivator	Current status Day growth temperature Lighting duration Lighting intensity Lights on time Mode Night growth temperature Temperature Wind speed
Refrigerator	Fresh air filter Water filter used
Robot Cleaner	Current status Operating mode Running time
Stick Cleaner	Battery Current status Operating mode
System Boiler	Indoor temperature Inlet temperature Outlet temperature
Water Purifier	High-temp sterilization Type UVnano
Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer	Current status Delayed start/end Remaining time Total time Cycles
Ventilator	Carbon dioxide PM1 PM10 PM2.5 Sleep timer Temperature Schedule turn-off Schedule turn-on

自动化示例

通知、错误事件

指南：Automating on event

重点：请查看指南中的第 3、4 步

您可以在第 4 步中选择想要作为触发器的状态变化

alias: 缺水示例
description: 当空气净化器出现 lack_of_water 时切换开关
triggers:
  - trigger: state
    entity_id:
      - event.purifier_notification
actions:
  - condition: state
    entity_id: event.purifier_notification
    attribute: event_type
    state: lack_of_water
  - type: toggle
    device_id: xxxxxxxx
    entity_id: xxxxxxxx
    domain: switch

故障排除

设置

Aborted: The token is not valid

当 Personal Access Token (PAT) 无效或输入错误时，就会出现此错误。请访问 Personal Access Token 页面检查令牌是否有效。

Aborted: The country is not supported

请在 Choose the region / Country 部分检查您的 PAT 对应的有效国家。

Error: The number of API calls has been exceeded

当使用该 PAT 发起的 API 调用次数异常过多时，就会出现此错误。等待一段时间后，LG ThinQ 集成通常会恢复正常工作。

调试 / 问题报告

启用日志配置后，LG ThinQ 集成会显示更多附加信息。

启用调试日志。
- 如果您将 Enable 切换为 Disable，日志会保存到下载文件夹。
在报告问题时：
- 提供设备配置的截图（包括设备名称、类型和实体）
- 附上调试日志
- 描述预期行为以及当前无法正常工作的部分

#LG ThinQ

#前提条件

#Personal Access Token (PAT)

#支持的设备

#家电

#数据更新

#能耗

#平台

#Binary sensor

#Button

#Climate

#Event

#Fan

#Humidifier

#Number

#Select

#Switch

#Vacuum

#Water heater

#Sensor

#自动化示例

#通知、错误事件

#故障排除

#设置

#Aborted: The token is not valid

#Aborted: The country is not supported

#Error: The number of API calls has been exceeded

#调试 / 问题报告