Sensors

TP-Link Deco

amosyuen/ha-tplink-deco · vv3.11.0

HACSLocal polling

Home Assistant TP-Link Deco Custom Component

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
`switch`	Switch or outlet
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`select`	Mode picker (as switches)
`device_tracker`	Presence (as an occupancy sensor)

What people report

Many Deco and Mercusys Halo mesh models work, but newer firmware (S7, X55, X20, E4R) often changes authentication and breaks setup or destabilises the router.

Works18
Partly works1
Not working4

Device	In Home Assistant	What they said	Source
Deco M4	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco M5	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco M9 Plus	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco P7	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco P9	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco PX50	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco S4	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco X20	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco X50	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco X60	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco X68	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco X73-DSL	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco X90	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Deco XE75	Works	Listed as supported in README Saved copy Supported devices: Deco M4; Deco M5; Deco M9 Plus; Deco P7; Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Mercusys Halo H70X	Works	Listed as supported in README Saved copy … Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
Mercusys Halo H80X	Works	Listed as supported in README Saved copy … Deco P9; Deco PX50; Deco S4; Deco S7 (1.3.0 Build 20220609 Rel. 64814); Deco X20; Deco X50; Deco X60; Deco X68; Deco X73-DSL(1.0); Deco XE75; Deco X90; Mercusys Halo H70X; Mercusys Halo H80X. Excerpt saved from the README on 2026-10-23.	README
TP-Link Deco S7	Works Local	Encrypted legacy API fallback merged for newer firmware auth Saved copy Summary Adds support for Deco S7 firmware that uses the encrypted legacy local-web API, while preserving the existing LuCI authentication flow for currently supported Deco models. This builds on and supersedes #584. The original commits and authorship from @pmoranga are preserved. ## Changes - Keep the existing LuCI authentication flow as the default. - Detect the legacy S7 protocol only when the public LuCI keys endpoint returns HTTP 401. - Establish the encrypted local-web session using the S7 challenge, RSA and AES handshake. - Remember the detected protocol for subsequent authentication … Excerpt saved from GitHub on 2026-10-23.	PR #589 · 2026-10
TP-Link Deco XE75 firmware 1.3.1	Works	Per-node client list 502 now falls back to global query Saved copy Problem On some Deco firmware the per-node client list query returns a `502 Bad Gateway`: [code] Confirmed on an XE75 mesh running firmware 1.3.1 (Build 20251023). Because `_async_update_data` issues one of these per node via `asyncio.gather`, a single 502 makes the whole client-update cycle raise, and every client `device_tracker` goes unavailable. The global query (`device_mac="default"`) keeps working on the same firmware. ## Change In `TplinkDecoClientUpdateCoordinator._async_update_data`, wrap the per-node `gather` in a `try`/`except aiohttp.ClientResponseError`: - `status = 500` (the … Excerpt saved from GitHub on 2026-10-23.	PR #527 · 2026-06
TP-Link Deco S1900	Partly works	Firmware 1.5.2 needs new auth flow; experimental support Saved copy Problem Hi, I wanted to add integratin to my HA but I received the error "Unknown error occurred". I used my original account to TP-Link account, also I created new one and added to my Deco network as the second administrator, also I tried to login with admin useraname. But no attempt was sucessful. Ip address is also OK (to my main Deco tower). Can anybody help me? Thank you ### TP-Link Deco Version v3.7.0 ### Router Model Deco S7 ### Debugging Information Logger: custom_components.tplink_deco.config_flow Zdroj: custom_components/tplink_deco/config_flow.py:138 integrace: TP-Link Deco … Excerpt saved from GitHub on 2026-10-23.	Issue #456 · 2026-01
TP-Link Deco E4R	Not working	Unknown error on credentials, firmware 1.3.1 Saved copy Problem Hi, I wanted to add integratin to my HA but I received the error "Unknown error occurred". I used my original account to TP-Link account, also I created new one and added to my Deco network as the second administrator, also I tried to login with admin useraname. But no attempt was sucessful. Ip address is also OK (to my main Deco tower). Can anybody help me? Thank you ### TP-Link Deco Version v3.7.0 ### Router Model Deco S7 ### Debugging Information Logger: custom_components.tplink_deco.config_flow Zdroj: custom_components/tplink_deco/config_flow.py:138 integrace: TP-Link Deco … Excerpt saved from GitHub on 2026-10-23.	Issue #456 · 2026-01
TP-Link Deco X20 firmware 1.6.1	Not working	Unknown error occurred on credentials dialog Saved copy Problem Hi, I wanted to add integratin to my HA but I received the error "Unknown error occurred". I used my original account to TP-Link account, also I created new one and added to my Deco network as the second administrator, also I tried to login with admin useraname. But no attempt was sucessful. Ip address is also OK (to my main Deco tower). Can anybody help me? Thank you ### TP-Link Deco Version v3.7.0 ### Router Model Deco S7 ### Debugging Information Logger: custom_components.tplink_deco.config_flow Zdroj: custom_components/tplink_deco/config_flow.py:138 integrace: TP-Link Deco … Excerpt saved from GitHub on 2026-10-23.	Issue #456 · 2026-01
TP-Link Deco X50 mesh firmware 1.8.0	Not working	Network drops every 30-90 minutes with integration enabled Saved copy Problem I upgraded the Firmware last night and since then the Deco HA integration states it was unable to connect and will retry. This happens indefinitely and then every so often the Deco router reboots. Its like its performing a Denial of service attack on the router. I've turned off and disconnected all other network devices except my laptop and router is stable. I reconnect HA and router is unstable. I disable the Deco Integration and router is stable again. I reenable the integration and Deco again reboots. Any ideas? ### TP-Link Deco Version 1.6.1 ### Router Model Deco X55 ### Debugging … Excerpt saved from GitHub on 2026-10-23.	Issue #354 · 2025-01
TP-Link Deco X55	Not working	Firmware 1.6.1/1.8.0: login error, polling reboots router Saved copy Problem I upgraded the Firmware last night and since then the Deco HA integration states it was unable to connect and will retry. This happens indefinitely and then every so often the Deco router reboots. Its like its performing a Denial of service attack on the router. I've turned off and disconnected all other network devices except my laptop and router is stable. I reconnect HA and router is unstable. I disable the Deco Integration and router is stable again. I reenable the integration and Deco again reboots. Any ideas? ### TP-Link Deco Version 1.6.1 ### Router Model Deco X55 ### Debugging … Excerpt saved from GitHub on 2026-10-23.	Issue #354 · 2025-01

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

Local polling

Talks to the device on your network, asking it for updates every so often.

Details

Installs (analytics)	3,197 (0.45%)
GitHub stars	301
Latest version	v3.11.0 (2026-10-19)
Set up in the UI	Yes
Maintainers	@amosyuen
License	MIT

Devices listed in its README

Deco M4
Deco M5
Deco M9 Plus
Deco P7
Deco P9
Deco PX50
Deco S4
Deco S7 (1.3.0 Build 20220609 Rel. 64814)
Deco X20
Deco X50
Deco X60
Deco X68
Deco X73-DSL(1.0)
Deco XE75
Deco X90
Mercusys Halo H70X
Mercusys Halo H80X

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/amosyuen/ha-tplink-deco
Source code: https://github.com/amosyuen/ha-tplink-deco
Issues: https://github.com/amosyuen/ha-tplink-deco/issues
HACS: https://hacs.xyz