Skip to content

Refactor discovery and connection routing #1725

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
ZeliardM wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

Refactor discovery and connection routing #1725

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,9 @@ If your device requires authentication to control it,
you need to pass the credentials using `--username` and `--password` options or define `KASA_USERNAME` and `KASA_PASSWORD` environment variables.

> [!NOTE]
> If your system has multiple network interfaces, you can specify the broadcast address using the `--target` option.
> If your system has multiple network interfaces, specify the subnet broadcast
> address with `--target`, for example
> `kasa --target 192.168.1.255 discover`.

The `discover` command will automatically execute the `state` command on all the discovered devices:

Expand Down Expand Up @@ -187,7 +189,7 @@ The following devices have been tested and confirmed as working. If your device
### Supported Kasa devices

- **Plugs**: EP10, EP25[^2], HS100[^2], HS103, HS105, HS110, KP100, KP105, KP115, KP125, KP125M[^1], KP401
- **Power Strips**: EP40, EP40M[^1], HS107, HS300, KP200, KP303, KP400
- **Power Strips**: EP40, EP40M[^1], HS107, HS300[^2], KP200, KP303, KP400
- **Wall Switches**: ES20M, HS200[^2], HS210, HS220[^2], KP405, KS200, KS200M, KS205[^1], KS220, KS220M, KS225[^1], KS230, KS240[^1]
- **Bulbs**: KL110, KL110B, KL120, KL125, KL130, KL135, KL50, KL60, LB100, LB110, LB130
- **Light Strips**: KL400L10, KL400L5, KL420L5, KL430
Expand Down
1 change: 1 addition & 0 deletions SUPPORTED.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,7 @@ Some newer Kasa devices require authentication. These are marked with [^1] in th
- Hardware: 1.0 (US) / Firmware: 1.0.21
- Hardware: 2.0 (US) / Firmware: 1.0.12
- Hardware: 2.0 (US) / Firmware: 1.0.3
- Hardware: 2.0 (US) / Firmware: 1.1.2[^1]
- **KP200**
- Hardware: 3.0 (US) / Firmware: 1.0.3
- **KP303**
Expand Down
43 changes: 35 additions & 8 deletions devtools/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,8 @@
This directory contains some simple scripts that can be useful for developers.

## dump_devinfo
* Queries the device (if --host is given) or discover devices and creates fixture files that can be added to the test suite.
* Queries one device with `--host`, or discovers devices with `--target`, and creates fixture files that can be added to the test suite.
* Direct connection options are available for devices that cannot be discovered.

```shell
Usage: python -m devtools.dump_devinfo [OPTIONS]
Expand All @@ -13,14 +14,40 @@ Usage: python -m devtools.dump_devinfo [OPTIONS]
Use --host (for a single device) or --target (for a complete network).

Options:
--host TEXT Target host.
--target TEXT Target network for discovery.
--username TEXT Username/email address to authenticate to device.
--password TEXT Password to use to authenticate to device.
--basedir TEXT Base directory for the git repository
--autosave Save without prompting
--host TEXT Target host.
--target TEXT Target network for discovery.
--username TEXT Username/email address to authenticate to
device.
--password TEXT Password to use to authenticate to device.
--credentials-hash TEXT Hashed credentials used to authenticate to
the device.
--basedir TEXT Base directory for the git repository
--autosave Save without prompting
--batch-size INTEGER Number of batched requests to send at once
-d, --debug
--help Show this message and exit.
-di, --discovery-info TEXT Bypass discovery by passing an accurate
discovery result json escaped string. Do not
use this flag unless you are sure you know
what it means.
--discovery-timeout INTEGER Timeout for discovery. [default: 10]
-df, --device-family [iot.smartplugswitch|iot.smartbulb|iot.ipcamera|smart.kasaplug|smart.kasaswitch|smart.tapoplug|smart.tapobulb|smart.taposwitch|smart.tapohub|smart.kasahub|smart.ipcamera|smart.taporobovac|smart.tapochime|smart.tapodoorbell]
Exact device family for an advanced direct
connection.
-e, --encrypt-type [klap|aes|xor]
Encryption type for an advanced direct
connection.
-lv, --login-version INTEGER RANGE
Login version for an advanced direct
connection. [x>=1]
-kv, --klap-version INTEGER RANGE
IOT KLAP handshake version for an advanced
direct connection. [x>=1]
--https / --no-https Whether an advanced direct connection uses
HTTPS.
--timeout INTEGER Timeout for queries.
--port INTEGER RANGE Connection and UDP discovery port override.
[1<=x<=65535]
--help Show this message and exit.
```

## create_module_fixtures
Expand Down
Loading
Loading