Skip to content

Document the Fronius Modbus setpoint fallback - #47915

Open
farmio wants to merge 3 commits into
home-assistant:nextfrom
farmio:fronius-modbus-fallback-period
Open

Document the Fronius Modbus setpoint fallback#47915
farmio wants to merge 3 commits into
home-assistant:nextfrom
farmio:fronius-modbus-fallback-period

Conversation

@farmio

@farmio farmio commented Sep 5, 2026

Copy link
Copy Markdown
Member

Proposed change

Documents the new Fronius option Revert the AC power limit if Home Assistant stops.

Setpoints written over Modbus stay on the inverter until they are changed - including while Home Assistant is shut down or unreachable. The option lets the inverter recover on its own: it drops the AC power limit an hour after it last received it, while Home Assistant sends the limit again every 15 minutes so the hour only runs out once Home Assistant has really stopped.

It also covers the case the option matters most for: removing the integration leaves the last limit in force with nothing left to take it back.

The new subsection also says what the option does not cover: Fronius documents no timeout for the battery setpoints, so those keep their value whatever happens to Home Assistant.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI lite review requested due to automatic review settings September 5, 2026 16:31
@home-assistant home-assistant Bot added in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch next This PR goes into the next branch labels Sep 5, 2026
@home-assistant

home-assistant Bot commented Sep 5, 2026

Copy link
Copy Markdown

It seems that this PR is targeted against an incorrect branch. Documentation updates which apply to our current stable release should target the current branch. Please change the target branch of this PR to current and rebase if needed. If this is documentation for a new feature, please add a link to that PR in your description.

@netlify

netlify Bot commented Sep 5, 2026

Copy link
Copy Markdown

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit a1adf0f
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6a9c49f547e01a00089d1b8e
😎 Deploy Preview https://deploy-preview-47915--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@home-assistant home-assistant Bot added has-parent This PR has a parent PR in another repo and removed needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch labels Sep 5, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The new text needs small but important wording and UI-instruction edits for clarity and to match Home Assistant documentation style/tone.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR updates the Fronius integration documentation to explain the new option Revert the AC power limit if Home Assistant stops, including how the inverter behaves when Home Assistant is unavailable.

Changes:

  • Added a new subsection describing how Modbus AC power limit setpoints persist and how the new revert option provides a timeout-based fallback.
  • Documented that the revert behavior applies only to AC power limit, and that Fronius does not document a timeout for battery setpoints.
File summaries
File Description
source/_integrations/fronius.markdown Adds documentation for the Modbus setpoint fallback option and clarifies scope/limitations.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 2
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread source/_integrations/fronius.markdown Outdated

#### Falling back to the inverter's own settings

A setpoint stays on the inverter until it is changed, including while Home Assistant is shut down or unreachable. To have the inverter recover on its own instead, turn on **Revert the AC power limit if Home Assistant stops**: go to **Settings** > **Devices & services**, select the Fronius integration, and choose **Configure**.

A setpoint stays on the inverter until it is changed, including while Home Assistant is shut down or unreachable. To have the inverter recover on its own instead, turn on **Revert the AC power limit if Home Assistant stops**: go to **Settings** > **Devices & services**, select the Fronius integration, and choose **Configure**.

The inverter then drops the `AC power limit` an hour after it last received it, and hands control back to its own priority list. Home Assistant sends the limit again every 15 minutes, so the hour only ever runs out once Home Assistant has really stopped - a restart or a short outage has plenty of room. An inverter held at `30 %` runs unrestricted an hour after the Home Assistant host dies.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants