Services Reference

Services Reference

PowerSync services are battery-agnostic where possible. Brand-specific control is routed through the configured coordinator, so most automations should use the generic power_sync.* services instead of brand names.

Core Services

Service	Description	Parameters
power_sync.sync_tou_schedule	Manually sync the current tariff/schedule to supported battery systems	None
power_sync.sync_now	Refresh provider and battery data immediately	None

Battery Control

Service	Description	Parameters
power_sync.force_charge	Force battery charge from grid for a timed window	duration optional, minutes, default 30; power_w optional, 0/omitted uses the inverter default
power_sync.force_discharge	Force battery discharge/export for a timed window	duration optional, minutes, default 30; power_w optional, 0/omitted uses the inverter default
power_sync.hold_battery_soc	Hold the battery around its current SOC and block normal charge/discharge where the hardware supports it	duration optional, minutes, default 30
power_sync.set_self_consumption	Put the battery into self-consumption mode	None
power_sync.restore_normal	Cancel force/hold/self-consumption overrides and return to normal operation	None

Coverage notes:

• Force charge/discharge routes through Tesla, Sigenergy, Sungrow, FoxESS, GoodWe, AlphaESS, Solax Hybrid, ESY Sunhome, and SAJ H2/HS2 where the configured hardware supports the action.
• power_w is best-effort. ESY Sunhome is mode-only, and SAJ H2/HS2 uses a percentage of rated power through the upstream SAJ integration.
• hold_battery_soc is strongest on Modbus systems with a standby/backup mode. Tesla and AlphaESS are best-effort; solar surplus can still move SOC.

Backup Reserve

Service	Description	Parameters
power_sync.set_backup_reserve	Set the hardware backup reserve / minimum SOC	percent required, 0-100

Supported reserve writes: Tesla Powerwall, Sigenergy, Sungrow, FoxESS, GoodWe, and Solax Hybrid. ESY Sunhome and SAJ H2/HS2 do not expose backup reserve control, so the call is logged as a no-op for those systems.

Tesla currently rejects reserve values from 81-99%; PowerSync clamps those requests to 100%.

Tesla Powerwall Settings

Service	Description	Parameters
power_sync.set_operation_mode	Set Powerwall operation mode	mode: autonomous, self_consumption, or backup
power_sync.set_grid_export	Set Powerwall grid export rule	rule: never, pv_only, or battery_ok
power_sync.set_grid_charging	Enable or disable grid charging	enabled boolean
power_sync.set_storm_watch	Enable or disable Storm Watch when the site supports it	enabled boolean
power_sync.set_off_grid_ev_reserve	Set the battery percentage reserved for EV charging during an outage	percent required, 0-100
power_sync.set_vpp_enrollment	Enroll or unenroll from a Tesla grid-services program	program_id, enrolled boolean
power_sync.schedule_max_backup	Raise backup reserve to 100% for a fixed window, then restore the previous reserve	duration_minutes required, 1-1440
power_sync.refresh_calibration	Clear PowerSync's local Powerwall calibration guard after a calibration cycle	None

Tesla Powerwall Local Control

Service	Description	Parameters
power_sync.powerwall_go_off_grid	Physically disconnect from grid using local Powerwall control	bypass_soc_check optional boolean; mode optional advanced TEDAPI mode override
power_sync.powerwall_reconnect_grid	Reconnect to grid	None
power_sync.powerwall_verify_pairing	Verify the stored local pairing key	None

Local off-grid control requires completed gateway pairing. Powerwall 3 uses signed TEDAPI commands; Powerwall 2 uses the local gateway path.

AC Inverter Curtailment

Service	Description	Parameters
power_sync.curtail_inverter	Manually curtail the configured AC-coupled inverter	mode optional: load_following default or shutdown
power_sync.restore_inverter	Restore the configured AC-coupled inverter to normal operation	None

Automatic curtailment uses the configured AC inverter settings and current price/load data. Manual load_following mode passes home load to controllers that support it; unsupported paths fall back to zero export or native curtailment behavior.

Data Services

Service	Description	Parameters
power_sync.get_calendar_history	Return battery energy history for the mobile app	period optional: day, week, month, or year
power_sync.sync_battery_health	Update Tesla battery-health data from a mobile TEDAPI scan or capacity blueprint	original_capacity_wh, current_capacity_wh, degradation_percent; optional battery_count, scanned_at

get_calendar_history supports service responses in Home Assistant versions that expose response data from service calls.

PowerSync Automation Actions

The mobile app's Automations engine also exposes actions such as Enable Optimizer, Disable Optimizer, AEMO spike export, EV charging actions, and grid-status workflows. These are PowerSync automation actions, not separate Home Assistant Developer Tools services.