home-assistant / home-assistant.io

:blue_book: Home Assistant User documentation
https://www.home-assistant.io
Other
4.83k stars 7.22k forks source link

Do we have to make it so hard for foks with solar systems to set up energy? #31830

Open KeithoHimself opened 6 months ago

KeithoHimself commented 6 months ago

Feedback

The documentation is sparse and assumes deep knowledge of Home Assistant. The use of templates and helpers appears mandatory for folks that have a CCS WattNode meter in the consumption path. The following is off-topic in terms of documentation feedback, but how hard would it be to simply be able to indicate what path the meter is in and have the math done automatically?

No examples of pre-built templates for dealing with consumption path in the documentation, which would be helpful.

URL

https://www.home-assistant.io/integrations/fronius/

Version

2024.3.0

Additional information

No response

home-assistant[bot] commented 6 months ago

Hey there @farmio, mind taking a look at this feedback as it has been labeled with an integration (fronius) you are listed as a code owner for? Thanks!

Code owner commands Code owners of `fronius` can trigger bot actions by commenting: - `@home-assistant close` Closes the feedback. - `@home-assistant rename Awesome new title` Renames the feedback. - `@home-assistant reopen` Reopen the feedback. - `@home-assistant unassign fronius` Removes the current integration label and assignees on the feedback, add the integration domain after the command. - `@home-assistant add-label needs-more-information` Add a label (needs-more-information) to the feedback. - `@home-assistant remove-label needs-more-information` Remove a label (needs-more-information) on the feedback.
farmio commented 6 months ago

Hi 👋! Afaik, an integration shall provide entities based on API responses. It shall not provide calculated entities.

Looking at https://www.home-assistant.io/integrations/fronius/#consumption-path-meter I do see pre-built template code that can be copy&pasted ready for use (except for entity_id language).

If you think this is not comprehensive, keep in mind, this is a community project - you are invited to add to the documentation to make it more clear. If you do, you might want to have a look at https://github.com/home-assistant/home-assistant.io/pull/22320

Here is a pretty good resource highlighting the difficulties different systems may encounter based on the setup https://community.home-assistant.io/t/howto-fronius-integration-with-battery-into-energy-dashboard/376329

KeithoHimself commented 6 months ago

Thank you for the links! Looking at my original post I see that I was overly critical and I apologize for that. I'll look over the information you provided and I'll consider contributing based on my findings.

lu-zero commented 4 months ago

Would be possible though have a mean to install the premade derived sensors? Having to redo that manually for each setup is error prone.

frenck commented 4 months ago

Would be possible though have a mean to install the premade derived sensors?

It depend if the device or service integrated provides that information.

farmio commented 4 months ago

https://github.com/home-assistant/core/pull/116535 would already be a nice step towards a more user friendly Fronius integration. Not 100% sure if it is ok in Core though.

lu-zero commented 4 months ago

Potentially another way is to overhaul the energy dashboard to take in energy and/or power and take in positive-negative range inputs like https://github.com/flixlix/power-flow-card-plus does.

frenck commented 4 months ago

Potentially another way is to overhaul the energy dashboard to take in energy and/or power and take in positive-negative range inputs like flixlix/power-flow-card-plus does.

That is about frontend, not related to this conversation.