Lighting

TCL Home - Unofficial

nemesa/ha-tcl-home-unofficial-integration · v3.16.0

HACSCloud polling

TCL Home - home assistant integration (unofficial)

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`light`	Light
`switch`	Switch or outlet
`climate`	Thermostat
`humidifier`	Humidifier or dehumidifier
`remote`	TV remote (activities)	Needs its own HomeKit Bridge in accessory mode
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`button`	Button (as a switch)
`select`	Mode picker (as switches)

What people report

Cloud-based TCL Home support covers split, portable, window and duct ACs plus dehumidifiers and Breeva purifiers. New device types are enabled one by one from user diagnostics.

Works11
Requested1

Device	In Home Assistant	What they said	Source
TCL Breeva Air Purifier A2	Works Cloud	Contributed by Ajsalemo Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Breeva Air Purifier A3	Works Cloud	Contributed by Ajsalemo Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Breeva Air Purifier A5	Works Cloud	Contributed by Ajsalemo Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Dehumidifier (DEM)	Works Cloud	Listed as supported Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Dehumidifier (DF)	Works Cloud	Listed as supported Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Duct AC	Works Cloud	Listed as supported Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Portable AC	Works Cloud	Listed as supported Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Split AC FMA-09CHSD/TPG11I	Works Cloud	Dual split units work after type enabled Saved copy hi @nemesa, there are no difference in app between device that is marked with "Split AC" vs device marked as "Split AC-1", all 4x devices (2x dual) are same model - FMA-09CHSD/TPG11I, and 5. device is model TAC-18CHSD/TPG11I - is also marked as "Split AC-1" for device_id: (CDzuOxFAAAE) - difference in app for this device is "Generator Mode" available in menu at first i was thinking that this "-1" marker is related to dual system - but it doesn't match devices that are paired as dual, nor it make sense for 5. device which is not dual..., im guessing maybe if you remove and re-add same device … Excerpt saved from GitHub on 2026-10-23.	Issue #15 · 2025-07
TCL Split AC Fresh air	Works Cloud	Works after re-pairing in TCL app Saved copy Yes, I just had to re-pair the device in TCL App Excerpt saved from GitHub on 2026-10-23.	Issue #51 · 2025-10
TCL Split AC TAC-18CHSD/TPG11I	Works Cloud	Standalone split AC supported Saved copy Thank you for your work on this integration - great work! i have 5 AC units, 4 of them are same model (2x Dual Split AC units): - (CDzv2BFAAAE) - (CDzxbBFAAAE) - (CFtKLxFAAAE) - (CFtLDhFAAAE) and 1 AC unit that is standalone Split AC: (different model from those 4 units above) - (CDzuOxFAAAE) devices (CFtLDhFAAAE) and (CFtKLxFAAAE) are first dual unit setup, they are detected but not setup correctly because they are missing capability=23 in capabilities list to be detected as type 1 devices (CDzv2BFAAAE) and (CDzxbBFAAAE) are second dual unit setup, they are not detected because they have … Excerpt saved from GitHub on 2026-10-23.	Issue #15 · 2025-07
TCL Window AC	Works Cloud	Listed as supported Saved copy Supported devices: Split AC; Split AC Fresh air; Portable AC; Window AC; Duct AC; Dehumidifier (DEM); Dehumidifier (DF); Breeva Air Purifier A2 (by Ajsalemo); Breeva Air Purifier A3 (by Ajsalemo); Breeva Air Purifier A5 (by Ajsalemo); Cylindrical AC (by joe-sal). Excerpt saved from the README on 2026-10-23.	README
TCL Water Heat Pump SMKLd-10D/HBp-A	Requested Cloud	Listed as not implemented; owner collecting diagnostics to add it Saved copy Hi, is there any chance to add support for TCL ATW Heat Pumps? It has support for TCL Home App Is there anything i can do to help the process? Logger: custom_components.tcl_home_unofficial Source: custom_components/tcl_home_unofficial/init.py:87 integration: TCL Home - Unofficial Setup.async_setup_entry device is not implemented by this integration: GetThingsResponseData(device_id='DJ6CHxFAAAI', platform='TCLIOT', nick_name='Living Room', device_name='ATW Heat Pump', category='AC', firmware_version='V8-R82CT20-WFMV201.1.1.20', is_online=1, room='Living Room', type=1, device_type='', … Excerpt saved from GitHub on 2026-10-23.	Issue #43 · 2025-09

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Cloud polling

Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.

Details

Installs (analytics)	828 (0.12%)
GitHub stars	104
Latest version	3.16.0 (2026-05-22)
Set up in the UI	Yes
Maintainers	@nemesa
License	MIT

Devices listed in its README

Split AC
Split AC Fresh air
Portable AC
Window AC
Duct AC
Dehumidifier (DEM)
Dehumidifier (DF)
Breeva Air Purifier A2 (by Ajsalemo)
Breeva Air Purifier A3 (by Ajsalemo)
Breeva Air Purifier A5 (by Ajsalemo)
Cylindrical AC (by joe-sal)

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

Fork	Stars	Last push	Description
daninger4995/ha-tcl-home-unofficial-integration Newer code	★ 0	2026-09-03	TCL Home - home assistant integration (unofficial)
jgillum/ha-tcl-home-unofficial-integration Newer code	★ 0	2026-10-03	TCL Home - home assistant integration (unofficial)

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/nemesa/ha-tcl-home-unofficial-integration/blob/main/README.md
Source code: https://github.com/nemesa/ha-tcl-home-unofficial-integration
Issues: https://github.com/nemesa/ha-tcl-home-unofficial-integration/issues
HACS: https://hacs.xyz