Merge release v2.0.2

Author: github-actions[bot]

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 2.0.2
+
+- **Fixed** EMA smoother slowing down across zero-crossings when `SMOOTH_TARGET_ALPHA` was configured above 0.5: the sign-flip "catchup" branch capped the effective alpha at 0.5, which actually reduced responsiveness for users who picked a larger alpha (e.g. 1.0 for near-instant tracking). The catchup boost now never drops below the configured alpha ([#371](https://github.com/tomquist/astrameter/issues/371)).
+
 ## 2.0.1
 
 - **Fixed** false "Home Assistant sensor is stale" errors for sensors that update infrequently or push only on value changes — including constant readings (e.g. solar production at night) and push-based integrations. The Home Assistant powermeter now treats a sensor as stale only when Home Assistant itself marks it `unavailable`/`unknown` or the websocket connection is lost ([#363](https://github.com/tomquist/astrameter/issues/363)).

README.md

@@ -1012,6 +1012,8 @@ A: Ports below 1024 require root privileges on Linux. Solutions:
 - Use `setcap` to grant permissions
 - Run as root (not recommended)
 
+Note: the Docker image runs as a non-root user, so binding port 1010 (used by `shellypro3em_old` and the combined `shellypro3em`, which starts both listeners) still fails with `PermissionError: [Errno 13]` under `network_mode: host`. Port 2220 (`shellypro3em_new`) is unaffected. Either lower the host's privileged-port range (`sudo sysctl -w net.ipv4.ip_unprivileged_port_start=1010`, persist via `/etc/sysctl.d/`) or run the container as root (`user: "0:0"` in compose). Publishing the port via bridge networking does **not** work, because the Marstek discovery packets are UDP broadcasts to the subnet address and aren't forwarded by Docker's port mapping.
+
 ### I get parsing errors on startup or the app crashes.
 
 A: Common causes:

ha_addon/config.yaml

@@ -1,5 +1,5 @@
 name: "AstraMeter"
-version: "2.0.1"
+version: "2.0.2"
 slug: b2500_meter
 description: >-
   "Replicates a Smart Meter device for Marstek energy storage systems (formerly B2500 Meter) while allowing integration with various smart meters."

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "astrameter"
-version = "2.0.1"
+version = "2.0.2"
 description = "Power-meter monitoring for Marstek battery inverters (formerly b2500-meter)"
 readme = "README.md"
 requires-python = ">=3.10"

src/astrameter/ct002/balancer.py

@@ -907,7 +907,8 @@ def _compute_auto_target(
         if all_dc_under_surplus and not self._all_dc_surplus_warned:
             logger.info(
                 "CT002: %.0f W surplus but no AC-chargeable battery "
-                "reporting — holding all at 0 W. Reporting device_types: %s",
+                "reporting — nothing here can absorb it. Reporting "
+                "device_types: %s",
                 -grid_total,
                 sorted({reports[cid].get("device_type", "") or "?" for cid in reports}),
             )

src/astrameter/powermeter/wrappers/smoothing.py

@@ -74,7 +74,7 @@ async def get_powermeter_watts(self) -> list[float]:
 
         catchup_alpha = self._alpha
         if (raw_total > 0) != (self._value > 0):
-            catchup_alpha = min(0.5, self._alpha * 4)
+            catchup_alpha = max(self._alpha, min(0.5, self._alpha * 4))
         delta = catchup_alpha * (raw_total - self._value)
 
         if self._max_step > 0:

src/astrameter/powermeter/wrappers/smoothing_test.py

@@ -82,10 +82,27 @@ async def test_sign_change_catchup(self):
         # Sign flip: raw goes negative
         fake.set([-100.0])
         await sm.get_powermeter_watts()
-        # catchup_alpha = min(0.5, 0.1 * 4) = 0.4
+        # catchup_alpha = max(0.1, min(0.5, 0.1 * 4)) = 0.4
         # delta = 0.4 * (-100 - 100) = -80 → new = 20
         assert sm.smoothed_value == pytest.approx(20.0)
 
+    @pytest.mark.asyncio
+    async def test_sign_change_does_not_slow_high_alpha(self):
+        fake = FakePowermeter([1.0])
+        sm = SmoothedPowermeter(fake, alpha=1.0)
+
+        await sm.get_powermeter_watts()
+        assert sm.smoothed_value == 1.0
+
+        # Sign flip: the catchup branch must not reduce alpha below the
+        # configured value, otherwise large user-chosen alphas (e.g. 1.0)
+        # respond slower across zero-crossings than they do anywhere else.
+        fake.set([-99.0])
+        await sm.get_powermeter_watts()
+        # catchup_alpha = max(1.0, min(0.5, 4.0)) = 1.0
+        # delta = 1.0 * (-99 - 1) = -100 → new = -99
+        assert sm.smoothed_value == pytest.approx(-99.0)
+
     @pytest.mark.asyncio
     async def test_max_step_limits_delta(self):
         fake = FakePowermeter([100.0])