Skip to content

Releases

v3.16.0 - Optional automatic enabling of new client trackers

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 20:08
3ffea2f

New feature

  • Added Enable trackers for new clients, an opt-in setting for each Deco configuration (#12).
  • When enabled, newly registered client trackers are enabled by default. Existing trackers are left unchanged, and Home Assistant's Disable new entities setting still takes precedence.
  • The option is off by default, so existing installations keep their current behavior.

Thanks to @CarlosMChica for proposing this in amosyuen/ha-tplink-deco#680.

Full changelog

v3.15.5 - Marketplace Catalog Preparation

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 19:11
bc8b8a9

This release completes the validation required for catalog submission. It does not change integration behavior, configuration, or entity IDs.

v3.15.4 - First independent ha-deco release

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 16:45
d6462d0

First independent ha-deco release

This release continues the TP-Link Deco integration under independent maintenance by Dennis (@dkwolf1). The integration domain remains tplink_deco.

  • Preserves the start of syslog bursts with chronological, checkpointed batches.
  • Preserves naming settings and the syslog destination during reauthentication.
  • Points installation, documentation, and support links to this repository.

Add this repository as a custom repository in Marketplace or HACS. See the installation guide.

Thanks to Amos Yuen for the original integration, @oncleben31 and @ludeeus for the templates, @alunduil for validating the syslog fix, and @rjullien for the reauthentication fix.

v3.15.3-beta.2 - Reauthentication Settings and Syslog Burst Fixes

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 15:22
2e493f1

Changes

  • Preserve client and Deco name prefixes/postfixes and the syslog destination when reauthenticating (#677).
  • Retain the syslog burst improvements introduced in beta.1: send new lines oldest-first in batches, checkpoint completed batches and resume remaining lines on subsequent polls when they are still available (#675).

Testing

Please use beta.2 for further testing instead of beta.1.

The live WAN-disconnection validation tracked in #674 is still pending. Syslog forwarding remains best-effort: UDP delivery is not guaranteed, and unsent lines can be lost if the Deco rotates its log.

Thanks

  • @rjullien for identifying and fixing the reauthentication settings reset, including regression coverage (#677).
  • @alunduil for reporting the syslog burst loss and providing testing details (#674).

Full changelog: amosyuen/ha-tplink-deco@v3.15.2...v3.15.3-beta.2

v3.15.3-beta.1 - Syslog Burst Validation

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 15:22
7cd93d2

Syslog Burst Validation Beta

  • Forward fetched new lines chronologically in checkpointed batches instead of discarding older lines at the previous 1,000-line poll cap.
  • Resume from completed batches after errors, cancellation, timeouts or polling pauses.
  • Retain UDP pacing and network timeouts, with a 30-second formatting/sending/checkpointing budget.
  • Automated burst/recovery coverage is included. Live WAN-outage validation is still pending.

UDP remains best effort. Partial sends can duplicate lines, and router log rotation can remove unsent data. This is not a guaranteed lossless archive.

Thanks to @alunduil (Alex Brandt) for the detailed reproduction and offer to test #674. v3.15.2 remains the latest stable release.

v3.15.2 - Compressed Deco System Log Support

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 15:22
575ef76

Fixes

  • Decode plain-text, gzip, tar and gzip-compressed tar system-log snapshots, addressing the firmware formats reported on BE65 and BE9300.
  • Fix both manual system-log downloads and syslog forwarding through their shared API path.
  • Process decompression/archive decoding outside the HA event loop; handle empty/corrupt archives and ignore links without extracting files to disk.
  • Add regression coverage. Existing settings and plain-text log support are retained.

Thanks

Thanks to @cstosgale (Chris Stos-Gale) for the original implementation and BE9300 testing in #671, and @ryanpalfrey for reporting the BE65 failure in #672. The extended implementation has automated coverage; confirmation on the affected hardware is welcome.

v3.15.1 - Fix Setup Form Compatibility

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 15:22
b0e224a

Fixes

  • Fix setup and options forms failing to load because the Deco interval validator could not be serialized, as reported on Home Assistant 2026.3.3.
  • Preserve interval 0 and all intervals of at least 10 seconds; show a clear error for values 1-9.
  • Existing valid configurations and polling behavior remain unchanged.
  • Add form serialization/validation regression coverage and a dedicated HA 2026.3.3 CI job.

Thanks

Thanks to @arozwalak (Artur Rozwalak) for the detailed report and reproduction information in #668.

v3.15.0 - System Logs, Syslog Forwarding and Session Cleanup

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 15:22
7d65e6f

New Features

  • Download the Deco system log using the tplink_deco.download_system_log action. The action saves a file under <config>/tplink_deco_logs/ and returns its path and line count. Config-entry selection is supported when multiple entries are loaded. (#650)
  • Optionally forward new Deco system log lines to a syslog receiver over UDP or TCP. Forwarding is disabled by default and configured per entry. Based on #660 and the original work in #607.
  • Syslog forwarding remembers its position across Home Assistant restarts, skips existing history on first enable, respects polling pause, and stops before logout on integration unload.

Fixes and Improvements

  • Give each polling switch a config-entry-specific unique ID and migrate the old ID while preserving the existing entity ID. (#655, replacing #648; fixes #647)
  • Release the Deco session after successful config-entry unload, with coordinator cleanup performed in the correct order. Failed platform unloads retain runtime state. (#656, replacing #652)
  • Handle Deco nodes with missing or empty nicknames by falling back to their MAC address. (#651)
  • Remove the deprecated CONN_CLASS_CLOUD_POLL declaration; iot_class remains local_polling. (#658; fixes #664)
  • Update Slovak setup/options translations, including the remaining untranslated interval label. Based on #653.
  • Link the README to the documentation wiki. (#659)
  • Update development/test constraints for pip and Ruff. (#662, #663)

Validation

  • Locally checked Python syntax, JSON, pre-commit and diff whitespace.
  • Live tested UDP and TCP forwarding, including reception of 1,000-line batches.
  • Verified TCP forwarding resumes after a Home Assistant restart and stops when disabled.
  • Manual system-log download and the polling switch were tested by the maintainer.
  • Normal Deco, client and wireless updates continued successfully during the observed test.
  • The combined release PR passed the required GitHub checks before merge.

Live validation covers the maintainer's setup, not every Deco model, firmware or multi-entry arrangement. Additional scenarios have automated regression coverage.

Important Notes

  • Each syslog poll downloads the whole Deco log and uses the shared API session, which can delay other requests. The default forwarding interval is 300 seconds.
  • Only the newest 1,000 new lines are forwarded per poll. If more lines are generated, older excess lines are skipped; this is not a lossless log archive.
  • Syslog transport is unencrypted. Raw Deco logs may contain client identifiers and authentication-related protocol data. Use a trusted local receiver and review/redact logs before sharing them publicly.
  • UDP delivery is best effort. TCP retries after a partial send can duplicate messages.
  • Log downloads and forwarding are unsupported on legacy encrypted local-web firmware such as the affected Deco S7 firmware. Forwarding emits one warning and stops until reload.

Thanks

  • @alunduil (Alex Brandt): manual system-log download and opt-in syslog forwarding.
  • @gappleby: original system-log implementation, parsing and tail-matching work in #607.
  • @rjullien (Rene Jullien): nickname fallback and the original session-cleanup implementation and tests.
  • @SJRepos: the original multi-entry polling-switch fix.
  • @misa1515: Slovak translation updates and the deprecation report.
  • @dkwolf1: integration, lifecycle/migration safeguards, regression coverage and live release testing.
  • @dependabot: development dependency updates.

AI-assisted contributions retain the original co-author attribution in the integration commit.

v3.15.0-beta.2 - Multi-Entry and Session Cleanup

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 15:22
1ee4664

Changes

  • Migrates polling switch unique IDs so every TP-Link Deco config entry has its own polling control.
  • Migrates existing polling switch entities without unnecessarily changing their entity IDs.
  • Correctly shuts down the Deco, client, mobile and wireless coordinators during unload.
  • Logs out standard and legacy encrypted Deco sessions after a successful unload.
  • Preserves the active integration runtime when platform unload fails.
  • Includes the manual Deco system-log download action introduced in beta.1.
  • Includes safer handling for Deco nodes without a configured nickname.

Testing requested

Please verify:

  • existing polling switch entity IDs remain unchanged after upgrading;
  • multiple Deco config entries have separate polling switches;
  • reloading and unloading the integration produces no coordinator or logout errors;
  • the integration reconnects normally after a reload;
  • manual system-log downloads still work.

Please report any regression with the Home Assistant log and a diagnostics download. Remove passwords, tokens and other private information before uploading logs.

Contributors

Special thanks to @SJRepos, @rjullien, @alunduil and @gappleby for their implementations, testing and regression coverage.

Includes #650, #651, #655 and #656.

Fixes #647.

v3.15.0-beta.1 - Manual System Log Download

Choose a tag to compare

@dkwolf1 dkwolf1 released this 22 Nov 15:22
ee645b2

Changes

  • Added the tplink_deco.download_system_log Home Assistant action.
  • Uses the Deco web interface's fast save_log endpoint.
  • Supports explicit config-entry selection for installations with multiple Deco networks.
  • Added selectable log severity levels and safe output filename validation.
  • Saves downloaded logs in the tplink_deco_logs directory.
  • Added a stable MAC-address fallback when firmware omits Deco nickname fields.

Compatibility

The system-log action uses the standard LuCI web session.

Firmware using the legacy encrypted web session, including affected Deco S7 firmware, is not currently supported by this action. Existing polling, entities and configuration remain unchanged.

Testing

This is a beta release intended to validate the system-log endpoint across additional Deco models and firmware versions.

All automated tests, Home Assistant 2026.11 compatibility checks, HACS validation, Hassfest validation and pre-commit checks passed.

Includes #650 and #651.

Continues the manual-download portion of #607.