68 lines
2.5 KiB
Plaintext
68 lines
2.5 KiB
Plaintext
TP-Link Deco Guest Wi-Fi Recovery Archive
|
|
==========================================
|
|
|
|
Version: 1.0.0
|
|
Created: 2026-09-02
|
|
Project: P026 Flounder downstairs guest-area controls
|
|
|
|
Purpose
|
|
-------
|
|
|
|
This archive preserves the locally maintained TP-Link Deco Guest Wi-Fi
|
|
customisation. The upstream tplink_deco integration does not provide this
|
|
service or sensor. Reinstalling or overwriting custom_components/tplink_deco
|
|
can remove them.
|
|
|
|
Archive
|
|
-------
|
|
|
|
File: docs/tplink_deco_guest_wifi_recovery_2026-09-02.tgz
|
|
SHA-256: 452ed7b7be5e8c469dc7740d5297959179204d24593a22c965f1915ca727c48d
|
|
|
|
Contents
|
|
--------
|
|
|
|
- custom_components/tplink_deco/api.py
|
|
- custom_components/tplink_deco/__init__.py
|
|
- custom_components/tplink_deco/const.py
|
|
- custom_components/tplink_deco/services.yaml
|
|
- custom_components/tplink_deco/coordinator.py
|
|
- custom_components/tplink_deco/binary_sensor.py
|
|
- packages/tplink_deco_guest_wifi.yaml
|
|
|
|
Behaviour Preserved
|
|
-------------------
|
|
|
|
- Service: tplink_deco.set_guest_network
|
|
- Service field: enable (boolean)
|
|
- Router state: binary_sensor.data_cupboard_new_sundamage_12_deco_guest_network
|
|
- Requested state: input_boolean.wifi_guest_network
|
|
- Flounder control: the requested-state helper; the package reconciles it to
|
|
the router-confirmed sensor.
|
|
- Write protocol: read each returned wireless band, retain its host, guest and
|
|
backhaul settings, set only guest.enable, add radio.channel from host.channel,
|
|
write each band separately, then read back and verify every written band.
|
|
- Deco firmware can return a malformed successful response containing
|
|
{"error_code": 0}; the integration accepts that response only for writes and
|
|
relies on the read-back verification as the final confirmation.
|
|
|
|
Recovery Procedure
|
|
------------------
|
|
|
|
1. Stop before updating, reinstalling, or deleting custom_components/tplink_deco.
|
|
2. Verify the archive checksum above.
|
|
3. Extract the archive from /homeassistant, preserving the listed paths.
|
|
4. Run Home Assistant configuration validation and Python compilation for the
|
|
restored integration files.
|
|
5. Restart Home Assistant. A restart is required for custom integration code.
|
|
6. Confirm tplink_deco.set_guest_network is registered and the Guest Network
|
|
binary sensor is available before operating Guest Wi-Fi.
|
|
|
|
Update Policy
|
|
-------------
|
|
|
|
Do not replace custom_components/tplink_deco with an upstream or HACS update
|
|
without first comparing it to this archive and deliberately reapplying the
|
|
Guest Wi-Fi customisation. The archive contains no credentials, tokens, session
|
|
cookies, or router address.
|