Skip to content

Services Reference

bolagnaise edited this page Mar 7, 2026 · 18 revisions

Services Reference

Core Services

Service Description Parameters
power_sync.sync_tou_schedule Manually sync TOU tariff to battery None
power_sync.sync_now Refresh data from provider and battery None

Battery Control

Service Description Parameters
power_sync.force_charge Force charge from grid duration_minutes (required)
power_sync.force_discharge Force discharge to grid duration_minutes (required)
power_sync.restore_normal Restore normal battery operation None

Tesla Powerwall Settings

Service Description Parameters
power_sync.set_backup_reserve Set backup reserve percentage backup_reserve (0-100)
power_sync.set_operation_mode Set operation mode mode (autonomous, self_consumption, backup)
power_sync.set_grid_export Set grid export behaviour export (everything, pv_only, never)
power_sync.set_grid_charging Enable/disable grid charging enabled (true/false)

Dual Powerwall: If you have a dual Powerwall setup, all services above — including force charge, force discharge, restore normal, TOU sync, and all settings — are automatically applied to both gateways. No additional configuration is needed.

Sungrow Battery Control

Service Description Parameters
power_sync.sungrow_force_charge Force charge from grid duration_minutes (optional)
power_sync.sungrow_force_discharge Force discharge to grid duration_minutes (optional)
power_sync.sungrow_restore_normal Restore self-consumption mode None
power_sync.sungrow_set_backup_reserve Set backup reserve percentage percent (0-100)
power_sync.sungrow_set_charge_rate Set max charge rate kw (kilowatts)
power_sync.sungrow_set_discharge_rate Set max discharge rate kw (kilowatts)
power_sync.sungrow_set_export_limit Set grid export limit watts (0 to disable)

AC Inverter Curtailment

Service Description Parameters
power_sync.curtail_inverter Manually curtail AC inverter to zero export None
power_sync.restore_inverter Restore AC inverter to normal operation None

Data Services

Service Description Parameters
power_sync.get_calendar_history Get energy history (for mobile app) start_date, end_date
power_sync.sync_battery_health Sync battery health data (Tesla TEDAPI / blueprint). Not needed for Sungrow, Sigenergy, or GoodWe — SOH is read automatically. None

Clone this wiki locally