LG ThinQ

The LG ThinQ integration allows you to connect LG ThinQ devices to Home Assistant. The features of this integration include:

• Control LG appliances as Home Assistant entities through the LG ThinQ Connect API.

Prerequisites

• This feature works via LG ThinQ cloud. Therefore, an internet connection is required.
• A personal access token to use the LG ThinQ Connect API.

Personal Access Token (PAT)

1. Access the personal access token page (requires an LG ThinQ account).
2. Select ADD NEW TOKEN.
3. Enter a new token name and select the following authorized scopes:
   • 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
4. Select CREATE TOKEN.
5. Once all the steps are completed, you will see that a PAT has been generated.

Configuration

To add the LG ThinQ integration to your Home Assistant instance, use this My button:

1. Enter the information to use LG ThinQ Connect API:
   • The Token Value obtained through the PAT issuance process. (Required)
   • The entry name.
2. Choose the region (country).

Supported Devices

Appliance

Support LG Appliances as follows:

• 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

Platforms

LG ThinQ represents devices as a set of profiles. And these are mapped to entities in Home Assistant.

A list of all Entity Platforms provided by LG ThinQ Integration:

• Binary sensor
• Climate
• Event
• Fan
• Number
• Select
• Sensor
• Switch
• Vacuum

Binary sensor

A read-only property which has only two states that can be toggled is represented as a binary sensor platform.

Climate

The properties for controlling both the temperature and wind strength of the appliance are represented as a climate platform.

Event

A notification message pushed from the server is represented as an event platform.

Fan

The properties for controlling the wind strength of the appliance are represented as a fan platform.

Number

A read-write property which has numeric value is represented as a number platform.

Select

A writable property which has a list of selectable values is represented as a select platform.

Sensor

A read-only property which has states is represented as a sensor platform.

Switch

A read-write property which has only two states that can be toggled is represented as a switch platform.

Vacuum

The properties for controlling the clean operations of the appliance are represented as a vacuum platform.

Troubleshooting

Setup

Aborted: The token is not valid

This error occurs when the Personal Access Token (PAT) is invalid or entered incorrectly. Please visit the Personal Access Token Page page to check if your token is valid.

Aborted: The country is not supported

Check your PAT’s valid country in the Choose the region / Country section.

Error: The number of API calls has been exceeded

This error occurs when there’s an abnormal number of API calls made using the PAT. The LG ThinQ integration will work properly after some time.

Debugging

The LG ThinQ integration will show additional information by enabling log configuration. Add the line to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more]: Don’t forget to remove the line again once you are done debugging.

logger:
  default: info
  logs:
    homeassistant.components.lg_thinq: debug