GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Add selective room cleaning to vacuum clean module by epg-pers · Pull Request #1660 · python-kasa/python-kasa

Conversation

@epg-pers

@epg-pers epg-pers commented Feb 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds support for selective room cleaning to the existing Clean module:

  • clean_rooms(room_ids: list[int], map_id: int | None = None) - sends setSwitchClean with clean_mode: 3 and the verified payload to clean specific rooms
  • get_rooms(map_id: int | None = None) - on-demand call to getMapData returning the filtered list of room areas
  • current_map_id property - exposes the active map ID from getMapInfo, which is now included in the polling query

Background

The correct setSwitchClean payload for selective room cleaning was reverse-engineered by intercepting live device traffic while the official Tapo app performed a room clean (getSwitchClean readback). Key findings:

  • clean_mode: 2 is spot clean — the room_list field is silently ignored
  • clean_mode: 3 is selective room clean
  • room_list is a plain int[] of room IDs (the pixel values used in the LZ4 map), not an array of objects
  • start_type: 1 is required

This was verified working on an RV30 Max Plus (EU) running firmware 1.3.2, documented in https://github.com/epg-pers/tapo-rv30-ha and discussed in #1592.

Test plan

  • All 48 existing + new tests pass against both RV20 and RV30 fixtures
  • test_clean_rooms - verifies correct setSwitchClean payload with default map ID
  • test_clean_rooms_explicit_map_id - verifies explicit map_id is used when provided
  • test_clean_rooms_empty_raises - verifies ValueError on empty room list
  • test_get_rooms / test_get_rooms_explicit_map_id - verifies getMapData call and room filtering

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

davidefiocco and rytilahti reacted with heart emoji
All reactions
  • ❤️ 2 reactions
@epg-pers epg-pers mentioned this pull request Feb 23, 2026
TPAP Implementation #1592
Open
@epg-pers
Add room cleaning support to vacuum clean module
cba457a
Add clean_rooms() to send selective room clean commands using
clean_mode 3 with the verified setSwitchClean payload, and
get_rooms() to query the room list from the device on demand.
Add getMapInfo to the polling query to expose current_map_id.

Tested on RV30 Max Plus (EU) firmware 1.3.2.
@epg-pers
epg-pers force-pushed the feature/vacuum-room-cleaning branch from 3a5234c to cba457a Compare February 23, 2026 22:00
@codecov

codecov Bot commented Feb 23, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 90.66667% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 93.29%. Comparing base (932f3e2) to head (dd3ac76).
⚠️ Report is 41 commits behind head on master.

Files with missing lines Patch % Lines
kasa/smart/modules/clean.py 90.66% 5 Missing and 2 partials ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##           master    #1660      +/-   ##
==========================================
+ Coverage   93.22%   93.29%   +0.06%     
==========================================
  Files         157      157              
  Lines        9818     9932     +114     
  Branches     1003     1022      +19     
==========================================
+ Hits         9153     9266     +113     
+ Misses        472      471       -1     
- Partials      193      195       +2     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

rytilahti
rytilahti reviewed Feb 26, 2026
View reviewed changes

@rytilahti rytilahti left a comment

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the pull request, @epg-pers! See some initial comments inline.

I am trying to think ahead how to integrate this with downstreams, I guess we would need to add support for parameters for Feature actions to make it easier to integrate, e.g., to home assistant?

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

@davidefiocco

davidefiocco commented Feb 28, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Hello! @epg-pers I tested this with my RV30(UN) 1.0, firmware 1.2.2 Build 240627, AES transport, and it worked beautifully!

I took a stab at integrating zones too, and it worked, but I would have never managed without your work!

In order to progress with different modes, I triggered each cleaning mode from the Tapo app (room, zone, custom, home advanced, home standard) and polled getCleanStatus / getSwitchClean / getVacStatus via the local API to observe which clean_status and clean_mode values the device reported. Then I replayed those values in setSwitchClean payloads locally and verified that the vacuum actually started the expected mode (checked by looking at the vacuum IRL and via the app).

One thing I couldn't figure out and trigger properly is the "Home Advanced Cleaning", but the others (spot, rooms, zones) would be covered.

In case you're curious, I extended this also trying to factor in @rytilahti's suggestions here master...davidefiocco:python-kasa:feat/room-cleaning-improvements in case it can be useful for inspiration (and zones could be added in a separate PR). It worked for me!

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@epg-pers

epg-pers commented Feb 28, 2026

Copy link
Copy Markdown
Contributor Author

Hello! @epg-pers I tested this with my RV30(UN) 1.0, firmware 1.2.2 Build 240627, AES transport, and it worked beautifully!

I took a stab at integrating zones too, and it worked, but I would have never managed without your work!

In order to progress with different modes, I triggered each cleaning mode from the Tapo app (room, zone, custom, home advanced, home standard) and polled getCleanStatus / getSwitchClean / getVacStatus via the local API to observe which clean_status and clean_mode values the device reported. Then I replayed those values in setSwitchClean payloads locally and verified that the vacuum actually started the expected mode (checked by looking at the vacuum IRL and via the app).

One thing I couldn't figure out and trigger properly is the "Home Advanced Cleaning", but the others (spot, rooms, zones) would be covered.

In case you're curious, I extended this also trying to factor in @rytilahti's suggestions here master...davidefiocco:python-kasa:feat/room-cleaning-improvements in case it can be useful for inspiration (and zones could be added in a separate PR). It worked for me!

That's great do hear. It sounds like you followed a similar strategy to me; trigger action from the app > poll the device locally to understand what was set > attempt the same payload locally. Feel free to add your additions to this PR. I haven't had much time this week to revisit @rytilahti suggestions.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@davidefiocco
Address review on python-kasa#1660: add enums, dataclasses, name deco…
a8819f3
…ding for room cleaning
@davidefiocco

davidefiocco commented Mar 1, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Feel free to add your additions to this PR.

Sure! @epg-pers, I've prepared a commit addressing @rytilahti's review feedback (enums, dataclasses, base64 name decoding, clean_type property) with rooms only, no zones yet.

All 54 tests pass and pre-commit checks are clean.
You can see the diff here: epg-pers/python-kasa@feature/vacuum-room-cleaning...davidefiocco:python-kasa:feature/vacuum-room-cleaning-review-fixes

You could either:

  • Add me as a collaborator on your fork so I can push directly to your branch, or
  • Pull my changes into your branch:
git remote add davidefiocco https://github.com/davidefiocco/python-kasa.git
git fetch davidefiocco feature/vacuum-room-cleaning-review-fixes
git merge davidefiocco/feature/vacuum-room-cleaning-review-fixes

And if needed I can try to chime in response to @rytilahti's comments above.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@epg-pers

epg-pers commented Mar 2, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor Author

@davidefiocco thanks for doing the legwork on rytilahti's suggestions, ive merged your branch in. 54 tests passing and pre-commit clean. @rytilahti really appreciate the detailed review feedback, the enums, dataclass, and base64 name decoding are all in now. Let me know if there is anything else you would like changed.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

rytilahti
rytilahti reviewed Mar 2, 2026
View reviewed changes

@rytilahti rytilahti left a comment

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a couple of minor nits, nice to see the progress here! Feel free to comment and/or close my previous comments, just to make it visible if they are still pending.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

Comment thread kasa/smart/modules/clean.py Resolved

Uh oh!

There was an error while loading. Please reload this page.

davidefiocco added 2 commits March 21, 2026 23:10
@davidefiocco
Expose current_map_name property on Clean module
5b7be69
@davidefiocco davide.fiocco
Add debug logging for skipped areas and improve suction typing
082b5df
@davidefiocco

davidefiocco commented Mar 22, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Hey @epg-pers !
I believe this PR is genuinely useful and thus as before I tried to address @rytilahti's remarks in the same way as last time.

You can check the new diff via epg-pers/python-kasa@feature/vacuum-room-cleaning...davidefiocco:python-kasa:feature/vacuum-room-cleaning-review-fixes and merge on your branch via

git fetch davidefiocco feature/vacuum-room-cleaning-review-fixes
git merge davidefiocco/feature/vacuum-room-cleaning-review-fixes

This time I addressed debug logging, the requested blank line and typed FanSpeed. Added two tests, all tests pass, linters happy. If you merge this to your branch, I am glad to try to respond to all comments by @rytilahti in your behalf. Still, I am afraid that we'll need yet another iteration because there are some rough edges to discuss.

I also added a fixture from my device, and added that separately in #1665, but couldn't add map data in it yet (I experience errors if I try).

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

davidefiocco added 2 commits March 23, 2026 01:19
@davidefiocco
Use better named constants for getMapData type and start_type, improv…
d642f88
…e formatting
@davidefiocco
Fix get_rooms() not unwrapping getMapData response
dd3ac76
@github-actions

github-actions Bot commented Jun 21, 2026

Copy link
Copy Markdown

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days.
If you are the author of this PR, please leave a comment if you want to keep it open. Also, please rebase your PR onto the latest dev branch to ensure that it's up to date with the latest changes.
Thank you for your contribution!

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@github-actions github-actions Bot added the stale label Jun 21, 2026
@github-actions github-actions Bot closed this Jun 29, 2026
@rytilahti rytilahti reopened this Jul 5, 2026
@github-actions github-actions Bot removed the stale label Jul 6, 2026
@rytilahti rytilahti added this to the 0.11 milestone Jul 6, 2026
@rytilahti rytilahti added the enhancement New feature or request label Jul 6, 2026
@rytilahti

rytilahti commented Jul 11, 2026

Copy link
Copy Markdown
Member

@davidefiocco, I merged your branch to @epg-pers' branch behind this PR, thanks to both of you for this! I tested with my own vacuum & I am planning to improve this with some ideas I have in a separate PR, so I will just merge this now.

davidefiocco reacted with heart emoji
All reactions
  • ❤️ 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@davidefiocco

davidefiocco commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Fantastic news, thanks for consolidating this @rytilahti!!

rytilahti reacted with hooray emoji
All reactions
  • 🎉 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@rytilahti
rytilahti enabled auto-merge (squash) July 11, 2026 13:02
rytilahti
rytilahti approved these changes Jul 11, 2026
View reviewed changes
@rytilahti
rytilahti merged commit aba457a into python-kasa:master Jul 11, 2026
21 of 22 checks passed

Uh oh!

There was an error while loading. Please reload this page.

@rytilahti rytilahti mentioned this pull request Oct 4, 2026
Prepare 0.11.0 #1776
Merged
rytilahti added a commit that referenced this pull request Oct 4, 2026
@rytilahti
Prepare 0.11.0 (#1776)
5b8447c
## [0.11.0](https://github.com/python-kasa/python-kasa/tree/0.11.0)
(2026-10-04)

[Full
Changelog](0.10.2...0.11.0)

**Release summary:**

This is a huge and long overdue release, coming more than a year and a
half after the previous one.
Hopefully the next one follows sooner, as the TPAP transport (which did
not make it into this release) is used more and more on newer devices.

This release brings broader camera support, new modules for lights,
vacuums and cameras, and many connectivity fixes for newer firmware
versions. Some other highlights:
- Improved Tapo camera support: login version 3, presets, wifi handling,
last alert detection, and more robust authentication and discovery.
- Selective room cleaning for robot vacuums.
- Configurable light strip length via the new strip segment module, and
an exposed light transition state change flag.
- Basic HomeKit module for Kasa (iot) devices.
- Energy monitoring V2 support (S515D).
- Better hub and thermostat state reporting (hold, summer mode, low
battery).
- Connection fixes for newer Tapo firmware and older SSL devices, plus
KLAP v2 for iot devices.
- More resilient time handling, with failover and UTC fallback for iot
devices.
- Python 3.14 is now supported.
- Inclusion of fixtures for 29 devices or firmware versions, including
the Tapo C460, C200 and C101 cameras and the KH100 hub with KE100/KE110
thermostats.

**Thank you to all contributors!**

A big thank you to everyone who contributed to this release, whether
through code, device fixtures, bug reports or testing.

Special thanks to @ZeliardM for a huge effort on both features and
project maintenance, including but not limited to:
- Features like the HomeKit module for iot devices, iot time module
failover, wifi handling and credential improvements for cameras, Tapo
login version 3, and V2 energy monitoring for S515D.
- A lot of necessary maintenance work including type annotations and
cleanups throughout the test suite, modernized docstrings, CI hardening
with SHA-pinned actions, and many bug fixes. This helps us to keep the
library maintainable and open to new contributions.

A warm welcome to our new contributors, with special thanks to those who
contributed improvements and fixes:
- @alams154: discovery on port 20004
- @bluntman001: iot device classification fix
- @bm1549: KLAP v2 transport for iot devices
- @darylldelfin: cipher support for newer Tapo firmware
- @davidefiocco: vacuum mop water level fix
- @epg-pers: selective room cleaning for vacuums
- @freeKC: camera discovery and authentication fixes
- @gpongelli: extended camera detection
- @Ikstar: KL420 color temperature range
- @juherr: last alert detection module for cameras, camera error codes
and a C200 fixture
- @kad: SSL connections to older devices
- @KaloyanNaumov: multi-request timeout handling
- @loganrosen: KL400L5 color temperature range
- @markvanpraet: Tapo C460 support and camera battery fix
- @monteccarlos: iot timezone mapping fix
- @mrwogu: preset support for Tapo cameras
- @nopoz: strip segment module, light transition flag and credentials
hash fix
- @tk1475: UTC fallback for unset iot device clocks
- @wh1t3f1r3: non-retryable network error handling

Thanks also to our new contributors who provided device fixtures to help
future development efforts: @emanueleg, @fantandrea, @HarryPehkonen,
@ijaron, @Krotu, @LostLuma, @mjbohr and @TheLinuxGuy.

**This release in numbers:**

- 68 merged pull requests from 29 contributors, 27 of them first-time
contributors
- 8 new modules
- 29 new device fixtures
- 203 files changed, with 25,199 lines added and 2,585 removed


**Implemented enhancements:**

- \[Feature Request\] C220 camera line crossing detection on-off switch
[\#1551](#1551)
- SslAesTransport: handshake again when a camera answers 401 to
passthrough
[\#1771](#1771) (@freeKC)
- Add LastAlertDetection module for smartcam devices
[\#1762](#1762) (@juherr)
- Add KL420 to TPLINK\_KELVIN color temperature ranges
[\#1757](#1757) (@Ikstar)
- Do not authenticate with a credentials\_hash from a different
transport [\#1749](#1749)
(@nopoz)
- Expose the light transition state change flag
[\#1745](#1745) (@nopoz)
- Add strip segment module for configurable light strip length
[\#1744](#1744) (@nopoz)
- Add KL400L5 color temperature range
[\#1719](#1719)
(@loganrosen)
- Update smartcam credential handling and tests
[\#1664](#1664)
(@ZeliardM)
- Add support for V2 Energy Monitoring for S515D
[\#1663](#1663)
(@ZeliardM)
- Add selective room cleaning to vacuum clean module
[\#1660](#1660)
(@epg-pers)
- New Wi-Fi handling for SMARTCAM devices
[\#1639](#1639)
(@ZeliardM)
- Add support for tapo login\_version 3 in sslaestransport
[\#1638](#1638)
(@ZeliardM)
- Add preset support for Tapo cameras
[\#1615](#1615) (@mrwogu)
- Add python 3.14 to supported versions
[\#1599](#1599)
(@rytilahti)
- Add discovery port 20004
[\#1595](#1595)
(@alams154)
- Implement IOT Time Module Failover
[\#1583](#1583)
(@ZeliardM)
- Add bare bones homekit module for iot devices
[\#1566](#1566)
(@ZeliardM)
- Extend smartcam detection support
[\#1552](#1552)
(@gpongelli)

**Fixed bugs:**

- Time module unavailable for waterleak sensor
[\#1613](#1613)
- 'No time zone found with key EST' in debian 13
[\#1579](#1579)
- Discovery: accept cameras that only send the encrypt\_type list
[\#1770](#1770) (@freeKC)
- Classify IOT devices via sysinfo regardless of transport \(fixes
\#1740\) [\#1769](#1769)
(@bluntman001)
- Fall back to UTC for iot time when the device clock is not set
[\#1768](#1768) (@tk1475)
- Add UNKNOWN\_USERNAME \(-60502\) camera error code
[\#1761](#1761) (@juherr)
- Disable multi requests on timeout during multi-request
[\#1759](#1759)
(@KaloyanNaumov)
- Add ECDHE-RSA-AES256 cipher for newer Tapo firmware
[\#1755](#1755)
(@darylldelfin)
- Map iot timezone index 18 to America/New\_York instead of EST
[\#1743](#1743)
(@monteccarlos)
- fix: use KLAP v2 transport for IOT devices with login version 2
[\#1731](#1731) (@bm1549)
- Add ENETUNREACH to non-retryable errors in XorTransport
[\#1668](#1668)
(@wh1t3f1r3)
- Fix mop set\_waterlevel sending setCleanAttr without type field
[\#1667](#1667)
(@davidefiocco)
- Fix SMARTCAM Time module and update tests
[\#1659](#1659)
(@ZeliardM)
- Fix camera login version in CLI
[\#1658](#1658)
(@ZeliardM)
- Allow SSL connections to older devices
[\#1654](#1654) (@kad)
- waterleaksensor: use parent's Time for alert timestamp
[\#1614](#1614)
(@rytilahti)
- Add hold state to thermostatstate
[\#1609](#1609)
(@rytilahti)
- Fix thermostat idle reporting on low battery
[\#1598](#1598)
(@rytilahti)
- Add shutdown \(summer mode\) to thermostatstate
[\#1588](#1588)
(@rytilahti)
- Fix iotstrip child device time handling
[\#1584](#1584)
(@ZeliardM)

**Added support for devices:**

- Add C200 device fixture
[\#1760](#1760) (@juherr)
- Add P125M fixture for firmware 1.4.4
[\#1746](#1746)
(@HarryPehkonen)
- Add fixtures for KH100, KE100 and KE110 and simulate TRV states
[\#1726](#1726) (@Krotu)
- Add L530EA\(EU\) device fixture
[\#1694](#1694)
(@ZeliardM)
- Add C101 test fixture
[\#1673](#1673) (@ijaron)
- Add LB130\(US\) device fixture
[\#1669](#1669)
(@ZeliardM)
- Add KL110B\(UN\) device fixture
[\#1657](#1657)
(@ZeliardM)
- Add TS15\(US\) device fixture
[\#1649](#1649)
(@ZeliardM)
- Add Tapo C460 support
[\#1645](#1645)
(@markvanpraet)
- Add P105\(US\) device fixture
[\#1644](#1644)
(@ZeliardM)
- Add L430C\(EU\) device fixture
[\#1643](#1643)
(@ZeliardM)
- Add L430P\(EU\) device fixture
[\#1607](#1607)
(@LostLuma)
- Add S500\(US\)\_1.0\_1.2.0 fixture
[\#1569](#1569)
(@ZeliardM)
- Add device fixture for P316M\(US\)
[\#1568](#1568)
(@TheLinuxGuy)
- Add L535E\(EU\) 3.0 1.1.8 fixture
[\#1545](#1545)
(@fantandrea)
- Adding KL400L10\(US\)\_1.0\_1.0.10 fixture
[\#1539](#1539) (@mjbohr)
- Add TP10\(IT\) 1.0 1.2.5 fixture
[\#1538](#1538)
(@emanueleg)
- Add LB100\(US\)\_1.0\_1.8.11 fixture file
[\#1515](#1515)
(@ZeliardM)
- Add KS225\(US\)\_1.0\_1.1.1 and L930-5\(EU\)\_1.0\_1.2.5
[\#1509](#1509)
(@ZeliardM)

**Documentation updates:**

- How to hash credentials to make use of --credentials-hash flag?
[\#1517](#1517)
- docs: modernize docstrings across the repository
[\#1682](#1682)
(@ZeliardM)
- Add a note to emeter guide being kasa-only
[\#1512](#1512)
(@rytilahti)

**Project maintenance:**

- tests: add type annotations to top-level test files
[\#1688](#1688)
(@ZeliardM)
- tests: add type annotations to CLI, protocol, and smartcam tests
[\#1687](#1687)
(@ZeliardM)
- tests: add type annotations to Smart tests
[\#1686](#1686)
(@ZeliardM)
- tests: add type annotations to IoT tests
[\#1685](#1685)
(@ZeliardM)
- tests: add type annotations to transport tests
[\#1684](#1684)
(@ZeliardM)
- tests: centralize transport and session cleanup in conftest
[\#1683](#1683)
(@ZeliardM)
- ci: pin all GitHub Actions to SHA hashes and update versions
[\#1681](#1681)
(@ZeliardM)
- tests: fix typos, child device subtype, CLI patch path, and
deprecation test logic
[\#1677](#1677)
(@ZeliardM)
- Update GitHub Workflows and Actions
[\#1622](#1622)
(@ZeliardM)
- Use log-level debug for smartdevice query error reporting
[\#1587](#1587)
(@rytilahti)
- Use Device instead of SmartDevice where feasible
[\#1585](#1585)
(@ZeliardM)

**Closed issues:**

- Python 3.14 Support
[\#1597](#1597)
- HS300 Child State - Time Module Error
[\#1445](#1445)
@rytilahti rytilahti mentioned this pull request Oct 4, 2026
Prepare 0.11.0.1 #1780
Merged
rytilahti added a commit that referenced this pull request Oct 4, 2026
@rytilahti
Prepare 0.11.0.1 (#1780)
ff26187
## [0.11.0.1](https://github.com/python-kasa/python-kasa/tree/0.11.0.1)
(2026-10-04)

[Full
Changelog](0.10.2...0.11.0.1)

**Release summary:**

*Note: 0.11.0 was tagged but never published to PyPI due to a packaging
issue. 0.11.0.1 contains the same changes plus a fix for the release
workflow.*

This is a huge and long overdue release, coming more than a year and a
half after the previous one.
Hopefully the next one follows sooner, as the TPAP transport (which did
not make it into this release) is used more and more on newer devices.

This release brings broader camera support, new modules for lights,
vacuums and cameras, and many connectivity fixes for newer firmware
versions. Some other highlights:
- Improved Tapo camera support: login version 3, presets, wifi handling,
last alert detection, and more robust authentication and discovery.
- Selective room cleaning for robot vacuums.
- Configurable light strip length via the new strip segment module, and
an exposed light transition state change flag.
- Basic HomeKit module for Kasa (iot) devices.
- Energy monitoring V2 support (S515D).
- Better hub and thermostat state reporting (hold, summer mode, low
battery).
- Connection fixes for newer Tapo firmware and older SSL devices, plus
KLAP v2 for iot devices.
- More resilient time handling, with failover and UTC fallback for iot
devices.
- Python 3.14 is now supported.
- Inclusion of fixtures for 29 devices or firmware versions, including
the Tapo C460, C200 and C101 cameras and the KH100 hub with KE100/KE110
thermostats.

**Thank you to all contributors!**

A big thank you to everyone who contributed to this release, whether
through code, device fixtures, bug reports or testing.

Special thanks to @ZeliardM for a huge effort on both features and
project maintenance, including but not limited to:
- Features like the HomeKit module for iot devices, iot time module
failover, wifi handling and credential improvements for cameras, Tapo
login version 3, and V2 energy monitoring for S515D.
- A lot of necessary maintenance work including type annotations and
cleanups throughout the test suite, modernized docstrings, CI hardening
with SHA-pinned actions, and many bug fixes. This helps us to keep the
library maintainable and open to new contributions.

A warm welcome to our new contributors, with special thanks to those who
contributed improvements and fixes:
- @alams154: discovery on port 20004
- @bluntman001: iot device classification fix
- @bm1549: KLAP v2 transport for iot devices
- @darylldelfin: cipher support for newer Tapo firmware
- @davidefiocco: vacuum mop water level fix
- @epg-pers: selective room cleaning for vacuums
- @freeKC: camera discovery and authentication fixes
- @gpongelli: extended camera detection
- @Ikstar: KL420 color temperature range
- @juherr: last alert detection module for cameras, camera error codes
and a C200 fixture
- @kad: SSL connections to older devices
- @KaloyanNaumov: multi-request timeout handling
- @loganrosen: KL400L5 color temperature range
- @markvanpraet: Tapo C460 support and camera battery fix
- @monteccarlos: iot timezone mapping fix
- @mrwogu: preset support for Tapo cameras
- @nopoz: strip segment module, light transition flag and credentials
hash fix
- @tk1475: UTC fallback for unset iot device clocks
- @wh1t3f1r3: non-retryable network error handling

Thanks also to our new contributors who provided device fixtures to help
future development efforts: @emanueleg, @fantandrea, @HarryPehkonen,
@ijaron, @Krotu, @LostLuma, @mjbohr and @TheLinuxGuy.

**This release in numbers:**

- 68 merged pull requests from 29 contributors, 27 of them first-time
contributors
- 8 new modules
- 29 new device fixtures
- 203 files changed, with 25,199 lines added and 2,585 removed


**Implemented enhancements:**

- \[Feature Request\] C220 camera line crossing detection on-off switch
[\#1551](#1551)
- SslAesTransport: handshake again when a camera answers 401 to
passthrough
[\#1771](#1771) (@freeKC)
- Add LastAlertDetection module for smartcam devices
[\#1762](#1762) (@juherr)
- Add KL420 to TPLINK\_KELVIN color temperature ranges
[\#1757](#1757) (@Ikstar)
- Do not authenticate with a credentials\_hash from a different
transport [\#1749](#1749)
(@nopoz)
- Expose the light transition state change flag
[\#1745](#1745) (@nopoz)
- Add strip segment module for configurable light strip length
[\#1744](#1744) (@nopoz)
- Add KL400L5 color temperature range
[\#1719](#1719)
(@loganrosen)
- Update smartcam credential handling and tests
[\#1664](#1664)
(@ZeliardM)
- Add support for V2 Energy Monitoring for S515D
[\#1663](#1663)
(@ZeliardM)
- Add selective room cleaning to vacuum clean module
[\#1660](#1660)
(@epg-pers)
- New Wi-Fi handling for SMARTCAM devices
[\#1639](#1639)
(@ZeliardM)
- Add support for tapo login\_version 3 in sslaestransport
[\#1638](#1638)
(@ZeliardM)
- Add preset support for Tapo cameras
[\#1615](#1615) (@mrwogu)
- Add python 3.14 to supported versions
[\#1599](#1599)
(@rytilahti)
- Add discovery port 20004
[\#1595](#1595)
(@alams154)
- Implement IOT Time Module Failover
[\#1583](#1583)
(@ZeliardM)
- Add bare bones homekit module for iot devices
[\#1566](#1566)
(@ZeliardM)
- Extend smartcam detection support
[\#1552](#1552)
(@gpongelli)

**Fixed bugs:**

- Time module unavailable for waterleak sensor
[\#1613](#1613)
- 'No time zone found with key EST' in debian 13
[\#1579](#1579)
- Discovery: accept cameras that only send the encrypt\_type list
[\#1770](#1770) (@freeKC)
- Classify IOT devices via sysinfo regardless of transport \(fixes
\#1740\) [\#1769](#1769)
(@bluntman001)
- Fall back to UTC for iot time when the device clock is not set
[\#1768](#1768) (@tk1475)
- Add UNKNOWN\_USERNAME \(-60502\) camera error code
[\#1761](#1761) (@juherr)
- Disable multi requests on timeout during multi-request
[\#1759](#1759)
(@KaloyanNaumov)
- Add ECDHE-RSA-AES256 cipher for newer Tapo firmware
[\#1755](#1755)
(@darylldelfin)
- Map iot timezone index 18 to America/New\_York instead of EST
[\#1743](#1743)
(@monteccarlos)
- fix: use KLAP v2 transport for IOT devices with login version 2
[\#1731](#1731) (@bm1549)
- Add ENETUNREACH to non-retryable errors in XorTransport
[\#1668](#1668)
(@wh1t3f1r3)
- Fix mop set\_waterlevel sending setCleanAttr without type field
[\#1667](#1667)
(@davidefiocco)
- Fix SMARTCAM Time module and update tests
[\#1659](#1659)
(@ZeliardM)
- Fix camera login version in CLI
[\#1658](#1658)
(@ZeliardM)
- Allow SSL connections to older devices
[\#1654](#1654) (@kad)
- waterleaksensor: use parent's Time for alert timestamp
[\#1614](#1614)
(@rytilahti)
- Add hold state to thermostatstate
[\#1609](#1609)
(@rytilahti)
- Fix thermostat idle reporting on low battery
[\#1598](#1598)
(@rytilahti)
- Add shutdown \(summer mode\) to thermostatstate
[\#1588](#1588)
(@rytilahti)
- Fix iotstrip child device time handling
[\#1584](#1584)
(@ZeliardM)

**Added support for devices:**

- Add C200 device fixture
[\#1760](#1760) (@juherr)
- Add P125M fixture for firmware 1.4.4
[\#1746](#1746)
(@HarryPehkonen)
- Add fixtures for KH100, KE100 and KE110 and simulate TRV states
[\#1726](#1726) (@Krotu)
- Add L530EA\(EU\) device fixture
[\#1694](#1694)
(@ZeliardM)
- Add C101 test fixture
[\#1673](#1673) (@ijaron)
- Add LB130\(US\) device fixture
[\#1669](#1669)
(@ZeliardM)
- Add KL110B\(UN\) device fixture
[\#1657](#1657)
(@ZeliardM)
- Add TS15\(US\) device fixture
[\#1649](#1649)
(@ZeliardM)
- Add Tapo C460 support
[\#1645](#1645)
(@markvanpraet)
- Add P105\(US\) device fixture
[\#1644](#1644)
(@ZeliardM)
- Add L430C\(EU\) device fixture
[\#1643](#1643)
(@ZeliardM)
- Add L430P\(EU\) device fixture
[\#1607](#1607)
(@LostLuma)
- Add S500\(US\)\_1.0\_1.2.0 fixture
[\#1569](#1569)
(@ZeliardM)
- Add device fixture for P316M\(US\)
[\#1568](#1568)
(@TheLinuxGuy)
- Add L535E\(EU\) 3.0 1.1.8 fixture
[\#1545](#1545)
(@fantandrea)
- Adding KL400L10\(US\)\_1.0\_1.0.10 fixture
[\#1539](#1539) (@mjbohr)
- Add TP10\(IT\) 1.0 1.2.5 fixture
[\#1538](#1538)
(@emanueleg)
- Add LB100\(US\)\_1.0\_1.8.11 fixture file
[\#1515](#1515)
(@ZeliardM)
- Add KS225\(US\)\_1.0\_1.1.1 and L930-5\(EU\)\_1.0\_1.2.5
[\#1509](#1509)
(@ZeliardM)

**Documentation updates:**

- How to hash credentials to make use of --credentials-hash flag?
[\#1517](#1517)
- docs: modernize docstrings across the repository
[\#1682](#1682)
(@ZeliardM)
- Add a note to emeter guide being kasa-only
[\#1512](#1512)
(@rytilahti)

**Project maintenance:**

- Fix PyPI publishing for packages with metadata 2.5
[\#1779](#1779)
(@rytilahti)
- tests: add type annotations to top-level test files
[\#1688](#1688)
(@ZeliardM)
- tests: add type annotations to CLI, protocol, and smartcam tests
[\#1687](#1687)
(@ZeliardM)
- tests: add type annotations to Smart tests
[\#1686](#1686)
(@ZeliardM)
- tests: add type annotations to IoT tests
[\#1685](#1685)
(@ZeliardM)
- tests: add type annotations to transport tests
[\#1684](#1684)
(@ZeliardM)
- tests: centralize transport and session cleanup in conftest
[\#1683](#1683)
(@ZeliardM)
- ci: pin all GitHub Actions to SHA hashes and update versions
[\#1681](#1681)
(@ZeliardM)
- tests: fix typos, child device subtype, CLI patch path, and
deprecation test logic
[\#1677](#1677)
(@ZeliardM)
- Update GitHub Workflows and Actions
[\#1622](#1622)
(@ZeliardM)
- Use log-level debug for smartdevice query error reporting
[\#1587](#1587)
(@rytilahti)
- Use Device instead of SmartDevice where feasible
[\#1585](#1585)
(@ZeliardM)

**Closed issues:**

- Python 3.14 Support
[\#1597](#1597)
- HS300 Child State - Time Module Error
[\#1445](#1445)
pillarsdotnet pushed a commit to pillarsdotnet/python-kasa that referenced this pull request Oct 22, 2026
@epg-pers @davidefiocco
Add selective room cleaning to vacuum clean module (python-kasa#1660)
592f2b8
Adds support for selective room cleaning to the existing `Clean` module.

Co-authored-by: davidefiocco <[email protected]>
pillarsdotnet pushed a commit to pillarsdotnet/python-kasa that referenced this pull request Oct 30, 2026
@rytilahti
Prepare 0.11.0 (python-kasa#1776)
1189d3e
## [0.11.0](https://github.com/python-kasa/python-kasa/tree/0.11.0)
(2026-10-04)

[Full
Changelog](python-kasa/python-kasa@0.10.2...0.11.0)

**Release summary:**

This is a huge and long overdue release, coming more than a year and a
half after the previous one.
Hopefully the next one follows sooner, as the TPAP transport (which did
not make it into this release) is used more and more on newer devices.

This release brings broader camera support, new modules for lights,
vacuums and cameras, and many connectivity fixes for newer firmware
versions. Some other highlights:
- Improved Tapo camera support: login version 3, presets, wifi handling,
last alert detection, and more robust authentication and discovery.
- Selective room cleaning for robot vacuums.
- Configurable light strip length via the new strip segment module, and
an exposed light transition state change flag.
- Basic HomeKit module for Kasa (iot) devices.
- Energy monitoring V2 support (S515D).
- Better hub and thermostat state reporting (hold, summer mode, low
battery).
- Connection fixes for newer Tapo firmware and older SSL devices, plus
KLAP v2 for iot devices.
- More resilient time handling, with failover and UTC fallback for iot
devices.
- Python 3.14 is now supported.
- Inclusion of fixtures for 29 devices or firmware versions, including
the Tapo C460, C200 and C101 cameras and the KH100 hub with KE100/KE110
thermostats.

**Thank you to all contributors!**

A big thank you to everyone who contributed to this release, whether
through code, device fixtures, bug reports or testing.

Special thanks to @ZeliardM for a huge effort on both features and
project maintenance, including but not limited to:
- Features like the HomeKit module for iot devices, iot time module
failover, wifi handling and credential improvements for cameras, Tapo
login version 3, and V2 energy monitoring for S515D.
- A lot of necessary maintenance work including type annotations and
cleanups throughout the test suite, modernized docstrings, CI hardening
with SHA-pinned actions, and many bug fixes. This helps us to keep the
library maintainable and open to new contributions.

A warm welcome to our new contributors, with special thanks to those who
contributed improvements and fixes:
- @alams154: discovery on port 20004
- @bluntman001: iot device classification fix
- @bm1549: KLAP v2 transport for iot devices
- @darylldelfin: cipher support for newer Tapo firmware
- @davidefiocco: vacuum mop water level fix
- @epg-pers: selective room cleaning for vacuums
- @freeKC: camera discovery and authentication fixes
- @gpongelli: extended camera detection
- @Ikstar: KL420 color temperature range
- @juherr: last alert detection module for cameras, camera error codes
and a C200 fixture
- @kad: SSL connections to older devices
- @KaloyanNaumov: multi-request timeout handling
- @loganrosen: KL400L5 color temperature range
- @markvanpraet: Tapo C460 support and camera battery fix
- @monteccarlos: iot timezone mapping fix
- @mrwogu: preset support for Tapo cameras
- @nopoz: strip segment module, light transition flag and credentials
hash fix
- @tk1475: UTC fallback for unset iot device clocks
- @wh1t3f1r3: non-retryable network error handling

Thanks also to our new contributors who provided device fixtures to help
future development efforts: @emanueleg, @fantandrea, @HarryPehkonen,
@ijaron, @Krotu, @LostLuma, @mjbohr and @TheLinuxGuy.

**This release in numbers:**

- 68 merged pull requests from 29 contributors, 27 of them first-time
contributors
- 8 new modules
- 29 new device fixtures
- 203 files changed, with 25,199 lines added and 2,585 removed


**Implemented enhancements:**

- \[Feature Request\] C220 camera line crossing detection on-off switch
[\python-kasa#1551](python-kasa#1551)
- SslAesTransport: handshake again when a camera answers 401 to
passthrough
[\python-kasa#1771](python-kasa#1771) (@freeKC)
- Add LastAlertDetection module for smartcam devices
[\python-kasa#1762](python-kasa#1762) (@juherr)
- Add KL420 to TPLINK\_KELVIN color temperature ranges
[\python-kasa#1757](python-kasa#1757) (@Ikstar)
- Do not authenticate with a credentials\_hash from a different
transport [\python-kasa#1749](python-kasa#1749)
(@nopoz)
- Expose the light transition state change flag
[\python-kasa#1745](python-kasa#1745) (@nopoz)
- Add strip segment module for configurable light strip length
[\python-kasa#1744](python-kasa#1744) (@nopoz)
- Add KL400L5 color temperature range
[\python-kasa#1719](python-kasa#1719)
(@loganrosen)
- Update smartcam credential handling and tests
[\python-kasa#1664](python-kasa#1664)
(@ZeliardM)
- Add support for V2 Energy Monitoring for S515D
[\python-kasa#1663](python-kasa#1663)
(@ZeliardM)
- Add selective room cleaning to vacuum clean module
[\python-kasa#1660](python-kasa#1660)
(@epg-pers)
- New Wi-Fi handling for SMARTCAM devices
[\python-kasa#1639](python-kasa#1639)
(@ZeliardM)
- Add support for tapo login\_version 3 in sslaestransport
[\python-kasa#1638](python-kasa#1638)
(@ZeliardM)
- Add preset support for Tapo cameras
[\python-kasa#1615](python-kasa#1615) (@mrwogu)
- Add python 3.14 to supported versions
[\python-kasa#1599](python-kasa#1599)
(@rytilahti)
- Add discovery port 20004
[\python-kasa#1595](python-kasa#1595)
(@alams154)
- Implement IOT Time Module Failover
[\python-kasa#1583](python-kasa#1583)
(@ZeliardM)
- Add bare bones homekit module for iot devices
[\python-kasa#1566](python-kasa#1566)
(@ZeliardM)
- Extend smartcam detection support
[\python-kasa#1552](python-kasa#1552)
(@gpongelli)

**Fixed bugs:**

- Time module unavailable for waterleak sensor
[\python-kasa#1613](python-kasa#1613)
- 'No time zone found with key EST' in debian 13
[\python-kasa#1579](python-kasa#1579)
- Discovery: accept cameras that only send the encrypt\_type list
[\python-kasa#1770](python-kasa#1770) (@freeKC)
- Classify IOT devices via sysinfo regardless of transport \(fixes
\python-kasa#1740\) [\python-kasa#1769](python-kasa#1769)
(@bluntman001)
- Fall back to UTC for iot time when the device clock is not set
[\python-kasa#1768](python-kasa#1768) (@tk1475)
- Add UNKNOWN\_USERNAME \(-60502\) camera error code
[\python-kasa#1761](python-kasa#1761) (@juherr)
- Disable multi requests on timeout during multi-request
[\python-kasa#1759](python-kasa#1759)
(@KaloyanNaumov)
- Add ECDHE-RSA-AES256 cipher for newer Tapo firmware
[\python-kasa#1755](python-kasa#1755)
(@darylldelfin)
- Map iot timezone index 18 to America/New\_York instead of EST
[\python-kasa#1743](python-kasa#1743)
(@monteccarlos)
- fix: use KLAP v2 transport for IOT devices with login version 2
[\python-kasa#1731](python-kasa#1731) (@bm1549)
- Add ENETUNREACH to non-retryable errors in XorTransport
[\python-kasa#1668](python-kasa#1668)
(@wh1t3f1r3)
- Fix mop set\_waterlevel sending setCleanAttr without type field
[\python-kasa#1667](python-kasa#1667)
(@davidefiocco)
- Fix SMARTCAM Time module and update tests
[\python-kasa#1659](python-kasa#1659)
(@ZeliardM)
- Fix camera login version in CLI
[\python-kasa#1658](python-kasa#1658)
(@ZeliardM)
- Allow SSL connections to older devices
[\python-kasa#1654](python-kasa#1654) (@kad)
- waterleaksensor: use parent's Time for alert timestamp
[\python-kasa#1614](python-kasa#1614)
(@rytilahti)
- Add hold state to thermostatstate
[\python-kasa#1609](python-kasa#1609)
(@rytilahti)
- Fix thermostat idle reporting on low battery
[\python-kasa#1598](python-kasa#1598)
(@rytilahti)
- Add shutdown \(summer mode\) to thermostatstate
[\python-kasa#1588](python-kasa#1588)
(@rytilahti)
- Fix iotstrip child device time handling
[\python-kasa#1584](python-kasa#1584)
(@ZeliardM)

**Added support for devices:**

- Add C200 device fixture
[\python-kasa#1760](python-kasa#1760) (@juherr)
- Add P125M fixture for firmware 1.4.4
[\python-kasa#1746](python-kasa#1746)
(@HarryPehkonen)
- Add fixtures for KH100, KE100 and KE110 and simulate TRV states
[\python-kasa#1726](python-kasa#1726) (@Krotu)
- Add L530EA\(EU\) device fixture
[\python-kasa#1694](python-kasa#1694)
(@ZeliardM)
- Add C101 test fixture
[\python-kasa#1673](python-kasa#1673) (@ijaron)
- Add LB130\(US\) device fixture
[\python-kasa#1669](python-kasa#1669)
(@ZeliardM)
- Add KL110B\(UN\) device fixture
[\python-kasa#1657](python-kasa#1657)
(@ZeliardM)
- Add TS15\(US\) device fixture
[\python-kasa#1649](python-kasa#1649)
(@ZeliardM)
- Add Tapo C460 support
[\python-kasa#1645](python-kasa#1645)
(@markvanpraet)
- Add P105\(US\) device fixture
[\python-kasa#1644](python-kasa#1644)
(@ZeliardM)
- Add L430C\(EU\) device fixture
[\python-kasa#1643](python-kasa#1643)
(@ZeliardM)
- Add L430P\(EU\) device fixture
[\python-kasa#1607](python-kasa#1607)
(@LostLuma)
- Add S500\(US\)\_1.0\_1.2.0 fixture
[\python-kasa#1569](python-kasa#1569)
(@ZeliardM)
- Add device fixture for P316M\(US\)
[\python-kasa#1568](python-kasa#1568)
(@TheLinuxGuy)
- Add L535E\(EU\) 3.0 1.1.8 fixture
[\python-kasa#1545](python-kasa#1545)
(@fantandrea)
- Adding KL400L10\(US\)\_1.0\_1.0.10 fixture
[\python-kasa#1539](python-kasa#1539) (@mjbohr)
- Add TP10\(IT\) 1.0 1.2.5 fixture
[\python-kasa#1538](python-kasa#1538)
(@emanueleg)
- Add LB100\(US\)\_1.0\_1.8.11 fixture file
[\python-kasa#1515](python-kasa#1515)
(@ZeliardM)
- Add KS225\(US\)\_1.0\_1.1.1 and L930-5\(EU\)\_1.0\_1.2.5
[\python-kasa#1509](python-kasa#1509)
(@ZeliardM)

**Documentation updates:**

- How to hash credentials to make use of --credentials-hash flag?
[\python-kasa#1517](python-kasa#1517)
- docs: modernize docstrings across the repository
[\python-kasa#1682](python-kasa#1682)
(@ZeliardM)
- Add a note to emeter guide being kasa-only
[\python-kasa#1512](python-kasa#1512)
(@rytilahti)

**Project maintenance:**

- tests: add type annotations to top-level test files
[\python-kasa#1688](python-kasa#1688)
(@ZeliardM)
- tests: add type annotations to CLI, protocol, and smartcam tests
[\python-kasa#1687](python-kasa#1687)
(@ZeliardM)
- tests: add type annotations to Smart tests
[\python-kasa#1686](python-kasa#1686)
(@ZeliardM)
- tests: add type annotations to IoT tests
[\python-kasa#1685](python-kasa#1685)
(@ZeliardM)
- tests: add type annotations to transport tests
[\python-kasa#1684](python-kasa#1684)
(@ZeliardM)
- tests: centralize transport and session cleanup in conftest
[\python-kasa#1683](python-kasa#1683)
(@ZeliardM)
- ci: pin all GitHub Actions to SHA hashes and update versions
[\python-kasa#1681](python-kasa#1681)
(@ZeliardM)
- tests: fix typos, child device subtype, CLI patch path, and
deprecation test logic
[\python-kasa#1677](python-kasa#1677)
(@ZeliardM)
- Update GitHub Workflows and Actions
[\python-kasa#1622](python-kasa#1622)
(@ZeliardM)
- Use log-level debug for smartdevice query error reporting
[\python-kasa#1587](python-kasa#1587)
(@rytilahti)
- Use Device instead of SmartDevice where feasible
[\python-kasa#1585](python-kasa#1585)
(@ZeliardM)

**Closed issues:**

- Python 3.14 Support
[\python-kasa#1597](python-kasa#1597)
- HS300 Child State - Time Module Error
[\python-kasa#1445](python-kasa#1445)
pillarsdotnet pushed a commit to pillarsdotnet/python-kasa that referenced this pull request Oct 30, 2026
@rytilahti
Prepare 0.11.0.1 (python-kasa#1780)
577b3f7
## [0.11.0.1](https://github.com/python-kasa/python-kasa/tree/0.11.0.1)
(2026-10-04)

[Full
Changelog](python-kasa/python-kasa@0.10.2...0.11.0.1)

**Release summary:**

*Note: 0.11.0 was tagged but never published to PyPI due to a packaging
issue. 0.11.0.1 contains the same changes plus a fix for the release
workflow.*

This is a huge and long overdue release, coming more than a year and a
half after the previous one.
Hopefully the next one follows sooner, as the TPAP transport (which did
not make it into this release) is used more and more on newer devices.

This release brings broader camera support, new modules for lights,
vacuums and cameras, and many connectivity fixes for newer firmware
versions. Some other highlights:
- Improved Tapo camera support: login version 3, presets, wifi handling,
last alert detection, and more robust authentication and discovery.
- Selective room cleaning for robot vacuums.
- Configurable light strip length via the new strip segment module, and
an exposed light transition state change flag.
- Basic HomeKit module for Kasa (iot) devices.
- Energy monitoring V2 support (S515D).
- Better hub and thermostat state reporting (hold, summer mode, low
battery).
- Connection fixes for newer Tapo firmware and older SSL devices, plus
KLAP v2 for iot devices.
- More resilient time handling, with failover and UTC fallback for iot
devices.
- Python 3.14 is now supported.
- Inclusion of fixtures for 29 devices or firmware versions, including
the Tapo C460, C200 and C101 cameras and the KH100 hub with KE100/KE110
thermostats.

**Thank you to all contributors!**

A big thank you to everyone who contributed to this release, whether
through code, device fixtures, bug reports or testing.

Special thanks to @ZeliardM for a huge effort on both features and
project maintenance, including but not limited to:
- Features like the HomeKit module for iot devices, iot time module
failover, wifi handling and credential improvements for cameras, Tapo
login version 3, and V2 energy monitoring for S515D.
- A lot of necessary maintenance work including type annotations and
cleanups throughout the test suite, modernized docstrings, CI hardening
with SHA-pinned actions, and many bug fixes. This helps us to keep the
library maintainable and open to new contributions.

A warm welcome to our new contributors, with special thanks to those who
contributed improvements and fixes:
- @alams154: discovery on port 20004
- @bluntman001: iot device classification fix
- @bm1549: KLAP v2 transport for iot devices
- @darylldelfin: cipher support for newer Tapo firmware
- @davidefiocco: vacuum mop water level fix
- @epg-pers: selective room cleaning for vacuums
- @freeKC: camera discovery and authentication fixes
- @gpongelli: extended camera detection
- @Ikstar: KL420 color temperature range
- @juherr: last alert detection module for cameras, camera error codes
and a C200 fixture
- @kad: SSL connections to older devices
- @KaloyanNaumov: multi-request timeout handling
- @loganrosen: KL400L5 color temperature range
- @markvanpraet: Tapo C460 support and camera battery fix
- @monteccarlos: iot timezone mapping fix
- @mrwogu: preset support for Tapo cameras
- @nopoz: strip segment module, light transition flag and credentials
hash fix
- @tk1475: UTC fallback for unset iot device clocks
- @wh1t3f1r3: non-retryable network error handling

Thanks also to our new contributors who provided device fixtures to help
future development efforts: @emanueleg, @fantandrea, @HarryPehkonen,
@ijaron, @Krotu, @LostLuma, @mjbohr and @TheLinuxGuy.

**This release in numbers:**

- 68 merged pull requests from 29 contributors, 27 of them first-time
contributors
- 8 new modules
- 29 new device fixtures
- 203 files changed, with 25,199 lines added and 2,585 removed


**Implemented enhancements:**

- \[Feature Request\] C220 camera line crossing detection on-off switch
[\python-kasa#1551](python-kasa#1551)
- SslAesTransport: handshake again when a camera answers 401 to
passthrough
[\python-kasa#1771](python-kasa#1771) (@freeKC)
- Add LastAlertDetection module for smartcam devices
[\python-kasa#1762](python-kasa#1762) (@juherr)
- Add KL420 to TPLINK\_KELVIN color temperature ranges
[\python-kasa#1757](python-kasa#1757) (@Ikstar)
- Do not authenticate with a credentials\_hash from a different
transport [\python-kasa#1749](python-kasa#1749)
(@nopoz)
- Expose the light transition state change flag
[\python-kasa#1745](python-kasa#1745) (@nopoz)
- Add strip segment module for configurable light strip length
[\python-kasa#1744](python-kasa#1744) (@nopoz)
- Add KL400L5 color temperature range
[\python-kasa#1719](python-kasa#1719)
(@loganrosen)
- Update smartcam credential handling and tests
[\python-kasa#1664](python-kasa#1664)
(@ZeliardM)
- Add support for V2 Energy Monitoring for S515D
[\python-kasa#1663](python-kasa#1663)
(@ZeliardM)
- Add selective room cleaning to vacuum clean module
[\python-kasa#1660](python-kasa#1660)
(@epg-pers)
- New Wi-Fi handling for SMARTCAM devices
[\python-kasa#1639](python-kasa#1639)
(@ZeliardM)
- Add support for tapo login\_version 3 in sslaestransport
[\python-kasa#1638](python-kasa#1638)
(@ZeliardM)
- Add preset support for Tapo cameras
[\python-kasa#1615](python-kasa#1615) (@mrwogu)
- Add python 3.14 to supported versions
[\python-kasa#1599](python-kasa#1599)
(@rytilahti)
- Add discovery port 20004
[\python-kasa#1595](python-kasa#1595)
(@alams154)
- Implement IOT Time Module Failover
[\python-kasa#1583](python-kasa#1583)
(@ZeliardM)
- Add bare bones homekit module for iot devices
[\python-kasa#1566](python-kasa#1566)
(@ZeliardM)
- Extend smartcam detection support
[\python-kasa#1552](python-kasa#1552)
(@gpongelli)

**Fixed bugs:**

- Time module unavailable for waterleak sensor
[\python-kasa#1613](python-kasa#1613)
- 'No time zone found with key EST' in debian 13
[\python-kasa#1579](python-kasa#1579)
- Discovery: accept cameras that only send the encrypt\_type list
[\python-kasa#1770](python-kasa#1770) (@freeKC)
- Classify IOT devices via sysinfo regardless of transport \(fixes
\python-kasa#1740\) [\python-kasa#1769](python-kasa#1769)
(@bluntman001)
- Fall back to UTC for iot time when the device clock is not set
[\python-kasa#1768](python-kasa#1768) (@tk1475)
- Add UNKNOWN\_USERNAME \(-60502\) camera error code
[\python-kasa#1761](python-kasa#1761) (@juherr)
- Disable multi requests on timeout during multi-request
[\python-kasa#1759](python-kasa#1759)
(@KaloyanNaumov)
- Add ECDHE-RSA-AES256 cipher for newer Tapo firmware
[\python-kasa#1755](python-kasa#1755)
(@darylldelfin)
- Map iot timezone index 18 to America/New\_York instead of EST
[\python-kasa#1743](python-kasa#1743)
(@monteccarlos)
- fix: use KLAP v2 transport for IOT devices with login version 2
[\python-kasa#1731](python-kasa#1731) (@bm1549)
- Add ENETUNREACH to non-retryable errors in XorTransport
[\python-kasa#1668](python-kasa#1668)
(@wh1t3f1r3)
- Fix mop set\_waterlevel sending setCleanAttr without type field
[\python-kasa#1667](python-kasa#1667)
(@davidefiocco)
- Fix SMARTCAM Time module and update tests
[\python-kasa#1659](python-kasa#1659)
(@ZeliardM)
- Fix camera login version in CLI
[\python-kasa#1658](python-kasa#1658)
(@ZeliardM)
- Allow SSL connections to older devices
[\python-kasa#1654](python-kasa#1654) (@kad)
- waterleaksensor: use parent's Time for alert timestamp
[\python-kasa#1614](python-kasa#1614)
(@rytilahti)
- Add hold state to thermostatstate
[\python-kasa#1609](python-kasa#1609)
(@rytilahti)
- Fix thermostat idle reporting on low battery
[\python-kasa#1598](python-kasa#1598)
(@rytilahti)
- Add shutdown \(summer mode\) to thermostatstate
[\python-kasa#1588](python-kasa#1588)
(@rytilahti)
- Fix iotstrip child device time handling
[\python-kasa#1584](python-kasa#1584)
(@ZeliardM)

**Added support for devices:**

- Add C200 device fixture
[\python-kasa#1760](python-kasa#1760) (@juherr)
- Add P125M fixture for firmware 1.4.4
[\python-kasa#1746](python-kasa#1746)
(@HarryPehkonen)
- Add fixtures for KH100, KE100 and KE110 and simulate TRV states
[\python-kasa#1726](python-kasa#1726) (@Krotu)
- Add L530EA\(EU\) device fixture
[\python-kasa#1694](python-kasa#1694)
(@ZeliardM)
- Add C101 test fixture
[\python-kasa#1673](python-kasa#1673) (@ijaron)
- Add LB130\(US\) device fixture
[\python-kasa#1669](python-kasa#1669)
(@ZeliardM)
- Add KL110B\(UN\) device fixture
[\python-kasa#1657](python-kasa#1657)
(@ZeliardM)
- Add TS15\(US\) device fixture
[\python-kasa#1649](python-kasa#1649)
(@ZeliardM)
- Add Tapo C460 support
[\python-kasa#1645](python-kasa#1645)
(@markvanpraet)
- Add P105\(US\) device fixture
[\python-kasa#1644](python-kasa#1644)
(@ZeliardM)
- Add L430C\(EU\) device fixture
[\python-kasa#1643](python-kasa#1643)
(@ZeliardM)
- Add L430P\(EU\) device fixture
[\python-kasa#1607](python-kasa#1607)
(@LostLuma)
- Add S500\(US\)\_1.0\_1.2.0 fixture
[\python-kasa#1569](python-kasa#1569)
(@ZeliardM)
- Add device fixture for P316M\(US\)
[\python-kasa#1568](python-kasa#1568)
(@TheLinuxGuy)
- Add L535E\(EU\) 3.0 1.1.8 fixture
[\python-kasa#1545](python-kasa#1545)
(@fantandrea)
- Adding KL400L10\(US\)\_1.0\_1.0.10 fixture
[\python-kasa#1539](python-kasa#1539) (@mjbohr)
- Add TP10\(IT\) 1.0 1.2.5 fixture
[\python-kasa#1538](python-kasa#1538)
(@emanueleg)
- Add LB100\(US\)\_1.0\_1.8.11 fixture file
[\python-kasa#1515](python-kasa#1515)
(@ZeliardM)
- Add KS225\(US\)\_1.0\_1.1.1 and L930-5\(EU\)\_1.0\_1.2.5
[\python-kasa#1509](python-kasa#1509)
(@ZeliardM)

**Documentation updates:**

- How to hash credentials to make use of --credentials-hash flag?
[\python-kasa#1517](python-kasa#1517)
- docs: modernize docstrings across the repository
[\python-kasa#1682](python-kasa#1682)
(@ZeliardM)
- Add a note to emeter guide being kasa-only
[\python-kasa#1512](python-kasa#1512)
(@rytilahti)

**Project maintenance:**

- Fix PyPI publishing for packages with metadata 2.5
[\python-kasa#1779](python-kasa#1779)
(@rytilahti)
- tests: add type annotations to top-level test files
[\python-kasa#1688](python-kasa#1688)
(@ZeliardM)
- tests: add type annotations to CLI, protocol, and smartcam tests
[\python-kasa#1687](python-kasa#1687)
(@ZeliardM)
- tests: add type annotations to Smart tests
[\python-kasa#1686](python-kasa#1686)
(@ZeliardM)
- tests: add type annotations to IoT tests
[\python-kasa#1685](python-kasa#1685)
(@ZeliardM)
- tests: add type annotations to transport tests
[\python-kasa#1684](python-kasa#1684)
(@ZeliardM)
- tests: centralize transport and session cleanup in conftest
[\python-kasa#1683](python-kasa#1683)
(@ZeliardM)
- ci: pin all GitHub Actions to SHA hashes and update versions
[\python-kasa#1681](python-kasa#1681)
(@ZeliardM)
- tests: fix typos, child device subtype, CLI patch path, and
deprecation test logic
[\python-kasa#1677](python-kasa#1677)
(@ZeliardM)
- Update GitHub Workflows and Actions
[\python-kasa#1622](python-kasa#1622)
(@ZeliardM)
- Use log-level debug for smartdevice query error reporting
[\python-kasa#1587](python-kasa#1587)
(@rytilahti)
- Use Device instead of SmartDevice where feasible
[\python-kasa#1585](python-kasa#1585)
(@ZeliardM)

**Closed issues:**

- Python 3.14 Support
[\python-kasa#1597](python-kasa#1597)
- HS300 Child State - Time Module Error
[\python-kasa#1445](python-kasa#1445)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@rytilahti rytilahti rytilahti approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

enhancement New feature or request

Projects

None yet

Milestone

0.11

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

3 participants

@epg-pers @davidefiocco @rytilahti
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.