battery-charging-optimizer/QUICK_FIX_REFERENCE.md

Battery Optimizer - Quick Fix Reference Card

Print this page and keep it handy for quick troubleshooting!

---

🚨 Emergency Quick Checks (5 Minutes)

1️⃣ Check PyScript Status

Settings → Devices & Services → Search "PyScript" → Should show "Configured"

2️⃣ Reload PyScript

Developer Tools → Services → Call Service:
service: pyscript.reload

3️⃣ Check Logs for Errors

Settings → System → Logs → Filter "pyscript" → Look for RED messages

4️⃣ Verify Services Exist

Developer Tools → Services → Search "pyscript."
Should show: calculate_charging_schedule, execute_charging_schedule, getprices_extended

5️⃣ Check Files in Correct Location

# Via SSH or File Editor:
ls -la /config/pyscript/
# Should show: battery_charging_optimizer.py, hastrom_flex_extended.py

---

🔧 Common Fixes

❌ "ModuleNotFoundError: No module named 'zoneinfo'"

Quick Fix: Add fallback to both scripts

Replace in BOTH files:

from zoneinfo import ZoneInfo
TIMEZONE = ZoneInfo("Europe/Berlin")

With:

try:
    from zoneinfo import ZoneInfo
    TIMEZONE = ZoneInfo("Europe/Berlin")
except ImportError:
    import pytz
    TIMEZONE = pytz.timezone("Europe/Berlin")

Then: pyscript.reload

---

❌ "AttributeError: 'state' object has no attribute..."

Cause: Missing helper entity

Quick Fix: Create missing entities

Go to: Settings → Devices & Services → Helpers → Create Helper

Required Helpers:

• Toggle: input_boolean.battery_optimizer_enabled (initial: ON)
• Toggle: input_boolean.goodwe_manual_control (initial: OFF)
• Toggle: input_boolean.battery_optimizer_manual_override (initial: OFF)
• Number: input_number.battery_capacity_kwh (min: 0, max: 50, initial: 10)
• Number: input_number.battery_optimizer_min_soc (min: 0, max: 100, initial: 20)
• Number: input_number.battery_optimizer_max_soc (min: 0, max: 100, initial: 100)
• Number: input_number.battery_optimizer_max_charge_power (min: 0, max: 10000, initial: 5000)
• Number: input_number.charge_power_battery (min: 0, max: 10000, initial: 0)
• Text: input_text.battery_optimizer_status (max: 255)

Then: pyscript.reload

---

❌ Services Not Showing Up

Cause: PyScript didn't load scripts

Quick Fix:

1. Check file location: /config/pyscript/ (not pyscripts)
2. Check file permissions: Should be readable by HA
3. Call: pyscript.reload
4. Check logs immediately for errors

---

❌ "NameError: name 'task' is not defined"

Cause: PyScript not initialized or wrong version

Quick Fix:

1. Check PyScript version: Settings → Devices & Services → PyScript
2. Update to latest: HACS → PyScript → Update
3. Restart Home Assistant
4. Call: pyscript.reload

---

❌ Time Triggers Not Firing

Quick Fix: Create automation instead

configuration.yaml:

automation:
  - alias: "Battery Optimizer - Daily Calculation"
    trigger:
      platform: time
      at: "14:05:00"
    action:
      service: pyscript.calculate_charging_schedule

  - alias: "Battery Optimizer - Hourly Execution"
    trigger:
      platform: time_pattern
      minutes: "05"
    action:
      service: pyscript.execute_charging_schedule

Restart Home Assistant.

---

❌ Sensors Not Created (hastrom_flex_pro_ext)

Quick Fix: Check if price is None

Add logging to hastrom_flex_extended.py around line 86:

log.info(f"DEBUG: current_price = {current_price}")
if current_price is not None:
    state.set("sensor.hastrom_flex_ext", value=float(current_price))
else:
    log.error("Current price is None - cannot create sensor")

Then: pyscript.reload and call pyscript.getprices_extended

---

🧪 Manual Test Sequence

Run these in order to isolate the problem:

Test 1: Price Fetcher

service: pyscript.getprices_extended

Wait 5 seconds, then check:

Developer Tools → States → sensor.hastrom_flex_pro_ext
Should have: prices_today, prices_tomorrow in attributes

Test 2: Optimizer

service: pyscript.calculate_charging_schedule

Wait 5 seconds, then check:

Developer Tools → States → pyscript.battery_charging_schedule
Should have: schedule array, num_charges, last_update

Test 3: Executor

service: pyscript.execute_charging_schedule

Immediately check logs:

Should see: "Suche Ladeplan für ..."

---

📋 Log Error Patterns & Fixes

Error in Logs	Quick Fix
ModuleNotFoundError: zoneinfo	Add pytz fallback (see above)
NameError: task	Update PyScript integration
AttributeError: state	Create missing helper entity
Fehler beim Abrufen	Check network/API access
SyntaxError	Re-copy files, check encoding
ValueError: State attributes	Reduce schedule size
No errors, but not working	Check if optimizer is enabled

---

🎛️ Enable/Disable Optimizer

Enable

service: input_boolean.turn_on
data:
  entity_id: input_boolean.battery_optimizer_enabled

Disable

service: input_boolean.turn_off
data:
  entity_id: input_boolean.battery_optimizer_enabled

Check Status

Developer Tools → States → input_boolean.battery_optimizer_enabled
Should show: "on" or "off"

---

📊 Debug Logging

configuration.yaml:

logger:
  default: info
  logs:
    custom_components.pyscript: debug

Restart, then check logs again.

---

✅ Success Indicators

Price Fetcher Working:

Log shows: "✓ API-Abfrage erfolgreich: 48 Datenpunkte"
State exists: sensor.hastrom_flex_pro_ext with prices_today array

Optimizer Working:

Log shows: "=== Batterie-Optimierung gestartet" ... "=== Optimierung abgeschlossen ==="
State exists: pyscript.battery_charging_schedule with schedule array
Status shows: "X Ladungen" in input_text.battery_optimizer_status

Executor Working:

Log shows: "🔋 AKTIVIERE LADEN" OR "✓ Auto-Modus bereits aktiv"
Manual control toggles: input_boolean.goodwe_manual_control changes state

---

🆘 Still Not Working?

Gather This Info:

1. Home Assistant version (Settings → System → Info)
2. PyScript version (Settings → Devices & Services → PyScript)
3. Last 50 lines of logs with "pyscript" filter
4. List of services starting with "pyscript."
5. Which entities from "Required Helpers" exist

Get Help:

• Home Assistant Community: https://community.home-assistant.io/
• PyScript GitHub: https://github.com/custom-components/pyscript/issues
• Include all info from "Gather This Info" above

---

📁 File Locations Cheat Sheet

File	Production Location	Dev Location
Optimizer	/config/pyscript/battery_charging_optimizer.py	./openems/battery_charging_optimizer.py
Price Fetcher	/config/pyscript/hastrom_flex_extended.py	./openems/hastrom_flex_extended.py
Logs	/config/home-assistant.log	Settings → System → Logs
Config	/config/configuration.yaml	N/A

---

🔢 Default Configuration Values

battery_capacity_kwh: 10
min_soc: 20
max_soc: 100
max_charge_power: 5000
price_threshold: 28
reserve_capacity: 2
pv_threshold: 500

---

⏰ Trigger Schedule

Time	Service	Purpose
14:05 daily	getprices_extended	Fetch tomorrow prices
14:05 daily	calculate_charging_schedule	Plan next 48h
00:05 daily	Both services	Midnight update
XX:05 hourly	execute_charging_schedule	Apply current hour action
XX:00 hourly	getprices_extended	Update current price

---

🔗 Quick Links

• Detailed Troubleshooting: TROUBLESHOOTING_GUIDE.md
• Full Diagnosis: DIAGNOSIS_SUMMARY.md
• Validation Script: validate_pyscript.py
• Technical Details: diagnostic_pyscript_issues.md

---

Last Updated: 2025-11-20 Version: 3.2.0 (battery_charging_optimizer) + 2.0 (hastrom_flex_extended)