Skip to content

✨ New Features

Choose a tag to compare

View all tags
@cataseven cataseven released this 22 May 08:03
v1.2.9
c2c2c9c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

📊 4G / LTE data usage tracking (#47)

If your router has a USB cellular modem (any UsbLte / UsbModem /
UsbQmi interface) and you've enabled the "Data Usage & Limit"
feature in the Keenetic web UI, you now get a full picture of your
plan's usage directly in Home Assistant.

Six new sensors per cellular WAN

  • Data Used — month-to-date usage in GB. Hooked into HA's
    long-term statistics, so a Statistics card on your dashboard
    charts daily and monthly growth automatically.
  • Data Remaining — how many GB are left in your plan.
  • Data Limit — the limit you set in the router.
  • Data Threshold — the warning threshold (typically 90 % of the
    limit).
  • Days Until Reset — countdown to the monthly counter rollover.
  • Quota Usage — current usage as a percentage of the limit,
    updated as soon as the counter ticks.

Two automatic alarms

  • Data Limit Exceeded — flips on when the hard limit is hit.
    Use it to send a notification, switch off a non-essential WiFi
    network, or pause downloads.
  • Data Threshold Exceeded — flips on when the warning level is
    reached. Perfect for an early "slow down" alert before the limit
    kicks in.

Bonus: cellular signal telemetry

You also get a full block of diagnostic sensors describing the
cellular link itself: operator name, current technology
(4G / 5G / 3G / 2G), signal bars, RSSI, RSRP, RSRQ, CINR, current
band, roaming status, modem temperature, connection state, and APN.
This is what lets you understand why speeds drop at certain times
of day — usually a tower handoff or worsening signal that the byte
counters alone can't explain.

All of these appear automatically on the cellular WAN sub-device.
Routers without a USB modem just don't see them.

🎛️ Per-device bandwidth limiting (#42)

You can now set a download / upload speed cap on any tracked
client directly from Home Assistant, no need to log into the
Keenetic web UI for it.

How it works

Open any tracked client device card. You'll see two new controls:

  • Bandwidth Limit — a slider (and direct-entry box) that sets
    the cap in kbit/s. Default range goes up to 100 000 (≈100 Mbit/s);
    you can type higher values for faster connections.
  • Clear Bandwidth Limit — a one-tap button that removes the cap
    entirely, equivalent to "Disable" in the Keenetic web UI.

The limit is saved to the router's running config the moment you
apply it, so it survives a reboot. Whatever you set here also shows
up in the Keenetic web UI's per-device settings — they stay in sync.

Why two controls

Home Assistant's slider entity always requires a value when you
apply it. If you clear the input box and click Apply, HA shows an
error. The button gives you a clean one-tap way to remove the
limit without thinking about what number to type.

Tip

Set a low cap on guest devices to keep them from saturating your
connection, or use an automation to drop bandwidth on a media
streamer during work hours and restore it in the evening.

Assets 3
Loading