Repository navigation
Supported Devices and Firmware
The following models have been reported working with at least one hardware and firmware combination:
- Deco M4
- Deco M5
- Deco M9 Plus
- Deco P7
- Deco P9
- Deco PX50
- Deco S4
- Deco S7
- Deco X20
- Deco X50
- Deco X60
- Deco X68
- Deco X73-DSL
- Deco XE75
- Deco X90
- Mercusys Halo H70X
- Mercusys Halo H80X
This list is not a guarantee for every regional firmware, hardware revision, or operating mode. TP-Link can use different local API behavior under the same marketing model name.
The documented S7 firmware 1.3.0 Build 20220609 Rel. 64814 uses a legacy encrypted local web session over HTTP. The integration supports its authentication and numeric string responses, but manual system-log download and automatic syslog forwarding are unavailable for this legacy transport. Enabling forwarding results in one warning, then forwarding stops until the integration is reloaded.
Basic tracking support does not imply support for every optional endpoint. The manual download implementation was live tested by its contributor on an X50-5G. The maintainer also tested manual download, UDP/TCP forwarding, restart recovery and disabling forwarding on their own mesh for v3.15.0. These results are not a guarantee for all models listed above.
Some firmware has been reported to briefly interrupt wireless backhaul while processing device_list. Configure a longer Deco status interval or use 0 for startup-only status polling.
Firmware 1.4.5 Build 20240828 Rel. 84587 was confirmed to return an incorrect client list in both the Deco app and Home Assistant in one reported environment. TP-Link beta firmware 1.8.5 Build 26082813 Rel. 27740 corrected the issue. Contact TP-Link support for firmware availability in your region.
Firmware 1.8.0 Build 25102213 Rel. 43970 was confirmed working after updating the integration to v3.13.0 or newer.
An unlisted model may still work when its local web interface uses a supported protocol. Before opening a compatibility issue:
- Update the integration.
- Confirm local web access.
- Try the correct HTTP or HTTPS address.
- Use owner credentials and username
admin. - Disable SSL verification for a self-signed certificate.
- Provide diagnostics and sanitized debug logs.
Avoid claiming that an entire model family is incompatible until the exact main-node model, hardware revision, and firmware are known. Mixed meshes use the main Deco's web API behavior.