github rwoldberg/ldata-ha v.2.0.1
Out of RC and into the World with Additional Diagnostic Data

one day ago

This release leaves the 'release candidates' behind and recommends upgrading to LWHEM firmware v2.0.13 if supported.

v2.0.1 Changes:

  • New Diagnostic Sensors: Panels get RSSI, overVoltage, underVoltage. Breakers get operationalState, overCurrent, overVoltage, underVoltage, bleRSSI.

Over the last month the RC line has seen a lot of change

Key takeaway's from v1.1.35 to v2.0.1 are:

  1. Shift from frequent 'polling' (asking Leviton for updates weather data has changed or not) to 'Websockets' (live subscription stream as values change). NOTE Poll Rate (asking) has been replaced with HA Inform Rate (this tells HA when values need to be stored). Since Websockets is a live stream it can easily overwhelm HA and local hardware.

How do I choose HA Inform Rate? (Default 30 sec)
• Too aggressive (short interval): increases CPU/memory load, DB writes (impacting SD/ssd endurance), and can overwhelm local hardware — especially on smaller platforms.
• Too conservative (Long interval): stale data, slower detection of device state changes, delayed config pushes
• Recommended starting point: 30–60s for most deployments; adjust based on device count and hardware capability
• Monitor resource usage (CPU, memory, DB writes) after any HA inform rate change and adjust accordingly

  1. "Read Only" option renamed to "Allow Breaker Control" (off by default — If you need breaker control you must enable this!)

  2. Support for LWHEM v2.0.13 firmware

Summary of changes across v2.0.0 Release Candidates

v2.0.0-rc1 — Websocket Release Candidate (Feb 12)

The big architectural shift: moved from polling to WebSockets for near-realtime updates (dependent on the "HA inform rate" setting). Key changes:

  • Near-realtime data updates instead of periodic API polling — a major change aimed at reducing Leviton server load (which was the concern that prompted the polling interval changes in 1.1.34/1.1.35)
  • New configurable HA Inform Rate (default 30 sec), with guidance to balance responsiveness vs. local hardware load (CPU, memory, DB writes, SD card endurance)
  • "Read Only" option renamed to "Allow Breaker Control" (off by default — must re-enable if needed)
  • Significant backend rewrite

v2.0.0-rc2 (Feb 18)

  • Improved support for multi-panel and mixed-panel setups
  • Preliminary support for LWHEM 2.0.13 firmware (with a warning to hold off upgrading firmware from 1.7.6 due to Leviton backend data field issues)

v2.0.0-rc3 (Feb 22)

  • Fixed a CT Daily Total update issue
  • General code optimization and cleanup

v2.0.0-rc4 (Feb 24)

  • Added user-configurable Gap Handling options (how data gaps are handled in energy calculations)
  • Various backend optimizations

v2.0.0-rc5 — New Hardware Counters (Feb 26)

  • Support for Leviton's newly exposed hardware energy counters at the per-breaker level (not just CTs). With firmware 2.0.13 (and possibly 1.7.6), this eliminates the need for "power × time" calculations and gap handling workarounds
  • New lifetime accumulating Import/Consumption sensors auto-created for breakers that report the new energyConsumption and energyImport fields
  • total_daily sensors now operate in dual mode: power × time for legacy panels, delta-between-lifetime-readings for panels with hardware counters
  • Gap Handling automatically hidden when hardware counters are detected
  • Further reduction in API calls
  • Added verbose WebSocket debug logging (to help identify which setups have the new hardware counters)

Don't miss a new ldata-ha release

NewReleases is sending notifications on new releases.