Skip to content

Conversation

@catsmanac
Copy link
Contributor

Proposed change

In HA version 2025.9 support for the Enphase Collar was added to the enphase_envoy integration. Collar support included display of grid_state as on/off grid. After some time of field use, it turns out the grid_state field of the envoy does not reflect the actual grid connection status, but rather the admin_state_str field of the Collar device does.

This PR is related to the fix for this in the parent code base and describes this issue, where to get the grid status and some caution with these status until time will learn more.

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.

@home-assistant home-assistant bot added Hacktoberfest An PR on this issue (or the PR itself) is eligible towards Hacktoberfest! has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels Oct 5, 2025
@netlify
Copy link

netlify bot commented Oct 5, 2025

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 06f2e44
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/68e3d6f4bc6226000855e81d
😎 Deploy Preview https://deploy-preview-41188--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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


#### Collar status entities

- **Collar <abbr title="Collar serial number">SN</abbr> Admin state**: Collar state, ENCMN_MDE_ON_GRID when on grid and ENCMN_MDE_OFF_GRID when off grid.
Copy link
Member

Choose a reason for hiding this comment

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

Is this really the state we are communicating to the user? "ENCMN_MDE_ON_GRID"?

To me, this doesn't sounds like something we should ever make user-facing 🤷

Copy link
Contributor Author

Choose a reason for hiding this comment

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

You are completely right that this shouldn't show like this. Turns out I forgot to add these to the translations strings and those raw api values showed in the gui. As if I was before my first coffee or after my first beer, not realizing what was going on... . THANKS!!!

@catsmanac catsmanac requested a review from frenck October 6, 2025 15:46
Copy link
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

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

Thank you, @catsmanac 👍

@c0ffeeca7 c0ffeeca7 added the awaits-parent Awaits the merge of an parent PR label Oct 7, 2025
@home-assistant home-assistant bot added the parent-merged The parent PR has been merged already label Oct 14, 2025
@c0ffeeca7 c0ffeeca7 merged commit f3e7ff3 into home-assistant:next Oct 14, 2025
7 checks passed
@home-assistant home-assistant bot removed awaits-parent Awaits the merge of an parent PR parent-merged The parent PR has been merged already labels Oct 14, 2025
@github-actions github-actions bot locked and limited conversation to collaborators Oct 15, 2025
@catsmanac catsmanac deleted the Enphase_envoy_collar_grid_state branch October 21, 2025 17:32
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Hacktoberfest An PR on this issue (or the PR itself) is eligible towards Hacktoberfest! has-parent This PR has a parent PR in another repo next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants