## [0.1.5] - 2026-03-01

### Added
- Added long-term statistics support for battery-related sensors.
- Battery voltage and battery percentage sensors are now marked as measurement
  sensors, enabling Home Assistant long-term statistics and historical trends.
- Added `battery_percent_rechargeable` sensor to provide a more realistic battery
  level estimation when using rechargeable batteries (e.g. NiMH).

### Changed
- Improved battery sensor metadata to align with Home Assistant best practices
  for long-term statistics (state class and measurement semantics).
- Clarified separation between vendor-style battery percentage and
  rechargeable battery estimation.

Author: fwmone

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.1.5] - 2026-03-01
+
+### Added
+- Added long-term statistics support for battery-related sensors.
+- Battery voltage and battery percentage sensors are now marked as measurement
+  sensors, enabling Home Assistant long-term statistics and historical trends.
+- Added `battery_percent_rechargeable` sensor to provide a more realistic battery
+  level estimation when using rechargeable batteries (e.g. NiMH).
+
+### Changed
+- Improved battery sensor metadata to align with Home Assistant best practices
+  for long-term statistics (state class and measurement semantics).
+- Clarified separation between vendor-style battery percentage and
+  rechargeable battery estimation.
+
 ## [0.1.4] - 2026-02-17
 
 ### Added

custom_components/paperlesspaper_push/device_sensors.py

@@ -4,7 +4,7 @@
 from datetime import datetime, timezone
 from typing import Any, Callable, Optional
 
-from homeassistant.components.sensor import SensorEntity, SensorDeviceClass
+from homeassistant.components.sensor import SensorEntity, SensorDeviceClass, SensorStateClass
 from homeassistant.const import PERCENTAGE, UnitOfElectricPotential
 from homeassistant.helpers.update_coordinator import CoordinatorEntity
 from homeassistant.helpers.entity import Entity
@@ -85,6 +85,8 @@ class _SensorDef:
     name: str
     device_class: SensorDeviceClass | None = None
     unit: str | None = None
+    state_class: SensorStateClass | None = None
+    suggested_display_precision: int | None = None
     value_fn: Callable[[dict], Any] = lambda d: None
 
 
@@ -94,20 +96,26 @@ class _SensorDef:
         name="Battery Voltage",
         device_class=SensorDeviceClass.VOLTAGE,
         unit=UnitOfElectricPotential.VOLT,
+        state_class=SensorStateClass.MEASUREMENT,
+        suggested_display_precision=2,
         value_fn=lambda d: _battery_voltage_v(_get_bat_mv(d)),
     ),
     _SensorDef(
         key="battery_percent",
         name="Battery",
         device_class=SensorDeviceClass.BATTERY,
         unit=PERCENTAGE,
+        state_class=SensorStateClass.MEASUREMENT,
+        suggested_display_precision=0,
         value_fn=lambda d: _battery_percent_from_mv(_get_bat_mv(d)),
     ),
     _SensorDef(
         key="battery_percent_rechargeable",
         name="Battery (Rechargeable)",
         device_class=SensorDeviceClass.BATTERY,
         unit=PERCENTAGE,
+        state_class=SensorStateClass.MEASUREMENT,
+        suggested_display_precision=0,
         value_fn=lambda d: _battery_percent_nimh(_get_bat_mv(d)),
     ),
     _SensorDef(
@@ -147,6 +155,13 @@ def __init__(self, coordinator, sensor_def: _SensorDef, unique_prefix: str):
         self._attr_name = sensor_def.name
         self._attr_device_class = sensor_def.device_class
         self._attr_native_unit_of_measurement = sensor_def.unit
+
+        if sensor_def.state_class:
+            self._attr_state_class = sensor_def.state_class
+
+        if sensor_def.suggested_display_precision is not None:
+            self._attr_suggested_display_precision = sensor_def.suggested_display_precision
+
         self._attr_suggested_object_id = f"{DOMAIN}_{sensor_def.key}"
 
     @property

custom_components/paperlesspaper_push/manifest.json

@@ -1,7 +1,7 @@
 {
   "domain": "paperlesspaper_push",
   "name": "paperlesspaper Push",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "documentation": "https://github.com/fwmone/paperlesspaper_push",
   "issue_tracker": "https://github.com/fwmone/paperlesspaper_push/issues",  
   "requirements": [],