Battery Health Tracker

Features 🔬 Low-Level BMS & Kernel Telemetry (via Shizuku) Direct Fuel Gauge Queries: Reads physical registers directly from /sys/class/oplus_chg/battery/ and /sys/class/power_supply/battery/. True State of Health (SOH): Real electrochemical capacity evaluated against nominal factory design capacity. Hardware Cycle Counter: Reads non-volatile cycles tracked by the physical fuel gauge IC (immune to OS battery stat wipes). Dual-Cell SuperVOOC Monitoring: Individual cell voltages (cell0Volt, cell1Volt) and series balance Δ mV . ⚡ True Full Charge vs Display 100% CC/CV Saturation Tracking: Distinguishes between the display "100%" (often end of Constant Current at ~90% saturation) and True Full Charge when Constant Voltage current tapers below cutoff ( I ≤ 80 mA ). 🌡️ IEC 61960 Thermal Compensation Normalized Capacity at 25°C: Eliminates seasonal capacity swings (winter vs summer) using the electrochemical standard formula: C 25 ∘ C = C fcc 1.0 + 0.006 × ( T batt − 25.0 ) 🛡️ Silicon Safety & Protection Registers Hardware Fault Monitoring: Inspects physical protection flags in real time (short_c_hw_status, short_ic_otp_status, subboard_temp_err) with an instant SAFE / ALERT indicator. 📈 Internal Resistance (ESR) Dynamic Impedance Calculation: Estimates real-time internal resistance ( m Ω ) using active Δ V Δ I load steps, helping identify aging and degradation. 📊 Health Trends & Projections Interactive SOH Chart: Visual canvas trend with 100%, 90%, and 80% industrial replacement threshold lines. Cycle Life Projection: Estimates remaining cycles before reaching 80% capacity based on historical wear rate. Safe History Management: Multi-select deletion, persistent Trash bin, full restore, and bidirectional CSV/JSON export and import with automatic deduplication. ⏰ Configurable Background Work Scheduler Customizable Intervals: Select between 24 hours, 2 days, or 7 days periodic snapshots via Android WorkManager. Material 3 TimePicker: Choose the exact time of day for scheduled background measurements to prevent nighttime wakeups, with real-time countdown banner on the dashboard. 📥 CSV History Import & Bidirectional Backup Full History Portability: Restore snapshots exported from other devices or previous installations. Deduplication & Integrity: Automatically skips duplicate timestamps while preserving notes and battery metrics. 📱 Universal Device Presets & Advanced Samsung Telemetry OPlus & Samsung Coverage: Built-in rated capacities (IEC 61960) for 40+ Oppo, Realme, and OnePlus models, plus extensive Samsung Galaxy presets (Galaxy S24, S23, S22, Z Fold/Flip, and A-series). Samsung EFS & ASOC Telemetry: Decodes raw chemical degradation from Samsung EFS batt_asoc (Absolute State of Health) nodes, prioritizing true molecular cell aging over smoothed One UI system metrics. 📊 Interactive Home Screen Widgets Battery Status Widget (3×2 / 4×2): Real-time home screen monitoring showing live SOH %, hardware cycle count, dynamic wattage (+ / - W), and cell temperature. Minimalist SOH Gauge Widget (1×1): Compact, glanceable circular gauge focusing purely on battery State of Health. Power Connection Auto-Refresh: Automatically synchronizes and updates widget telemetry on charger plug and unplug events. ⚡ Live Power Streaming & Dynamic Wattage Meter Real-Time Continuous Power Flow: Live BMS voltage and current stream during active app usage. Visual Wattage Indicator: Color-coded animated charging/discharging power indicators with dynamic positive/negative wattage calculation. 🔔 Smart Notifications & Thermal Protection Snapshot Receipts: Confirmation cards for manual saves, scheduled background logs (WorkManager), and 100% charger unplug events. Overheat Alarm: High-priority alert when battery temperature exceeds 42°C during high-speed charging or heavy workloads. 🚀 120 Hz UI & Themes Fluid Performance: Zero-allocation Composables locked to 120 Hz (8.33 ms frame budget). 4 Themes: System Default, Light, Dark, and AMOLED Pure Black (#000000) for zero OLED sub-pixel power draw. 💻 Built-in Diagnostic Console Real-Time Shell Inspector: Live log of every sysfs, dumpsys, and settings query with exit codes and fallback paths. 1-Click Share & Bug Reporting: Instant Markdown generation ready to share or paste into GitHub Issues, formatted cleanly with human-readable command labels.