Skip to content

Commit b966534

Browse files
authored
Add files via upload
1 parent 784b377 commit b966534

1 file changed

Lines changed: 89 additions & 31 deletions

File tree

README.md

Lines changed: 89 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,118 @@
1-
# TP-Link Deco (Community Fix)
1+
# TP-Link Deco
2+
3+
[![GitHub Release](https://img.shields.io/github/v/release/amosyuen/ha-tplink-deco?style=for-the-badge)](https://github.com/amosyuen/ha-tplink-deco/releases)
4+
[![GitHub Activity](https://img.shields.io/github/commit-activity/y/amosyuen/ha-tplink-deco?style=for-the-badge)](https://github.com/amosyuen/ha-tplink-deco/commits/main)
5+
[![License](https://img.shields.io/github/license/amosyuen/ha-tplink-deco?style=for-the-badge)](LICENSE)
6+
7+
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?style=for-the-badge)](https://github.com/pre-commit/pre-commit)
8+
[![Black](https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge)](https://github.com/psf/black)
9+
[![HACS](https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge)](https://hacs.xyz)
10+
11+
[![Maintained](https://img.shields.io/badge/maintained-yes-brightgreen?style=for-the-badge)]()
12+
[![Home Assistant](https://img.shields.io/badge/Home%20Assistant-2026.4%2B-blue?style=for-the-badge)](https://www.home-assistant.io/)
13+
14+
---
15+
16+
## 🚀 Overview 2026
17+
18+
This integration provides local polling control and diagnostics for TP-Link Deco systems within Home Assistant.
19+
20+
The project is actively maintained and extended with new features and stability improvements.
21+
22+
---
23+
24+
## ✨ Features
25+
26+
### Diagnostics
27+
28+
- CPU usage (raw + smoothed)
29+
- Memory usage (raw + smoothed)
30+
- Backhaul and network diagnostics
31+
32+
### Polling Control
233

3-
⚠️ This fork restores and extends compatibility with newer Home Assistant versions.
34+
#### Runtime control
435

5-
The original repository is in maintenance mode and is no longer actively tested.
6-
This fork resolves compatibility issues and adds additional functionality.
36+
- Pause / resume polling via:
37+
- `tplink_deco.pause_polling`
38+
- `tplink_deco.resume_polling`
39+
- Switch entity:
40+
- `switch.deco_polling`
41+
42+
#### Polling interval control
43+
44+
- Adjustable polling interval:
45+
46+
- 10 sec
47+
- 30 sec (default)
48+
- 60 sec
49+
- 120 sec
50+
51+
- Configurable:
52+
- during setup
53+
- via Home Assistant UI (select entity)
54+
55+
#### Benefits
56+
57+
- Reduces load on the Deco API
58+
- Prevents session conflicts
59+
- Improves stability and responsiveness
60+
- Allows fine-tuning between performance and load
761

862
---
963

10-
## Added / Fixed in this fork
64+
## 📝 Changelog
1165

12-
- ✅ Fix for Home Assistant 2026.4 compatibility
13-
- ✅ Diagnostic entities (including backhaul speed and max speed)
14-
- ✅ Polling control:
66+
### v3.7.4
1567

16-
- pause/resume services
68+
- Added CPU usage sensors (raw and smoothed)
69+
- Added memory usage sensors (raw and smoothed)
70+
- Added configurable polling interval (10 / 30 / 60 / 120 seconds)
71+
- Added select entity for runtime polling control
72+
73+
---
1774

18-
- switch entity to control polling from the UI
19-
- ✅ Improved stability when accessing the Deco web interface
75+
### v3.7.3
2076

21-
👉 Use this fork if the original integration no longer works or if you need extended diagnostics and control.
77+
- Fix for Home Assistant 2026.4 compatibility
78+
- Added diagnostic entities (including backhaul speed and max speed)
79+
- Added polling control:
80+
- pause / resume services
81+
- switch entity (`switch.deco_polling`)
82+
- Improved stability when accessing the Deco web interface
2283

2384
---
2485

25-
## Services / Switch
86+
## 🔧 Services
2687

27-
Available services in Home Assistant:
88+
Available services:
2889

2990
- `tplink_deco.pause_polling`
3091
- `tplink_deco.resume_polling`
92+
- `tplink_deco.reboot_polling`
3193

32-
Available entity:
94+
---
95+
96+
## 🔌 Entities
97+
98+
Polling control:
3399

34100
- `switch.deco_polling`
101+
- `select.polling_interval`
35102

36103
---
37104

38-
## Polling Control
105+
## 📦 Installation
39106

40-
Pause or resume polling to the Deco API.
107+
### HACS
41108

42-
### Benefits
109+
[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=amosyuen&repository=ha-tplink-deco&category=integration)
43110

44-
- Reduces load on the Deco API by limiting continuous polling
45-
- Decreases network traffic and processing overhead
46-
- Improves debugging by allowing polling to be temporarily disabled
47-
- Helps prevent issues with limited concurrent sessions in the Deco web interface
48-
- Provides more control over integration behavior for advanced users
111+
### Manual
49112

50-
This is especially useful when accessing the Deco web interface, as the API allows only a limited number of concurrent sessions.
113+
1. Copy `custom_components/tplink_deco` to your Home Assistant config folder
114+
2. Restart Home Assistant
115+
3. Add the integration via UI
51116

52117
# TP-Link Deco
53118

@@ -64,13 +129,6 @@ This is especially useful when accessing the Deco web interface, as the API allo
64129

65130
[![Community Forum][forum-shield]][forum]
66131

67-
> [!CAUTION]
68-
> This integration is in MAINTENANCE MODE.
69-
>
70-
> I no longer have a deco unit so I cannot test this integration properly. I will not implement any new feature requests and will only implement simple fixes required by Home Assistant.
71-
>
72-
> If anybody is interested in taking over this repo and maintaining it, please let me know.
73-
74132
## Functionality
75133

76134
This integration is a local polling integration that logs into the admin web UI for TP-Link Deco routers. Currently the only feature implemented is device trackers for active devices.

0 commit comments

Comments
 (0)