docs: document custom external controller setup
docs: update SolarEdge battery control support
Document Powerwall local pairing
Update wiki coverage for current PowerSync features
docs: document Fronius Reserva support
docs: clarify tariff auto-sync for modbus batteries
docs: update wiki feature coverage
docs: refresh PowerSync wiki
Update docs for all 9 supported battery systems
- Battery-System-Setup: add at-a-glance support table with all systems and key limitations
- Home, Installation: update battery system lists to include all 9 systems
- Advanced-Features: expand AEMO spike section to cover all non-Tesla systems (Sigenergy, FoxESS, Sungrow, GoodWe, AlphaESS, Solax, ESY Sunhome, SAJ H2/HS2)
- Sensors, Dashboard-Setup: update Battery Health table — AlphaESS, ESY Sunhome, and FoxESS H3 Smart added as auto-read; Solax and SAJ H2/HS2 noted as unavailable; FoxESS split by model family
- Services-Reference: update brand coverage note and sync_battery_health description to reflect all supported systems
- Electricity-Providers: replace stale Localvolts TOU sync brand list with capability-based wording
docs(wiki): add AC inverter curtailment guide + full readability pass
Add a new AC-Inverter-Curtailment.md page with per-brand setup guides for
all nine supported AC-coupled solar inverter brands (Sungrow SG, Fronius,
Huawei, Enphase, GoodWe, Zeversolar, Solax, Sigenergy, AlphaESS, FoxESS),
covering connection settings, prerequisites, supported models, and
brand-specific options such as Fronius load-following mode and Enphase JWT
authentication.
Across all twelve wiki files, remove developer-facing content that has no
value to end users: Modbus register numbers, gain/scale/offset values,
internal API endpoint paths, Python library names, code architecture terms,
and implementation-detail notes (sign conventions, flash wear, write-order
requirements, LP internals). Simplify jargon throughout — DOD explained in
plain English, DPEL/SunSpec terms replaced with plain descriptions, Flow
Power PEA formulas converted to prose. Fix stale entity IDs in
Installation.md to match the power_sync_ prefix used across the rest of the
wiki. Replace EV power-sharing math blocks with a two-paragraph plain-English
explanation.
docs(services): document hold_battery_soc + manual-vs-optimizer state split
Reflects the new services and handler behaviour shipped in PowerSync
2.12.60.
- New row for power_sync.hold_battery_soc (duration-based) with
reference to the per-brand capability matrix (Tesla/AlphaESS return
a 'warning' because they can't strictly lock the battery; Sigenergy
/ Sungrow / FoxESS / GoodWe have native standby primitives).
- New row for power_sync.set_self_consumption (promoted from
internal-use to a first-class toggle).
- Clarification paragraph on what restore_normal actually does per
brand (Tesla also restores TOU tariff + operation mode + backup
reserve; Modbus brands clear forced-dispatch registers). Same
user-visible end state, different implementation.
- New paragraph explaining the source='user' vs source='optimizer'
split: LP-driven force mode executes the hardware write only and
does not populate the Controls screen countdown or trigger mobile
state events. Manual activity is the only thing that shows on the
Controls screen.
docs(wiki): add AlphaESS battery system setup guide
New top-level AlphaESS section in Battery-System-Setup.md mirroring the
Sigenergy/FoxESS/Sungrow layout:
- Supported models: SMILE5, SMILE-Hi5, SMILE-Hi10, SMILE-B3, SMILE-T10,
SMILE-G3, Storion-T30.
- Connection details call out the unusual default slave ID (85 / 0x55)
since every other supported brand defaults to 1 or 247.
- Quirks section documents the SOC-scale mismatch between read register
0x0102 (0.1%/bit) and write register 0x0728 (0.4%/bit), the +32000
dispatch-power offset, and the fact that forced dispatch has no
auto-revert (PowerSync releases 0x0722 on unload and restore_normal).
- Explicit note that Note5 and Note7 enum mappings are still being
validated against live hardware.
Services-Reference.md updated:
- Generic Battery Control table gains a note clarifying that the
force_charge / force_discharge / restore_normal dispatch to the right
brand-specific handler for Tesla / Sigenergy / Sungrow / FoxESS /
GoodWe / AlphaESS.
- sync_battery_health row updated to include AlphaESS in the list of
brands that don't need a manual health sync (SOH is read automatically
from Modbus register 0x011B).
Add Powerwall 3 off-grid control documentation
Document the new PW3 off-grid/reconnect feature in Advanced Features
including setup, off-grid curtailment, and automation actions. Add
powerwall_go_off_grid and powerwall_reconnect_grid to Services Reference.
Remove PW2+PW3 dual Powerwall sections
The dual Powerwall feature has been removed from the integration as
of v2.9.0. Remove the corresponding documentation:
- Battery-System-Setup.md: delete the entire 'Dual Powerwall Setup —
PW2 + PW3 (Optional)' section (~70 lines covering setup steps,
battery capacity weighting, safety features)
- Advanced-Features.md: drop the 'Dual Powerwall' callout in the
AEMO spike detection section
- Services-Reference.md: drop the 'Dual Powerwall' callout in the
Tesla service reference
Tesla now handles native PW3 leader/follower configurations as a
single system, so no PowerSync-side multi-gateway support is needed.
Update wiki for v2.5.0-2.6.6 features
- Add Solax inverter section to Battery System Setup
- Add Sigenergy Remote EMS control documentation
- Add FoxESS grid targeting and force mode power setpoint docs
- Add EV power/SOC and PV array sensors to Sensors page
- Add Sigenergy, FoxESS, and optimizer enable/disable services
- Update Dashboard Setup for auto-generated strategy and tesla-style card
- Add load-following curtailment, push notifications, free electricity docs
- Add hardware backup reserve and optimizer automation control
- Add OCPP charger details and EV sensors to EV Smart Charging
- Add Solax and OCPP troubleshooting sections
- Update AEMO spike detection to cover all battery systems
- Update confidence decay horizon to 4h (matches code)
- Remove alpha warning from Smart Optimization
- Add demo mode mention to wiki home
Update wiki for battery health sensor support across all systems
Sungrow, Sigenergy, and GoodWe now read SOH automatically from the
inverter. Updated Sensors, Dashboard Setup, and Services Reference
to reflect that the blueprint is only needed for Tesla.
Add dual Tesla Powerwall documentation
- Battery-System-Setup: Add Dual Powerwall Setup section with setup instructions,
capacity weighting, inter-battery prevention table, and safety features
- Services-Reference: Note that all services apply to both gateways automatically
- Advanced-Features: Note dual PW behavior for AEMO spike detection
Initialize wiki with comprehensive documentation