Skip to content

feat: operator guide#950

Open
b0661 wants to merge 1 commit into
Akkudoktor-EOS:mainfrom
b0661:feat/operation_guide
Open

feat: operator guide#950
b0661 wants to merge 1 commit into
Akkudoktor-EOS:mainfrom
b0661:feat/operation_guide

Conversation

@b0661

@b0661 b0661 commented Mar 15, 2026

Copy link
Copy Markdown
Collaborator

Work in progress to create a comprehensive operator guide. Feel free to review and provide improvements.

The guide should help to get a quick setup for a user. More details may be referenced.

@b0661 b0661 added documentation Improvements or additions to documentation enhancement Changes/ updates/ enhancement to existing features help wanted Extra attention is needed in progess Pull request is in progress (excempt from stale handling) labels Mar 15, 2026
@b0661 b0661 force-pushed the feat/operation_guide branch 2 times, most recently from 2640238 to 1d863bf Compare March 15, 2026 11:34
Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>
@b0661 b0661 force-pushed the feat/operation_guide branch from 1d863bf to 6ac2522 Compare March 15, 2026 11:37
Comment on lines 191 to 194
* **Load** energy meter readings
* **Grid export** energy meter readings
* **Grid import** energy meter readings
* **PV production** energy meter readings

@phoerious phoerious Mar 15, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This is one of the parts where I was confused and couldn't find any documentation. What's the difference between load and import here? I guess load is the current (absolute) meter reading, but what do I configure as import? As an example, Tibber exposes two entities: sensor.tibber_pulse_xxx_last_meter_consumption (current meter reading) and sensor.tibber_pulse_zzz_accumulated_consumption (consumption today). There's also one for the current hour. I guess I would use last_meter_consumption as "load", but I'm unsure about the other one. Or is it the other way round? import/export are last meter reading and load is daily consumption? Or are there other smart meters that distinguish between what I consume in total vs. what I consumed from the grid? Wouldn't that just be consumption - production?

@b0661 b0661 Mar 16, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

  • Load is the electric energy consumption within your system (aka. house, apartment). What your home appliances (e.g. oven, dish washer, fridge, wall box, ...) consume.
  • Grid export is how much electric energy you export to the electric grid
  • Grid import, how much electric energy you import from the electric grid
  • PV production is the amount of electric energy that your solar panel provide to your system

Tibber only wants to and can only see grid import/ export. That is what your grid meter provides.

Load can be estimated by a load provider (prediction provider), same for pv production.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Makes sense. Would be helpful if that were written down somewhere. 😉

% SPDX-License-Identifier: Apache-2.0
(operator-guide-page)=

# Akkudoktor-EOS Operator Guide

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This guide is a good step forward, but it still doesn't quite align with my first experience with the software. Looking back I can now piece together a few things from this, but as a new user, I would still be at a loss why the dashboards behave like some deployment failed.

I prefer clear steps from start to finish like:

  1. Add repository
  2. Install app
  3. Set mode to OPTIMIZATION and configure the timeout
  4. Optional: set config option X to Y if you have ABC...
  5. Wait for first run
  6. Inspect dashboard, adjust filled-in dummy data like so: ...
  7. Click save config to file, otherwise changes are lost on restart.

Or something like that.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

You are welcome to improve.

Comment on lines +634 to +636
- Missing or misconfigured prediction providers.
- System description (battery, inverter) not defined.
- No measurement inputs (e.g., current PV power, load) available.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

A missing first run due to a missing configuration seems to be the most common cause for new users at least.

@github-actions

Copy link
Copy Markdown

This pull request has been marked as stale because it has been open (more than) 90 days with no activity. Remove the stale label or add a comment saying that you would like to have the label removed otherwise this pull request will automatically be closed in 30 days. Note, that you can always re-open a closed pull request at any time.

@github-actions github-actions Bot added the stale Not worked on for 90 days label Jun 15, 2026
@b0661 b0661 removed the stale Not worked on for 90 days label Jun 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement Changes/ updates/ enhancement to existing features help wanted Extra attention is needed in progess Pull request is in progress (excempt from stale handling)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants