Skip to content

LG ThinQ Binding for openHAB ​

This binding integrates the LG ThinQ cloud API with openHAB, enabling monitoring and control of several LG home appliances from both the ThinQ 1.0 and ThinQ 2.0 platforms.

It provides a standardized, robust, and officially aligned implementation following openHAB add-on guidelines.


⚠️ Compatibility Notice for Users Migrating from Unofficial or Legacy Versions ​

Migration from Non-Official or Pre-5.0 LG ThinQ Bindings ​

If you are currently using any unofficial, manually installed, or forked version of the LG ThinQ binding --- particularly any version older than 5.0 --- please be aware that direct upgrade to the official binding distributed via the openHAB Add-on Store is not supported.

Major structural changes were introduced in the official version, including:

  • Standardization and renaming of channels\
  • Reorganization of metadata\
  • New Thing IDs\
  • Updated discovery and bridge flow\
  • Conformance to openHAB's add-on development guidelines

Because of these differences, Things created by older bindings are not compatible and cannot be migrated automatically.

Required Migration Steps ​

To migrate successfully:

  1. Delete all existing LG ThinQ Things, including:

    • The LG ThinQ Bridge\
    • All discovered LG ThinQ devices
  2. Install the official LG ThinQ binding from the openHAB Add-on Store.

  3. Create a new LG ThinQ Bridge Thing using the official binding.

  4. Allow auto-discovery to detect your devices again and re-add them.

What Can Be Preserved? ​

Your Items do NOT need to be deleted.

You may:

  • Keep all existing Items\
  • Re-link each Item to its corresponding new channel once devices are rediscovered

This allows you to preserve UI pages, sitemaps, HABPanels, and automation rules.


Supported Things ​

This binding support several devices from the LG ThinQ Devices V1 & V2 line. All devices require a configured Bridge. See the table bellow:

Thing IDDevice NameVersionsSpecial FunctionsCommandsObs
air-conditioner-401Air ConditionerV1 & V2Filter and Energy MonitoringAll features in LG App, except Wind Direction
dishwasher-204Dish WasherV2NoneNoneProvide only some channels to follow the cycle
dryer-tower-222Dryer TowerV1 & V2NoneAll features in LG App (including remote start)LG has a WasherDryer Tower that is 2 in one device.
When this device is discovered by this binding, it's recognized as 2 separated devices Washer and Dryer
washer-tower-221Washer TowerV1 & V2NoneAll features in LG App (including remote start)LG has a WasherDryer Tower that is 2 in one device.
When this device is discovered by this binding, it's recognized as 2 separated devices Washer and Dryer
washer-201Washer MachineV1 & V2NoneAll features in LG App (including remote start)
dryer-202Dryer MachineV1 & V2NoneAll features in LG App (including remote start)
fridge-101RefrigeratorV1 & V2NoneAll features in LG App
heatpump-401HPHeat PumpV1 & V2NoneAll features in LG App

cloud-account Bridge ​

This binding has a Bridge responsible for discovering and registering LG Things. Thus, adding the Bridge (LGThinq GW Bridge) is the first step in configuring this Binding. The following parameters are available to configure the Bridge and to link to your LG Account as well:

Bridge ParameterLabelDescriptionObs
languageUser LanguageMore frequent languages usedIf you choose other, you can fill Manual user language (only if your language was not pre-defined in this combo
countryUser CountryMore frequent countries usedIf you choose other, you can fill Manual user country (only if your country was not pre-defined in this combo
manualLanguageManual User LanguageThe acronym for the language (PT, EN, IT, etc)
manualCountryManual User CountryThe ISO 3166-1 alpha-2 country code, e.g. GB, US, BR (use GB — not UK — for the United Kingdom; the country must match the one your LG account was created in)
usernameLG User nameThe LG user's account (normally an email)
passwordLG PasswordThe LG user's password
pollingIntervalSecPolling Discovery IntervalIt is the time (in seconds) that the bridge waits to try to fetch the devices registered to the user's account and, if it finds some new device, will show it as available to link. Please, choose a long time greater than 300 seconds.
alternativeServerAlt Gateway ServerOnly used if you have some proxy to the LG API Server or for Mock Tests

Discovery ​

This Binding has auto-discovery for the supported LG Thinq devices. Once LG Thinq Bridge has been added, LG Thinq devices linked to your account will be automatically discovered and displayed in the openHAB Inbox.

Thing Configuration ​

All the configurations are pre-defined by the discovery process. But you can customize to fine-tune the device's state polling process. See the table below:

ParameterDescriptionDefault ValueSupported Devices
pollingPeriodPowerOffSecondsSeconds to wait to the next polling when device is off. Useful to save up i/o and cpu when your device is not working. If you use only this binding to control the device, you can put higher values here.10All
pollingPeriodPowerOnSecondsSeconds to wait to the next polling for device state (dashboard channels)10All
pollingExtraInfoPeriodSecondsSeconds to wait to the next polling for Device's Extra Info (energy consumption, remaining filter, etc)60Air Conditioner and Heat Pump
pollExtraInfoOnPowerOffIf enables, extra info will be fetched in the polling process even when the device is powered off. It's not so common, since extra info are normally changed only when the device is running.OffAir Conditioner and Heat Pump

Channels ​

Air Conditioner ​

Most, but not all, LG ThinQ Air Conditioners support the following channels:

Dashboard Channels ​

channel #channeltypedescription
target-temperatureTarget TemperatureNumber:TemperatureDefines the desired target temperature for the device
current-temperatureTemperatureNumber:TemperatureRead-Only channel that indicates the current temperature informed by the device
fan-speedFan SpeedNumberThis channel let you choose the current label value for the fan speed (Low, Medium, High, Auto, etc.). These values are pre-configured in discovery time.
op-modeOperation ModeNumber (Labeled)Defines device's operation mode (Fan, Cool, Dry, etc). These values are pre-configured at discovery time.
powerPowerSwitchDefine the device's Power state.
cool-jetCool JetSwitchSwitch Cool Jet ON/OFF
auto-dryAuto DrySwitchSwitch Auto Dry ON/OFF
energy-savingEnergy SavingSwitchSwitch Energy Saving ON/OFF
fan-step-up-downFan VDirNumberDefine the fan vertical direction's mode (Off, Upper, Circular, Up, Middle Up, etc)
fan-step-left-rightFan HDirNumberDefine the fan horizontal direction's mode (Off, Lefter, Left, Circular, Right, etc)

More Information Channel ​

channel #channeltypedescription
extra-info-collectorEnable Extended Info CollectorSwitchEnable/Disable the extra information collector to update the bellow channels
current-energyCurrent EnergyNumber:EnergyThe Current Energy consumption in Kwh
remaining-filterRemaining FilterNumber:DimensionlessPercentage of the remaining filter

Heat Pump ​

LG ThinQ Heat Pump supports the following channels

Heat Pump Channels ​

channel #channeltypedescription
target-temperatureTarget TemperatureNumber:TemperatureDefines the desired target temperature for the device
min-temperatureMinimum TemperatureNumber:TemperatureMinimum temperature for the current operation mode
max-temperatureMaximum TemperatureNumber:TemperatureMaximum temperature for the current operation mode
current-temperatureTemperatureNumber:TemperatureRead-Only channel that indicates the current temperature informed by the device
op-modeOperation ModeNumber (Labeled)Defines device's operation mode (Fan, Cool, Dry, etc). These values are pre-configured at discovery time.
powerPowerSwitchDefine the device's Current Power state.
air-water-switchAir/Water SwitchSwitchSwitch the heat pump operation between Air or Water

Heat Pump More Information Channel ​

channel #channeltypedescription
extra-info-collectorEnable Extended Info CollectorSwitchEnable/Disable the extra information collector to update the bellow channels
current-energyCurrent EnergyNumber:EnergyThe Current Energy consumption in Kwh

Washer Machine ​

LG ThinQ Washer Machine supports the following channels

Washer Machine Dashboard Channels ​

channel #channeltypedescription
stateWasher StateStringGeneral State of the Washer
powerPowerSwitchDefine the device's Current Power state.
previous-statePrevious StateStringPrevious operation state reported by LG ThinQ
process-stateProcess StateStringStates of the running cycle
courseCourseStringCourse set up to work
temperature-levelTemperature LevelStringTemperature level supported by the Washer (Cold, 20, 30, 40, 50, etc.)
door-lockDoor LockSwitchDisplay if the Door is Locked.
rinseRinseStringThe Rinse set program
spinSpinStringThe Spin set option
delay-timeDelay TimeStringDelay time programmed to start the cycle
remain-timeRemaining TimeStringRemaining time to finish the course
stand-byStand By ModeSwitchIf the Washer is in stand-by-mode
rs-flagRemote StartSwitchIf the Washer is in remote start mode waiting to be remotely started
dry-levelDry LevelStringDry level set for the course
eco-hybridEco HybridStringEco hybrid drying option set for the course
steamSteamStringSteam option set for the course
pre-washPre-WashStringPre-wash option set for the course
turbo-washTurboWashStringTurboWash option set for the course
medic-rinseMedic RinseStringMedic rinse option set for the course
soil-washSoil LevelStringSoil level set for the course
steam-softenerSteam SoftenerStringSteam softener option set for the course

The channels dry-level to steam-softener only exist on V2 washers that support the option.

Washer Machine Remote Start Option ​

These channels are always present, but a remote start only works while it is enabled on the washer (rs-flag is ON).

channel #channeltypedescription
rs-start-stopRemote Start/StopSwitchON starts the washer
rs-courseCourse to RunString (Selection)Course to use for the remote start
rs-temperature-levelTemperature LevelString (Selection)Temperature for the remote start
rs-spinSpinStringSpin speed for the remote start
rs-rinseRinseStringRinse option for the remote start
rs-dry-levelDry LevelString (Selection)Dry level for the remote start
rs-eco-hybridEco HybridString (Selection)Eco hybrid option for the remote start
rs-steamSteamString (Selection)Steam option for the remote start
rs-pre-washPre-WashString (Selection)Pre-wash option for the remote start
rs-turbo-washTurboWashString (Selection)TurboWash option for the remote start
rs-medic-rinseMedic RinseString (Selection)Medic rinse option for the remote start
rs-soil-washSoil LevelString (Selection)Soil level for the remote start
rs-steam-softenerSteam SoftenerString (Selection)Steam softener option for the remote start

rs-dry-level to rs-steam-softener only exist if the washer supports setting the option for a remote start.

When remote start gets enabled on the washer, these channels take over its current settings once. After that they keep your values, also while the washer is in stand-by. Changing rs-course doesn't change the other channels. A washer in stand-by must be woken up by sending ON to stand-by before the remote start.

Dryer Machine ​

LG ThinQ Dryer Machine supports the following channels

Dryer Machine Dashboard Channels ​

channel #channeltypedescription
powerPowerSwitchDefine the device's Current Power state.
stateDryer StateStringGeneral State of the Washer
previous-statePrevious StateStringPrevious operation state reported by LG ThinQ
process-stateProcess StateStringStates of the running cycle
courseCourseStringCourse set up to work
temperature-levelTemperature LevelStringTemperature level supported by the Washer (Cold, 20, 30, 40, 50, etc.)
child-lockChild LockSwitchDisplay if the Door is Locked.
dry-levelDry Level CourseStringDry level set to work in the course
delay-timeDelay TimeStringDelay time programmed to start the cycle
remain-timeRemaining TimeStringRemaining time to finish the course
stand-byStand By ModeSwitchIf the Washer is in stand-by-mode
rs-flagRemote StartSwitchIf the Washer is in remote start mode waiting to be remotely started

Dryer Machine Remote Start Option ​

These channels are always present, but a remote start only works while it is enabled on the dryer (rs-flag is ON).

channel #channeltypedescription
rs-start-stopRemote Start/StopSwitchON starts the dryer
rs-courseCourse to RunString (Selection)Course to use for the remote start

V2 dryers also get the option channels of the washer for the options they support.

Dryer/Washer Tower ​

LG ThinQ Dryer/Washer is recognized as 2 different things: Dryer & Washer machines. Thus, for this device, follow the paragraph's for Dryer Machine and Washer Machine

Refrigerator ​

LG ThinQ Refrigerator supports the following channels

Refrigerator Dashboard Channels ​

channel #channeltypedescription
door-openDoor OpenContactAdvice if the door is opened
freezer-temperatureFreezer Set Point TemperatureNumber:TemperatureTemperature level chosen. This channel supports commands to change temperature
fridge-temperatureFridge Set Point TemperatureNumber:TemperatureTemperature level chosen. This channel supports commands to change temperature
temp-unitTemp. UnitStringTemperature Unit (°C/F). Supports command to change the unit
express-modeExpress FreezeSwitchChannel to change the express freeze function (ON/OFF/Rapid)
express-cool-modeExpress CoolSwitchChannel to switch ON/OFF express cool function
eco-friendly-modeVacationSwitchChannel to switch ON/OFF Vacation function (unit will work in eco mode)

Refrigerator More Information ​

This Channel Group is reports useful information data for the device:

channel #channeltypedescription
fresh-air-filterFresh Air FilterStringShows the Fresh Air filter status (OFF/AUTO/POWER/REPLACE)
water-filterWater FilterStringShows the filter's used months

OBS: some versions of this device can not support all the channels, depending on the model's capabilities.

Full Example ​

Example of how to configure a Thing.

Example demo.things ​

dsl
Bridge lgthinq:cloud-account:MyLGThinqBridge [ username="user@registered.com", password="cleartext-password", language="en-US", country="US", pollingIntervalSec=600] {
   Thing air-conditioner-401 myAC [ modelUrlInfo="<ac-model-url>", deviceId="<device-id>", platformType="<platform-type>", modelId="<model-id>", deviceAlias="<MyAC>" ]
}

Until now, there is no way to easily obtain the values of ac-model-url, device-id, platform-type and model-id. So, if you really need to configure the LGThinq Thing textually, I suggest you to first add it with the UI discovery process through the LG Thinq Bridge, then after, copy these properties from the Thing created and complete the textual configuration.

Here are some examples on how to map the channels to items.

Example demo.items ​

dsl
Switch               ACPower        "Power"                   <switch>  { channel="lgthinq:air-conditioner-401:myAC:dashboard#power" }
Number               ACOpMode       "Operation Mode"          <text>    { channel="lgthinq:air-conditioner-401:myAC:dashboard#op-mode" }
Number:Temperature   ACTargetTemp   "Target Temperature"      <text>    { channel="lgthinq:air-conditioner-401:myAC:dashboard#target-temperature" }
Number:Temperature   ACCurrTemp     "Temperature"             <text>    { channel="lgthinq:air-conditioner-401:myAC:dashboard#current-temperature" }
Number               ACFanSpeed     "Fan Speed"               <text>    { channel="lgthinq:air-conditioner-401:myAC:dashboard#fan-speed" }
Switch               ACCoolJet      "CoolJet"                 <switch>  { channel="lgthinq:air-conditioner-401:myAC:dashboard#cool-jet" }
Switch               ACAutoDry      "Auto Dry"                <switch>  { channel="lgthinq:air-conditioner-401:myAC:dashboard#auto-dry" }
Switch               ACEnSaving     "Energy Saving"           <switch>  { channel="lgthinq:air-conditioner-401:myAC:dashboard#emergy-saving" }
Number               ACFanVDir      "Vertical Direction"      <text>    { channel="lgthinq:air-conditioner-401:myAC:dashboard#fan-step-up-down" }

Example demo.sitemap ​

All the channels already have StateDescription for the selection Channels. So, unless you want to rename theirs into demo.items, you can simply define as Selection that the default description of the values will be displayed.

dsl

sitemap demo label="Air Conditioner"
{
    Frame label="Dashboard" {
        Switch    item=ACPower
        Selection item=ACOpMode
        Selection item=ACTargetTemp
        Text      item=ACCurrTemp
        Selection item=ACFanSpeed
        Switch    item=ACCoolJet
        Switch    item=ACAutoDry
        Switch    item=ACEnSaving
        Selection item=ACFanSpeed
    }
}